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