Remove Optical Cartridge (RMVOPTCTG)

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

Remove an optical disk cartridge and its volume(s) from an optical device or media library device.
Remove a cartridge currently in the input/output station of an optical media library.
Move the input/output station of an optical media library to the out position.
Open the tray for some optical devices.
Remove the volume description of an optical volume previously removed using this command with VOLOPT(*KEEP) specified.

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

Top

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.