The Create Historical Data (CRTHSTDTA) command creates and adds historical data for a member to the historical data files. Historical data is an ongoing summary of the system reflecting the members that have been summarized using this command.

Parameters

Keyword	Description	Choices	Notes
MBR	Member	Name	Required, Positional 1
LIB	Library	Name, QPFRDATA, *CURLIB	Optional, Positional 2
REPLACE	Replace	*NO, *YES	Optional
JOBD	Job description	Single values: *NONE Other values: Qualified object name	Optional
	Qualifier 1: Job description	Name, QPFRJOBD
	Qualifier 2: Library	Name, *LIBL, *CURLIB

Top

Member (MBR)

Specifies the member to be used to create the historical data. Specify the name of the member.

This is a required parameter.

Library (LIB)

Specifies the library where the member is located.

The possible library values are:

QPFRDATA

The IBM-supplied performance data library, QPFRDATA, is where the member is located.

*CURLIB

The current library for the job is used to locate the member. If no library is specified as the current library for the job, QGPL is used.

library-name

Specify the name of the library where the member is located.

Replace (REPLACE)

Specifies whether to replace the historical data for the member if it already exists.

*NO

The historical data is not replaced.

*YES

The historical data is replaced.

Job description (JOBD)

Specifies the job description used to submit jobs for batch processing.

*LIBL

All libraries in the job's library list are searched until the first match is found.

*CURLIB

The current library for the job is used to locate the job description. If no library is specified as the current library for the job, QGPL is used.

library-name

Specify the name of the library where the job description is located.

QPFRJOBD

The IBM-supplied performance tools job description is used.

job-description-name

Specify the name of an alternate job description.

*NONE

A batch job is not submitted; instead, processing continues interactively while the user waits. The user's work station cannot be used during this time. This is something to consider for especially long jobs.

Examples

Example 1: Creating Files in Default Library

CRTHSTDTA   MBR(MONDAY)

This command creates files that contain historical data with the member named MONDAY.

Example 2: Creating Files in Specified Library

CRTHSTDTA   MBR(TUESPM)  LIB(MYLIB)

This command creates files that contain historical data with a member named TUESPM located in library MYLIB.

Error messages

*ESCAPE Messages

PFR9039

Historical data cannot be created for member &2.

PFR9056

Cannot copy graph format or package.

PFR9061

Cannot create historical data.

PFR9070

Cannot create historical data.

PFR9803

Cannot create historical data.