                S y s t e m  I / O  E x e r c i s e r

	 Utility to provide a constant I/O load on the system.

  IOX Commands are:

	Abort		BAdblocks	BUffersize
	CONFigure	CONTrol_c	DENsity
	DESelect	ERrorlimit	EXEcute
	EXIt		Files11		Help
	INterleave	ITerations	Logfile
	PARameterlist	PATtern		PRIntsummary
	PROceed		RAndom		REPorterrors
	REStart		RETries		RUntime
	SElect		SPy		STart
	SUmmarytime	Temporaryfile	VErify
	VOlumecheck	WAit		WRitecheck

 For additional information about individual commands type:
 	HELP IOX commandname

2 ABORT

	IOX> ABO        ; Abort everything
        IOX> ABO task   ; Abort task
        IOX> ABO /ALL   ; Abort all tasks

 This command,  when given in CONTROL/C AST command mode and  with  no
 arguments,   will  cause  I/O  on  all  units  to  be stopped and the
 Exerciser run to be aborted.  All units remain selected,  all  active
 tasks  are  aborted  but  not removed from the execution list and all
 parameters remain unchanged.  Control  is  then  returned  to  normal
 command mode.

 When this command is given with a task name that has been executed by
 the  EXECUTE  command,  the task will be aborted and removed from the
 execution list.

 When this command is followed by the /ALL switch,  all  active  tasks
 will be aborted and all tasks will be removed from the execution list.

2 BADBLOCKS

      IOX> BADBLOCKS ddnn: [list]

 This  command  permits  known  bad blocks on a unit to be entered and
 subsequently ignored during non-file structured operations.  The unit
 must be selected using the FILES11 command.
 Note:	The exerciser does not use the tast 50 blocks of a device.  If
 one of these blocks is entered as bad, a message will printed.

    Format:
        BAD DK0: 70:3
		Adds a cluster of three blocks starting at block 70 to
                the list for DK0:
	BAD DK0: 100:2,3,300:100
                Adds blocks 100, 101, 3 and 300 thru 399 to the list.
        BAD DK0:
                Prints the bad block list thus:
	00070:003
	00100:002
	00003:001
	00300:100

2 BUFFERSIZE

        IOX> BUFFERSIZE n

 This   command   will  change  the  default  of  non-file  structured
 buffersize to the specified value.  The specified  value  is  stored,
 MOD 4, and buffer space is requested if necessary.

2 CONFIGURE

        IOX> CONFIGURE [ddnn:]

 The  CONFIGURE  command  will allow a new device data structure to be
 added to the Exerciser or print  the  list  of  currently  configured
 devices.

    Format:
        CONF DK5:
                Adds device DK5: to the exerciser's data structures
        CONF
                Prints current configuration

2 CONTROL_C

        IOX> CONTROL_C YES
        IOX> CONTROL_C NO

 This command will enable or disable the use of the CONTROL/C AST trap.
 With  CONTROL/C AST's disabled, the terminal can be used to run other
 tasks.  When CONTROL/C AST's are enabled, typing anything other  than
 CTRL/C will cause an error message to be printed.

2 DENSITY

	IOX> DENSITY ddnn: [n]

 This command will either print the density of the specified device or
 set the density of the device to the value specified.

2 DESELECT

        IOX> DESELECT ddnn:

 This command will stop all active I/O on the specified  unit,  delete
 the bad block list, deselect it's LUN and detach the device.

2 ERRORLIMIT

        IOX> ERRORLIMIT n

 This command will set the maximum number of errors that each device
 may have between summary reports.

2 EXECUTE

        IOX> EXECUTE task [command line]
 
 This command will cause the specified task to execute ( via the spawn
 mechanism ) with the supplied command line.  All the rules concerning
 command lines and tasks for the executive Spawn directive apply here.

2 EXIT

        IOX> EXIT

 The EXIT command will cause the Exerciser to exit with a status of WARNING.

2 FILES11

        IOX> FILES11 ddnn: [n]

 This command will select a disk for file structured reads and writes.

    Format:
        F DK5:
		The above command will open a temporary  file  (marked
		for  deletion)  on  DK5:.   The  size  of  the file is
		determined by the optional decimal value.  If no value
		is specified, the default will be  that  of  the  last
                TEMPORARYFILE command.

2 HELP

	IOX> HELP

 This command will print a summary of each exerciser command.

