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:
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:
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
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
USER The user to be displayed. The default is *ALL for
all users. A specific name or a generic name may be
JOBNBR The job number to be displayed. The default is *ALL
for all job numbers. A specific job number may be
MSGID The message ID to be displayed. The default is *ALL
for all message IDs. A specific message ID may be
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
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
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
If the command is entered in batch or *PRINT is
specified, the spooled file is output and retained.
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
The QHST2 file must exist with converted messages. See the CVTQHST2
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