Add Optical Cartridge (ADDOPTCTG)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
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.
| Top |
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.
| Top |
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.
| Top |
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.
| Top |
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.
| Top |
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.
| Top |
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.
| Top |