When you clone a CICS® region
that is started as a batch job, CICS DA
guides you through the process and automates steps where possible. CICS DA proposes new names for
data sets and jobs, but you can change these names. However, you must
provide some values, such as the new APPLID. The clone process creates
a batch job to start the new region.
Before you begin
Ensure that the CICS region
you want to clone is running, and that the region start policy is
recorded and saved in the model. For more information about recording
the start policy, see Specifying the region start policy.
Important: You must ensure that the data set, where you want
to create the new region startup JCL, exists before you start the
clone operation.
Procedure
- In the DA Explorer view, right-click the CICS region that you want to clone and click Clone
Region. You can also click Clone CICS Region in
the region editor. The Clone a CICS Region wizard opens. The fields in the page that
is displayed are populated, showing the details of the CICS
region you are cloning.
- Change the values to provide unique attributes and specify the start policy for the new CICS region. You can select the Name Transform rule
set that you want CICS DA to apply during the
clone operation. If you want to view or modify the rules before cloning a CICS region, see Creating a name transform rule set.
You can also specify JCL procedures that you want to run Before or
After the clone process. These JCL procedures can be used to extend the clone
process by performing additional actions to suit your enterprise.
When you are finished, click Next.
The Edit region target page opens. The Edit region
target page is where you specify the location for your new region. If you are cloning an
unmanaged region, then the page contains only the z/OS system
selection.
- When the fields are complete and there are no reported CICS DA errors, click Next.
- Select the target z/OS system
and, if available, the group and owning CMAS. Click Next.
The page is updated to show the data sets used by the original CICS region. The page also shows the proposed name for the new CICS and, if you are cloning a managed region, the CICSPlex® SM data sets that CICS DA creates, and the share status of the data sets. CICS DA reviews all of the data sets in the original CICS region and attempts to identify any naming convention that you use. This information is
used to propose new data set names for the new region, but these names are overridden by an
applicable name transform rule if a name transform rule set is applied.
- Review the proposed names for the new data sets. You can
choose to keep the proposed data set names or type over them in the
page. You can choose to share some data sets between the two regions
by selecting the Share check box:
- If the new data set name is not available, and the Share check
box is preselected but is not available, the data set must be shared.
- If the new data set name is not available, and the Share check
box is preselected but available, it is suggested that the data set
is shared. If you choose to clear the check box and not share the
data set, a new data set is created, with the name in the New
Data set column.
- If the new data set name and the Share check
box are both available, you must either accept the proposed name,
share the data set, or change the data set name.
- If the new data set name is available and the Share check
box is not available, then you cannot share the data set. However,
you can change the data set name.
Note: The new cloned CICS region does not have to share the CICS system definition (CSD) data set.
By default, the DFHCSD Share check box is selected. To use a different CSD,
clear the Share check box for the DFHCSD and enter the CSD name in the
New Data set column. If the CSD does not exist, you can create the data set
after the clone operation completes.
- Click Next. The
page is updated to show any JCL PROC, INCLUDE, SIT, or EYUPARM members
that exist in the original started task, and the proposed name for
the new members that CICS DA
creates.
- Review the proposed member names. You can choose to keep
the proposed member names or type over them in the page.
- Click Finish to save the settings
and complete the clone operation.
Results
When you click Finish, CICS DA runs the following tasks:
- Check to ensure that the new data sets and JCL data set members
do not exist in the target z/OS system.
- Allocate the data sets and, where necessary, initialize them.
- Create the JCL to start the new CICS region,
if necessary.
- Create new JCL INCLUDEs and other input members if necessary.
- If the region is a managed region, then the following extra tasks
are run:
- Add the region to the chosen CICSPlex SM
definitions.
- Add the region to the selected groups.
If any of the steps fail, CICS DA
backs out all the changes and any new data sets are deleted. An error
message is displayed in the page that identifies the failure. You
must review the error message to determine the cause of the failure,
and then try the operation again.
If the steps are successful, CICS DA then adds the new
region to your CICSPlex SM definitions and to the system
model. Finally, the CICS region editor opens showing details
of the CICS region, and a report is shown in the Console
view, and also written to the audit log.
What to do next
You might need to take some further steps before you start
the new CICS region. CICS DA is unable to identify or
run some actions, such as defining the region to your security policy,
and some connectivity steps. When CICS DA
completes all that it can do, a report is posted to the Console view.
The report identifies the setup that was done, and the further steps
that you must take. The report provides the following information:
- An indication that the job completed successfully, showing the
original and new region name
- An indication as to which CICSplex the new region was added
- A list of the WLM and RTA specifications that the region is associated
with
- The job name for the new region JCL
- The member name and qualifiers for the new region JCL
- A list of the SIT overrides that were updated in the new JCL
- A list of the SIT members that were created
- A list of the EYUPARM values, if applicable, that were updated
in the new JCL
- A list of the EYUPARM members, if applicable, that were created
- A list of the JCL members that were created
- A list of SIT overrides that must be applied manually
- A list of SIT members that must be created manually
- A list of the EYUPARM values, if applicable, that must be applied
manually
- A list of the EYUPARM members, if applicable, that must be created
manually
- A list of the JCL Include members that must be created manually
- A list of the CICSPlex SM
definitions that might require attention
- The report also identifies some other tasks that you might consider
running for the new region. Examples include security definitions, CICS profile, task tables, VTAM® APPLID.
CICS DA stores the details about the cloned CICS region. If you want to remove the CICS region, in the future, these details are used by the deprovision
operation.