Checking the status of a platform

The status information for a platform shows whether the platform is active, and whether the CICS® bundles for the platform are present and enabled in the CICS regions for the platform.

About this task

The STATUS setting for a platform is derived from the status of the CICS regions in the region types. This value shows whether the platform is active, partially active, or inactive, depending on whether or not the CICS regions are active.

The ENABLESTATUS setting for a platform is derived from the status of the management parts for the CICS bundles that are installed with the platform. This value shows whether the CICS bundles that were installed with the platform are present and enabled in the CICS regions for the platform. A management part is a MGMTPART record that is created automatically during the platform installation process. Management parts record the relationship between the platform 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 platform hierarchy. The view shows a hierarchy of platforms, applications, and region types, and their overall status. The platform is enabled if there is at least one active CICS region in every region type, and the CICS bundles referenced by the management parts for the platform are installed in the CICS regions.
  2. In the Cloud Explorer view, expand the region types for the platform, then expand the Regions list for each region type to view the CICS regions and their status. The view shows whether each CICS region is active or inactive. Double-click on a CICS region to display and work with the region in the Managed Regions view.
  3. View the management parts and check on the status of each individual CICS bundle that is deployed . In the Cloud Explorer view, expand the region types for the platform, then expand the Bundles list for each region type, which displays the management parts for the CICS bundles installed with the platform. 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

The Cloud Explorer view showing the platform hierarchy

Table 1 shows the possible values for the status of a platform, and their meanings:
Table 1. Platform status values
Status value Meaning
ACTIVE There is at least one active CICS region in every region type associated with the platform.
PARTIAL At least one but not all region types have no active CICS regions or regions that are able to manage platform resources.
INACTIVE All region types have no active CICS regions that support the PLATFORM object.
Table 2 shows the possible values for the enable status of the platform, and their meanings:
Table 2. Platform enable status values
Status value Meaning
ENABLING All the management parts for the platform are in the process of being enabled.
ENABLED All the management parts for the platform are enabled.
DISABLING All the management parts for the platform are in the process of being disabled.
DISABLED All the management parts for the platform are disabled.
SOMEDISABLED Some of the management parts for the platform are disabled.
INSTALLING The platform is being installed, and it cannot be enabled or disabled at this time.
DISCARDING The platform is being discarded, and it cannot be enabled or disabled at this time.
FAILED A problem occurred during install or discard of the platform.
INCOMPLETE Some of the management parts for the platform are empty or have an invalid scope.
EMPTY None of the management parts for the platform are installed.
Table 3 shows the possible values for the status of a management part, and their meanings:
Table 3. 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 active 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 platform.
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 platform is not as expected, follow the procedures in Diagnosing platform deployment errors and Diagnosing platform runtime errors to diagnose the problem and take suitable action.