Name

snalu62_get_event − Waits for one of a set of events to occur on one or more sessions associated with a local LU. 
 
 
 

FORMAT

STATUS_RTN snalu62_get_event(
     STATUS_VEC status_vec,
     char ∗local_lu_name,
     char ∗remote_lu_alias,
     UINT32 ∗event,
     SES_ID session_id,
     SRV_INFO ∗server_info
     );
 
 
 

Arguments

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 the fully-qualified network name or the locally-defined alias of the local LU.
 
 

remote_lu_alias
 
A pointer to a char buffer to receive a 65-byte null-terminated ASCII string specifying the locally-defined name of the remote LU with which this event is associated.  The interface returns this parameter when the value of the event parameter is SNALU62_C_CONTACT_LOST. 
 
 

event
 
A pointer to a UINT32 location to receive a value indicating the event received. It can be one of the following values:
 

•SNALU62_C_IMPLIED_FORGET

The interface received an "implied forget" indication on the session indicated by the session_id parameter.  The local SPS process may have a resynchronization responsibility as a result of this message. 

•SNALU62_C_CONTACT_LOST

The interface lost contact with the remote LU indicated in the remote_lu_alias parameter. All sessions between the local LU and the remote LU are terminated. 

•SNALU62_C_SES_LOST_WITHOUT_BIS

The interface lost the session indicated by the session_id parameter. 
 
 

session_id
 
A pointer to SES_ID location to receive the session identifier information of a session which has received a Bracket Initiation Stopped (BIS), Logical Unit STATus message (LUSTAT), Request To Receive (RTR) or an RU with the Begin Bracket Indicator (BBI) set. The interface returns this parameter when the value of the event parameter is SNALU62_C_IMPLIED_FORGET or SNALU62_C_SES_LOST_WITHOUT_BIS. 
 
 

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. 
 
 
 

Description

 
The transaction program can use this verb to test for certain interface events that would otherwise go undetected by the transaction program.
 

Restrictions

 
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