snalu62_get_pip(3) — Subroutines

NAME

snalu62_get_pip − Returns the program initialization parameters (PIP) data that the remote transaction program supplied on an allocation request.

LIBRARY

/usr/shlib/libsnatprm.so

SYNOPSIS

#include <sna/snatprmdf.h>

STATUS_RTN snalu62_get_pip(
       RES_ID resource,
       STATUS_VEC status_vec,
       PIP_DATA ∗pip
       );

Valid Conversation States

HDX: All except Reset

FDX: All except Reset

SUPPLIED PARAMETER

resource

A RES_ID structure specifying the resource ID assigned to the conversation by the interface. The interface returns this ID on the snalu62_allocate, snalu62_attach_listen, or snalu62_receive_allocate verb.

RETURNED PARAMETERS

status_vec

A pointer to a STATUS_VEC array to receive the completion status information.

pip

A pointer to a PIP_DATA structure to receive the PIP data that the remote transaction provided.

The interface allocates the memory referenced by the PIP_DATA structure. The transaction program must deallocate this memory by using the snalu62_free_mem verb.

DESCRIPTION

This verb returns the PIP data supplied by the remote transaction program on the allocation request. PIP data consists of a number of variables supplied by the requesting transaction programs. The interpretation of these variables is program-dependent.

RESTRICTIONS

None

RETURN VALUES

SNALU62_S_OKnormal successful completion

SNALU62_S_CONVCANC
conversation cancelled

SNALU62_S_PARERR
parameter error, function-name

SNALU62_S_PRGPARCHK
program parameter check

SNALU62_S_UNSUC
verb did not execute successfully

ERRORS