NAME

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

LIBRARY

 
/usr/shlib/libsnatprm.so
 
 
 

SYNOPSIS

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

Valid Conversation States

 
HDX: All

FDX: All
 
 

SUPPLIED PARAMETERS

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. 
 
 

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. 
 
 
 

RETURNED PARAMETERS

remote_lu_alias

A pointer to a 65-byte char buffer to receive the 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 that received a Bracket Initiation Stopped (BIS), Logical Unit STATus message (LUSTAT), Request To Receive (RTR) or a request unit (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. 
 
 
 

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_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: None

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