Remove Optical Cartridge (RMVOPTCTG)

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.

Parameters

Keyword Description Choices Notes
VOL Volume identifier Character value, *IOSTATION, *MOUNTED, *LEASTUSED, *MAGAZINE Required, Positional 1
VOLOPT Volume description option *REMOVE, *KEEP Optional, Positional 2
MEDLOC Media location *IOSTATION, *MAGAZINE Optional, Positional 3
RMVCTGLOC Removed cartridge location Character value, *NONE Optional
MLB Optical media library Name Optional
DEV Optical device Name Optional

Volume identifier (VOL)

Specifies the volume identifier of the optical cartridge to be removed from the optical device or media library device. For cartridges with two volumes, only one volume identifier must be specified.

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

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

*LEASTUSED
The system will determine which optical cartridge is the least recently used and removes it from the specified media library.

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

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

*MAGAZINE
This value will open the bulk load magazine for removal from the optical library..

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

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

Volume description option (VOLOPT)

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

Note: This parameter is valid only if a volume identifier is specified on the VOL parameter.

*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 initialized volumes in media library devices. For uninitialized volumes and volumes in other optical devices, this value will be ignored and *REMOVE will be used.

Media location (MEDLOC)

Specifies the final destination of the optical volume being removed.

*IOSTATION
The optical cartridge is removed to the input/output station.
*MAGAZINE
The optical cartridge is removed to the bulk load magazine.

Note: Not all optical libraries are equipped with a bulk load magazine.

Removed cartridge location (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.

Optical media library (MLB)

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

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

Optical device (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

Example 1: Specify a Volume Identifier 

RMVOPTCTG   VOL(VOL01)

This command removes optical cartridge with volume identifier 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.

Example 3: Specify a Media Location of *MAGAZINE 

RMVOPTCTG   VOL(VOL01)  MEDLOC(*MAGAZINE)

This command removes optical cartridge with volume identifier VOL01 to the bulk load magazine.

Example 4: Specify a Volume Name of *MAGAZINE 

RMVOPTCTG   VOL(*MAGAZINE)  MLB(OPTMLB01)

This command opens the bulk load magazine so that it can be removed from the optical media library.

Error messages

*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.
OPT1671
Feature not installed for optical device &1.
OPT1672
Error accessing bulk load magazine for optical device &1.
OPT1676
Bulk load magazine is full for optical device &1.
OPT1677
Bulk load magazine is open for optical device &1.
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.
OPT7740
User not authorized to object &2 in library &3 type &4.