Administration Commands
aping
Possible values are:
ALLOCATION_FAILURE_NO_RETRY
The conversation could not be allocated because of a permanent condition, such as a configuration error or session protocol error. Check the sense_data parameter and the error log file for more information. Do not attempt to retry the aping command until the error has been corrected.
ALLOCATION_FAILURE_RETRY
The conversation could not be allocated because of a temporary condition, such as a link failure. Check the error log file for more information. Retry the aping command, preferably after a timeout to allow the condition to clear.
SECURITY_NOT_VALID
The user ID or password specified was not accepted by the partner LU.
TP_NAME_NOT_RECOGNIZED
The partner LU does not recognize the specified TP name.
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 command until the cause of the error has been corrected.
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 command, preferably after a timeout to allow the condition to clear.
sense_data
If the secondary_rc parameter is ALLOCATION_FAILURE_NO_RETRY, this parameter contains the SNA sense data associated with the error. For all other secondary_rc values, this parameter is not returned.
primary_rc
CONV_FAILURE_NO_RETRY
The APPC conversation with the partner TP 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 command until the error has been corrected.
primary_rc
CONV_FAILURE_RETRY
The APPC conversation with the partner TP was terminated because of a temporary error. Retry the aping command. If the problem occurs again, check the error log file to determine the cause of the error.
primary_rc
DEALLOC_ABEND
The partner TP deallocated the APPC conversation because of an error condition. The reason for the error may be logged on the remote node.
Appendix A, Common Return Codes from snapadmin Commands, lists combinations of primary and secondary return codes that are common to all commands.
48