SNAX/APC Application Programming Manual

Verb Definitions
SNAX/APC Application Programming Manual—138786
3-48
MC-ALLOCATE Verb
Request Details
MC-AL-HEADER
This is a template containing the REQ-UOW-ID and the REQ-VERB-CODE. This
is the standard SNAX/APC request header and is defined at the beginning of this
section.
RESERVED-1
This is a field reserved for future use. It must contain a 0 or one space (ASCII 32).
MC-AL-SYNC-LEVEL
This field indicates the sync level at which the conversation should be allocated.
This field must contain the letter N for no synchronization level, C for confirm
synchronization or S for sync point support. The letters must be in uppercase.
When SNAX/APC receives a BIND request for an LU-LU session, it saves the
accompanying synchronization-level information. The synchronization level
specified in ALLOCATE must not be greater than the one received with the BIND
request.
MC-AL-RET-CONTROL
This field must contain either the value “AL,” “IM,” or “ ” to be valid.
MC-AL-RET-CONTROL indicates when control should be returned to the TP
which is issuing the MC-ALLOCATE. The value of “AL” indicates that control
should be returned when the session is allocated, whereas a value of “IM” indicates
that control should be returned immediately. The value “IM” indicates that if a first
speaker session is available, the ALLOCATE completes immediately. If a first
speaker session is not available the verb will complete immediately with a return
code of RC-UNSUCCESSFUL.
MC-AL-PARTNER-LUNAME
This contains the name of the remote LU that supports the remote TP.
MC-AL-MODENAME
This field contains the name of the mode that the remote TP should use to access a
bind image. If nothing is specified in this field, the remote TP uses its default mode.
Reply Format
01 MC-ALLOCATE-REP.
02 MC-ALR-HEADER.
03 REP-UOW-ID PIC X(2).
03 REP-VERB-CODE PIC 9(4) COMP.
03 REP-RETURN-CODE PIC S9(4) COMP.
03 REP-RETURN-CODE-DETAIL PIC S9(4) COMP.