HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs

APING

3.4.5 Returned Parameters: Allocation Failure

If the verb does not execute because SNAplus2 cannot allocate the APPC conversation, SNAplus2 returns the

following parameters:

primary_rc

AP_ALLOCATION_ERROR

secondary_rc

Possible values are:

AP_ALLOCATION_FAILURE_NO_RETRY

The conversation cannot be allocated because of a permanent condition, such as a conﬁguration error

or session protocol error. Check the

sense_data parameter and the error log ﬁle for more information.

Do not attempt to retry the APING verb until the error has been corrected.

AP_ALLOCATION_FAILURE_RETRY

The conversation could not be allocated because of a temporary condition, such as a link failure. Check

the error log ﬁle for more information. Retry the APING verb, preferably after a timeout to allow the

condition to clear.

AP_SECURITY_NOT_VALID

The user ID or password speciﬁed was not accepted by the partner LU.

AP_TP_NAME_NOT_RECOGNIZED

The partner LU does not recognize the speciﬁed TP name.

AP_TRANS_PGM_NOT_AVAIL_NO_RETRY

The remote LU rejected the allocation request because it was unable to start the requested partner TP.

The condition is permanent. The reason for the error may be logged on the remote node. Do not retry

the APING verb until the cause of the error has been corrected.

AP_TRANS_PGM_NOT_AVAIL_RETRY

The remote LU rejected the allocation request because it was unable to start the requested partner TP.

The condition may be temporary, such as a timeout. The reason for the error may be logged on the

remote node. Retry the APING verb, preferably after a timeout to allow the condition to clear.

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.

3.4.6 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 ﬁle 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 ﬁle to determine the cause of the error.