Change Optical Volume (CHGOPTVOL)

Where allowed to run: All environments (*ALL)
Threadsafe: No

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.

Top

Parameters

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

Top

Volume identifier (VOL)

Specifies the volume identifier of the optical volume to be changed.

Top

Volume full threshold (THRESHOLD)

Specifies the volume-full-threshold percentage.

*SAME: The value does not change.
volume-full-threshold: Specify the threshold percentage. Valid values range from 1 through 100.

Top

Authorization list (AUTL)

The authorization list used to verify access to the optical volume on this IBM i. 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 IBM i 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.

Top

Text 'description' (TEXT)

Specifies the text that briefly describes the optical volume.

*SAME: The value does not change.
*BLANK: Text is not specified.
'description': Specify a maximum of 50 characters enclosed in apostrophes to describe the optical volume.

Top

Examples

CHGOPTVOL   VOL(VOL01)  THRESHOLD(99)

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

Top

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.

Top