Deployment analysis is the analysis of CICS® resource definitions that
are stored within CICS. These
resource definitions can be running in an active CICS region, or contained in a CICSPlex® SM Data Repository, or a CICS System Definition file that
is used by CICS regions. Deployment
analysis provides a way of reporting on, and comparing, resource definitions
from these different sources, and can be started by using the CICS CM Batch interface and the CICS CM plug-in.
The
CM plug-in provides two ways of entering the data that is required
to run the analysis: A rich editor, and a JCL editor. The editors
are linked so that any changes you make in one editor are reflected
in the other editor. For more information about the Deployment Analysis
editor, see The deployment analysis editor.
When all the data is entered, you
can start the analysis in one of two ways: You can submit the JCL
and receive the report in a data set. Alternatively, you can run the
analysis from the Deployment Analysis editor, and view the report
in the CM plug-in report viewer.
Deployment analysis can be
started from either the Configurations view,
the CICSplex Explorer view, the Regions view,
or the toolbar, by using the following procedure.
Before you begin
Before you use deployment analysis for the first time, you
must set up your deployment analysis preferences. You do this setup
in the
Preferences window. For more information
about setting deployment analysis preferences, see
Setting the Deployment Analysis preferences
Procedure
- Choose one of the following actions to start deployment
analysis:
- In the Configurations view, right-click
a configuration name and select Deployment Analysis.
Click the report type that you want to run. The following report types
are available:
- Candidates
- Lists a set of candidate resource definitions that are stored
in a CSD file, a CICSPlex SM
data repository, or a combination of the two.
- Candidates Compare
- Compares two sets of candidate resource definitions that are stored
in a CSD file, a CICSPlex SM
data repository, or a combination of the two.
- Check
- Lists the referential integrity issues in a set of candidate resource
definitions that are stored in a CSD file, a CICSPlex SM data repository, or a combination
of the two.
- Cold start Compare
- Compares a set of runtime resource definitions that are installed
in an active CICS region, with
a set of candidate resource definitions that are stored in a CSD file,
a CICSPlex SM data repository,
or a combination of the two.
- Deployment Analysis Editor
- Open a window where you can select more templates or jobs that
you saved previously.
- Runtime resources compare
- Compares two sets of runtime resource definitions that are installed
in two active CICS regions.
- Runtime resources
- Lists a set of runtime resource definitions that are installed
in an active CICS region.
- Click the Deployment Analysis Editor icon
in the toolbar to
open a window where you can select more templates or jobs that you
saved previously.
- In the CICSplex Explorer view or the Regions view,
right-click a CICS region and
click Deployment Analysis. Click the report
type that you want to run. The following report types are available:
- Cold start Compare
- Compares a set of runtime resource definitions that are installed
in an active CICS region, with
a set of candidate resource definitions that are stored in a CSD file,
a CICSPlex SM data repository,
or a combination of the two.
- Deployment Analysis Editor
- Open a window where you can select more templates or jobs that
you saved previously.
- Runtime resources compare
- Compares two sets of runtime resource definitions that are installed
in two active CICS regions.
This option is available only in the CICSplex Explorer view.
- Runtime resources
- Lists a set of runtime resource definitions that are installed
in an active CICS region. This
option is available only in the CICSplex Explorer view.
The deployment analysis editor opens.
- Complete the information by using either the rich editor,
or the JCL editor, or you can switch between the two editors. The
editor pages are linked, so that any changes that you make to one
page are reflected in the other page. In the rich editor, the mandatory
fields are shown with an asterisk (*) next to the field name. Some
of the fields have content assist. When you click in a field, the
light-bulb symbol
next to the
field shows that content assist is available. When you
press Ctrl +space, content assist shows a list
of the possible choices for the field. You can double-click a name
in the list to insert the content in the field.
- Save your changes by clicking the Save icon
or clicking Ctrl+S. The JCL is saved in the
job library that is defined in the Deployment Analysis Preferences page.
- Optional: You can run the report now and show
the results in the CM plug-in. To run the report, click Run
in the editor. The results are shown in the Report viewer.
Alternatively you can click the Submit Job icon
to submit the JCL as a Job, and receive the output report
in SYSOUT.
What to do next
For more information about the JCL that is used to generate
deployment analysis reports, search for "JCL to generate a deployment
analysis report" in the CICS Configuration Manager for z/OS product documentation in
the CICS TS information center.
For
more information about reading deployment analysis reports, search
for "Interpreting the sections of a deployment analysis report" in
the CICS Configuration Manager for z/OS product documentation in the CICS TS information center.