The  Remove  All  Messages command  is  intended  for  programmers  who
generate  a  lot of  messages  in  their interactive  job  and want  to
periodically cleanup their job log message queue.

The command has no parameters and is entered as:

             RMVALLMSG

A  prompt will appear asking to confirm the  request.  Y is the default
and if used will remove:

  **   Messages sent to programs that are no longer active.

  **   Messages  sent to  your  current  program.   If  you  are  on  a
       command entry  display, all messages  sent to the  command entry
       program  will be removed.   However, if the  current display has
       messages, they  will remain  on the  display,  but the  commands
       cannot be accessed using F9.

This has the  effect of cleaning up  the job log message  queue.  Since
this  also removes  a lot of  audit trail,  the command should  be used
appropriately.

The command  can only  be used  interactively such  as from  a  command
entry display or an interactive CL program.

Typical uses for RMVALLMSG
--------------------------

  **   When  group jobs  or system  request  jobs will  be  ended by  a
       signoff that  requests a *LIST or an  abnormal termination (such
       as  when PWRDWNSYS  is used  and jobs  are still  active), large
       job logs  that  of no  particular  value can  be  generated.   A
       periodic  use of  RMVALLMSG can  reduce  the size  of these  job
       logs.

  **   When  a tool such as CHKSAVRST is  intended to be used following
       a  SAV  or  RST  command,  the  CHKSAVRST  tool  will   be  more
       effective  if the  job log  message queue  is clean.   Using  as
       sequence of commands as:

            RMVALLMSG
            SAV or RST
            CHKSAVRST

       will make the CHKSAVRST results more obvious.

  **   Assume  some function is  failing and you  want to send  the job
       log to someone.  To  produce a simple job  log, you do not  need
       to signoff, but rather  just use RMVALLMSG to clean  out the job
       log message queue such as:

             RMVALLMSG
             /* Do the function that is failing */
             DSPJOBLOG   OUTPUT(*PRINT)

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

None.

Restrictions
------------

The command  can only be  used interactively or in  an interactive used
CL program.

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

The following TAA Tools must be on your system:

     PMTOPR          Prompt operator
     SNDCOMPMSG      Send completion message
     SNDESCMSG       Send escape message

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

None, the tool is ready to use.

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

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

   RMVALLMSG     *CMD                   TAAMSHH       QATTCMD
   TAAMSHHC      *PGM       CLP         TAAMSHHC      QATTCL