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.
About this task
The status information for a version of an application is
derived from the status of the individual management parts for that
version of 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
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.
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.
Note: When you start or restart
a CICS region, the availability
status of your CICS application
is only restored if the enable status was ENABLED. If the enable
status was SOMEDISABLED then your availability status will not be
restored and you will need to reset your availability status.
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.
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.
An application in the SOMEDISABLED state can be made available if
necessary, however, application entry points of bundles not
already enabled will not become available during this action.
You can make an application available with an enabled status of
SOMEDISABLED. There are two factors you must be aware of however.
When the enabled status is SOMEDISABLED, the availability status
of your application is not restored if you start or restart a region.
Also, you cannot automate the deployment of an application to
a target state of AVAILABLE using the DFHDPLOY utility.
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.
What to do next
If the status of the application version is not as expected,
follow the procedure in Diagnosing application errors to
diagnose the problem and take suitable action.