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.
Procedure
- 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.
- In the Start and Stop policies section, click Update
stop policy. The Specify stop Policy window
is displayed.
- 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.
- 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.