Change Tape Cartridge (CHGTAPCTG)

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

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.