NAME

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

LIBRARY

 
/usr/shlib/libsnatprm.so
 
 
 

SYNOPSIS

 
#include <sna/snatprmdf.h>
 
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
       );
 
 

Valid Conversation States

 
HDX: Reset

FDX: Reset
 
 

SUPPLIED PARAMETERS

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 wants 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 use. 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 that returned the shared_res_id information. 

RETURNED PARAMETERS

resource

A pointer to a RES_ID structure to receive the resource 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. 
 
 
 

DESCRIPTION

RESTRICTIONS

 
A conversation can only be transitioned once during a conversation and it must be transitioned before any other verb call is 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_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

 
None

RELATED INFORMATION

 
Functions: snalu62_receive_allocate

Manuals: Compaq SNA APPC/LU6.2 Programming Interface for Tru64 UNIX Programming