2 INTERLEAVE

        IOX> INTERLEAVE n

 This  command  will  set  the  block structured interleave factor for
 sequential  disk operations.  This  factor is added  to  the previous
 block number to abtain the new block number.

2 ITERATIONS

        IOX> ITERATIONS n

 This  command will set the idle loop iteration count to the specified
 value.

2 LOGFILE

	IOX> LOGFILE YES
	IOX> LOGFILE NO

 This  command  will  enable  or disable the use of a log file for all
 output that is normally directed to the terminal.  The  file  IOX.LOG
 is created or appended to as desired.

2 PARAMETERLIST

        IOX> PARAMETERLIST

 This command will display information about  the  currently  selected
 devices  and  tasks, the current defaulted parameters and the dynamic
 memory usage.

2 PATTERN

	IOX> PATTERN [n]

 This command will display the current menu of write/read data patterns
 indicating which pattern is currently selected.  If the optional value
 is specified, it will change the data pattern.

2 PRINTSUMMARY

        IOX> PRINTSUMMARY

 This command will print  the  current  operational  totals  for  each
 selected device.

2 PROCEED

        IOX> PROCEED

 This  command will proceed from CONTROL/C command mode into CONTROL/C
 AST mode.  Note: Summary reports and error reports cannot occur while
 in CONTROL/C command mode.

2 RANDOM

        IOX> RANDOM YES
        IOX> RANDOM NO

 This command  will enable  or  disable random  disk  block  seeking.
 When random seeking is disabled, sequential interleaved block number
 determination is used.   See the  INTERLEAVE  command for additional
 information.

2 REPORTERRORS

        IOX> REPORTERRORS YES
        IOX> REPORTERRORS NO

 This command will enable or disable error reporting to the terminal

2 RESTART

        IOX> RESTART

 This  command  will  cause  the  Exerciser to deselect and detach all
 devices, remove  all  user  configured  data  structures,  reset  all
 parameters  to  their initial default values and return the Exerciser
 to its original memory size.

2 RETRIES

        IOX> RETRIES YES
        IOX> RETRIES NO

 This command will enable  or  disable  handler  retries  on  non-file
 structured operations.

2 RUNTIME

        IOX> RUNTIME n

 This  command will set the runtime of the Exerciser.  If a value of 0
 (you must type 0) is entered, the Exerciser will run continuously.

2 SELECT

        IOX> SELECT ddnn: [n]

 This command will select a device for non-file structured reading and
 writing.

    Format:
	SE DK1: 100
		The above command will select DK1: for non-file structured
		I/O operations.  The optional value of 100 will cause only
		100 bytes of data to be written and read for each operation.

2 SPY

        IOX> SPY [ddnn:]

 The SPY command allows the user to look at the  current  state  of  a
 device.   The  current LBN or VBN, function code and I/O state (idle,
 AST queued, in progress) is displayed.  If the optional device is not
 specified then the status for all devices will be displayed.

2 START

        IOX> START

 This command will start the exercising of all selected devices.

2 SUMMARYTIME

        IOX> SUMMARYTIME n

 This command will set the  time  interval  between  summary  progress
 reports.  A value of 0 will inhibit summary reports.

2 TEMPORARYFILE

        IOX> TEMPORARYFILE n

 This  command  will change the default file structured temporary file
 size to the specified value.

2 VERIFY

        IOX> VERIFY ddnn: [n]

 This command will do a read only check in non-file  structured  mode,
 on  the device.  The optional value specifies the number of blocks to
 check.  After the blocks  have  been  checked,  the  device  will  be
 deselected and detached.

2 VOLUMECHECK

        IOX> VOLUMECHECK YES
        IOX> VOLUMECHECK NO

 When  volume checking is enabled each non-file structured device will
 be checked to see if the volume to be tested has a home block.  If it
 does, a warning message will be printed.

2 WAIT

        IOX> WAIT YES
        IOX> WAIT NO

 This command will enable or disable the use of the executive WTSE$S
 directive  in  the idle loop.  If WAIT is disabled, the instruction
 "BICB  -(SP),(SP)+"  is  used.  See  the  ITERATIONS  command   for
 additional information.

2 WRITECHECK

        IOX> WRITECHECK YES
        IOX> WRITECHECK NO

 This  command  will  enable  or  disble  write  checking for non-file
 structured disk write operations.

