OpenVMS DCL Dictionary

Document revision date: 19 July 1999

OpenVMS DCL Dictionary

Contents

Index

SET VOLUME

Changes the characteristics of one or more mounted Files--11 volumes. The SET VOLUME command affects only the node on which the command is issued, and will not affect any other nodes, even when a volume is mounted on multiple nodes in an OpenVMS Cluster configuration.
If you are not the owner of the volume, requires control access to the volume.

Format

SET VOLUME device-name[:][,...]

Parameter

device-name[:][,...]
Specifies the name of one or more mounted Files--11 volumes.

Qualifiers

/ACCESSED[=n]
Requires OPER (operator) privilege.
Specifies the number of directories to be maintained in system space for ready access. You can specify a value n in the range of 0 to 255. If you specify the qualifier /ACCESSED and omit the number of directories, a default value of 3 is used. If you specify a value greater than the current value, the new value is effective immediately; otherwise, the new value is not effective until the next time the volume is mounted.
/DATA_CHECK[=(option[,...])]
Defines a default for data check operations following all read and write operations to the specified volume. (If you do not specify the /DATA_CHECK qualifier, no checks are made.) Possible keywords are as follows:

READ Performs checks following all read operations.

WRITE Performs checks following all write operations (default).

/ERASE_ON_DELETE

/NOERASE_ON_DELETE (default)
Determines whether the space occupied by a file is overwritten with a system-specified pattern when a file on the volume is deleted.
/EXTENSION[=n]
Specifies the number of blocks to be used as a default extension size for all files on the volume. You can specify a value n in the range of 0 to 65,535. If you specify the /EXTENSION qualifier without specifying a value, a default value of 0 (the OpenVMS RMS default) is used.
For example, during an update operation, the extension default is used when a file increases to a size greater than its initial default allocation.
/FILE_PROTECTION=(ownership[:access][,...])
Sets the default protection to be applied to all files on the specified disk volume. Specify the ownership parameter as system (S), owner (O), group (G), or world (W) and the access parameter as read (R), write (W), execute (E), or delete (D). A null access specification means no access.

Note
This attribute is not used while the volume is in use on an OpenVMS system, but the attribute is provided to control the process use of the volume on RSX-11M systems. The OpenVMS system always uses the default file protection; the protection can be changed with the DCL command SET PROTECTION/DEFAULT.

/HIGHWATER_MARKING

/NOHIGHWATER_MARKING
Determines whether the file highwater mark (FHM) volume attribute is set. The FHM attribute guarantees that a user cannot read data that was not written by the user. Applies to Files-11 On-Disk Structure Level 2 volumes only.
/LABEL=volume-label
Specifies a 1- to 12-character ANSI name to be encoded on the volume. The specified label remains in effect until it is changed explicitly; dismounting the volume does not affect the label. Compaq strongly recommends that a volume label should consist only of alphanumeric characters, dollar signs ($), underscores (_), and hyphens (-).
If you change the volume label on an OpenVMS system disk, you should also update the POLYCENTER Software Installation utility database. To accomplish this, use the PRODUCT REGISTER VOLUME command to replace the old volume label with the new volume label.

Note
Changing the volume label does not change other structures that used the original volume label. For example, the DISK$labelname logical is not changed nor is the device-lock name that is kept internally by OpenVMS. As a result, if you attempt to access another disk that has the same volume label as the original volume of this device, you may get error messages such as the following: "%MOUNT-F-VOLALRMNT, another volume of same label already mounted".
Compaq recommends that, if you change a disk volume label, you also dismount and remount the disk on all nodes in the cluster so that the names and locks are consistent.

/LOG

/NOLOG (default)
Determines whether the volume specification of each volume is displayed after the modification.
/MOUNT_VERIFICATION

