HP-UX SNAplus2 R7 APPC Programmer's Guide

APPC Control Verbs
GET_TP_PROPERTIES
verified
Specifies whether conversation security has been verified for this conversation. Possible values are:
AP_YES
Conversation security has been verified. The invoking TP supplied a user ID (returned as the
user_id
parameter on this verb), and either supplied a valid password or indicated that conversation security
had already been verified.
AP_NO
Conversation security has not been verified. The invoked TP does not require a user ID and password.
user_id
The user ID associated with the TP. This is a 10-byte type-AE EBCDIC string, padded on the right with
EBCDIC spaces if the ID is shorter than 10 bytes. The password is not returned on this verb; it is returned
on the RECEIVE_ALLOCATE verb.
UNIX
prot_luw_id
The protected Logical Unit of Work Identifier (LUWID) for the transaction in which the TP is participating.
The protected LUWID is used to correlate protected conversations (those with a sync_level of
AP_SYNCPT).
It consists of the following parameters:
prot_luw_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_luw_id.fq_luw_name parameter)
prot_luw_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_luw_id.instance
The instance number associated with the Logical Unit of Work (a 6-byte binary number).
prot_luw_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
Possible values are:
AP_BAD_TP_ID
96