HELP START — VMS 5.0
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. 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/DISABLE_SWAPPING/ENABLE_GENERIC/FORM_MOUNTED
/FORWARD/GENERIC/JOB_LIMIT/LIBRARY/NEXT/ON
/OWNER_UIC/PROCESSOR/PROTECTION/RECORD_BLOCKING
/RETAIN/SCHEDULE/SEARCH/SEPARATE/TERMINAL
/TOP_OF_FILE/WSDEFAULT/WSEXTENT/WSQUOTA
/ALIGN
/ALIGN[=(option[,...])]
Determines whether alignment pages are printed when the queue is
resumed. Alignment pages 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
/BACKWARD=n Printing resumes after backing up one or more pages of the current file in the current job; the default is 1. Use this qualifier in restarting an output queue from a paused state.
/BASE_PRIORITY
/BASE_PRIORITY=n Specifies the base process priority at which jobs are initiated from a batch queue or the base priority of the symbiont process for printer, terminal, or server queues. By default, if you omit the qualifier, jobs are initiated at the same priority as the base priority established by DEFPRI at system generation. The value n can be any decimal value from 0 through 15.
/BATCH
/BATCH /NOBATCH (default) Indicates that this is 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 VAX/VMS Version 4.n and may be retired in the future. The function of the /[NO]BATCH qualifier has been incorporated into the /[NO]BATCH qualifier of the INITIALIZE/QUEUE command. DIGITAL recommends that you use this command to determine queue type and that existing command procedures using START/QUEUE/[NO]BATCH be updated.
/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 will be accepted by the queue for a print job. If a print job is submitted that contains fewer blocks than the lowlim value, the job remains in a pending state until the job limit for the queue is changed, enabling the job to execute. The uplim parameter is a decimal number referring to the maximum number of blocks that will be accepted by the queue for a print job. If a print job is submitted that exceeds this value, the job remains in a pending state until the limit for the queue is changed, enabling the job to execute. 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 will execute in the queue. In order to specify only a lower job limit, you must use two sets of double quotation marks to indicate the upper specifier. For example, /BLOCK_LIMIT=(500,"") means any job with 500 or more blocks will execute 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 will not run in the queue. The /NOBLOCK_LIMIT qualifier cancels the /BLOCK_LIMIT setting previously established for that queue.
/CHARACTERISTICS
/CHARACTERISTICS=(characteristic[,...]) /NOCHARACTERISTICS Specifies one or more characteristics for processing jobs on the queue. If only one characteristic is specified, you can omit the parentheses. Each time you specify /CHARACTERISTICS, all previously set characteristics are erased. Only the characteristics specified with the qualifier are now 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. When users include the /CHARACTERISTICS qualifier with a PRINT or SUBMIT command, all the characteristics they specify must also be specified for the queue that will be executing the job. If not, the job will remain pending in the queue until the queue characteristics are changed or they delete the entry with the DELETE/ENTRY command. Users need not specify every characteristic of a queue with a PRINT or SUBMIT command as long as the ones they specify are a subset of the characteristics set for that queue. The job will also run if no characteristics are specified. 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 will accept or reject 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 and jobs already pending in the queue continue to be candidates for execution.
/CPUDEFAULT
/CPUDEFAULT=time Defines the default CPU time limit for batch jobs. Specify the CPU default time as a delta time value, the numeric value 0, or the keyword NONE or INFINITE. You can specify up to 497 days of delta time. The value 0 and the keyword INFINITE allow a job unlimited CPU time, subject to restrictions imposed by the /CPUMAXIMUM qualifier or the user authorization file. Specify NONE when a default CPU time limit is not needed. The value for time cannot exceed the CPU time limit set by the /CPUMAXIMUM qualifier. See the VMS DCL Concepts Manual for information on specifying delta times.
/CPUMAXIMUM
/CPUMAXIMUM=time Defines the maximum CPU time limit for batch jobs. Use this qualifier to override the CPU time limit specified in the user authorization file (UAF). Specify the CPU maximum time as a delta time value, the numeric value 0, or the word NONE or INFINITE. You can specify up to 497 days of delta time. The value 0 and the keyword INFINITE allow unlimited CPU time. Specify NONE when a maximum CPU time limit is not desired. See the VMS DCL Concepts Manual for information on specifying delta times. A CPU time limit for processes is specified by each user record in the system UAF. You can also specify the following: a default CPU time limit for all jobs in a given queue and a maximum CPU time limit for all jobs in a given queue. See Table 1 for information on what action is taken for each value specified and for the possible combinations of specifications.
/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. Once an option is set for
the queue by the /DEFAULT qualifier, users do not have to specify
that option in their PRINT commands.
The options are:
[NO]BURST[=keyword] Specifies whether file burst pages
will be printed. If the keyword is
ALL (the default), burst pages are
placed before each file in the print
job. If the keyword is ONE, a burst
page is placed before the first copy
of the first file in the job.
[NO]FEED Specifies whether a form-feed is
automatically inserted at the end of
a page.
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 systemwide default form, form=0,
is the default value for this
keyword. See also /FORM_MOUNTED.
[NO]FLAG[=keyword] Specifies whether file flag pages
will be printed. If the keyword is
ALL (the default), flag pages are
placed before each file in the print
job. If the keyword is ONE, a flag
page is placed before the first copy
of the first file in the job.
[NO]TRAILER[=keyword] Specifies whether file trailer pages
will be printed. If the keyword is
ALL (the default), trailer pages are
placed at the end of each file in the
print job. If the keyword is ONE, a
trailer page is placed after the last
copy of the last 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
/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 in the /GENERIC qualifier can be placed in this execution queue for processing.
/FORM_MOUNTED
/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. Specify the form type using a numeric value or a form name that has been defined by the DEFINE/FORM command. Form types are installation-specific.
/FORWARD
/FORWARD=n Printing resumes after advancing one or more pages of the the current file in the current job; the default is 1. Use this qualifier in restarting an output queue from a paused state.
/GENERIC
/GENERIC[=(queue-name[,...])] /NOGENERIC (default) Specifies that this is a generic queue and that jobs placed in it can be moved for processing to compatible execution queues. The /GENERIC qualifier optionally accepts a list of target execution queues which 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 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, printer, server, or terminal) as the generic queue. Moreover, for a generic server queue, an additional check is made: the symbiont named with the /PROCESSOR qualifier must be the same for both the generic and execution queues. The /GENERIC qualifier is used in conjunction with either the /BATCH or /DEVICE qualifiers to define the queue as a generic batch, printer, server, or terminal queue. If neither /BATCH or /DEVICE is specified on creation of a generic queue, it becomes a generic printer queue by default.
/JOB_LIMIT
/JOB_LIMIT=n Indicates the number of batch jobs that can be executed concurrently from the queue. The job limit default value for n is 1.
/LIBRARY
/LIBRARY=file-name /NOLIBRARY Specifies the file name for the device control library. When you are initializing a symbiont queue, you can use the /LIBRARY qualifier to specify an alternate device control library. The default library is SYS$LIBRARY:SYSDEVCTL.TLB. Only a file name can be used as the parameter of the /LIBRARY qualifier. The system always assumes that the location of the file is in SYS$LIBRARY and that the file type is TLB.
/NEXT
/NEXT Indicates that the current job will not resume printing when the queue is restarted. By default, the job that was executing when the queue stopped resumes printing if it has not been deleted. Use the /NEXT qualifier to abort the current job and start with the next job in the queue.
/ON
/ON=[node::]device[:] (printer, terminal, server queue) /ON=node:: (batch queue) Specifies the node and/or device on which this execution queue is located. For batch queues, only the node name can be specified. You can include both the node name and the device name for printer and terminal queues. By default, a queue executes on the same node from which you first start the queue. The default device parameter is the same as the queue name. The node name is used only in VAXcluster systems; it must match the node name specified by the SYSGEN parameter SCSNODE for the processor on which the queue executes.
/OWNER_UIC
/OWNER_UIC=uic Enables you to change the UIC of the queue. Specify the UIC using standard UIC format as described in the VMS DCL Concepts Manual. The default UIC is [1,4]. You must have OPER (operator) privilege in order to use this qualifier.
/PROCESSOR
/PROCESSOR=file-name /NOPROCESSOR Allows users to specify their own print symbionts. The file name specifier can be any valid file name. The system supplies the device and directory name SYS$SYSTEM as well as the file type EXE. If you use this qualifier for a output queue, it specifies that the symbiont image to be executed is SYS$SYSTEM:file-name.EXE. By default, SYS$SYSTEM:PRTSMB.EXE is executed. If you use this qualifier for a generic queue, it specifies that the generic queue can place jobs only on queues established as server queues and that are executing the specified symbiont image. The /NOPROCESSOR qualifier cancels the effect of a previous /PROCESSOR setting.
/PROTECTION
/PROTECTION=(codes) Specifies the protection of the queue. By default, the queue protection is (SYSTEM:E, OWNER:D, GROUP:R, WORLD:W). If you include only one protection code, you can omit the parentheses. You must have OPER (operator) privilege in order to use this qualifier.
/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 is directed to send 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 Specifies that jobs be retained in the queue in a completed status after they have executed. By default, no jobs are retained in the queue after execution. The option parameter can be the keyword ALL or ERROR. If ALL is specified, all jobs are retained in the queue after execution. If ERROR is specified, only jobs that have completed unsuccessfully are retained in the queue. If you omit the option parameter, ALL is assumed. The /NORETAIN qualifier enables you to reset the queue to the default.
/SCHEDULE
/SCHEDULE=[NO]SIZE Specifies 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, smaller jobs will be printed before longer ones. If you issue this command while there are pending jobs in any queue, its effect on future jobs is unpredictable.
/SEARCH
/SEARCH="search-string" Enables you to resume printing the current file of the current job on the first page containing the specified string. The search string parameter can have from 1 to 63 characters. Enclose the search string in quotation marks. Use this qualifier in restarting an output queue from a paused state.
/SEPARATE
/SEPARATE=(option[,...])
/NOSEPARATE
Specifies the job separation defaults for a printer or terminal
queue. The job separation options are:
[NO]BURST Specifies whether a burst page
will be printed at the beginning
of every job. Specifying BURST
also results in a flag page being
printed.
[NO]FLAG Specifies whether a flag page will
be printed at the beginning of
every job.
[NO]TRAILER Specifies whether a trailer page
will be printed at the end of
every job.
[NO]RESET=(module[,...]) Specifies a job reset sequence for
the queue. The specified modules
from the device control library
are used to reset the device each
time a job reset occurs.
/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. It is supported in this release for compatibility with VAX/VMS Version 4.n and may be retired in the future. The function of the /[NO]TERMINAL qualifier has been incorporated into the /[NO]DEVICE qualifier of the INITIALIZE/QUEUE command. DIGITAL recommends that you use this command to determine queue type and that existing command procedures using START/QUEUE/[NO]TERMINAL be updated.
/TOP_OF_FILE
/TOP_OF_FILE Resumes printing at the beginning of the file. Resumes printing the file that is the current file when the queue is in a paused state. Use this qualifier only when restarting an output queue from a paused state.
/WSDEFAULT
/WSDEFAULT=n Defines a working set default for a batch 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. A positive integer in the range 1 through 65,535, 0, or the word NONE can be specified for n. If you specify 0 or NONE, the working set default value becomes the value specified either in the UAF or by the SUBMIT command (if specified). You can also specify this qualifier for an output queue. Used in this context, it establishes the working set default of the symbiont process for a printer, terminal, or server queue when the symbiont process is created.
/WSEXTENT
/WSEXTENT=n Defines a working set extent for the batch 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. A positive integer in the range 1 through 65,535, 0, or the word NONE can be specified for n. If you specify 0 or NONE, the working set value becomes the value specified either in the UAF or by the SUBMIT command (if specified). You can also specify this qualifier for an output queue. Used in this context, it establishes the working set extent of the symbiont process for a printer, terminal, or server queue when the symbiont process is created.
/WSQUOTA
/WSQUOTA=n Defines the working set page size (working set quota) for a batch 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. Specify a positive integer in the range 1 through 65,535, 0, or the word NONE as the value for n. If 0 or NONE is specified for n, the working set quota defaults to the value specified either in the UAF or by the SUBMIT command (if specified). A working set default size and a working set quota (maximum size) are included in each user record in the system UAF and can be specified for individual jobs and/or for all jobs in a given queue. You can also specify this qualifier for an output queue. Used in this context, it establishes the working set quota of the symbiont process for a printer, terminal, or server queue when the symbiont process is created.
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
job queue manager 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 you must specify the /MANAGER qualifier.
For more information, see the Guide to Maintaining a VMS System.
Format:
START/QUEUE/MANAGER [file-spec]
Additional information available:
Parameters
file-spec Specifies the name of the file to contain information about batch and print jobs, queues, and form definitions. The file specification parameter is used in VAXcluster systems or for specifying an alternate system job queue file. 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.
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 system job queue file. Specify a positive integer in the range of 1 through 127, or 0. If 0 is specified, the default value of 50 is used.
/EXTEND_QUANTITY
/EXTEND_QUANTITY=n Specifies the number of blocks by which the system job 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 0 is specified, the default value of 100 is used.
/NEW_VERSION
/NEW_VERSION /NONEW_VERSION (default) Enables you to specify that a new version of the job queue manager file be created to supersede an existing version. The new file contains no information until you issue 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 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 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: 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.