Using a history file
Fast Path Analyzer/EP 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.
Each time 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.
(PTF BQQ5181 applied) When you run Fast Path Analyzer/EP, 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:
//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
/*
//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>
/*
The complete history file record layout is shown in the History file record layout documentation.
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 will contain statistics specific to the range of UOWs that are requested.
The sample JCL command set below 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.
//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.
//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
/*
Related topic