HELP START — VMS 5.2
o Starts the specified secondary processor or processors in a VMS
multiprocessing system. See START/CPU.
o Starts or restarts the specified queue. See START/QUEUE.
Additional information available:
/CPU
Starts the specified secondary processor or processors in a VMS
multiprocessing system. The /CPU qualifier is required.
Requires CMKRNL privilege.
Format:
START/CPU [cpu-id,...]
Additional information available:
Parameter
cpu-id Decimal value representing the identity of a processor in a multiprocessing system. In a VAX 8300 system, for instance, the cpu-id is the VAXBI node number of the processor; in a VAX 8800, the cpu-id of the left processor is 1 and that of the right processor is 0. If you do not specify a cpu-id and do not include the /ALL qualifier, the START/CPU command selects a single available processor to join the multiprocessing system.
Qualifier
Additional information available:
/ALL
/ALL Selects all remaining processors in the system's available set to join the multiprocessing system.
Examples
1. $ START/CPU The START/CPU command selects an inactive processor from the multiprocessing system's available set and attempts to place it in the INIT state. When it completes its initialization, the selected processor enters the RUN state as a member of the system's active set. 2. $ START/CPU 04,07 The START/CPU command selects the processors with cpu-ids 04 and 07 and attempts to place them in the INIT state. When they complete initialization, these processors enter the RUN state as members of the system's active set. 3. $ START/CPU/ALL The START/CPU/ALL command selects all inactive processors remaining in the system's available set and attempts to place them in the INIT state. When they complete initialization, these processors enter the RUN state as members of the system's active set.
/QUEUE
Starts or restarts the specified queue after it has been
initialized. You use this command to change the attributes of the
specified queue. The /QUEUE qualifier is required.
o Start the system job queue manager (see /MANAGER).
Format:
START/QUEUE queue-name[:]
Additional information available:
ParametersCommand QualifiersExamples
Parameters
queue-name[:] Specifies the name of the queue to be started or restarted.
Command Qualifiers
Additional information available:
/ALIGN/BACKWARD/BASE_PRIORITY/BATCH/BLOCK_LIMIT
/CHARACTERISTICS/CLOSE/CPUDEFAULT/CPUMAXIMUM
/DEFAULT/DESCRIPTION/DISABLE_SWAPPING/ENABLE_GENERIC
/FORM_MOUNTED/FORWARD/GENERIC/JOB_LIMIT/LIBRARY
/NEXT/ON/OPEN/OWNER_UIC/PROCESSOR
/PROTECTION/RECORD_BLOCKING/RETAIN/SCHEDULE
/SEARCH/SEPARATE/TERMINAL/TOP_OF_FILE/WSDEFAULT
/WSEXTENT/WSQUOTA
/ALIGN
/ALIGN[=(option[,...])]
Prints alignment pages to aid in aligning printer forms. Use this
qualifier only when restarting an output execution queue from a
paused state.
After the alignment is complete, the queue enters a paused state
until you restart it by reentering the START/QUEUE command. Printing
resumes from the point where alignment data started; that is, the
task is backspaced over the pages printed for alignment. Possible
options are as follows:
MASK Specifies that input data are masked by replacing
alphabetic characters with x's and numbers with 9's;
nonalphanumeric characters are not masked. Mask
characters allow you to prevent the printing of
sensitive information. If you omit the MASK option, data
are printed unaltered.
n Specifies the number of alignment pages to print. The
value of n can be from 1 through 20. By default, one
page of alignment data is printed.
/BACKWARD
/BACKWARD=n Restarts a print queue n pages before the current page; n defaults to 1. If you omit the page value, printing resumes at the top of the current page. Use this qualifier only when restarting an output execution queue from a paused state.
/BASE_PRIORITY
/BASE_PRIORITY=n Specifies the base process priority at which jobs are initiated from a batch execution queue. By default, if you omit the qualifier, jobs are initiated at the same priority as the base priority established by DEFPRI at system generation (usually 4). The base priority specifier can be any decimal value from 0 through 15.
/BATCH
/BATCH /NOBATCH Specifies that you are starting or restarting a batch queue. The /NOBATCH qualifier cancels the effect of a previous /BATCH qualifier on the same command. It is supported in this release for compatibility with VMS V4.n. The /[NO]BATCH qualifier of the INITIALIZE/QUEUE command has superseded the /[NO]BATCH qualifier of the START/QUEUE command. DIGITAL recommends that you use the INITIALIZE/QUEUE/[NO]BATCH command to determine queue type. DIGITAL also recommends that you update command procedures that use START/QUEUE/[NO]BATCH.
/BLOCK_LIMIT
/BLOCK_LIMIT=([lowlim,]uplim) /NOBLOCK_LIMIT Limits the size of print jobs that can be executed on a printer or terminal queue. This qualifier allows you to reserve certain printers for certain size jobs. You must specify at least one of the parameters. The lowlim parameter is a decimal number referring to the minimum number of blocks that are accepted by the queue for a print job. If a print job is submitted that contains fewer blocks than the the lowlim value, the job remains pending until the block limit for the queue is changed. After the block limit for the queue is decreased sufficiently, the job is processed. The uplim parameter is a decimal number referring to the maximum number of blocks that are accepted by the queue for a print job. If a print job is submitted that exceeds this value, the job remains pending until the block limit for the queue is changed. After the block limit for the queue is increased sufficiently, the job is processed. If you specify only an upper limit for jobs, you can omit the parentheses. For example, /BLOCK_LIMIT=1000 means that only jobs with 1000 blocks or less are processed in the queue. To specify only a lower job limit, you must use two double quotation marks to indicate the upper specifier. For example, /BLOCK_LIMIT=(500,"") means any job with 500 or more blocks is processed in the queue. You can specify both a lower and upper limit. For example, /BLOCK_ LIMIT=(200,2000) means that jobs with less than 200 blocks or more than 2000 blocks are not processed in the queue. The /NOBLOCK_LIMIT qualifier cancels the previous /BLOCK_LIMIT setting for that queue.
/CHARACTERISTICS
/CHARACTERISTICS=(characteristic[,...]) /NOCHARACTERISTICS Specifies one or more characteristics for processing jobs on an execution queue. If a queue does not have all the characteristics that have been specified for a job, the job remains pending. If you specify only one characteristic, you can omit the parentheses. Each time you specify /CHARACTERISTICS, all previously set characteristics are cancelled. Only the characteristics specified with the qualifier are established for the queue. Queue characteristics are installation-specific. The characteristic parameter can be either a value from 0 through 127 or a characteristic name that has been defined by the DEFINE /CHARACTERISTIC command. The /NOCHARACTERISTICS qualifier cancels any /CHARACTERISTICS settings previously established for that queue.
/CLOSE
/CLOSE Prevents jobs from being entered in the queue through PRINT or SUBMIT commands or as a result of requeue operations. To allow jobs to be entered, use the /OPEN qualifier. Whether a queue accepts or rejects new job entries is independent of the queue's state (such as paused, stopped, stalled). When a queue is marked closed, jobs executing continue to execute. Jobs already pending in the queue continue to be candidates for execution.
/CPUDEFAULT
/CPUDEFAULT=time Defines the default CPU time limit for jobs in this batch execution queue. You can specify time as delta time, 0, INFINITE, or NONE. You can specify up to 497 days of delta time. If the queue does not have a specified CPUMAXIMUM time limit and the value established in the user authorization file (UAF) has a specified CPU time limit of NONE, either the value 0 or the keyword INFINITE allows unlimited CPU time. If you specify NONE, the CPU time value defaults to the value specified either in the UAF or by the SUBMIT command (if included). CPU time values must be greater than or equal to the number specified by the SYSGEN parameter PQL_MCPULM. For information on specifying delta times, see the VMS DCL Concepts Manual.
/CPUMAXIMUM
/CPUMAXIMUM=time Defines the default CPU time limit for all jobs in this batch execution queue. You can specify time as delta time, 0, INFINITE, or NONE. You can specify up to 497 days of delta time. If the queue does not have a specified CPUMAXIMUM time limit and the value established in the user authorization file (UAF) has a specified CPU time limit of NONE, either the value 0 or the keyword INFINITE allows unlimited CPU time. If you specify NONE, the CPU time value defaults to the value specified either in the UAF or by the SUBMIT command (if included). CPU time values must be greater than or equal to the number specified by the SYSGEN parameter PQL_MCPULM. The time cannot exceed the CPU time limit set by the /CPUMAXIMUM qualifier. For information on specifying delta time, see the VMS DCL Concepts Manual.
/DEFAULT
/DEFAULT=(option[,...])
/NODEFAULT
Establishes defaults for certain options of the PRINT command.
Defaults are specified by the list of options. If you specify only
one option, you can omit the parentheses. After you set an option
for the queue with the /DEFAULT qualifier, you do not have to
specify that option in your PRINT commands. If you do specify these
options in your PRINT command, the values specified with the PRINT
command override the values established for the queue with the
/DEFAULT qualifier.
You cannot use the /DEFAULT qualifier with the /GENERIC qualifier.
Possible options are as follows:
[NO]BURST[=keyword] Controls whether two file flag pages with a
burst bar between them are printed
preceding output. If you specify the value
ALL (default), these flag pages are printed
before each file in the job. If you specify
the value ONE, these flag pages are printed
once before the first file in the job.
[NO]FEED Specifies whether a form-feed is inserted
automatically at the end of a page.
[NO]FLAG[=keyword] Controls whether a file flag page is
printed preceding output. If you specify
the value ALL (default), a flag page is
printed before each file in the job. If you
specify the value ONE, a flag page is
printed once before the first file in the
job.
FORM=type Specifies the default form for an output
execution queue. If a job is submitted
without an explicit form definition, this
form is used to process the job. See also
/FORM_MOUNTED.
[NO]TRAILER[=keyword] Controls whether a file trailer page is
printed following output. If you specify
the value ALL (default), a trailer page is
printed after each file in the job. If you
specify the value ONE, a trailer page is
printed once after the last file in the
job.
When you specify the BURST option for a file, the [NO]FLAG option
does not add or subtract a flag page from the two flag pages that
are printed preceding the file.
For information on establishing mandatory queue attributes, see the
description of the /SEPARATE qualiifer. For information on
specifying default queue attributes, see the Guide to Maintaining a
VMS System. You cannot use the /DEFAULT qualifier with the /GENERIC
qualifier.
/DESCRIPTION
/DESCRIPTION=string
/NODESCRIPTION
A string of up to 255 characters used to provide operator-supplied
information about the queue.
Enclose strings containing lowercase letters, blanks, or other
nonalphanumeric characters (including spaces) in quotation marks
("").
The /NODESCRIPTION qualifier removes any descriptive text that may
be associated with the queue.
/DISABLE_SWAPPING
/DISABLE_SWAPPING /NODISABLE_SWAPPING (default) Controls whether batch jobs executed from a queue can be swapped in and out of memory.
/ENABLE_GENERIC
/ENABLE_GENERIC (default) /NOENABLE_GENERIC Specifies whether files queued to a generic queue that does not specify explicit queue names with the /GENERIC qualifier can be placed in this execution queue for processing. For more information, see the description of the /GENERIC qualifier.
/FORM_MOUNTED
/FORM_MOUNTED=type Specifies the mounted form for an output execution queue. If the stock of the mounted form does not match the stock of the default form, as indicated by the qualifier /DEFAULT=FORM, all jobs submitted to this queue without an explicit form definition enter a pending state. If a job is submitted with an explicit form and the stock of the explicit form does not match the stock of the mounted form, the job enters a pending state. In both cases, the jobs remain pending state until the stock of the mounted form of the queue matches the stock of the form associated with the job. To specify the form type, use either a numeric value or a form name that has been defined by the DEFINE/FORM command. Form types are installation-specific. You cannot use the /FORM_MOUNTED qualifier with the /GENERIC qualifier.
/FORWARD
/FORWARD=n Advances the specified number of pages before resuming printing the current file in the current job; the default is 1. If you omit the page value, printing resumes at the top of the next page. Use this qualifier only when restarting an output execution queue from a paused state.
/GENERIC
/GENERIC[=(queue-name[,...])] /NOGENERIC (default) Specifies a generic queue. Also specifies that jobs placed in this queue can be moved for processing to compatible execution queues. The /GENERIC qualifier optionally accepts a list of target execution queues that have been previously defined. For a generic batch queue, these target queues must be batch execution queues. For a generic output queue, these target queues must be output execution queues, but can be of any type (printer, server, or terminal). For example, a generic printer queue can feed a mixture of printer and terminal execution queues. If you do not specify any target execution queues with the /GENERIC qualifier, jobs can be moved to any execution queue that (1) is initialized with the /ENABLE_GENERIC qualifier, and (2) is the same type (batch or output) as the generic queue. To define the queue as a generic batch or output queue, you use the /GENERIC qualifier with either the /BATCH or /DEVICE qualifier. If you specify neither /BATCH nor /DEVICE on creation of a generic queue, by default the queue becomes a generic printer queue.
/JOB_LIMIT
/JOB_LIMIT=n Specifies the number of batch jobs that can be executed concurrently from the queue. Specify a number in the range 0 through 255.
/LIBRARY
/LIBRARY=file-name /NOLIBRARY Specifies the file name for the device control library. When you initialize an output execution queue, you can use the /LIBRARY qualifier to specify an alternate device control library. You can use only a file name as the parameter of the /LIBRARY qualifier. The system always assumes that the file is located in SYS$LIBRARY and that the file type is TLB.
/NEXT
/NEXT Aborts the currently suspended print job and begins processing of the first pending job in the queue. Use this qualifier only when restarting an output execution queue from a paused state.
/ON
/ON=[node::]device[:] (printer, terminal, server queue) /ON=node:: (batch queue) Specifies the node or device, or both, on which this execution queue is located. For batch execution queues, you can specify only the node name. For output execution queues, you can include both the node name and the device name. The node name is used only in VAXcluster systems; it must match the node name specified by the SYSGEN parameter SCSNODE for the VAX computer on which the queue executes.
/OPEN
/OPEN Allows jobs to be entered in the queue through PRINT or SUBMIT commands or as the result of requeue operations. To prevent jobs from being entered in the queue, use the /CLOSE qualifier. Whether a queue accepts or rejects new job entries is independent of the queue's state (such as paused, stopped, stalled).
/OWNER_UIC
/OWNER_UIC=uic Requires OPER privilege or CONTROL and EXECUTE access to the queue. Enables you to change the user identification code (UIC) of the queue. Specify the UIC using standard format as described in the VMS DCL Concepts Manual.
/PROCESSOR
/PROCESSOR=filename /NOPROCESSOR Allows you to specify your own print symbiont for an output execution queue. You can use any valid file name as a parameter of the /PROCESSOR qualifier. The system supplies the device and directory name SYS$SYSTEM and the file type EXE. If you use this qualifier for an output queue, it specifies that the symbiont image to be executed is SYS$SYSTEM:filename.EXE. By default, SYS$SYSTEM:PRTSMB.EXE is the symbiont image associated with an output execution queue. The /NOPROCESSOR qualifier cancels any previous /PROCESSOR setting and causes SYS$SYSTEM:PRTSMB.EXE to be used.
/PROTECTION
/PROTECTION=(ownership[:access],...) Requires OPER privilege or CONTROL and EXECUTE access to the queue. Specifies the protection of the queue. Ownership categories are SYSTEM, OWNER, GROUP, WORLD; each category can be abbreviated to its first character. Access categories are R (READ), W (WRITE), E (EXECUTE), and D (DELETE); a null access specification means no access. If you include only one protection code, you can omit the parentheses. For more information on specifying protection codes, see the VMS DCL Concepts Manual. For more information on controlling queue operations through UIC-based protection, see the Guide to Maintaining a VMS System.
/RECORD_BLOCKING
/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 sends each formatted record in a separate I/O request to the output device. For the standard VMS print symbiont, record blocking can have a significant performance advantage over single-record mode.
/RETAIN
/RETAIN[=option] /NORETAIN Holds jobs in the queue in a retained status after they have executed. The /NORETAIN qualifier enables you to reset the queue to the default. Possible options are as follows: ALL Holds all jobs in the queue after execution ERROR Holds in the queue only jobs that complete unsuccessfully
/SCHEDULE
/SCHEDULE=[NO]SIZE Specifies whether pending jobs in an output queue are scheduled for printing based on the size of the job. When the /SCHEDULE=SIZE qualifier is in effect, shorter jobs are printed before longer ones. When /SCHEDULE=NOSIZE is in effect, jobs are printed in the order they were submitted, regardless of size. If you enter this command while there are pending jobs in any queue, its effect on future jobs is unpredictable.
/SEARCH
/SEARCH="search-string" Specifies that printing is to resume at the page containing the specified string. The search for the string moves forward, beginning on the page following the current page. During the search, consecutive tabs and spaces are treated as a single space, and character case is ignored. The string can be from 1 through 63 characters and must be enclosed in quotation marks. Use this qualifier only when restarting an output execution queue from a paused state.
/SEPARATE
/SEPARATE=(option[,...])
/NOSEPARATE
Specifies the mandatory queue attributes, or job separation options,
for an output execution queue. Job separation options cannot be
overridden by the PRINT command.
You cannot use the /SEPARATE qualifier with the /GENERIC qualifier.
The job separation options are as follows:
[NO]BURST Specifies whether two job flag pages with
a burst bar between them are printed at
the beginning of each job.
[NO]FLAG Specifies whether a job flag page is
printed at the beginning of each job.
[NO]TRAILER Specifies whether a job trailer page is
printed at the end of each job.
[NO]RESET=(module[,...]) Specifies one or more device control
library modules that contain the job reset
sequence for the queue. The specified
modules from the queue's device control
library (by default SYS$LIBRARY:SYSDEVCTL)
are used to reset the device each time a
job reset occurs. The RESET sequence
occurs after any file trailer and before
any job trailer. Thus, all job separation
pages are printed when the device is in
its RESET state.
When you specify /SEPARATE=BURST, the [NO]FLAG separation option
does not add or subtract a flag page from the two flag pages that
are printed preceding the job.
For information on establishing queue attributes that can be
overridden, see the description of the /DEFAULT qualifier.
For more information on specifying mandatory queue attributes, see
the Guide to Maintaining a VMS System.
/TERMINAL
/TERMINAL /NOTERMINAL Indicates that the output queue is a terminal queue. The /NOTERMINAL qualifier cancels the effect of a previous /TERMINAL qualifier on the same command. The /[NO]DEVICE qualifier of the INITIALIZE/QUEUE command has superseded the /[NO]TERMINAL qualifier. DIGITAL recommends that you use the INITIALIZE/QUEUE command to determine queue type. DIGITAL also recommends that you use this qualifier to update command procedures that use START/QUEUE/[NO]TERMINAL.
/TOP_OF_FILE
/TOP_OF_FILE Resumes printing at the beginning of the file that was current when the output execution queue paused. Use this qualifier only when restarting an output execution queue from a paused state.
/WSDEFAULT
/WSDEFAULT=n Defines for a batch job a working set default, the default number of physical pages that the job can use. The value set by this qualifier overrides the value defined in the user authorization file (UAF) of any user submitting a job to the queue. You also can specify this qualifier for an output execution queue. Used in this context, /WSDEFAULT establishes the working set default of the symbiont process for an execution queue when the symbiont process is created. If you specify 0 or NONE, the working set default value defaults to the value specified in the UAF or by the SUBMIT command (if included).
/WSEXTENT
/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. The value set by this qualifier overrides the value defined in the user authorization file (UAF) of any user submitting a job to the queue. You also can specify this qualifier for an output execution queue. Used in this context, /WSEXTENT establishes the working set extent of the symbiont process for an output execution queue when the symbiont process is created. If you specify 0 or NONE, the working set default value defaults to the value specified in the UAF or by the SUBMIT command (if included). A working set default size and a working set quota (maximum size) are included in each user record in the system user authorization file (UAF). You can specify a working set default and a working set quota for individual jobs or for all jobs in a given queue.
/WSQUOTA
/WSQUOTA=n Defines for a batch job a working set quota, the amount of physical memory that is guaranteed to the job. The value set by this qualifier overrides the value defined in the user authorization file (UAF) of any user submitting a job to the queue. You also can specify this qualifier for an output execution queue. Used in this context, /WSQUOTA establishes the working set quota of the symbiont process for an output execution queue when the symbiont process is created. If you specify 0 or NONE, the working set default value defaults to the value specified in the UAF or by the SUBMIT command (if included). A working set default size and a working set quota (maximum size) are included in each user record in the system user authorization file (UAF). You can specify a working set default and a working set quota for individual jobs or for all jobs in a given queue. Working set default, working set quota, and working set extent values are included in each user record in the system user authorization file (UAF). You can specify working set values for individual jobs and/or for all jobs in a given queue.
Examples
1. $ START/QUEUE/BATCH SYS$BATCH
This command starts the batch queue named SYS$BATCH. The /BATCH
qualifier indicates that this is a batch queue.
2. $ STOP/QUEUE LPA0
$ START/QUEUE/TOP_OF_FILE LPA0
The STOP/QUEUE command suspends operation of the printer queue LPA0.
Then the START/QUEUE/TOP_OF_FILE command resumes operation. The
file that was being printed when the queue was stopped is started
again from the beginning.
3. $ INITIALIZE/QUEUE LPA0
.
.
.
$ START/QUEUE/DEFAULT=FLAG LPA0
The INITIALIZE/QUEUE command initializes the queue named LPA0.
Later, the START/QUEUE command starts the queue. The /DEFAULT
qualifier requests that a flag page precede each file in each job.
4. $ START/QUEUE/DEFAULT=FORM=LN01_PORTRAIT LN01_PRINT
The START/QUEUE command restarts the the LN01_PRINT queue with the
default form LN01_PORTRAIT.
/MANAGER
Starts the queue manager for the batch/print facility and opens the
queue file. After the system is bootstrapped, you must execute this
command before you can execute any other queue management or job
submission command. The /QUEUE qualifier is optional, but the
/MANAGER qualifier is required.
For more information, see the Guide to Maintaining a VMS System.
Requires both OPER and SYSNAM privileges.
Format:
START/QUEUE/MANAGER [file-spec]
Additional information available:
Parameters
file-spec Specifies the name of the queue file. This file contains information about batch and print jobs, queues, form definitions, and characteristics. The file specification parameter is used in VAXcluster systems. The default file specification is SYS$SYSTEM:JBCSYSQUE.DAT. Any elements that you omit from the file specification default to those of SYS$SYSTEM:JBCSYSQUE.DAT. No wildcard characters are permitted in the file specification. 4 Command_Qualifiers
Additional information available:
/BUFFER_COUNT/EXTEND_QUANTITY/NEW_VERSION/RESTART
/BUFFER_COUNT
/BUFFER_COUNT=n Specifies the number of buffers in a local buffer cache to allocate for performing I/O operations to the queue file. Specify a positive integer in the range of 1 through 1500, or 0. If you specify 0, the default value of 50 is used.
/EXTEND_QUANTITY
/EXTEND_QUANTITY=n Specifies the number of blocks by which the queue file is extended, when necessary. This value is also used as the initial allocation size when the queue file is created. Specify a positive integer in the range of 10 through 65,535, or 0. If you specify 0, the default value of 100 is used.
/NEW_VERSION
/NEW_VERSION /NONEW_VERSION (default) Specifies that a new version of the queue file be created to supersede an existing version. If you specify a new version all jobs in the previous version are lost. The new queue file contains no information until you enter a subsequent INITIALIZE /QUEUE command.
/RESTART
/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 queue file that is opened is the queue 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 incurs 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 that in order to prevent a looping condition, the job controller does not restart the queue manager if it detects an error within two minutes of starting the queue manager.