HP-UX SNAplus2 R7 APPC Programmer's Guide

APPC Control Verbs
SET_TP_PROPERTIES
Successful Execution
If the verb executes successfully, APPC returns the following parameters:
primary_rc
AP_OK
prot_id
If set_prot_id and new_prot_id are both set to AP_YES, this structure specifies the new protected LUWID
for the TP, as generated by APPC. The structure contains the following parameters:
prot_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 prot_id.fq_luw_name parameter)
prot_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.
prot_id.instance
The instance number associated with the Logical Unit of Work (a 6-byte binary number).
prot_id.sequence
The sequence number of the current segment of the Logical Unit of Work (a 2-byte binary number).
unprot_id
If set_unprot_id and new_unprot_id are both set to AP_YES, this structure specifies the new unprotected
LUWID for the TP, as generated by APPC. 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 unprot_id.fq_luw_name 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).
Unsuccessful Execution
If the verb does not execute successfully, APPC returns a primary return code parameter to indicate the type of
error and a secondary return code parameter to provide specific details about the reason for unsuccessful execution.
Parameter Check
If the verb does not execute because of a parameter error, APPC returns the following parameters:
primary_rc
AP_PARAMETER_CHECK
secondary_rc
101