TAA Tools
DSPMSGUSE2      DISPLAY MESSAGE USE 2                  TAAMSJI

The Display  Message Use  2 command  reads the outfile  created by  the
SCNEXTMSGF TAA  tool and creates  a listing of  the message ID  and the
command  name  that sends  the message  if it  is  known.   Only system
commands that  send  escape messages  can  be identified.    Diagnostic
messages and messages from APIs cannot be identified.

Assume  you see  some message  text, but  are not  sure of  the command
that  sent the message.   From the message text,  you identify a string
of characters that can  be used to  search the message descriptions  of
the system.

You  must  first  set  up  the  file  for  the  descriptions  with  the
SCNEXTMSGF tool.   This requires the use  of CRTEXTMSGF and CVTEXTMSGF.
See the discussion using DSPTAA SCNEXTMSGF.

Once the SCNEXTMSGP file  has been created, you  can use SCNEXTMSGF  to
create an outfile  of records which contain  a string of text  found in
the  messages.    Assume you  want  to  scan  for  the string  'special
authority' in all messages and create an outfile

             SCNEXTMSGF   SCNVALUE('special authority') MSGLIB(xxx)
                            OUTPUT(*OUTFILE) OUTLIB(QTEMP)

The  SCNVALUE  is  folded to  uppercase  as  well as  the  message text
before  scanning.     The  MSGLIB  parameter  identifies   the  library
containing  the  SCNEXTMSGP  file.   The  OUTLIB  parameter  identifies
where  the outfile  SCNMSGP will  be placed.   It will  contain records
for the message  IDs that  have the string  'special authority'  within
the message text.

The  DSPMSGUSE2 command  may then  be  used to  determine the  commands
associated with any system escape messages.

             DSPMSGUSE2

A  listing  would be  produced  of  all the  message  IDs  that contain
descriptive text with the string  'special authority'.  If the  command
is known,  it is listed  also.   The command may  not be known  because
the  string is in  a Diagnostic message  or from  an API.   Only escape
messages  from  system  commands can  be  found  programmatically which
determines what DSPMSGUSE2 can find.

DSPMSGUSE2 escape messages you can monitor for
----------------------------------------------

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

DSPMSGUSE2 Command parameters                         *CMD
-----------------------------

   SCNMSGPLIB    The name of the  library containing the SCNMSGP  file.
                 The  file  must have  been  output  by the  SCNEXTMSGF
                 command.   *LIBL is  the default.   A specific library
                 or *CURLIB may also be used.

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

The SCNMSGP file must have been output by the SCNEXTMSGF TAA tool.

See the previous comments about what command names can be found.

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

The following TAA Tools must be on your system:

     CHKDBFMBR       Check data base file member
     RSNLSTMSG       Resend last message
     RTVFMT          Retrieve format
     RTVSYSVAL3      Retrieve system value 3
     SNDCOMPMSG      Send completion message
     SNDESCINF       Send escape information

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

None, the tool is ready to use.

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

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

   DSPMSGUSE2    *CMD                   TAAMSJI       QATTCMD
   TAAMSJIC      *PGM       CLP         TAAMSJIC      QATTCL
   TAAMSJIR      *PGM       RPG         TAAMSJIR      QATTRPG
					

Added to TAA Productivity tools April 15, 2010


Home Page Up to Top