Attributes of History Files

Customizing CA SMF Director › Attributes of History Files

Attributes of History Files

The SMF files are emptied into standard OS data sets. These files are CA SMF Director's history data sets, which are available for selective processing that is extracting and printing.

This product automatically generates the names of these history data sets, since they are created as needed. This automating naming assures that all collected SMF data is uniquely identified.

You can have a measure of control over the naming of history data sets by specifying a standard prefix or high level qualifier for them. This control is done with the PREFIX and APREFIX keywords of the DUMPOPTIONS command.

DUMPOPTIONS PREFIX(SYS1.SMFDATA).

The default prefix is SYS1.SMFDATA. The prefix can be single or multilevel, and is initially set during the installation. If no value is specified for APREFIX, the name that is used is taken from the PREFIX operand.

For further details regarding the control statement, see SMFD Command Statement Reference.

Note: We recommend setting a unique prefix for different configurations.

The structure of a history file data set name is as follows:

For SYSx.MANx file dumps:
```
prefix.Mfmmddyy.Thhmmtnn 
```
For logstream dumps:
```
prefix.iimmddyy.Thhmmtnn 
```
For substream dumps:
```
prefix.ifmmddyy.jhhmmtnn 
```

Where:

prefix

Represents the standard data set name prefix that this product automatically supplies whenever it dumps an SMF file.

Default: SYS1.SMFDATA.

M

Represents a SYSx.MANx history file.

f

Represents the suffix for the specific SMF file name (0-9, A-L). A value of 'S' indicates that previously dumped data from the SYSx.MANx files was manually added to CA SMF Director control.

mmddyy

Identifies the date that this product dumped the SMF data.

T

Represents the time prefix.

hhmm

Specifies the time the SMF data was dumped (twenty-four hour clock).

t

Represents the history file pool type where the SMF data is located. Values are:

P: Primary or main history file. (Default.)
A: Alternate (duplex data set)

nn

Represents a sequence number that starts at one and is incremented by one each time an EOV occurs for a single dumped SMF MAN file.

i

Represents the first character of a unique substream identifier for a history file. The identifiers are generated when the logstream and substream definitions are added at COMPILE time. These identifiers can also be seen in a LISTC report or in the ISPF online interface.

j

Represents the second character of a unique substream identifier for a history file. The identifiers are generated when the logstream and substream definitions are added at COMPILE time. These identifiers can also be seen in a LISTC report or in the ISPF online interface.

A sample follows:

SYS1.SMFDATA.MS090108.T1418P01

CA SMF Director creates its history files with a logical record length of 37260. The records are by default variable length spanned. The default block size that is used depends on the device type that is used for the history files. For the DASD devices, the default block size is 27998, and for a magnetic tape the default is 32748. If you prefer a block size or logical record length other than the default, you can code the desired attributes in a DCB parameter on the HISTORY1 or HISTORY2 DD JCL statements.