Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

PARAMETER

QUALIFIERS

/AFTER

/CHARACTERISTICS

/CLI

/CPUTIME

/DELETE

/HOLD

/KEEP

/LOG_FILE

/NAME

/NOTIFY

/PARAMETERS

/PRINTER

/PRIORITY

/QUEUE

/RESTART

/TRAILING_BLANKS

/WSDEFAULT

/WSEXTENT

/WSQUOTA

HELP JOB — VMS 5.5

   Identifies the beginning of a batch job submitted through a card
   reader. Each batch job submitted through the system card reader
   must be preceded by a JOB card.

   JOB cannot be abbreviated.

   Format

     $ JOB  user-name

Additional information available:

PARAMETERQUALIFIERS

PARAMETER

user-name
   Identifies the user name under which the job is to be run. Specify
   the user name as you would during the login procedure.

QUALIFIERS

Additional information available:

/AFTER/CHARACTERISTICS/CLI/CPUTIME/DELETE/HOLD
/KEEP/LOG_FILE/NAME/NOTIFY/PARAMETERS/PRINTER
/PRIORITY/QUEUE/RESTART/TRAILING_BLANKS/WSDEFAULT
/WSEXTENT/WSQUOTA

/AFTER

      /AFTER=time

   Holds the job until the specified time. If the specified time has
   already passed, the job is queued for immediate processing.

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

/CHARACTERISTICS

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

   Specifies one or more characteristics required for processing
   the job. If you specify only one characteristic, you can omit
   the parentheses. Codes for characteristics are installation
   defined. Use the SHOW QUEUE/CHARACTERISTICS command to see which
   characteristics are available on your system.

   All the characteristics specified for the job must also be
   specified for the queue that will execute the job. If not, the
   job remains pending in the queue until the queue characteristics
   are changed or the entry is deleted with the DELETE/ENTRY command.
   Users need not specify every characteristic of a queue with the
   JOB command as long as the ones they specify are a subset of
   the characteristics set for that queue. The job also runs if no
   characteristics are specified.

/CLI

      /CLI=file-name

   Specifies a different command language interpreter (CLI) with
   which to process the job. The file-name parameter specifies
   that the CLI be SYS$SYSTEM:filename.EXE. The default CLI is that
   defined in the user authorization file (UAF).

/CPUTIME

      /CPUTIME=n

   Specifies a CPU time limit for the batch job. Time can be
   specified as delta time, 0, NONE, or INFINITE. (For information on
   specifying time values, see the VMS DCL Concepts Manual.)

   When you need less CPU time than authorized, use the /CPUTIME
   qualifier to override the base queue value established by the
   system manager or the value authorized in your UAF. Specify 0 or
   INFINITE to request an infinite amount of time. Specify NONE when
   you want the CPU time to default to your UAF value or the limit
   specified on the queue. Note that you cannot request more time
   than permitted by the base queue limits or your UAF.

/DELETE

      /DELETE (default)
      /NODELETE

   Controls whether the batch input file is deleted after the job
   is processed. If you specify the /NODELETE qualifier, the file
   is saved in the user's default directory under the default name
   INPBATCH.COM. If you specify the /NAME qualifier, the file name of
   the batch input file is the same as the job name you supply with
   the /NAME qualifier.

/HOLD

      /HOLD
      /NOHOLD (default)

   Controls whether or not the job is to be made available for
   immediate processing.

   If you specify the /HOLD qualifier, the job is not released for
   processing until you specifically release it with the /NOHOLD or
   the /RELEASE qualifier of the SET QUEUE/ENTRY command.

/KEEP

      /KEEP
      /NOKEEP (default)

   Controls whether the log file is deleted after it is printed. The
   /NOKEEP qualifier is the default unless you specify the /NOPRINTER
   qualifier.

/LOG_FILE

      /LOG_FILE=filespec
      /NOLOG_FILE

   Controls whether a log file with the specified name is created for
   the job or a log file is created.

   When you use the /LOG_FILE qualifier, the system writes the
   log file to the file you specify. If you use the /NOLOG_FILE
   qualifier, no log file is created. If you specify neither form of
   the qualifier, the log file is written to a file in your default
   directory that has the same file name as the first command file in
   the job and a file type of LOG. Using neither the /LOG_FILE nor
   the /NOLOG_FILE qualifier is the default.

   You can use the /LOG_FILE qualifier to specify that the log file
   be written to a different device. Logical names that occur in
   the file specification are translated at the time the job is
   submitted. 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 and the file type
   LOG.

