| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
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.
| Top |
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| DEV | Library device | Name | Required, Positional 1 |
| CTG | Cartridge ID | Values (up to 40 repetitions): Character value | Required, Positional 2 |
| CGY | Category | Single values: *SHARE400 Other values: Element list |
Optional |
| Element 1: Category name | Character value, *NOSHARE, *IPL, *NL, *CNV | ||
| Element 2: Category system | Character value, *CURRENT | ||
| CHKVOL | Check volume identifier | *YES, *NO | Optional |
| Top |
Specifies the library device to be used. The device name must have been created previously on the system using the Create Device Media Library (CRTDEVMLB) command.
This is a required parameter.
| Top |
Specifies a maximum of 40 cartridge identifiers that are currently in the insert category that are added to the category specified.
This is a required parameter.
Note: The cartridge identifier should represent the external identifier if the library device has a bar code scanner to read external identifiers.
| Top |
Specifies the category to which the tape cartridge is added. The cartridge is moved to a slot in the library device, unless the cartridge is added to the convenience (CNV) category.
Single values
Element 1: Category name
**** Attention ********************************** When using the *IPL category for an alternate IPL of a system, you must ensure that the cartridges are the proper ones to be used for the alternate IPL. Conflicts may arise if high-end and low-end systems are attached to the same library device. **************************************************
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 name attribute is used.
***** Attention ********************************* If the system name is changed, the category information associated with all tape cartridges in library devices is not valid. *************************************************
| Top |
Specifies whether the logical volume identifier is forced to be identical to the external identifier if the library device has a bar code scanner to read the bar code identifier.
| Top |
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.
| Top |
*ESCAPE Messages
| Top |