The secondary qualifiers can all be used at once as long as the user capability bits defined in the /SET and /CLEAR parameters do not overlap.
The privileges required to execute the SET PROCESS/CAPABILITY command match those required by the $PROCESS_CAPABILITIES system service. ALTPRI is the base privilege required to make any modifications, and the only privilege required to modify the current owner's kernel thread. Modifications within the same UIC group require GROUP privilege. Modifications to any unrelated kernel thread require WORLD privilege.
As with the other SET PROCESS qualifiers, the bit operations occur on the current process if no /IDENTIFICATION qualifier or explicit process name parameter is specified. Specifying a process name does not imply that all kernel threads associated with the process are affected; the SET PROCESS command affects only the initial kernel thread of a multithreaded process.
You can then analyze the dump with the ANALYZE/PROCESS_DUMP utility.
Specifies the process identification (PID) value of the kernel thread for which characteristics are to be changed. The /IDENTIFICATION qualifier overrides the process-name parameter.
The PID is assigned by the system when the process is created. When you specify a PID, you can omit the leading zeros.
If you use the /IDENTIFICATION qualifier, the process-name parameter is ignored.
Note
The /IDENTIFICATION qualifier allows the SET PROCESS command to affect individual kernel thread PIDs; since each thread is a separate runnable entity, this command treats them as discrete entities in terms of affinities and capabilities.
Changes the priority for the specified kernel thread. If you do not have the ALTPRI privilege, the value you specify is compared to your current base priority, and the lower value is always used.
Enables the following process privileges:
ACNT | ALLSPOOL | ALTPRI | AUDIT |
BUGCHK | BYPASS | CMEXEC | CMKRNL |
DETACH | DIAGNOSE | DOWNGRADE | EXQUOTA |
GROUP | GRPNAM | GRPPRV | IMPORT |
LOG_IO | MOUNT | NETMBX | OPER |
PFNMAP | PHY_IO | PRMCEB | PRMGBL |
PRMMBX | PSWAPM | READALL | SECURITY |
SETPRV | SHARE | SHMEM | SYSGBL |
SYSLCK | SYSNAM | SYSPRV | TMPMBX |
UPGRADE | VOLPRO | WORLD |
Use the SHOW PROCESS/PRIVILEGES command to determine what authorized privileges are enabled currently.
Temporarily stops the process's activities. The process remains suspended until another process resumes or deletes it. Use the qualifiers /NOSUSPEND and /RESUME to resume a suspended process.
Specify either of the following keywords with the /SUSPEND qualifier to produce different results:
Keyword | Result |
---|---|
SUPERVISOR (default) | Specifies that the named process is to be suspended to allow the delivery of asynchronous system traps (ASTs) at EXEC or KERNEL mode. Specifying this keyword is optional. |
KERNEL | Specifies that the named process is to be suspended such that no ASTs can be delivered. To specify the KERNEL keyword, you must be in either KERNEL mode or EXEC mode, or have CMKRNL (change mode to kernel) and CMEXEC (change mode to executive) privilege enabled. Note that this was the default behavior of the SET PROCESS/SUSPEND command for versions of OpenVMS prior to VMS Version 5.0. |
Depending on the operation, the process from which you specify the /SUSPEND qualifier requires privileges. You must have GROUP privilege to suspend another process in the same group, unless that process has the same user identification code (UIC). You must have WORLD privilege to suspend any other process in the system.
When you enter the SET PROCESS/SUSPEND=KERNEL/ID= command in a cluster environment, the KERNEL keyword is ignored if the target process and the current process reside on different cluster nodes. As a result, process suspension is handled as if you had specified the SUPERVISOR keyword (the default).
Note that you can specify SET PROCESS/SUSPEND=KERNEL to override a previous SET PROCESS/SUSPEND=SUPERVISOR. SET PROCESS/SUSPEND=SUPERVISOR does not, however, override SET PROCESS/SUSPEND=KERNEL.
Permits the process to be swapped. By default, a process that is not currently executing can be removed from physical memory so that other processes can execute. If you specify the /NOSWAPPING qualifier, the process is not swapped out of the balance set when it is in a wait state.
#1
$ SET PROCESS/PRIVILEGE=EXQUOTA
#2The SET PROCESS command in this example assigns the current process the privilege of exceeding quotas.
$ SET PROCESS/NORESOURCE_WAIT
#3The SET PROCESS command in this example disables resource wait mode for the current process.
$ RUN/PROCESS_NAME=TESTER CALC %RUN-S-PROC_ID, identification of created process is 0005002F $ SET PROCESS/PRIORITY=10 TESTER
#4The RUN command in this example creates a subprocess and gives it the name TESTER. Subsequently, the SET PROCESS/PRIORITY command assigns the subprocess a priority of 10.
$ SHOW PROCESS/SUBPROCESS 19-APR-1994 15:17:28.41 User: DAVIS Process ID: 31900218 Node: OCALA Process name: "DAVIS" Processes in this tree: DAVIS * DAVIS_1 DAVIS_2 $ SET PROCESS/SUSPEND DAVIS_1 $
#5The SET PROCESS/SUSPEND command in this example suspends the process DAVIS_1 such that ASTs can be delivered to it. Because no keyword was specified, the /SUSPEND=SUPERVISOR version is assumed.
$ SHOW PROCESS/SUBPROCESS OCALA::CHEESE 19-APR-1994 12:17:24.45 User: CHEESE Process ID: 31400208 Node: OCALA Process name: "CHEESE" Processes in this tree: CHEESE * CHEESE_1 CHEESE_2 $ SET PROCESS OCALA::CHEESE_2 /SUSPEND=KERNEL $
#6The SET PROCESS/SUSPEND=KERNEL command in this example suspends the process CHEESE_2 on node OCALA such that no ASTs can be delivered to it.
$ SET PROCESS CPUSCHED/AFFINITY/SET=1/PERMANENT $ SET PROCESS CPUSCHED/CAPABILITY/SET=8/PERMANENT $ SHOW CPU/FULL COBRA7, a DEC 4000 Model 620 Multiprocessing is ENABLED. Streamlined synchronization image loaded. Minimum multiprocessing revision levels: CPU = 1 System Page Size = 8192 System Revision Code = System Serial Number = Default CPU Capabilities: System: QUORUM RUN Default Process Capabilities: System: QUORUM RUN PRIMARY CPU = 00 CPU 00 is in RUN state Current Process: *** None *** Serial Number: AY24870417 Revision: A200 VAX floating point operations supported. IEEE floating point operations and data types supported. Processor is Primary Eligible. PALCODE: Revision Code = 5.48 PALcode Compatibility = 0 Maximum Shared Processors = 2 Memory Space: Physical address = 00000000 00000000 Length = 0 Scratch Space: Physical address = 00000000 00000000 Length = 0 Capabilities of this CPU: System: PRIMARY QUORUM RUN User bitmask: 00000040 Processes which can only execute on this CPU: NETACP PID = 0000008E Reason: PRIMARY Capability CPU 01 is in RUN state Current Process: CPUSCHED PID = 00000095 Serial Number: AY24870406 Revision: A200 VAX floating point operations supported. IEEE floating point operations and data types supported. PALCODE: Revision Code = 5.48 PALcode Compatibility = 0 Maximum Shared Processors = 2 Memory Space: Physical address = 00000000 00000000 Length = 0 Scratch Space: Physical address = 00000000 00000000 Length = 0 Capabilities of this CPU: System: QUORUM RUN User bitmask: 00000080 Processes which can only execute on this CPU: CPUSCHED PID = 00000095 Reason: Affinitized to this CPU Reason: User capabilities - 00000080) $ SET PROCESS/NOAFFINITY/PERMANENT $ SET PROCESS/NOCAPABILITY/PERMANENT $ SHOW CPU/FULL COBRA7, a DEC 4000 Model 620 Multiprocessing is ENABLED. Streamlined synchronization image loaded. Minimum multiprocessing revision levels: CPU = 1 System Page Size = 8192 System Revision Code = System Serial Number = Default CPU Capabilities: System: QUORUM RUN Default Process Capabilities: System: QUORUM RUN CPU 00 is in RUN state Current Process: *** None *** Serial Number: AY24870417 Revision: A200 VAX floating point operations supported. IEEE floating point operations and data types supported. Processor is Primary Eligible. PALCODE: Revision Code = 5.48 PALcode Compatibility = 0 Maximum Shared Processors = 2 Memory Space: Physical address = 00000000 00000000 Length = 0 Scratch Space: Physical address = 00000000 00000000 Length = 0 Capabilities of this CPU: System: PRIMARY QUORUM RUN User bitmask: 00000040 Processes which can only execute on this CPU: NETACP PID = 0000008E Reason: PRIMARY Capability CPU 01 is in RUN state Current Process: CPUSCHED PID = 00000095 Serial Number: AY24870406 Revision: A200 VAX floating point operations supported. IEEE floating point operations and data types supported. PALCODE: Revision Code = 5.48 PALcode Compatibility = 0 Maximum Shared Processors = 2 Memory Space: Physical address = 00000000 00000000 Length = 0 Scratch Space: Physical address = 00000000 00000000 Length = 0 Capabilities of this CPU: System: QUORUM RUN User bitmask: 00000080 Processes which can only execute on this CPU: *** None ***
In this example, CPU 1 has user capability 8 enabled (user mask = 80). User capability 8 is set for the initial kernel thread of process CPUSCHED, and CPU affinity is set to 1. Either of these settings forces the initial kernel thread to run only on CPU 1, as shown by the SHOW PROCESS command.
Then, the SET PROCESS/NOAFFINITY/NOCAPABILITY command clears all CPU affinities and user capability requirements for the initial kernel thread of process (CPUSCHED), and the binding to CPU 1 disappears.
Replaces the default DCL prompt ($ ) with the specified string.
SET PROMPT [=string]
string
Specifies the new prompt string. The following rules apply:
- All valid ASCII characters can be used.
- No more than 32 characters are allowed.
- To include spaces or lowercase letters, enclose the string in quotation marks (" "). Otherwise, letters are converted automatically to uppercase; leading and trailing spaces are removed.
If you do not specify the string parameter with the SET PROMPT command, the default DCL prompt ($ ) is restored.
The SET PROMPT command customizes prompts for your main process or a subprocess.When a continued command is read from the terminal or an indirect command is read from a command procedure, DCL places an underscore in front of the prompt string.
/CARRIAGE_CONTROL (default)
/NOCARRIAGE_CONTROL
Inserts carriage return and line feed characters before the prompt string. Type the qualifier after the string parameter.
$ SET PROMPT ="What's next?" What's next? SHOW TIME 19-APR-1994 14:08:58
The SET PROMPT command in this example replaces the DCL prompt ($ ) with the phrase "What's next?". When you see the prompt on your screen, you can enter any DCL command. This example uses the SHOW TIME command.
Establishes the default protection for files created by the current process.
SET PROTECTION [=(code)]/DEFAULT
code
Specifies the SOGW protection to be assigned by default to all files subsequently created by the current process. To override this protection you must specify an explicit protection using either the SET PROTECTION command or the /PROTECTION qualifier on the CREATE command. If you do not specify a protection code, the current default remains unchanged.The code is made up of the following components:
- Ownership category---system (S), owner (O), group (G), or world (W). Each category can be abbreviated to its first character.
- Access category---Read (R), write (W), execute (E), or delete (D). The access category is assigned to each ownership category. A null access specification means no access.
Use the SET SECURITY command to reset security characteristics of the directory or file.
$ SET PROTECTION=(GROUP:RWED,WORLD:R)/DEFAULT
The SET PROTECTION/DEFAULT command in this example sets the default protection to grant unlimited access to other users in the same group and read (R) access to all users. The default protections for system and owner are not changed.
Changes the attributes of the specified queue.Requires manage (M) access to the queue.
SET QUEUE queue-name[:]
queue-name[:]
Specifies the name of an execution queue or a generic queue.
After you have created a queue with the INITIALIZE/QUEUE command, use the SET QUEUE command to change the queue's status or attributes.The defaults for the SET QUEUE qualifiers depend on the qualifiers of the queue when it was initialized. For example, the default for /JOB_LIMIT with INITIALIZE/QUEUE is 1. However, if the queue you are altering was initialized with a job limit of 3, and if you do not specify the /JOB_LIMIT qualifier with the SET QUEUE command, the job limit remains at 3 for that queue.
/BASE_PRIORITY=n
Specifies the base process priority at which jobs are initiated from a batch execution queue. The base priority specifier can be any decimal value from 0 to 15.You also can specify this qualifier for an output execution queue. In this context the /BASE_PRIORITY qualifier establishes the base priority of the symbiont process when the symbiont process is created.
/BLOCK_LIMIT=([lowlim,]uplim)
/NOBLOCK_LIMIT
Limits the size of print jobs that can be processed on an output execution 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 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 a null string ("") to indicate the upper limit. 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=(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 the /CHARACTERISTICS qualifier, all previously set characteristics are canceled. 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 to 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
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, or stalled). When a queue is marked closed, jobs executing continue to execute and jobs pending in the queue continue to be candidates for execution./CPUDEFAULT=time
Defines the default CPU time limit for jobs in a 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 defined 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 system parameter PQL_MCPULM. The time cannot exceed the CPU time limit set by the /CPUMAXIMUM qualifier. For information on specifying delta time, see the OpenVMS User's Manual or the topic SPECIFY Date_Time in online help. For more information on specifying CPU time limits, see the CPU Time Limit Specifications and Actions table for the INITIALIZE/QUEUE command.
/CPUMAXIMUM=time
Defines the maximum CPU time limit for all jobs in a batch execution queue. You can specify time as delta time, 0, INFINITE, or NONE. You can specify up to 497 days of delta time.The /CPUMAXIMUM qualifier overrides the time limit specified in the user authorization file (UAF) for any user submitting a job to the queue. 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 system parameter PQL_MCPULM.
For information on specifying delta time, see the OpenVMS User's Manual or the topic SPECIFY Date_Time in online help. For more information on specifying CPU time limits, see the CPU Time Limit Specifications and Actions table for the INITIALIZE/QUEUE command.
/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. 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 file flag page is printed before each file in the job. If you specify the value ONE, a file 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. If no form type is explicitly specified with the FORM keyword, the system assigns the form "DEFAULT" to the queue. See also the description of the /FORM_MOUNTED qualifier. [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 with each file in the job. If you specify the value ONE, a trailer page is printed once with 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 qualifier. For information on specifying default queue attributes, see the OpenVMS System Manager's Manual.
/DESCRIPTION=string
/NODESCRIPTION
Specifies 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 have been associated with the queue.
/DISABLE_SWAPPING
/NODISABLE_SWAPPING
Controls whether batch jobs executed from a queue can be swapped in and out of memory./ENABLE_GENERIC
/NOENABLE_GENERIC
Specifies whether files queued to a generic queue that does not specify explicit queue names can be placed in this execution queue for processing./FORM_MOUNTED=type
Specifies the mounted form for an output execution queue.If no form type is explicitly specified, the system assigns the form "DEFAULT" to the queue.
If the stock of the mounted form does not match the stock of the default form, as indicated by the /DEFAULT=FORM qualifier, all jobs submitted to this queue without an explicit form definition enter a pending state and remain pending until the stock of the queue's mounted form is identical to the stock of the form associated with the job.
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, the job enters a pending state and remains pending until the stock of the mounted form of the queue is identical to 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.
/JOB_LIMIT=n
Indicates the number of batch jobs that can be executed concurrently from the queue. Specify a number in the range 1 to 255./NO_INITIAL_FF
/NONO_INITIAL_FF (default)
Allows user to set or modify whether a form feed should be sent to a printer device when a queue starts. To suppress the initial form feed, set the queue with /NO_INITIAL_FF qualifier.Setting the queue with /NONO_INITIAL_FF qualifier sends a form feed to the output device before printing begins when the queue restarts.
/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, or stalled)./OWNER_UIC=uic
Requires OPER (operator) privilege or control (C) access to the queue.Enables you to change the user identification code (UIC) of the queue. Specify the UIC by using the standard format as described in the OpenVMS Guide to System Security.
/PROTECTION=(ownership[:access],...)
Requires OPER (operator) privilege to control access to the queue.
Previous | Next | Contents | [Home] | [Comments] | [Ordering info] | [Help]
![]()
9996P047.HTM OSSG Documentation 26-NOV-1996 11:18:14.65Copyright © Digital Equipment Corporation 1996. All Rights Reserved.