Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

/QUEUE

Parameters

Qualifiers

/MANAGER

/ALIGN

/BACKWARD

/BASE_PRIORITY

/BATCH

/BLOCK_LIMIT

/CHARACTERISTICS

/CPUDEFAULT

/CPUMAXIMUM

/DEFAULT

/DISABLE_SWAPPING

/ENABLE_GENERIC

/FORM_MOUNTED

/FORWARD

/GENERIC

/JOB_LIMIT

/LIBRARY

/NOLIBRARY

/NEXT

/ON

/OWNER_UIC

/PROCESSOR

/PROTECTION

/RECORD_BLOCKING

/RETAIN

/SCHEDULE

/SEARCH

/SEPARATE

/TABLE

/TERMINAL

/TOP_OF_FILE

/WSDEFAULT

/WSEXTENT

/WSQUOTA

Parameters

Qualifiers

/BUFFER_COUNT

/EXTEND_QUANTITY

/NEW_VERSION

/RESTART

HELP START — MicroVMS 4.6

Additional information available:

/QUEUE

/QUEUE

Starts or restarts the specified queue after it has been initialized.
The /TOP_OF_FILE, /BACKWARD or /FORWARD, /SEARCH, and /ALIGN
qualifiers are processed in that order when more than one occurs in a
command line.

Format
 START/QUEUE queue-name

 Requires the Secure User Environment Option.

 Requires OPER privilege or execute access to the queue.

Additional information available:

ParametersQualifiers

/MANAGER

Parameters

queue-name
 Name of the queue.

Qualifiers

Additional information available:

/ALIGN/BACKWARD/BASE_PRIORITY/BATCH/BLOCK_LIMIT
/CHARACTERISTICS/CPUDEFAULT/CPUMAXIMUM/DEFAULT
/DISABLE_SWAPPING/ENABLE_GENERIC/FORM_MOUNTED/FORWARD
/GENERIC/JOB_LIMIT/LIBRARY/NOLIBRARY/NEXT
/ON/OWNER_UIC/PROCESSOR/PROTECTION
/RECORD_BLOCKING/RETAIN/SCHEDULE/SEARCH/SEPARATE
/TABLE/TERMINAL/TOP_OF_FILE/WSDEFAULT
/WSEXTENT/WSQUOTA

/ALIGN[=(option,...)]

 Prints alignment pages that enable the operator to properly align the
 forms in the printer or terminal.  Use this qualifier in restarting an
 output queue from a paused state.  Possible options are:

 +---------+------------------------------------------------+
 | MASK    | Displays alphabetic characters as x's and      |
 |         | numbers as 9's; nonalphanumeric characters     |
 |         | are not masked.  The default is not to mask.   |
 +---------+------------------------------------------------+
 | n       | Specifies the number of alignment pages to     |
 |         | print.  The value of n can be from 1 to 20;    |
 |         | the default is 1.                              |
 +---------+------------------------------------------------+

/BACKWARD=n

 Restarts a print queue n pages before the current page; n defaults
 to 1.  Use this qualifier in restarting an output queue from a paused
 state.

/BASE_PRIORITY=n

 Specifies the base process priority at which jobs are initiated from a
 batch queue. The value of n can be from 0 through 15. By default, jobs
 are initiated at the priority established by DEFPRI at system
 generation (usually 4).

/BATCH

 /NOBATCH (default)
 Specifies that the queue is a batch queue. (The queue must have been
 initialized as a batch queue.)

/BLOCK_LIMIT=([lower,]upper)

 /NOBLOCK_LIMIT (default)
 Restricts the size of print jobs that can be executed on a printer or
 terminal queue. The lower parameter specifies the minimum number of
 blocks that will be accepted by the queue for a print job. The upper
 parameter specifies the maximum number of blocks that will be accepted
 by the queue for a print job. If a job contains fewer blocks than the
 number specified by the lower parameter or more blocks than the number
 specified by the upper parameter, the job remains pending until the
 block limit for the queue is changed. To specify only the lower
 parameter, you must use two sets of quotation marks ("") in place of
 the upper specifier.

/CHARACTERISTICS=(characteristic,...)

 /NOCHARACTERISTICS (default)
 Specifies one or more characteristics for processing jobs on the
 queue. Each time you specify /CHARACTERISTIC, all previously set
 characteristics are erased. A queue must have all the characteristics
 specified for the job or the job remains pending.

