Checking the status of an application

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

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 version of each application.
   • An application version is enabled if the CICS bundles referenced by the management parts for the application version have been installed in the CICS regions, and all of them are enabled. Some resources for an application require more time to enable than others. The status of the application is reported as SOMEDISABLED until all the resources are enabled. If the application does not display ENABLED status when the Cloud Explorer view is refreshed for the first time following the Enable action, refresh the view again after a short time and check again.
   • When the application version is made available, the application entry points, and therefore the resources that they control for the application, are available to callers. If your platform includes any CICS regions that are still at CICS TS 5.1, application versions are assumed to be available in those regions as soon as they are enabled. In CICS regions from CICS TS 5.2, after an application version is enabled, you must make it available using the Make Available action.
2. If the overall status of the application version is not as you expected, view the management parts for the application version 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 the 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. If the application version that includes the CICS bundle has been made available to callers, the individual CICS bundles that contain application entry points also display as available.
   Tip: The availability status of a CICS bundle is not restored if you start or restart a CICS region in the platform after the time when you make available the CICS bundle, or the application containing it. When you have verified that the application has been installed and enabled correctly in the started or restarted CICS region, select the appropriate version and make it available in the CICS region.
3. If you need to check on the status of the private resources that have been installed in the CICS regions for the application version, in the Cloud Explorer view, double-click the name of the application to open it in the online application editor, and select the Private Resources tab. You can view the private resources by the CICS region where they are installed, or by the CICS bundle where they are defined. The status for each private resource is displayed. For a guide to using the online application editor, see The online application editor.

Results

Figure 1 shows the actions that you take during the provisioning stage of an application's lifecycle, and the appropriate temporary status, enablement status, and availability status in each situation, together with the possible error states.

Figure 1. Application lifecycle: Provisioning

• You deploy a CICS Application project by exporting it to the home directory for the platform on zFS, and creating an APPLDEF resource definition for the application version in the data repository of the CMAS. When you have completed this process, the Cloud Explorer view displays the name of the application definition for the application version.
• When you install an application, the status INSTALLING is displayed in the Cloud Explorer view while installation is in progress. When installation is complete, the expected status for the application is DISABLED, UNAVAILABLE. If the application has no application entry points, the Cloud Explorer view displays this as the availability status. If the application is installed in a CICS TS 5.1 region, no availability status is displayed.
• If the status INCOMPLETE, EMPTY, or FAILED is displayed for the application after installation, follow the procedure in Diagnosing application errors to troubleshoot the problem.
• When you enable an application, the status ENABLING is displayed in the Cloud Explorer view while enabling is in progress. When enabling is complete, the expected status for the application is ENABLED, UNAVAILABLE.
• If the status SOMEDISABLED or DISABLED is displayed for the application after the Enable action, follow the procedure in Diagnosing application errors to troubleshoot the problem.
• When you make an application available, the status for the application is expected to change to ENABLED, AVAILABLE. If the status for the application shows that it has no application entry points or is installed in a CICS TS 5.1 region, the Make Available action is not required.
• If the availability status SOMEAVAIL or UNAVAILABLE is displayed for the application after the Make Available action, follow the procedure in Diagnosing application errors to troubleshoot the problem.

Figure 2 shows the actions that you take during the deprovisioning stage of an application's lifecycle, and the appropriate temporary status, enablement status, and availability status in each situation, together with the possible error states.

Figure 2. Application lifecycle: Deprovisioning

• When you make an application unavailable, the status for the application changes to ENABLED, UNAVAILABLE. If the status for the application shows that it has no application entry points, or that it is installed in a CICS TS 5.1 region, the Make Unavailable action is not required.
• When you disable an application, the status DISABLING is displayed in the Cloud Explorer view while disabling is in progress. When disabling is complete, the expected status for the application is DISABLED, UNAVAILABLE. Alternatively, the status can show that the application has no application entry points, or that it is installed in a CICS TS 5.1 region.
• If the status SOMEDISABLED is displayed for the application after the Disable action, follow the procedure in Diagnosing application errors to troubleshoot the problem.
• When you discard an application, the status DISCARDING is displayed in the Cloud Explorer view while the discard is in progress. When discarding is complete, the application name is no longer shown in the Cloud Explorer view. Instead, the name of the application definition for the application version is displayed.

Table 1 lists all the possible values for the status of an application version, and their meanings:

Table 1. Application status values

Status value	Meaning
AVAILABLE	The application version has been made available to callers through its application entry points.
DISABLED	All the management parts for the application version are disabled.
DISABLING	All the management parts for the application version are in the process of being disabled.
DISCARDING	The application version is being discarded, and it cannot be enabled or disabled at this time.
EMPTY	None of the management parts for the application version are installed.
ENABLED	All the management parts for the application version are enabled.
ENABLING	All the management parts for the application version are in the process of being enabled.
FAILED	A problem occurred during install or discard of the application version.
INCOMPLETE	Some of the management parts for the application version are empty or have an invalid scope.
INSTALLING	The application version is being installed, and it cannot be enabled or disabled at this time.
NONE (No entry points)	The application version does not have any application entry points.
SOMEAVAIL	The Make Available or Make Unavailable action has been performed for the application version, but some application entry points are available and some are unavailable.
SOMEDISABLED	Some of the management parts for the application version are disabled.
UNAVAILABLE	The application version is set as unavailable to callers.

Table 2 lists all the possible values for the status of a management part, and their meanings:

Table 2. Management part status values

Status value	Meaning
AVAILABLE	The application entry points declared in the CICS bundle have been made available to callers.
DISABLED	The CICS bundle is disabled in all of the CICS regions.
DISABLING	The CICS bundle is in the process of being disabled.
EMPTY	The CICS bundle is not installed in any of the CICS regions.
ENABLED	The CICS bundle is installed and enabled in all of the CICS regions.
ENABLING	The CICS bundle is in the process of being enabled.
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.
NONE (No entry points)	The CICS bundle does not contain any statements of application entry points.
SOMEAVAIL	The Make Available or Make Unavailable action has been performed for the CICS bundle, but some application entry points are available and some are unavailable.
SOMEDISABLED	The CICS bundle is disabled in some of the CICS regions. This status can also occur when the CICS bundle is disabled in all of the CICS regions, if the ENABLEDCOUNT value for any of the installed BUNDLE resources is greater than 0, indicating that one or more resources, application entry points, or policy scopes that were created by the CICS bundle are currently enabled in the CICS region.
UNAVAILABLE	The application entry points declared in the CICS bundle are set as unavailable to callers.