Each invocation of a Rule Search API must include the address of the Real-Time TCT. The address of the Real-Time TCT is obtained using macro CTTGTCT.

Use the following call statement to invoke macro CTTGTCT:

CTTGTCT    TCTADDR=tctaddr,TEST=ACT

where

• tct-addr is the address of a full‑word field to contain the address of the Real-Time TCT that is returned by macro CTTGTCT. Optional. If no value is specified for this parameter, the address of the Real-Time TCT is returned in general register 1.
• TEST is an explicit request to check if Control‑M/Tape is active. A value of ACT must be specified for this parameter.

Macro CTTGTCT alters the values in general registers 0, 1, and 15. If programs at your site depend on the integrity of values in these registers, it is recommended that you save their values before running macro CTTGTCT and restore them after the macro is completed.

Return Codes

The CTTGTCT macro returns one of the following return codes in general register 15:

Table 244 Return Codes for Macro CTTGTCT

Sample TCT Address Request

The following sample demonstrates how macro CTTGTCT is called to obtain the address of the Real‑Time TCT:

Figure 82 Sample TCT Address Request

          CTTGTCT TCTADDR=ACTVTCT,TEST=ACT

          LTR     R15,R15                                Active TCT obtained ?    

          BNZ     TCTFAIL                                No - Terminate

          L       R12,ACTVTCT

          USING   TCT,R12

 .

          .

TCTFAIL   WTO     ‘TCT NOT FOUND OR NOT ACTIVE, PROGRAM TERMINATED’

          .

          .

          COPY    CTTSSVT                                   | For use by

CVT       CVT     DSECT=YES,PREFIX=YES                      | Macro

          IEFJSCVT                                          | CTTGTCT

          IEFJESCT                                          |

ACTVTCT   DS      A                                         Address of TCT

          .

TCT       DSECT

          COPY    CTTTCT                                    TCT mapping