SNAX/APC Application Programming Manual

Application Prototype Simulator
SNAX/APC Application Programming Manual—138786
4-13
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 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 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. If you enter IM, a conversation is
established only if a suitable session is immediately available; otherwise, the request
completes unsuccessfully.
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 if specified.
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.