The Display QHST  Inquiries command displays or lists  inquiry messages
and their  replies from the QHST  log.  The formatting  allows a better
review  than  the  DSPLOG  command.   A  detail  option  for additional
information is available.

You must have  *USE authority to  the TAACVTQHST Authorization List  to
use DSPQHSTINQ.

A typical command would be:

             DSPQHSTINQ

One  line would be  displayed for  each inquiry  message and  the reply
(if any).  A summary by reply type is included.

Command  options  exist to  select  a  specific message  ID,  provide a
start date/time, and to request more detail information.

A  similar  function  is  available  for  a  Message  Queue   with  the
DSPMSGQINQ command.

The  system  attempts  to  keep the  reply  immediately  following  the
original  message  in  QHST.    This  is  not always  accomplished  and
consequently there will be messages  without a reply that are  repeated
later with a reply and some replies that do not match any inquiry.

DSPQHSTINQ escape messages you can monitor for
----------------------------------------------

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

DSPQHSTINQ Command parameters                         *CMD
-----------------------------

   MSGID         The message ID to  be displayed.  *ALL is  the default
                 for all inquiry messages.

                 A specific inquiry message ID may be requested.

                 *NONE  may be  entered to  display only  those inquiry
                 messages  that do not  have a message  ID.  This would
                 occur if  a command  like SNDMSG was  used which  does
                 not support a MSGID parameter.

   STRDAT        The start  date of the  messages to be selected.   The
                 default  is *BEGIN which  means any date  after Jan 1,
                 1940  for  the  messages  that  are  converted.    The
                 special  value  *TODAY  may  be  entered  for  today's
                 date.   If a date is entered, the  date must be in job
                 format.

   STRTIM        The start time of  the messages to  be selected.   The
                 default is  *AVAIL which means  the first  message for
                 the date  requested.  If entered, the  time must be in
                 the format of HHMMSS.

   ENDDAT        The  end date  of the  messages to  be selected.   The
                 default is *TODAY  which means the  current date.   If
                 a date is entered, the date must be in job format.

   ENDTIM        The  end time  of the  messages to  be selected.   The
                 default  is *END which means the  last message for the
                 date requested.  If entered,  the time must be in  the
                 format of HHMMSS.

   OPTION        The type of listing to be output.

                 *SUMMARY is the  default to list one  line per inquiry
                 message and its reply.

                 *DETAIL   may   be   specified   to  list   additional
                 information including  the  reply  date/time  and  the
                 time  difference between  when  the inquiry  was  sent
                 and when the reply occurred.

   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
------------

You must have  *USE authority to the  TAACVTQHST Authorization List  to
use DSPQHSTINQ.

The  system  attempts  to  keep the  reply  immediately  following  the
original  message  in  QHST.    This  is  not always  accomplished  and
consequently there will be messages  without a reply that are  repeated
later with a reply and some replies that do not match any inquiry.

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

The following TAA Tools must be on your system:

     CVTQHST         Convert QHST
     CVTTIM          Convert time
     RSNLSTMSG       Resend last message
     RTVDAT          Retrieve date
     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
   ------        ----    ---------      ----------    ----------

   DSPQHSTINQ    *CMD                   TAAHSTI       QATTCMD
   TAAHSTIC      *PGM       CLP         TAAHSTIC      QATTCL
   TAAHSTIC2     *PGM       CLP         TAAHSTIC2     QATTCL
   TAAHSTIR      *PGM       RPG         TAAHSTIR      QATTRPG