HP-UX SNAplus2 R7 APPC Programmer's Guide

APPC Conversation Verbs
MC_ALLOCATE and ALLOCATE
Session Not Available
Depending on the value specified for rtn_ctl, APPC may return the following parameter:
primary_rc
AP_UNSUCCESSFUL
The supplied parameter rtn_ctl specified immediate (AP_IMMEDIATE) return of control to the TP, and
the local LU did not have an available contention-winner session.
Allocation Error
If SNAplus2 cannot allocate the conversation, APPC 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 configuration error
or session protocol error. To determine the error, the System Administrator should examine the error
log file. Do not attempt to retry the allocation until the error has been corrected.
This value is also returned if the session corresponding to the requested conversation group ID is no
longer active.
AP_ALLOCATION_FAILURE_RETRY
The conversation could not be allocated because of a temporary condition, such as a link failure. The
reason for the failure is logged in the system error log. Retry the allocation, preferably after a timeout
to allow the condition to clear.
AP_FDX_NOT_SUPPORTED_BY_LU
The duplex_type parameter was set to AP_FULL_DUPLEX, but the LU used by this TP does not support
full-duplex operation.
For information about these secondary return codes, see Appendix B, Common Return Codes.
AP_SEC_BAD_PROTOCOL_VIOLATION
AP_SEC_BAD_PASSWORD_EXPIRED
AP_SEC_BAD_PASSWORD_INVALID
AP_SEC_BAD_USERID_REVOKED
AP_SEC_BAD_USERID_INVALID
AP_SEC_BAD_USERID_MISSING
AP_SEC_BAD_PASSWORD_MISSING
AP_SEC_BAD_UID_NOT_DEFD_TO_GRP
AP_SEC_BAD_UNAUTHRZD_AT_RLU
AP_SEC_BAD_UNAUTHRZD_FROM_LLU
AP_SEC_BAD_UNAUTHRZD_TO_TP
AP_SEC_BAD_INSTALL_EXIT_FAILED
AP_SEC_BAD_PROCESSING_FAILURE
sense_data
SNA sense data giving more information about the cause of the allocation failure.
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 return codes are:
primary_rc
117