TAA Tools
DSPMSGQINQ      DISPLAY MESSAGE QUEUE INQUIRIES        TAAMSJO

The Display Message  Queue Inquiries command displays or  lists inquiry
messages and  their replies from a message queue  such as QSYSOPR.  The
formatting  allows a better  review than the DSPMSG  command.  A detail
option for additional information is available.

A typical command would be:

             DSPMSGQINQ  MSGQ(QSYSOPR)

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.

Using your own CVTMSGQ function
-------------------------------

Some  users  may prefer  to  capture the  contents of  a  message queue
periodically and  create  the  MSGLSTP  file in  a  permanent  library.
CVTMSGQ  supports  this capability  and  you  can  add messages  to  an
existing MSGLSTP file.

This  could be  used for  QSYSOPR for users  that periodically  IPL the
system, but want a DSPMSGQINQ listing for several days.

To achieve this, use  CVTMSGQ when needed  and then specify  DSPMSGQINQ
MSGQ(*MSGLSTP).  Specify the  library (or use the library  list to find
the MSGLSTP file).

Note that  when using this technique, you must  manage the capturing of
messages.

  **   The  tool does not  check if the same  messages are converted to
       the MSGLSTP  file.   The listing  occurs in  the physical  order
       (arrival sequence)  of the  MSGLSTP file so  they may not  be in
       time sequence and it is possible to have duplicate messages.

  **   The  DSPMSGQINQ  listing  does not  describe  the  message queue
       where the  messages  were  converted  from.    Therefore  it  is
       possible to  have one listing  combining messages  from multiple
       message queues.

DSPMSGQINQ escape messages you can monitor for
----------------------------------------------
None.  Escape messages from based on functions will be re-sent.

DSPMSGQINQ Command parameters                         *CMD
-----------------------------

   MSGQ          The  qualified name  of the  message queue  to display
                 inquiry messages for.   The library value defaults  to
                 *LIBL.   A  specific library  or *CURLIB  may also  be
                 used.

                 The  special value  *MSGLSTP may  be used  to describe
                 that  you  are  managing  the  conversion  of messages
                 yourself.   For  example,  you  may  periodically  use
                 CVTMSGQ  for the  same message  queue and  add records
                 to  the same  file.   See the previous  comments about
                 this  approach.      The  library   qualifier   should
                 describe  where the  MSGLSTP  file exists.   Only  the
                 first member is processed.

   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.   The special  value *TODAY  may be  entered for
                 todays  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.

                 A message must  be selected  by all  of the  selection
                 parameters in order to display it.

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

None.

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

The following TAA Tools must be on your system:

     CHKDBFMBR       Check data base file member
     CHKOBJ3         Check object 3
     CVTMSGQ         Convert message queue
     CVTDAT          Convert date
     CVTTIM          Convert time
     RSNLSTMSG       Resend last message
     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
   ------        ----    ---------      ----------    ----------

   DSPMSGQINQ    *CMD                   TAAMSJO       QATTCMD
   TAAMSJOC      *PGM       CLP         TAAMSJOC      QATTCL
   TAAMSJOC2     *PGM       CLP         TAAMSJOC2     QATTCL
   TAAMSJOR      *PGM       RPG         TAAMSJOR      QATTRPG
					

Added to TAA Productivity tools January 15, 2011


Home Page Up to Top