The Work with Optical Volumes (WRKOPTVOL) command displays a list of optical volumes and provides options to:

• add an optical cartridge
• remove an optical cartridge
• change optical volume attributes
• display optical volume attributes
• print optical volume attributes
• copy a volume
• initialize a volume
• rename a volume
• delete a volume entry

Parameters

Keyword	Description	Choices	Notes
DEV	Optical device	Name, *ALL	Optional, Positional 1
VOL	Volume identifier	Character value, *ALL, *BACKUP, *INDRIVE, *REMOVED	Optional, Positional 2
CSI	Side information	Character value, *ALL, *NONE	Optional
RTVEXTINFO	Retrieve extended information	*NO, *YES	Optional

Top

Optical device (DEV)

Specifies the optical device from which the volumes are listed.

*ALL

The volumes in all optical devices are listed.

optical-device-name

Specify the name of an optical device from which the volumes are listed.

Volume identifier (VOL)

Specifies the optical volume identifiers which are listed.

*ALL

All optical volume identifiers in the specified optical devices are listed.

*BACKUP

The optical volumes in the specified optical devices whose type is backup are listed.

*INDRIVE

Only the volumes which are currently in a drive for the specified optical device are listed.

*REMOVED

The volumes removed from optical libraries but whose information was kept in the optical index database files are listed.

volume-identifier

Specify the identifier of a specific volume to be listed.

Side information (CSI)

Specifies the communications side information objects representing the optical servers in the optical configuration from which the volumes are listed. This parameter is valid only when DEV(*ALL) is specified.

*ALL

The names of volumes for all remote optical servers are listed.

*NONE

No volumes are listed for remote optical servers.

communications-side-information-object-name

Specify the name of the communications side information object representing the optical server for which volumes are listed.

Retrieve extended information (RTVEXTINFO)

Specifies whether extended volume information, such as location of the volume and the percentage of the volume used, is retrieved.

*NO

No extended volume information is retrieved.

*YES

The extended volume information is retrieved.

Examples

Example 1: Displaying Optical Volumes in an Optical Device

WRKOPTVOL   DEV(OPT01)

This command displays the Work with Optical Volumes panel, showing a list of all optical volumes in the optical device OPT01.

Example 2: Displaying Optical Volumes in a Remote Server

WRKOPTVOL   DEV(*ALL)  VOL(*ALL)  CSI(LAN01)

This command displays the Work with Optical Volumes panel, showing a list of all optical volumes in the optical server LAN01.

Error messages

*ESCAPE Messages

OPT1530

&1 does not represent a valid optical device.

OPT1805

Error accessing optical volume index file.

OPT1815

Internal program error occurred.

OPT1860

Request to optical device &1 failed.

OPT2301

Internal system object in use.