Adding a CICS bundle to a platform

You can add a CICS® bundle to a platform by selecting a bundle to install and enable in a region type. For example, you might want to add a policy rule that you want to apply to a region type.

Before you begin

The CICS bundle must exist in zFS, in the platform home directory, and must be accessible by the platform. You must have an FTP connection to zFS to retrieve the list of CICS bundles.

About this task

You cannot add a CICS bundle to a platform if it has already been installed in the target region type in the platform, unless the CICS bundle contains only resources that are eligible for multi-versioning. A CICS bundle that contains other resource types cannot be added to a platform if it has already been installed in that region type for an application that is deployed on the platform. The resources that are eligible for multi-versioning, and can therefore be added to a platform as well as to applications that are deployed on a platform, are listed in Creating a CICS Application project.

CICS bundles that are installed as part of platform bundles, or added to a running platform, must not contain declarations of application entry points in the bundle manifest. Application entry points are not supported for CICS bundles installed directly on platforms, and CICS does not enable the application entry points in this situation, although the CICS bundle and its resources are installed. Standalone CICS bundles that are installed directly in CICS regions can contain declarations of application entry points to enable scoping of region level policies.

When you define a TRANSACTION resource in a CICS bundle, and deploy the CICS bundle as part of an application, or add the CICS bundle to a platform, autoinstall of the initial program for the transaction is not supported. For a TRANSACTION resource defined in a CICS bundle that is deployed with a platform, you must define and deploy the PROGRAM resource for the transaction's initial program in one of the following ways:

In a CICS bundle that is deployed with the platform.
As part of an application that is deployed on the platform.
In the CICS regions that are part of the platform, using a standalone CICS bundle, the CICS CSD, or the CICSPlex® SM data repository.

Procedure

In the Cloud Explorer view, right-click a region type from the platform where you want to add the CICS bundle, and click Add Bundle. The ADDBUNDLE operation dialog opens.
Select a target region type from the list of region types for the platform where you want to add the CICS bundle. The default is the region type that you selected in the Cloud Explorer view. Only one target region type can be selected for each request.
Select a CICS bundle from the Platform Bundles list to install in the region type. Only one CICS bundle can be selected for each request. The list of CICS bundles comprises the bundles found in the PLATFORM_HOME/bundles directory on zFS that are not currently installed on the platform.
Click OK. The ADDBUNDLE request is made and any errors are fed back into the dialog.
In the CICS Cloud Perspective, click Window > Show View > Other > CICS SM Operations > Bundles. Alternatively, in the Cloud Explorer view, expand the region types for the platform, then expand the Bundles list for the region type where the CICS bundle is installed. Double-click the management part, or right-click the management part and select Show Installed Bundles. The CICS Bundles view opens.
In the CICS Bundles view, right-click the CICS bundle and select Enable for all instances of the bundle in all of the regions in which it is installed.

Results

The management parts for the CICS bundle are installed in the selected region type.