SNAX/APC Application Programming Manual
Verb Definitions
SNAX/APC Application Programming Manual—138786
3-50
MC-ALLOCATE Verb
Return Codes
The following return code can be returned in HEADER-RETURN-CODE of the IPC
HEADER:
OUT-OF-RESOURCES
The following return codes can be returned in REP-RETURN-CODE of
ALR-HEADER:
RC-OK
RC-UNSUCCESSFUL
RC-ALLOCATION-ERROR (with one of the following detail codes)
RCD-ALLOC-FAIL-NO-RETRY
RCD-ALLOC-FAIL-RETRY
RCD-SYNC-LEVL-NOT-SUPPTD
RC-PARAMETER-ERROR (with one of the following detail codes)
RCD-INVALID-PARTNER-NAME
RCD-INVALID-MODENAME
RCD-SYNCLVL-NOT-SUPPTD
RCD-IMPROPER-SYNCLEVEL
RCD-PSHEADER-NOT-SUPPTD
Considerations
•
An MC-ALLOCATE is the first conversation verb issued. If it is used, only mapped
verbs may be issued in the ensuing conversation.
•
SNAX/APC does not always return immediate notification that an MC-ALLOCATE
request with the AL-RET-CONTROL field equal to %H0000, two blank spaces, or
the characters AL failed. A return code indicating success for such a request only
indicates that SNAX/APC was able to obtain a session with the remote LU. Some
types of allocation errors, such as TP-NOTAVAIL-RETRY, are returned on a
subsequent verb reply. SNAX/APC can detect remote TP errors only when the local
TP attempts to send data to the remote TP; that is, when the TP flushes the data
buffer by issuing an MC-CONFIRM, MC-RECEIVE-AND-WAIT, MC-SEND-
DATA, or MC-SEND-ERROR verb.
•
SNAX/APC supports parallel sessions. In order to establish simultaneous
conversations from the same LU to one or more partner LUs, a TP-READY and
MC-ALLOCATE must be issued for each conversation.
•
If an MC-ALLOCATE verb is issued with the AL-RET-CONTROL field set to
%H0000, two spaces, or AL, SNAX/APC waits for a session with the specified
partner, using the specified mode, to become free.
•
If an MC-ALLOCATE verb is processing when SNAX/APC receives a CANCEL
system message from the application program, SNAX/APC replies to the cancelled
IPC immediately. The MC-ALLOCATE verb is allowed to finish normally. After