GET_TYPE

The GET_TYPE verb returns the conversation type (basic or mapped) of a particular conversation.

VCB Structure

typedef struct get_type
{
 unsigned short    opcode;             /* verb operation code      */
 unsigned char     opext;              /* verb extension code      */
 unsigned char     format;             /* 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     conv_type;          /* conversation type        */
 unsigned char     conv_style;         /* conversation style       */
} GET_TYPE;

Supplied Parameters

The transaction program supplies the following parameters to Personal Communications:
opcode
AP_GET_TYPE
opext
AP_BASIC_CONVERSATION
format
Identifies the format of the VCB. Set this field to one 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
conv_type
Conversation type of the conversation identified by conv_id.

AP_BASIC_CONVERSATION
AP_MAPPED_CONVERSATION

conv_style
Conversation style of the conversation identified by conv_id. This field requires the format 1 version of the VCB. See Full-Duplex VCBs for more details on accessing format 1 VCBs.

AP_HALF_DUPLEX
AP_FULL_DUPLEX

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_TP_ID

AP_BAD_CONV_ID

The conditions generating the following possible primary return codes (primary_rc) are described in APPC Common Return Codes.
  • AP_TP_BUSY
  • AP_UNEXPECTED_SYSTEM_ERROR