WRKTAPCTG (Work with Tape Cartridges)

WRKTAPCTG Command syntax diagram

 

Purpose

The Work with Tape Cartridges (WRKTAPCTG) command allows the user to work with a list of tape cartridges.

 

Required Parameters

DEV

Specifies the name of the library device used. The device name must have been previously created on the system using the Create Device Media Library (CRTDEVMLB) command.

 

Optional Parameters

CTG

Specify a maximum of 40 cartridge identifiers to work with.

Note:

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

*ALL: All tape cartridges in the device or in the category specified are displayed to work with.

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. See generic names for additional information.

cartridge-identifier: Specify the cartridge identifier.

CGY

Specifies the category of tape cartridges to work with.

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. The cartridge identifiers in this category cannot be shared with other systems.

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

*NL: The cartridge identifiers in the *NL category are displayed. The cartridge identifiers in this category are 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 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 name, the current system attribute is used.

Attention
If the system name is changed, the category information 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.

*ALL: The systems that own categories available to the system running this command are used.

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

Single Values:

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

*INSERT: The cartridge identifiers in the *INSERT category are displayed. 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.

*EJECT: The cartridge identifiers in the *EJECT category are displayed. The cartridge identifiers in this category are for cartridges whose identifiers have been removed from the system and are no longer usable.

Examples for WRKTAPCTG

Example 1: Working with a Single Cartridge in a Tape Library

WRKTAPCTG   DEV(LIB01)  CTG(VOL4)  CGY(*ALL)

This command shows the list of only VOL4 at the work station display. A number of options for working with the tape cartridge shown are available on the Work with Tape Cartridges display.

Example 2: Working with All Cartridges in the *INSERT Category

WRKTAPCTG   DEV(LIB01)  CGY(*INSERT)

This command shows the list of all cartridges in the *INSERT category. A number of options for working with these cartridges are available on the Work with Tape Cartridge display.

Error messages for WRKTAPCTG

*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 does not exist

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 ID found

CPF9814

Device &1 not found.

CPF9825

Not authorized to device &1.