The Run I/O command is  a testing aid to submit a batch  job to perform
a series  of writes to a data  base file in QTEMP.   This can assist in
testing  system performance  by various  tools that  need to  work with
data base activity.

*JOBCTL  authority  is  required  to  prevent  the  *PUBLIC  user  from
issuing the command.

A typical command would be:

             RUNIO      RECORDS(10000) DLYAFTWRT(5)

A batch  job would be submitted to  the QSYSNOMAX job queue.   It would
write  1000 records and then wait for  5 seconds before writing another
1000 records.   When 10,000  records had  been written,  the job  would
end.

RUNIO escape messages you can monitor for
-----------------------------------------

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

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

   RECORDS       The total  number of records to  be written.   It must
                 be  a value  between 1 and  99,999,999,999.   The data
                 is written as 20 byte  records to the TAATMPP file  in
                 QTEMP.

   DLYAFTWRT     The  number  of  seconds  to  wait  after  each  1,000
                 records  are written.    This  allows for  a  burst of
                 activity.

   JOBQ          The  job queue  to submit  the job  to.   QSYSNOMAX is
                 the default  to ensure  the job  will run  when it  is
                 submitted.   The library qualifier  defaults to *LIBL.

   FILE          The  name of the file on which  to write.  The default
                 is QTEMP/TAATMPP.    The  file  will  be  created  and
                 deleted by  this command and  must not exist  prior to
                 the command.   The library must exist  and can be used
                 to target a specific ASP  by using SETASPGRP prior  to
                 RUNIO.  If a  batch job is submitted it  will use this
                 ASP group as the INLASPGRP.

   RCDLEN        The record  length of the file.  This  can be 20, 500,
                 1000, 5000, or 10000.  The default is 20.

   RCDGRP        The  number  of  records to  write  in a  group.   The
                 default is  1000.  The  number of  groups will be  the
                 total  number  of  records   divided  by  this  number
                 rounded  up to  the nearest  integer.  The  last group
                 written may not be a full group.

   ASPLMT        The maximum  percentage that  the ASP  can be  filled.
                 If this  threshold is  reached, RUNIO  will terminate.
                 This  safeguards  against overfilling  the  ASP.   The
                 default is 80.

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

*JOBCTL  authority  is  required  to  prevent  the  *PUBLIC  user  from
issuing the command.

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

The following TAA Tools must be on your system:

     CHKJOBCTL       Check *JOBCTL special authority
     CHKOBJ3         Check object 3
     RSNLSTMSG       Resend last 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
   ------        ----    ---------      ----------    ----------

   RUNIO         *CMD                   TAADBMY       QATTCMD
   TAADBMYC      *PGM       CLP         TAADBMYC      QATTCL
   TAADBMYC2     *PGM       CLP         TAADBMYC2     QATTCL
   TAADBMYR      *PGM       RPG         TAADBMYR      QATTRPG