snalu62_pass_resource(3) — Subroutines

Name

snalu62_pass_resource − Requests the interface to transition the specified conversation to the calling process.

FORMAT

STATUS_RTN snalu62_pass_resource(
     RES_ID ∗resource,
     TP_ID ∗tp_id,
     STATUS_VEC status_vec,
     UINT32 shared_res_id [2],
     SRV_INFO ∗server_info
     );

Arguments

resource

A pointer to a RES_ID structure to receive the ID assigned to the conversation by the interface. Supply this ID on all subsequent verb calls for this conversation.

tp_id

This parameter is a place holder. The functionality represented by this parameter is not implemented.

status_vec

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

shared_res_id

A pointer to a 2-member UINT32 array specifying the internal resource ID maintained by the LU6.2 Server for the conversation the transaction program wishes to transition.

The interface returns this information on the snalu62_attach_listen verb. A transaction program can pass the conversation to another program by passing the program this array. That program can then specify this information when it calls the snalu62_pass_resource verb to receive the passed conversation.

server_info

A pointer to a SRV_INFO structure specifying the LU6.2 Server to utilize. Supply sufficient information to uniquely identify the LU6.2 Server. If this parameter is not specified, the interface attempts to connect to a local server with the name LU62_SRV.

Because the shared_res_id value is internal to the LU6.2 Server, this parameter must specify the same LU6.2 Server information that was specified for the snalu62_attach_listen verb which returned the shared_res_id information.

Description

A conversation can only be transitioned once during a conversation and it must be transitioned prior to any other verb call being made for this conversation.

This verb is available only if the local LU has been defined with the session_activation parameter set to TRUE.

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