Creating a deployment analysis report

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

  1. 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 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.
  2. 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 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.
  3. 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.
  4. Optional: You can run the report now and show the results in the CM plug-in. To run the report, click Run The Run icon in the editor. The results are shown in the Report viewer. Alternatively you can click the Submit Job icon 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.