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.

Rebuild the manifest in the following situations:
  • 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.
  1. On the Historical Database menu, select option 5 Export or 7 Maintenance.

    The list of HDBs appears.

  2. 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
  3. 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.

  4. 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.
  5. Contact your DB2 administrator for your local DB2 settings, and then type the values into the panel.
  6. 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.

  7. Enter sub to submit the JCL, and then press the Exit key (F3) to return to the CICS PA panel.
  8. 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.
  9. 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
Parent topic: The CICS PA plug-in for CICS Explorer