WRKOPTVOL (Work with Optical Volumes)

WRKOPTVOL Command syntax diagram

 

Purpose

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

 

Optional Parameters

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.

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.

CSI

Specifies the communications side information object 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.

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 of WRKOPTVOL

Example 1: Displaying Optical Volumes in an Optical Device

WRKOPTVOL   DEV(OPT01)

This command displays 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 a list of all optical volumes in the optical server LAN01.

Error messages for WRKOPTVOL

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