CICS region editor

The CICS® region editor shows information about the selected CICS region, such as the job name, APPLID, and start policy. There are two CICS region editors: Managed CICS Region editor and Unmanaged CICS Region editor. Basic information about the region is common to both editors, but the Managed CICS Region editor also contains CICSPlex® SM management information. You can also clone a managed region from the Managed CICS Region editor.

The view name identifies the name of the object and the object type. In the following screen capture of a Managed CICS Region editor, the object that is shown is called IYCWEFE1 and it is a Region.

A screen capture of a region editor. The view shows the following sections: Details, Start, and Stop Policy Last known status, CICSPlex SM, Subsystems, System Groups, and CICS connectivity.

Note: When you add an unmanaged CICS region to a CICSplex, CICSPlex SM definitions are added to the JCL that starts the region, and a CSYSDEF is created in the CMAS. CICS DA does not stop and restart the CICS region, so if a discovery is run before the region restarts, the region might be shown as a Managed region, but without a managing CMAS. If this occurs, check that the JCL is correct, and stop and restart the CICS region.

The following screen capture shows an example of the Unmanaged CICS Region editor:

Use the Tag field to add one or more tags to the model element. For more information about tagging, see Tagging the elements in a model.

Table 1. Fields in the Details section
Field Description
APPLID The APPLID of the region.
Job The job name.
Program The name of the region startup program.
Version The version of CICS.
z/OS System The z/OS® System where the region is running. You can click the hyperlink to show details of the z/OS System in the z/OS System editor.
CICSplex (Managed region only) The CICSplex that the region is part of.
MAS (Managed region only) The MAS name.

Table 2. Fields in the Last known status section
Field Description
Status The last known status of the managed region.
User The user that started the job.
Job ID The ID of the CICS job. If the region is running, you can click the hyperlink to show details of the running job in the z/OS Job view.
Start region Click Start to start the region. The start job is not submitted unless a start policy is defined. If you click Start when the region is running, the start job is held until the region next stops.
Stop Region Click Stop to stop the region. Start is active only when the region is active.
Table 3. Fields in the Start Policy section
Field Description
No start policy specified This message indicates that start policy is not recorded for this region. Click Specify Start policy to enter the start policy type and details.
Stop policy (default stop command) This message indicates that stop policy is set to the default for this region. Hover over the text to show the default stop policy. Click Update stop policy to change the stop policy type and details.
Batch Job This field is visible only if the region is started by a batch job. The field shows the data set name of the job that is used to start the region. Click Browse to locate the job. When the batch job is recorded, you can click the batch job hyperlink to browse or edit the job.
Started task This field is visible only if the region is started by a start command. The field shows the start command that is used to start the region.

Table 4. Fields in the CICSPlex SM section
Field Description
CMAS (Managed region only) The CMAS that this region is connected to.
MON Spec (Managed region only) The name of the monitor specification that is associated with this region.
RTA Spec (Managed region only) The name of the Real Time Analysis (RTA) specification that is associated with this region.
WLM Spec (Managed region only) The name of the Workload Management (WLM) specification that is associated with this region.
Add to CICSplex (Unmanaged region only) Click Add to CICSplex to install CICSPlex SM definitions in the CICS region and add the region to an existing CICSplex. For more information about adding a CICS region to a CICSplex, see Adding a CICS region to a CICSplex.

Table 5. Fields in the Subsystems section (Managed region only)
Field Description
DB2® The name of the DB2 subsystem that is associated with this region.
MQ The name of the WebSphere® MQ subsystem that is associated with this region.
IMS™ The name of the IMS subsystem that is associated with this region.

In the Managed CICS Region editor, you can click Clone CICS Region to create a copy of the managed CICS region. For more information about cloning, see Cloning a CICS region.

The Managed CICS Region editor also shows the CICS system groups that the managed region is a member of, and other CICS regions that this region is connected to. You can select a CICS region in the CICS Connectivity section and click Open to open the region in the resource editor.