TAA Tools
DSPTRGSTS       DISPLAY TRIGGER STATUS                 TAADBOC

The Display Trigger Status  command displays the trigger status  of the
programs for one  or more files in one or  more libraries.  An 'escape'
parameter  exists to  allow you  to send  an escape  message if  one or
more programs are disabled or inoperative.

You must have *ALLOBJ special  authority to use a library  qualifier of
*ALL or *ALLUSR.

A typical command would be:

             DSPTRGSTS  FILE(xxx/*ALL)

The  trigger  status  for all  files  in  the  named library  would  be
displayed.

Adding ESCAPE(*YES) such as:

             DSPTRGSTS  FILE(xxx/*ALL) ESCAPE(*YES)

would  cause  the TAA9893  escape  message to  be  sent if  any  of the
programs are  disabled or  inoperative.   This allows  you  to run  the
program everyday  in batch  and cause  an abnormal  job termination  if
any problems exist.

DSPTRGSTS escape messages you can monitor for
---------------------------------------------

      TAA9893    One or more programs are disabled or inoperative.
                   Only sent if ESCAPE(*YES) is specified.

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

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

   FILE          The  qualified   name  of  the  file  to  display  the
                 trigger status for.   A  generic name  or the  special
                 value *ALL may be entered.

                 The library qualifier  defaults to *LIBL.   A specific
                 library  or  the  special  values  *CURLIB,  *USRLIBL,
                 *ALLUSR, or *ALL may be entered.

                 There  may be  several disabled  programs in  the QSYS
                 library.     This  is  considered   to  be  a   normal
                 situation.

   ESCAPE        A  *YES/*NO  value  for  whether  to  send  an  escape
                 message  if one or  more files have  programs that are
                 disabled or inoperative.

                 If   DSPTRGSTS   is   entered   interactively    using
                 OUTPUT(*)  and   ESCAPE(*YES),  the   display  appears
                 followed  by an  escape message  and the  spooled file
                 is retained.   If  OUTPUT(*PRINT)  or the  command  is
                 run  in batch  with ESCAPE(*YES),  a  spooled file  is
                 created and the command ends abnormally.

                 *NO is  the default meaning the  command will complete
                 normally  regardless of what is  found for the status.

                 *YES may  be  specified to  cause the  TAA9893  escape
                 message  if  one or  more  programs  are  found to  be
                 disabled or inoperative.

   OUTPUT        How  to  output the  results.    * is  the  default to
                 display the  spooled file  if the  command is  entered
                 interactively.   If the  display is ended  with F3/F12
                 or  the Enter key,  the spooled file  is deleted after
                 it is  displayed.   To retain  the spooled  file,  you
                 may use the  the System Request 'Cancel'  function and
                 the spooled file will exist in a HLD status.

                 If  the  command is  entered  in  batch  or *PRINT  is
                 specified,  the spooled  file is  output and retained.


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

You must have *ALLOBJ  special authority to use a library  qualifier or
*ALL or *ALLUSR.

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

The following TAA Tools must be on your system:

     CHKALLOBJ       Check *ALLOBJ special authority
     RTVSYSVAL3      Retrieve system value 3
     SNDCOMPMSG      Send completion message
     SNDESCINF       Send escape information
     SNDESCMSG       Send escape message

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

None, the tool is ready to use.

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

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

   DSPTRGSTS     *CMD                   TAADBOC       QATTCMD
   TAADBOCC      *PGM       CLP         TAADBOCC      QATTCL
   TAADBOCR      *PGM       RPG         TAADBOCR      QATTRPG
					

Added to TAA Productivity tools January 15, 2013


Home Page Up to Top