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
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:
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.WRKMEDIBRM
nor WRKLNKBRM
command.EXTMEDIBRM
command.EXTMEDIBRM
command is run on it.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.
When a save of the library already exits in BRMS, the data from the EXTMEDIBRM
will not be included in the BRMS Recovery Report.
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:
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.
Value for FILE parameter on | BRMS Entry Value | BRMS Save Command | Native Save Command |
---|---|---|---|
*SAVSYS | *SAVSYS |
| SAVSYS |
*SAVSECDTA | *SAVSECDTA | SAVSECDTA | |
*SAVCFG | *SAVCFG | SAVCFG | |
*SAVOBJ | *OBJ List |
| SAVOBJ |
*FILE | *OBJ List of only *file objects |
| SAVOBJ OBJTYPE(*FILE) |
*SAVLIB | *IBM , *ALLUSR, libraries |
| SAVLIB |
*SAVDLO | *ALLDLO or *FLR list |
| SAVDLO |
*SAV | *LINK or *LNK List |
| SAV |
*SAVCHGOBJ | Incremental (cumulative) of *OBJ list | *CUML or *INCR of | SAVCGHOBJ |
*SAVCHGDLO | Incremental (cumulative) of *FLR list | *CUML or *INCR of | SAVDLO using REFCHGDATE |
*SAVCHG | Incremental (cumulative) of *LNK list | *CUML or *INCR of | SAV using CHGPERIOD |
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.
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:
WRKLNKBRM
.ADDMEDIBRM
command.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. SETMEDBRM
is used.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.