TAA Tools
DSPMSG2         DISPLAY MESSAGE 2                      TAAMSKJ

Display Message  2 allows  several selection  criteria to minimize  the
number  of messages that  would be displayed  or listed.   For example,
you  can  display by  message ID,  message  type, job,  user, start/end
date/time, or the  sending program.   The DSPMSG2  command may be  used
on any message queue, but would most likely be used with QSYSOPR.

A typical command would be:

             DSPMSG2    MSGQ(QSYSOPR) MSGID(xxxxxxx)

A listing would  be displayed with only the message  IDs that match the
one specified.

DSPMSG2 escape messages you can monitor for
-------------------------------------------

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

DSPMSG2 Command parameters                            *CMD
--------------------------

   MSGQ          The  qualified   name  of  the  message  queue  to  be
                 displayed.  The default is QSYSOPR.

                 The library  value  defaults  to  QSYS.    A  specific
                 library, *LIBL, or *CURLIB may also be used.

   STRDAT        The  date to  begin  displaying messages.   *BEGIN  is
                 the default  for the first date of  a message that was
                 sent to  the  message queue.    *TODAY or  a  specific
                 date (in job format) may be entered.

   STRTIM        The time  associated with  STRDAT to begin  displaying
                 messages.   *AVAIL  is the  default meaning  the first
                 message with a date matching the STRDAT value.

   ENDDAT        The  date to end  displaying messages.   *AVAIL is the
                 default meaning  the  date of  the  last message  that
                 was sent  to the message  queue.  A specific  date may
                 be entered in job format.

   ENDTIM        The  time  associated with  ENDDAT  to  end displaying
                 messages.   *AVAIL is  the  default meaning  the  last
                 message with a date matching the ENDDAT value.

   MSGTYPE       A list of  up 7 message types that  will be displayed.
                 *ALL  is the  default for  all  types.   The supported
                 values are *COMP, *DIAG,  *INFO, *INQ, *SNDCPY,  *RQS,
                 and *RQSPMT.

   SEV           The severity of the  messages to be displayed.   00 is
                 the   default  which   allows  any   severity   to  be
                 displayed.     A  value  (00-99)  may  be  entered  to
                 request all severities *GE.

   MSGID         A list  of  up  to 40  message  IDs to  be  displayed.
                 *ALL is the default for all message IDs.

   JOB           The job  that sent the  message.  *ALL is  the default
                 for all jobs.

   USER          The  user that sent the message.   *ALL is the default
                 for all users.

   SNDPGM        The program  that  sent  the  message.   *ALL  is  the
                 default for all programs.

   SNDMODULE     The  module  that  sent  the message.    *ALL  is  the
                 default for all modules.

   SNDPROC       The  procedure that  sent the  message.   *ALL  is the
                 default for all procedures.

   MSGTXT        The value to  scan the  message text  for.   Up to  20
                 bytes  may  be  entered.   Both  the  MSGTXT  and  the
                 message are folded to upper case before scanning.

   LISTTYPE      The type of listing to be output.

                 *BASIC  is the default  to list  one line  per message
                 with an abbreviated message text.

                 *DETAIL  may  be  specified to  list  additional lines
                 per message.   This  includes  the job  number of  the
                 job  that sent  the message,  the sending  program (or
                 module/procedure),   the  message  file/library  where
                 the message was sent from,  and the full 256 bytes  of
                 text.

   SEQ           The sequence in the messages are to be displayed.

                 *ASCEND  is  the  default   to  display  in  ascending
                 sequence.

                 *DESCEND  may be  specified  to display  in descending
                 sequence.

   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
     FMTLIN          Format line
     RSNLSTMSG       Resend last message
     RTVMSGQA        Retrieve message queue attributes
     RTVSYSVAL3      Retrieve system value 3
     SNDCOMPMSG      Send completion message
     SNDESCINF       Send escape information
     SNDESCMSG       Send escape message
     SNDSTSMSG       Send status message
     SORTDBF         Sort data base file
     TRNVAL          Translate value

Implementation
--------------

None, the tool is ready to use.

Objects used by the tool
------------------------

   Object        Type    Attribute      Src member    Src file
   ------        ----    ---------      ----------    ----------

   DSPMSG2       *CMD                   TAAMSKJ       QATTCMD
   TAAMSKJC      *PGM       CLP         TAAMSKJC      QATTCL
   TAAMSKJC2     *PGM       CLP         TAAMSKJC2     QATTCL
   TAAMSKJR      *PGM       RPG         TAAMSKJR      QATTRPG
					

Added to TAA Productivity tools January 15, 2014


Home Page Up to Top