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.

FORMAT

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

Arguments

resource

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

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 call 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.

Return Values

SNALU62_S_OK
normal successful completion

SNALU62_S_CONVCANC
conversation cancelled

SNALU62_S_PARERR
parameter error, function-name

SNALU62_S_PRGPARCHK
program parameter check