Work with Tape Cartridge (WRKTAPCTG)
| Where allowed to run: Interactive environments (*INTERACT *IPGM *IREXX *EXEC) Threadsafe: No |
Parameters Examples Error messages |
The Work with Tape Cartridges (WRKTAPCTG) command allows the user to work with a list of tape cartridges.
| Top |
Parameters
| 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, *EJECT Other values: Element list |
Optional |
| Element 1: Category name | Character value, *ALL, *NOSHARE, *IPL, *NL, *CNV, *SYSGEN | ||
| Element 2: Category system | Character value, *CURRENT |
| Top |
Library device (DEV)
Specifies the library device to be used. The device name must have been previously created on the system using the Create Device Media Library (CRTDEVMLB) command.
This is a required parameter.
- name
- Specify the name of the library device.
| Top |
Cartridge ID (CTG)
Specify the cartridge identifiers to work with.
Note: The cartridge identifier should represent the external identifier if the library device has a bar code scanner to read external identifiers.
Single values
- *ALL
- All tape cartridges in the device or in the category specified are shown.
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.
| Top |
Category (CGY)
Specifies the category of tape cartridges to work with.
Single values
- *SHARE400
- The cartridge identifiers in the *SHARE400 category are displayed. A cartridge in this category can be shared with other systems attached to the same device.
- *INSERT
- The cartridge identifiers in the *INSERT category are displayed. A cartridge in this category has been placed in the library device, but its identifier has not been added to the system.
- *EJECT
- The cartridge identifiers in the *EJECT category are displayed. A cartridge in this category has had its identifier removed from the system and is no longer usable.
Element 1: Category name
- *ALL
- All categories are searched for the cartridge identifiers specified on the CTG parameter and all are displayed to work with.
- *NOSHARE
- The cartridge identifiers in the *NOSHARE category are displayed. A cartridge with this identifier cannot be shared with other systems.
- *IPL
- The cartridge identifiers in the *IPL category are displayed. A cartridge with this identifier can be used for an alternate IPL.
- *NL
- The cartridge identifiers in the *NL category are displayed. A cartridge with this identifier is used as a non-labeled tape.
- *CNV
- The cartridge identifiers in the *CNV category are displayed. Cartridges in this category are for use with the convenience station.
- *SYSGEN
- The cartridge identifiers in the *SYSGEN category are displayed. If the library device is in *SYSGEN mode, cartridges cannot be moved from the *SYSGEN category.
- category-name
- Specify the name of a user-defined category. This category name must have been created previously with the Create Tape Category (CRTTAPCGY) command.
Element 2: Category system
This element identifies the system the category belongs to. The system name is obtained from the pending system name field of a Display Network Attributes (DSPNETA) command. If there is no pending name, the current system attribute is used.
***** Attention ***************************** If the system name is changed, all category information associated with all tape cartridges in library devices are not valid. *********************************************
- *CURRENT
- The category belongs to the system currently running the command.
- *ALL
- The systems that own categories available to the system running this command are used.
- character-value
- Specify the name of the system to which the category belongs.
| Top |
Examples
Example 1: Working with a Single Cartridge in a Tape Library
WRKTAPCTG DEV(LIB01) CTG(VOL4) CGY(*ALL)
This command displays the Work with Tape Cartridges panel, showing only one entry for VOL4. A number of options for working with the tape cartridge shown are available on the Work with Tape Cartridges panel.
Example 2: Working with All Cartridges in the *INSERT Category
WRKTAPCTG DEV(LIB01) CGY(*INSERT)
This command displays the Work with Tape Cartridges panel, showing the list of all cartridges in the *INSERT category.
| Top |
Error messages
*ESCAPE Messages
- CPF6708
- Command ended due to error.
- CPF6711
- Command not allowed
- CPF6718
- Cannot allocate device &1.
- CPF6745
- Device &1 not a media library device.
- CPF67A6
- Category does not exist
- CPF67D2
- Cartridge command was not successful.
- CPF67D4
- Category not available
- CPF67E4
- Library device function not successful
- CPF67E6
- Volume &2 is not correct
- CPF67EA
- Function not successful
- CPF67EC
- Library device description &1 does not exist
- CPF67ED
- Library device &1 not available
- CPF67F5
- Duplicate cartridge or virtual volume name found
- CPF9814
- Device &1 not found.
- CPF9825
- Not authorized to device &1.
| Top |