SET PROCESS

From VSI OpenVMS Wiki
Jump to: navigation, search

SET PROCESS is a DCL command that changes the execution characteristics associated with the specified process or kernel thread for the current terminal session or job. If no process is specified, changes are made to the current process. SET PROCESS requires GROUP privilege to change other processes in the same UIC group. Requires WORLD privilege to change processes outside your UIC group.

Syntax

SET PROCESS process-name

Qualifiers

  • /AFFINITY allows bits in the kernel thread affinity mask to be set or cleared individually, in groups, or all at once. This qualifier is mutually exclusive with the /CAPABILITY qualifier. Alpha and Integrity only
  • /AUTO_UNSHELVE controls whether the process automatically unshelves files.
  • /CAPABILITY allows bits in the process user capability mask to be set or cleared individually, in groups, or all at once. This qualifier is mutually exclusive with the /AFFINITY qualifier.
  • /CASE_LOOKUP=keyword (keywords: BLIND (default) or SENSITIVE) determines whether or not RMS ignores case at the process level. The difference with /PARSE_STYLE is that /PARSE_STYLE preserves the case specified on the DCL command whereas /CASE_LOOKUP instructs DCL to notice or ignore the case (whether preserved or not).
  • /CLEAR clears all user capabilities or CPU affinities defined by the position values n specified by the /CAPABILITY or the /AFFINITY qualifier.
  • /DUMP causes the contents of the address space to be written to the file named (image-name).DMP in the current default directory (where the image name is the same as the file name) when an image terminates because of an unhandled error.
  • /GLOBAL Modifies the global cell SCH$GL_DEFAULT_PROCESS_CAP. This global cell is used to initialize the user capability mask of processes when they are started.
  • /IDENTIFICATION Specifies the process identification (PID) value of the kernel thread for which characteristics are to be changed. The target process must be on the same node as the process from which the command is issued. The /IDENTIFICATION qualifier overrides the process-name parameter.
  • /KERNEL_THREAD_LIMIT Changes the limit of the number of kernel threads that can be created in the process.
  • /NAME changes the name of the current process to a string of 1 to 15 characters.
  • /PARSE_STYLE=keyword (keywords: TRADITIONAL (default) and EXTENDED) tells DCL whether it should use former (prior to OpenVMS V7.2) rules for DCL syntax or the new rules allowing for ODS-5 extended filenames. In general, processes set to PARSE_STYLE=EXTENDED will preserve case and allow for special characters in file specifications.
  • /PERMANENT performs the operation on the permanent affinity or capability mask as well as the current mask, making the changes valid for the life of the kernel thread.
  • /PRIORITY 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.
  • /PRIVILEGES=privilege-list enables privileges for the specified process. Requires SETPRV privilege as an authorized privilege to enable any privilege you do not have in your authorized privilege mask.
  • /RAD=HOME=n changes the home resource affinity domain (RAD) of a process.
  • /RESOURCE_WAIT enables resource wait mode so that the process waits for resources to become available.
  • /RESUME resumes a process suspended with /SUSPEND
  • /SCHEDULING_CLASS adds a process to, or removes a process from, a scheduling class.
  • /SET sets all user capabilities or CPU affinities defined by the position values n specified by the /CAPABILITY or the /AFFINITY qualifier.
  • /SSLOG Enables or disables system service logging, using a log file (named SSLOG.DAT by default) to log data.
  • /SUSPEND causes a process to suspend all activity and go into the SUSP state until specifically resumed with /RESUME
  • /SWAPPING Permits the process to be swapped (default; /NOSWAPPING disables swapping). Requires the PSWAPM privilege to disable swapping for your process.
  • /SYMLINK=keyword controls the behavior of all directory wildcard searches performed by the RMS $SEARCH service. DCL commands (such as COPY, SUBMIT, SET FILE, and so on) internally resolve directory wildcard arguments using the RMS $SEARCH service. Keywords available:
    • NOWILDCARD indicates that symlinks are not followed during directory wildcard searches.
    • WILDCARD indicates that symlinks are followed, that is, target files are included during wildcard searches.
    • NOELLIPSIS indicates that symlinks are followed, that is, target files are included for all wildcard fields except for ellipsis.
    • ELLIPSIS equivalent to WILDCARD (included for command symmetry).
  • /TOKEN changes the maximum size of tokens (elements bounded by spaces) in a DCL command. By default, the bit is clear, indicating that traditional tokens (255 bytes) are being used. If the bit is set, extended tokens (4000 bytes) are used.
  • /UNITS=keyword (BLOCKS or BYTES) specifies whether the amount of disk space reported by certain utilities is to be displayed in blocks or bytes.