Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

Parameters

Qualifiers

/AFTER

/BACKUP

/BEFORE

/BY_OWNER

/CHARACTERISTICS

/CLI

/CONFIRM

/CPUTIME

/CREATED

/DELETE

/EXCLUDE

/EXPIRED

/HOLD

/IDENTIFY

/KEEP

/LOG_FILE

/MODIFIED

/NAME

/NOTIFY

/PARAMETERS

/PRINTER

/PRIORITY

/QUEUE

/REMOTE

/SINCE

/RESTART

/USER

/WSDEFAULT

/WSEXTENT

/WSQUOTA

HELP SUBMIT — MicroVMS 4.5B

Queues a batch job.

Format
 SUBMIT file-spec,...

 Requires the Secure User Environment Option.

Additional information available:

ParametersQualifiers

Parameters

file-spec,...
 Name of a file containing a command procedure (or files containing
 command procedures). Wildcard characters are allowed. The file type
 defaults to COM. If a node name is specified, the /REMOTE qualifier
 must also be specified.

Qualifiers

Additional information available:

/AFTER/BACKUP/BEFORE/BY_OWNER/CHARACTERISTICS
/CLI/CONFIRM/CPUTIME/CREATED/DELETE/EXCLUDE/EXPIRED
/HOLD/IDENTIFY/KEEP/LOG_FILE/MODIFIED/NAME/NOTIFY
/PARAMETERS/PRINTER/PRIORITY/QUEUE/REMOTE/SINCE
/RESTART/USER/WSDEFAULT/WSEXTENT/WSQUOTA

/AFTER=absolute-time

 /NOAFTER
 Holds the job until the specified time. If the time has passed,
 processes the job immediately. Time can be an absolute time or a
 combination of absolute and delta times.

/BACKUP

 /NOBACKUP
 Selects files according to the dates of their most recent
 backups.  Relevant only with the /BEFORE and /SINCE qualifiers.

/BEFORE[=time]

 /NOBEFORE
 Submits only those files dated before the specified time.  You
 can specifiy time as an absolute time, as a combination of
 absolute and delta times, or as one of the following keywords:
 TODAY (default), TOMORROW, or YESTERDAY.  Specified with
 /BACKUP, /CREATED, /EXPIRED, or /MODIFIED.

/BY_OWNER[=uic]

 Submits only those files with the specified user identification
 code.  The default uic is that of the current system.

/CHARACTERISTICS=(characteristic,...)

 Specifies one or more characteristics for processing the job. A job
 must have all the characteristics specified for the job (or it remains
 pending).

/CLI=file-spec

 Specifies the command language interpreter (CLI) that will be used in
 processing the job. The file name specifies that the CLI be
 SYS$SYSTEM:filename.EXE. The default CLI is that defined in the user's
 authorization file.

/CONFIRM

 /NOCONFIRM (default)
 Issues a request for confirmation before submitting each file.  The
 following responses are valid:

 +----------+-----------------------------------------------+
 | YES      | Submit the file                               |
 +----------+-----------------------------------------------+
 | NO       | Do not submit the file                        |
 +----------+-----------------------------------------------+
 | TRUE     | Submit the file                               |
 +----------+-----------------------------------------------+
 | FALSE    | Do not submit the file                        |
 +----------+-----------------------------------------------+
 | 1        | Submit the file                               |
 +----------+-----------------------------------------------+
 | 0        | Do not submit the file                        |
 +----------+-----------------------------------------------+
 | <RETURN> | Do not submit the file                        |
 +----------+-----------------------------------------------+
 | ALL      | Continue execution of the command with no     |
 |          | further confirmation prompts                  |
 +----------+-----------------------------------------------+
 | <CTRL/Z> | Stop execution of the command                 |
 +----------+-----------------------------------------------+
 | QUIT     | Stop execution of the command                 |
 +----------+-----------------------------------------------+

/CPUTIME=keyword

 Specifies a CPU time limit for the batch job. Time can be specified as
 delta time, 0, NONE, or INFINITE. Both the value 0 and the keyword
 INFINITE allow unlimited CPU time; the keyword NONE defaults to your
 user authorization file (UAF) value or the limit specified on the
 queue. Note that you cannot specify more time than permitted by the
 base queue limits or your own UAF.

/CREATED

 /NOCREATED
 Selects files based on their dates of creation.  Relevant only
 with the /BEFORE and /SINCE qualifiers.

/DELETE

 /NODELETE (default)
 Positional qualifier.
 As a command qualifier -- deletes all files after executing them.

 As a parameter qualifier -- deletes the file after executing it.

