R1: Control-M/Restart Simulation facility

The Control-M/Restart Simulation Facility simulates restart or data set cleanup processing under Control-M/Restart. It can be used to validate the results of Control-M/Restart processing and the AutoEdit variable resolution of the job before the job is run in the production environment.

Simulation enables you to see what actions are taken by Control-M/Restart without Control-M/Restart performing updates. The Simulation facility adds a CONTROLR step to the job stream before the edited job is submitted. The job runs and then stops after the CONTROLR step; the utility adds a step that prevents the execution of the other steps in the job. No updates are performed.

Note: In simulation mode, Control-M/Restart submits the entire job. The operating system does not "know" when the job is submitted that the only step that will run is the Control-M/Restart step. The result is that the operating system does its standard look-ahead file allocation processing. This may cause the system to call for tape mounts when the job starts to execute. No data on these files will be lost, nor will the tapes be uncataloged or scratched.

The output of the simulation process is a standard print file containing

• input control statements
• messages about the analyzed submitted job

The output shows relevant data, such as which data sets are uncataloged, how GDG adjustments are performed, from which step the job is restarted, and so on.

The Simulation facility is available only for jobs run under Control-M.

The Control-M/Restart Simulation panel (Figure 2) can be displayed in the following ways:

• Select Option R1 in the IOA Online Utilities menu. The IOA Online Utilities menu is displayed by requesting Option 6 on the IOA Primary Option menu under ISPF, or by activating CLIST IOAUTIL from the TSO Command Processor.
• Activate CLIST CTRCSIM from the TSO Command Processor.

To exit the Control-M/Restart Simulation panel without activating the utility, press END (PF03/PF15).

Figure 2 Control-M/Restart Simulation Panel

------------------------- Control-M/RESTART SIMULATION -----------------------

COMMAND ===>

ACTION REQUIRED: ===> R - Restart Simulation

P - Prevent NCT2 Simulation

TRACE MODE: ===> . . . . . . . . .

OPERATION MODE: ===> J - JCL, S - SCHEDULE

JCL LIBRARY MODE:

JCL LIBRARY ===> CTM.PROD.JCL

MEMBER NAME ===>

SCHEDULE LIBRARY MODE:

SCHEDULING LIBRARY MODE ===> CTM.PROD.SCHEDULE

TABLE NAME ===> JOB NAME ===>

RESTART PARAMETERS:

ORDER ID ===>

FROM PGMSTEP ===> TO PGMSTEP ===>

FROM PROCSTEP ===> TO PROCSTEP ===>

AUTOEDIT PARAMETERS:

OWNER ===> N45

GLOBAL AUTOEDIT LIBRARY ===> CTMP.PROD.PARM

WDATE ===> 08 08 00 (DD MM YY)

ODATE ===> 08 08 00 (DD MM YY)

ENTER YES TO CONTINUE ===>

Either of two types of Control-M/Restart processing can be requested:

• To request job restart simulation, specify R (Restart) in the ACTION REQUIRED field.
• To request Prevent-NCT2 processing simulation, specify P (Prevent NCT2) in the ACTION REQUIRED field.

The CTRCSIM utility operates in either JCL Library mode or Scheduling Library mode, according to the parameters you specify in the utility panel: