Checking the status of an application

The status information for an application shows whether the CICS® bundles for the application are present and enabled in the CICS regions associated with the region type in the platform.

About this task

The status information for an application is derived from the status of the individual management parts for the application. A management part is a MGMTPART record that is created automatically during the application install process. Management parts record the relationship between the application and each installed CICS bundle, and the region type where each CICS bundle is installed in the platform.

Procedure

  1. In the CICS Explorer® menu bar, click Operations > Cloud Explorer to display the Cloud Explorer view, and switch to the application hierarchy. The view shows the overall status for each application. The application is enabled if the CICS bundles referenced by the management parts for the application have been installed in the CICS regions, and all of them are enabled.
  2. View the management parts for the application and check on the status of each individual CICS bundle. In the Cloud Explorer view, working with the application hierarchy, expand each region type displayed under the application to show the Bundles list for the region type. Expand each Bundles list to display the management parts for the application. The status for each management part shows whether the CICS bundle is in an enabled or disabled state in the CICS regions, or if the CICS bundle has not been installed properly.

Results

Table 1 shows the possible values for the status of an application, and their meanings:
Table 1. Application status values
Status value Meaning
ENABLING All the management parts for the application are in the process of being enabled
ENABLED All the management parts for the application are enabled
DISABLING All the management parts for the application are in the process of being disabled
DISABLED All the management parts for the application are disabled
SOMEDISABLED Some of the management parts for the application are disabled
INSTALLING The application is being installed, and it cannot be enabled or disabled at this time
DISCARDING The application is being discarded, and it cannot be enabled or disabled at this time
FAILED A problem occurred during install or discard of the application
INCOMPLETE Some of the management parts for the application are empty or have an invalid scope
EMPTY None of the management parts for the application are installed
Table 2 shows the possible values for the status of a management part, and their meanings:
Table 2. Management part status values
Status value Meaning
ENABLING The CICS bundle is in the process of being enabled
ENABLED The CICS bundle is installed and enabled in all of the CICS regions
DISABLING The CICS bundle is in the process of being disabled
DISABLED The CICS bundle is disabled in all of the CICS regions
SOMEDISABLED The CICS bundle is disabled in some of the CICS regions
IMPORTONLY The CICS bundle is installed and enabled in all of the CICS regions, but it only contains import statements, so does not affect the status of the application
INCOMPLETE The CICS bundle is installed in some, but not all, of the CICS regions
INVALIDSCOPE The CICS system group specified for installing the CICS bundles does not exist, so no CICS bundles are installed
EMPTY The CICS bundle is not installed in any of the CICS regions

What to do next

If the status of the application is not as expected, follow the procedure in Diagnosing application errors to diagnose the problem and take suitable action.