CL Command Reference - SETTAPCGY
CL Command List > SETTAPCGY Reference
Description:
The Set Tape Category (SETTAPCGY) command sets the category for a tape device in a specified media library device. The system automatically loads cartridges from the specified category in the order specified on the cartridge order (CTGORDER) parameter.
Examples:
Example 1: Using Mounted Category Without a Mount Identifier
SETTAPCGY MLB(LIB01) OPTION(*MOUNTED) CGY(*NOSHARE *CURRENT)
CTGORDER(*SEQ) TGTCGY(*IPL)
This command sets the tape category to *NOSHARE for a resource in media library device LIB01 on the system currently running this command. Each cartridge that is used is changed to the *IPL category. The order in which the cartridges are used is the exact order in which they were added to or changed in the category. As each cartridge is used and unloaded from the resource, the system automatically chooses and loads the next sequential cartridge from the *NOSHARE category.
Example 2: Using Mounted Category with a Mount Identifer
This command sets the tape category to *NOSHARE for a resource in media library device LIB01 on the system currently running this command. The mounted category session is identified by the mount identifier DAILY. Each cartridge that is used is changed to the DAILY1 category. The order in which the cartridges are used is the exact order in which they were added to or changed in the category. As each cartridge is used and unloaded from the resource, the system automatically chooses and loads the next sequential cartridge from the *NOSHARE category.
Example 3: Releasing a Category Session
SETTAPCGY MLB(LIB01) OPTION(*RELEASE)
This command releases the category session assigned to the job issuing the command. The category is still set to a resource in media library device LIB01 and is available for another job to assign.
Example 4: Assigning a Category Session
SETTAPCGY MLB(LIB01) OPTION(*ASSIGN) MNTID(DAILY)
This command assigns the mounted category session identified by the mount identifier DAILY to the job issuing the command.
Example 5: Demounting a Mounted Category
SETTAPCGY MLB(LIB01) OPTION(*DEMOUNTED)
This command demounts the mounted category from a resource in media library device LIB01. The mount identifier DAILY is now available to use to name another mounted category session.