INZOPT (Initialize Optical)
Purpose
The Initialize Optical (INZOPT) command initializes an optical volume. Depending on the type of optical volume being initialized this operation may take 30 minutes or more to complete. When an existing optical volume is initialized a second time, all existing information is lost.
Media format is determined by the media type. If the media type is *DVD-RAM, the new media format will be *UDF (Universal Disk Format). If the media type is *ERASE or *WORM, the new media format will be *HPOFS (High Performance Optical File System).
Restriction: To use this command have *ALL authority to the authorization list securing the volume if it is in an optical library device. You need *CHANGE authority to the authorization list securing the volume if it is in an optical stand-alone device.
Optional Parameters
- VOL
- Specifies the volume identifier of the optical volume being initialized or
re-initialized.
*MOUNTED: The volume mounted on the specified device (DEV parameter) will be initialized.
volume-identifier: Specify the identifier of the optical volume to initialize.
- 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), a hyphen (-), or a period (.). The first character
must be alphabetic or numeric and the identifier cannot contain blanks. More
information about optical volume names can be found in the Optical Support
book.
*VOL: The new volume identifier is the same as the old volume identifier.
new-volume-identifier: Specify the new volume identifier.
- DEV
- Specifies the name of an optical device which contains the volume to be
initialized. This parameter is required when VOL(*MOUNTED) is specified. The
device cannot be an optical media library device.
optical-device: The name of the optical device containing the volume which will be initialized.
- THRESHOLD
- Specifies the percentage of space on the volume to use until the volume is
considered full. This field is only used for volumes in a media library device
with a target media format of *HPOFS. For volumes in a DVD-RAM device, or
volumes with a target media format of *UDF, this field is ignored and the
threshold will default to 100 percent.
Note: If TYPE(*BACKUP) is specified, this parameter is ignored and the volume-full-threshold is set to 99 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
- Specifies whether the system checks to see if the optical volume is already
initialized.
*YES: The system checks to see if the optical volume is initialized.
Note: If the optical 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.
- ENDOPT
- Specifies whether the media is unloaded from the device after the
initialize completes.
Note: This parameter is ignored if the media is in 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
- 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.
- TEXT
- Specifies the text that briefly describes the optical volume. More
information on this parameter is in Commonly
used parameters.
*BLANK: Text is not specified. If the optical volume is being re-initialized, the text is not changed.
'description': Specify no more than 50 characters of text, enclosed in apostrophes.
- 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.
- 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 default character set is used. For the current release, this value is 500.
500: The EBCDIC character set and code page 500 are used.
850: The ASCII character set and code page 850 are used.
- MEDFMT
- Indicates the media format to use when writing to the optical media. There
are two media formats, either *HPOFS or *UDF. For a complete comparison of the
two media formats please refer to the Optical Support
book.
*MEDTYPE: Specifies that the operating system will determine which media format is used to initialize the volume. Which media format is used is based upon the optical 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 (HPOFS) media format 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 re-initialize the media
thereby losing all previously recorded
data on the media.>
*UDF: The Universal Disk Format (UDF) media format which is 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 level security through permissions.
Example for INZOPT
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 for INZOPT
*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 operations 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
- Internal 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.
- 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.