SNAX/APC Application Programming Manual

Application Prototype Simulator
SNAX/APC Application Programming Manual—138786
4-40
MC-ALLOCATE (F2)
Request Fields
Partner LU Name
specifies the name of the partner LU that supports the partner TP. The partner LU
name must be configured as a partner to the local LU specified in the last
TP-READY verb.
Partner TP Name
specifies the name of the partner TP with which you want to establish a
conversation. SNAX/APC uses the partner TP name in the ATTACH request that it
sends to the partner LU. Note that the partner TP name is not part of the
configuration of the SNAX/APC process. The partner TP name must also be known
to the partner LU. In the CICS environment, for example, the partner TP name is
the CICS TRANSID attribute.
Mode Name
specifies the partner (LU, mode) entry under which the service that this conversation
uses must have been established. The entry, SCF mnemonic PTNR-MODE, must
have been configured for the partner LU, SCF mnemonic PTNR-LU. If this field is
left blank, the default entry for the partner LU is implied.
Sync Level (N,C,S)
specifies the requested synchronization level for the conversation. You can enter
N (None), C (Confirm), or S (Syncpt).
Return Control (AL,IM)
specifies the conditions under which the MC-ALLOCATE request must complete.
If you enter AL, two blank spaces, or leave this field blank, the request completes
when a suitable session is available for the local TP. 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.
Security Type (N,S,P)
specifies the type of access security information on this allocation request. The
value N indicates NONE, which means the access security information is omitted on
this allocation request. This is the default value if the field is left empty. If the
value N is specified, the User ID and Password are discarded.
The value S indicates SAME, which means an already verified notification is sent on
this allocation request. An indicator in the ATTACH request indicates that the local
LU has already verified the User ID and Password.
The value P indicates PGM, which means the access security information provided
by the User ID and Password fields is used.