gtpg2m4fGeneral Macros

TPPCC ACTIVATE_ON_CONFIRMATION

Use the TPPCC general macro with the ACTIVATE_ON_CONFIRMATION verb specified to allow the issuing TPF ECB to exit after sending out a CONFIRM, DEALLOCATE TYPE=CONFIRM, or PREPARE_TO_RECEIVE TYPE=CONFIRM request. TPF/APPC then activates a different ECB at the program specified when the reply to the CONFIRM request has arrived and been processed. The ACTIVATE_ON_CONFIRMATION verb is a TPF extension to the LU 6.2 architecture.

Format




label
A symbolic name can be assigned to the macro statement.

ACTIVATE_ON_CONFIRMATION
Directs the TPPCC macro to perform the ACTIVATE_ON_CONFIRMATION 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.

VERB
Specifies the verb function that is to be executed. The value must be one of the following:

CONFIRM
Specifies that the function of the CONFIRM verb should be executed.

DEALLOCATE
Specifies that the function of the DEALLOCATE verb with TYPE=CONFIRM should be executed.

PREPARE_TO_RECEIVE
Specifies that the function of the PREPARE_TO_RECEIVE verb with TYPE=CONFIRM should be executed.

PARM
Specifies the parameter information to be passed to the new ECB. The type of information is based on the option specified, which must be one of the following:

DL
Specifies a TPF data level within the range D0 through DA. After the reply to the CONFIRM request arrives and is processed, the contents of the working storage block on the data level specified is passed from the ECB issuing this verb to a 4K block on the same data level of the ECB created.

TOKEN
Specifies the symbolic name of a field or a register that points to a field. This is an 8-byte field that is saved and passed to EBX000 of the new ECB that is created when the reply to the CONFIRM request has arrived and been processed.

PGM
Specifies the symbolic name of a field or a register that points to a field. This is a 4-byte field containing the TPF real-time program segment to be activated when the reply to the CONFIRM request has arrived and been processed. This TPF real-time segment must be defined in the TPF transaction program name table (TPNT) as an ACTIVATE_ON_RECEIPT target program. This is done with the ITPNT macro by specifying TYPE = AOR and by specifying the segment name as both the TPN name and the PGM name. See ITPNT-Transaction Program Name Table Macro for more information about the ITPNT macro.

RCODE
Specifies the symbolic name of a field or a register that points to a field. This 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.

Entry Requirements

Return Conditions

Programming Considerations

Examples

SYMB100   TPPCC ACTIVATE_ON_CONFIRMATION,   X
                RESID=(R7),                 X
                VERB=CONFIRM,               X
                PARM=(DL,D5),               X
                   PGM=(R2),                   X
                   RCODE=EBW010
SYMB100   TPPCC ACTIVATE_ON_CONFIRMATION,   X
                RESID=(R7),                 X
                VERB=PREPARE_TO_RECEIVE,    X
                PARM=(TOKEN,(R6)),          X
                PGM=(R2),                   X
                RCODE=EBW010