Create Historical Data (CRTHSTDTA)

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

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.