RMVOPTCTG (Remove Optical Cartridge)

RMVOPTCTG Command syntax diagram

 

Purpose

The Remove Optical Cartridge (RMVOPTCTG) command can be used to:

Restriction: You must have *USE authority to use this command. It is shipped with *EXCLUDE public authority.

 

Required Parameters

VOL
Specifies the volume identifier of the optical cartridge being removed from the optical media library. Although an optical cartridge has two volumes, you need only specify one volume identifier to remove the optical cartridge.

*IOSTATION: The input/output station of an optical media library is moved to the out position. This allows any optical cartridge currently in the input/output station to be removed.

*MOUNTED: The system will remove the description of the volume located in the optical device specified on the DEV parameter. For some optical devices the tray will be opened.

Note: This value is only valid when parameter DEV is specified.

volume-identifier: Specify the volume identifier of the optical cartridge being removed.

 

Optional Parameters

VOLOPT
Specifies whether to keep the optical volume description in the optical index database files.

*REMOVE: The volume description is removed from the optical index database files.

*KEEP: The volume description is kept in the optical index database files. This allows the volume descriptions of removed volumes to be displayed when using the Work with Optical Volumes (WRKOPTVOL) command.

Note: This value is only valid for volumes in media library devices. It will be ignored for volumes in other optical devices.

RMVCTGLOC
Specifies the external location of the optical cartridge after it is removed.

Note: This parameter is valid only when VOLOPT(*KEEP) is specified.

*NONE: No external location is specified.

removed-cartridge-location: Specify the location of the optical cartridge after it is removed. A maximum of 50 characters can be specified.

MLB
Specifies the name of the optical media library to use for the operation.

Note: This parameter is valid only when VOL(*IOSTATION) or VOL(*LEASTUSED) is specified. This parameter is ignored when a specific volume name is specified on the VOL parameter.

DEV
Specifies the name of the optical device which is to have the volume which it contains removed from the optical index database and tray opened if supported by the device.

Note: This parameter is valid only when VOL(*MOUNTED) is specified. This parameter is ignored when a specific volume name is specified on the VOL parameter.

Examples for RMVOPTCTG

Example 1: Specify a Volume Identifier 

RMVOPTCTG   VOL(VOL01)

Example 2: Specify a Stand-Alone Device 

RMVOPTCTG   VOL(*MOUNTED) DEV(OPT01)

This command removes the volume found in the stand-alone optical device OPT01.

Error messages for RMVOPTCTG

*ESCAPE Messages

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.
OPT1346
Operation not allowed to volume located in a remote optical device.
OPT1430
Optical volume &1 information removed.
OPT1460
Optical volume &1 is not in an optical device.
OPT1530
&1 does not represent a valid optical device.
OPT1555
Optical device &1 in use.
OPT1652
Device &1 is not an optical media library.
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
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.
OPT7740
User not authorized to object &2 in library &3 type &4.