SNAX/APC Application Programming Manual

Verb Definitions
SNAX/APC Application Programming Manual—138786
3-10
ALLOCATE Verb
Request Details
REQ-UOW-CODE
This field must contain the value 1001, which identifies the ALLOCATE verb.
AL-PARTNER-TP-TYPE
This field indicates whether the remote TP can use mapped or basic conversational
verbs. If this field contains the letter B or is blank, the partner TP must use basic
conversation verbs. If this field contains the letter M, the partner TP can use
mapped conversation verbs.
Note that if you use a mixed-mode conversation, the remote TP can send mapping
information along with other data; the local TP must be able to distinguish between
user data and mapped conversation information.
AL-SYNC-LEVEL
This field indicates the requested synchronization level for the conversation. 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.
AL-RET-CONTROL
This field indicates the conditions under which the ALLOCATE request will
complete.
The value %H 0000 (decimal zero), two blank spaces, or the characters AL specify
that the request will wait until the local TP has control of a session before
completing.
The characters IM specify that the request completes immediately, with a return
code indicating whether the allocation was successful or not. The value IM
indicates that if a first speaker session is available, the ALLOCATE will complete
immediately. If a first speaker session is not available, the verb will complete
immediately with a return code of RC-UNSUCCESSFUL.
Reply Format
?SECTION ALLOCATE-REP,TANDEM
01 ALLOCATE-REP.
02 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.