Installing an application definition and enabling the application

To make an application available on a platform, you install an application definition and enable the application. The CICS® bundles that are deployed as part of the application are created in the CICS regions.

Before you begin

An application definition, which specifies an application bundle and an application binding, must exist, and the platform must be configured. See Creating an application definition.

Procedure

  1. Open the CICS Cloud perspective.
  2. In the Cloud Explorer view, right-click the application that you want to install and click Install.
  3. Click OK to install the application in the platform. Refresh the Cloud Explorer view, and the application name appears.
  4. When you are ready to make the application available for use, in the Cloud Explorer view right-click the application and click Enable.
  5. Click OK to enable the application.

Results

When you install the application definition, CICSPlex SM creates an APPLCTN resource to represent the application in the CICSplex. CICSPlex SM also creates a record for the application in the data repository, which is used in recovery processing for the bundles for applications.

If the target platform is active, CICSPlex SM uses the information in the application bundle and the application binding to install the CICS bundles across the regions in the platform. Each BUNDLE resource is dynamically created and is given a unique name. The resources that are defined inside each CICS bundle are dynamically created in the CICS regions during the BUNDLE resource installation.

The relationship between the application and each installed CICS bundle is saved in a management part. The management part is a MGMTPART record that is created automatically for each CICS bundle during the application install process. It records the CICS regions where the bundle is installed, and tracks the status of the bundle in the CICS regions.

When you install an application in an active platform, CICSPlex SM installs the CICS bundles immediately in all the CICS regions that are defined as part of the platform, and available at the time when you install the application definition. CICSPlex SM also installs the CICS bundles in CICS regions in the platform if you start or restart the regions after the time when you install the application definition. If you add further CICS regions to the platform after the time when you install the application definition, CICSPlex SM installs the CICS bundles in those regions as well.

An application is initially installed in a disabled state. When you enable the application, CICSPlex SM enables the CICS bundles that were installed for the application in all the CICS regions, so that the application is available for use in all the CICS regions. If you start or restart a CICS region in the platform after the time when you enable the application, CICSPlex SM installs the bundles in that region in an enabled state.

What to do next

Click Operations > Applications to view the installed application and check its status. Checking the status of an application explains how to do this. The application status shows whether the CICS bundles for the application were successfully installed and enabled.