Using a history file

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 Using a history file.

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.

Use the sample JCL command set in below figure to write statistics to the history file.

//PFP      EXEC 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
/*

The complete history file record layout is shown in the Fast Path/EP Series Reference Manual 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.

  //PFP      EXEC 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
    REPORT STARTUOW=5,STOPUOW=10
/*