gtpc2ma9C/C++ Language Support User's Guide

tppc_confirmed-Send a Confirmation Reply

This function sends a confirmation reply to the remote transaction program. This allows the 2 programs to synchronize their processing. The local TPF transaction program can call this function when it receives a confirmation request from the remote transaction program. See the WHAT_RECEIVED (whatrcv) parameter of the tppc_receive function (tppc_receive-Receive Information).

Format

#include   <tppc.h>
void       tppc_confirmed(unsigned int *resid,
                          struct tppc_return_codes *rcode);

resid
This is a pointer to a 4-byte field that contains the resource ID. This resource ID must be the ID assigned on the initial ALLOCATE for this conversation or one that was assigned by an incoming ATTACH.

rcode
This is a pointer to the structure tppc_return_codes, defined in tppc.h, where the return code is to be placed.

Return Codes

The following table contains a list of the primary and secondary return codes that can be returned to the program that called the tppc_confirmed function. A complete list of the return codes and their definitions can be found in Table 37 and Table 38.

Symbolic Name Primary Code Secondary Code
LU62RC_OK 0000  
LU62RC_PARAMETER_CHECK 0001  
  LU62RC_PK_BAD_TCBID .... 00000001
  LU62RC_PK_BAD_CONVID .... 00000002
LU62RC_STATE_CHECK 0002  
  LU62RC_SKCNFMD_BADSTATE .... 00000041
LU62RC_TPF_ABEND FFFF  

Programming Considerations

Examples

The following example sends a confirmation reply to the remote transaction program.

#include <tppc.h>
 
      unsigned int               resource_id;
      struct   tppc_return_codes return_code;

  ·
  ·
  ·
/* set up resource_id with the value returned from the allocate verb */
  ·
  ·
  ·
tppc_confirmed(&resource_id,&return_code); /* normal processing path */
  ·
  ·
  ·

Related Information