/CPUDEFAULT=time

 Specifies the default CPU time limit for batch jobs. Time can be
 specified as delta time, 0, NONE, or INFINITE. Both the value 0 and
 the keyword INFINITE allow unlimited CPU time (subject to the
 restrictions imposed by the /CPUMAXIMUM qualifier or the user
 authorization file); the keyword NONE indicates that no time limit is
 needed.

/CPUMAXIMUM=time

 Specifies the maximum CPU time limit for batch jobs. The /CPUMAXIMUM
 qualifier overrides the time limit specified in the user authorization
 file (UAF). 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 specifies that no time limit is needed.

/DEFAULT=(keyword,...)

 /NODEFAULT
 Sets defaults for the following PRINT command options:

 +-----------------------+--------------------------------------------+
 | [NO]BURST[=keyword]   | Specifies where to print burst pages (flag |
 |                       | pages that are printed over the paper's    |
 |                       | perforations for easy identification of    |
 |                       | individual files in a print job.) The      |
 |                       | keyword ALL (the default) places burst     |
 |                       | pages before each printed file in the      |
 |                       | job. The keyword ONE places a burst page   |
 |                       | before the first printed file in the job.  |
 +-----------------------+--------------------------------------------+
 | [NO]FEED              | Specifies whether a form-feed is           |
 |                       | automatically inserted at the end of a     |
 |                       | page. (default)                            |
 +-----------------------+--------------------------------------------+
 | [NO]FLAG[=keyword]    | Specifies where to print flag pages        |
 |                       | (containing the job entry number, the      |
 |                       | name of the user submitting the job, and   |
 |                       | so on). The keyword ALL (the default)      |
 |                       | places flag pages before each printed      |
 |                       | file in the job. The keyword ONE places a  |
 |                       | flag page before the first printed file    |
 |                       | in the job.                                |
 +-----------------------+--------------------------------------------+
 | FORM=type             | Specifies the default form for a printer,  |
 |                       | terminal, or server queue.  If a job is    |
 |                       | not submitted with an explicit form        |
 |                       | definition, then this form will be used to |
 |                       | process the job.  The system-wide default  |
 |                       | form, form=0, is the default value for     |
 |                       | this keyword.  See also /FORM_MOUNTED.     |
 +-----------------------+--------------------------------------------+
 | [NO]TRAILER[=keyword] | Specifies where to print trailer pages.    |
 |                       | The keyword ALL (the default) places       |
 |                       | trailer pages after each printed file in   |
 |                       | the job. The keyword ONE places a trailer  |
 |                       | page after the last printed file in the    |
 |                       | job.                                       |
 +-----------------------+--------------------------------------------+

 If you specify any of the keywords BURST, FLAG, TRAILER without
 specifying a value, the value ALL is used by default.

/DISABLE_SWAPPING

 /NODISABLE_SWAPPING (default)
 Controls whether batch jobs executed from a queue can be
 swapped in and out of memory.

/ENABLE_GENERIC (default)

 /NOENABLE_GENERIC
 Allows files queued to a generic queue that does not specify explicit
 queue names in the /GENERIC qualifier to be placed in this execution queue
 for processing.

/FORM_MOUNTED=type

 Specifies the form type for a printer, terminal, or server queue.
 If the stock of the mounted form is not identical to the stock of
 the default form, as indicated by the DCL command qualifier
 /DEFAULT=FORM=type, then all jobs submitted to this queue without
 an explicit form definition will enter a pending state.  If a job
 is submitted with an explicit form and the stock of the explicit
 form is not identical to the stock of the mounted form, then the job
 will enter a pending state.  In both cases, the pending state will be
 maintained until the stock of the mounted form of the queue is
 identical to the stock of the form associated with the job.

/FORWARD=n

 Advances the specified number of pages before resuming printing the
 current file.  Use this qualifier in restarting an output queue from
 a paused state.

