Initialize Optical (INZOPT)

The Initialize Optical (INZOPT) command initializes an optical volume. Depending on the type of optical volume being initialized this operation may take up to 30 minutes to complete. When an existing optical volume is initialized a second time, all existing information is lost.

Restriction: To use this command you must have *ALL authority to the authorization list securing the volume if it is in an optical media library device. You need *CHANGE authority to the authorization list securing the volume if it is in an optical device.

Parameters

Keyword	Description	Choices	Notes
VOL	Volume identifier	Character value, *MOUNTED	Optional, Key, Positional 1
NEWVOL	New volume identifier	Character value, *VOL	Optional, Positional 2
DEV	Device	Name	Optional
THRESHOLD	Volume full threshold	1-100, *CALC	Optional
CHECK	Check for an active volume	NO, YES	Optional
ENDOPT	End of media option	LEAVE, UNLOAD	Optional
CLEAR	Clear	NO, YES	Optional
TEXT	Text 'description'	Character value, *BLANK	Optional
TYPE	Volume type	PRIMARY, BACKUP	Optional
CCSID	Coded character set ID	*CALC, 500, 850	Optional
MEDFMT	Media format	MEDTYPE, HPOFS, *UDF	Optional

Top

New volume identifier (NEWVOL)

Specifies the identifier of the optical volume after it is initialized. The identifier must contain only alphabetic characters (A through Z), numeric characters (0 through 9), hyphen (-), underscore (_), or a period (.). The first character must be alphabetic or numeric and the identifier cannot contain blanks.

*VOL: The new volume identifier is the same as the old volume identifier.
new-volume-identifier: Specify the new volume identifier.

Volume full threshold (THRESHOLD)

Specifies the percentage of space on the volume to use until the volume is considered full. This field is only used if the media format is *HPOFS. For other media formats, this field is ignored and the threshold will default to 100 percent.

*CALC

The system will calculate the percentage of the volume to use based on media format and volume type.

For a media format of *HPOFS and a volume type of *PRIMARY the threshold will be 95 percent.
For a media format of *HPOFS and a volume type of *BACKUP the threshold will be 99 percent.
For a media format of *UDF the threshold will be 100 percent.

volume-full-threshold

Specify the volume threshold percentage. Valid values range from 1 through 100.

Note: If the volume type is *BACKUP, this parameter is ignored and the volume-full-threshold is set to 99 percent.

If the media format is *UDF, this parameter is ignored and the volume-full-threshold is set to 100 percent.

Check for an active volume (CHECK)

Specifies whether the system checks to see if the optical volume is initialized.

*YES: The system checks to see if the optical volume is initialized. If the volume is initialized, the operation is ended and an error message is sent.
*NO: The system does not check to see if the optical volume is initialized. The volume will be initialized and all existing data will be lost.

End of media option (ENDOPT)

Specifies whether the media is unloaded from the device after the initialize command completes.

Note: This parameter is ignored if the media is an optical library device.

*LEAVE: When the initialize completes the media is left in the device.
*UNLOAD: When the initialize completes the media is unloaded from the device.

Clear (CLEAR)

Specifies whether or not existing data on the volume will be cleared during the initialize process. This parameter only applies when the volume media type is *DVD-RAM.

Note: If the volume media type is *WORM the volume is never cleared regardless of the parameter setting.

If the volume media type is *ERASE the volume is always cleared regardless of the parameter setting.

*NO: The volume is not cleared.
*YES: The volume is cleared of existing data prior to initialization.
Note: If this option is selected the INZOPT command may take several hours or more to complete, depending on the media capacity.

Volume type (TYPE)

Specifies the type of optical volume being initialized. Optical volumes for user applications are initialized as primary volumes. Backup optical volumes can be written to only by using the following set of optical backup commands: CVTOPTBKU, CPYOPT, and DUPOPT.

*PRIMARY: The optical volume is used as a primary volume.
*BACKUP: The optical volume is used as a backup volume.

Coded character set ID (CCSID)

Specifies the character set in which the optical volume, directory, file names, and volume description are written. This parameter does not affect how user data is written. The user application must determine the character set in which the file data is written.

*CALC: The system will select the default character set based on the media format.
500: The EBCDIC character set and code page 500 are used.
850: The ASCII character set and code page 850 are used.

Media format (MEDFMT)

Indicates the media format to use when writing to the optical media. There are two media formats, either *HPOFS (High Performance Optical File System) or *UDF (Universal Disk Format). For a complete comparison of the two media formats refer to the Optical Support, SC41-4310 book.

*MEDTYPE

Specifies that the operating system will determine which media format is used to initialize the volume. The media format will be based upon the media type.

If the media type is *WORM or *UNKNOWN, the media will be initialized using the *HPOFS format.
If the media type is *ERASE and has not been previously initialized the media will be initialized using the *HPOFS format.
If the media type is *ERASE and has been previously initialized it will be initialized using the previous media format.
If the media type is *DVD-RAM, the media will be initialized using the *UDF format.

*HPOFS

The High Performance Optical File System is used to initialize the volume. One of the characteristics of HPOFS is space occupied by a deleted file is not reused. The only way deleted file space can be recovered is to reinitialize the media thereby losing all previously recorded data on the media.

*UDF

The Universal Disk Format, a subset of the ISO 13346 standard, is used to initialize the volume. One of the characteristics of UDF is space occupied by a deleted file will be reused when needed for either the creation of a new file or the extension of an existing file. The UDF media format also provides file and directory level security through the use of permissions.

Examples

INZOPT   VOL(VOL01)  THRESHOLD(99)  CHECK(*NO)

This command initializes the optical volume VOL01 with a volume-full-threshold of 99 percent. The system does not check to see if the volume is initialized.

Error messages

*ESCAPE Messages

OPT1305: Optical volume &1 is read only.
OPT1315: Optical volume &1 is write protected.
OPT1320: Optical volume &1 in use.
OPT1325: Optical volume format not recognized.
OPT1330: Optical volume not found or not useable.
OPT1331: Optical volume &1 not found.
OPT1335: Volume &1 already initialized.
OPT1342: Invalid volume identifier specified.
OPT1345: No free space available on media.
OPT1346: Operation not allowed to volume located in a remote optical device.
OPT1350: Write operation failed to optical volume &1.
OPT1360: Media directory corrupted on optical volume &1.
OPT1375: Optical volume &1 already exists.
OPT1460: Optical volume &1 is not in an optical device.
OPT1485: Initialize or rename of optical volume failed.
OPT1489: Volume parameter is not permitted for device &1.
OPT1530: &1 does not represent a valid optical device.
OPT1540: Invalid parameters specified.
OPT1555: Optical device &1 in use.
OPT1605: Media or device error occurred.
OPT1790: Operation not allowed or conflicts with another request.
OPT1805: Error accessing optical volume index file.
OPT1810: Error accessing optical directory index file.
OPT1815: Internal program error occurred.
OPT1820: Internal error occurred on optical device &1.
OPT1821: Error occurred on optical device &1.
OPT1825: Optical indexes are incorrect for optical device &1.
OPT1860: Request to optical device &1 failed.
OPT1861: No device description configured for resource &1.
OPT1862: No active device description for resource &1.
OPT1863: Optical libraries need to be reclaimed.
OPT1872: Optical request timed out or was cancelled.
OPT2301: Internal system object in use.
OPT2420: Not authorized to optical volume &2.
OPT2422: Not authorized to file or directory.
OPT7740: User not authorized to object &2 in library &3 type &4.