gtpg2m4gGeneral Macros

TPPCC ACTIVATE_ON_RECEIPT

Use the TPPCC general macro with the ACTIVATE_ON_RECEIPT verb specified to allow the issuing TPF ECB to exit and activate a different ECB at the program specified after information has been received. The information received may be data, conversation status, or a confirmation request. The ACTIVATE_ON_RECEIPT 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_RECEIPT
Directs the TPPCC macro to perform the ACTIVATE_ON_RECEIPT 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.

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 D1 through DA. After the information is received, 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 after the information is received.

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 after the information has been received. 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 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_RECEIPT,        X
                RESID=(R7),                 X
                PARM=(DL,D5),               X
                PGM=(R2),                   X
                RCODE=EBW010
SYMB100   TPPCC ACTIVATE_ON_RECEIPT,        X
                RESID=(R7),                 X
                PARM=(TOKEN,(R6)),          X
                PGM=(R2),                   X
                RCODE=EBW010