The CPU Monitor  tool provides a  monitoring solution which  will alert
the user  when jobs exceed a  set CPU percentage.  When  jobs are found
to  be consuming  CPU resources  over the limit,  a message  is sent to
the designated message queue describing the offending jobs.

Three commands  make up the  CPUMON tool  suite: STRCPUMON,  RUNCPUMON,
and ENDCPUMON

The  STRCPUMON  command performs  some  validity  checking, then  calls
RUNCPUMON  to submit  the TAACPUMON  job to batch.   The  TAACPUMON job
should remain active until the ENDCPUMON command is executed.

STRCPUMON Command                                     *CMD
-----------------

   SBS           Subsystem(s) to be  monitored.   The default is  *ALL.
                 Up to 25 subsystems may be entered.

   INTERVAL      The monitoring refresh interval in seconds.

                 The  default  is  300  seconds (5  minutes).    Values
                 between 30-3600 may be specified.

   CPULIMIT      The  CPU limit  percentage the  user wants  to monitor
                 for.   All jobs  equal to  or higher  than this  limit
                 will  be reported  on  by  sending  a message  to  the
                 specified message queue.

                 The  default is  30 percent.   A range  of .1  to 99.9
                 may be specified.

   MSGQ          The  qualified  name of  the message  queue to  send a
                 message to when  monitored jobs are  found to be  over
                 the set CPU percentage limit.

                 The default is 3.

   JOBQ          The job  queue to submit  the TAACPUMON batch  job to.
                 The  job   will  run  in  this  job  queue  until  the
                 ENDCPUMON command is executed.

STRCPUMON escape messages you can monitor for
---------------------------------------------

      TAA9898   The TAACPUMON job is already active.

RUNCPUMON Command                                     *CMD
-----------------

The RUNCPUMON command  is an  internal command  called from  STRCPUMON.
RUNCPUMON should not be run independently from STRCPUMON.

   SBS           Subsystem(s) to  be monitored.   The default  is *ALL.
                 Up to 25 subsystems may be entered.

   INTERVAL      The monitoring refresh interval in seconds.

                 The  default is 10  seconds.  Values  between 5-99 may
                 be specified.

   CPULIMIT      The CPU  limit percentage  the user  wants to  monitor
                 for.   All jobs  equal to  or higher  than this  limit
                 will  be  reported  on by  sending  a  message to  the
                 specified message queue.

                 The  default is  30 percent.   A  range of .1  to 99.9
                 may be specified.

   MSGQ          The qualified  name of  the  message queue  to send  a
                 message to  when monitored jobs  are found to  be over
                 the set CPU percentage limit.

RUNCPUMON escape messages you can monitor for
---------------------------------------------

       None.

ENDCPUMON Command                                     *CMD
-----------------

The command has no parameters.

ENDCPUMON escape messages you can monitor for
---------------------------------------------

      None.

             Determining the INTERVAL and CPULIMIT settings
             --------------------------------------

So  that  your  message  queue  doesn't  get  continually  filled  with
messages  of jobs  over  the  specified  CPU  limit,  the  user  should
experiment  with the  settings  for INTERVAL  and CPULIMIT  parameters.
Each  system administrator  will have  different  limits in  mind where
they want to be  notified when a job  is consuming too many  resources.

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

Only  a  *JOBCTL  authority user  can  use  STRCPUMON,  RUNCPUMON,  and
ENDCPUMON.

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

The following TAA Tools must be on your system:

     CHKJOBCTL       Check *JOBCTL special authority
     EXTLST2         Extract List 2
     RTVJOBSTS       Retrieve Job status
     SNDESCINF       Send escape information
     SNDESCMSG       Send escape message
     SNDPGMMSG       Send program message

Objects used by the tool
------------------------

   Object        Type    Attribute      Src member    Src file
   ------        ----    ---------      ----------    ----------

   STCPUPMON     *CMD                   TAACPUM       QATTCMD
   RUNCPUMON     *CMD                   TAACPUM1      QATTCMD
   ENDCPUMON     *CMD                   TAACPUM2      QATTCMD
   TAACPUMC      *PGM       CLP         TAACPUMC      QATTCL
   TAACPUMC1     *PGM       CLP         TAACPUMC1     QATTCL
   TAACPUMC2     *PGM       CLP         TAACPUMC2     QATTCL
   TAACPUMR1     *PGM       SQLRPGLE    TAACPUMR1     QATTRPG

Structure
---------

STRCPUMON   Cmd
   TAACPUMC   CL Pgm that submits CPUMON job

RUNCPUMON   Cmd
   TAACPUMC1  CL Pgm in batch for CPUMON job  (TAACPUMON)

ENDCPUMON   Cmd
   TAACPUMC2  CL Pgm