CANCEL_CONVERSATION

The CANCEL_CONVERSATION verb is a control verb that will cancel a connection between a local LU and partner LU using a specific transaction program (tp_id) and a conversation (conv_id).

VCB Structure

The definition of the VCB structure for the CANCEL_CONVERSATION verb is as follows:

typedef struct cancel_conversation
{
 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  */
} CANCEL_CONVERSATION;

Supplied Parameters

The transaction program supplies the following parameters to Communication Server:

opcode: AP_CANCEL_CONVERSATION
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.
conv_id: Conversation identifier. The value of this parameter was returned by the ALLOCATE verb in the invoking transaction program.

Returned Parameters

If the verb executes successfully, Communication Server returns the following parameters:

primary_rc: AP_OK

If the verb does not execute because of a parameter error, Communication Server returns the following parameters;

primary_rc: AP_PARAMETER_CHECK
secondary_rc: AP_BAD_CONV_ID
AP_BAD_TP_ID