HELP START — MicroVMS 4.6
Additional information available:
/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:
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:
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.