/NOMOUNT_VERIFICATION
Determines whether mount verification is enabled. Mount verification prevents interruption to user input/output operations and notifies the operator of problems with the disk.
/OWNER_UIC[=uic]
Sets the owner user identification code (UIC) of the volume to the specified UIC. The default UIC is that of the current process. Brackets ([]) are required around the UIC. Specify the UIC by using standard UIC format as described in the OpenVMS Guide to System Security.
/PROTECTION=(ownership[:access][,...])
Specifies the protection to be applied to the volume.

Specify the ownership parameter as system (S), owner (O), group (G), or world (W).
Specify the access parameter as read (R), write (W), create (C), or delete (D).

The default protection is all types of access by all categories of user.
/REBUILD[=FORCE]
Recovers caching limits for a volume that was dismounted improperly. If a disk volume was dismounted improperly (such as during a system failure), and was then remounted with the MOUNT/NOREBUILD command, you can use SET VOLUME/REBUILD to recover the caching that was in effect at the time of the dismount. The FORCE option forces the disk to be rebuilt unconditionally, thus updating the free block count in the disk volume's lock value block.
/RETENTION=(min[,max])
Specifies the minimum and maximum retention times to be used by the file system to determine the expiration date for files on the volume. When a file is created, its expiration date is set to the current time plus the maximum time. Each time the file is accessed, the current time is added to the minimum time. If the sum is greater than the expiration date, a new expiration date is computed.
If you omit the maximum value, a default value that is the smaller of (2 x min) or (min + 7) days is used. For example, /RETENTION=3- is the same as /RETENTION=(3-,6-), while /RETENTION=10- is the same as /RETENTION=(10-,17-).
The command SET VOLUME/RETENTION=0 disables retention times on the volume.
/STRUCTURE_LEVEL=n
Sets the structure level of the volume. Use the value 5 to set the volume to ODS-5.
When the /STRUCTURE_LEVEL qualifier is used with other qualifiers, the volume structure level is set prior to the other qualifiers being performed.
You cannot use the SET VOLUME command to change a volume from ODS-5 to ODS-2. To reset a volume to ODS-2, refer to instructions in the OpenVMS Guide to Extended File Specifications.

Note
Compaq does not support creating the system disk as (or changing it to) an ODS-5 volume.

Refer to the OpenVMS Guide to Extended File Specifications for further information.
/SUBSYSTEM

/NOSUBSYSTEM
Enables the processing of subsystem ACEs. Requires the SECURITY privilege. By default, the disk from which you boot has protected subsystems enabled but other disks do not. For further details on subsystems, refer to the OpenVMS Guide to System Security.
/UNLOAD (default)

/NOUNLOAD
Specifies whether the volume is unloaded (spun down) when the DCL command DISMOUNT is entered.
/USER_NAME[=user-name]
Specifies a user name of up to 12 alphanumeric characters to be recorded on the volume. The default name is the current process user name.
/WINDOWS[=n]
Specifies the number of mapping pointers to be allocated for file windows. The value of n can be from 7 to 80; the default value is 7.

Examples

#1
$ SET VOLUME/DATA_CHECK=(READ,WRITE) DBC5

The SET VOLUME command in this example requests that data checks be performed following all read and write operations to DBC5.

#2
$ SET VOLUME/FILE_PROTECTION=(S:RWED,O:RWED,G:RE,W:RE) DBC5

The SET VOLUME command in this example sets the default protection to be applied to all files created on volume DBC5. System (S) and owner (O) are granted all types of access; group (G) and world (W) are permitted only to read and execute files on DBC5.

#3
$ SET VOLUME/LABEL=LICENSES DBC5

The SET VOLUME command in this example encodes the label LICENSES on the volume DBC5. Note that if characters in labels are entered in lowercase, they are changed to uppercase by the /LABEL qualifier.

#4
$ SET VOLUME/ACCESSED=25/USER_NAME=MANAGER/LOG DBA0:

The SET VOLUME command in this example specifies that 25 directories are to be maintained in system space for ready access for the volume DBA0. The command also assigns the user name MANAGER to the volume and displays the volume specification after the volume is modified.

