CHGTAPCTG (Change Tape Cartridge)

CHGTAPCTG Command syntax diagram

 

Purpose

The Change Tape Cartridge (CHGTAPCTG) command changes the specified cartridge from any category to the specified category.

 

Required Parameters

DEV

Specifies the name of 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.

CTG

Specifies the cartridge identifiers that are to have their corresponding categories changed.

Note:

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

*ALL: All tape cartridges in the device are changed.

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

cartridge-identifier: Specify a maximum of 40 cartridge identifiers to be changed.

 

Optional Parameters

CGY

Specifies the category to which the tape cartridge is changed.

Note:

The category cannot be changed with this command if it is a *NOSHARE category unless the command is issued from the system that owns the rights of the *NOSHARE.

Element 1: Category Name

*SAME: The value does not change.

*NOSHARE: The cartridge identifiers are changed to the *NOSHARE category. A cartridge with this identifier cannot be shared with other systems.

*IPL: The cartridge identifiers are changed to the *IPL category. A cartridge with this identifier can be used for an alternate IPL.

*NL: The cartridge identifiers are changed to the *NL category. A cartridge with this identifier is used as a non-labeled tape.

category-name: Specify the name of a user-defined category to which the cartridge identifiers are to be changed.

Element 2: Category System

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, all category information associated with all tape cartridges in library devices owned by the system are no longer valid.

*SAME: The value does not change.

*CURRENT: The category belongs to the system currently running the command.

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

Single Value:

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

Example for CHGTAPCTG

CHGTAPCTG   DEV(LIB01)  CTG(VOL1)  CGY(*SHARE400)

This command changes the category associated with the cartridge identifier VOL1 to the category *SHARE400.

Error messages for CHGTAPCTG

*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

CPF67EA

Function not successful

CPF67F5

Duplicate cartridge ID found

CPF67F9

&6 cartridges not changed

CPF9814

Device &1 not found.

CPF9825

Not authorized to device &1.