HP-UX SNAplus2 R7 APPC Programmer's Guide

APPC Control Verbs
SET_TP_PROPERTIES
Generate a new unprotected LUWID.
AP_NO
Set the TP’s unprotected LUWID to the one supplied on this verb.
unprot_id
If set_unprot_id is set to AP_YES and new_unprot_id is set to AP_NO, this structure specifies the new
unprotected LUWID for the TP; otherwise this structure is reserved. The structure contains the following
parameters:
unprot_id.fq_length
The length (1–17 bytes) of the fully qualified LU name associated with the Logical Unit of Work (the
LU name itself is specified by the following parameter)
unprot_id.fq_luw_name
The fully qualified LU name associated with the Logical Unit of Work. This name is a 17-byte EBCDIC
string, padded on the right with EBCDIC spaces. It consists of a network ID of 1–8 A-string characters,
an EBCDIC dot (period) character, and an LU name of 1–8 A-string characters.
unprot_id.instance
The instance number associated with the Logical Unit of Work (a 6-byte binary number).
unprot_id.sequence
The sequence number of the current segment of the Logical Unit of Work (a 2-byte binary number).
set_user_id
Specifies whether APPC is to modify the user ID. Possible values are:
AP_YES
Modify the user ID for this TP.
AP_NO
Leave the user ID unchanged.
set_password
Specifies whether APPC should modify the password associated with the new_password parameter. Possible
values are:
AP_YES
APPC should modify the password.
AP_NO
APPC should not modify the password.
user_id
If set_user_id is set to AP_YES, this parameter specifies the new user ID; otherwise it is reserved.
new_password
If set_password is set to AP_YES, this parameter specifies the new password; otherwise it is reserved.
3.6.3 Returned Parameters
After the verb executes, APPC returns parameters to indicate whether the execution was successful and, if not, to
indicate the reason the execution was not successful.
100