#5
$ SET VOLUME/REBUILD/LOG NODE$DBA2: %SET-I-MODIFIED, _NODE$DBA2: modified

The SET VOLUME command in this example causes a rebuild operation to begin on the volume that is mounted on NODE$DBA2. The /LOG qualifier directs the SET VOLUME command to display a notification message.

SET WORKING_SET

Redefines the default working set size for the process, or sets an upper limit to which the working set size can be changed by an image that the process executes. Working set limits cannot be set to exceed those defined in the user authorization file (UAF).
Specify the value of n as a number of 512-byte pagelets on Alpha or 512-byte pages on VAX. Note that the OpenVMS system rounds up this value to the nearest CPU-specific page so that actual amount of physical memory allowed may be larger than the specified amount on Alpha.

Format

SET WORKING_SET

Parameters

None.

Description

The SET WORKING_SET command enables the user to change the working set size within the authorized limits. A process's working set is the collection of physical pages to which an executing image can refer. Each user is assigned a default working set size to be associated with the process created during login. The maximum size to which any process can increase its working set is defined in the user authorization file (UAF).

Qualifiers

/ADJUST (default)

/NOADJUST
Controls whether the system can automatically adjust the size of the process working set.
/EXTENT=n
Specifies the maximum number of physical pages that can be resident in the working set during image execution.
The extent value must be greater than the minimum working set defined at system generation, and it must be less than or equal to the authorized extent defined in the UAF.
If you specify a value greater than the authorized extent, the command sets the working set limit at the maximum authorized value.
/LIMIT=n
Specifies the size to which the working set is to be reduced at image exit.
If you specify a value greater than the current quota, the quota value is also increased.
/LOG

/NOLOG (default)
Determines whether confirmation of the SET WORKING_SET command is displayed.
/QUOTA=n
Specifies the maximum number of physical pages that any image executing in the process context can request. An image can set the working set size for the process by calling the $ADJWSL (Adjust Working Set Limit) system service.
If you specify a quota value that is greater than the authorized quota, the working set quota is set to the authorized quota value.

Examples

#1
$ SHOW WORKING_SET Working Set /Limit= 150 /Quota= 700 /Extent= 700 Adjustment enabled Authorized Quota= 700 Authorized Extent= 700 $ SET WORKING_SET/QUOTA=1000 %SET-I-NEWLIMS, new working set: Limit = 150 Quota = 700 Extent = 700

$ SHOW WORKING_SET
 Working Set      /Limit=  150  /Quota=  700            /Extent= 700
 Adjustment enabled    Authorized Quota=  700  Authorized Extent= 700
$ SET WORKING_SET/QUOTA=1000
%SET-I-NEWLIMS, new working set: Limit = 150 Quota = 700 Extent = 700

The SHOW WORKING_SET command in this example displays the current limit, quota, and extent, as well as the authorized quota and authorized extent. The SET WORKING_SET command attempts to set a quota limiting the maximum number of pages any image can request that is greater than the authorized quota. Note from the response that the quota was not increased.

#2
$ SHOW WORKING_SET Working Set /Limit= 150 /Quota= 350 /Extent= 350 Adjustment enabled Authorized Quota= 350 Authorized Extent= 350 $ SET WORKING_SET/LIMIT=100 %SET-I-NEWLIMS, new working set: Limit = 100 Quota = 350 Extent = 350 $ SHOW WORKING_SET Working Set /Limit= 100 /Quota= 350 /Extent= 350 Adjustment enabled Authorized Quota= 350 Authorized Extent= 350

$ SHOW WORKING_SET
 Working Set      /Limit=  150  /Quota=  350            /Extent= 350
 Adjustment enabled    Authorized Quota=  350  Authorized Extent= 350
$ SET WORKING_SET/LIMIT=100
%SET-I-NEWLIMS, new working set: Limit = 100 Quota = 350 Extent = 350
$ SHOW WORKING_SET
 Working Set      /Limit=  100  /Quota=  350            /Extent= 350
 Adjustment enabled    Authorized Quota=  350  Authorized Extent= 350