/GENERIC[=(queue-name,...)]

 /NOGENERIC (default)
 Specifies that the queue is generic; jobs in a generic queue are moved to
 one of the specified queues for processing.  (The /BATCH qualifier of the
 generic queue and all the specified execution queues must match.)  If you
 do not specify a queue, jobs can move to any execution queue (initialized
 without the printer, terminal, or server) as the generic queue.  (For a
 generic server queue, the /PROCESSOR qualifier of the generic queue and
 the execution queue must also match.)  By default, a generic queue is
 a print queue; use the appropriate qualifier (/BATCH, /PROCESSOR,
 /TERMINAL) to override the default.  The /GENERIC qualifier is
 incompatible with the /DEFAULT, /FORM, and /SEPARATE qualifiers.

/JOB_LIMIT=n

 Specifies the number of batch jobs that can be executed concurrently
 from the queue; the value of n defaults to 1.

/LIBRARY=file-name

/NOLIBRARY

 Specifies the file name for the device control library. (The /LIBRARY
 qualifier can be used to specify an alternate device control library
 when used to initialize an output queue.) The default library is
 SYS$LIBRARY:SYSDEVCTL.TLB. You can specify only a file name; the
 library must be in SYS$LIBRARY and the file type must be TLB.

/NEXT

 Restarts the queue with the next job. (By default, the job that was
 executing when the queue stopped resumes if it has not been deleted.)

/ON=device[:]

 Specifies the device on which this execution queue is located; the
 default device name is the same as the queue name.

/OWNER_UIC=uic

 Requires OPER privilege.
 Specifies a UIC for the queue. The default UIC is [1,4].

/PROCESSOR=(file-name)

 /NOPROCESSOR
 Used for a output queue, specifies a print symbiont image in
 SYS$SYSTEM:file-name.EXE; the default file name is PRTSMB. Used for a
 generic queue, the /PROCESSOR qualifier specifies that the generic
 queue can place jobs only on queues that have declared themselves as
 server queues and that are executing the specified symbiont image.

/PROTECTION=(ownership[:access],...)

 Requires OPER privilege.
 Applies the specified protection to the queue. The ownership
 categories are SYSTEM, OWNER, GROUP, WORLD; the access categories are
 R (read), W (write), E (create), and D (delete). The default
 protection is (SYSTEM:E, OWNER:D, GROUP:R, WORLD:W).

/RECORD_BLOCKING (default)

 /NORECORD_BLOCKING
 Determines whether the symbiont can concatenate (or block together)
 output records for transmission to the output device.  If you specify
 /NORECORD_BLOCKING, the symbiont is directed to send each formatted
 record in a separate I/O request to the output device.  For the standard
 MicroVMS print symbiont, record blocking can have a significant
 performance advantage over single-record mode.

/RETAIN[=keyword]

 /NORETAIN (default)
 Retains jobs in the queue in a completed status after they have
 executed. Possible keywords are:

 +---------+------------------------------------------------+
 | ALL     | Retains all jobs in the queue after execution  |
 |         | (default)                                      |
 +---------+------------------------------------------------+
 | ERROR   | Retains in the queue only jobs that complete   |
 |         | unsuccessfully                                 |
 +---------+------------------------------------------------+

/SCHEDULE=SIZE (default)

 /SCHEDULE=NOSIZE
 Schedules whether pending jobs in a printer or terminal queue
 are scheduled for printing based on the size of the job.  When
 the default, /SCHEDULE=SIZE, is in effect, shorter jobs will
 print before longer ones.  If you issue this command while
 there are pending jobs in the queue, the effect on future jobs
 is unpredictable.

/SEARCH="string"

 Resumes printing the current file on the first page containing the
 specified string. The string can be from 1 through 63 characters and
 must be enclosed in quotation marks.  Use this qualifier in restarting
 an output queue from a paused state.

/SEPARATE=(keyword,...)

 /NOSEPARATE (default)
 Specifies the job separation defaults for a printer or terminal queue.
 Possible keywords are:

 +-------------------+------------------------------------------------+
 | [NO]BURST         | Prints a burst page (a flag page printed over  |
 |                   | the paper's  perforations for easy             |
 |                   | identification of individual files) at the     |
 |                   | beginning  of every job.                       |
 +-------------------+------------------------------------------------+
 | [NO]FLAG          | Prints a flag page (containing the job entry   |
 |                   | number, the name  of the user submitting the   |
 |                   | job, and so on) at the beginning of every      |
 |                   | job.                                           |
 +-------------------+------------------------------------------------+
 | [NO]TRAILER       | Prints a trailer page at the end of every job. |
 +-------------------+------------------------------------------------+
 | [NO]RESET=(m,...) | Specifies a job reset sequence for the queue.  |
 |                   | The specified  module(s) from the device       |
 |                   | control library (see /LIBRARY) are used to     |
 |                   | reset  the device each time a job reset        |
 |                   | occurs.                                        |
 +-------------------+------------------------------------------------+

