HP-UX SNAplus2 NOF Programmer's Guide

NOF API Verbs (ACTIVATE_SESSION to OPEN_FILE)
APING
Chapter 3 137
sense_data If the secondary_rc parameter is
AP_ALLOCATION_FAILURE_NO_RETRY, this parameter
contains the SNA sense data associated with the error.
For all other secondary_rc values, this parameter is
reserved.
Returned Parameters: Conversation Failure
If the verb does not execute because the APPC conversation with the
partner TP failed, SNAplus2 returns the following parameters:
primary_rc AP_CONV_FAILURE_NO_RETRY
The conversation was terminated
because of a permanent condition,
such as a session protocol error.
Check the error log file to determine
the cause of the error. Do not retry
the APING verb until the error has
been corrected.
primary_rc AP_CONV_FAILURE_RETRY
The conversation was terminated
because of a temporary error. Retry
the APING verb. If the problem
occurs again, check the error log file
to determine the cause of the error.
primary_rc AP_DEALLOC_ABEND
The partner TP deallocated the
conversation because of an error
condition. The reason for the error
may be logged on the remote node.
Returned Parameters: Other Conditions
Appendix A, “Common Return Codes,” lists further combinations of
primary and secondary return codes that are common to all NOF verbs.