Deprovisioning a CICS region

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

  1. In the CICS DA Explorer view, right-click the CICS region that you want to remove and click Deprovision Region.
    Screen capture that shows the Deprovision Region option
    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.
    A screen capture of the Deprovision a CICS Region window, which shows the region details.
  2. 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.
    A screen capture of the Deprovision a CICS region window that shows the list of data sets to remove that you can select.
  3. 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.
  4. 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.