HELP MOUNT — MicroVMS 4.5B
Makes a volume available for processing. The volume must be physically loaded on a ready device. Volumes mounted privately from a subprocess become owned by the master process. Format MOUNT device-name,... [volume-label,...] [logical-name]
Additional information available:
Parameters
device-name
Name of the device (physical name or logical name) on which the volume
is physically loaded.
volume-label
Label placed on the volume at initialization time. You must specify
the label unless the volume is mounted with the /FOREIGN, /NOLABEL, or
/OVERRIDE=IDENTIFICATION qualifier. (You must specify the label
in order to specify a logical name.)
logical-name
A character string of 1 through 255 characters. If the string contains
blanks, enclose it in quotation marks ("). The logical name defaults
to DISK$volume-label for disk volumes. (Do not use a logical name that
matches the file name of an executable image in SYS$SYSTEM.)
Qualifiers
Additional information available:
/ACCESSED/ASSIST/AUTOMATIC/BIND/BLOCKSIZE
/CACHE/COMMENT/DATA_CHECK/DENSITY/EXTENSION
/FOREIGN/GROUP/HDR3/INITIALIZE/LABEL/MESSAGE
/MOUNT_VERIFICATION/OVERRIDE/OWNER_UIC/PROCESSOR
/PROTECTION/QUOTA/REBUILD/RECORDSIZE/SHARE
/UNLOAD/SYSTEM/WINDOWS/WRITE
/ACCESSED=number-of-directories
Requires OPER privilege. Specifies the approximate number of directories that will be in use concurrently on the volume. The value specified with the /ACCESSED qualifier (which can be from 0 through 255) overrides the default set when the volume was initialized.
/ASSIST (default)
/NOASSIST Allows operator or user intervention if the MOUNT request fails. Operator replies are written to SYS$OUTPUT. NOTE: Operator-assisted MOUNT commands will not work unless the OPCOM process is running. SYS$MANAGER:SYLOGIN.COM creates the symbol MOUNT/NOASSIST for the MOUNT command. If you choose to allow operator-assisted MOUNT commands, you should remove this symbol and start OPCOM by deleting the comment character (!) from the line @SYS$SYSTEM:STARTUP OPCOM in SYS$MANAGER:SYSTARTUP.COM.
/AUTOMATIC (default)
/NOAUTOMATIC Determines whether MOUNT enables or disables automatic volume switching and labeling for magnetic tape. The default is /AUTOMATIC. If you have multiple magnetic tape drives allocated to a volume set, the MTAACP performs the volume switch by sequentially selecting the next available drive allocated to the volume set. The MTAACP expects the next reel of the volume set to be loaded on that drive.
/BIND=volume-set-name
Creates a volume set of one or more disk volumes or adds one or more volumes to an existing volume set. (Specify the root volume label first, if it is not online.) The volume-set-name can be from 1 through 12 alphanumeric characters.
/BLOCKSIZE=n
Specifies, for magnetic tape volumes, the default block size. Valid values are in the range 18 through 65534 for MicroVMS RMS operations and 14 through 65534 for MicroVMS non-RMS operations. By default, records are written to tape volumes in 2048-byte blocks. For foreign or unlabeled tapes, the default is 512 bytes. You must specify /BLOCKSIZE when you are mounting: Tapes that do not have HDR2 labels. Tapes that contain blocks whose size exceeds the default block size (2048 bytes).
/CACHE=(keyword,...)
/NOCACHE For disk devices, overrides the disk caching limits established at system generation time. With the TAPE_DATA option, enables or disables the write cache for the tape controller specified. Possible keywords are: +-----------------+--------------------------------------------------+ | [NO]EXTENT[=n] | Enables extent caching to the specified limit. | | | NOEXTENT or EXTENT=0 disables extent caching. | | | Requires OPER privilege. | +-----------------+--------------------------------------------------+ | [NO]FILE_ID[=n] | Enables file identification caching. The value | | | of N must be greater than 1. Requires OPER | | | privilege. NOFILE_ID or FILE_ID=1 disables file | | | identification caching. | +-----------------+--------------------------------------------------+ | LIMIT=n | Specifies the maximum amount of free space in | | | the extent cache in 1/1000's of currently | | | available free space on the disk. | +-----------------+--------------------------------------------------+ | [NO]QUOTA[=n] | Enables quota caching. You normally set N to | | | the maximum number of expected active users for | | | a disk with quotas enabled. NOQUOTA or QUOTA=0 | | | disables quota file caching. | +-----------------+--------------------------------------------------+ | TAPE_DATA | Enables the write cache for a tape device if the | | | tape controller supports a write cache. /NOCACHE| | | is the default for mounting tape devices. If the| | | tape controller does not support a write cache, | | | the option is ignored. | +-----------------+--------------------------------------------------+ | WRITETHROUGH | Disables writeback caching which only writes the | | | file headers of files open for write after the | | | files are closed. Thus, WRITETHROUGH writes | | | file headers to the disk on every file header | | | operation. | +-----------------+--------------------------------------------------+ If you specify more than one option, separate them by commas and enclose the list in parentheses.
/COMMENT="string"
Writes the string containing additional information for the operator (when operator assistance is necessary) to the operator log file and the current SYS$OUTPUT device. The string must contain no more than 78 characters.
/DATA_CHECK=(keyword,...)
Checks all read and/or write operations on the disk. Overrides the initialization value. Specify one or both keywords: +---------+-----------------------------------------+ | READ | Checks all read operations | +---------+-----------------------------------------+ | WRITE | Checks all write operations (default) | +---------+-----------------------------------------+
/DENSITY=n
The /DENSITY qualifier is not applicable to the TK50 tape device. Specifies, for foreign or unlabeled tapes, the density (in bpi) at which the tape will be written. You can specify 800, 1600, or 6250, if the density is supported by the magnetic tape drive. If you do not specify a density for a tape that was previously written, the density defaults to that of the first record on the volume.
/EXTENSION=n
Sets the default extend quantity for all files on the volume. The value n can range from 0 through 65535.
/FOREIGN
Requires ownership of the volume or VOLPRO privilege for Files-11 volumes. Indicates the volume is not to be processed by the file system.
/GROUP
Requires GRPNAM privilege. Makes the volume available to all processes with your group number, and makes its name a group logical name.
/HDR3
/NOHDR3 Controls whether MicroVMS file header labels are written on magnetic tapes. By default, MicroVMS file header labels are written. You can specify /NOHDR3 to write tapes that will be used on other systems that do not process MicroVMS file header labels correctly.
/INITIALIZE=CONTINUATION
Specifies that any volume added to the magnetic tape volume set is initialized before you can write to the volume.
/LABEL (label)
/NOLABEL Indicates, for magnetic tape volumes, whether the tape contains MicroVMS ANSI labels. Note that /NOLABEL is equivalent to /FOREIGN.
/MESSAGE (default)
/NOMESSAGE Writes MOUNT request messages to SYS$OUTPUT.
/MOUNT_VERIFICATION (default)
/NOMOUNT_VERIFICATION Enables mount verification.
/OVERRIDE=(option,...)
Requires OPER or VOLPRO privileges to specify /OVERRIDE=(ACCESSIBILITY, EXPIRATION) along with the /FOREIGN qualifier; otherwise, the tape will not be read. Allows you to override one or more protection checks that the MOUNT command performs. The options are as follows: +------------------+--------------------------------------------------+ | ACCESSIBILITY | (For magnetic tapes only). If the installation | | | allows, this option overrides any character in | | | the Accessibility Field of the volume. The | | | necessity of this option is defined by the | | | installation. That is, each installation has | | | the option of specifying a routine that the | | | magnetic tape file system will use to process | | | this field. By default MicroVMS provides a | | | routine that checks this field in the following | | | manner. If the magnetic tape was created on a | | | version of MicroVMS that conforms to Version 3 | | | of ANSI, then this option must be used to | | | override any character other than an ASCII | | | space. If a MicroVMS protection is specified | | | and the magnetic tape conforms to an ANSI | | | standard that is later than Version 3, then | | | this option must be used to override any | | | character other than an ASCII 1. To use the | | | ACCESSIBILITY option, you must have the user | | | privilege VOLPRO or be the owner of the volume. | +------------------+--------------------------------------------------+ | EXPIRATION | (For magnetic tapes only). Allows you to write | | | to a tape that has not yet reached its | | | expiration date. You must have the user | | | privilege VOLPRO to override volume protection, | | | or your UIC must match the UIC written on the | | | volume. | +------------------+--------------------------------------------------+ | IDENTIFICATION | Allows you to mount a volume when you do | | | not know what the volume label is. If you | | | specify /OVERRIDE=IDENTIFICATION, you can | | | specify anything for the volume-label parameter | | | or you can omit it; the MOUNT command ignores | | | whatever you enter. The volume must be | | | mounted /NOSHARE. | +------------------+--------------------------------------------------+ | LOCK | Directs MOUNT not to write-lock the volume | | | as a consequence of certain errors encountered | | | while mounting it. Use this option when you | | | are mounting a damaged volume to be repaired | | | using the Verify Utility. (BYPASS privilege | | | will be necessary to actually perform the repair | | | operation.) VOLPRO privilege or ownership of | | | of the volume is required to use this option. | +------------------+--------------------------------------------------+ | OWNER_IDENTIFIER | Allows you to override the processing of the | | | Owner Identifier field of the volume label. | +------------------+--------------------------------------------------+ | SETID | (For tapes that do not conform to ANSI | | | standards). Allows you to inhibit checks of the | | | file set identifier when you switch reels in a | | | multivolume tape set. | +------------------+--------------------------------------------------+
/OWNER_UIC=[uic]
Requires ownership of the volume or VOLPRO privilege to specify a UIC other than your own. Specifies an owner UIC for the volume while it is mounted. The default is the UIC initialized for the volume.
/PROCESSOR=keyword
Requires OPER privilege. For magnetic tapes and Files-11 Structure Level 1 disk, requests that the MOUNT command associate an ACP to process the volume. The /PROCESSOR qualifier causes MOUNT to override the default manner in which ACP's are associated with devices. For Files-11 Structure Level 2 disk, controls block cache allocation. Possible keywords are: +-------------+---------------------------------------------------+ | UNIQUE | For magnetic tape and Files-11 Structure Level 1 | | | disk, creates a new process to execute a copy of | | | the default ACP image for the specified device | | | type or controller. | | | | | | For Files-11 Structure Level 2 disk, allocates a | | | separate block cache. | +-------------+---------------------------------------------------+ | SAME:device | For magnetic tape and Files-11 Structure Level 1 | | | 1 disk, uses the same ACP process currently being | | | used by the device specified. | | | | | | For Files-11 Structure Level 2 disk, takes the | | | block cache allocation from the specified device. | +-------------+---------------------------------------------------+ | file-spec | Creates a new process to execute the ACP image | | | specified by the file-spec (for example, a | | | modified or a user-written ACP). No wildcard | | | characters, node names, or directory names are | | | allowed in the file specification. Requires | | | CMKRNL and OPER privilege. | +-------------+---------------------------------------------------+
/PROTECTION=(ownership[:access],...)
Requires VOLPRO privilege for a volume other than your own. Applies the specified protection to the volume while it is mounted. The default is the protection initialized for the volume. The ownership categories are SYSTEM, OWNER, GROUP, WORLD; the access categories are R (read), W (write), E (create), and D (delete).
/QUOTA (default)
/NOQUOTA Requires VOLPRO privilege for a volume other than your own. Enforces disk quotas for each user on the volume if the volume contains a quota file.
/REBUILD (default)
/NOREBUILD Controls whether or not MOUNT performs a rebuild operation on a disk volume. If a disk volume has been improperly dismounted (such as during a system failure), it must be rebuilt in order to recover any caching limits that were enabled on the volume at the time of the dismount. By default, MOUNT attempts the rebuild. The rebuild may consume a considerable amount of time, depending on the number of files on the volume and, if quotas are in use, on the number of different file owners. If you use the /NOREBUILD qualifier, devices can be returned to active use immediately. You can then perform the rebuild later with the DCL command SET VOLUME/REBUILD.
/RECORDSIZE=n
Specifies, for magnetic tape volumes, the number of characters in each record. This qualifier is normally used 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 that is specified or used by default. The block size may be in the range 20 through 65,532 bytes if you are using MicroVMS RMS, or 14 through 65,534 bytes if you are not using MicroVMS RMS.
/SHARE
/NOSHARE (default) Makes the volume available to all users.
/UNLOAD (default)
/NOUNLOAD Controls whether or not the disk specified in the MOUNT command is unloaded when it is dismounted.
/SYSTEM
Requires SYSNAM privilege. Makes the volume available to all users of the system and makes its logical name a system logical name.
/WINDOWS=number-of-pointers
Specifies the number of mapping pointers (used to access data in the file) to be allocated for file windows. The value of n can be from 7 through 80; the default is 7. Overrides the initialization value.
/WRITE (default)
/NOWRITE Permits write access to the volume.