Runtime Operations Phase › Runtime Steps

Runtime Steps

Before You Begin:

For related information, see the specific appendices.

• z/OS Job Control Language for z/OS JCL.
• z/VSE Job Control Language for z/VSE JCL.
• Runtime Messages for a discussion of the codes. returned to the Total application program running in the transparency environment

Note: For more information about runtime operations, see the CA IDMS System Operations Guide.

What To Do

To execute a Total application program with the CA IDMS TOTAL Transparency runtime interface, perform the steps below.

Step 1: Assemble and Link Edit ETOTTBL Output

Assemble and link edit ETOTTBL output generated by ETOTMAIN.

Perform this step once to store the control table in the load library for use with all Total application programs. It is not repeated for each Total application program that uses the runtime interface.

Step 2: Modify the Total Application Program

Modify the Total application program to remove any Total DML functions not supported by the runtime interface (see Total Features Supported).

Step 3: Recompile the Total Application Program

Recompile the Total application program if it has been modified.

Step 4: Assemble the ETOTCINT Macro

Assemble the ETOTCINT macro if CICS applications will use the transparency to access the CA IDMS/DB database.

The syntax for the ETOTCINT macro used to generate the ETOTCINT module is shown below. You only need to assemble this macro once. Subsequently, it can be used with all Total CICS applications to access the CA IDMS/DB database.

►►── ETOTCINT CWADISP= cics-cwa-displacement ─────────────────────────────────►

 ►──┬───────────────────────────┬─────────────────────────────────────────────►◄
    └─ ,NAME= ─┬─ ETOTCINT ───┬─┘
               └─ csect-name ─┘

Parameters

CWADISP=cics-cwa-displacement

Specifies the displacement, in bytes, of the transparency work area within the CICS CWA area. Specify the same value given to the CWADISP operand when you assembled the CICSOPT macro to create your CICSOPTS module.

NAME=ETOTCINT/csect-name

Specifies the name of the generated module. The default is ETOTCINT. If specified, csect-name must be a 1- to 8-character alphanumeric value.

Step 5: Create Your CICS Interface Module

Most parameters for the CICSOPT macro are described in the System Operations guide. Parameters specific to the Total/T interface are described below.

Syntax

►►───┬───────────────────────────┬─────────────────────────────────────►
     └─ ,ESCTOT= ─┬─ YES ──────┬─┘
                  └─── NO ◄────┘

 ►── ,ESCTBL= ──┬─ total-control-table──┬──────────────────────────────►◄
                └─ ETOTTBL ◄────────────┘

For more information about this topic, see Creating the CICS CA IDMS/DB Interface (IDMSINTC) for z/OS and Creating the CICS CA IDMS/DB Interface (IDMSINTC) for z/VSE.

Parameters

ESCTOT=YES/NO

Specifies whether the IDMSINTC interface supports TOTAL/T. YES should be specified. The default is NO.

ESCTBL=ETOTTBL/total-control-table

Specifies the name of the load module containing the control table generated by ETOTMAIN. The default is ETOTTBL.

Step 6: Link Edit the Compiled Total Application

Link edit the compiled Total application program with the following transparency and CA IDMS/DB modules:

• ETOTBINT (batch only) or ETOTCINT (CICS only)—The runtime interface module that passes translated database calls to CA IDMS/DB. ETOTBINT is supplied as an object module with the transparency; ETOTCINT is supplied as a macro that must be assembled prior to runtime.
• ETOTTRAN (batch only)—The runtime interface module (supplied in object form) that translates Total database calls to CA IDMS/DB database calls.
• IDMS (batch only)—The CA IDMS/DB module that will receive database calls passed by ETOTBINT.
• IDMSOPTI (batch only)—The (optional) CA IDMS/DB module that passes runtime information to the CA IDMS/DB central version that will handle database calls issued by the runtime interface of the transparency. IDMSOPTI is used to indicate the mode of operation.

Step 7: Execute the Total Application

Execute the Total application as per standard CA IDMS/DB runtime procedures.