HP-UX SNAplus2 R7 APPC Programmer's Guide

APPC Conversation Verbs
MC_SEND_CONVERSATION and SEND_CONVERSATION
The invoked TP does not use conversation security. (If you use this value, the invoked TP must be
configured not to use conversation security.)
AP_PGM
The invoked TP uses conversation security and thus requires a user ID and password. Supply this
information through the user_id and pwd parameters.
AP_PGM_STRONG
The invoked TP uses conversation security and thus requires a user ID and password. In addition,
setting
AP_PGM_STRONG stipulates that SNAplus2 encrypts the password when sending it across the
network. Supply the user ID and password through the user_id and pwd parameters.
AP_SAME
Use this value when your TP was invoked by another TP, using a valid user ID and password, and is now
invoking a third TP which also requires conversation security. (The situation in which one TP invokes
a second TP which then invokes a third TP is illustrated in Section 1.1.9, Multiple Conversations). This
value tells the third TP (the invoked TP) that conversation security has already been verified for the
first invoking TP.
If you use this value, the tp_id supplied on this [MC_]SEND_CONVERSATION verb must be the same
as the one that was returned on the RECEIVE_ALLOCATE verb when this TP was invoked.
UNIX
This value may 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)
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 request-
ing 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_]SEND_CONVERSATION.
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.
211