Adding Saved Information About Volumes into BRMS

The Extract Media Information (EXTMEDIBRM) and  Add Media Information to BRM (ADDMEDIBRM) commands add information about a volume in the BRMS media file.  You specify the identifier of the volume and what is contained on the volume.                  
                                                                    
BRMS records content information only for media already added to the BRMS media inventory, and then only for media whose contents are currently shown as expired.  If active contents information for the media already exists, or if the media has not been added to the media inventory, no content information is added.                   
 
Note:  Object level detail cannot be retrieved using EXTMEDIBRM and ADDMEDIBRM.  Because of this, the following commands will not work:
  WRKMEDIBRM, Option 9
  WRKLNKBRM
  RSTOBJBRM
  RSTDLOBRM
 

Extract Media Information (EXTMEDIBRM)

 
The Extract Media Information (EXTMEDIBRM) command adds information about a volume in the BRMS media file.  You specify the identifier of the volume and what is contained on the volume.  BRMS will load the volume in a tape drive and record the content information only for media already added to the BRMS media inventory and only for media whose contents are currently shown as expired.  If active contents information for the media already exists, or if the media has not been added to the media inventory, no content information is added.
 
EXTMEDIBRM
  Device . . . . . . . . . . . . .   TAPxx                           
  Volume identifier  . . . . . . .   VOLxxx       
  File origin  . . . . . . . . . .   *FILE     *FILE, *SAV, *SAVCAL, *SAVCFG, *SAVCHG, *SAVCHGCAL, *SAVCHGDLO, *SAVCHGOBJ, *SAVDLO, *SAVLIB, *SAVOBJ, *SAVSECDTA, *SAVSYS
  End of tape option . . . . . . .   *REWIND   *UNLOAD, *LEAVE, *REWIND 
 
 
Notes:

1. When running the EXTMEDIBRM command on a full system save, it is recommended that *FILE is used for the file origin parameter.  If you specify one of the other options, all the entries are entered into the BRMS database as that type of save. It's not possible to use BRMS to restore any data when FILE(*FILE) is used. A CPD0033 message may be displayed when attempting to use BRMS. This is intended for reference only.
2. Integrated File System data cannot be restored using the WRKMEDIBRM nor WRKLNKBRM command.
3. It is not possible to use BRMS to restore from parallel saves.  A media definition is required for these, and BRMS cannot create these from data obtained using the EXTMEDIBRM command.
4. When a sequence starts on a volume and then spans the next two volumes, the volume that has only a continued sequence on it will not list anything when the EXTMEDIBRM command is run on it.

5. When a library spans media, it is not possible to restore that sequence number using BRMS  or use DUPMEDBRM on spanned volumes or a spanned sequence number when EXTMEDIBRM is used.  This is because the file sequence is continued from a previous volume; however, BRMS does not know what the previous volume was. The sequence will be listed on the first volume, however, it will not be listed on the continuation volume.  The ADDMEDIBRM command must be used for data that spans media.

6. When a save of the library already exits in BRMS, the data from the EXTMEDIBRM will not be included in the BRMS Recovery Report.  

7. If there is a requirement to use BRMS commands or menus to restore the data fro the media , the EXTMEDIBRM command needs to use the correct value in the File Origin Parameter (FILE). Use the DSPTAP command to verify what command was used to save the data.  If multiple types of saves were done to the volume *FILE is recommended (See Note 1). Possible values are:

• *FILE       
• *SAV        
• *SAVCFG     
• *SAVCHG     
• *SAVCHGDLO  
• *SAVCHGOBJ  
• *SAVDLO     
• *SAVLIB     
• *SAVOBJ     
• *SAVSECDTA  
• *SAVSYS    

 
Example when saves span media

 
Volume    Library         Volume Sequence          Library Sequence
VOL001                            1
                  LIBA                                                                1
                  LIBB                                                                2
                  LIBC                                                                3
VOL002                            2
                  LIBC                                                                3 (cont)
