TAA Tools
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:

        PRTQHSTANL

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,
                 specify *YES.

   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.

Restrictions
------------

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.

Prerequisites
-------------

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

Implementation
--------------

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

Structure
---------

PRTQHSTANL  Cmd
  TAAHSTDC   CL
    TAAHSTDR   RPG
      TAAHSTDC2  CL
					

Added to TAA Productivity tools April 1, 1995


Home Page Up to Top