HISTORY_DDNAME

Use the HISTORY_DDNAME keyword to specify the ddname(s) of a DD statement(s) specified in the JCL to which a statistical summary record is written.

If the JCL does not contain a DD statement(s) with the referenced ddname(s), an error message is generated. If the ddname(s) refers to a data set that contains data, the summary record is appended to the existing data (as if you had specified DISP=MOD). For information about the record layout, see History file record layout.

Note

All fields are written to the History File only when POINTER_VALIDATION=FULL is specified. If any other value is specified for the POINTER_VALIDATION keyword, certain fields in the History File will be set to zero.

The data set referenced by this ddname(s) must be a physical sequential data set. It cannot be a member of a partitioned data set. The record format (RECFM) supports fixed or variable length records that can be blocked or unblocked. The statistics summary records written to the data set contain 200 bytes of data. The logical record length (LRECL) should be 200 for RECFM=FB and 204 for RECFM=VB. The block size (BLKSIZE) must be appropriate for the RECFM and LRECL.

Note

If critical errors are detected during analysis, a statistics summary record is not generated for the area.

Use

HISTORY_DDNAME is an optional keyword for the following commands and subcommands:

ANALYZE
LIST
PREPARE
RETRIEVE
GLOBAL

Related keywords

POINTER_VALIDATION
RAP_VALIDATION

Related subcommand

REPORT

Syntax

HISTORY_DDNAME=parameter
HISTORY_DDNAME=(parameter[,parameter[, ...]])

Parameters

Specify a 1-character to 8-character ddname.

Default

None

Alias

The following are aliases of the HISTORY_DDNAME keyword:

EXTDD
EXTRACT_DDNAME
HISDD