If your platform is not enabled, or if you experience any
errors when attempting to update or change a platform, follow this
procedure to take appropriate action.
About this task
CICS Explorer®
issues the error message CNX0592E for errors that
occur when you are performing operations on an active platform. This
message is always preceded in the Error Log view by a CNX06xxE message
that describes the action performed. When you receive message CNX0592E,
review the attribute and error information in the message, and review
the Error log view to determine the failing command and condition.
CICSPlex® SM
issues error messages to the CICSPlex SM
output log (the EYULOG) for the maintenance point CMAS.
Look
up the error codes for platforms in the PLATDEF Resource Table in the CICS TS product documentation for platform definitions
(PLATDEF), and the PLATFORM Resource Table in the CICS TS product documentation for
PLATFORM resources.
Procedure
- If the status of a platform
is PARTIAL or INACTIVE, investigate the status of each CICS® region in the platform.
A status
of PARTIAL or INACTIVE means that one or more region types in the
platform contains no active CICS regions.
- 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.
The view shows whether each CICS region
is active or inactive.
- Double-click on any inactive CICS region to display and work with the region
in the Managed Regions view.
- If the enable status of a platform is DISABLED or SOMEDISABLED,
try to enable the management parts for the platform.
- To enable the whole platform, in the Cloud Explorer
view, right-click the platform and click Enable.
CICSPlex SM
attempts to enable all the CICS bundles
for the platform in all the CICS regions.
- Check the new status to see whether the platform is
now enabled.
- If the platform is not enabled, follow the process in
the next step to investigate the individual CICS bundles that are named in each management
part.
- 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.
- To enable a CICS bundle,
open the Bundles view by clicking . Alternatively, double-click on the management part in the
Cloud Explorer view, or right-click the management part and select Show
Installed Bundles.
- Select the record for the bundle in the CICS region where you want to enable it, right-click,
and click Enable.
- If the 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 you are attempting to add
an existing CICS region to
a region type, or to remove an existing CICS region
from a region type, and receive an error message, verify that the CICS region has been shut down.
To shut down a CICS region
using the
CICS Explorer,
in the Regions view, right-click the CICS region
and select
Shutdown. Refresh the Regions view
and confirm that the status of the region is INACTIVE. Alternatively,
shut down the CICS region using CICSPlex SM or CICS commands.
Tip: The Stop action
for a CICS region in the Cloud
Explorer view does not shut down the region. It only disconnects the
region from CICSPlex SM.
The CICS region must be shut
down and restarted in order to install the required bundles for the
new region type.
- If you are attempting to add a CICS bundle to a CICS Platform
Project, and receive an error message, select the platform in the
Cloud Explorer view and check the status of each CICS bundle that you attempted to add.
If
an error occurs when you add a bundle to a platform or remove a bundle
from a platform, the operation fails and all resources modified to
that point get restored to their original state.
- 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. If the CICS regions are available, check the definition
for the CICS bundle for any
errors.
- If the error code relates to bundle failure or partial
install, 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.