Specifying the region stop policy

You can use CICS® DA to stop a CICS region. The method that is used to stop the CICS region is called the stop policy. By default, CICS DA submits the stop command F {jobName},COSD if the region is a CMAS, or F {jobName},CEMT P SHUT for other CICS regions. However, you can change the stop policy for individual regions, in the region editor.
CICS DA submits the processing to run the stop policy on the z/OS® system that is associated with the CICS DA connection.
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.

Before you begin

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

Procedure

  1. In the DA Explorer view, expand the system model to show the CICS region for which you want to record the stop 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 and Stop policies section, click Update stop policy. The Specify stop Policy window is displayed.
    A screen capture of the Specify stop Policy window for the region MUNNSA2. The Default stop policy is selected.
  3. Select the appropriate option and enter the new stop policy details:
    • If the CICS region is stopped 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 stop 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 stopped by issuing a command, click Stop command. In the field, type the stop command that is prefixed with the MVS ROUTE command. The MVS ROUTE command ensures that CICS stops on the correct image.

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

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

Results

The CICS region stop policy is updated in the model on the CICS DA server. You can now click Stop the CICS region editor to stop the region.