RMVTAPCTG (Remove Tape Cartridge)

RMVTAPCTG Command syntax diagram

 

Purpose

The Remove Tape Cartridge (RMVTAPCTG) command removes the specified cartridge identifiers from their current category, or from the category specified, and places them in the eject (*EJECT) category. The eject category is not a valid category for input/output (I/O) operations; cartridges in the eject category cannot be used in the tape device.

 

Required Parameters

DEV
Specifies the name of the library device used. The device name must have been created previously on the system using the Create Device Media Library (CRTDEVMLB) command.
CTG
Specifies the cartridge identifiers that are removed.

 

Notes

  1. The cartridge identifier should be the same as the external identifier if the library device has a bar code scanner to read external identifiers.

  2. If this parameter is specified, the CGY parameter cannot be specified.

*ALL: All cartridges are removed.

generic*-cartridge-identifier: Specify the generic name of the cartridge identifier. A generic name is a character string of one or more characters followed by an asterisk (*); for example, ABC*. The asterisk substitutes for any valid characters. A generic name specifies all objects with names that begin with the generic prefix for which the user has authority. If an asterisk is not included with the generic (prefix) name, the system assumes it to be the complete object name. For more information on the use of generic names, refer to generic names.

cartridge-identifier: Specify a maximum of 40 cartridge identifiers to remove.

CGY
Specifies the category from which the tape cartridges are to be removed.

Note: If this parameter is specified, the CTG parameter cannot be specified.

Element 1: Category Name

*NOSHARE: The cartridge identifiers assigned to the *NOSHARE category are removed. The cartridge identifiers in this category cannot be shared with other systems.

*IPL: The cartridge identifiers assigned to the *IPL category are removed. The cartridge identifiers in this category can be used for an alternate IPL.

*NL: The cartridge identifiers assigned to *NL category are removed. The cartridge identifiers in this category are used as a non-labeled tape.

*CNV: All cartridge identifiers assigned to the *CNV category are removed. A cartridge in this category would be automatically removed by OS/400 if the cartridge was loaded and an unload was requested by a user.

category-name: Specify the name of a user-defined category. The cartridge identifiers assigned to the specified user-defined category are removed.

Element 2: Category System

This element identifies the system to which the category belongs. The system name is obtained from the pending system name field of a Display Network Attributes (DSPNETA) command. If there is no pending system name, the current system attribute is used.

Attention:

If the system name is changed, the categories associated with all tape cartridges in library devices owned by the system are no longer valid.

*CURRENT: The category belongs to the system currently running the command.

system-name: Specify the name of the system to which the category belongs.

Single Values:

*SHARE400: The cartridge identifiers assigned to the *SHARE400 category are removed. The cartridge identifiers in this category can be shared with other systems attached to the same device.

*INSERT: The cartridge identifiers assigned to the *INSERT category are removed. The cartridge identifiers in this category are for cartridges that have been placed in the library device, but whose identifier has not been added to the system.

 

Optional Parameters

STATION
Specifies the station to receive the cartridges being ejected.

*DEV: If the tape library has a convenience input/output (I/O) station, the cartridges are placed in it. If the tape library does not have a convenience I/O station, the cartridges are placed in either the high capacity output station or a storage slot within the library.

*CNV: The tape cartridge is ejected into the convenience I/O station. The convenience I/O station allows entry and removal of the tape cartridges from the library without opening the library door.

*HIGHCAP:The tape cartridges either are ejected into the high capacity output station or are returned to a storage slot in the library device. Both of these outcomes require that the library door be opened to physically remove the tape cartridges from the library.

Examples for RMVTAPCTG

Example 1: Removing a Single Cartridge to the *EJECT Category 

RMVTAPCTG   DEV(LIB01)  CTG(VOL4)
  STATION(*HIGHCAP)

This command removes the cartridge identifier VOL4 from its current category and places it in the *EJECT category. The cartridge is placed in a storage slot or the high capacity output station.

Example 2: Removing All Cartridges from the *IPL Category 

RMVTAPCTG   DEV(LIB01)  CGY(*IPL)
  STATION(*CNV)

This command removes all cartridge identifiers in the *IPL category and places them in the *EJECT category. The cartridges are placed in the convenience I/O station.

Error messages for RMVTAPCTG

*ESCAPE Messages

CPF67AF
&6 cartridges not removed
CPF6745
Device &1 not a media library device.