HP-UX SNAplus2 R7 APPC Programmer's Guide

APPC Control Verbs
GET_LU_STATUS
AP_OK
active_sess
Specifies the number of sessions currently active between the local LU and the specified partner LU.
zero_sess
Specifies whether the number of active sessions between the two LUs has dropped to 0 (zero) at any time
since the last GET_LU_STATUS verb was issued. Possible values are:
AP_YES
The session count has dropped to 0 (zero).
AP_NO
At least one session has been active at all times since the verb was last issued.
Unsuccessful Execution
If the verb does not execute successfully, APPC returns a primary return code parameter to indicate the type of
error and a secondary return code parameter to provide specific details about the reason for unsuccessful execution.
Parameter Check
If the verb does not execute because of a parameter error, APPC returns the following parameters:
primary_rc
AP_PARAMETER_CHECK
secondary_rc
Possible values are:
AP_BAD_TP_ID
The value of tp_id did not match a TP identifier assigned by APPC.
AP_INVALID_FORMAT
The reserved parameter format was set to a nonzero value.
AP_SYNC_NOT_ALLOWED
The application issued this verb within a callback routine using the synchronous APPC entry point.
Any verb issued from a callback routine must use the asynchronous entry point.
State Check
No state check errors occur for this verb.
Other Conditions
If the verb does not execute because other conditions exist, APPC returns primary return codes (and, if applicable,
secondary return codes). For information about these return codes, see Appendix B, Common Return Codes.
Possible values are:
primary_rc
AP_COMM_SUBSYSTEM_ABENDED
AP_INVALID_VERB
AP_TP_BUSY
AP_UNEXPECTED_SYSTEM_ERROR
APPC does not return secondary return codes with these primary return codes.
3.4.4 State When Issued
The conversation can be in any state except Reset when the TP issues this verb.
92