[MC_]GET_ATTRIBUTES
The GET_ATTRIBUTES verb returns the attributes of the conversation.
VCB Structure
typedef struct get_attributes
{
unsigned short opcode; /* verb operation code */
unsigned char opext; /* verb extension code */
unsigned char format; /* verb format */
unsigned short primary_rc; /* primary return code */
unsigned long secondary_rc; /* secondary return code */
unsigned char tp_id[8]; /* TP identifier */
unsigned long conv_id; /* conversation identifier */
unsigned char reserv3; /* reserved */
unsigned char sync_level; /* sync_level */
unsigned char mode_name[8]; /* mode name */
unsigned char net_name[8]; /* network name of local LU */
unsigned char lu_name[8]; /* local LU name */
unsigned char lu_alias[8]; /* local LU alias */
unsigned char plu_alias[8]; /* partner LU alias */
unsigned char plu_un_name[8];
/* partner LU uninterpreted name */
unsigned char reserv4[2]; /* reserved */
unsigned char fqplu_name[17];
/* fully qualified partner LU */
/* name */
unsigned char reserv5; /* reserved */
unsigned char user_id[10]; /* user identifier */
unsigned long conv_group_id; /* conversation group identifier */
unsigned char conv_corr_len; /* conversation correlator */
/* length */
unsigned char conv_corr[8]; /* conversation correlator */
unsigned char reserv6[13]; /* reserved */
} GET_ATTRIBUTES;typedef struct mc_get_attributes
{
unsigned short opcode; /* verb operation code */
unsigned char opext; /* verb extension code */
unsigned char format; /* verb format */
unsigned short primary_rc; /* primary return code */
unsigned long secondary_rc; /* secondary return code */
unsigned char tp_id[8]; /* TP identifier */
unsigned long conv_id; /* conversation identifier */
unsigned char reserv3; /* reserved */
unsigned char sync_level; /* sync_level */
unsigned char mode_name[8]; /* mode name */
unsigned char net_name[8]; /* network name of local LU */
unsigned char lu_name[8]; /* local LU name */
unsigned char lu_alias[8]; /* local LU alias */
unsigned char plu_alias[8]; /* partner LU alias */
unsigned char plu_un_name[8]; /* partner LU uninterpreted name */
unsigned char reserv4[2]; /* reserved */
unsigned char fqplu_name[17]; /* fully qualified partner LU */
/* name */
unsigned char reserv5; /* reserved */
unsigned char user_id[10]; /* user identifier */
unsigned long conv_group_id; /* conversation group identifier */
unsigned char conv_corr_len; /* conversation correlator */
/* length */
unsigned char conv_corr[8]; /* conversation correlator */
unsigned char reserv6[13]; /* reserved */
} MC_GET_ATTRIBUTES;Supplied Parameters
The transaction program supplies the following parameters to Personal Communications:
- opcode
- AP_B_GET_ATTRIBUTES
AP_M_GET_ATTRIBUTES
- opext
- AP_BASIC_CONVERSATION or AP_MAPPED_CONVERSATION.
On full-duplex conversations, this flag must be ORed together with AP_FULL_DUPLEX_CONVERSATION.
- format
- Identifies the format of the VCB. Set this field to zero to specify the version of the VCB listed above.
- tp_id
- Identifier for the local transaction program
The value of this parameter was returned by the TP_STARTED verb in the invoking transaction program or by RECEIVE_ALLOCATE in the invoked transaction program.
- conv_id
- Conversation identifier.
The value of this parameter was returned by the ALLOCATE verb in the invoking transaction program or by RECEIVE_ALLOCATE in the invoked transaction program.
Returned Parameters
If the verb executes successfully, Personal Communications returns the following parameters:
- primary_rc
- AP_OK
- sync_level
- Synchronization level of the conversation.
AP_CONFIRM_SYNC_LEVEL
AP_NONE - mode_name
- Name of the set of networking characteristics associated with the session allocated to the conversation. This is an 8-byte alphanumeric type-A EBCDIC string (starting with a letter), padded to the right with EBCDIC spaces.
- net_name
- Name of the network containing the local LU. This is an 8-byte alphanumeric type-A EBCDIC string (starting with a letter), padded to the right with EBCDIC spaces.
- lu_name
- Name of the local LU. This is an 8-byte alphanumeric type-A EBCDIC string (starting with a letter), padded to the right with EBCDIC spaces.
- lu_alias
- Alias by which the local LU is known to the local transaction program. This is an 8-byte string in a locally displayable character set. All 8 bytes are significant and must be set.
- plu_alias
- Alias by which the partner LU is known to the local transaction program. This is an 8-byte string in a locally displayable character set. All 8 bytes are significant and must be set.
- plu_un_name
- Uninterpreted name of partner LU, that is, the name of the partner LU as defined at the system services control point (SSCP). This is an 8-byte type-A EBCDIC character string.
- fqplu_name
- Fully qualified name of the partner LU. This name is 17 bytes long and is right-padded with EBCDIC blanks. It is composed of two type-A EBCDIC character strings concatenated by an EBCDIC dot. (Each name can have a maximum length of 8 bytes with no embedded blanks. If the network ID is not present, then omit the dot.)
- user_id
- User ID sent by the invoking transaction program through the ALLOCATE verb to access the invoked transaction program (if applicable). This is a 10-byte type-AE EBCDIC character string, padded to the right with EBCDIC spaces.
- conv_group_id
- The conversation group identifier of the session allocated to the conversation.
- conv_corr_len
- Always set to 0.
Range: 0–8
- conv_corr
- Always set to 0.
If the verb does not execute because of a parameter error, Personal Communications returns
the following parameters:
- primary_rc
- AP_PARAMETER_CHECK
- secondary_rc
- AP_BAD_CONV_ID
AP_BAD_TP_ID
The conditions generating the following possible primary return codes (primary_rc) and indented secondary return codes (secondary_rc) are described in APPC Common Return Codes.
- AP_TP_BUSY
- AP_CONVERSATION_TYPE_MIXED
- AP_DUPLEX_TYPE_MIXED
- AP_UNEXPECTED_SYSTEM_ERROR