HELP SUBMIT — MicroVMS 4.6
Queues a batch job. Format SUBMIT file-spec,... Requires the Secure User Environment Option.
Additional information available:
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.