Remove Tape Cartridge (RMVTAPCTG)

Keyword	Description	Choices	Notes
DEV	Library device	Name	Required, Positional 1
CTG	Cartridge ID	Single values: ALL Other values (up to 40 repetitions): Character value*	Optional
CGY	Category	Single values: SHARE400, INSERT Other values: Element list	Optional
Element 1: Category name	Character value, NOSHARE, IPL, NL, CNV
Element 2: Category system	Character value, *CURRENT
STATION	Station	DEV, CNV, *HIGHCAP	Optional

Cartridge ID (CTG)

Specifies the cartridge identifiers that are to be removed.

Notes:

The cartridge identifier should represent the external identifier if the library device has a bar code scanner to read external identifiers.
If this parameter is specified, the CGY parameter cannot be specified.

Single values

*ALL: All cartridges are removed.

Other values (up to 40 repetitions)

generic-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 cartridge identifiers with names that begin with the generic prefix. If an asterisk is not included with the generic (prefix) name, the system assumes it to be the complete cartridge identifier.
identifier: Specify the cartridge identifier to be removed.

Category (CGY)

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

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

Single values

*SHARE400: The cartridge identifiers assigned to the *SHARE400 category are removed. A cartridge in this category can be shared with other systems attached to the same device.
*INSERT: All cartridge identifiers assigned to the *INSERT category are removed. A cartridge in this category has been placed in the library device, but its identifier has not been added to the system.

Element 1: Category name

*NOSHARE: All cartridges identifiers assigned to the *NOSHARE category are removed. A cartridge with this identifier cannot be shared with other systems.
*IPL: The cartridges identifiers assigned to the *IPL category are removed. A cartridge with this identifier can be used for an alternate IPL.
*NL: All cartridges identifiers assigned to the *NL category are removed. A cartridge with this identifier is 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.
character-value: 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 are not valid.
*********************************************

*CURRENT: The category belongs to the system currently running the command.
character-value: Specify the name of the system to which the category belongs.

Station (STATION)

Specifies the station to receive the cartridges being ejected.

*DEV: If the tape library has a convenience 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 the high capacity output station. If the tape library does not have a high capacity output station, the cartridges are placed in a storage slot within the library. The library door must be opened to physically remove the tape cartridges from the high capacity output station or a storage slot within the library.
*CNV: The tape cartridge is ejected to 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. If the tape library does not have a convenience I/O station, the cartridges are placed in the high capacity output station. If the tape library does not have a high capacity output station, the cartridges are placed in a storage slot within the library. The library door must be opened to physically remove the tape cartridges from the high capacity output station or a storage slot within the library.
*HIGHCAP: The tape cartridges are ejected to the high capacity output station in the library device. If the tape library does not have a high capacity output station, the cartridges are placed in the convenience I/O station. If the tape library does not have a convenience I/O station, the cartridges are placed in a storage slot within the library. The library door must be opened to physically remove the tape cartridges from the high capacity output station or a storage slot within the library.

Examples

Example 1: Removing a Single Cartridge to the *HIGHCAP station

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 the high capacity output station. If no high capacity output station is defined the cartridge will be placed in a convenvience I/O station. If no convenience I/O is supported the cartridge will remain in a storage slot.

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.