HELP INITIALIZE — MicroVMS 4.4
Formats a disk or magnetic tape volume and writes a label on the volume. At the end of initialization, the volume is empty except for the system files containing the structure information. All former contents of the disk are lost. Format INITIALIZE device-name volume-label Requires VOLPRO privilege for most INITIALIZE operations.
Additional information available:
Parameters
device-name Name of the device on which the volume is physically mounted. volume-label Specifies the identification to be encoded on the volume. For a disk volume, you can specify a maximum of 12 alphanumeric characters; for a magnetic tape volume, you can specify a maximum of 6 alphanumeric characters. Letters are automatically changed to uppercase. Nonalphanumeric characters are not allowed in the volume-label specification on disk. In order to use ANSI "a" characters on the volume-label on magnetic magnetic tape, the volume name must be enclosed in quotation marks.
Qualifiers
Additional information available:
/ACCESSED/BADBLOCKS/CLUSTER_SIZE/DATA_CHECK
/DENSITY/DIRECTORIES/ERASE/EXTENSION/FILE_PROTECTION
/GROUP/HEADERS/HIGHWATER/INDEX/LABEL/MAXIMUM_FILES
/OVERRIDE/OWNER_UIC/PROTECTION/SHARE/STRUCTURE
/SYSTEM/USER_NAME/VERIFIED/WINDOWS
/ACCESSED=number-of-directories
Requires OPER privilege. Specifies the number of directories to be maintained in system space for ready access as an integer in the range 0 through 255. Defaults to 3.
/BADBLOCKS=(area,...)
Specifies faulty areas on a volume so that no data will be written to them. Possible formats for area are: +-------------------+--------------------------------------+ | lbn[:count] | Logical block number of the first | | | block and optionally a block count | | | beginning with the first block | +-------------------+--------------------------------------+ | sec.trk.cyl[:cnt] | Sector, track, and cylinder of the | | | first block, and optionally a | | | block count beginning with the | | | first block | +-------------------+--------------------------------------+
/CLUSTER_SIZE=number-of-blocks
Defines the minimum allocation unit in blocks. The maximum size is 1/100 of the volume size. The minimum size is 255*4096 divided into the disk size in blocks. Structure Level 2 disks smaller than 50,000 blocks have a default value of 1. Structure Level 1 disks must always have a cluster size of 1.
/DATA_CHECK[=(keyword,...)]
Checks all read and/or write operations on the disk. By default, no data checks are made. Specify one or both keywords: +---------+------------------------------------------------+ | READ | Checks all read operations | +---------+------------------------------------------------+ | WRITE | Checks all write operations; default if only | | | /DATA_CHECK is specified | +---------+------------------------------------------------+
/DENSITY=density-value
The /DENSITY qualifier is not applicable to the TK50 tape device. For floppy disk volumes that are to be initialized on RX02 dual-density disk drives, specifies the density at which the floppy disk is to be formatted. For magnetic tape volumes, specifies the density in bytes per inch (bpi) at which the magnetic tape is to be written. RX02 dual-density disk drives allow floppy disks to be initialized at single or double density. To specify single-density formatting of a floppy disk, specify the density value SINGLE. To specify double-density formatting of a floppy disk, specify the density value DOUBLE. If you do not specify a density value for a floppy disk being initialized on an RX02 drive, the system leaves the volume at the density to which the volme was last formatted. Floppy disks purchased from DIGITAL are formatted in single density. For magnetic tape volumes, 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. If the drive allows only 1600 and 800 BPI operation, then the default density is 1600. 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. The magnetic tape density will not default on an unusually short record.
/DIRECTORIES=number-of-entries
Allocates the specified number of entries for user directories as an integer in the range 16 through 16000. The default is 16.
/ERASE
/NOERASE (default) Physically destroys deleted data (by writing over it).
/EXTENSION=n
Specifies, for disk volumes, the number of blocks to use as a default extension size for all files on the volume. The value n can range from 0 through 65535. The default is 5. NOTE: This attribute is not used when the ODS-1 volume is being used on a VAX/VMS system, but is provided to control the process's use of the volume on RSX-11M systems.
/FILE_PROTECTION=code
Defines, for disk volumes, the default protection to be applied to all files on the volume. NOTE: This attribute is not used when the ODS-1 volume is being used on a VAX/VMS system, but is provided to control the process's use of the volume on RSX-11M systems.
/GROUP
Defines a group volume. The /GROUP qualifier applies protection of RWED to all ownership categories unless /GROUP is specified with /NOSHARE, in which case the volume protection is RWED for all but the world category. The owner UIC of the volume defaults to your group number and a member number of 0.
/HEADERS=number-of-headers
Specifies 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.
/HIGHWATER (default)
/NOHIGHWATER Sets the File Highwater Mark (FHM) volume attribute, which guarantees that a user cannot read data that he has not written. You cannot specify /NOHIGHWATER for magnetic tape.
/INDEX=keyword
Specifies the location of the index file for the volume's directory structure. Possible keywords are: +-----------+----------------------------------------------+ | BEGINNING | Beginning of the volume | +-----------+----------------------------------------------+ | MIDDLE | Middle of the volume (default) | +-----------+----------------------------------------------+ | END | End of the volume | +-----------+----------------------------------------------+ | BLOCK:n | Beginning of the logical block by the number | | | n | +-----------+----------------------------------------------+
/LABEL=option
Defines characteristics for the magnetic tape volume label, as
directed by the included option. The available options are as
follows:
OWNER_IDENTIFIER:"(14 ANSI characters)"
Specifies the Owner Identifier field in the volume label.
The field specified can accept up to 14 ANSI characters.
VOLUME_ACCESSIBILITY:"n"
Specifies the character to be written in the volume-accessibility
field of the MicroVMS ANSI volume label VOL1 on an ANSI magnetic
tape. N may be any valid ANSI "a" character and must be enclosed
in quotation marks. This set of characters includes numeric
characters, uppercase letters, and any one of the following
nonalphanumeric characters:
! " % ' ( ) * + , - . / : ; < = > ?
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 that of 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 character, you must specify the
/OVERRIDE=ACCESSIBILITY qualifier on the INITIALIZE and MOUNT commands
in order to access the magnetic tape.
/MAXIMUM_FILES=number-of-files
Restricts the maximum number of the 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: volume size in blocks --------------------- (cluster factor + 1) The minimum value is 0. Note that the maximum can be increased only by reinitializing the volume.
/OVERRIDE=(option,...)
Requests the INITIALIZE command to ignore data on a magnetic tape volume that protects it from being overwritten. You may specify one 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 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. | +------------------+--------------------------------------------------+ | OWNER_IDENTIFIER | Allows you to override the processing of the | | | Owner Identifier field of the volume label. | +------------------+--------------------------------------------------+ If you specify only one option, you may omit the parentheses. If you specify more than one option, separate them with commas and enclose the list in parentheses. In order 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.
/OWNER_UIC=uic
Specifies an owner UIC for the volume. The default is your default UIC.
/PROTECTION=(ownership[:access],...)
Applies the specified protection to the volume. The default is your default protection. The ownership categories are SYSTEM, OWNER, GROUP, WORLD; the access categories are R (read), W (write), E (create), and D (delete).
/SHARE (default)
/NOSHARE Permits all categories of access by all categories of ownership. The /NOSHARE qualifier denies access to group (unless /GROUP is also specified) and world processes.
/STRUCTURE=level
Specifies whether the volume should be formatted in Files-11 Structure Level 1 or Structure Level 2 (the default). Level 1 is incompatible with the /CLUSTER_SIZE and /DATA_CHECK qualifiers.
/SYSTEM
Requires a system UIC or SYSPRV 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.
/USER_NAME=name
Specifies a user name to be associated with the volume. The name must be 1 through 12 alphanumeric characters. The default is your user name.
/VERIFIED (default)
/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 /VERIFIED for disks with 4096 blocks or more and /NOVERIFIED for disks with less than 4096 blocks.
/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 can be an integer in the range 7 through 80. The default is 7.
/QUEUE
Creates a print or batch queue and assigns it a name and attributes. Format INITIALIZE/QUEUE queue-name Requires the Secure User Environment Option. Requires OPER privilege.
Additional information available:
Parameters
queue-name User-defined name of the queue. Queue-name may be up to 31 alphanumeric characters.
Qualifiers
Additional information available:
/BASE_PRIORITY/BATCH/BLOCK_LIMIT/CHARACTERISTICS
/CPUDEFAULT/CPUMAXIMUM/DEFAULT/DISABLE_SWAPPING
/ENABLE_GENERIC/FORM_MOUNTED/GENERIC/JOB_LIMIT
/LIBRARY/NOLIBRARY/ON/OWNER_UIC/PROCESSOR
/PROTECTION/RECORD_BLOCKING/RETAIN/SCHEDULE
/SEPARATE/START/TERMINAL/WSDEFAULT/WSEXTENT
/WSQUOTA
/BASE_PRIORITY=priority
Specifies the base process priority at which jobs are initiated from a batch queue or the base priority of the symbiont process for a printer, terminal, or server queue. The value can be an integer in the range 0 through 15. The base priority defaults to the same priority as the base priority established by DEFPRI at system generation (usually 4).
/BATCH
/NOBATCH (default) Specifies that the queue is a batch queue.
/BLOCK_LIMIT=([lower,]upper)
/NOBLOCK_LIMIT (default)
Restricts the size of print jobs that can be executed on a printer or
terminal queue. The lower parameter specifies the minimum number of
blocks that will be accepted by the queue for a print job. The upper
parameter specifies the maximum number of blocks that will be accepted
by the queue for a print job. If a job contains fewer blocks than the
number specified by the lower parameter or more blocks than the number
specified by the upper parameter, the job remains pending until the
block limit for the queue is changed. To specify only the lower
parameter, you must use two sets of quotation marks ("") in place of
the upper specifier.
/CHARACTERISTICS=(characteristic,...)
/NOCHARACTERISTICS (default) Specifies one or more characteristics for processing jobs on the queue. (Use the SHOW QUEUE/CHARACTERISTIC command to display the available characteristics.) A queue must have all the characteristics specified for a job or the job remains pending.
/CPUDEFAULT=time
Specifies the default CPU time limit for batch jobs. Time can be specified as a delta time, 0, NONE (the default), or INFINITE. Both the value 0 and the keyword INFINITE allow unlimited CPU time (subject to the restrictions imposed by the /CPUMAXIMUM qualifier or the user authorization file).
/CPUMAXIMUM=time
Specifies the maximum CPU time limit for batch jobs. The /CPUMAXIMUM qualifier overrides the time limit specified in the user authorization file (UAF). Time can be specified as a delta time, 0, NONE (the default), or INFINITE. Both the value 0 and the keyword INFINITE allow unlimited CPU time.
/DEFAULT=(option,...)
/NODEFAULT Establishes default options for the PRINT command. The /DEFAULT qualifier cannot be used with the /GENERIC qualifier. Possible options are: +-----------------------+--------------------------------------------+ | [NO]BURST[=keyword] | Specifies where to print burst pages | | | (flag pages that are printed over the | | | paper's perforations for easy | | | identification of individual files in a | | | print job.) The keyword ALL (the default) | | | places burst pages before each printed | | | file in the job. The keyword ONE places | | | a burst page before the first printed | | | file in the job. | +-----------------------+--------------------------------------------+ | [NO]FEED | Specifies whether a form-feed is | | | automatically inserted at the end of a | | | page. (default) | +-----------------------+--------------------------------------------+ | [NO]FLAG[=keyword] | Specifies where to print flag pages | | | (containing the job entry number, the | | | name of the user submitting the job, and | | | so on). The keyword ALL (the default) | | | places flag pages before each printed | | | file in the job. The keyword ONE places a | | | flag page before the first printed file | | | in the job. | +-----------------------+--------------------------------------------+ | FORM=type | Specifies the default form for a printer, | | | terminal, or server queue. If a job is | | | not submitted with an explicit form | | | definition, then this form will be used to | | | process the job. The system-wide default | | | form, form=0, is the default value for | | | this keyword. See also /FORM_MOUNTED. | +-----------------------+--------------------------------------------+ | [NO]TRAILER[=keyword] | Specifies where to print trailer pages. | | | The keyword ALL (the default) places | | | trailer pages after each printed file in | | | the job. The keyword ONE places a | | | trailer page after the last printed file | | | in the job. | +-----------------------+--------------------------------------------+ If you specify any of the keywords BURST, FLAG, TRAILER without specifying a value, the value ALL is used by default.
/DISABLE_SWAPPING
/NODISABLE_SWAPPING (default) Inhibits swapping for batch jobs.
/ENABLE_GENERIC (default)
/NOENABLE_GENERIC Determines whether or not a queue will accept files from a generic queue of the same type (where the generic queue was initialized without a queue name specified with the /GENERIC qualifier).
/FORM_MOUNTED=type
Specifies the form type for a printer, terminal, or server queue. If the stock of the mounted form is not identical to the stock of the default form, as indicated by the DCL command qualifier /DEFAULT=FORM=type, then all jobs submitted to this queue without an explicit form definition will enter a pending state. If a job is submitted with an explicit form and the stock of the explicit form is not identical to the stock of the mounted form, then the job will enter a pending state. In both cases, the pending state will be maintained until the stock of the mounted form of the queue is identical to the stock of the form associated with the job.
/GENERIC[=(queue-name,...)]
/NOGENERIC (default) Specifies that the queue is generic and that the jobs placed in it can be moved to compatible execution queues for processing. If you specify one or more names with /GENERIC, jobs can be moved only to the specified queues. The target execution queues may be initialized with the /NOENABLE_GENERIC qualifier to disable them from accepting jobs from the generic queues that do not specify an explicit execution queue list. If you do not specify a queue name with /GENERIC, jobs can be moved to any execution queue (with /ENABLE_GENERIC in effect) that is the same type (batch, printer, terminal, or server) as the generic queue. By default, a generic queue is a print queue. Use the appropriate qualifier (/BATCH, /PROCESSOR, /TERMINAL) to override the default. The /GENERIC qualifier is incompatible with the /DEFAULT, /FORM, and /SEPARATE qualifers. (The generic and execution queues must be initialized with matching /BATCH and /PROCESSOR queues.) The /BATCH qualifier determines that an execution queue is a batch queue. The symbiont process determines whether queues are printer, terminal, or server queues; the standard symbiont sets this characteristic depending upon whether the output device is a printer or a terminal.
/JOB_LIMIT=number-of-jobs
Specifies the number of batch jobs that can be executed concurrently from the queue. Defaults to 1.
/LIBRARY=filename
/NOLIBRARY
Assigns a device control library (containing escape sequence modules) for programmable printers. (The /LIBRARY qualifier can be used to specify an alternate device control library when used to initialize an output queue.) The default library is SYS$LIBRARY:SYSDEVCTL.TLB. You can specify only a file name. The library must be in SYS$LIBRARY and the file type must be TLB.
/ON=device[:]
Specifies the device on which a the queue is located. The default device name is the queue name.
/OWNER_UIC=uic
Specifies the user identification code (UIC) of the queue. The default UIC is [1,4].
/PROCESSOR=filename
/NOPROCESSOR Specifies a file containing a print symbiont. Specify only a file name. The file must be in SYS$SYSTEM and must have a type of EXE. The default print symbiont is named PRTSMB. (Used for a generic queue, the /PROCESSOR qualifier specifies that the generic queue can place jobs only on queues that were defined as server queues and that are executing the specified symbiont image.)
/PROTECTION=(ownership[:access],...)
Specifies the protection of the queue. Ownership categories are: SYSTEM, OWNER, GROUP, WORLD; each category can be abbreviated to its first character. Access categories are: R (read), W (write), E (execute), or D (delete); a null access specification means no access. The default protection is: (SYSTEM:E, OWNER:D, GROUP:R, WORLD:W).
/RECORD_BLOCKING (default)
/NORECORD_BLOCKING Determines whether the symbiont can concatenate (or block together) output records for transmission to the output device. If you specify /NORECORD_BLOCKING, the symbiont is directed to send each formatted record in a separate I/O request to the output device. For the standard MicroVMS print symbiont, record blocking can have a significant performance advantage over single-record mode.
/RETAIN[=keyword]
/NORETAIN (default) Holds jobs in the queue in a completed status after they have executed. Possible keywords are: +---------------+------------------------------------------+ | ALL (default) | Holds all jobs in the queue after | | | execution | +---------------+------------------------------------------+ | ERROR | Holds in the queue only jobs that | | | complete unsuccessfully | +---------------+------------------------------------------+
/SCHEDULE=SIZE (default)
/SCHEDULE=NOSIZE Schedules jobs in an output queue on the basis of size so that short jobs print before long jobs. The effect of this qualifier on currently pending jobs is unpredictable.
/SEPARATE=(keyword,...)
/NOSEPARATE (default) Specifies the job separation defaults for a printer or terminal queue. The /SEPARATE qualifier cannot be used with the /GENERIC qualifier. Possible keywords are: +-------------------+------------------------------------------------+ | [NO]BURST | Prints a burst page (a flag page printed over | | | the paper's perforations for easy | | | identification of individual files) at the | | | beginning of every job. | +-------------------+------------------------------------------------+ | [NO]FLAG | Prints a flag page (containing the job entry | | | number, the name of the user submitting the | | | job, and so on) at the beginning of every | | | job. | +-------------------+------------------------------------------------+ | [NO]TRAILER | Prints a trailer page at the end of every job. | +-------------------+------------------------------------------------+ | [NO]RESET=(m,...) | Specifies a job reset sequence for the queue. | | | The specified module(s) from the device | | | control library (see /LIBRARY) are used to | | | reset the device each time a job reset | | | occurs. | +-------------------+------------------------------------------------+
/START
/NOSTART (default) Starts the queue being initialized by the current INITIALIZE/QUEUE command.
/TERMINAL
/NOTERMINAL (default) Associates a generic queue with a terminal queue (instead of a printer queue) of matching characteristics.
/WSDEFAULT=n
Defines a working set default for a batch job. The /WSDEFAULT qualifier overrides the working set size specified in the user authorization file. Possible values are: a positive integer in the range 1 through 65535, 0, or the keyword NONE (the default). A zero or NONE sets the default value to the value specified either in the UAF or by the SUBMIT command (if specified). When used for an output queue, this qualifier specifies the working set default of the symbiont process for a printer, terminal, or server queue when the output queue is created.
/WSEXTENT=n
Defines a working set extent for the batch job. The /WSEXTENT qualifier overrides the working set extent in the user authorization file. Possible values are: a positive integer in the range 1 through 65535, 0, or the keyword NONE (the default). A zero or NONE sets the default value to the value specified either in the UAF or by the SUBMIT command (if specified). When used for an output queue, this qualifier specifies the working set extent of the symbiont process for a printer, terminal, or server queue when the output queue is created.
/WSQUOTA=n
Defines a working set page size (working set quota) for the batch job. The /WSQUOTA qualifier overrides the value in the user authorization file. Possible values are: a positive integer in the range 1 through 65535, 0, or the keyword NONE (the default). A zero or NONE set the default value to the value specified either in the UAF or by the SUBMIT command (if specified). When used for an output queue, this qualifier specifies the working set quota of the symbiont process for a printer, terminal, or server queue when the output queue is created.