VOL003                            3
                  LIBC                                                                3 (cont)
                  LIBD                                                                4
                  LIBE                                                                5
 
In the above example, running the EXTMEDIBRM command on VOL002 does not list anything, and the volume remains expired.
 

The table below shows the proper value for the FILE parameter, depending on how the objects were saved.

 
When running an EXTMEDIBRM on a volume to extract history saved outside of BRMS, if the volume is not expired, users will see the following message:
 
Message ID . . . . . . . . . :   BRM1392
Message file . . . . . . . . :   Q1AMSGF
  Library  . . . . . . . . . :     QBRM
 
Message . . . . :   Unable to use volume &1. (C R)
Cause . . . . . :   Volume &1 is not available for use as scratch media. Processing of control group &2 type &3 is interrupted.
Recovery  . . . :   Do one of the following:
    -- Type C to cancel the operation.
    -- Pick a different volume, then type R to try the operation again.
 

Adding Media Information to BRM (ADDMEDIBRM)

The Add Media Information to BRM (ADDMEDIBRM) command adds file level detail to the BRMS media inventory content volume information.  The files and the volumes that contain them can be from another tape inventory or from some other outside source.  The purpose of the command is to allow user applications or another volume management system to insert data (volume file descriptions) into the BRMS media contents information so that the volumes and their contents can be managed. ADDMEDIBRM must be used for each sequence on the volume. Multiple volumes write a media information record for each volume; the volume sequence is increased as the records are added.                                                 
 
ADDMEDIBRM
  Volume . . . . . . . . . . . . . >   VOLXX     Character value
  Volume sequence  . . . . . . . . >   2         1-9999  [This example is for the second volume in the set]
  Sequence number  . . . . . . . . >   13        1-16777215
  File label . . . . . . . . . . .     *TYPE
  Type . . . . . . . . . . . . . .     *LIB      *LIB, *ALLDLO, *LINK, *QHST, *SAVSFG, *SAVSECDTA, *SAVSYS
  Library  . . . . . . . . . . . . >   LIBXX     Name                   
 

How to add a sequence number that spans media using the above example
 

ADDMEDIBRM VOL(VOL001 VOL002 VOL003)
           VOLSEQ(1)                
           SEQNBR(3)                
           LIB(LIBC)                
           FILE(*SAVLIB)           

   Note: Using BRMS to do restores or DUPMEDBRM cannot be guaranteed to work for all imported data that spans media

 
Notes:  

1. Integrated File System data cannot be restored using WRKLNKBRM.
2. It is not possible to use BRMS to restore from parallel saves.  A media definition is required for these, and BRMS cannot create these from data obtained using the ADDMEDIBRM command.
3. The Recovery Report shows only the first volume of the media set.  During the recovery (STRRCYBRM), the following message is issued:  CPA6798 - No volume to mount on device TAPxx (C "cartridge id").  Type the next volume in the set, and press the Enter key.  The restore should continue on that volume.  If you have R540 or later, a special instructions step in the recovery report that lists the volumes in the set can be added. 
4. SAVSYS entries will not appear on the recovery report. BRMS cannot verify the release of the SAVSYS.  If you have R540 or later, a special instructions step in the recovery report that lists the volumes in the set can be added.
5. If a volume is enrolled in BRMS and a native operating system save command is run and that volume is used, the volume expiration date changes, by default,  to *PERM unless SETMEDBRM is used.
6. When running an ADDMEDIBRM on a volume to extract history saved outside of BRMS, if the volume is not expired and sequence 1 is specified, users will see the following error message:

Message ID . . . . . . . . . :   BRM1756 
Message file . . . . . . . . :   Q1AMSGF
  Library  . . . . . . . . . :     QBRM 
 
Message . . . . :   Volume &1 is not expired.
Cause . . . . . :   An attempt to add a contents entry failed because the volume &1 is not expired.
Recovery  . . . :   Retry the request after expiring the media or specifying another volume. Use the WRKMEDBRM to expire the volume.