Name

snalu62_get_tp_properties − Returns information about the transaction program calling the verb. 
 
 
 

FORMAT

STATUS_RTN snalu62_get_tp_properties(
     RES_ID resource,
     TP_ID tp_id,
     STATUS_VEC status_vec,
     char ∗fully_qualified_local_lu_name,
     char ∗local_lu_alias,
     TP_NAME ∗own_tpn,
     char ∗security_user_id,
     char ∗security_profile,
     BUFFER ∗luwid,
     BUFFER ∗protected_luwid
     );
 
 
 

Valid Conversation States

 
All except Reset
 
 

Arguments

resource
 
A RES_ID structure assigned to the conversation by the interface. This ID was returned by the snalu62_allocate, snalu62_attach_listen, or snalu62_receive_allocate verb. 
 
 

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. 
 
 

fully_qualified_local_lu_name
 
A pointer to a 18-byte char buffer to receive a null-terminated ASCII string indicating the fully-qualified network name of the local LU. 
 
 

local_lu_alias
 
A pointer to a 65-byte char buffer to receive a null-terminated ASCII string indicating the locally-known alias of the local LU. 
 
 

own_tpn
 
A pointer to a TP_NAME structure to receive the local name of the transaction program.  The translate field of this structure indicates whether the transaction program name specified on the snalu62_allocate or snalu62_receive_allocate request was translated. 
 
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. 
 

security_user_id
 
A pointer to an 11-byte char buffer to receive a null-terminated ASCII string indicating the user ID carried on the incoming allocation request that established this conversation. 
 

security_profile
 
A pointer to an 11-byte char buffer to receive a null-terminated ASCII string indicating the profile carried on the incoming allocation request that established this conversation. 
 

luwid
 
A pointer to a BUFFER structure to receive the unprotected logical unit of work (LUW) identifier in use by 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. 
 

protected_luwid
 
A pointer to a BUFFER structure to receive the protected logical unit of work (LUW) identifier in use by 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. 
 

Description

 
Use the snalu62_get_tp_properties verb to find out the current transaction program name. A transaction program can have an unknown name in the following circumstances:
 
 

•The program has multiple conversations and therefore multiple names. 
 

•The program has multiple snalu62_receive_allocate calls outstanding at a time. 
 

•The program was started by an Attach Manager and did not specify a name on the snalu62_receive_allocate verb. 
 
 

Return Values

SNALU62_S_OK
normal successful completion

SNALU62_S_CONVCANC
conversation canceled

SNALU62_S_PARERR
parameter error, function-name

SNALU62_S_PRGPARCHK
program parameter check

SNALU62_S_UNSUC
verb did not execute successfully