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 iSeries, 5722-BR1, licensed program installed.

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 tape 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.

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.

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.

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.

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.

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.