TAA Tools
CHKASPTHD       CHECK ASP THRESHOLD                    TAAASPA

The  Check ASP  (Auxiliary  Storage Pool)  Threshold  tool provides  an
additional  method of  notifying the  system operator  when an  ASP has
reached  its threshold of storage  used.  A message  is sent to QSYSOPR
(or a named  message queue) that  describes the current percentage  and
remaining  storage  available.    In  addition,  a  separate  threshold
percentage may be named in conjunction with the SHOUT tool.

The  system  sends  a  message  (CPF0907)  describing  an  ASP  storage
threshold problem,  but the  first  level text  does not  describe  any
values for  the operator.   The second level  text must be  accessed to
determine which ASP and the amount the threshold has been exceeded.

CHKASPTHD would send a message such as:

     ASP 2 exceeds threshold.  Used 93%.  Remaining ASP stg 2,360 MB.

In  a  situation  where  it is  normal  to  exceed  the threshold,  the
operator can more easily determine if a real problem exists.

*JOBCTL special authority is required to use CHKASPTHD.

CHKASPTHD submits a batch job  for one or all ASPs.   A typical use  of
CHKASPTHD WOULD BE:

             CHKASPTHD   MSGQ(*SYSOPR) WAKEUP(300) ASP(1)
                           SHOUTPCT(80) USERS(USERA USERB)

The submitted  batch job would  wake up every  5 minutes and  check the
usage percentage of ASP 1.

If  the usage  percentage  went above  80%, the  QSYSOPR  message queue
would  be  sent a  message.   This would  only cause  a 'break'  at the
workstation if the message queue was set to break mode.

If USERA and/or  USERB were signed  on, a break  message would be  sent
to their workstation.

More details
------------

The  batch  job  would wakes  up  according  to  the WAKEUP  number  of
seconds  and checks the status of  the named ASPs.   The QYASPOL API is
used to access  the ASP information.   For each  ASP that had  exceeded
its  threshold,  a  message  would be  sent  to  QSYSOPR  (a  different
message queue could be specified).

The  job queue  QSYSNOMAX is used  for the  batch job which  causes the
job to run in the QSYSWRK subsystem.

A different percentage threshold can  also be specified on the  command
to utilize  the function  to the TAA  SHOUT command.   For  example, if
the  normal threshold percentage  is 90%,  you could specify  the SHOUT
percentage  at 95%.   If 95%  was reached, the  list of  users named on
the USERS  parameter would  be notified  with  a break  message.   This
could be  helpful if the  System Operator is  not available or  has not
noticed the condition.

Performance considerations
--------------------------

Between  WAKEUP intervals, the batch program is  in a delayed state for
the number  of seconds  you specified.   When  the  interval ends,  the
program uses the  QYASPOL API to access  the ASP information.   The API
function always  accesses the information for every  ASP defined to the
system.   The program  determines  which ASP  to  check based  on  your
command specification.

Based on this, you should consider the following:

  **   The WAKEUP  interval  should not  be too  short  as each  wakeup
       causes overhead.

  **   Checking  all ASPs  does not  cause significantly  more overhead
       as the API always returns all information.

  **   You  can have multiple batch jobs  that are checking one or more
       ASPs.  This would  only make sense if you had  different message
       queues to  send messages  to, or different  SHOUTPCT thresholds,
       or a different list of users to notify using SHOUT.

Testing
-------

You  can  test  the  CHKASPTHD  function  by  determining  the  current
percentage usage  for the  required ASP  with WRKASP.   CHKASPTHD  will
check against  the 'usage percentage'.   Then use CHKASPTHD  to specify
a  percentage  slightly higher  than  is currently  being  used.   Name
yourself in the USERS parameter.

Copy some large file to  a temporary library.   Check WRKASP to see  if
the percentage used has  been reached.  If not, keep  copying until the
percentage is reached.

At that point you should receive a message.

