Customizing CA SMF Director › Attributes of History Files

Attributes of History Files

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

This product automatically generates the names of these history data sets, since they are created as needed. This 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 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 at installation. If no value is specified for APREFIX, the name used is taken from the PREFIX operand.

For further details regarding the above control statement see Chapter 4, Command Reference.

Note: We recommend that a unique prefix be set 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 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, and can 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, and can be seen in a LISTC report or in the ISPF online interface.

The following is a sample:

SYS1.SMFDATA.MS090108.T1418P01

CA SMF Director history files are created with a logical record length of 32760, and can contain variable length spanned records. The default block size used depends on the device type used for the history files. For DASD devices the default block size is 4096, and for a magnetic tape the default is 32748. If a block size or logical record length other than the default is desired, it can be specified on the HISTORY1, HISTORY2, HISTij1, or HISTij2 DD JCL statements.