The SET DEFAULT command sets command qualifier, classname parameter, and classname qualifier defaults for the MONITOR command. Each SET DEFAULT command sets only the command qualifiers you specify, but replaces the entire set of classname parameters and classname qualifiers. All qualifiers and class names are identical to those for the MONITOR command.
SET DEFAULT [/qualifier[,...]] classname[,...] [/qualifier[,...]]
classname[,...]
Specifies one or more class names.
/qualifier[,...]
One or more command qualifiers as described in the Command Qualifier Descriptions section.
/qualifier[,...]
One or more classname qualifiers.
Command and classname qualifiers are identical to those for the MONITOR classname commands.
MONITOR> SET DEFAULT /INTERVAL=10 PAGE/AVERAGE+IO/MAXIMUM /NODE=(LARRY,MOE,CURLEY)
The command in this example selects PAGE and IO as the default classes for the MONITOR command and specifies an interval of 10 seconds for the statistics display. The command specifies that AVERAGE statistics be displayed for the PAGE class, and that MAXIMUM statistics be displayed for the IO class. Finally, the command requests that data be collected on nodes LARRY, MOE, and CURLEY. After establishing these defaults, you can enter the MONITOR command without any qualifiers or parameters to display the requested information.
The SHOW DEFAULT command displays the defaults established by the SET DEFAULT command.
SHOW DEFAULT
None.
None.
The SHOW DEFAULT command verifies the defaults you have set with the SET DEFAULT command.
MONITOR> SHOW DEFAULT /BEGINNING = current time /INTERVAL = 10 /ENDING = indefinite /VIEWING_TIME = 10 /FLUSH_INTERVAL = 300 /NOINPUT /NORECORD /DISPLAY = SYS$OUTPUT:.; /NOSUMMARY /NOFILENAME /NOCOMMENT Classes: PAGE/AVERAGE IO/MAXIMUM Nodes: LARRY MOE CURLEY
The command in this example displays the defaults specified by the previous SET DEFAULT command.
Normally, MOUNT allocates the device to the user who enters the command. However, mounting volumes with the /SHARE, /GROUP, or /SYSTEM qualifier deallocates the device, because the purpose of these qualifiers is to make the volume shareable.
Note
To mount a volume on a device, you must have read (R), write (W), or control (C) access to that device.
Any subprocess in the process tree can mount or dismount a volume for the job. When a subprocess mounts a volume (for the job) as private, the master process of the job becomes the owner of this device. This provision is necessary because the subprocess may be deleted and the volume should remain privately mounted for this job. However, when a subprocess explicitly allocates a device and then mounts a private volume on this device, the subprocess retains device ownership. In this situation, only subprocesses with SHARE privilege have access to the device.
Upon successful completion of the operation, MOUNT notifies you with a message sent to SYS$OUTPUT. If the operation fails for any reason, MOUNT notifies you with an error message.
The Mount utility (MOUNT) makes a disk or magnetic tape volume available for processing.
MOUNT device-name[:][,...] [volume-label[,...]] [logical-name[:]]
device-name[:][,...]
Specifies the physical device name or logical name of the device on which the volume is to be mounted. On a system where volumes are not connected to HSCs (hierarchical storage controllers), use the following format:ddcu:
The dd describes the device type of the physical devices used. For example, an RA60 disk drive is device type DJ, and an RA80 or RA81 disk drive is device type DU. The c identifies the controller, and the u identifies the unit number of the device.
On a system with HSCs, use one of the following formats:
node$ddcu:
allocation-class$ddcu:
If your devices are dual ported to HSCs, use the allocation-class format. For example, $125$DUA23 represents an RA80 or RA81 disk with unit number 23. The disk's allocation class is $125$. The c part of the format is always A for HSC disks. TROLL$DJA12 represents an RA60 disk with unit number 12. The device is connected to an HSC named TROLL. See OpenVMS Cluster Systems for more information about naming conventions.
Device names can be generic so that if no controller or unit number is specified, the system attempts to mount the first available device that satisfies those specified components of the device names. If no volume is physically mounted on the specified device, MOUNT displays a message requesting that you place the volume in the device; after you place the volume in the named drive, MOUNT then completes the operation.
If you specify more than one device name for a disk or magnetic tape volume set, separate the device names with either commas or plus signs. For a magnetic tape volume set, you can specify more volume labels than device names or more device names than volumes.
volume-label[,...]
Specifies the label on the volume. The number of characters allowed in a label depends on the type of device, as follows:OpenVMS requires disk volume labels to be unique in the first 12 characters within a given domain. For example, disks mounted by different members of the same group using the /GROUP qualifier must be unique. However, disks mounted in different domains, such as one mounted using the /GROUP qualifier and one mounted privately, can use the same volume label.
Device Type Number of Characters
in LabelMagnetic tape 0-6 Files--11 disk 1-12 ISO 9660 disk 1-32 If you mount an ISO 9660 volume using the /SYSTEM or /CLUSTER qualifier, and the volume label is not unique within the first 12 characters, you must supply an alternate volume label using the qualifier /OVERRIDE=IDENTIFICATION. If you choose this option, then Mount verification is disabled for the device.
In addition, if a volume is part of a volume set and the first 12 characters of the volume-set name are the same as the first 12 characters of the volume label, a lock manager deadlock will occur. To avoid this problem, you must override either the volume label (by using the /OVERRIDE qualifier) or the volume-set name (by using the /BIND qualifier).
If you specify more than one volume label, separate the labels with either commas or plus signs. The volumes must be in the same volume set and the labels must be specified in ascending order according to relative volume number.
When you mount a magnetic tape volume set, the number of volume labels need not equal the number of device names specified. When a magnetic tape reaches the end-of-tape (EOT) mark, the system requests the operator to mount the next volume on one of the devices. The user is not informed of this request; only the operator is informed.
When you mount a disk volume set, each volume label specified in the list must correspond to a device name in the same position in the device name list.
The volume-label parameter is not required when you mount a volume with the /FOREIGN or /NOLABEL qualifier or when you specify /OVERRIDE=IDENTIFICATION. To specify a logical name when you enter either of these qualifiers, type any alphanumeric characters in the volume-label parameter position.
logical-name[:]
Defines a 1- to 255-alphanumeric character string logical name to be associated with the volume.If you do not specify a logical name, the MOUNT command assigns the default logical name DISK$volume-label to individual disk drives; it assigns the default logical name DISK$volume-set-name to the device on which the root volume of a disk volume set is mounted. Note that if you specify a logical name in the mount request that is different from DISK$volume-label or DISK$volume-set-name, then two logical names are associated with the device.
If you do not specify a logical name for a magnetic tape drive, the MOUNT command assigns only one logical name, TAPE$volume-label, to the first magnetic tape device in the list. No default logical volume-set name is assigned in this case.
The MOUNT command places the name in the process logical name table, unless you specify /GROUP or /SYSTEM. In the latter cases, it places the logical names in the group or system logical name table.
If you specify the /CLUSTER qualifier, the logical name is established on each node in the cluster.
Note
Avoid assigning a logical name that matches the file name of an executable image in SYS$SYSTEM. Such an assignment prohibits you from invoking that image.
Do not use the logical name assigned to a volume as a distributed file system (DFS) access point. If you attempt to add a DFS access point using the same name as the logical name, DFS fails as in the following example:
$ SHOW LOG DISK$* (LNM$SYSTEM_TABLE) "DISK$TIVOLI_SYS" = "TIVOLI$DUA0:" $ MCR DFS$CONTROL DFS> ADD ACCESS DISK$TIVOLI_SYS TIVOLI$DUA0:[000000] %DNS-W-NONSNAME, Unknown namespace name specifiedIf the logical name of a volume is in a process-private table, then the name is not deleted when the volume is dismounted.
To invoke MOUNT, enter the DCL command MOUNT, followed by the device name, volume label, and logical name. You must include a device name and a volume label (unless you specify /OVERRIDE=IDENTIFICATION or use the /FOREIGN or /NOLABEL qualifier); the logical name is optional.MOUNT returns you to the DCL level after it either successfully completes the operation or fails, generating an error message. If you press Ctrl/Y or Ctrl/C, MOUNT aborts the operation and returns you to the DCL prompt.
You can direct output from MOUNT operations with the /COMMENT and /MESSAGE qualifiers. When the mount operation requires operator assistance, use /COMMENT to specify additional information to be included with the operator request. The /COMMENT text string is sent to the operator log file and to SYS$OUTPUT. The string must contain no more than 78 characters.
Use the /MESSAGE qualifier (this is the default) to send mount request messages to your current SYS$OUTPUT device. If you specify /NOMESSAGE during an operator-assisted mount, messages are not sent to SYS$OUTPUT; the operator sees them, however, if an operator terminal is enabled to receive messages.
Many MOUNT qualifiers require special privileges. Some qualifiers require different privileges according to which qualifier keyword you specify. See the individual qualifiers for details. Table 16-1 lists MOUNT qualifiers that require special privileges.
Table 16-1 MOUNT Qualifiers That Require Special Privileges Qualifier Keywords Required Privilege /ACCESSED OPER /CACHE= [NO]EXTENT[=n] OPER [NO]FILE_ID[=n] OPER [NO]QUOTA[=n] OPER /FOREIGN VOLPRO¹ /GROUP GRPNAM /MULTI_VOLUME VOLPRO /OVERRIDE= ACCESSIBILITY VOLPRO¹ EXPIRATION VOLPRO¹ LOCK VOLPRO¹ SHADOW VOLPRO¹ /OWNER_UIC= uic VOLPRO¹ /PROCESSOR= UNIQUE OPER SAME:device OPER file-spec OPER and CMKRNL /PROTECTION= code VOLPRO¹ /QUOTA VOLPRO¹ /SYSTEM SYSNAM /WINDOWS= n OPER
¹Or your UIC must match the volume UIC.
Specifies, for ODS1 disk volumes, the approximate number of directories that will be in use concurrently on the volume.
/ACCESSED= n
n
Specifies the approximate number of directories that will be in use concurrently on an ODS1 volume. (The /ACCESSED qualifier is meaningless for ODS2 volumes.) Specify a value from 0 to 255 to override the default that was specified when the volume was initialized.You need the user privilege OPER to use /ACCESSED.
$ MOUNT/ACCESSED=150 DBA1 WORK
This command requests the volume labeled WORK to be mounted on DBA1, specifying 150 as the number of active directories on the volume.
Directs the mount operation to allow operator or user intervention if the mount request fails.
/ASSIST
/NOASSIST
When you specify the /ASSIST qualifier, MOUNT notifies the user and certain classes of operator if a failure occurs during the mount operation. If a failure occurs, the operator or user can either abort the operation or correct the error condition to allow the operation to continue.The operator-assist messages are sent to all operator terminals that are enabled to receive messages; magnetic tape mount requests go to TAPE and DEVICE operators, and disk mount requests go to DISK and DEVICE operators. Thus, if you need operator assistance while mounting a disk device, a message is sent to DISK operators. See the description of the REPLY command in the OpenVMS DCL Dictionary for more information about enabling and disabling operator terminals.
Any operator reply to a mount request is written to SYS$OUTPUT to be displayed on the user's terminal or written in a batch job log.
If no operator terminal is enabled to receive and respond to a mount assist request, a message is displayed informing the user of the situation. If a volume is placed in the requested drive, no additional operator response is necessary. If the mount request originates from a batch job and no operator terminal is enabled to receive messages, the mount is aborted. See the OpenVMS System Messages and Recovery Procedures Reference Manual for a description of the error messages and their suggested user actions.
The default is /ASSIST and can be overridden by /NOASSIST.
$ MOUNT/NOASSIST DMA0: DOC WORK %MOUNT-I-MOUNTED, DOC mounted on _NODE$DMA0:
This command mounts an RK07 volume labeled DOC and assigns the logical name WORK. The /NOASSIST qualifier signals MOUNT that no operator intervention is necessary.
Determines whether MOUNT enables or disables automatic volume switching and labeling for magnetic tape or ISO 9660 CD--ROM.
/AUTOMATIC
/NOAUTOMATIC
The default is /AUTOMATIC.Magnetic Tape
If you have multiple magnetic tape drives allocated to a volume set, the magnetic tape ancillary control process (MTACP) performs the volume switch by sequentially selecting the next available drive allocated to the volume set. The MTACP expects the next reel of the volume set to be loaded on that drive.
If the MTACP is writing to the volume set, it creates a label and initializes the magnetic tape with that label and the protections established for the first magnetic tape of the volume set. If it is reading from the volume set, the MTACP generates the label and attempts to mount the next magnetic tape with that label. If the drive has the wrong magnetic tape (or no magnetic tape) loaded, the MTACP sends a message to the operator's console to prompt for the correct magnetic tape.
The label generated by the MTACP fills the 6-character volume identifier field. The first four characters of the field contain the first four characters of the label specified in the MOUNT command, padded with underscores when the label is not at least four characters. The fifth and sixth characters contain the relative volume number for this reel in the volume set.
If you specify /NOAUTOMATIC, the MTACP requires operator intervention to switch to the next drive during end-of-tape processing, and requires that the operator specify a label for each new reel added to a volume set.
ISO 9660 CD--ROM
Under ISO 9660, not all volume-set members must be mounted to perform I/O operations against that volume set. By default, if I/O operations attempt to access an unmounted volume-set member, an operator message is sent to all DISK CLASS operators for system-mounted volume sets, or the owning process for privately mounted volume sets. The message specifies the volume-set member to mount to complete the I/O operation requested. If /NOAUTOMATIC is specified, then an I/O operation to a nonmounted volume set member completes with an error message SS$_DEVNOTMOUNT.
$ MOUNT/NOAUTOMATIC MTA0: ABCD,EFGH
This command instructs MOUNT not to generate its own label for the second volume, but to use the ones supplied with the MOUNT command. If the second volume is not already labeled, then the operator must use REPLY/INIT and supply the second label.
Creates a volume set of one or more disk volumes or adds one or more volumes to an existing volume set.
/BIND= volume-set-name
volume-set-name
Specifies a 1- to 12-alphanumeric-character name identifying the volume set.An ISO 9660 volume-set name can be from 1 to 128 characters in length.
OpenVMS requires volume-set names to be unique in the first 12 characters. In addition, if the first 12 characters of volume-set name are the same as the first 12 characters of any volume label, a lock manager deadlock will occur. To avoid this problem, you must override either the volume label (by using the /OVERRIDE qualifier) or the volume-set name (by using the /BIND qualifier).
You must specify the /BIND qualifier when you first create the volume set or each time you add a volume to the set. To dismount an individual volume of the volume set, you must use the DISMOUNT qualifier /UNIT. Otherwise, dismounting an individual volume dismounts the entire volume set.When you create a volume set, the volumes specified in the volume-label list are assigned relative volume numbers based on their positions in the label list. The first volume specified becomes the root volume of the set.
When you add a volume or volumes to a volume set, the first volume label specified must be that of the root volume, or the root volume must already be on line.
Note that if you attempt to create a volume set from two or more volumes that already contain files and data, the file system does not issue an error message when you issue the MOUNT/BIND command. However, the volumes are unusable as a volume set because the directory structures are not properly bound.
If you mount an ISO 9660 volume using the /SYSTEM or /CLUSTER qualifier, and the volume label is not unique within the first 12 characters, you must supply an alternate 12-character volume label using the qualifier /BIND=volume-set-name. If you choose this option, then Mount verification is disabled for the device.
Note
Once a volume is bound into a volume set, it cannot easily be unbound. To unbind a bound volume set (BVS):
- Do an image backup of the BVS.
- Initialize all volumes of the BVS.
- Do an image restore to a single volume with the /NOINITIALIZE qualifier, or do a nonimage restore to a single volume.
Examples
$ MOUNT/BIND=LIBRARY DMA0:,DMA1:,DMA2: BOOK1,BOOK2,BOOK3
$ MOUNT/BIND=TEST3013 DSA3011/SHADOW=($1$DUA402:,$1$DUA403:), DSA3012/SHADOW=($1$DUA404:,$1$DUA405:) TEST3011,TEST3012 TEST3013
6048P038.HTM OSSG Documentation 26-NOV-1996 12:43:16.62
Copyright © Digital Equipment Corporation 1996. All Rights Reserved.