Extract Media Information (EXTMEDIBRM)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
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 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.
To use this command, you must have the Backup Recovery and Media Services for IBM i licensed program installed.
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| DEV | Device | Name | Required, Positional 1 |
| VOL | Volume identifier | Character value, *MOUNTED | Optional, Positional 2 |
| FILE | File origin | *FILE, *SAV, *SAVCFG, *SAVCHG, *SAVCHGDLO, *SAVCHGOBJ, *SAVDLO, *SAVLIB, *SAVOBJ, *SAVSECDTA, *SAVSYS | Optional |
| ENDOPT | End of media option | *UNLOAD, *LEAVE, *REWIND | Optional |
| Top |
Device (DEV)
Specifies the name of the device on which you are loading the volume. The device name must be defined in the BRMS device table.
| Top |
Volume identifier (VOL)
Specifies the volume identifier of the volume on the device whose information is being added to BRMS.
- *MOUNTED
- The information on the volume identifier that is loaded on the device is added to BRMS.
- volume-identifier
- Specify the volume identifier of the volumes from which data is being added to the BRMS media content information.
| Top |
File origin (FILE)
Specifies the type of information that is stored on the volume.
- *FILE
- The information on the volume is a file.
- *SAV
- The information on the volume is IFS information.
- *SAVCFG
- The information on the volume is a save of configuration information.
- *SAVCHG
- The information on the volume is an incremental save of IFS information.
- *SAVCHGDLO
- The information on the volume is an incremental save of document information.
- *SAVCHGOBJ
- The information on the volume is an incremental object save.
- *SAVDLO
- The information on the volume is a full save of document information.
- *SAVLIB
- The information on the volume is a saved library.
- *SAVOBJ
- The information on the volume is a full object save.
- *SAVSECDTA
- The information on the volume is a save of security information.
- *SAVSYS
- The information on the volume is system save information.
| Top |
End of tape option (ENDOPT)
Specifies, when tape is used, what positioning operation is automatically done on the tape volume after the save operation ends. If more than one volume is included, this parameter applies only to the last volume used; all other volumes are rewound and unloaded when the end of the tape is reached.
Note: If no objects are saved the volume is not opened and the ENDOPT parameter is ignored.
If you specify *LEAVE and the device is a shared device, the device will not be varied off after the save operation. If you specify *LEAVE and the device is not a shared device, the device will be varied off after the save operation.
- *UNLOAD
- The volume is automatically rewound and unloaded after the operation ends.
- *LEAVE
- The volume does not rewind or unload after the operation ends. It remains at the current position on the device.
- *REWIND
- The volume is rewound, but not unloaded.
| Top |
Examples
Example 1: Adding Media Information
EXTMEDIBRM DEV(TAP06) FILE(*SAVLIB)
This command adds save library content information for the volume that is mounted on device TAP06 to the BRMS media inventory.
| Top |
Error messages
*ESCAPE Messages
- BRM1134
- Device &1 not found.
- BRM1917
- Feature not installed.
- BRM1921
- Feature not licensed.
- BRM40A2
- BRMS product initialization required.
- BRM6708
- Command ended due to error.
- CPF9800
- All CPF98xx messages could be signaled. xx is from 01 to FF.
| Top |