----------------------
QBATCH
© by Thibaut MAQUET
90 rue du FG ST Lazare
F59600 Maubeuge France
----------------------

     QBatch works exactly as the Run command. It detaches itself from the CLI
and runs a background process, freeing your system for further activities.
QBatch is very useful for people who use slow compilers, for archiving
maniacs such as myself, and for those who like doing many things at the same
time. The command allows you interesting options such as system pause and
time option.
     QBatch is available from CLI/SHELL on any AMIGA. Even if a command has
an icon, you can not run QBatch from Workbench. To use correctly, copy QBatch
to your C: directory. As well, QBatch needs the S: directory and your SYS:
for internal uses. At least,the following CLI commands must be available:
EXECUTE, COPY and RUN. Put them in your C directory or residents list.

Synopsis:

QBatch -option1 -option2 -... -optionN "command to run"

Example:

QBatch -n -w "execute nightly_arc"
 
... for execute nightly_arc batch file. QBatch will work in the current
directory and will advise you at the end of the job. Note that
"command_to_run" must be an executable file. All arguments and wildcards
supported.
     Warning: ALIAS is not supported.
 
OPTIONS
     Type:

QBatch -h  <press Return>

     The following help menu gives you some information about available
options.

 *** QBatch version1.0 - Copyright © Thibaut Maquet.

 Usage: QBatch [-<options>] "command"

OPTIONS LIST:

    -e  notify jobs failure
    -h  help menu 
    -n  notify end of job
    -ofile set output file
    -pfile print file
    -q  suppress supervisor messages
    -s  stop system
    -thh:mn wait hour hh and minute mn
    -w  set working directory

     QBatch is an utility inspired by an AOS-VS command. It runs a job as a
background process like the Run command. This frees system for further
activities.
     Here is some informations about the different options.

     1. "e" option. Type:

QBatch -e "command"

     If for any reason, QBatch cannot run your job, (Run,Execute,
Copy,printer troubles...),it will immediately inform you. This option does
not inform you of a failure command but of a failure job, which is more
important to know. Thus, QBatch will not advise you when you entered a bad
command name.

     2. "h" option. Type :

QBatch -h

     This displays the help menu.

     3. "n" option. Type :

QBatch -n "command"

     This option notifies an end of job. When a job is completed, WorkBench
screen will flash and you will hear two noises.

     4. "o" option. Type :

QBatch -oOutput_File "command"

     This allows you to head all output data for a Output_File. Default is
CON: standard window. Example:

QBatch -oT:res "Sort file.dat"

... sends all output to T:res file. If output file is not available, then
QBatch displays the following message:

Output file can not be opened.

     5. "p" option. Type:

QBatch -pFile_to_print

     This option allows you to print any text files.

     6. "q" option. Type:

QBatch -q "command"

     All supervisor messages will be removed.

     7. "s" option. Type :

QBatch -s

     By activating this option, you stop all activities. Screen becomes
black and all output units are stopped. By pressing left mouse button, you
leave this option. If you have a small brother who like "computing" you will
love this option.

     8. "t" option. Type:

QBatch -t22:15 "lha a nightly_arc #?"

     This will run lha after a quarter past 22 in 24-hour time. So, QBatch
will wait until the right time. When you switch off your system, you lose the
job. If you enter a wrong time, QBatch displays the following message:
 
Illegal time.

     9. "w" option. Type:

QBatch -w "command"

     QBatch works in the root directory. If you want to use the current
directory, you must use this option.

     10. Other options
     QBatch does not know other options. If you enter other options, QBatch
will ignore them.

ADVICE
     QBatch is a multitasking program. It works with a very small priority so
it will not disturb other tasks. Do not run too many jobs at the same time;
otherwise your system will turn into a rheumatic turtle.

END OF TEXT