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

  Requires OPER privilege, EXECUTE (E) access to the queue,  or  WRITE
  (W) access to the queue.


  Format:


    SUBMIT  file-spec[,...]

Additional information available:

ParametersCommand QualifiersExamples

 file-spec[,...]

  Specifies  one or more files containing command procedures. Wildcard
  characters 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 two or more files, 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 23:58 relative to the
  host system's clock.

 /BACKUP
 /NOBACKUP

  Modifies  the  interpretation  of  the time value specified with the
  /BEFORE or /SINCE qualifier. /BACKUP selects files according to  the
  dates  of  their most recent backups. This qualifier is incompatible
  with the other qualifiers that 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 /CREATED.

 /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
  /BEFORE 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 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  through  127  and  its
  association   with  a  particular  characteristic  name  is  system-
  specific. 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:

  -  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)

  -  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)

  -  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)

  -  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.

 /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

               <RET>

  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  are  NO,  FALSE, 0, and <RET>. QUIT or CTRL/Z
  indicates that you want to  stop  processing  the  command  at  that
  point.  When you respond with 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=option

  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 0 or 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  interpretation  of  the time value specified with the
  /BEFORE or /SINCE qualifier. The qualifier  /CREATED  selects  files
  based  on  their  dates  of creation. This qualifier is incompatible
  with the other qualifiers that 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 /CREATED.

 /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 /DELETE to work, the protection code on  the  input  files  must
  allow D (delete) access to the user identification code (UIC) of the
  user submitting the job.

 /EXCLUDE=(file-spec[,...])
 /NOEXCLUDE

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

 /EXPIRED
 /NOEXPIRED

  Modifies  the  interpretation  of  the time value specified with the
  /BEFORE or /SINCE qualifier. /EXPIRED  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  other  qualifiers  that 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 /CREATED.

 /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 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.
  /NOKEEP is the default unless the /NOPRINTER qualifier is used.

 /LOG_FILE[=file-spec]
 /NOLOG_FILE

  Names   the   log  file.  No  wildcards  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 /NOLOG_FILE, no log
  file is created. By default, a log file is created, written  to  the
  directory  defined  by  the  logical  name SYS$LOGIN on the UAF, and
  given the batch job's name as its logical 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 /NAME
  must be a valid file name.

 /MODIFIED
 /NOMODIFIED

  Modifies the interpretation of the time  value  specified  with  the
  /BEFORE  or  /SINCE  qualifier. /MODIFIED selects files according to
  the dates on which  they  were  last  modified.  This  qualifier  is
  incompatible  with  the  other  qualifiers  that 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
  /CREATED.

 /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
  alphanumerics, 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 command 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 through P8, respectively, for each command  procedure
  in  the  job).  The  symbols  are  local  to  the  specified command
  procedure.

  Commas delimit  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.
  /PRINTER allows you to specify a particular print queue; the default
  print queue is  SYS$PRINT.  If  you  specify  /NOPRINTER,  /KEEP  is
  assumed.

 /PRIORITY=n

  Requires OPER or ALTPRI 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 through 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.

 /REMOTE

  Queues  the  job to SYS$BATCH on the remote node specified. When you
  use  /REMOTE,  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 /REMOTE: /BACKUP,
  /BEFORE,  /BY_OWNER,   /CONFIRM,   /CREATED,   /EXCLUDE,   /EXPIRED,
  /MODIFIED, and /SINCE.

 /RESTART
 /NORESTART (default)

  Specifies whether the job will restart 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
  /SINCE  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  privilege and R (read) and W (write) 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 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 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 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 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 AVERAGE
         Job AVERAGE (queue SYS$BATCH, entry 112) pending

  The SUBMIT command enters the procedure AVERAGE.COM in the batch job
  queue.   When  the  batch job completes, the log file AVERAGE.LOG is
  queued for printing and then deleted.

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

  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.

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

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