/EXCLUDE=(file-spec,...)

 /NOEXCLUDE
 Excludes files from the SUBMIT operation.  The qualifier value
 file-spec cannot include a device name.  Wildcard  characters are
 supported for file specifications.  However, you cannot use relative
 version numbers to exclude a specific version.

/EXPIRED

 /NOEXPIRED
 Selects files based on their dates of expiration.  Relevant only
 with the /BEFORE and /SINCE operations.

/HOLD

 /NOHOLD (default)
 Holds the job (until released by the SET QUEUE/ENTRY command).

/IDENTIFY (default)

 /NOIDENTIFY
 Displays the queue name and job number of the job when it is queued.

/KEEP

 /NOKEEP (default)
 Saves the log file after printing it; /NOKEEP is the default unless
 /NOPRINTER is specified.

/LOG_FILE=file-spec

 /NOLOG_FILE
 Names the log file. The default is job-name.LOG. You can use /LOG_FILE
 to specify a different device. Logical names in the file specification
 are translated in the context of the process that submits the job.

/MODIFIED

 /NOMODIFIED
 Selects files according to the dates on which they were last
 modified.  Relevant only with the /BEFORE and /SINCE qualifiers.

/NAME=job-name

 Names the job (and possibly the batch job log file). The name must be
 1 through 39 alphanumeric characters. Enclose the name in parentheses
 if it contains any special characters. The default is the name of the
 first file in the job.

/NOTIFY

 /NONOTIFY (default)
 Broadcasts a message to your terminal when the job completes.

/PARAMETERS=(parameter,...)

 Provides the values of up to 8 optional parameters (equated to P1
 through P8, respectively, in each command procedure in the job). If
 the parameter contains spaces, special characters, or lowercase
 characters, enclose it in quotation marks. The size of the parameter
 (including enclosing quotation marks and the preceding comma) must not
 exceed 255 characters.  However, the total length of all eight
 parameter strings of the /PARAMETER qualifier cannot exceed 480
 characters.  The symbols are local to the specified command procedure.

/PRINTER=queue-name

 /NOPRINTER
 Queues the log file to the specified queue for printing. The default
 is SYS$PRINT.

/PRIORITY=n

 Requires OPER or ALTPRI privilege to raise the priority
 above the value of the MAXQUEPRI parameter.
 Specifies the job scheduling priority for the specified job. The value
 of n is an integer from 0 to 255; the default is the value of the
 SYSGEN parameter DEFQUEPRI.

/QUEUE=queue-name

 Queues the job to the specified batch queue. The default is SYS$BATCH.

/REMOTE

 Requires the DECnet Option.
 Queues the job to a queue on another node. The node name must be
 included in the file specification. No other qualifiers can be
 specified with /REMOTE.

/SINCE[=time]

 /NOSINCE
 Submits only those files dated since the specified time.  You
 can specifiy time as an absolute time, as a combination of
 absolute and delta times, or as one of the following keywords:
 TODAY (default), TOMORROW, or YESTERDAY.  Specified with
 /BACKUP, /CREATED, /EXPIRED, or /MODIFIED.

/RESTART

 /NORESTART (default)
 Restarts the job after a crash or a STOP/REQUEUE command.

/USER=user-name

 Requires CMKRNL privilege and R (read) access to the User
 Authorization File.
 Submits a job for another user so that the job runs under that user's
 user name and UIC.

/WSDEFAULT=n

 Defines a working set default for a batch job; the /WSDEFAULT
 qualifier overrides the working set size specified in the user
 authorization file. Possible values of n are a positive integer in the
 range 1 through 65535, 0, or the keyword NONE. A 0 or NONE sets the
 default value to the value specified either in the UAF or by the
 working set quota established for the queue. You cannot request a
 value higher than the default.

/WSEXTENT=n

 Defines a working set extent for the batch job; the /WSEXTENT
 qualifier overrides the working set extent in the user authorization
 file. Possible values of n are a positive integer in the range 1
 through 65535, 0, or the keyword NONE. A 0 or NONE sets the default
 value to the value specified either in the UAF or set for the queue.
 You cannot request a value higher than the default.

/WSQUOTA=n

 Defines a working set page size (working set quota) for the batch job;
 the /WSQUOTA qualifier overrides the value in the user authorization
 file. Possible values of n are a positive integer in the range 1
 through 65535, 0, or the keyword NONE. A 0 or NONE sets the default
 value to the value specified either in the UAF or set for the queue.
 You cannot request a value higher than the default.

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026