HP-UX SNAplus2 R7 APPC Programmer's Guide

APPC Control Verbs
GET_LU_STATUS
Note
If two or more TPs are using the same combination of local LU and partner LU, it is
important that only one of them issues this verb. SNAplus2 maintains the zero sessions
indicator for each pair of LUs independently of the TPs using them, and resets it each time
this verb is issued. This means that, if the session count drops to
0 (zero) and then sessions
are reactivated, and two TPs subsequently issue GET_LU_STATUS, only the first TP will
be notified of the zero session count. If multiple TPs using the same LUs need to check
LU and session status, they should do so using NOF verbs; refer to the
HP-UX SNAplus2
NOF Programmer’s Guide for more information.
3.4.1 VCB Structure: GET_LU_STATUS
The definition of the VCB structure for the GET_LU_STATUS verb is as follows:
typedef struct get_lu_status
{
AP_UINT16 opcode;
unsigned char opext; /* Reserved */
unsigned char format; /* Reserved */
AP_UINT16 primary_rc;
AP_UINT32 secondary_rc;
unsigned char tp_id[8];
unsigned char plu_alias[8];
AP_UINT16 active_sess;
unsigned char zero_sess;
unsigned char reserv3[7];
} GET_LU_STATUS;
3.4.2 Supplied Parameters
The TP supplies the following parameters to APPC:
opcode
AP_GET_LU_STATUS
tp_id
Identifier for the local TP.
The value of this parameter is returned by the TP_STARTED verb in the invoking TP or by RE-
CEIVE_ALLOCATE in the invoked TP.
plu_alias
Alias by which the partner LU is known to the local TP. This is an 8-byte ASCII character string.
3.4.3 Returned Parameters
After the verb executes, APPC returns parameters to indicate whether the execution was successful and, if not, to
indicate the reason the execution was not successful.
Successful Execution
If the verb executes successfully, APPC returns the following parameters.
primary_rc
91