SNAX/APC Application Programming Manual

Verb Definitions
SNAX/APC Application Programming Manual—138786
3-12
ALLOCATE Verb
AL-PASSWORD
This field contains the password when the SECURITY-TYPE field contains the
letter P. This field is ignored when the SECURITY-TYPE field contains either the
letter N or the letter S.
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 ALLOCATE is the first conversation verb issued. After that, only basic verbs
may be issued in the ensuing conversation.
•
SNAX/APC does not always return immediate notification that an 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 it flushes the data buffer by
issuing a CONFIRM, RECEIVE-AND-WAIT, SEND-DATA, or 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
ALLOCATE must be issued for each conversation.