Build the manifest
A manifest is a proprietary DB2 table that contains all the information required by the CICS® PA plug-in to access and use historical data. The manifest is a catalog of DB2 tables for HDBs that are associated with the same qualifier and for which the Explorer indicator is set.
- Whenever you add or change an HDB in a way that affects its eligibility for inclusion in the manifest. For example, if an HDB is currently included in the manifest and you change its qualifier or clear the Explorer option, it is no longer eligible for inclusion in the manifest.
- Whenever any changes are made to the status of a report in an eligible Statistics HDB. The manifest will only contain entries for statistics reports with a status of Collect=Yes or Alt and DB2 Load=Yes. If these indicators are not set, the report will not be included in the manifest and therefore will not be accessible through the CICS PA plug-in.
- When you upgrade to a new release of CICS TS in which the statistics record ID changes. For a table of record IDs by supported CICS TS release, see Using the Statistics reporting dialog.
- On the Historical Database menu, select option 5 Export or 7
Maintenance.
The list of HDBs appears.
- Select Explorer -> Manifest Maintenance from the action
bar. The Manifest Maintenance panel appears:Figure 1. Manifest Maintenance
File Options Help ------------------------------------------------------------------------------ Manifest Maintenance Command ===> _________________________________________________________________ Specify Qualifier for Manifest. Qualifier . . . GF9IJG _ Create Tablespace Repository . . . . . : CICSPA.XYX.REPOSTRY CICS versions (VRM): Transaction Server . : 680 Transaction Gateway : 900 DB2 Settings: DB2 Subsystem ID . . . DH2C DSNTIAD Plan Name . . DSNTIA91 DB2 Load Library . . . 'DB2.V910.SDSNLOAD' DB2 Exit Library . . . 'DB2.V910.SDSNEXIT' DB2 RUNLIB Library . . 'DSN910.RUNLIB.LOAD' Database . . . . . . . FGSI87FC Storage Group . . SYSDFLT VCAT Catalog name . . DB2CAT Volume . . . . . . Allocation: Primary 10 Secondary . . . . 5 F1=Help F3=Exit F7=Backward F8=Forward F10=Actions F12=Cancel
- Type the name of a qualifier.
The manifest table will be named qualifier.CPA_MANIFEST. HDBs that have the same qualifier and which are otherwise eligible will be included in this manifest.
- When creating the first manifest, select Create Tablespace. The tablespace name is MANIFEST. On subsequent uses of Manifest Maintenance (either when creating a manifest for a new qualifier or recreating a manifest to add or delete HDBs) do not select Create Tablespace.
- Contact your DB2 administrator for your local DB2 settings, and then type the values into the panel.
- Press Enter. The panel prompts you to press Enter again to proceed.
Press Enter again. An edit panel appears, containing JCL to create the required DB2® table.
- Enter sub to submit the JCL, and then press the Exit key (F3) to return to the CICS PA panel.
- Check the Recap report, which is written to MANB0001.This contains output from the job step that populates the manifest, and will include details of the HDBs that were included.
- Check the SYSPRINT file in the job output, to confirm that the manifest table was successfully defined.
Sample Recap report
This example shows an example of the Recap report that is written by the manifest build job to MANB0001. This shows the total number of Performance and Statistics tables included in the manifest. Duplicate entries are listed in the report, though only the first occurrence is included in the manifest.
__________________________________________________
V5R3M0 CICS Performance Analyzer … Page 1
Manifest Build Recap Report
__________________________________________________
MANB0001 Printed at 12:34:56 02/15/2015
Manifest Build for Qualifier: STTS52 Repository DSN: CPA000.NW25X.MANIFEST.MAINT
Number of Performance tables: 3
Number of Statistics tables : 94
HDB Name Table Name Description Status
-------- -------------------- ------------------------------ ---------
CMF52SUM CPA_CMFPSUM Performance Summary Included
CMFLST52 CPA_CMFPLST Performance List Included
CMFLST52 CPA_CMFALERT Performance Alerts Included
STAT52 CPA_HST019A Domain Subpools Included
CPA_HST020A Task Subpools Included
CPA_HST010A Transaction Manager Included
CPA_HST011A Transactions Included
CPA_HST012A Transaction Classes Included
CPA_HST016A FEPI Pools Included
CPA_HST017A FEPI Connections Included