DSPQHST DISPLAY QHST TAAHSTH |
The Display QHST command provides a method of searching the data from
the QHST logs and displays or lists the entries. The QHST
information must first be converted to a QHST2 file using the
CVTQHST2 command. DSPQHST provides several search criteria such as a
date range, a generic job or user name, message ID, and a scan value
to scan the message text.
You must have converted the QHST information using the CVTQHST2
command (part of the DSPQHST2 tool) to create the file QHST2.
A typical DSPQHST command would be:
DSPQHST MSGID(CPFxxxx)
This would display the messages for the specified message ID.
Another typical command would be to scan the message text for a
string such as:
DSPQHST SCNMSGTXT(IPL)
Any messages with 'IPL' in the message text would be displayed.
DSPQHST escape messages you can monitor for
-------------------------------------------
None. Escape messages from based on functions will be re-sent.
DSPQHST Command parameters *CMD
--------------------------
PERIOD A 4 part parameter to determine the beginning and
ending date/time values.
The first part is the beginning time. The default
is *AVAIL which means the earliest time for the
beginning date specified. A specific time may be
entered as 100000 or with separators such as
10:00:00.
The second part is the beginning date. The default
is *CURRENT meaning the current date. A specific
date may be entered in job date format or the
special value *BEGIN which means the first date
found in the file.
The third part is the ending time. The default is
*AVAIL which means the latest time for the ending
date specified. A specific time may be entered as
100000 or with separators such as 10:00:00.
The fourth part is the ending date. The default is
*CURRENT meaning the current date. A specific date
may be entered in job date format or the special
value *END which means the last date found in the
file or *BGNDATE which means the date entered in the
second part of the parameter.
JOB The job to be displayed. The default is *ALL for
all jobs. A specific name or a generic name may be
entered.
USER The user to be displayed. The default is *ALL for
all users. A specific name or a generic name may be
entered.
JOBNBR The job number to be displayed. The default is *ALL
for all job numbers. A specific job number may be
entered.
MSGID The message ID to be displayed. The default is *ALL
for all message IDs. A specific message ID may be
entered.
MSGTYPE The message type to be displayed. The default is
*ALL for all message types. A specific message ID
may be entered.
Use the command prompter to see the valid types.
Use the DSPMSGTYP command to display the types with
a description.
SCNMSGTXT A string to be scanned for in the message text. The
default is *NONE meaning no scan occurs. Up to 32
characters may be entered.
Both the value entered and the QHST2 file data are
folded to upper case before scanning.
If a blank exists between two values that you want
to scan for, enter it in quotes such as 'srvr
ended'.
EXCLUDEID A list of up to 100 excluded message IDs. The
default is *NONE.
In some cases you may have a standard set of message
IDs that should be ignored in QHST. Using an
exclude list allows this. A good technique to use
is with the FAVCMD tool where you would use
WRKFAVCMD to set up a DSPQHST command with the
standard exclude list. Then use the ? Option on
the WRK display to add a ? to the beginning of the
command. Using Option 8 or the FAVCMD command will
cause a prompt with the standard message IDs.
QHST2LIB The library where the QHST2 file exists. The file
must be created by the CVTQHST2 command.
OUTPUT How to output the results. * is the default to
display the spooled file if the command is entered
interactively. The spooled file is deleted after it
is displayed.
If the command is entered in batch or *PRINT is
specified, the spooled file is output and retained.
Restrictions
------------
None.
Prerequisites
-------------
The following TAA Tools must be on your system:
CHKGENERC Check generic
CVTDAT Convert date
CVTTIM Convert time
DSPQHST2 Display QHST2
EDTVAR Edit variable
EXTLST2 Extract list 2
RTVDAT Retrieve date
RTVSYSVAL3 Retrieve system value 3
SNDCOMPMSG Send completion message
SNDESCINF Send escape information
SNDESCMSG Send escape message
SNDJLGMSG Send job log message
TRNVAL Translate value
Implementation
--------------
The QHST2 file must exist with converted messages. See the CVTQHST2
command.
Objects used by the tool
------------------------
Object Type Attribute Src member Src file
------ ---- --------- ---------- ----------
DSPQHST *CMD TAAHSTH QATTCMD
TAAHSTHC *PGM CLP TAAHSTHC QATTCL
TAAHSTHR *PGM RPG TAAHSTHR QATTRPG
TAAHSTHR11 *PGM RPG TAAHSTHR11 QATTRPG
|
Added to TAA Productivity tools August 1, 2008
