Queues one or more files containing command procedures to a batch
   queue.

   Requires OPER (operator) privilege, execute (E)  access to the
   queue, or write (W)  access to the queue.

   Format

     SUBMIT  filespec[,...]

Additional information available:

PARAMETERQUALIFIERSEXAMPLES

filespec[,...]
   Specifies one or more files containing command procedures.
   Wildcard characters (* and %) are allowed in the directory
   specification, file name, file type, and version number fields.
   The default file type is that of the preceding file. If no
   previous file specification contains an explicit file type, the
   default file type is COM.

   If you specify more than one file, separate the file
   specifications with either commas (,)  or plus signs (+).

   If you specify a node name, you must use the /REMOTE qualifier.

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/RESTART
/SINCE/USER/WSDEFAULT/WSEXTENT/WSQUOTA

      /AFTER=time
      /NOAFTER

   Requests that the job be held until after a specific time. If
   the specified time has passed already, the job is processed
   immediately.

   You can specify time as either an absolute time or as a
   combination of absolute and delta times. For complete information
   on specifying time values, see the VMS DCL Concepts Manual.

   In a VAXcluster, a batch job submitted to execute at a specific
   time may begin execution a little before or after the requested
   time. This occurs when the clocks of the member systems in the
   VAXcluster are not synchronized. For example, a job submitted
   using the DCL command SUBMIT/AFTER=TOMORROW may execute at 11:58
   P.M. relative to the host system's clock.

   This problem can occur in a cluster even if a job is run on
   the same machine from which it was submitted, because the
   redundancy built into the batch/print system allows more than
   one job controller in the cluster to receive a timer asynchronous
   system trap (AST) for the job and, thus, to schedule it for
   execution. Moreover, this behavior is exacerbated if the batch job
   immediately resubmits itself to run the next day using the same
   SUBMIT command. This can result in having multiple instances of
   the job executing simultaneously because TOMORROW (after midnight)
   might be only a minute or two in the future.

   A solution to this problem is to place the SUBMIT command in a
   command procedure that begins with a WAIT command, where the
   delta-time specified in the WAIT command is greater than the
   maximum difference in time between any two systems in the cluster.
   Use the SHOW TIME command on each system to determine this
   difference in time. Use the SYSMAN command CONFIGURATION SET TIME
   to synchronize clocks on the cluster. For complete information
   on the SYSMAN command CONFIGURATION SET TIME, see the VMS SYSMAN
   Utility Manual.

      /BACKUP
      /NOBACKUP

   Modifies the time value specified with the /BEFORE or the /SINCE
   qualifier. The /BACKUP qualifier selects files according to the
   dates of their most recent backups. This qualifier is incompatible
   with the following qualifiers that also allow you to select files
   according to time attributes: /CREATED, /EXPIRED, and /MODIFIED.
   If you specify none of these four time qualifiers, the default is
   the /CREATED qualifier.

      /BEFORE[=time]
      /NOBEFORE

   Selects only those files dated prior to the specified time.
   You can specify 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. Specify one of the
   following qualifiers with the /BEFORE qualifier to indicate the
   time attribute to be used as the basis for selection: /BACKUP,
   /CREATED (default), /EXPIRED, or /MODIFIED.

   For complete information on specifying time values, see the VMS
   DCL Concepts Manual.

      /BY_OWNER[=uic]
      /NOBY_OWNER

   Selects only those files whose owner user identification code
   (UIC) matches the specified owner UIC. The default UIC is that of
   the current process.

   Specify the UIC by using standard UIC format as described in the
   VMS DCL Concepts Manual.

      /CHARACTERISTICS=(characteristic[,...])

   Specifies the name or numbers of one or more characteristics to
   be associated with the the job. Characteristics can refer to such
   things as color of ink. If you specify only one characteristic,
   you can omit the parentheses.

   A characteristic's number must range from 0 to 127. To see which
   characteristics have been defined for your system, use the SHOW
   QUEUE/CHARACTERISTICS command. To see which characteristics
   are associated with a particular queue, use the SHOW QUEUE/FULL
   command.

   A job can be executed on a queue only if none, some, or all of the
   characteristics associated with the queue also are associated
   with the job. That is, the job's characteristics must be a
   subset of the queue's characteristics. However, if any of the
   characteristics associated with the job are not associated with
   the queue, the job remains pending until one or more of the
   following occurs:

   o  The characteristics specified with the queue are changed
      to make the job's characteristics a subset of the queue's
      characteristics (using, for example, the SET QUEUE
      /CHARACTERISTICS command).

   o  The characteristics specified with the job are changed to
      make the job's characteristics a subset of the queue's
      characteristics (using, for example, the SET ENTRY
      /CHARACTERISTICS command).

   o  The job is moved to a queue on which all the job's
      characteristics have been specified (using, for example, the
      SET ENTRY/REQUEUE command).

   o  The job is deleted (using, for example, the DELETE/ENTRY
      command).

      /CLI=filename

   Specifies the command language interpreter (CLI) to be used to
   process the job. The file specification assumes the device name
   SYS$SYSTEM: and the file type EXE (SYS$SYSTEM:filename.EXE). The
   default CLI is that defined in the user authorization file (UAF).

      /CONFIRM
      /NOCONFIRM (default)

   Controls whether a request is issued before each submit operation
   to confirm that the operation should be performed on that file.
   The following responses are valid:

   YES       NO        QUIT

   TRUE      FALSE     Ctrl/Z

   1         0         ALL

             <Return>

   You can use any combination of uppercase and lowercase letters
   for word responses. You can abbreviate word responses to one or
   more letters (for example, T, TR, or TRU for TRUE), but these
   abbreviations must be unique. Affirmative answers are YES, TRUE,
   and 1. Negative answers include: NO, FALSE, 0, and pressing
   the Return key. Entering QUIT or pressing Ctrl/Z indicates that
   you want to stop processing the command at that point. When you
   respond by entering ALL, the command continues to process, but no
   further prompts are given. If you type a response other than one
   of those in the list, DCL issues an error message and redisplays
   the prompt.

      /CPUTIME=time

   Defines a CPU time limit for the batch job. You can specify time
   as delta time, 0, INFINITE, or NONE. If the queue on which the
   job executes has a defined CPUMAXIMUM value, the smaller of the
   SUBMIT command and queue values is used. If the queue on which
   the job executes does not have a specified maximum CPU time limit,
   the smaller of the SUBMIT command and user authorization file
   (UAF) values is used. If the queue on which the job executes
   does not have a specified maximum CPU time limit and the UAF has
   a specified CPU time limit of NONE, either the value 0 or the
   keyword INFINITE allows unlimited CPU time. If you specify the
   keyword NONE, the specified queue or UAF value is used. CPU time
   values must be greater than or equal to the number specified by
   the SYSGEN parameter PQL_MCPULM.

      /CREATED (default)
      /NOCREATED

   Modifies the time value specified with the /BEFORE or the /SINCE
   qualifier. The /CREATED qualifier selects files based on their
   dates of creation. This qualifier is incompatible with the
   following qualifiers that also allow you to select files according
   to time attributes: /BACKUP, /EXPIRED, and /MODIFIED. If you
   specify none of these four time qualifiers, the default is the
   /CREATED qualifier.

      /DELETE
      /NODELETE (default)

   Positional qualifier.

   Controls whether files are deleted after processing. If you
   specify the /DELETE qualifier after the SUBMIT command name, all
   files in the job are deleted after processing. If you specify the
   /DELETE qualifier after a file specification, only that file is
   deleted after it is processed.

   For the /DELETE qualifier to work, the protection code on
   the input files must allow delete (D)  access to the user
   identification code (UIC) of the user submitting the job.

      /EXCLUDE=(filespec[,...])
      /NOEXCLUDE

   Excludes the specified files from the submit operation.
   You can include a directory but not a device in the file
   specification. Wildcard characters (* and %)  are allowed in
   the file specification. However, you cannot use relative version
   numbers to exclude a specific version. If you specify only one
   file, you can omit the parentheses.

      /EXPIRED
      /NOEXPIRED

   Modifies the time value specified with the /BEFORE or the /SINCE
   qualifier. The /EXPIRED qualifier selects files according to their
   expiration dates. (The expiration date is set with the SET FILE
   /EXPIRATION_DATE command.) The /EXPIRED qualifier is incompatible
   with the following qualifiers that also allow you to select files
   according to time attributes: /BACKUP, /CREATED, and /MODIFIED. If
   you specify none of these four time qualifiers, the default is the
   /CREATED qualifier.

      /HOLD
      /NOHOLD (default)

   Controls whether the job is made available for immediate
   processing. The /HOLD qualifier holds the job until it is released
   by the SET ENTRY/RELEASE or the SET ENTRY/NOHOLD command.

      /IDENTIFY (default)
      /NOIDENTIFY

   Displays the job name, the queue name, the entry number, and the
   status of the job when it is queued.

      /KEEP
      /NOKEEP

   Controls whether the log file is deleted after it is printed; the
   /NOKEEP qualifier is the default unless the /NOPRINTER qualifier
   is specified.

      /LOG_FILE[=filespec]
      /NOLOG_FILE

   Names the log file. No wildcards (* and %)  are allowed in the
   file specification.

   When you use the /LOG_FILE qualifier, the system writes the batch
   job's output to the file you specify. If you use the /NOLOG_
   FILE qualifier, no log file is created. By default, a log file
   is created, is written to the directory defined by the logical
   name SYS$LOGIN in the UAF, and is given the batch job's name as
   its file name with a file type of LOG. By default, a log file also
   is given the batch job's name as its file name with a file type of
   LOG.

   You can use the /LOG_FILE qualifier to write the log file to a
   different device. Logical names in the file specification are
   translated in the context of the process that submits the job. The
   process executing the batch job must have access to the device on
   which the log file will reside.

   If you omit the /LOG_FILE qualifier and specify the /NAME
   qualifier, the log file is written to a file having the same file
   name as that specified by the /NAME qualifier with the file type
   LOG. When you omit the /LOG_FILE qualifier, the job-name value
   used with the /NAME qualifier must be a valid file name.

      /MODIFIED
      /NOMODIFIED

   Modifies the time value specified with the /BEFORE or the /SINCE
   qualifier. The /MODIFIED qualifier selects files according to
   the dates on which they were last modified. This qualifier is
   incompatible with the following qualifiers that also allow you to
   select files according to time attributes: /BACKUP, /CREATED, and
   /EXPIRED. If you specify none of these four time modifiers, the
   default is the /CREATED qualifier.

      /NAME=job-name

   Names the job (and possibly the batch job log file). The job name
   must be 1 to 39 alphanumeric characters. If characters other than
   alphanumeric characters, underscores (_),  or dollar signs ($)
   are used in the name, enclose the name in quotation marks (" ").
   The default job name is the name of the first file in the job.

   If you omit the /LOG_FILE qualifier, the job-name value must be
   a valid file name. The SHOW ENTRY and SHOW QUEUE/FULL commands
   display the job name.

      /NOTIFY
      /NONOTIFY (default)

   Controls whether a message is broadcast to your terminal session
   when the job is completed or aborted.

      /PARAMETERS=(parameter[,...])

   Provides the values of up to eight optional parameters (equated to
   the symbols P1 to P8, respectively, for each command procedure
   in the job). The symbols are local to the specified command
   procedure.

   Commas (,)  separate individual parameters. If you specify only
   one parameter, you can omit the parentheses.

   If the parameter contains spaces, special characters, or lowercase
   characters, enclose it in quotation marks. The size of the
   parameter can be from 1 to 255 characters.

      /PRINTER[=queue-name](default)
      /NOPRINTER

   Queues the job log file for printing when your job is completed.
   The /PRINTER qualifier allows you to specify a particular print
   queue; the default print queue is SYS$PRINT. If you specify the
   /NOPRINTER qualifier, the /KEEP qualifier is assumed.

      /PRIORITY=n

   Requires OPER (operator) or ALTPRI (alter privilege) privilege to
   specify a priority greater than the value of the SYSGEN parameter
   MAXQUEPRI.

   Specifies the job-scheduling priority for the batch job with
   respect to other jobs in the same queue. The value of n is an
   integer in the range of 0 to 255, where 0 is the lowest priority
   and 255 is the highest.

   The default value is the value of the SYSGEN parameter DEFQUEPRI.
   No privilege is needed to set the priority lower than the
   MAXQUEPRI value.

   The /PRIORITY qualifier has no effect on the job's process
   execution priority. The job's process execution priority is
   determined by the base priority attribute of the INITIALIZE/QUEUE
   /BASE_PRIORITY command.

      /QUEUE=queue-name[:]

   Identifies the batch queue on which the job is entered. The
   default queue is SYS$BATCH.

   Queues the job to SYS$BATCH on the remote node specified. When you
   use the /REMOTE qualifier, you must include the node name in the
   file specification.

   Note that, unlike submitting a job on a local node, multiple
   command procedures queued by a single SUBMIT/REMOTE command are
   considered separate jobs.

   You can specify only the following qualifiers with the /REMOTE
   qualifier:

   o  /BACKUP

   o  /BEFORE

   o  /BY_OWNER

   o  /CONFIRM

   o  /CREATED

   o  /EXCLUDE

   o  /EXPIRED

   o  /MODIFIED

   o  /SINCE

      /RESTART
      /NORESTART (default)

   Indicates whether the job restarts after a system failure or after
   a STOP/QUEUE/REQUEUE command.

      /SINCE[=time]
      /NOSINCE

   Selects only those files dated after the specified time. You can
   specify time as an absolute time, a combination of absolute and
   delta times, or as one of the following keywords: TODAY (default),
   TOMORROW, or YESTERDAY. Specify one of the following qualifiers
   with the /SINCE qualifier to indicate the time attribute to be
   used as the basis for selection: /BACKUP, /CREATED (default),
   /EXPIRED, or /MODIFIED.

   For complete information on specifying time values, see the VMS
   DCL Concepts Manual.

      /USER=username

   Requires CMKRNL (change mode to kernel) privilege and read (R)
   and write (W)  access to the user authorization file (UAF).

   Allows you to submit a job on behalf of another user. The job
   runs exactly as if that user had submitted it. The job runs
   under that user's user name and user identification code (UIC),
   and accounting information is logged to that user's account.
   By default, the user identification comes from the requesting
   process. The username qualifier value can be any user name that is
   validated on your system. The name must be 1 to 12 alphanumeric
   characters.

      /WSDEFAULT=n

   Defines for a batch job a working set default, the default number
   of physical pages that the job can use. If the queue on which the
   job executes has a nonzero default working set, the smaller of
   the specified job and queue values is used. If the queue on which
   the job executes has a working set default of 0, the smaller of
   the specified job and UAF values (value established in the user
   authorization file) is used. If you specify the value 0 or NONE,
   the specified queue or UAF value is used. Working set default
   values must range between the numbers specified by the SYSGEN
   parameters PQL_MWSDEFAULT and WSMAX.

      /WSEXTENT=n

   Defines for the batch job a working set extent, the maximum
   amount of physical memory that the job can use. The job uses
   the maximum amount of physical memory only when the system has
   excess free pages. If the queue on which the job executes has a
   nonzero working set extent, the smaller of the specified job and
   queue values is used. If the queue on which the job executes has a
   working set extent of 0, the smaller of the specified job and the
   value established in the user authorization file (UAF) is used. If
   you specify the value 0 or NONE, the specified queue or UAF value
   is used. Working set extent values must range between the numbers
   specified by the SYSGEN parameters PQL_MWSEXTENT and WSMAX.

      /WSQUOTA=n

   Defines for the batch job a working set quota, the amount of
   physical memory that the job is guaranteed. If the queue on which
   the job executes has a nonzero working set quota, the smaller of
   the specified job and queue values is used. If the queue on which
   the job executes has a working set quota of 0, the smaller of the
   specified job or the value established in the user authorization
   file (UAF) is used. If you specify the value 0 or NONE, the
   specified queue or UAF value is used. Working set quota values
   must range between the numbers specified by the SYSGEN parameters
   PQL_MWSQUOTA and WSMAX.

   1.  $ SUBMIT /PARAMETERS=(TXT,DOC,MEM) BACKUP, -
       _$AVERAGE, RUNMASTER
         Job BACKUP (queue SYS$BATCH, entry 416) pending

     In this example, the SUBMIT command enters three command
     procedures in a single job. The job is given three parameters:
     P1 is equated to the string TXT, P2 to the string DOC, and P3
     to the string MEM. After the procedure BACKUP.COM is executed,
     the procedures AVERAGE.COM and RUNMASTER.COM are executed.

   2.  $ SUBMIT/NAME=BATCH24/HOLD TESTALL
         Job BATCH24 (queue SYS$BATCH, entry 467) holding

     In this example, the SUBMIT command enters the procedure
     TESTALL.COM as a batch job and specifies that the job be held
     for later processing. The job is not released until the SET
     ENTRY/RELEASE command is entered. The /NAME qualifier requests
     that the batch job be identified as BATCH24.


   3.  $ SUBMIT TEST.COM
         Job TEST (queue SYS$BATCH, entry 493) pending
       $ BATCH_JOB = $ENTRY
          .
          .
          .
       $ DELETE/ENTRY='BATCH_JOB'

     In this command sequence, the $ENTRY symbol is used to refer to
     a particular job in the queue file. The SUBMIT command creates
     a batch job to run the command procedure TEST.COM. In addition,
     the SUBMIT command defines $ENTRY as a local symbol whose
     value is the entry number of the job (493 in this example).
     The second statement assigns the value $ENTRY to the local
     symbol BATCH_JOB. The last line of the example deletes the job
     by using the symbol BATCH_JOB to identify it.

   4.  $ DEFINE JUNE WORKZ:[JONES]ANNUAL_REPORT.COM
       $ SUBMIT JUNE

       Job ANNUAL_REPORT (queue SYS$BATCH, entry 229) started on ZOO_BATCH

     In this example, the logical name JUNE is created and equated
     to ANNUAL_REPORT.COM with the DEFINE command. Using the logical
     name JUNE, the user submits ANNUAL_REPORT.COM to the batch
     queue. Note that the system translates the logical name JUNE
     to ANNUAL_REPORT.COM before ANNUAL_REPORT.COM is submitted
     to the batch queue. Also, the log file produced is named
     ANNUAL_REPORT.COM rather than JUNE.COM.

     Note also that the job is submitted to the generic queue
     SYS$BATCH, but runs on the execution queue ZOO_BATCH.