Trailing-Edge
-
PDP-10 Archives
-
BB-JR93N-BB_1990
-
10,7/galaxy/queue/submit.hlp
There are 3 other files named submit.hlp in the archive. Click here to see a list.
SUBMIT Command
Function
The SUBMIT command places entries into the input queue for the
batch system. See the help file QUEUE for more information and
examples.
See the TOPS-10/TOPS-20 Batch Reference Manual for more
information about batch jobs.
Format
SUBMIT jobname=control-file-spec,log-file-spec
Where: jobname is the name of the job to be entered into the
queue. The jobname is optional. If you omit it, the
default job name is the name of the log file.
The equal sign is required only if you specify the job
name.
control-file-spec is the name of the input file. This
file contains all monitor-level and user-level commands
for processing by the batch controller (BATCON). If
you do not include a device in the file specification,
and if the monitor does not find the control file in
your job search list, the monitor will search ersatz
device CTL for the control file.
log-file-spec is the name of the output file. The
batch controller uses this file to record its
processing of the job.
Only the two files mentioned above can be specified in a request
to the batch input queue. The name of the control file is
required; the log file name is optional and, if omitted, is taken
from the control file. If the job name is omitted, it defaults
to the name of the log file, if present, or the name of the
control file if no log file is specified. If an extension is
omitted, the following are assumed:
.CTL for the control file
.LOG for the log file
If you type SUBMIT with no arguments or switches, a list of the
jobs in the batch queue will be printed on your terminal.
The switches to this command can be divided into two categories,
depending on whether the switch can be used only once, or can be
used more times, in a single command string. The two categories
are:
o Queue-Operation Switches
These switches can be used only once in the command string.
They affect the entire request, and you can place them
anywhere in the command string. If you have used one of
these switches in a command string, you cannot use it again
in the same string. Many switches have a /NO construction,
which has a negative effect. Be sure you do not use the /NO
construction of a switch in the same command string with the
positive construction.
o File-Control Switches
These switches can be used any number of times in the command
string. You can also use the /NO construction of a switch in
the same command string with the positive construction. For
more help on switches, and how to achieve a temporary or
permanent effect by the placement of the switch, see the help
file SWITCH.
Switch Category Function
/ABEFORE: File Queues the file only if the access
date-time control date is before the specified date
and time.
/ACCOUNT: Queue Specifies the account to which the
"string" operation job should be charged. If the
account contains any
nonalphanumeric characters, you
must enclose the string in
quotation marks.
/AFTER: Queue Processes the request after the
date-time operation specified date and time.
/ALLFILES: Queue Accepts the request only if all of
YES or NO operation the files in the request exist.
That is, if any specified file is
not present, no files are
processed. /ALLFILES is the same
as /ALLFILES:YES. By default (or
/ALLFILES:NO), if all of the files
do not exist, the existing files
are still processed.
/ASINCE: File Queues only the files that have
date-time control been accessed since the specified
date and time.
/ASSISTANCE: Queue Specifies whether the job needs
YES or NO operation or does not need operator
intervention. Arguments are YES or
1 and NO or 0. If you specify NO
and then request assistance, your
job is cancelled. Assistance is
any action the operator must take
before the job can continue,
including PLEASE and MOUNT
requests.
/BATLOG:arg Queue Controls the output of the log file
operation on disk. Arguments are:
APPEND Appends the log file to any
existing file of the same name.
SUPERSEDE Replaces any existing
file of the same name with the new
file.
SPOOL Spools the log file for
output to the printer instead of
writing the file into your
directory. This prevents a large
log file from using up your disk
quota. Will not override
/OUTPUT:NOLOG.
/BATOPT: Queue Specifies a LOGIN option line to
option-name operation read for LOGIN switches to apply to
the batch job. The option name
that you specify with the /BATOPT
switch must match a line in the
SWITCH.INI file that appears as:
LOGIN:option-name/switches
/BEFORE: File Queues the file only if it was
date-time control created before the specified date
and time.
/BEGIN:n File Starts the output on the nth line
control of the control file.
/CARDS:n Queue Uses n as the maximum number of
operation cards that can be punched by the
batch job (up to 10,000). If you
omit the switch, no cards will be
punched.
/CHECK Queue Prints on your terminal a list of
operation the batch queue entries made by
your job.
/CORE:n Queue Uses n (in decimal K) as the
operation maximum amount of memory that your
job can use.
/CREATE Queue Makes a new entry in the batch
operation input queue. This is the default
function except when you are
listing queue entries.
/DELETE File Deletes the control file after
control processing it. (This is the same
as /DISPOSE:DELETE.)
/DEPENDENCY:n Queue Specifies the initial value of the
operation dependency count in decimal. When
used with /MODIFY, this switch
changes the dependency count of a
previously submitted job. If n is
a signed number (+ or -), that
number is added to or subtracted
from the dependent job's count. If
n is not a signed number, the
dependent job's count is changed to
n.
/DESTINATION: Queue Specifies the node that will
node operation process output requests from this
batch job, including the printing
of the log file. Use the node name
or the node number to specify the
node. If you specify another host
or a node that does not exist, the
job will wait in the queue
indefinitely.
/DISPOSE: File Controls the disposition of the
arg control control file after it is processed.
The arguments to this switch are:
DELETE deletes the file from your
directory after spooling it.
PRESERVE preserves the file after
processing it. This is the default
function.
RENAME is no longer supported.
/DISTRIBUTION: Queue Specifies text to place in the
"text" operation distribution field, on the banner
page of output listings. For batch
input requests, the distribution
text is printed on the banner page
of the log file listing. You can
use this field to include mailing
information, or the location where
the operator should leave the
listing. The text field may be up
to 39 alphanumeric characters,
including punctuation and spaces if
the text is placed in quotation
marks.
/ERBINARY File Prints an error message if a binary
control file is included in the request.
This is the default function.
/ERNONE Queue Prints an error message if no files
operation match the file specification. This
is the default function.
/ERPROTECTION Queue Prints an error message if
operation processing the request would
require a violation of file
protection. This is the default
function.
/FAST Queue Prints a list of the entries in the
operation batch queue in a fast format on
your terminal.
/FEET:n Queue Uses n as the maximum number of
operation feet of paper tape that the batch
job can punch. If the switch is
omitted, no paper tape is punched.
/HELP: Queue Prints information on your terminal
arg operation about the QUEUE command. This
switch does not queue any files.
/HELP can be used alone or with one
of the following arguments:
TEXT prints a message about the
format and switches to the QUEUE
command. This is the same as /HELP
with no arguments.
SWITCHES prints a list of all the
switches available with the QUEUE
command.
/JOBNAME:name Queue Specifies the name of the job. The
operation job name can be up to six
alphanumeric characters.
/KILL Queue Removes the specified entry from
operation the queue. You must give the job
name, /SEQUENCE, or /REQUESTID, to
the left of the equal sign in the
command line. See the examples.
/LENGTH:n:m File Processes only files whose length
control is between n and m blocks.
/LIST:arg Queue Prints information about the jobs
operation in the queue. If you use /LIST
alone, it shows the jobs in the
queue. This is equivalent to using
the QUEUE command with no arguments
and no switches. /LIST can be
abbreviated to /L. The switch can
also take one of the following
arguments:
ALL shows all data about each queue
request.
FAST shows a fast list of the queue
requests. (This is the same as
/FAST.)
JOBS shows a list of the jobs in
the queue. (This is the same as
/LIST with no arguments.)
SUMMARY shows only the summary line
of the queue display.
/MESSAGE:arg Queue Specifies the amount of information
operation to be printed when an error occurs
from the request. You can specify
one or more of the following
arguments:
ADDRESS prints the location in
memory where the error occurred.
CONTINUATION prints information
about the error.
FIRST prints the one-line error
message.
PREFIX prints a six-character error
prefix.
/METERS:n Queue Uses n as the maximum number of
operation meters of paper tape that can be
punched by the job.
/MODIFY Queue Alters the specified parameter in
operation the specified job. This switch
requires that you have access
rights to the job. You must give a
job name, /SEQUENCE, or /REQUESTID,
to the left of the equal sign in
the command line. This switch can
be used to modify a previously
submitted request as long as the
request has not been started. See
the examples.
/NEW: File Accepts the request even if the
YES or NO control file does not yet exist. Does not
search for control file on CTL:
/NONEW File Does not accept the file
control specification of a file that does
not exist. This is the default
function.
/NONOTIFY Queue Does not set the system to notify
operation you when a request is completed.
See /NOTIFY.
/NOOPTION Queue Ignores the SWITCH.INI file.
operation For help on SWITCH.INI files, see
the help file SWINI.
/NOPHYSICAL File Searches for the file by
control recognizing any logical names.
This is the default function.
/NORESTART Queue Prevents the job from being
operation restarted if it was stopped because
of a system crash. This is the
default function.
/NOTIFY: Queue Sets the system to notify you when
YES or NO operation your request is completed. To be
notified, use /NOTIFY with no
argument, or with YES or 1 as an
argument. To suppress
notification, use /NOTIFY:0 or
/NOTIFY:NO. By default, you are
not notified when a request is
finished.
/OKBINARY File Accepts files whose extensions
control indicate that they include binary
information. Normally, files with
extensions .SAV, .SHR, .LOW, .REL,
.EXE, and .HGH will not be accepted
for processing.
/OKNONE Queue Does not produce a warning message
operation if no files match the file
specification.
/OKPROTECTION Queue Does not output an error message
operation when a protection code is violated.
/OPTION:option Queue Uses the option line QUEUE:option
operation in the SWITCH.INI file. For help
on SWITCH.INI files, see the help
file SWINI.
/OUTPUT:arg Queue Determines whether or not the log
operation file will be printed. This switch
has three arguments only one of
which can be specified at a time.
The arguments are LOG, NOLOG, and
ERROR.
LOG prints the log file.
NOLOG suppresses printing of the
log file.
ERROR prints the log file only if
an error occurs.
/PAGES:n Queue Uses n as the maximum number of
operation pages of output that your job can
print.
/PATH:[dir] Queue Specifies the directory to be
operation accessed.
/PHYSICAL File Does not recognize logical names
control for devices in the command line.
/PRESERVE File Saves the control file after
control processing it. This is the default
and it is the same as
/DISPOSE:PRESERVE.
/PRIORITY:n Queue Gives the specified priority (n is
operation 1 to 63) to the request. A larger
number has greater priority.
/PROCESSING:node Queue Specifies the node that is to
operation process the batch job. Use the
node name or node number to specify
the node. Batch jobs can be
submitted to IBM host nodes only.
Jobs submitted to nodes other than
IBM host nodes will wait in the
queue indefinitely.
/PROTECTION: Queue Specifies a protection code for the
nnn operation queue request. Queue requests are
protected in the same way that
files are protected. See the help
file PCODES.
/READER Queue Causes a disk-resident card job to
operation be read as if it were punched on
cards and had been submitted
through the card reader.
/REMOTE Queue Prints on your terminal a list of
operation remote queues. Must be used with
/DESTINATION.
/REQUESTID:n Queue Specifies the request
operation identification number of the job
you wish to modify or terminate
(/KILL). The request
identification number is assigned
when the request is queued. This
switch is used to the left of the
equal sign in the command line.
See the examples.
/RESTARTABLE: Queue Specifies whether the job should be
YES or NO operation restarted after the system has
crashed and been restored.
Arguments are: YES (or 1) and NO
(or 0). The default function is
NO.
/RUN:file Queue Executes the specified program
operation (file) after your request is
accepted.
/RUNCORE:nx Queue Executes the program specified in
operation /RUN in nK of core after the
request is accepted. The value can
also be expressed in terms of nP
(pages).
/RUNOFFSET:n Queue Executes the program specified in
operation /RUN with offset n after the
request is accepted.
/SEQUENCE:n Queue Specifies a sequence number to help
operation identify a request to be modified
or deleted. This switch must be
used to the left of the equal sign
in the command line.
/SINCE: File Queues only the files with creation
date-time control dates after the specified date and
time.
/SITGO Queue Processes the batch job using the
operation SITGO compiler.
/STREAM:n Queue Prints a list of the jobs that are
operation running or destined to run in the
specified batch stream.
/TAG:xxx File Starts at the statement labeled xxx
control in the control file. Equivalent to
GOTO xxx at the beginning of the
control file.
/TIME:hh-mm-ss Queue Specifies the CPU time limit for
operation the job. The form /TIME:n can be
used to specify a limit of n
seconds.
/TMPFIL: Queue Creates a temporary file TMP:file
file:text operation and enters the text into this file.
/TPLOT:n Queue Uses n minutes as the maximum
operation amount of plotting time allowed for
your job. If you omit the switch,
no plotter time is allowed.
/UNIQUE: Queue Specifies whether more than one
YES or NO operation batch job can run from your PPN at
one time. If the value is YES (or
1), only one job will run at a
time. Any other batch jobs will
wait until the previous job is
finished. If the value is NO (or
0), any number of batch jobs can
run at the same time.
/USERNAME: Queue Specifies the user name field for
"name" operation the banner page of output listings.
For batch input requests, the user
name is printed on the banner page
for the log file listing. This
field can contain up to 39
alphanumeric characters, and may
include punctuation and spaces if
the name is placed in quotation
marks.
Associated Messages
When you make an entry into the batch queue, the system prints
the following message on your terminal:
[BATCH JOB name QUEUED, REQUEST #nnn, RUN TIME:time]
Where: name is the name of the job in the queue. This can be
specified by the user. Otherwise, the name of the log
file is used.
nnn is the number that represents the request
identification of the job in the queue.
time is the amount of time allowed for the batch job to
run.
Characteristics
Leaves your job at monitor level.
Destroys your core image.
Does not require that you be logged in if you only want the list
of batch queue entries.
Examples
1. Create a control file.
.SOS CUE.CTL<RET>
INPUT: CUE.CTL
00100 PRINT SYS: NOTICE.TXT<RET>
00200 <ESC>
E<RET>
[DKSC: CUE.CTL]
Submit the control file.
.SUBMIT CUE.CTL<RET>
[BATCH JOB CUE QUEUED, REQUEST #132, LIMIT 0:05:00]
Use DIRECTORY to see new .LOG file.
.DIR CUE<RET>
CUE CTL 1 <055> dd-mmm-yy DSKC: [27,5434]
CUE LOG 3 <055> dd-mmm-yy
TOTAL OF 4 BLOCKS IN 2 FILES ON DSKC: [27,5434]
.
2. Submit the control file CUE.CTL to the batch queue for
processing at 5:00 p.m.:
.SUBMIT CUE /AFTER:17:00<RET>
[BATCH JOB CUE QUEUED, REQUEST 79, LIMIT 0:05:00]
Change the processing time to 4:30 p.m., identifying the job
by its request identification number:
.SUBMIT /REQUESTID:79= /MODIFY /AFTER:16:30<RET>
[1 JOB MODIFIED]
Cancel the batch job CUE altogether:
.SUBMIT CUE= /KILL<RET>
[1 JOB CANCELED]
.