The Add Optical Cartridge (ADDOPTCTG) command adds an optical disk cartridge and its volume(s) to an optical library or stand alone device. An optical cartridge can be either single or double sided. Each side represents an optical volume.

A 12-character date and time stamp is assigned by the system to an uninitialized volume when it is added to the optical device. This stamp is used as the volume identifier to track each volume until it is initialized. 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.

Parameters

Keyword	Description	Choices	Notes
MLB	Optical device	Name	Required, Positional 1
AUTL	Authorization list	Name, *PRV, QOPTSEC, *NONE	Optional, Positional 2
DIR	Rebuild directory index	*NO, *YES	Optional
MEDLOC	Media location	*IOSTATION, *MAGAZINE	Optional

Top

Optical device (MLB)

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

Authorization list (AUTL)

Specifies the authorization list used to verify authority to the optical cartridge and its volume(s).

*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 volume(s), QOPTSEC, is used.

*NONE

No security checking is performed for the optical volume(s).

authorization-list-name

Specify the name of the authorization list used.

Rebuild directory index (DIR)

Specifies whether the optical directory index is built for the optical volume(s) 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 volume(s) 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.

Media location (MEDLOC)

Specifies the location of the optical volume(s) to be added to an optical library..

*IOSTATION

Add a single optical disk cartridge to an optical library from the input/output station.

*MAGAZINE

Add multiple optical disk cartridges to an optical library from the bulk load magazine.

Note: Not all optical libraries are equipped with a bulk load magazine.

Examples

Example 1: Specify an Authorization List

ADDOPTCTG   MLB(OPTMLB01)  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.

Example 2: Specify a Media Location of *MAGAZINE

ADDOPTCTG   MLB(OPTMLB01)  AUTL(QOPTSEC) MEDLOC(*MAGAZINE)

This command adds all of the optical cartridges and volumes from the bulk load magazine to the system in optical media library OPTMLB01. All of the volumes added to optical media library OPTMLB01 will be secured by authorization list QOPTSEC.

Error messages

*ESCAPE Messages

OPT1245

Error processing directories for optical volume &1.

OPT1480

Add optical disk cartridge failed.

OPT1530

&1 does not represent a valid optical device.

OPT1555

Optical device &1 in use.

OPT1652

Device &1 is not an optical media library.

OPT1671

Feature not installed for optical device &1.

OPT1672

Error accessing bulk load magazine for optical device &1.

OPT1675

Bulk load magazine is empty for optical device &1.

OPT1677

Bulk load magazine is open for optical device &1.

OPT1790

Operation not allowed or 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.