The SET WORKING_SET command in this example sets the working set size for any image in the process to 100.

SHOW

Displays information about the current status of a process, the system, or devices in the system.

Format

SHOW option

Description

The SHOW command options are described individually in this manual. Table DCLII-22 lists all the SHOW command options.

Table DCLII-22 SHOW Command Options
Option Displays

ACCOUNTING Resources the current accounting file is tracking

AUDIT Security auditing characteristics in effect on the system

BROADCAST Message classes for which broadcast is enabled

CLUSTER OpenVMS Cluster activity and performance

CPU Current state of the attached processor

DEFAULT Current default device and directory

DEVICES Status of devices in the system

DEVICE/SERVED Status of devices served by the MSCP server on an OpenVMS Cluster system

DISPLAY Node where the output from a DECwindows application running on the current node will be displayed

ENTRY Information about a user's batch and print jobs or about specific job entries

ERROR Error count for the CPU, memory, and physical devices

INTRUSION Contents of the intrusion database

KEY Key definitions created by the DEFINE/KEY command

LICENSE Software product licenses active on the current node as well as list of the names attached to a license (known as the RESERVE list)

LOGICAL Current logical name assignments

MEMORY Availability and usage of memory resources

NETWORK Information about network services registered on a node

PRINTER Printer characteristics

PROCESS Attributes of the current process, including privileges, resource quotas, memory usage, priority, and accounting information

PROTECTION Current default protection applied to files

QUEUE Names and types of queues that are available on the system as well as any current jobs belonging to your process

QUEUE/CHARACTERISTICS Characteristic names and numbers that have been defined for system queues

QUEUE/FORM Form names and numbers that have been defined for system queues

QUEUE/MANAGERS Information about the queue manager(s) on the system or OpenVMS Cluster

QUOTA Current disk quota authorized for and used by a specific user on a specific disk

RMS_DEFAULT Current default multiblock and multibuffer counts used by OpenVMS Record Management Services (RMS) for file operations

SECURITY Name, class, and profile of a security object

STATUS Status of the current job, including accumulated CPU time, open file count, and count of I/O operations

SYMBOL Current symbol definitions

SYSTEM List of all processes in the system

TERMINAL Device characteristics of a terminal

[DAY]TIME Current date and time

TRANSLATION Current logical name assignment

USERS Information about users currently on the system

WORKING_SET CURRENT working set size limit and quota

ZONE Current state of a VAXft system

**Table DCLII-22 SHOW Command Options**
Option	Displays
ACCOUNTING	Resources the current accounting file is tracking
AUDIT	Security auditing characteristics in effect on the system
BROADCAST	Message classes for which broadcast is enabled
CLUSTER	OpenVMS Cluster activity and performance
CPU	Current state of the attached processor
DEFAULT	Current default device and directory
DEVICES	Status of devices in the system
DEVICE/SERVED	Status of devices served by the MSCP server on an OpenVMS Cluster system
DISPLAY	Node where the output from a DECwindows application running on the current node will be displayed
ENTRY	Information about a user's batch and print jobs or about specific job entries
ERROR	Error count for the CPU, memory, and physical devices
INTRUSION	Contents of the intrusion database
KEY	Key definitions created by the DEFINE/KEY command
LICENSE	Software product licenses active on the current node as well as list of the names attached to a license (known as the RESERVE list)
LOGICAL	Current logical name assignments
MEMORY	Availability and usage of memory resources
NETWORK	Information about network services registered on a node
PRINTER	Printer characteristics
PROCESS	Attributes of the current process, including privileges, resource quotas, memory usage, priority, and accounting information
PROTECTION	Current default protection applied to files
QUEUE	Names and types of queues that are available on the system as well as any current jobs belonging to your process
QUEUE/CHARACTERISTICS	Characteristic names and numbers that have been defined for system queues
QUEUE/FORM	Form names and numbers that have been defined for system queues
QUEUE/MANAGERS	Information about the queue manager(s) on the system or OpenVMS Cluster
QUOTA	Current disk quota authorized for and used by a specific user on a specific disk
RMS_DEFAULT	Current default multiblock and multibuffer counts used by OpenVMS Record Management Services (RMS) for file operations
SECURITY	Name, class, and profile of a security object
STATUS	Status of the current job, including accumulated CPU time, open file count, and count of I/O operations
SYMBOL	Current symbol definitions
SYSTEM	List of all processes in the system
TERMINAL	Device characteristics of a terminal
[DAY]TIME	Current date and time
TRANSLATION	Current logical name assignment
USERS	Information about users currently on the system
WORKING_SET	CURRENT working set size limit and quota
ZONE	Current state of a VAXft system

