Change Optical Volume (CHGOPTVOL)

The Change Optical Volume (CHGOPTVOL) command changes the volume-full threshold, the authorization list, or the description of an optical volume. If TYPE(*BACKUP) was specified when the volume was initialized, the volume-full threshold cannot be changed.

Restrictions:

To use this command the user must have *CHANGE authority to the volume being changed.
If this command is being used to change the volume's authorization list, the user must have *AUTLMGT authority to the authorization list currently securing the volume.

Keyword	Description	Choices	Notes
VOL	Volume identifier	Character value	Required, Key, Positional 1
THRESHOLD	Volume full threshold	1-100, *SAME	Optional, Positional 2
AUTL	Authorization list	Name, SAME, NONE	Optional, Positional 3
TEXT	Text 'description'	Character value, BLANK, SAME	Optional

Authorization list (AUTL)

The authorization list used to verify access to the optical volume on this iSeries. This value is not stored on the volume and will not be maintained when the optical disk is moved between systems.

For volumes in media library devices the authorization list can be maintained for this iSeries when the optical disk is removed from the device. This can be done by specifying VOLOPT(*KEEP) on the Remove Optical Cartridge (RMVOPTCTG) CL command. The authorization list can then be restored by specifying AUTL(*PRV) on the Add Optical Cartridge (ADDOPTCTG) CL command.

If the volume is in a stand-alone optical device such as a CD-ROM or DVD device, the authorization list will secure the volume for the duration that the optical disk is in the device. The authorization list cannot be maintained when the optical disk is removed from the device. If the optical disk is ejected from the device then inserted again, the authorization list will be reset to the default which is QOPTSEC.

*SAME: The value does not change.
*NONE: No authorization list is used to secure the optical volume.
authorization-list-name: Specify the name of the authorization list used to secure the optical volume.

Examples

CHGOPTVOL   VOL(VOL01)  THRESHOLD(99)

This command changes the volume-full-threshold for the optical volume VOL01 to 99 percent.

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.
OPT1340: Optical volume &1 not initialized.
OPT1341: THRESHOLD or TEXT can not be specified.
OPT1345: No free space available on media.
OPT1350: Write operation failed to optical volume &1.
OPT1360: Media directory corrupted on optical volume &1.
OPT1460: Optical volume &1 is not in an optical device.
OPT1463: Operation not completed, optical volume is not a primary volume.
OPT1485: Initialize or rename of optical volume failed.
OPT1530: &1 does not represent a valid optical device.
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.
OPT2410: Authorization list &1 for volume &2 was not found.
OPT2420: Not authorized to optical volume &2.
OPT7740: User not authorized to object &2 in library &3 type &4.