Using a history file

BMC AMI Fast Path Online Analyzer for IMS provides a facility to generate a file containing historical summary records. BMC recommends the use of the Repository Facility for storing historical data. This data can be collected based on the analysis of multiple areas, and can be generated in a single report. For more information, see Fast Path Offline Suite documentation.

Related topics

Analyzing-a-DEDB-online

When an area is analyzed, a statistics record is appended to a user-specified file. The file can be used as input to a user-supplied reporting facility.

Use the HISTORY_DDNAME keyword on the ANALYZE command to specify the ddnames of DD statements to which the records are to be written. You can generate multiple copies of a report by listing more than one ddname.

Warning

The DD statement that is used for the output data must specify DISP=OLD to prevent destructive concurrent access to the data set.

(PTF BQQ5181 applied) When you run BMC AMI Fast Path Online Analyzer for IMS, use the HISTORY_DISP keyword to maintain the JCL status of the HISTORY data set that is defined by the DISP keyword. The HISTORY_DISP keyword is ignored if DISP=NEW is specified for the DISP keyword.

Use the following sample JCL command set to write statistics to the history file:

//PFP EXEC PGM=DFSRC00,REGION=0M,
//    PARM=(IFP,<dbdName>,DBF#FPU0)
//STEPLIB  DD   DSN=BMC.PFP.LOAD,DISP=SHR
//         DD   DSN=IMS.RESLIB,DISP=SHR
//<ddName1>  DD DSN=<your.dataset.name>,DISP=OLD
//PFPSYSIN DD *
  ANALYZE DBD=<dbdName>,IAREA=<areaName>,
    HISTORY_DDNAME=<ddName1>,HISTORY_DISP=YES
/*
//PFP EXEC PGM=DFSRC00,REGION=0M,
//    PARM=(IFP,<dbdName>,DBF#FPU0)
//STEPLIB  DD   DSN=BMC.PFP.LOAD,DISP=SHR
//         DD   DSN=IMS.RESLIB,DISP=SHR
//<ddName1>  DD DSN=<your.dataset.name>,DISP=OLD
//PFPSYSIN DD *
  ANALYZE DBD=<dbdName>,IAREA=<areaName>,
    HISTORY_DDNAME=<ddName1>
/*

For the complete history file record layout, see Fast Path/EP reference information.

UOW range specification

An additional record is written to the history file for each UOW range that is requested on any REPORT subcommand for the area being processed. The record contains statistics that are specific to the range of UOWs that are requested.

The following sample JCL command set  will write two records to the history file. One record will contain statistics for the entire area; the other record will contain statistics only for the UOWs that are specified.

//PFP EXEC PGM=DFSRC00,REGION=0M,
//    PARM=(IFP,<dbdname>,DBF#FPU0)
//STEPLIB  DD   DSN=BMC.PFP.LOAD,DISP=SHR
//         DD   DSN=IMS.RESLIB,DISP=SHR
//ddname1  DD DSN=<your.dataset.name>,DISP=OLD
//PFPSYSIN DD *
  ANALYZE DBD=<dbdname>,IAREA=<areaname>,
      HISTORY_DDNAME=<ddname1>
    REPORT STARTUOW=5,STOPUOW=10
/*

Optionally, you can use HISTORY_UOW_RANGE_RPT to suppress reporting for UOW range values without affecting the history record. 

The sample JCL command set below will write two records to the history file but will suppress different UOW range reporting in PFPRPTS altogether. 

//PFPEXEC PGM=PFPMAIN,REGION=0M
//STEPLIB  DD DSN=BMC.PFP.LOAD,DISP=SHR
//         DD DSN=IMS.RESLIB,DISP=SHR
//ddname1  DD DSN=your.dataset.name,DISP=OLD
//PFPSYSIN DD *
  ANALYZE  DBD=dbdname,IAREA=areaname,
  HISTORY_DDNAME=ddname1,
  HISTORY_UOW_RANGE_RPT=NO
  REPORT STARTUOW=5,STOPUOW=10
/*

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*