Delete the temporary library.

End the current CHKASPTHD job.

You are now ready to implement the CHKASPTHD command as required.


CHKASPTHD escape messages you can monitor for
---------------------------------------------

None.  Escape messages from based on functions will be re-sent.

Command parameters                                    *CMD
------------------

   MSGQ          The  qualified name of  the message  queue to  be sent
                 the  standard message if the  ASP storage threshold is
                 exceeded.    The   default  is  *SYSOPR  meaning   the
                 QSYSOPR message queue in QSYS.

                 A  specific  message  queue  may  be named.    If  the
                 library  qualifier  is  blank, *LIBL  is  assumed.   A
                 library name  may  be entered  or the  special  values
                 *LIBL or *CURLIB.

   WAKEUP        The  wakeup interval  of  the  batch job  in  seconds.
                 The  default is  300 seconds (5  minutes).   The value
                 entered must be between  5 seconds and 86,400  seconds
                 (24 hours).

   ASP           The  list of  ASPs  to be  checked.   The  default  is
                 *ALL.     See  the  previous   documentation  for  the
                 performance considerations.

                 A maximum of 16 ASPs may be entered.

   JOB           The  job  name  for  the  submitted  batch  job.   The
                 default is CHKASPTHD.

   SHOUTPCT      A percentage  may be  entered to  allow the  CHKASPTHD
                 function to  shout at the  list of users  specified in
                 the  USERS parameter.   The default  is *NONE, meaning
                 only  the  standard  message  will  be  sent   to  the
                 message queue described by the MSGQ parameter.

                 The intent  of allowing  another threshold  percentage
                 is  to provide the function  of the TAA  SHOUT tool to
                 cause break messages  to be sent  to specified  users.

                 *SAME  may  be   specified  to  cause  the   same  ASP
                 threshold  percentage as defined  to the system  to be
                 used.

                 A  different  percentage  may  be  entered  such  as a
                 value higher than the  value defined to the system  to
                 allow for  a more serious notification.   For example,
                 if  the threshold  defined to  the system is  90%, the
                 SHOUTPCT could be  set at 95%.   This will allow  more
                 users  to be  made  aware  of an  increasing  critical
                 condition.

                 There  is no  check made relative  to the  current ASP
                 storage  threshold  set  thru   DST/SST  or  the   TAA
                 CHGASPA2  command.   The SHOUTPCT  value  can be  less
                 than,   equal  or   greater  than   the   ASP  storage
                 threshold.

                 If a value is entered, it must be between 01-99.

                 The  SHOUTPCT value applied  to all ASPs  named in the
                 ASP parameter.

   USERS         A list of  up to 10 users  for the SHOUT tool  to send
                 a  message to  if the  SHOUTPCT ASP  threshold storage
                 value  is reached.   The default is  *FIRSTUSER.  This
                 allows for  the  active  user with  the  highest  user
                 class  to be  notified.   For  full  details, see  the
                 USERS parameter on the SHOUT command.

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

*JOBCTL special authority is required to use CHKASPTHD.

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

The following TAA Tools must be on your system:

     CHKDUPLST       Check duplicate list
     CHKJOBCTL       Check job control
     CHKOBJ3         Check object 3
     EDTVAR          Edit variable
     EXTLST          Extract list
     EXTLST2         Extract list 2
     MOVCHRDEC       Move character to decimal
     RSNLSTMSG       Resend last message
     SHOUT           Shout message
     SNDESCMSG       Send escape message

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

None, the tool is ready to use.

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

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

   CHKASPTHD     *CMD                   TAAASPA       QATTCMD
   TAAASPAC      *PGM       CLP         TAAASPAC      QATTCL
   TAAASPAC2     *PGM       CLP         TAAASPAC2     QATTCL

The TAAASPAC2 program is submitted to batch by TAAASPAC.
					

Added to TAA Productivity tools December 15, 2000


Home Page Up to Top