If an application that is deployed on a platform does not
have the expected status, follow this troubleshooting procedure to
take appropriate action.
Before you begin
Use the Cloud Explorer view in the CICS® Cloud perspective to check the status of
the application.
Checking the status of an application explains
how to use the view and lists the possible values for the status of
an application and of the management parts. An 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.
Procedure
- If the status of an application is FAILED, check the CICSPlex® SM output log (the
EYULOG) for details of the problem that occurred while the application
was being installed or discarded. The CICSPlex SM data repository for the CMAS
might be full, in which case you need to increase its size. To expand
the data repository, use the REPRO function of the IDCAMS utility.
An example of the JCL to do this is in the EYUJXDRP member of the
CICSTS51.CPSM.SEYUSAMP library. In that JCL, on the RECORDS(xx,yy)
statement, specify a primary (xx) and a secondary
(yy) value that are appropriate for your environment.
The initial values are 500 and 3000.
- If the status of an application is DISABLED or SOMEDISABLED,
try to enable the whole application.
- In the Cloud Explorer view, right-click on the application
and select Enable. CICSPlex SM attempts to enable
all the CICS bundles for the
application in all the CICS regions.
- Check the new status to see whether the application
is now enabled. If the application is not enabled, investigate
the individual CICS bundles
that are named in each management part. In the Cloud Explorer view, use the switch hierarchy
drop-down list to switch
to the application hierarchy. 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.
- If the status of a management part is DISABLED or SOMEDISABLED,
try to enable the individual CICS bundles
in each CICS region where they
are installed.
- Double-click on the management
part to open the CICS Bundles
view, which displays the installed CICS bundles.
Alternatively, right-click the management part and click Show
Installed Bundles.
- In the CICS Bundles
view, select the record for the CICS bundle
in the CICS region where you
want to enable it, right-click and select Enable.
- If the CICS bundle
remains disabled, check its definition to see if it has a dependency
on an import for a resource that is not present in the CICS region.
- If the status of an application is INCOMPLETE or EMPTY,
investigate the individual CICS bundles
that are named in each management part:
- In the Cloud Explorer view,
use the switch hierarchy
drop-down list to switch to the application hierarchy. 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. To work with the installed CICS bundles,
double-click on the management part to open the CICS Bundles view. Alternatively, right-click
the management part and click Show Installed Bundles.
- If the status of a management part is INVALIDSCOPE,
check the definition for the CICS bundle
to see whether the target CICS system
group was specified correctly.
- If the status of a management part is EMPTY, check whether
the CICS regions where the CICS bundle should have been installed
are active and connected to the CMAS. To check whether the CICS regions
are active, use the switch hierarchy
drop-down list to switch
to the platform hierarchy in the Cloud Explorer view. For the platform
where the application is installed, expand the region types, then
expand the Regions list for each region type to show the CICS regions and their status. If
the CICS regions are available,
check the definition for the CICS bundle
for any errors.
- If the status of a management part is INCOMPLETE, check
the CICSMSG log of the CICS regions
in the region type of the affected bundle for more information about
why the bundle was not installed. If the CICS bundle cannot be found, check your zFS
setup.
- This error can occur when a platform is spread across different
systems (LPARs) in the same sysplex, but the platform home directory
in the zFS file system is not shared across the sysplex. You must
either use FTP by using a connection to the same zFS that your CMAS
is running on, or set up sysplex-wide sharing of your platform home
directory.
- This error can also occur if the platform home directory is on
a different sysplex from the sysplex where the platform is installed.
Ensure that the platform home directory is on the sysplex where you
have installed the platform.