ADDOPTCTG (Add Optical Cartridge)

ADDOPTCTG Command syntax diagram

 

Purpose

The Add Optical Cartridge (ADDOPTCTG) command adds an optical disk cartridge and its volumes to an optical media library. Each optical cartridge contains two volumes.

A 12-character date and time stamp is assigned by the system to a new volume when it is added to the optical library. This stamp is used as the volume identifier to track each volume until it is read. You can keep the system-generated volume identifier or you can specify a new volume identifier when the volume is initialized.

Restriction: The user must have *USE authority to use this command. The command is shipped with *EXCLUDE public authority.

 

Required Parameters

MLB

Specifies the name of the optical media library where the optical cartridge is to be added.

 

Optional Parameters

AUTL

Specifies the authorization list used to verify authority to the optical cartridge and its volumes.

*PRV: The previous authorization list is used. If no previous authorization list was saved or if the previous authorization list does not exist, the default authorization list, QOPTSEC, is used.

QOPTSEC: The default authorization list for the optical volumes, QOPTSEC, is used.

*NONE: No security checking is performed for the optical volumes.

authorization-list-name: Specify the name of the authorization list used.

DIR

Specifies whether the optical directory index is built for the optical volumes being added. The directory index is required to run Work with Optical Directories (WRKOPTDIR) and Display Optical (DSPOPT) when displaying directories. If not built now, the index will be built later the first time one of these commands is issued.

*NO: The optical directory index will not be built for the optical volumes being added but instead will be built at a later time if needed. Using this option may result in better performance for the command than if DIR(*YES) were specified.

*YES: The optical directory index is created now for each volume.

Example for ADDOPTCTG

ADDOPTCTG   MLB(OPT01)  AUTL(MYAUTH)

This command adds an optical cartridge and its volumes to the system in optical media library OPT01. The optical cartridge is secured with the authorization list MYAUTH.

Error messages for ADDOPTCTG

*ESCAPE Messages

OPT1245

Error processing directories for optical volume &1.

OPT1480

Add optical disk cartridge failed to complete successfully.

OPT1530

&1 does not represent a valid optical device.

OPT1555

Optical device &1 in use.

OPT1652

Device &1 is not an optical media library.

OPT1790

Operation conflicts with another request.

OPT1815

Internal program error occurred.

OPT1860

Request to optical device &1 failed.

OPT1861

No device description configured for resource &1.

OPT1862

No active device description for resource &1.

OPT1863

Optical libraries need to be reclaimed.

OPT2040

Error accessing backup control file.

OPT2301

Internal system object in use.

OPT2410

Authorization list &1 for volume &2 was not found.

OPT7740

User not authorized to object &2 in library &3 type &4.