[MC_]CONFIRMED

The CONFIRMED verb replies to a confirmation request from the partner transaction program. It informs the partner transaction program that the local transaction program has not detected an error in the received data.

Because the transaction program issuing the confirmation request waits for a confirmation, the CONFIRMED verb synchronizes the processing of the two transaction programs.

VCB Structure

typedef struct confirmed
{
 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 */
} CONFIRMED;
typedef struct mc_confirmed
{
 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 */
} MC_CONFIRMED;

Supplied Parameters

The transaction program supplies the following parameters to Personal Communications:
opcode
AP_B_CONFIRMED
Displays basic verb icon.
AP_M_CONFIRMED
Displays mapped verb icon.
opext
AP_BASIC_CONVERSATION or AP_MAPPED_CONVERSATION. For nonblocking operation, this flag can be ORed together with AP_NON_BLOCKING.
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 processor or by RECEIVE_ALLOCATE in the invoked transaction processor.

Returned Parameters

If the verb executes successfully, Personal Communications returns the following parameter:
primary_rc
AP_OK
If the verb is nonblocking and has not completed, Personal Communications returns the following parameters:
primary_rc
AP_OPERATION_INCOMPLETE
opext
AP_OPERATION_INCOMPLETE_FLAG
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
AP_CONFIRMED_INVALID_FOR_FDX

If the conversation is in the wrong state when the transaction processor issues this verb, Personal Communications returns the following parameters:
primary_rc
AP_STATE_CHECK
secondary_rc
AP_CONFIRMED_BAD_STATE
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
  • AP_CONVERSATION_TYPE_MIXED