HP-UX SNAplus2 R7 APPC Programmer's Guide

APPC Control Verbs
RECEIVE_ALLOCATE
State Check
If the conversation is in the wrong state when the TP issues this verb, APPC returns the following parameters:
primary_rc
AP_STATE_CHECK
secondary_rc
AP_ALLOCATE_NOT_PENDING
APPC did not find an incoming Allocate (from the invoking TP) to match the combination of TP name,
LU alias, or both supplied by the RECEIVE_ALLOCATE verb. The RECEIVE_ALLOCATE verb
waited for the incoming Allocate and eventually timed out. For more information, see Section 3.3.7,
Avoiding Waits and Section 3.3.8, Routing for Incoming Attaches.
This return code also occurs if you attempt to start a TP that is defined in the invokable TP data file as
nonqueued. A nonqueued TP is started automatically by SNAplus2 in response to an incoming Attach;
if you attempt to start it manually, the RECEIVE_ALLOCATE verb fails because no incoming Attach
is waiting for the TP.
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
AP_COMM_SUBSYSTEM_ABENDED
AP_COMM_SUBSYSTEM_NOT_LOADED
AP_UNEXPECTED_SYSTEM_ERROR
WINDOWS
AP_STACK_TOO_SMALL
AP_INVALID_VERB_SEGMENT
APPC does not return secondary return codes with these primary return codes.
3.3.5 State When Issued
This must be the first APPC verb issued by the invoked TP. The initial state is Reset.
A single invoked TP can issue multiple RECEIVE_ALLOCATE verbs; each starts a logically different APPC TP,
although all of them are executing in the same process.
3.3.6 State Change
If the verb executes successfully (primary_rc is
AP_OK), the state changes to Receive (for a half-duplex conversation)
or Send_Receive (for a full-duplex conversation).
3.3.7 Avoiding Waits
If the invoked TP issues a RECEIVE_ALLOCATE verb and a corresponding incoming Allocate (resulting from
the [MC_]ALLOCATE verb issued by the invoking TP) is not present, the invoked TP waits until the incoming
Allocate arrives or until the verb times out. The default is to wait indefinitely for an incoming Allocate; this can
be overridden by configuring the TP with a timeout of 0 (zero) (RECEIVE_ALLOCATE fails unless an incoming
89