Capturing the region start policy

CICS® DA can start a CICS region as a started task or by submitting JCL in a data set member. The method that is used is called the CICS region start policy. The CICS region must be in the system model and you must update the model to provide the information about the start policy for the 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 a CICS DA project that contains the system model. See Discovering and creating the system model for more information.

Procedure

  1. In the DA Projects view, double-click the CICS region, or right-click and click Open. The CICS region editor opens showing the details of the selected region.
  2. In the Start Policy section select either the Batch Job or Started Task radio button, depending on how the CICS region is started.
    A screen capture showing the CICS Region editor. The Start Policy section is on the right and in the example, the Batch Job radio button is selected.
  3. In the Start Policy section, select one of the following choices:
    • If the CICS region is started by submitting a batch job, select the Batch Job radio button and enter the data set name in the text field. The data set name must be in the following form:
      NB1.TEST.JCL(TESTMAS)
      Where NB1.TEST.JCL are the data set qualifiers and TESTMAS 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 execute the start policy on the z/OS system associated with the CICS DA connection, so you might need to edit the JCL and add JES control statements to ensure the job runs on the correct MVS™ image. For example:

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

      See the MVS JCL Reference for more information about the JCL JES control statements.

    • If the CICS region is to be started by a started task, select the Started Task radio button. In the text field type the start command 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

      See the MVS System Commands Reference documentation for more information about the MVS ROUTE command.

  4. Click Ctrl+S to save your changes.

Results

The CICS region start policy is added to the model.

What to do next

If the CICS region is not running you can start the CICS region by right-clicking the region in the model and clicking Start region.