Name

snalu62_attach_listen − Waits for an inbound allocation request for a basic or mapped conversation between a remote (partner) transaction program and a local transaction program over a session between the remote LU and the local LU. 
 
 
 

FORMAT

STATUS_RTN snalu62_attach_listen(
     RES_ID ∗resource,
     TP_ID ∗tp_id,
     UINT32 shared_res_id [2],
     STATUS_VEC status_vec,
     char ∗local_lu_name,
     char ∗remote_lu_alias,
     char ∗mode_name,
     SES_ID session_id,
     TP_NAME ∗tpn,
     UINT32 ∗type,
     UINT32 ∗sync_level,
     SECUR_INFO ∗security,
     BUFFER ∗luwid,
     BUFFER ∗conversation_correlator,
     PIP_DATA ∗pip,
     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. 
 
The interface allocates the memory referenced by the RES_ID structure.  The transaction program must deallocate this memory by using the snalu62_free_mem verb. 
 

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

shared_res_id
 
A pointer to a 2-member UINT32 array to receive the internal resource ID maintained by the LU6.2 Server for the conversation returned by this verb.  The 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. 
 

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

local_lu_name
 
A pointer to a null-terminated ASCII string specifying either the fully-qualified network name or the locally-defined alias of the local LU.
 
 

remote_lu_alias
 
A pointer to a 65-byte char buffer to receive a null-terminated ASCII string indicating the locally-defined name of the remote LU from which the interface received the allocation request. 
 
 

mode_name
 
A pointer to a 9-byte char buffer to receive a null-terminated ASCII string indicating the mode name used to establish the session to the remote LU from which the interface received the allocation request. 
 

session_id
 
A pointer to a SES_ID structure to receive the session identifier of the LU-LU session over which the interface received the allocation request. 
 
 

tpn
 
A pointer to a TP_NAME structure to receive the transaction program name specified in the allocation request.  The translate field of the TP_NAME structure indicates whether the interface translated the transaction program name specified on the allocate request. 
 
The interface allocates the memory referenced by the TP_NAME structure.  The transaction program must deallocate this memory by using the snalu62_free_mem verb. 
 

type
 
A pointer to a UINT32 location to receive a value indicating the type of conversation allocated.  It can be one of the following values:
 

•SNALU62_C_BASIC

•SNALU62_C_MAPPED
 
 

sync_level
 
A pointer to a UINT32 location to receive a value indicating the synchronization level specified in the allocate request.  It can be one of the following values:
 

•SNALU62_C_SL_NONE (the default)

Indicates that the conversation cannot use any confirmation verbs or sync-point processing. 

•SNALU62_C_SL_CONFIRM

Indicates that the conversation can use only confirmation verbs. 

•SNALU62_C_SL_SYNCPT

Indicates that the conversation can use both confirmation verbs and sync-point processing. 
 
 

security
 
A pointer to a SECUR_INFO structure to receive the conversation-level security verification information specified on the allocate request that the local LU uses to validate access to the local program and its resources. 
 
 
Unlike the snalu62_get_tp_properties verb, this call returns the password information.  The interface allocates the memory referenced by the SECUR_INFO structure.  The transaction program must deallocate this memory by using the snalu62_free_mem verb. 
 

luwid
 
A pointer to a BUFFER structure to receive the logical unit of work (LUW) identifier that the interface should use for the conversation.  If the sync_level parameter returns a value of SNALU62_C_SL_SYNCPT, this parameter indicates the protected LUW identifier. Otherwise, this parameter indicates the unprotected LUW identifier. 
 
The interface allocates the memory referenced by the BUFFER structure.  The transaction program must deallocate this memory by using the snalu62_free_mem verb. 
 

conversation_correlator
 
A pointer to a BUFFER structure to receive the conversation correlator that the interface should use for the conversation. 
 
The interface allocates the memory referenced by the BUFFER structure.  The transaction program must deallocate this memory by using the snalu62_free_mem verb. 
 

pip
 
A pointer to a PIP_DATA structure to receive the PIP data received from the remote transaction. 
 
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. 
 

server_info
 
A pointer to a SRV_INFO structure specifying the LU6.2 Server to utilize.  Specify 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, you must specify the same LU6.2 Server information here that you will specify for the snalu62_pass_resource verb . 

Description

 
Use this unarchitected verb to receive inbound allocation requests for transactions which may or may not have been defined with the snalu62_define_tp verb. 
 

Restrictions

 
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.

 
Only a process having superuser privileges or a user listed in the system group in the etc/group file can call this verb. 

 
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

SNALU62_S_UNSUC
verb did not execute successfully