HP-UX SNAplus2 R7 APPC Programmer's Guide

APPC Conversation Verbs
MC_GET_ATTRIBUTES and GET_ATTRIBUTES
The length (0–8 bytes) of the conversation correlator (see the description of the conv_corr parameter for more
information).
conv_corr
The conversation correlator assigned by the invoking TP’s node when the conversation was allocated.
UNIX
For TPs that use Syncpoint processing, the Syncpoint Manager uses this parameter to identify the conversation
during resynchronization processing.
luw_id
The Logical Unit of Work Identifier (LUWID) for the transaction in which this conversation is participating.
This is assigned on behalf of the TP that initiates the transaction, and enables you to correlate the different
conversations that make up the transaction.
A TP that uses Syncpoint processing has two LUWIDs associated with it; the unprotected LUWID is used for
conversations with a sync_level of
AP_NONE or AP_CONFIRM_SYNC_LEVEL, and the protected LUWID is
used for conversations with a sync_level of AP_SYNCPT. A TP that does not use Syncpoint processing has
only one, the unprotected LUWID. This verb returns the LUWID that is associated with this conversation; this
is the protected LUWID if the conversation has a sync_level of AP_SYNCPT, and the unprotected LUWID
otherwise. The application can use the GET_TP_PROPERTIES verb to get both LUWIDs for the TP.
The LUWID consists of the following parameters:
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 following parameter).
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.
luw_id.instance
The instance number associated with the Logical Unit of Work (a 6-byte binary number).
luw_id.sequence
The sequence number of the current segment of the Logical Unit of Work (a 2-byte binary number).
sess_id
The session ID of the session used by this conversation.
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:
149