SNAX/APC Application Programming Manual

Verb Definitions
SNAX/APC Application Programming Manual—138786
3-11
ALLOCATE Verb
Allocation is successful if a session (established under the appropriate mode) is
active, the session is not yet allocated to another conversation, and the local TP has
control of the session.
AL-PARTNER-LUNAME
This field contains the name of the remote LU that supports the remote TP. The
remote LU must be configured as a partner of the local LU. The remote LU name
must be in uppercase letters.
AL-MODENAME
This field contains the name of the mode to be used when this session is established.
The mode name must be in uppercase. If this field is all blanks, the default mode is
implied.
AL-PARTNER-TPNAME
This field contains the name of the remote TP. SNAX/APC uses the remote TP
name in the ATTACH request that it sends to the remote LU. Note that the remote
TP name is not configured in the configuration database. The remote TP name must
be known to the remote LU.
AL-SECURITY-TYPE
This field in an ALLOCATE request format with IPC version code S3 and above
indicates the type of conversational security to be used when allocating the
conversation with the remote partner. The field must contain one of the uppercase
letters N, P, or S.
The letter N indicates that no security is used. The USER-ID and PASSWORD
fields are ignored.
The letter P indicates that both USER-ID and PASSWORD are passed to the remote
partner in the allocate request (FMH-5). The partner performs its own validation of
the user ID and password. If this is specified, both the USER-ID and PASSWORD
fields must be present.
The letter S indicates that only the user ID is passed to the remote partner in the
allocate request (FMH- 5). The user ID is supplied with an already -verified
indicator set. This tells the partner LU that the local application has already verified
the security of the specified user. If this is specified, only the USER-ID field needs
to be present; the PASSWORD field is ignored.
AL-USER-ID
This field specifies the user ID when the SECURITY-TYPE field contains either the
letter P or the letter S. This field is ignored when the SECURITY-TYPE field
contains the letter N.