Disable an application to make it temporarily unavailable
on a platform. If you need to install a new version of an application,
or if you no longer require the application, disable and discard it.
About this task
When you disable or discard an application, the CICS® bundles that are deployed as part of the
application are also disabled or discarded in the CICS regions. When you want to install a new
version of an application, you must also replace the application definition
with a new application definition that points to the new version of
the application. You cannot edit an application definition that has
been installed.
Procedure
- Open the CICS Cloud
perspective. The Cloud Explorer view shows the current
status of the application. If you also want to check the status of
the CICS bundles for the application
in the CICS regions, in the CICS Explorer® menu bar,
click to open the Bundles view.
- In the Cloud Explorer view, locate the installed application
in either the Platform hierarchy or the Application hierarchy.
- To disable the application, right-click the application
name and select Disable, then click OK to
confirm. CICSPlex® SM
disables the CICS bundles for
the application in the CICS
regions, so that the application is no longer available on the platform.
Refresh the Cloud Explorer view, and check the application status.
If a status other than Disabled is shown for the application, see Checking the status of an application for more information
and suggested actions.
- To discard the application, you must disable it first,
as described in Step 3. When the application is disabled, right-click
the application name and select Discard, then
click OK to confirm. CICSPlex SM discards the CICS bundles for the application
in the CICS regions, and uninstalls
the application from the platform. When you refresh the Cloud Explorer
view, instead of the application name, you see the name of the application
definition (APPLDEF resource). If CICSPlex SM
fails to disable or discard any of the bundles, the application is
not discarded.
Results
The application is disabled or discarded, and all CICS bundles that are part of the
application are disabled or discarded. The application definition
remains in the data repository for the CICSplex.
What to do next
- To install a new version of an application, follow the instructions
in Creating an
application definition and Installing an application
definition to create and install a new version of the application
definition that points to the new version of the application. The
previous versions of the application definition can remain in the
data repository for the CICSplex, but you can only install one version
of the application definition in the platform at a time.
- If you no longer require the application, you can delete the application
definition, and also delete the application project from the platform
directory in zFS. You do not have to delete previous versions of the
application definition or the application project when you install
a new version of the application. You do not have to delete your application
definitions when you discard a platform.
- To delete the application definition, in the Cloud Explorer view,
right-click the application definition and select Delete,
then click OK to confirm. You must disable
and discard the application before you can delete the application
definition.
- To delete the application project, use the z/OS® perspective in the CICS Explorer to delete the folder
containing the application bundle from the platform home directory.