CHGOPTVOL (Change Optical Volume)

CHGOPTVOL Command syntax diagram

 

Purpose

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

1. To use this command the user must have *CHANGE authority to the volume being changed.
   
2. 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.

 

Required Parameters

VOL

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

 

Optional Parameters

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.

AUTL

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

For volumes in media library devices the authorization list can be maintained for this iSeries 400 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.

TEXT

Specifies the text that briefly describes the optical volume. More information is in Commonly used parameters.

*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.

Example for CHGOPTVOL

CHGOPTVOL   VOL(VOL01)  THRESHOLD(99)

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

Error messages for CHGOPTVOL

*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 operations 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 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.

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.