SCNQHST SCAN QHST TAAHSTK |
The Scan QHST command scans QHST information for a string of
characters. You must first convert the QHST information using the
CVTQHST2 command of the DSPQHST2 tool. Selection of which messages
to scan may be made on a date range, Job, User, Job number, and
Message ID. The scan occurs on the first level text and the message
data of the each message.
A typical command would be:
SCNQHST VALUE(ABC)
PERIOD(*AVAIL *BEGIN *AVAIL *END)
The information that was previously converted to the QHST2 file would
be scanned for the value ABC. The message would be listed if ABC is
found in the first level message text or in the message data. The
message information is folded before scanning. If the value occurs
only in the message data, the first level text would be listed along
with an indication that the value was found in the message data.
Creating the QHST2 file structure
---------------------------------
The QHST2 file structure must be created. If you are not using the
DSPQHST2 tool, use CVTQHST2 with CREATE(*YES) to create the file
structure in a named library.
Security
--------
When CVTQHST2 is used to create the QHST2 file structure, the QHST2
file is set to *PUBLIC *EXCLUDE. You may authorize anyone to the
file. *CHANGE authority is required to use CVTQHST2. *USE authority
is required to use SCNQHST.
SCNQHST escape messages you can monitor for
-------------------------------------------
TAA9891 The QHST2 file does not exist
TAA9892 No records exist in the QHST2 file
Escape messages from based on functions will be re-sent.
SCNQHST Command parameters *CMD
--------------------------
VALUE The value to be scanned for. Up to 20 bytes may be
entered. A blank value is not valid. The value,
the message text, and message data are all folded to
upper case before scanning.
*NONE may be entered to display all messages that
meet the other selection criteria. You may also use
DSPQHST2 which has a similar function.
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 date cannot be less than the
date of the first record in the QHST2 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. The date cannot be greater than the date of
the last record in the QHST2 file.
JOB The job to be selected. The default is *ALL.
USER The user to selected. The default is *ALL.
JOBNBR The job number to be selected. The default is *ALL.
MSGID The Message ID to be selected. The default is *ALL.
QHST2LIB The library where the QHST2 file structure exists.
*LIBL is the default. The files must have been
created by the CVTQHST2 command using the
CREATE(*YES) option.
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
------------
None.
Prerequisites
-------------
The following TAA Tools must be on your system:
CHKOBJ3 Check object 3
CVTDAT Convert date
CVTTIM Convert time
DSPQHST2 Display QHST2
RTVDAT Retrieve date
RTVSYSVAL3 Retrieve system value 3
SNDCOMPMSG Send completion message
SNDESCINF Send escape information
SNDESCMSG Send escape message
Implementation
--------------
The CVTQHST2 command must be used to first create the QHST2 files and
convert QHST information.
Objects used by the tool
------------------------
Object Type Attribute Src member Src file
------ ---- --------- ---------- ----------
SCNQHST *CMD TAAHSTK QATTCMD
TAAHSTKC *PGM CLP TAAHSTKC QATTCL
TAAHSTKR *PGM RPG TAAHSTKR QATTRPG
TAAHSTKR2 *PGM RPG TAAHSTKR2 QATTRPG
TAAHSTKP *FILE PF
TAAHSTKL *FILE LF TAAHSTKL QATTDDS
TAAHSTKP is created using the TAAHSTEP source. TAAHSTKL is the same
as TAAHSTEL except that the PFILE is TAAHSTKP.
|
Added to TAA Productivity tools October 15, 2012
