Removing a CICS region from a region type

Remove a CICS® region from a platform to scale down the capacity of an active platform. You can also remove shared CICS regions from any region types in the platform where they are no longer required, to modify your platform’s architecture.

About this task

Follow this procedure if your platform is already installed and active in the CICSplex. For more information about platform status, see Checking the status of a platform. If you have created a platform bundle but not yet installed it, use the platform editor to modify the platform bundle to change the CICS regions that are included in the platform. For instructions to do this, see The platform editor.

Procedure

Use the Cloud Explorer view in the CICS Cloud perspective to view the active platform. Expand the platform to view the region types. To view the CICS regions that are included in each region type, expand the region type, and then expand the Regions list to view the CICS regions.
Shut down the CICS region that you want to remove from the platform or from the region type. To shut down a CICS region, in the Regions view, right-click the CICS region and select Shutdown. Alternatively, shut down the CICS region using CICSPlex® SM or CICS commands.
Refresh the Cloud Explorer view and confirm that the status of the region is INACTIVE.
Working in the relevant region type, right-click the CICS region that you want to remove from the region type, and select Remove from Region type. Click OK to confirm the remove operation.

Results

The new status of the CICS region that you removed depends on whether it was a shared region that was included in other region types.

When you remove a created CICS region that was only included in one created region type, the system definition (CSYSDEF) for the CICS region is deleted. The created CICS region is therefore no longer part of the platform, and it cannot be started because it does not have the required CSYSDEF.
When you remove a created CICS region that is also included in another region type (a shared region), the CICS region continues to exist in the other region type. It is only removed from the region type and the associated CICSPlex SM system group (CSYSGRP) where you selected the Remove from Region type action. If it is now only included in one region type, it is no longer a shared region.
When you remove an adopted CICS region that was only included in one adopted region type, the CICS region continues to exist in the CICSplex. However, it is no longer an adopted region and is no longer part of the platform.
When you remove an adopted CICS region that is also included in another region type (a shared region), the CICS region continues to be an adopted region in the other region type. It is only removed from the region type and the associated CICSPlex SM system group (CSYSGRP) where you selected the Remove from Region type action. If it is now only included in one region type, it is no longer a shared region.

What to do next

If the CICS region is still part of your platform, to continue using the region, start the region using your normal method. If necessary, use the COLM transaction to connect the CICS region to CICSPlex SM. Refresh the Cloud Explorer view and confirm that the status of the region is ACTIVE. When you start the CICS region, the appropriate CICS bundles for the region type are installed in the region, and it is available for the workload in the platform.

If you removed an adopted CICS region that was only included in one adopted region type in the platform, to continue using the region outside the platform, start the region using your normal method.

If you removed a created CICS region that was only included in one created region type in the platform, choose what to do with the CICS region now that it is no longer part of the platform.

If you do not want to use the created CICS region again, delete the data sets and other resources that were created for the region.
If you do want to use the CICS region again as a CICSPlex SM MAS, create a new CSYSDEF for it so that it can be started and connected to CICSPlex SM. For instructions to do this, see Planning CICS system definitions in the CICS TS V5.2 product information.
If you want to use the CICS region again, but you do not want it to be managed by CICSPlex SM, reverse the steps that you performed to make the CICS region into a MAS, so that it can be started independently. For the list of steps, see Setting up a CICS managed application system (MAS) in the CICS TS V5.2 product information.

If you receive any error messages when you attempt to remove a CICS region from a region type, follow the procedure in Diagnosing platform runtime errors to resolve the issue.