SNAX/APC Application Programming Manual

Verb Definitions
SNAX/APC Application Programming Manual—138786
3-49
MC-ALLOCATE Verb
MC-AL-PARTNER-TPNAME
This field indicates the name of the remote TP to be used in the ATTACH request
that is sent to the remote LU. The remote TP name must be known to the remote
LU.
MC-AL-SECURITY-TYPE
This field in an MC-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.
RESERVED-2
This is a field reserved for future use. It must contain a 0 or one space (ASCII 32).
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.
AL-PASSWORD
This field contains the password when the SECURITY-TYPE field contains the
letter P. This field is ignored when the SECURITY-TYPE field contains either the
letter N or the letter S.
Reply Details
MC-ALR-HEADER
This is the standard SNAX/APC DDL definition for reply headers and contains the
reply UOW-ID, the reply verb code, the reply return code, and the reply return code
detail information.