HP OpenVMS Systems Documentation
HP OpenVMS DCL Dictionary
In this example, the volume WORKDISK is found to have been improperly dismounted, but because the /NOREBUILD qualifier is specified, a rebuild is not performed. Instead, MOUNT displays a message to inform you that the rebuild is needed, and proceeds to make WORKDISK available for use as is. You can rebuild the volume later with the DCL command SET VOLUME/REBUILD.
/RECORDSIZE=nSpecifies the number of characters in each record of a magnetic tape volume.
The parameter, n, specifies the block size in the range 20 to 65,532 bytes if you are using OpenVMS RMS, or 18 to 65,534 bytes if you are not using OpenVMS RMS.
You typically use this qualifier with the /FOREIGN and /BLOCKSIZE qualifiers to read or write fixed-length records on a block-structured device. In this case, the record size must be less than or equal to the block size specified or used by default.
In the following example, the magnetic tape is mounted on MTA0 with a default block size and record size of 512 characters:
/SHADOWBinds up to three physical devices into a shadow set represented by the virtual unit named in the command. This qualifier is applicable only if you have the volume shadowing option. Refer to HP Volume Shadowing for OpenVMS for additional information.
The format of this qualifier is:
This qualifier indicates that you are mounting a shadow set including the physical devices and the virtual unit that represents them to the system. This qualifier instructs MOUNT to expect a virtual unit name as the device-name parameter. Place the /SHADOW qualifier after the virtual-unit-name parameter.
Use the virtual unit naming format DSAn, where n is a unique number from 0 to 9999. For the physical-device-name, use the standard device-naming format $allocation-class$ddcu[:].
The following example shows how to create a shadow set wherein the software determines automatically the correct copy operation for the two shadow set members. In this case, $1$DUA10 is the more current volume and becomes the source of the copy operation to $1$DUA11.
The following command creates a volume set with the logical name TEST3. The volume set TEST3 is not shadowed, however each element of the volume set (TEST3011 and TEST3012) is a shadowset, providing redundancy for the volume set as a whole.
/NOSHARESpecifies, for a disk volume, that the volume is shareable.
If another user has already mounted the volume shareable, and you request it to be mounted with the /SHARE qualifier, any other qualifiers you enter are ignored.
By default, a volume is not shareable, and the MOUNT command allocates the device on which it is mounted.
If you previously allocated the device and specify the /SHARE qualifier, the MOUNT command deallocates the device so that other users can access it.
The /SHARE qualifier is incompatible with the /GROUP and /SYSTEM qualifiers.
/NOSUBSYSTEMEnables protected subsystems and the processing of subsystem ACEs. Requires the SECURITY privilege.
By default, the disk from which you boot has /SUBSYSTEM enabled but other disks do not. For further details on subsystems, refer to the HP OpenVMS Guide to System Security.
/SYSTEMMakes the volume public; that is, available to all users of the system, as long as the UIC-based volume protection allows them access.
The logical name for the device is placed in the system logical name table. You must have the user privilege SYSNAM to use the /SYSTEM qualifier.
When you mount a volume with the /SYSTEM qualifier in a VMScluster system, you must use a volume label that is unique clusterwide, even if the specified volume is not mounted clusterwide.
The /SYSTEM qualifier is incompatible with the /GROUP, /OVERRIDE=IDENTIFICATION, and /SHARE qualifiers.
The following command creates the volume set named MASTER_PAY consisting of the initialized volumes labeled PAYVOL1, PAYVOL2, and PAYVOL3. These volumes are mounted physically on the devices named DB1, DB2, and DB3, respectively. The volume PAYVOL1 is the root volume of the set.
The volumes are mounted as system volumes to make them available to all users.
/UCS_SEQUENCE=escape_sequenceSupplies the escape sequence to select the coded graphic character set, a requirement when mounting an ISO 9660 volume for one of the Supplementary Volume Descriptors (SVDs).
The parameter, escape_sequence, is a character sequence defined by the vendor who mastered the CD-ROM and is unique to the vendor's character set conversion tables.
Use the /UCS_SEQUENCE qualifier when mounting an ISO 9660 CD-ROM that contains non-ASCII character sets on OpenVMS.
An ISO 9660 volume may contain an SVD that specifies a graphic character set. This graphic character, when selected at mount time, is used as default character set when displaying a volume's directories and file names.
The /UCS_SEQUENCE qualifer defines the escape sequence to select the coded graphic character set.
All ISO 9660 volumes contain a Primary Volume Descriptor (PVD) that uses ASCII (ISO 646-IRV) as the character set. Both ISO 9660 and OpenVMS file naming conventions use the same subset of ASCII characters when displaying a volume's directories and file names.
/UNDEFINED_FAT=record-format:[record-attributes:][record-size]Establishes default file attributes to be used for records on ISO 9660 media for which no record format has been specified.
The following table describes the parameters:
ISO 9660 media can be mastered from platforms that do not support semantics of files containing predefined record formats. The /UNDEFINED_FAT qualifier establishes default file attributes to be used for records on ISO 9660 media for which no record format has been specified.
The /UNDEFINED_FAT qualifier is valid only in conjunction with the /MEDIA_FORMAT=CDROM qualifier.
This qualifier temporarily overrides all undefined file types, replacing them with selectable record formats having selectable record attributes and selectable record sizes as shown in the following illustration:
In the following example, the volume labeled OFFENS is mounted on DKA1 and all files on the volume are defined to be fixed length, carriage return, and 80 bytes in length. MOUNT also assigns the logical name STRAT.
/NOUNLOADControls whether or not the disk or magnetic tape volume or volumes specified in the MOUNT command are unloaded when they are dismounted.
In the following example, the volume labeled OFFENS is mounted on DKA1 with the /NOUNLOAD qualifier so that it can be dismounted without being physically unloaded. MOUNT also assigns the logical name STRAT.
/WINDOWS=nSpecifies the number of mapping pointers to be allocated for file windows.
The parameter, n, specifies a value from 7 to 80 that overrides the default value specified when the volume was initialized.
When a file is opened, the file system uses the mapping pointers to access data in the file. Use MOUNT/WINDOWS to override the default value specified when the volume was initialized. If no value was specified at volume initialization, the default number of mapping pointers is 7.
You must have the operator user privilege (OPER) to use the /WINDOWS qualifier.
The following command makes the volume labeled GONWITH on DKA2 available systemwide and assigns the logical name THE_WINDOW. You override the default number of mapping pointers by specifying a value of 25 for the /WINDOWS qualifier.
/NOWRITEControls whether the volume can be written.
By default, a volume is considered read/write when it is mounted. You can specify /NOWRITE to provide read-only access to protect files. This is equivalent to write-locking the device.
The following command mounts a volume labeled BOOKS on NODE$DKA1 and then proceeds to mount it on each node in the existing OpenVMS Cluster. The /NOWRITE qualifier makes the volume available for read-only access.
$ MOUNT MTA0: MATH06 STAT_TAPE %MOUNT-I-MOUNTED, MATH06 mounted on _MTA0: $ COPY ST061178.DAT STAT_TAPE:
This MOUNT command requests the magnetic tape whose volume label is MATH06 to be mounted on the device MTA0 and assigns the logical name STAT_TAPE to the volume.
Subsequently, the COPY command copies the disk file ST061178.DAT to the magnetic tape.
$ ALLOCATE DM: %DCL-I-ALLOC, _DMB2: allocated $ MOUNT DMB2: TEST_FILES %MOUNT-I-MOUNTED, TEST_FILES mounted on _DMB2:
This ALLOCATE command requests an available RK06/RK07 device. After the response from the ALLOCATE command, the physical volume can be placed on the allocated device. Then, the MOUNT command mounts the volume.
$ MOUNT DM: TEST_FILES %MOUNT-I-OPRQST, Please mount volume TEST_FILES in device _DMB2: %MOUNT-I-MOUNTED, TEST_FILES mounted on _DMB2:
This example achieves the same result as the series of commands in the preceding example. The MOUNT command requests an available RK06/RK07 device for the volume labeled TEST_FILES. After the volume is physically mounted in the device named in the response from MOUNT, the system completes the operation. Note that the device is automatically allocated by MOUNT.
$ MOUNT DYA1: TESTSYS %MOUNT-I-OPRQST, Please mount volume TESTSYS in device DYA1: [Ctrl/Y] $ EXIT %MOUNT-I-OPRQSTCAN, operator request canceled
This MOUNT command requests the operator to mount the volume TESTSYS on the device DYA1. In this example, the user cancels the mount by pressing Ctrl/Y. Notice that the image must exit before the mount request is actually canceled. Here, the EXIT command causes the image to exit. However, any command that is not performed within the command interpreter causes the current image to exit.
$ MOUNT DYA1: TESTSYS %MOUNT-I-OPRQST, Device _DYA1: is not available for mounting. %MOUNT-I-OPRQSTCAN, operator request canceled %MOUNT-I-OPRQST, Please mount volume TESTSYS in device _DYA1: %MOUNT-I-MOUNTED, TESTSYS mounted on _DYA1: %MOUNT-I-OPRQSTDON, operator request canceled - mount completed successfully
This MOUNT command requests the operator to mount the volume TESTSYS on the device DYA1. Because DYA1 is allocated to another user, the device cannot be mounted. In this case, the user can wait for the device to become available, redirect the mount to another device, or abort the mount. Here, the user remains in operator-assisted mount waiting for the process that is using the device to deallocate it.
At this point, because the device is available but no volume is mounted, the original mount request is canceled, and a new request to mount TESTSYS is issued. Finally, the operator places the volume in the drive and lets MOUNT retry the mount. When the mount completes, the request is canceled.
$ MOUNT DYA1: TESTSYS/COMMENT="Is there an operator around?" %MOUNT-I-OPRQST, Please mount volume TESTSYS in device _DYA1: Is there an operator around? %MOUNT-I-NOOPR, no operator available to service request . . . %MOUNT-I-MOUNTED, TESTSYS mounted on _DYA1: %MOUNT-I-OPRQSTDON, operator request canceled - mount completed successfully
This MOUNT command requests the operator to mount the volume TESTSYS on the device DYA1. In this example, no operator is available to service the request. At this point, the user can abort the mount by pressing Ctrl/Y, or wait for an operator. Here, the user waited, and an operator eventually became available to service the request.
$ MOUNT/SYSTEM/MEDIA=CDROM $1$DKA1 USER %MOUNT-I-CDROM_ISO, USER:VMS_ONLINE_DOCUMENTATION (1 of 4) , mounted on _$1$DKA1: (CDROM) $ MOUNT/SYSTEM/MEDIA=CDROM $1$DKA2 PROGRAMMING_1 %MOUNT-I-CDROM_ISO, PROGRAMMING_1:VMS_ONLINE_DOCUMENTATION (2 of 4) , mounted on _$1$DKA2: (CDROM) $ MOUNT/SYSTEM/MEDIA=CDROM $1$DKA3 PROGRAMMING_2 %MOUNT-I-CDROM_ISO, PROGRAMMING_2:VMS_ONLINE_DOCUMENTATION (3 of 4) , mounted on _$1$DKA3: (CDROM) MOUNT/SYSTEM/MEDIA=CDROM $1$DKA4 MANAGEMENT %MOUNT-I-CDROM_ISO, MANAGEMENT:VMS_ONLINE_DOCUMENTATION (4 of 4) , mounted on _$1$DKA4: (CDROM)
These commands mount each member of a four-member ISO 9660 volume set whose volume-set name is VMS_ONLINE_DOCUMENTATION.
$ MOUNT/SYSTEM/MEDIA=CDROM $1$DKA1,$1$DKA2,$1$DKA3,$1$DKA4 USER,PROGRAMMING_1,PROGRAMMING_2,MANAGEMENT %MOUNT-I-CDROM_ISO, USER:VMS_ONLINE_DOCUMENTATION (1 of 4) , mounted on _$1$DKA1: (CDROM) %MOUNT-I-CDROM_ISO, PROGRAMMING_1:VMS_ONLINE_DOCUMENTATION (2 of 4) , mounted on _$1$DKA2: (CDROM) %MOUNT-I-CDROM_ISO, PROGRAMMING_2:VMS_ONLINE_DOCUMENTATION (3 of 4) , mounted on _$1$DKA3: (CDROM) %MOUNT-I-CDROM_ISO, MANAGEMENT:VMS_ONLINE_DOCUMENTATION (4 of 4) , mounted on _$1$DKA4: (CDROM)
This command mounts four members of an ISO 9660 volume set whose volume set name is VMS_ONLINE_DOCUMENTATION.
$ MOUNT/SYSTEM/SUBSYSTEM $8$DKA300: ATLANTIS_WORK1 %MOUNT-I-MOUNTED, ATLANTIS_WORK1 mounted on _$8$DKA300: (ATLANTIS) $ SHOW DEVICE/FULL $8$DKA300: Disk $8$DKA300: (ATLANTIS), device type RZ24, is online, mounted, file-oriented device, shareable, served to cluster via MSCP Server, error logging is enabled. Error count 0 Operations completed 385 Owner process "" Owner UIC [SYSTEM] Owner process ID 00000000 Dev Prot S:RWPL,O:RWPL,G:R,W Reference count 1 Default buffer size 512 Total blocks 409792 Sectors per track 38 Total cylinders 1348 Tracks per cylinder 8 Allocation class 8 Volume label "ATLANTIS_WORK1" Relative volume number 0 Cluster size 3 Transaction count 1 Free blocks 396798 Maximum files allowed 51224 Extend quantity 5 Mount count 1 Mount status System Cache name "_$8$DKA700:XQPCACHE" Extent cache size 64 Maximum blocks in extent cache 39679 File ID cache size 64 Blocks currently in extent cache 0 Quota cache size 50 Maximum buffers in FCP cache 295 Volume owner UIC [VMS,PLATO] Vol Prot S:RWCD,O:RWCD,G:RWCD,W:RWCD Volume status: ODS-2, subject to mount verification, protected subsystems enabled, file high-water marking, write-through caching enabled.
The MOUNT command mounts a volume labeled ATLANTIS_WORK1, which is available systemwide. Subsystems on the volume are accessible.
$ MOUNT DSA0: /SHADOW=($200$DKA200:,$200$DKA300:,$200$DKA400:) X5OZCOPY %MOUNT-I-MOUNTED, X5OZCOPY mounted on _DSA0: %MOUNT-I-SHDWMEMSUCC, _$200$DKA200: (VIPER1) is now a valid member of the shadow set %MOUNT-I-SHDWMEMSUCC, _$200$DKA300: (VIPER1) is now a valid member of the shadow set %MOUNT-I-SHDWMEMSUCC, _$200$DKA400: (VIPER1) is now a valid member of the shadow set $ DISMOUNT DSA0: $ MOUNT/INCLUDE DSA0: /SHADOW=$200$DKA200: X5OXCOPY %MOUNT-I-MOUNTED, X5OZCOPY mounted on _DSA0: %MOUNT-I-SHDWMEMSUCC, _$200$DKA200: (VIPER1) is now a valid member of the shadow set %MOUNT-I-AUTOMEMSUCC, _$200$DKA300: (VIPER1) automatically added to the shadow set %MOUNT-I-AUTOMEMSUCC, _$200$DKA400: (VIPER1) automatically added to the shadow set
In this example, an existing shadow set is mounted in two ways. The first MOUNT command specifies each member of the shadow set with the /SHADOW qualifier. Then, after DSA0: is dismounted, the second MOUNT command uses the /INCLUDE qualifier to automatically mount all members of the shadow set.
Invokes the OpenVMS National Character Set (NCS) utility, which provides a convenient method of implementing alternative (non-ASCII) string collating sequences, typically using subsets of the DEC Multinational character set. NCS also facilitates the implementation of string conversion functions.
For more information about the NCS utility, refer to the OpenVMS National Character Set Utility Manual (available on the Documentation CD-ROM) or online help.
Performs a specified action when a command or program executed within a command procedure encounters an error condition or is interrupted by Ctrl/Y. The specified actions are performed only if the command interpreter is enabled for error checking or Ctrl/Y interrupts (the default conditions). Use the ON command only in a command procedure.
ON condition THEN [$] command
conditionSpecifies either the severity level of an error or a Ctrl/Y interrupt. Specify one of the following keywords, which may be abbreviated to one or more characters:
WARNING Return status of warning occurs ($SEVERITY equals 0). ERROR Return status of error occurs ($SEVERITY equals 2). SEVERE_ERROR Return status of error occurs ($SEVERITY equals 4). CONTROL_Y Ctrl/Y character occurs on SYS$INPUT.
The default error condition is ON ERROR THEN EXIT.
commandSpecifies the DCL command line to be executed. Optionally, you can precede the command line with a dollar sign ($).
If you specified an error condition as the condition parameter, the action is taken when errors equal to or greater than the specified level of error occur.
During the execution of a command procedure, the command interpreter checks the condition code returned from each command or program that executes. With the ON command, you can establish a course of action for the command interpreter to take based on the result of the check.
The system places condition codes in the global symbol $STATUS. The severity of the condition code is represented in the first 3 low-order bits of $STATUS. This severity level is also represented by the global symbol $SEVERITY. See the description of the EXIT command for information on severity level values.
If an ON command action specifies the severity level of an error, the command interpreter executes the ON command action for errors at the specified severity level or greater. For example, the following command causes a procedure to exit on warnings, errors, or severe errors:
$ ON WARNING THEN EXIT
The default action is as follows:
$ ON ERROR THEN EXIT
That is, the command interpreter continues when a warning occurs, and executes an EXIT command when an error or severe error occurs. An ON command action that specifies a severity level is executed only once; after the ON command action is taken, the default ON action is reset. There is an exception to the default ON action. If you use the GOTO command and specify a label that does not exist in the current command procedure, the procedure issues a warning message and exits.
The action specified by an ON command applies only within the command procedure in which the command is executed; therefore, if you execute an ON command in a procedure that calls another procedure, the ON command action does not apply to the nested procedure. An ON command executed at any command procedure level does not affect the error condition handling of procedures at any other level.
To disable error checking with the ON command, use the SET NOON command. You can enable error checking with the SET ON command, or by entering another ON command.
The ON command also provides a way to define an action routine for a Ctrl/Y interrupt that occurs during execution of a command procedure. The default (Ctrl/Y) action is to prompt for command input at the Ctrl/Y command level. The Ctrl/Y command level is a special command level where you can enter DCL commands. If you enter a command that is executed within the command interpreter, you can resume execution of the procedure with the CONTINUE command. (For a list of commands that are executed within the command interpreter, refer to the OpenVMS User's Manual.)
If you enter any other DCL command, the command interpreter returns to command level 0 and executes the image invoked by the command. If you interrupt the command procedure while it is executing an image that contains an exit handler, the exit handler is allowed to execute before the new command (image) is executed. (However, if you enter the STOP command after you interrupt a command procedure by pressing Ctrl/Y, exit handlers declared by the interrupted image are not executed.)
You can use the ON command to change the default action for a Ctrl/Y interrupt. If you change the default Ctrl/Y action, the execution of a Ctrl/Y interrupt does not automatically reset the default Ctrl/Y action. A Ctrl/Y action remains in effect until one of the following occurs:
- The procedure terminates (as a result of an EXIT or STOP command, or as a result of a default error condition handling action).
- Another ON CONTROL_Y command is executed.
- The procedure executes the SET NOCONTROL=Y command.
Previous Next Contents Index