CL Command Reference - ADDMEDBRM
CL Command List > ADDMEDBRM Reference
Description:
The Add Media to BRM (ADDMEDBRM) command adds a media volume to the BRMS media inventory. The volume can be a volume from another media inventory that contains active data, the volume can be a volume from some other outside source, or a new volume that you want to initialize. Once added, BRMS tracks the volume¡¯s characteristics, location, use and content.
When you add the volume, you must specify the media class of the volume. You can also specify how you want the volume to move, where the volume is located, its container (if any) and other miscellaneous attributes.
If the numbering scheme of the volumes that you are adding is consecutive, the ADDMEDBRM command will automatically add the volumes without having to add the volumes one at a time.
Virtual tape media and devices can be used with this command. The following restrictions apply to the use of virtual media and virtual devices.
. The Device (DEV) parameter is limited on only one device or *MEDCLS special value for serial operations.
. Execute authority is required to the Load or Unload Image Catalog (LODIMGCLG) command.
. *CHANGE authority is required to the image catalogs.
. Execute (*X) authority is required to each directory in the image catalog path name.
. Read, write, execute (*RWX) authority is required to each image file in the parent directory that will be loaded or mounted.
. *USE authority is required to the virtual devices using the image catalogs.
To use this command, you must have the Backup Recovery and Media Services for iSeries, 5722-BR1, licensed program installed.
Restrictions:
1. i5/OS uses certain volume identifiers for special purposes. You should avoid using these volume identifiers in your volume labeling. Volume identifiers that you should avoid are:
TAPxxx NLTxxx BLKxxx CLNxxx ERRxxx SLTxxx IMPxxx
2. To add a virtual volume, you must specify the name of an existing tape image catalog on the Image catalog (IMGCLG) parameter, These additional restrictions apply when adding virtual media:
. The name specified for the Volume identifier (VOL) parameter must exist as a tape volume name in the image catalog entries.
. The density of the virtual volume (image catalog entry) must be the same as the density of the media class.
. You must specify 1 for Number to add (VOLCNT). Virtual volumes can only be added individually.
. You must specify *LCL or the current system name for System (SYSNAME). Virtual tape media resides in storage on the current system.
. Cleaning and volume statistic are not maintained for virtual tape media.
Examples:
Example 1: Adding a Volume to BRMS
ADDMEDBRM VOL(T00001) MEDCLS(QIC1000)
This command adds volumes to the BRMS media inventory. In this example, volume T00001 is assigned a media class of QIC1000 and is added to the BRMS media inventory. The volume is not initialized and is added as expired.
Example 2: Adding and Initializing a Volume to BRMS
ADDMEDBRM VOL(T00002) MEDCLS(QIC1000)
INZ(*YES) DEV(TAP01)
This command adds the volume T00002 to the BRMS media inventory with a media class of QIC1000. The volume is initialized using device TAP01.
Example 3: Adding a Virtual Volume to BRMS
ADDMEDBRM VOL(VRT001) MEDCLS(VRT256K)
INZ(*YES) DEV(VRTTAP) IMGCLG(VRTIMGCLG)
This command adds the virtual volume VRT001 to the BRMS media inventory with a media class of VRT256K. The volume is initialized using device VRTTAP. Image catalog VRTIMGCLG contains the image catalog entry for VRT001.