When you deprovision a CICS® region, CICS DA guides you through the
process and automates steps where possible. CICS DA displays the details of the associated
JCL and data sets that can be deleted, for you to select.
Before you begin
Before you deprovision a CICS region,
ensure that the region is stopped.
Procedure
- In the CICS DA Explorer
view, right-click the CICS region
that you want to remove and click Deprovision Region. The Deprovision a CICS
region wizard opens. The fields in the page are populated, showing all of the details
that are associated with the CICS region that you might want
to delete. You can select from the available list of JCL and JCL members.
Note: For some regions, CICS DA might not find the system definition that associates the
region with a CICSplex SM. If this is case, the system definition is removed from the CICS DA model.
- Select the CICS region
JCL that you want to remove. Also, select the related data set JCL
members, from the displayed list, that you want to delete. Click Next. CICS DA checks your selections. If there are any
problems with your selections, a warning message is displayed. For example, if a data set member is
shared with another CICS region you see a message warning
that the JCL member is shared and cannot be removed. Clear the check box that you were warned about
and click Next again. The second window in the deprovision wizard opens.
- From the list of data sets displayed, select the data sets
that you want to remove. Click Finish. Again, CICS DA
checks your selections. If there are any problems with your selections,
a warning message is displayed. For example, if a data set is shared
with another CICS region you
see a message warning that the data set is shared and cannot be removed.
Clear the check box that you were warned about.
- Click Finish to remove the CICS region.
Results
When you click Finish, depending
on what you selected to remove, CICS DA
runs the following tasks:
- Removes the selected CICS region
JCL.
- Removes the selected PROC members.
- Removes the selected INCLUDE members.
- Removes the selected SYSIN members.
- Removes the selected EYUWUI members.
- Removes the selected EYUPARM members.
- Deallocates the selected data sets.
If any of the steps fail, an error message is displayed.
You must review the error message to determine the cause of the failure.
All
of the deprovision details are shown in the Console view
and are written to the audit log. Check the report to ensure that
all of your selected entities were processed. If there are any reported
errors, you might need to remove the JCL members or data sets manually.