Specifying the region start policy

You can use CICS® DA to start a CICS region as a started task, or by submitting JCL in a data set member. The method that is used to start the CICS region is called the start policy. The CICS region must be in the CICS DA system model. You must update the model to provide the information about the start policy before you can start a CICS region. CICS DA submits the processing to run the start policy on the z/OS® system that is associated with the CICS DA connection.

Before you begin

You must have an active CICS DA connection and a local copy of the system model before you can save the start policy. For more information, see Running discovery and loading the system model.

Note: CICS DA issues the z/OS MODIFY command to shut down a CICS region. If your organization uses multiple CICS regions with the same job name, then you cannot stop these regions by using the default stop policy. You must change the default stop policy to the command you use to stop your region. For example, you might change the stop command for the region to be: F jobname.identifier,CEMT P SHUT.

Procedure

  1. In the DA Explorer view, expand the system model to show the CICS region for which you want to record the start policy. Double-click the CICS region, or right-click the region and click Open. The CICS region editor opens showing the details of the selected region.
  2. In the Start Policy section click Specify Start policy. The Specify Start Policy window is displayed.
    A screen capture of the Specify Start Policy window for the region IYK2ZGV8. The data set name for the start policy batch job is shown in the Data Set Name field.
  3. Select the appropriate option and enter the start policy details:
    • If the CICS region is started by submitting a batch job, click Batch Job and enter the data set name in the field. The data set name must be in the following form:
      JT1.CICS42.JCL(LMASGV8)
      JT1.CICS42.JCL contains the data set qualifiers and LMASGV8 is the member name. Alternatively, you can enter one or more of the qualifiers and click Browse to find the data set.

      CICS DA submits the job to run the start policy on the z/OS system that is associated with the CICS DA connection. You might need to edit the JCL and add JES control statements to ensure that the job runs on the correct MVS™ image. For example:

      • For JES2: /*JOBPARM SYSAFF=MVS1
      • For JES3: //*MAIN SYSTEM=MVS1

      For more information about the JCL JES control statements, see the MVS JCL Reference.

    • If the CICS region is started by a started task, click Started Task. In the field, type the start command that is prefixed with the MVS ROUTE command. The MVS ROUTE command ensures that CICS starts on the correct image. For example, if your started task is CICSA and it runs on MVS1, you would type:
      RO MVS1,S CICSA

      For more information about the MVS ROUTE command, see the MVS System Commands Reference.

  4. Click OK to add the start policy to the region editor. Press Ctrl+S, or click the Save icon to save your changes in the model.

Results

The CICS region start policy is updated in the model on the CICS DA server. You can now use the CICS region editor to add the region to a CICSplex, start the region, or clone the region.