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

Parameters

Keyword	Description	Choices	Notes
DEV	Library device	Name	Required, Positional 1
CTG	Cartridge ID	Values (up to 40 repetitions): Character value, *ALL	Optional
CGY	Category	Single values: *SHARE400 Other values: Element list	Optional
	Element 1: Category name	Character value, *SAME, *NOSHARE, *IPL, *NL, *CNV
	Element 2: Category system	Character value, *SAME, *CURRENT

Top

Library device (DEV)

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

This is a required parameter.

name

Specify the name of the device.

Cartridge ID (CTG)

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

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-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 1 to 40 cartridge identifiers to change the category of.

Category (CGY)

Specifies the category to change the tape cartridge to. The category cannot be changed with this command if it is a *NOSHARE category unless the command is executed from the system that owns the rights of the *NOSHARE.

Single values

*SHARE400

The cartridge identifiers specified are changed to the *SHARE400 category.

Element 1: Category name

*SAME

The category information is not changed.

*NOSHARE

The cartridge identifiers specified are changed to the *NOSHARE category.

*IPL

The cartridge identifiers specified are changed to the *IPL category.

*NL

The cartridge identifiers specified are changed to the *NL category.

character-value

Specify the name of a user-defined category. The cartridge identifiers specified are changed to the user-defined category that is specified.

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 are not valid.
*********************************************

*SAME

The system does not change.

*CURRENT

The category belongs to the system currently running the command.

character-value

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

Examples

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

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

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

CPF67EA

Function not successful

CPF67F5

Duplicate cartridge or virtual volume name found

CPF67F9

&6 cartridges not changed

CPF9814

Device &1 not found.

CPF9825

Not authorized to device &1.