SHOW ACCOUNTING

Shows what resources the current accounting file is tracking.

Format

SHOW ACCOUNTING

Parameters

None.

Description

Each node on your system has its own current accounting file. You can see what resources this file is tracking using the SHOW ACCOUNTING command.
There are two occasions when the resources used by a process are not tracked, despite the output of the SHOW ACCOUNTING command:

When you use the RUN (Process) command with the /NOACCOUNTING qualifier.
When you use the $CREPRC system service with the PRC$M_NOACNT status flag.

Similarly, there is one occasion when the resources used by an image are always tracked, despite the output of the SHOW ACCOUNTING command:

When you install an image using the /ACCOUNTING qualifier of the Install utility.

The SHOW ACCOUNTING command produces a screen display (see the Example). The keywords in the display (in upper case) fall into two categories:

Keywords that show which types of resource are being tracked:

Keyword Type of Resource

IMAGE Resources used by an image

LOGIN_FAILURE Resources used by an unsuccessful attempt to log in

MESSAGE (Unformatted resource record written to the accounting file by a call to the $SNDJBC system service)

PRINT Resources used by a print job

PROCESS Resources used by a process

Keywords that show which types of process are being tracked. When the resources for processes or images are tracked, these keywords show the process type:

Keyword Type of Process

BATCH Batch process

DETACHED Detached process

INTERACTIVE Interactive process

NETWORK Network process

SUBPROCESS Subprocess (the parent process can be a batch, detached, interactive, or network process)

Keyword	Type of Resource
IMAGE	Resources used by an image
LOGIN_FAILURE	Resources used by an unsuccessful attempt to log in
MESSAGE	(Unformatted resource record written to the accounting file by a call to the $SNDJBC system service)
PRINT	Resources used by a print job
PROCESS	Resources used by a process

Keyword	Type of Process
BATCH	Batch process
DETACHED	Detached process
INTERACTIVE	Interactive process
NETWORK	Network process
SUBPROCESS	Subprocess (the parent process can be a batch, detached, interactive, or network process)

Qualifier

/OUTPUT[=filespec]
Requires read (R) and write (W) access to the directory in which the specified file is created.
Controls the output destination of the command. By default, the output is the current SYS$OUTPUT device. To send the output to a file, use the /OUTPUT qualifier followed by the file specification.
If the file specification does not include the file name or file type, the defaults .SHOW and .LIS are used respectively.

Example


$ SHOW ACCOUNTING Accounting is currently enabled to log the following activities: PROCESS any process termination IMAGE image execution INTERACTIVE interactive job termination LOGIN_FAILURE login failures NETWORK network job termination PRINT all print jobs

$ SHOW ACCOUNTING
 
Accounting is currently enabled to log the following activities: 
 
      PROCESS        any process termination 
      IMAGE          image execution 
      INTERACTIVE    interactive job termination 
      LOGIN_FAILURE  login failures 
      NETWORK        network job termination 
      PRINT          all print jobs

The keywords in this example show that the local node is tracking the resources used by each:

Interactive and network process
Image running in an interactive or network process
Login failure
Print job

Contents

Index

privacy and legal statement

9996PRO_061.HTML

READ	Performs checks following all read operations.
WRITE	Performs checks following all write operations (default).