
SUBMIT [[queuename:][jobname][/jobsw]=]file[/filesw] . . .

The SUBMIT command submits one or more files for processing on a batch
processor. The files are grouped together into a single QMG batch job
and will be executed one after the other without interruption.

The optional queuename allows you to submit your job to a queue other than
the default BATCH. The optional jobname allows you to give your print job
a name. If you do not specify jobname, the name of the first file in the
job is used as the job name.

The following job switches are available:

/AF:hh:mm:dd-mmm-yy		/[NO]HO			/[NO]LO
/[NO]PRIN:queue			/PRIO:priority		/[NO]RE

The following file switches are available:

/[NO]DE
/[NO]TR

2 AFTER

SUB /AF:hh:mm:dd-mmm-yy=files

The /AF switch allows you to specify that the processing of your job should
be delayed until after a specified date and time. The job will not run
immediately at that time, but will become eligible to be processed, and will
compete with other jobs at that time.

You may specify either the date, or the time, or both. If you do not
specify a date, the current date is assumed.  To specify the date
without the time, omit the hh and mm values, but still include the
colons.

TOMORROW is a valid date specification.

Examples:

SUB /AF:18:00=BIGFILE.BAT		! process the file after 6 pm

SUB /AF:::1-APR-82=JOKE.BAT		! process the file on April 1, 1982

SUB /AF:0:0:TOMORROW=NEW.DAY		! process the file after midnight
SUB /AF:::TOMORROW=NEW.DAY
2 DELETE

SUB files/[NO]DE

The /DE switch specifies that the specified file, and all succeding files,
are to be deleted after processing. The default is /NODE.

In the following example, FILE1.TXT will not be deleted after processing,
but both FILE2.TXT and FILE3.TXT will.

Example:

SUB FILE1.BAT,FILE2.BAT/DE,FILE3.BAT
2 HOLD

SUB /[NO]HO=files

The /HO switch specifies that your job is to be held (made ineligible for
printing). You must then release the job to allow it to be processed.

See HELP QUE /REL.
2 LOG

SUB /[NO]LO=files

The /LO switch specifies whether or not a logfile of the job should be 
generated. The logfile tracks all the action in the batch job.

The default is /LO.
2 PRINT

SUB /[NO]PRIN=files
SUB /PRIN:queue=files

The /PRIN switch specifies whether or not the batch log should be printed.

If you specify /NOPRIN, the logfile will not be printed, but rather, will be
placed in your directory. All output of the batch job not contained in the
batch log file (spooled MACRO listings, etc.) will be printed as separate
print jobs.

If you specify /PRIN, the logfile will be queued to be printed. All output of
the batch job not contained in the batch log file (spooled MACRO listings,
etc.) will be attached to the batch log and printed with it as a single print
job.

If you want your batch log to go to a queue other than PRINT, you can specify
another queue on the /PRIN switch.

The default is /PRIN:PRINT.
2 PRIORITY

SUB /PRIO:n=files

The /PRIO switch allows you to specify a priority for your batch job. This
priority does not specify the priority at which the batch job actually runs,
but is simply used to determine position in the queue.

Privileged users may specify any priority between 1 and 250. Non-privileged
users may only spcify priorities between 1 and 150.

The default is /PRIO:50. /PRIO:0 is the same as /PRIO:50.
2 RESTART

SUB /[NO]RE=files

The /RE switch specifies whether or not your job is to be restarted from the
beginning if it is interrupted.

If you specify /RE, if your job is stopped for some reason, and then started,
it will start over again from the beginning.

If you specify /NORE, the default, if your job is stopped for some reason, and
then started, it will be held.
2 TRANSFER

SUB /[NO]TR

The /TR switch specifies whether or not the system should make 
temporary copies of batch command files submitted from a volume 
mounted on a private (allocated) device. The default is /TR. This
permits you to dismount the volume and deallocate the device as
soon as the prompt returns after the SUBMIT command.

If you specify /NOTR, no copies will be made and you must keep the
volume mounted and the device deallocated until batch processing is
completed.
