CL Command Reference - ADDTAPCTG
CL Command List > ADDTAPCTG Reference
Description:
The Add Tape Cartridge (ADDTAPCTG) command adds the specified cartridge identifiers to a usable category. Cartridges are placed in the insert category when they are placed in the library device and must be added to a usable category before they can be used by a tape device.
The cartridge identifier must be unique within a library device. If a duplicate cartridge identifier does exist in a library device, both cartridges are unusable until one is physically removed from the library device.
Examples:
Example 1: Adding a Single Cartridge to the *SHARE400 Category
ADDTAPCTG DEV(LIB01) CTG(VOL4) CGY(*SHARE400) CHKVOL(*NO)
This command adds the cartridge identifier VOL4 to the usable category *SHARE400. The logical volume identifier in the volume labels of VOL4 are not verified.
Example 2: Adding Multiple Cartridges to the *NOSHARE Category
ADDTAPCTG DEV(LIB01) CTG(VOL1 VOL2 VOL3)
CGY(*NOSHARE) CHKVOL(*YES)
This command adds the cartridge identifiers VOL1, VOL2, and VOL3 to the usable category *NOSHARE. The logical volume identifiers on the tape cartridges are verified when the command is run.