The Repeat Command  command allows a  command to be repeated  between 1
and  99999  times.   RPTCMD  is  primarily a  testing  aid  and can  be
helpful when stress testing a function.

A typical command would be:

             RPTCMD    CMD(xxx) COUNT(100)

The  command would be run 100 times.   If all executions of the command
are successful, a completion message is sent.

If the command  fails on  any execution, any  messages would exist  for
the  last execution.   Whether  other messages  exist is  determined by
the RTNMSG (retain messages) parameter.

The  default for RTNMSG  is *LAST.   If the  command completes normally
each time it is  run, any messages sent by  all but the last  execution
of the command  would be removed.   Messages sent from the  last use of
the command would be re-sent (if any).

Use of the Command Prompting
----------------------------

The command to be repeated can be prompted for by using F4.

RPTCMD escape messages you can monitor for
------------------------------------------

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

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

   CMD           The  command to  be repeated.    Up to  500 characters
                 may be entered.

                 Command prompting  of the  command to  be run  may  be
                 used  by  entering  the command  with  a  leading  '?'
                 character.

   COUNT         The number  of repetitions to  be made.  It  must be a
                 number between 1 and 99999.

   RTNMSG        Whether  to  retain  messages  sent  from  the command
                 that is  executed.   Each  time  through the  loop  of
                 processing,  the value  is  checked.   If the  command
                 fails, any error messages will exist.

                 *LAST   is  the  default.    For   all  but  the  last
                 execution of  the command,  any messages  sent by  the
                 command  are removed.    On  the last  execution,  any
                 messages are resent.

                 *YES may  be specified to retain  any messages sent by
                 the command.   They will  be low  level messages  when
                 the command completes.

                 *NO may specified  to remove all messages sent  by all
                 executions of the command.


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

Since  the   command  to  be   repeated  is  run   using  QCMDEXC,  any
interactive  command run must be specified  to allow *EXEC on the ALLOW
parameter.

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

The following TAA Tools must be on your system:

     EDTVAR          Edit variable
     RSNLSTMSG       Resend last message
     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
   ------        ----    ---------      ----------    ----------

   RPTCMD        *CMD                   TAACMFI       QATTCMD
   TAACMFIC      *PGM       CLP         TAACMFIC      QATTCL