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

In addition, 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 accessible through the CICS PA plug-in. Therefore you should rebuild the manifest whenever any changes are made to the status of a report in an eligible Statistics HDB.

  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                    
                                                                                
 HDB Register . : CICSPA.HDB.REGISTER                                           
                                                                                
 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.

 »                                            __________________________________________________             
   V3R2M0                                                 CICS Performance Analyzer               … Page       1
                                                         Manifest Build Recap Report                         
                                              __________________________________________________             
  MANB0001 Printed at 12:03:45  3/15/2011                                                            
                                                                                                             
  Manifest Build for Qualifier: Q001      HDB Register DSN: CPA000.NW25X.MANIFEST.MAINT                      
                                                                                                             
  Number of Performance tables:        1                                                                     
  Number of Statistics tables :        9                                                                     
                                                                                                             
  HDB Name Table Name   Description                    Status                                                
  -------- ------------ ------------------------------ ---------                                             
  Q001P1   CPA_CMFPSUM  Performance Summary            Included                                              
                                                                                                             
  Q001P2   CPA_CMFPSUM  Performance Summary            Duplicate                                             
                                                                                                             
  Q001S1   CPA_HST005A  Domain Subpools                Included                                              
           CPA_HST006A  Task Subpools                  Included                                              
           CPA_HST014A  Storage Overview               Included                                              
           CPA_HST014B  DSAs                           Included 
           CPA_HSTG000A Connection Manager             Included 
           CPA_HSTG001A CICS Server Statistics         Included 
                                                                
  Q001S2   CPA_HST065A  MVS TCBs                       Included 
           CPA_HST014A  Storage Overview               Duplicate
                                                                
  Q001S3   CPA_HSTG000A Connection Manager             Duplicate
           CPA_HSTG001A CICS Server Statistics         Duplicate
           CPA_HSTG002A CICS Server Instance for EXCI  Included 
           CPA_HSTG007A CICS Server Instance for IPIC  Included
Parent topic: The CICS PA plug-in for CICS Explorer