MOUNT declares a volume to be logically known to the system, on-line, and available for use. Some qualifiers can be used with any MOUNT command; some are limited to mounting disks (and other random-addressable devices) and others are limited to mounting magnetic tapes. See also HELP MOUNT MAGTAPE. MOUNT For Disks and Other Random-Addressable Devices MOUNT[/qualifier[s]] ddnn: volumelabel Command Qualifiers For Both Disks and Tapes /DEFAULT:arg /FILE_PROTECTION:(code) SAVE /FOREIGN NOUNLOAD /OVERRIDE:IDENTIFICATION UNLOAD /PARAMETERS:"user parameters" /PROCESSOR:arg /PROTECTION:(code) acpname /PUBLIC UNIQUE /[NO]SHAREABLE /SHOW /SYSTEM (synonym for /PUBLIC) /VOLUME:(volume-ID[s]) /[NO]WAIT /[NO]WRITE Command Qualifiers for Disks and Other Files-11 Devices /ACCESSED:n /EXTENSION:n /OWNER:[uic] /UNLOCK /WINDOWS:arg n (USER:n,INDEX:n) 2 MAGTAPE MOUNT declares a volume to be logically known to the system, on-line, and available for use. Some qualifiers can be used with any MOUNT command; some are limited to mounting disks (and other random-addressable devices) and others are limited to mounting magnetic tapes. See also HELP MOUNT for information on mounting disks. MOUNT for Magnetic Tapes MOUNT[/qualifier[s]] ddnn:[,ddnn:...]] fileset-ID Command Qualifiers for ANSI and Unlabelled Tapes /BLOCK_SIZE:n /DENSITY:arg /CARRIAGE_CONTROL:arg 800 FORTRAN 1600 LIST 6250 NONE HIGH /[NO]HDR3 LOW /[NO]LABEL /OVERRIDE:arg /RECORD_SIZE:n ACCESSIBILITY /TRANSLATE:arg EXPIRATION_DATE EBCDIC SET_IDENTIFICATION NONE UT1 UT2 UT3 Command Qualifiers For Both Disks and Tapes /DEFAULT:arg /FILE_PROTECTION:(code) SAVE /FOREIGN NOUNLOAD /OVERRIDE:IDENTIFICATION UNLOAD /PARAMETERS:"user parameters" /PROCESSOR:arg /PROTECTION:(code) acpname /PUBLIC UNIQUE /[NO]SHAREABLE /SHOW /SYSTEM (synonym for /PUBLIC) /VOLUME:(volume-ID[s]) /[NO]WAIT /[NO]WRITE 3 EXAMPLES Mounting of magtape volumes is handled by a special ACP, the MTAACP. This ACP handles not only magtapes that meet the ANSI standard, but also the most commonly encountered unlabelled tape formats. The MOUNT command can only mount a single random-addressable volume, but magtapes can be mounted by the set. In fact, when you mount a single magtape, you are mounting a set consisting of only one tape. A magtape set consists of logically related records written on one or more individual reels of tape. Only the first tape in the set need be loaded on a device at the time the MOUNT command is issued. However, all tapes in the set can be loaded on different devices at the time the MOUNT command is issued. Therefore, the terminology used for mounting magtapes is somewhat different from that used in mounting disks. The tape set is identified by a File Set Identifier (fileset-ID). Each individual tape in the fileset is identified by a Volume Identifier (volume-ID). By default, the fileset-ID is the same as the volume-ID of the first individual reel of tape in the set. If you wish to use a fileset-ID other than the volume-ID of the first reel in the set, you can do on the first mount of a newly initialized tape as shown an example below. Each installation using magtapes extensively will have policies on fileset-IDs and volume-IDs. See your system manager or supervisor for information on how they are used in your installation. The examples establish the relationship between fileset-ID and volume-IDs. The following command >MOUNT MM0: FOO mounts a tape set (consisting of a single physical reel) whose fileset-ID is FOO and whose volume-ID is FOO. The reel FOO must be loaded on device MM0: at the time of the mount. The following command >MOUNT MM0: DRAG /VOLUME_IDENTIFICATION:(FOO,BAR,MORE) mounts a tape set whose fileset-ID is DRAG and that consists of three physical reels with volume-IDs of FOO, BAR, and MORE. The reel with the volume-ID FOO must be loaded on device MM0:, but the other two reels are not loaded at the time of the mount. The fileset-ID of the tape set was established with the first mount of the newly initialized tape set, using this same command. If this were the first mount, the fileset-ID DRAG would be established by the MOUNT command, but the actual change of the fileset-ID (from the default of FOO) does not take place until the first record is written to the tape. The command >MOUNT/OVERRIDE:SET_IDENTIFICATION MM0: (FOO,BAR,MORE) mounts a tape set whose fileset-ID is immaterial and that consists of three physical reels with volume-IDs of FOO, BAR, and MORE. The reel FOO must be loaded on device MM0:, but the other two reels are not loaded at the time of the mount. The following command >MOUNT MM0: FOO /VOLUMEID=(A312,A387,B231) mounts a tape set whose fileset-ID is FOO and that consists of three physical reels with volume-IDs A312,A387, and B231. The reel A312 must be loaded on device MM0:, but the other two reels are not loaded at the time of the mount. The following command >MOUNT (MM0:,MM1:,MM2:) (FOO,BAR,MORE) mounts a tape set whose fileset-ID is FOO and that consists of three physical reels with volume-IDs FOO, BAR, and MORE. At the time of the mount, the reel FOO must be loaded on device MM0:, the reel BAR must be loaded on device MM1:, and the reel MORE must be loaded on device MM2:. There is no theoretical limit to the number of physical tape reels in a set, but your DCL MOUNT command must translate to an MCR MOU command of 80 characters or fewer. There are, therefore, mounts that are permitted by the system, but that cannot be translated successfully from DCL to MCR within that limit. This means that in those cases, you cannot use the DCL MOUNT command, but must use the MCR MOU. 2 ACP #PROCESSOR 2 UNIQUE #PROCESSOR 2 PROCESSOR MOUNT/PROCESSOR:arg ddnn: volumelabel acpname UNIQUE Specifies the name of the ACP you wish to use to support file activity on the volume. In most cases, you can use the default ACP. The default ACP depends on the the device type. You only have to specify an ACP in special cases. If an ACP has been written for a custom application in your installation, you will need to use that ACP for volumes used by that application. You will also have to include the /FOREIGN qualifier in this case. You may also need to use the /PARAMETERS qualifier to enter parameters used by that ACP. The UNIQUE argument specifies that a dedicated ACP is to be used for the volume being mounted. MOUNT creates a copy of the F11ACP if the device is a disk or DECtape, or of the MTAACP, if the device is a magtape. This unique ACP will be given a name of the form ddnnF1 or ddnnAP. When the volume is dismounted and the file processor exits, the ACP is automatically removed. On RSX-11M-PLUS only, if the ACP (F11ACP or MTAACP) is installed in secondary pool, /PROCESSOR:UNIQUE is the default. If you specify the UNIQUE argument naming a foreign ACP, that ACP is created and dedicated to your volume. If you name a foreign ACP, you need the /FOREIGN qualifier. You may also need the /PARAMETERS qualifier. You cannot name an ACP with the UNIQUE argument. The documentation is in error. 2 DENSITY MOUNT/DENSITY:arg ddnn:[,ddnn:...] fileset-ID 800 1600 6250 LOW HIGH The /DENSITY qualifier specifies the density at which a magnetic tape is to be written. If the specified tape unit does not support the density given, the command is rejected. 2 EXTENSION MOUNT/EXTENSION:n ddnn: volumelabel The /EXTENSION qualifier specifies the default number of blocks by which a file will be extended when it has exhausted its allotted space. The default is whatever value was specified when the volume was initia- lized. This qualifier may be used to override the initialization value. 2 FILE_CONTROL_BLOCKS #ACCESSED 2 ACCESSED MOUNT/ACCESSED:n ddnn: volumelabel Specifies the approximate number of directories that will be accessed simultaneously during the mount. Legal values for n range from 1 through 127. F11ACP maintains a list of most recently used directories. The value specified for /ACCESSED sets the number of entries in this list. In general, directory operations can be significantly speeded up by increasing this value. If a directory appears in the list, no disk I/O is required to find the directroy in the MFD. In addition, directory operations take place without the necessity of reading the directory file header. If this qualifier is not explicitly stated, the default is the value specified at the time the volume was initialized. Note that increasing the /ACCESSED value increases the amount of system pool used. 2 FOREIGN MOUNT/FOREIGN ddnn: Specifies that the volume being mounted is not in Files-11 format. Such volumes are called foreign volumes. Note that before a disk or tape has been initialized, it is a foreign volume. This qualifier functions slightly differently on RSX-11M and RSX-11M-PLUS. On RSX-11M, /FOREIGN is recommended, but not required when using foreign volumes. If you don't mount the volume, access to the volume is unrestricted. If you mount a foreign volume /FOREIGN, no one else can access it. If you include /FOREIGN when mounting the foreign volume /SHAREABLE, then other users must also mount the volume to access it. On RSX-11M-PLUS, all volumes must be mounted. This qualifier is required for mounting foreign volumes. Since a foreign format is unknown to the system, no label is specified on the command line. 2 NOUNLOAD #DEFAULT 2 EXPIRATION_DATE #OVERRIDE 2 IDENTIFICATION #OVERRIDE 2 OVERRIDE MOUNT/OVERRIDE:EXPIRATION_DATE ddnn: volumelabel IDENTIFICATION ddnn: The /OVERRIDE:EXPIRATION_DATE qualifier allows you to override the expiration date of an ANSI standard magtape. The /OVERRIDE:IDENTIFICATION qualifier allows you to mount a Files-11 volume without specifying a volume identification. This is a privileged option. 2 OWNER MOUNT/OWNER:[g,m] ddnn: volumelabel Specifies the owner of the volume. The brackets are required syntax. Inclusion of this qualifier overrides the OWNER value established when the volume was initialized. The /OWNER interacts with the protection established for the file and the volume. See HELP MOUNT PROTECTION and HELP MOUNT FILE_PROTECTION. 2 PARAMETERS MOUNT/FOREIGN/ACP:acpname/PARAMETERS:"user parameters" ddnn: volumelabel Enables you to enter commands to an ACP that is not DIGITAL standard. A maximum of 40 characters enclosed in quotation marks can be passed to a foreign ACP. This qualifier is valid on RSX-11M systems only with the /ACP qualifier. The /FOREIGN qualifier is recommended in this case for RSX-11M systems and required for RSX-11M-PLUS systems. 2 FILE_PROTECTION MOUNT/FILE_PROTECTION:(code) ddnn: volumelabel Specifies the default file protection for any new files created on the volume while it is mounted. The /FILE_PROTECTION qualifier combines with /OWNER to control access to files. The file-protection code is enclosed in parentheses in the form (SYSTEM:RWED,OWNER:RWED,GROUP:RWED,WORLD:R) where R means allow read access to file W means allow write access to file E means allow file to be extended D means allow file to be deleted See also HELP MOUNT PROTECTION for information on volume protection. The default file protection can be overridden by specifying another protection when the file is created. If this qualifier is not included, the value specified at the time the volume was initialized is applied. For ANSI magtapes, this qualifier specifies the protection applied to the volume. See the RSX-11M/M-PLUS I/O Operations Manual for further information on the translation from this coding to ANSI label coding. 2 PROTECTION MOUNT/PROTECTION:(code) ddnn: volumelabel Specifies the volume protection for Files-11 disks. This protection overrides the volume protection established when the volume was initialized. The /PROTECTION qualifier combines with the /OWNER qualifier to control access to the volume. The file-protection code is enclosed in parentheses in the form (SYSTEM:RWED,OWNER:RWED,GROUP:RWED,WORLD:R) where R means allow read access to file W means allow write access to file E means allow file to be extended D means allow file to be deleted See also HELP MOUNT FILE_PROTECTION for information on setting the default protection for new files created on the volume while mounted. 2 SHOW MOUNT/SHOW ddnn: volumelabel The /SHOW qualifier specifies that volume information for the volume being mounted be displayed on the entering terminal. Here is the display format for disks and other random-addressable devices: Volume Information Class: Files-11 or Foreign Device: ddnn: Volume label: label Pack Serial: serial number supplied by manufacturer Owner: [g,m] (volume owner, override with /OWNER) Protection: code (volume protection) Default: code (default file protection) Processor: acpname The information displayed by /SHOW is similar for magtapes. If multiple tape volumes are being mounted, the device and volume label information is repeated for each volume. The Protection and Default fields are omitted from the volume information for magtapes. 2 UNLOAD #DEFAULT 2 DEFAULT MOUNT/DEFAULT:arg ddnn: volumelabel SAVE NOUNLOAD UNLOAD This qualifier is for RSX-11M-PLUS systems only. It applies to DB:, DM: and DU: devices only. Specifies the default that will apply when the volume is dismounted. SAVE is a privileged argument and specifies that the medium is not unloaded and can be accessed for reads and writes by privileged tasks. UNLOAD specifies that the medium is to be unloaded after the dismount. This is the default for Files-11 volumes. NOUNLOAD specifies that the medium is not to be unloaded. This is the default for foreign volumes. Remember, these values can also be set when you issue the DISMOUNT command. See also HELP DISMOUNT. 2 UNLOCK MOUNT/UNLOCK ddnn: volumelabel Specifies that the volume index file, [0,0]INDEXF.SYS, is unlocked. This means the file can be read and written to. Normally, this file is locked and can be read only. This qualifier has nothing to do with hardware or software writelocking. Its main use is in conjunction with VFY, the File Structure Verification Utility. 2 WINDOWS MOUNT/WINDOWS:arg ddnn: volumelabel n FULL (USER:n,INDEX:n) The /WINDOWS qualifier specifies the number of mapping pointers to be allocated for file windows. A file window consists of a number of mapping pointers; it is stored in memory when the file is opened. The argument n specifies a default for all files opened on the volume. n can be from 1 through 129. The USER and INDEX arguments can be combined or specified singly. USER:n specifies the user default value for the volume. INDEX:n specifies the number of pointers to allocate to the index file window. The argument FULL specifies that you want windows created that map as much of the file as possible. FULL can also replace n for USER and INDEX. The default value is set when the volume is initialized. This qualifer may be used to override the initialization default. 2 SYSTEM #PUBLIC 2 PUBLIC MOUNT/PUBLIC ddnn: volumelabel MOUNT/SYSTEM ddnn: volumelabel These two qualifiers are synonyms. They are privileged. Specifies that the mounted volume be available to all users who are allowed access under the volume-protection and file-protection codes established for the volume when mounted. If you state this qualifier explicitly when mounting a volume on an allocated (private) device, the device is automatically deallocated and set public, if necessary. If you do not state this qualifier explicitly, and the device is already set public, the mount will default to /PUBLIC. See also HELP MOUNT SHAREABLE, HELP ALLOCATE, and HELP SET DEVICE. 2 NOSHAREABLE #SHAREABLE 2 SHAREABLE MOUNT/[NO]SHAREABLE ddnn: volumelabel Specifies whether the volume is to be mounted shareable. A volume mounted /SHAREABLE can be mounted multiple times by the same or different users. Each user's access is determined by the volume-protection and file-protection codes established for the volume when mounted. If you mount the volume /SHAREABLE and the device is allocated or set public, the device is automatically deallocated or set nonpublic. A volume mounted /NOSHAREABLE is dedicated for your private use. No other user can access the volume. For Files-11 volumes mounted /NOSHAREABLE, your privileges are SYSTEM privileges. If you specify /NOSHAREABLE explicitly when mounting a volume on an device, the device is automatically allocated and set nonpublic, if necessary. If the device is already allocated, the mount defaults to /NOSHAREABLE. If the device is not allocated or set public, the default is /SHAREABLE. If the device is set public, the default is /PUBLIC (Synonym: /SYSTEM). See also HELP MOUNT PUBLIC, HELP ALLOCATE and HELP SET DEVICE. 2 NOWAIT #WAIT 2 WAIT MOUNT/[NO]WAIT ddnn: volumelabel Specifies whether you require operator assistance in performing the mount. The main use of this qualifier is for batch jobs, indirect command files, or terminals distant from the machine room. The default is /WAIT for mounts in batch jobs and indirect command files, and /NOWAIT for interactive mounts. If the mount is included in a batch job or indirect command file, or if you specify /WAIT in an interactive mount, a message concerning the mount is sent to the operator's console and the mount is not completed until the operator takes action. If you specify /NOWAIT in a batch job or indirect command file, or if the mount is interactive, no message appears. The medium must have been previously placed on the device and readied for access (spun up/on-line). Batch processing is available on RSX-11M-PLUS systems only. 2 NOWRITE #WRITE 2 WRITE MOUNT/[NO]WRITE ddnn: volumelabel Specifies whether the volume is to be write-protected. The default is /WRITE. If /WRITE is specified or implied, the volume can be written to as permitted by the volume-protection and file-protection codes established for the volume when mounted. If /NOWRITE is specified, no one may write to the volume. 2 VOLUME MOUNT/VOLUME:(volumeID[,volumeID[s]) Specifies volume identifiers. If you wish to check volume-IDs, you must specify this qualifier. If, for magtapes, the fileset-ID is not the same as the volume-ID of the first tape in the set, you must use this qualifier and include all volume-IDs in the set. See HELP MOUNT MAGTAPE EXAMPLES. 2 FORTRAN #CARRIAGE_CONTROL 2 LIST #CARRIAGE_CONTROL 2 CARRIAGE_CONTROL MOUNT/CARRIAGE_CONTROL:arg ddnn:[,ddnn:...] fileset-ID FORTRAN LIST NONE Specifies the record type for an unlabelled tape. The arguments correspond to the FORTRAN keywords for the OPEN statement. This qualifier also works on ANSI Level 1 or 2 magtapes, that is, those without HDR2 records (labels). This qualifier also works for ANSI Level 3 magtates that do not have a system code (HDR1 CP 61) beginning in DEC or OS. 2 BLOCK_SIZE MOUNT/BLOCK_SIZE:n ddnn:[,ddnn:...] fileset-ID Specifies the block size in characters for unlabelled magtapes at the time of the mount. Values for n can be from 18 through 16000. This qualifier also works on ANSI Level 1 or 2 magtapes, that is, those without HDR2 records (labels). 2 NOHDR3 #HDR3 2 HDR3 MOUNT/[NO]HDR3 ddnn:[,ddnn:...] fileset-ID Specifies whether an HDR3 label is to be written when creating new files. The /NOHDR3 qualifier is needed only in the situation where it is known that the target system cannot handle a tape with an HDR3 label. This qualifier has no other effect or application. The default is /HDR3. 2 NOLABEL #LABEL 2 LABEL MOUNT/[NO]LABEL ddnn:[,ddnn:...] fileset-ID Specifies whether the tape volume is ANSI or unlabelled. An ANSI tape is specified by the /LABEL qualifier. This is the default. An unlabelled tape is specified by the /NOLABEL qualifier. 2 RECORD_SIZE MOUNT/RECORD_SIZE:n ddnn:[,ddnn:...] fileset-ID Specifies the record size in characters for unlabelled magtape. The value for n can be from 1 through the value for blocksize on the volume. 2 EBCDIC #TRANSLATE 2 UT1 #TRANSLATE 2 UT2 #TRANSLATE 2 UT3 #TRANSLATE 2 TRANSLATE MOUNT/TRANSLATE:arg ddnn:[,ddnn:...] fileset-ID NONE UT1 UT2 UT3 Specifies the character translation to take place for reading from and writing to the mounted unlabelled tape volume. NONE specifies no translation, and is the default. EBCDIC specifies translation to ASCII from EBCDIC for writes and EBCDIC to ASCII for reads. Note that the translation is not one-to-one because some characters are found only in EBCDIC or only in ASCII. UT1, UT2, or UT3 specify user-supplied translation tables that have been previously linked into the MTAACP. See the RSX-11M/M-PLUS I/O Operations Manual for further information on character translation. 2 ACCESSIBILITY #OVERRIDE 2 EXPIRATION_DATE #OVERRIDE 2 IDENTIFICATION #OVERRIDE 2 SET_IDENTIFICATION #OVERRIDE 2 OVERRIDE Mounting Disks or other Files-11 Volumes MOUNT/OVERRIDE:IDENTIFICATION ddnn: volumelabel Mounting Magtapes MOUNT/OVERRIDE:(arg[,arg[s]) ddnn:[,ddnn:...] fileset-ID ACCESSIBILITY EXPIRATION_DATE IDENTIFICATION SET_IDENTIFICATION This is a privileged qualifier. /OVERRIDE:IDENTIFICATION allows privileged users to mount a volume without using the volume label (or the fileset ID for magtape). For magnetic tapes, /OVERRIDE specifies that you wish to override one or more characteristics of a tape volume that are normally checked when you mount a magtape. The parentheses are optional if you wish to specify only one argument. If you wish to specify more than one argument, the arguments must be enclosed in parentheses and separated by commas. The ACCESSIBILITY argument specifies that you wish to override the protection on ANSI magtapes. The EXPIRATION_DATE argument specifies that you wish to override the expiration date on ANSI magtapes. The IDENTIFICATION argument specifies that you wish to mount the tape or tape set without specifying a fileset-ID. By default, the fileset-ID is the volume-ID of the first tape reel in the set. The SET_IDENTIFICATION argument specifies that you wish to mount a tape or tape set that does not follow ANSI standard. This argument is not otherwise needed.