/NAME

      /NAME=job-name

   Specifies a string to be used as the job name and as the file
   name for both the batch job log file and the command file. The job
   name must be 1 to 39 alphanumeric characters and must be a valid
   file name. The default log file name is INPBATCH.LOG; the default
   command file name is INPBATCH.COM.

/NOTIFY

      /NOTIFY
      /NONOTIFY (default)

   Controls whether a message is broadcast to any terminal at which
   you are logged in, notifying you when your job completes or
   aborts.

/PARAMETERS

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

   Specifies 1 to 8 optional parameters that can be passed to the
   command procedure. The parameters define values to be equated to
   the symbols P1 to P8 in the batch job. The symbols are local to
   the specified command procedure.

   If you specify only one parameter, you can omit the parentheses.

   The commas (,)  delimit individual parameters. If the parameter
   contains any spaces, special characters or delimiters, or
   lowercase characters, enclose it in quotation marks (" ").
   Individual parameters cannot exceed 255 characters.

/PRINTER

      /PRINTER=queue-name
      /NOPRINTER

   Controls whether the job log file is queued to the specified queue
   for printing when the job is complete. The default print queue for
   the log file is SYS$PRINT.

   If you specify the /NOPRINTER qualifier, the /KEEP qualifier is
   assumed.

/PRIORITY

      /PRIORITY=n

   Requires OPER (operator) or ALTPRI (alter priority) privilege
   to raise the priority above the value of the SYSGEN parameter
   MAXQUEPRI.

   Specifies the job scheduling priority for the specified job. The
   value of n is an integer from 0 to 255, where 0 is the lowest
   priority and 255 is the highest.

   The default value for the /PRIORITY qualifier 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 process priority. The
   queue establishes the process priority.

/QUEUE

      /QUEUE=queue-name[:]

   Specifies the name of the batch queue in which the job is to be
   entered. If you do not specify the /QUEUE qualifier, the job is
   placed in the default system batch job queue, SYS$BATCH.

/RESTART

      /RESTART
      /NORESTART (default)

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

/TRAILING_BLANKS

      /TRAILING_BLANKS (default)
      /NOTRAILING_BLANKS

   Controls whether input cards in the card deck are read in card
   image form or input records are truncated at the last nonblank
   character. By default, the system does not remove trailing blanks
   from records read through the card reader. Use the /NOTRAILING_
   BLANKS qualifier to request that input records be truncated.

/WSDEFAULT

      /WSDEFAULT=n

   Defines a working set default for the batch job; the /WSDEFAULT
   qualifier overrides the working set size specified in the user
   authorization file (UAF). N can be any integer from 1 to 65,535,
   0, or the keyword NONE.

   Use this qualifier to impose a value lower than the base queue
   value established by the system manager or lower than the value
   authorized in your UAF. A value of 0 or the keyword NONE sets the
   default value to the value specified either in your UAF or by the
   working set quota established for the queue. You cannot request a
   value higher than your default.

/WSEXTENT

      /WSEXTENT=n

   Defines a working set extent for the batch job; the /WSEXTENT
   qualifier overrides the working set extent in the UAF. N can be
   any integer from 1 to 65,535, 0, or the keyword NONE.

   To impose a lower value, use this qualifier to override the base
   queue value established by the system manager rather than the
   value authorized in your UAF. A value of 0 or the keyword NONE
   sets the default value either to the value specified in the UAF or
   working set extent established for the queue. You cannot request a
   value higher than your default.

/WSQUOTA

      /WSQUOTA=n

   Defines the maximum working set size (working set quota) for the
   batch job; the /WSQUOTA qualifier overrides the value in the UAF.
   N can be any integer from 1 to 65,535, 0, or the keyword NONE.

   Use this qualifier to impose a value lower than the base queue
   value established by the system manager or lower than the value
   authorized in your UAF. Specify 0 or NONE if you want the working
   set quota defaulted to either your UAF value or the working set
   quota specified on the queue. You cannot request a value higher
   than your default.

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