/TABLE=command=table

 Specifies the name of an alternate command table to be used by the
 subprocess.

/TERMINAL

 /NOTERMINAL (default)
 Associates a generic queue with terminal queues (instead of printer
 queues) of matching characteristics.

/TOP_OF_FILE

 Resumes printing at the beginning of the file that was current when
 the queue stopped.  Use this qualifier in restarting an output queue
 from a paused state.

/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 are: a positive integer in the
 range 1 through 65535, 0, or the keyword NONE (the default). A zero or
 NONE sets the default value to the value specified either in the UAF
 or by the SUBMIT command (if specified).

 When used for an output queue, this qualifier specifies the working
 set default of the symbiont process for a printer, terminal, or
 server queue when the output queue is created.

/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 are: a positive integer in the range 1 through
 65535, 0, or the keyword NONE (the default). A zero or NONE sets the
 default value to the value specified either in the UAF or by the
 SUBMIT command (if specified).

 When used for an output queue, this qualifier specifies the working
 set extent of the symbiont process for a printer, terminal, or
 server queue when the output queue is created.

/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 are: a positive integer in the range 1 through
 65535, 0, or the keyword NONE (the default). A zero or NONE set the
 default value to the value specified either in the UAF or by the
 SUBMIT command (if specified).

 When used for an output queue, this qualifier specifies the working
 set extent of the symbiont process for a printer, terminal, or
 server queue when the output queue is created.

/MANAGER

Starts the queue manager for the batch/print facility and opens the
job queue manager file.  The START/QUEUE/MANAGER command must be
executed before you can execute any other queue management or job
submission command.

Format
 START/QUEUE/MANAGER [file-spec]

 Requires the Secure User Environment Option.

 Requires both OPER and SYSNAM privilege.

Additional information available:

ParametersQualifiers

Parameters

file-spec
 The name of the file containing the queue management information. The
 default file specification is SYS$SYSTEM:JBCSYSQUE.DAT.

Qualifiers

Additional information available:

/BUFFER_COUNT/EXTEND_QUANTITY/NEW_VERSION/RESTART

/BUFFER_COUNT=n
 Specifies the number of buffers in a local buffer cache to
 allocate for performing I/O operations to the system job queue file.
 Specify n as a positive integer in the range of 1 through 127 or 0.
 If 0 is specified, the default value of n=50 is used.
/EXTEND_QUANTITY=n
 Specifies the number of blocks by which the system job queue file is
 extended (when this action is necessary).  This value is also used as the
 initial allocation size when the queue file is created.
 Specify n as a positive integer in the range of 10 through
 65535 or 0.  If 0 is specified, the default value of n=100 is used.
/NEW_VERSION
 /NONEW_VERSION (default)
 Specifies that a new version of the job queue manager file be created
 to supersede an existing version.  All jobs in the previous are lost
 if a new version is specified.
/RESTART
 /NORESTART (default)
 The /RESTART qualifier specifies that the queue manager be restarted
 automatically on recovery from a job controller abort.  In addition,
 batch and output queues are restored to the states that existed prior
 to the interruption of service.  The job queue manager file that is
 opened is the same file that was open before the abort.  Upon restarting,
 the job controller uses the default values for the /EXTEND_QUANTITY and
 /BUFFER_COUNT qualifiers.  Previously set values are lost.

 When the job controller incurrs an internal fatal error, the process
 aborts and restarts itself.  By default, the queue manager is not
 restarted.  Intervention by a user with OPERATOR privilege is necessary
 to restart the queue manager and to restore the queueing environment
 using START/QUEUE/MANAGER and appropriate START/QUEUE commands.

 Note:  In order to prevent a looping condition, the job controller will
 not restart the queue manager if it detects an error within two minutes
 of starting the queue manager.

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