TPPCC CONFIRMED

Use the TPPCC general macro with the CONFIRMED verb specified to send a confirmation reply to the remote transaction program. This allows the 2 programs to synchronize their processing. The local z/TPF transaction program can issue this verb when it receives a confirmation request from the remote transaction program. See the WHATRCV parameter of the RECEIVE verb (see TPPCC RECEIVE).

Last updated

Changed for PUT00.

Format

Read syntax diagramSkip visual syntax diagramlabelTPPCCCONFIRMED ,RESID=symbolic_field1reg1,RCODE=symbolic_field2reg2,AMODE= amodedef,AMODE=3164
label
is a symbolic name that can be assigned to the macro statement.
CONFIRMED
directs the TPPCC macro to perform the CONFIRMED verb function.
RESID
specifies the symbolic name of a field or a register that points to a field. This is a 4-byte field in which the resource ID is supplied. This resource ID must be the one assigned on the initial ALLOCATE for this conversation or one that was assigned by an incoming ATTACH.
RCODE
specifies the symbolic name of a field or a register that points to a field. This field is a 6-byte field in which the return code is placed. The return code consists of a 2-byte primary return code followed by a 4-byte secondary return code. The actual values returned are listed in Return conditions.
AMODE
specifies the format that is used by all address parameters. The valid address format values are:
amodedef
is the default value specified by the AMODE parameter of the BEGIN macro. If AMODE is not specified on the BEGIN macro, the default value is 31.
31
indicates addresses are specified in 31-bit format.
64
indicates addresses are specified in 64-bit format.

Entry requirements

  • The conversation must be in one of the following states:
    • received-confirm
    • received-confirm-send
    • received-confirm-deallocate
  • See Entry requirements for the entry requirements relating to the TPPCC macro in general.

Return conditions

  • The results of the verb are indicated by the value returned in RCODE. The valid return codes are listed in the following section, “Return Codes”.
  • See Return conditions for the return conditions relating to the TPPCC macro in general.
  • The following table contains a list of the primary and secondary return codes that can be returned to the program that issued the CONFIRMED verb. A complete list of return codes and their definitions can be found in Table 2 and in Table 3.
    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

  • For information about macro register conventions, see Register conventions.
  • If you specify a register for a keyword value, the register must be enclosed in parentheses and in the range R1–R7.
  • The value supplied in RESID must be the resource ID returned by the ALLOCATE verb or one that was assigned by an incoming ATTACH.
  • A transaction program can issue this verb only as a reply to a confirmation request; the verb cannot be issued at any other time. Transaction programs can use this verb for various application-level functions. For example, the remote program can send data followed by a confirmation request. When the local program receives the confirmation request, it can issue this verb as an indication that it received and processed the data without error.
  • See Programming considerations for the programming considerations relating to the TPPCC macro in general.

Examples

SYMB100   TPPCC CONFIRMED,                         X
                RESID=(R4),                        X
                RCODE=EBW010

Related information

None.