INITIALIZE, Qualifiers
*Conan The Librarian (sorry for the slow response - running on an old VAX)
|
VMS Help INITIALIZE, Qualifiers *Conan The Librarian (sorry for the slow response - running on an old VAX) |
|
1 - /ACCESSED
/ACCESSED=number-of-directories
Affects Files-11 On-Disk Structure Level 1 disks only.
Specifies that, for disk volumes, the number of directories
allowed in system space must be a value from 0 to 255. The
default value is 3.
2 - /BADBLOCKS
/BADBLOCKS=(area[,...])
Specifies, for disk volumes, faulty areas on the volume. The
INITIALIZE command marks the areas as allocated so that no data
is written in them.
Possible formats for area are as follows:
lbn[:count] Logical block number (LBN) of the first block
and optionally a block count beginning with the
first block, to be marked as allocated
sec.trk.cyl[:cnt] Sector, track, and cylinder of the first block,
and optionally a block count beginning with the
first block, to be marked as allocated
All media supplied by Compaq and supported on the OpenVMS
operating system, except diskettes and TU58 cartridges, are
factory formatted and contain bad block data. The Bad Block
Locator utility (BAD) or the diagnostic formatter EVRAC can be
used to refresh the bad block data or to construct it for the
media exceptions above. The /BADBLOCKS qualifier is necessary
only to enter bad blocks that are not identified in the volume's
bad block data.
DIGITAL Storage Architecture (DSA) disks (for example, disks
attached to UDA-50 and HSC50 controllers) have bad blocks handled
by the controller, and appear logically perfect to the file
system.
For information on how to run BAD, refer to the OpenVMS Bad Block
Locator Utility Manual (available on the Documentation CD-ROM).
3 - /CLUSTER_SIZE
/CLUSTER_SIZE=number-of-blocks
Defines, for disk volumes, the minimum allocation unit in blocks.
The maximum size you can specify for a volume is 16382 blocks, or
1/50th the volume size, whichever is smaller.
For Files-11 On-Disk Structure Level 5 (ODS-5) disks, the default
cluster size is 3. In this case the minimum value allowed by the
following equation is applied:
(disk size in number of blocks)/(65535 * 4096)
Any fractional values must be rounded up to the nearest integer.
For Files-11 On-Disk Structure Level 2 (ODS-2) disks, the default
cluster size depends on the disk capacity; disks with less
than 50,000 have a default of 1. Disks that are larger than
50,000 have a default of either 3 or the result of the following
formula, whichever is greater:
(disk size in number of blocks)/(255 * 4096)
Any fractional values must be rounded up to the nearest integer.
For Files-11 On-Disk Structure Level 1 (ODS-1) disks, the cluster
size must always be 1.
NOTE
For Version 7.2, you can specify a cluster size for ODS-2
volumes smaller than allowed by the ODS-2 formula; however,
if you try to mount this volume on a system running a
version prior to 7.2, the mount fails with the following
error:
%MOUNT-F-FILESTRUCT, unsupported file structure level
If you choose the default during the initialization of a
Files-11 On-Disk Structure Level 2 (ODS-2) disk, your disk
can be mounted on prior versions of OpenVMS.
4 - /DATA_CHECK
/DATA_CHECK[=(option[,...])]
Checks all read and write operations on the disk. By default,
no data checks are made. Specify one or both of the following
options:
READ Checks all read operations.
WRITE Checks all write operations; default if only the /DATA_
CHECK qualifier is specified.
To override the checking you specify at initialization for disks,
enter a MOUNT command to mount the volume.
5 - /DENSITY
/DENSITY=density-value
Allows you to specify the format density value for certain tapes
and disks.
For magnetic tape volumes, specifies the density in bits per inch
(bpi) at which the magnetic tape is to be written. The density
value specified can be 800 bpi, 1600 bpi, or 6250 bpi, as long as
the density is supported by the magnetic tape drive.
If you do not specify a density value for a blank magnetic tape,
the system uses a default density of the highest value allowed
by the tape drive. If the drive allows 6250-, 1600-, and 800-bpi
operation, the default density is 6250 bpi.
If you do not specify a density value for a magnetic tape that
has been previously written, the system uses the density of the
first record on the volume. If the record is unusually short, the
density value will not default.
The /DENSITY qualifier does not apply to any TF tape device.
Valid tape density values are:
Keyword Meaning
DEFAULT Default density
800 NRZI 800 bits per inch (BPI)
1600 PE 1600 BPI
6250 GRC 6250 BPI
3480 IBM 3480 HPC 39872 BPI
3490E IBM 3480 compressed
833 DLT TK50: 833 BPI
TK50 DLT TK50: 833 BPI
TK70 DLT TK70: 1250 BPI
6250 RV80 6250 BPI EQUIVALENT
NOTE: Only the keywords above are understood by TMSCP/TUDRIVER
code prior to OpenVMS Version 7.2. The remaining keywords
in this table are supported only on Alpha systems.
TK85 DLT Tx85: 10625 BPI - Cmpt III - Alpha only
TK86 DLT Tx86: 10626 BPI - Cmpt III - Alpha only
TK87 DLT Tx87: 62500 BPI - Cmpt III - Alpha only
TK88 DLT Tx88: (Quantum 4000) - Cmpt IV - Alpha only
TK89 DLT Tx89: (Quantum 7000) - Cmpt IV - Alpha only
QIC All QIC drives are drive-settable only - Alpha only
8200 Exa-Byte 8200 - Alpha only
8500 Exa-Byte 8500 - Alpha only
DDS1 Digital Data Storage 1 - 2G - Alpha only
DDS2 Digital Data Storage 2 - 4G - Alpha only
DDS3 Digital Data Storage 3 - 8-10G - Alpha only
DDS4 Digital Data Storage 4 - Alpha only
AIT1 Sony Advanced Intelligent Tapes - Alpha only
To format a diskette on RXnn diskette drives, use the
INITIALIZE/DENSITY command. Specify the density at which the
diskette is to be formatted as follows:
Keyword Meaning
single RX01 - 8 inch
double RX02 - 8 inch
dd double density: 720K - 3 1/2 inch
hd high density: 1.44MB - 3 1/2 inch
ed extended density: 2.88MB - 3 1/2 inch
If you do not specify a density value for a diskette being
initialized on a drive, the system leaves the volume at the
density to which the volume was last formatted.
NOTE
Diskettes formatted in double density cannot be read or
written by the console block storage device (an RX01 drive)
of a VAX-11/780 until they have been reformatted in single
density.
RX33 diskettes cannot be read from or written to by RX50
disk drives. RX50 diskettes can be read from and written to
by RX33 disk drives; they cannot be formatted by RX33 disk
drives.
6 - /DIRECTORIES
/DIRECTORIES=number-of-entries
The effect of this qualifier depends on the disk structure:
o For ODS-1, /DIRECTORIES allows space for the specified number
of directory entries to be reserved in 000000.DIR (the MFD).
o For ODS-2 and ODS-5, /DIRECTORIES allows the initial size of
the MFD to be set. The specified number is divided by 16, to
produce the number of blocks to preallocate. This number is
then rounded up to a whole number of clusters.
The number-of-entries value must be an integer between 16 and
16000. The default value is 16.
7 - /ERASE
/ERASE
/NOERASE (default)
Physically destroys deleted data by writing over it. Controls
the data security erase (DSE) operation on the volume before
initializing it. The /ERASE qualifier applies to Files-11 On-Disk
Structure Level 2 and 5 disks and ANSI magnetic tape volumes,
and is valid for magnetic tape devices that support the hardware
erase function, such as TU78 and MSCP magnetic tapes.
If you specify the /ERASE qualifier, a DSE operation is performed
on the volume. For disk devices, the ERASE volume attribute is
set. In effect, each file on the volume is erased when it is
deleted.
Note that the amount of time taken by the DSE operation depends
on the volume size; the INITIALIZE/ERASE command is always slower
than the INITIALIZE/NOERASE command.
8 - /EXTENSION
/EXTENSION=number-of-blocks
Specifies, for disk volumes, the number of blocks to use as a
default extension size for all files on the volume. The extension
default is used when a file increases to a size greater than its
initial default allocation during an update. For Files-11 On-
Disk Structure Level 2 disks, the value for the number-of-blocks
parameter can range from 0 to 65,535. The default value is 5.
For Files-11 On-Disk Structure Level 1 disks, the value can range
from 0 to 255.
The OpenVMS operating system uses the default volume extension
only if no different extension has been set for the file and no
default extension has been set for the process by using the SET
RMS_DEFAULT command.
9 - /FILE_PROTECTION
/FILE_PROTECTION=code
Affects Files-11 On-Disk Structure Level 1 disks only.
Defines for disk volumes the default protection to be applied to
all files on the volume.
Specify the code according to the standard syntax rules described
in the OpenVMS Guide to System Security. Any attributes not
specified are taken from the current default protection.
Note that this attribute is not used when the volume is
being used on an OpenVMS system, but is provided to control
the process's use of the volume on RSX-11M systems. OpenVMS
systems always use the default file protection. Use the
SET PROTECTION/DEFAULT command to change the default file
protection.
10 - /GROUP
Used in conjunction with the /NOSHARE qualifier to create
a group volume. The group volume allows access by system
(S), owner (O), and group (G) accessors. The protection is
(S:RWCD,O:RWCD,G:RWCD,W).
The owner user identification code (UIC) of the volume defaults
to your group number and a member number of 0.
11 - /HEADERS
/HEADERS=number-of-headers
Specifies, for disk volumes, the number of file headers to be
allocated for the index file. The minimum and default value
is 16. The maximum is the value set with the /MAXIMUM_FILES
qualifier.
This qualifier is useful when you want to create a number of
files and want to streamline the process of allocating space
for that number of file headers. If you do not specify this
qualifier, the file system dynamically allocates space as it
is needed for new headers on the volume.
NOTE
The default value for the /HEADERS qualifier is generally
insufficient for ODS-2 disks. To improve performance and
avoid SYSTEM-F-HEADERFULL errors, Compaq recommends that
you set this value to be approximately the number of files
that you anticipate having on your disk; however, grossly
overestimating this value will result in wasted disk space.
The /HEADERS qualifier controls how much space is initially
allocated to INDEXF.SYS for headers. Each file on a disk requires
at least one file header and each header occupies one block
within INDEXF.SYS. Files that have many Access Control Entries
(ACE) or are very fragmented may use more than one header.
The default value of 16 leaves room for less than 10 files to be
created before INDEXF.SYS must extend; therefore, try to estimate
the total number of files that will be created on the disk and
specify it here. This will improve disk access performance.
Overestimating the value may lead to wasted disk space. This
value cannot be changed without reinitializing the volume.
INDEXF.SYS is limited as to how many times it may extend. When
the map area in its header (where the retrieval pointers are
stored) becomes full, file creation fails with the message
"SYSTEM-W-HEADERFULL."
12 - /HIGHWATER
/HIGHWATER (default)
/NOHIGHWATER
Affects Files-11 On-Disk Structure Level 2 disks only.
Sets the file high-water mark (FHM) volume attribute, which
guarantees that users cannot read data that they have not
written. You cannot specify the /NOHIGHWATER qualifier for
magnetic tape.
The /NOHIGHWATER qualifier disables FHM for a disk volume.
13 - /HOMEBLOCKS
/HOMEBLOCKS=option
This qualifier applies only to Files-11 ODS-2 volumes.
It specifies where the volume's homeblock and spare copy of the
homeblock are placed on disk. The value of option can be one of
the following:
o GEOMETRY
Causes the homeblocks to be placed at separate locations on
disk, to protect against failure of a disk block. Placement
depends on the reported geometry of the disk.
o FIXED
Causes the homeblocks to be placed at separate fixed locations
on the disk; this is the default. Placement is independent
of the reported geometry of the disk. This caters for disks
that report different geometries according to which type of
controller they are attached to.
o CONTIGUOUS
Causes the homeblocks to be placed contiguously at the start
of the disk. This allows container file systems to maximize
the amount of contiguous space on the disk, when used with the
/INDEX=BEGINNING qualifier.
14 - /INDEX
/INDEX=position
Specifies the location of the index file for the volume's
directory structure. Possible positions are as follows:
BEGINNING Beginning of the volume
MIDDLE Middle of the volume (default)
END End of the volume
BLOCK:n Beginning of the logical block specified by n
15 - /INTERCHANGE
Specifies that the magnetic tape will be used for interchange in
a heterogeneous vendor environment. The /INTERCHANGE qualifier
omits the ANSI VOL2 labels. Under OpenVMS, the ANSI VOL2 labels
contain OpenVMS specific security attributes.
For more information on the /INTERCHANGE qualifier and on
magnetic tape labeling and tape interchange, refer to the OpenVMS
System Manager's Manual, Volume 1: Essentials.
16 - /LABEL
/LABEL=option
Defines characteristics for the magnetic tape volume label, as
directed by the included option. The available options are as
follows:
o OWNER_IDENTIFIER:"(14 ANSI characters)"
Allows you to specify the Owner Identifier field in the
volume label. The field specified can accept up to 14 ANSI
characters.
o VOLUME_ACCESSIBILITY:"character"
Specifies the character to be written in the volume
accessibility field of the OpenVMS ANSI volume label VOL1
on an ANSI magnetic tape. The character may be any valid
ANSI "a" character. This set of characters includes numeric
characters, uppercase letters, and any one of the following
nonalphanumeric characters:
! " % ' ( ) * + , - . / : ; < = > ?
By default, the OpenVMS operating system provides a routine
that checks this field in the following manner:
o If the magnetic tape was created on a version of the
OpenVMS operating system that conforms to Version 3
of ANSI, then this option must be used to override any
character other than an ASCII space.
o If a 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.
If you specify any character other than the default, you
must specify the /OVERRIDE=ACCESSIBILITY qualifier on the
INITIALIZE and MOUNT commands in order to access the magnetic
tape.
17 - /MAXIMUM_FILES
/MAXIMUM_FILES=n
Restricts the maximum number of files that the volume can
contain. The /MAXIMUM_FILES qualifier overrides the default
value, which is calculated as follows:
(volume size in blocks)/((cluster factor + 1) * 2)
The maximum size you can specify for any volume is as follows:
(volume size in blocks)/(cluster factor + 1)
The minimum value is 0. Note that the maximum can be increased
only by reinitializing the volume.
NOTE
The /MAXIMUM_FILES qualifier does not reserve or create
space for new file headers on a volume. The file system
dynamically allocates space as it is needed for new headers.
18 - /MEDIA_FORMAT
/MEDIA_FORMAT=[NO]COMPACTION
Controls whether data records are automatically compacted and
blocked together on any device that supports data compaction.
Data compaction and record blocking increase the amount of data
that can be stored on a single tape cartridge.
Note that once data compaction or noncompaction has been selected
for a given cartridge, that same status applies to the entire
cartridge.
19 - /OVERRIDE
/OVERRIDE=(option[,...])
Requests the INITIALIZE command to ignore data on a magnetic tape
volume that protects it from being overwritten. You can specify
one or more of the following options:
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, OpenVMS provides a routine that
checks this field in the following manner. If the
magnetic tape was created on a version of OpenVMS
that conforms to Version 3 of ANSI, this option
must be used to override any character other than
an ASCII space. If a protection is specified and
the magnetic tape conforms to an ANSI standard
that is higher than Version 3, 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 may need to do this for magnetic
tapes that were created before VAX/VMS Version
4.0 on Digital operating systems using the D%
format in the volume Owner Identifier field. You
must have the user privilege VOLPRO to override
volume protection, or your UIC must match the UIC
written on the volume.
OWNER_ Allows you to override the processing of the
IDENTIFIER Owner Identifier field of the volume label.
If you specify only one option, you can omit the parentheses.
To initialize a volume that was initialized previously with the
/PROTECTION qualifier, your UIC must match the UIC written on the
volume or you must have VOLPRO privilege.
You can initialize a volume previously initialized with
/PROTECTION if you have control access.
20 - /OWNER_UIC
/OWNER_UIC=uic
Specifies an owner user identification code (UIC) for the volume.
The default is your default UIC. Specify the UIC using standard
UIC format as described in the OpenVMS Guide to System Security.
For magnetic tapes, no UIC is written unless protection on the
magnetic tape is specified. If protection is specified, but no
owner UIC is specified, your current UIC is assigned ownership of
the volume.
21 - /PROTECTION
/PROTECTION=(ownership[:access][,...])
Applies the specified protection to the volume:
o Specify the ownership parameter as system (S), owner (O),
group (G), or world (W).
o Specify the access parameter as read (R), write (W), create
(C), or delete (D).
The default is your default protection. Note that the /GROUP,
/SHARE, and /SYSTEM qualifiers can also be used to define
protection for disk volumes.
For magnetic tape, the protection code is written to an OpenVMS
specific volume label. The system applies only read (R) and
write (W) access restrictions; create and delete (D) access are
meaningless. Moreover, the system and the owner are always given
both read (R) and write (W) access to magnetic tapes, regardless
of the protection code you specify.
For more information on specifying protection code, refer to the
OpenVMS Guide to System Security. Any attributes not specified
are taken from the current default protection.
When you specify a protection code for an entire disk volume, the
access type E (execute) indicates create access.
22 - /SHADOW
/SHADOW=(device_name_1, device_name_2, device_name_3) label
Initializes multiple members of a future shadow set. Initializing
multiple members in this way eliminates the requirement of a full
copy when you later create a shadow set.
The INITIALIZE command with the /SHADOW and /ERASE qualifiers
performs the following operations:
o Formats up to six devices with one command, so that any three
can be subsequently mounted together as members of a new host-
based shadow set
o Writes a label on each volume
o Deletes all information from the devices except for the system
files containing identical file structure information. All
former contents of the disks are lost.
You can then mount up to three of the devices that you have
initialized in this way as members of a new host-based shadow
set.
Compaq strongly recommends that you use the /ERASE qualifier. By
using the /ERASE qualifier, no merge operation is required when
you create the shadow set with the MOUNT command.
All the devices must have identical, nonzero values for Total
Blocks. You can view the Total Blocks value by entering the
SHOW DEVICE/FULL command. If a device has never been mounted
or initialized on this system, the SHOW DEVICE/FULL command for
the device will not display a value for Total Blocks. To correct
this condition, either mount and then dismount the device,
or initialize the device. The Total Blocks value will then be
displayed by SHOW DEVICE/FULL.
Note that the INITIALIZE/SHADOW command should not be used to
initialize a disk to be added to an existing shadow set, as no
benefit is gained.
Additional information can be found in Volume Shadowing for
OpenVMS.
23 - /SHARE
/SHARE (default)
/NOSHARE
Permits all categories of access by all categories of ownership.
The /NOSHARE qualifier denies access to group (unless the /GROUP
qualifier is also specified) and world processes.
24 - /SIZE
/SIZE=n
Specifies the size of the DECram disk (device type DT$_RAM_DISK)
to be allocated from available memory. The size of the device is
created at disk initialization time.
To deallocate space, specify /SIZE=0. All resources specifically
allocated to the DECram disk are returned to the system.
Note that n cannot exceed 524,280 blocks either on a VAX system
or on versions of DECram prior to Version 2.3. DECram Version
2.3 running on an Alpha system supports up to 67,108,864 blocks,
equivalent to 32GB.
25 - /STRUCTURE
/STRUCTURE=level
Specifies whether the volume should be formatted in Files-11
On-Disk Structure Level 1, 2 (the default), or 5.
Structure Level 1 is incompatible with the /DATA_CHECK and
/CLUSTER_SIZE qualifiers. The default protection for a Structure
Level 1 disk is full access to system, owner, and group, and read
(R) access to all other users.
Note that Alpha does not support Files-11 On-Disk Structure Level
1 disks, and specifying 1 on Alpha results in an error. VAX does
not support Structure Level 5 disks, and specifying 5 on VAX
results in an error.
Refer to the OpenVMS Guide to Extended File Specifications for
more information about Structure Level 5 (ODS-5) disks.
26 - /SYSTEM
Requires a system UIC or SYSPRV (system privilege) privilege.
Defines a system volume. The owner UIC defaults to [1,1].
Protection defaults to complete access by all ownership
categories, except that only system processes can create top-
level directories.
27 - /USER_NAME
/USER_NAME=name
Specifies a user name to be associated with the volume. The name
must be 1 to 12 alphanumeric characters. The default is your user
name.
28 - /VERIFIED
/VERIFIED
/NOVERIFIED
Indicates whether the disk has bad block data on it. Use the
/NOVERIFIED qualifier to ignore bad block data on the disk. The
default is the /VERIFIED qualifier for disks with 4096 blocks or
more and the /NOVERIFIED qualifier for disks with less than 4096
blocks.
29 - /WINDOWS
/WINDOWS=n
Specifies the number of mapping pointers (used to access data in
the file) to be allocated for file windows. The value can be an
integer in the range of 7 to 80. The default is 7.
|
|
