Maintain manifest

A manifest is a proprietary DB2 table that contains all the information required by the CICS PA plug-in for CICS Explorer® 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. The manifest for a given qualifier can be rebuilt at any time.

About this task

The manifest definition specifies the qualifier and the settings for the DB2 table that will contain the manifest.

Rebuild the manifest whenever you add or change an HDB in a way that affects its eligibility for inclusion in that manifest. For example, if an HDB is currently included in a manifest and you clear the Explorer option, it is no longer eligible for inclusion in that manifest. If you change the qualifier for an eligible HDB, you should rebuild both the manifest for the old qualifier and the manifest for the new qualifier.

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.

Figure 1. Manifest Maintenance
   File  Options  Help                                                          
 ------------------------------------------------------------------------------ 
                              Manifest Maintenance                              
 Command ===> _________________________________________________________________ 
                                                                                
 Specify Qualifier for Manifest.                                                
                                                                                
 Qualifier . . . . . . . ________        _ Create Tablespace                    
                                                                                
 Repository  . . . . . : CICSPA.XYX.REPOSTRY                                           
                           
 CICS versions (VRM):       
  Transaction Server . : 680
  Transaction Gateway  : 900
 
 DB2 Settings:                                                                  
  DB2 Subsystem ID . . . ____                                                   
  DSNTIAD Plan Name  . . ________                                               
  DB2 Load Library . . . ______________________________________________         
  DB2 Exit Library . . . ______________________________________________         
  DB2 RUNLIB Library . . ______________________________________________         
  Database . . . . . . . ________  Storage Group  . . ________                  
  VCAT Catalog name  . . ________  Volume . . . . . . ______                    
  Allocation: Primary    ________  Secondary  . . . . ______                    
                                                                                
  F1=Help      F3=Exit      F7=Backward  F8=Forward  F10=Actions  F12=Cancel    

Procedure

  1. Select Explorer -> Manifest Maintenance in the action bar on the HDB Export or Maintenance panel to create or update a manifest for a specified qualifier.
  2. 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.
  3. 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 if it already exists in the specified DB2 Database.
  4. Specify the settings for the DB2 table that will be used to store the manifest. For details, see Creating DDL to define a DB2 table.
  5. Perform the following steps to create the manifest:
    1. Press Enter. The panel prompts you to press Enter again to proceed.
    2. Press Enter again. An edit panel appears, containing JCL to create the required DB2® table for the manifest.
    3. Enter sub to submit the JCL. If you selected Create Tablespace, the DB2 tablespace (named MANIFEST) and the Database and Storage Group are created first.
  6. Press the Exit key (F3) to save the manifest definition and return to the CICS® PA panel.

Task Task

Feedback


Timestamp icon Last updated: Saturday, 8 February 2014


http://pic.dhe.ibm.com/infocenter/cicsts/v5r1/topic///users-guide/MaintManifest.htm