PRTQHSTANL PRINT QHST ANALYSIS TAAHSTD
The Print QHST Analysis command finds the QHST files on the system
and summarizes the information. A report is prepared. A typical
command is entered as:
Printed output is spooled to the QHSTANL file.
The CPF1164 message (sent at the completion of every job) is used for
most of the analysis. This includes an analysis by day, by type of
job, by user, by completion code, by time of day etc.
This provides a simple job accounting function and provides basic
information about the system usage. For more specific information
you should consider the use of job accounting (The TAA Tool PRTJOBACG
may be helpful).
A summary of all of the message IDs found is prepared as well as a
specific listing and counting of important messages.
Command parameters *CMD
QHSTPLIB The library containing the QHSTP files. The QHST
files must be converted by the CVTQHST command. See
the next parameter. The QHSTPLIB parameter lets you
specify that the conversion has already taken place.
If you are not interested in the converted output,
specify a library like QTEMP.
CVTQHST A *YES/*NO option that defaults to *NO that controls
whether the CVTQHST command has already been run.
If you are only interested in the report output,
STRDATE The start date to be used. The default is *BEGIN
which specifies to use the earliest date found in
the QHSTP file. If you want to begin at a specific
date, enter the date in system format.
ENDDATE The end date to use. The default is *END which
specifies to use the records until end of file is
reached in QHSTP. If you want an earlier end date,
specify the date in system format.
PRTFILE The qualified name of the printer file to use.
QPRINT in *LIBL is the default. QHSTANL is always
the name used for the spooled file.
The CPF1164 message found in QHST describes the amount of CPU usage.
This has a minimum of 1 second per job. Because a system may run
many small batch jobs that take less than a second, this could result
in a total CPU usage of more than 24 hours per day if all CPU time is
accumulated. To prevent this, an assumption is made that any batch
job that uses 1 second of CPU actually uses 1/100th of a second.
The following TAA Tools must be on your system:
CVTQHST Convert QHST to an output file
RTVDAT Retrieve date
RTVSYSVAL3 Retrieve system value 3
SNDCOMPMSG Send completion message
SNDESCMSG Send escape message
SNDSTSMSG Send status message
None, the tool is ready to use.
Objects used by the tool
Object Type Attribute Src member Src file
------ ---- --------- ---------- ----------
PRTQHSTANL *CMD TAAHSTD QATTCMD
TAAHSTDC *PGM CLP TAAHSTDC QATTCL
TAAHSTDC2 *PGM CLP TAAHSTDC2 QATTCL
TAAHSTDR *PGM RPG TAAHSTDR QATTRPG
Added to TAA Productivity tools April 1, 1995