HP-UX SNAplus2 R7 APPC Programmer's Guide

APPC Conversation Verbs
MC_ALLOCATE and ALLOCATE
If you use this value, the tp_id supplied on this [MC_]ALLOCATE verb must be the same as the one that
was returned on the RECEIVE_ALLOCATE verb when this TP was invoked.
UNIX
This value can also be used if your TP was not invoked by another TP, but has obtained and verified the
appropriate security information by another means (for example from the HP-UX user name and password
supplied during logon). In this case, APPC uses the HP-UX user name with which the application is running,
truncated to 10 characters if necessary, as the user ID for conversation security; ensure that this name consists
of valid AE-string characters (see the description of the user_id parameter for more information) and is a
valid user name for the TP being invoked.
If the TP has obtained the security information by another means (for example by requesting the user to type
in a valid user ID and password before allocating the conversation), it should use SET_TP_PROPERTIES to
specify this user ID to APPC before issuing [MC_]ALLOCATE.
pwd
Password associated with user_id.
This parameter is required only if the security parameter is set to AP_PGM or AP_PGM_STRONG; otherwise
it is reserved.
The pwd and user_id parameters must match a user ID/password pair configured on the computer where the
invoked TP is located.
This parameter is a 10-byte EBCDIC character string; it is case-sensitive. The pwd parameter can consist of
characters from the type-AE EBCDIC character set. These characters are as follows:
• Uppercase and lowercase letters
• Numerals 0–9
• Special characters $, #, @, and period (.)
If the password is fewer than 10 bytes, use EBCDIC blanks (0x40) to pad it on the right.
user_id
User ID required to access the partner TP.
This parameter is required only if the security parameter is set to AP_PGM or AP_PGM_STRONG; otherwise
it is reserved.
The pwd and user_id parameters must match a user ID/password pair configured on the computer where the
invoked TP is located.
This parameter is a 10-byte EBCDIC character string; it is case-sensitive. The user_id parameter can consist
of characters from the type-AE EBCDIC character set. These characters are as follows:
• Uppercase and lowercase letters
• Numerals 0–9
• Special characters $, #, @, and period (.)
If the user ID is fewer than 10 bytes, use EBCDIC blanks (0x40) to pad it on the right.
pip_dlen
Length of the program initialization parameters (PIP) to be passed to the partner TP. The range for this value
is 0–32,767.
Not all APPC implementations support PIP data. Set pip_dlen to 0 (zero) if the partner TP is using an
implementation of APPC that does not support PIP data, or if the partner is a CPI-C application.
pip_dptr
114