Remove Media Info from BRM (RMVMEDIBRM)

Where allowed to run: All environments (*ALL)
Threadsafe: No
Parameters
Examples
Error messages

The Remove Media Information from BRM (RMVMEDIBRM) command is used to specify when to remove records from the BRMS media content information and how long to keep object detail. The Media contents (MEDCON) parameter indicates whether records are to be removed when they expire or when the expired volume is re-used. The Object level detail (OBJDTL) parameter indicates when the object level detail is to be removed. You can remove object level detail at the same time you remove record level information or you can specify a number of days to keep object information.

To use this command, you must have the Backup Recovery and Media Services for iSeries, 5722-BR1, licensed program installed.

Top

Parameters

Keyword Description Choices Notes
MEDCON Media contents *EXP, *REUSE Optional
OBJDTL Object level detail 1-9999, *MEDCON Optional
Top

Media contents (MEDCON)

Specifies whether records are removed when media expires or when the media is re-used.

*EXP
All BRMS media content information entries that have an Expiration date that are equal to or less than the current date are removed from the media content information.
*REUSE
Media content information entries associated with a media volume are not removed from the file until the volume is re-used, even though the volume has already expired.
Top

Object detail (OBJDTL)

Specifies when you want to remove object level detail for media records in the media content information.

*MEDCON
The object level detail information is removed based on the value specified in the Media contents (MEDCON) parameter.
number-of-days
Specify the number of days that object detail for an entry is kept on the file. If this number of days is greater than the number of days implied in the Media contents (MEDCON) parameter, such as the volume expires in 60 days and you specify 90 days in the Object level detail (OBJDTL) parameter, the parameter has no meaning since the contents record has already been removed. However, if you specify 45 days and the object expires in 60 days, the object level detail is removed after 45 days and the accompanying contents record is removed after 60 days.
Top

Examples

Example 1: Removing Media Information from BRMS

RMVMEDIBRM MEDCON(*REUSE) OBJDTL(45)

This command allows you to remove BRMS media contents information. In the example, media contents information remains on the BRMS media contents file until the media is reused and accompanying object detail is removed after 45 days.

Top

Error messages

*ESCAPE Messages

BRM1917
Feature not installed.
BRM1921
Feature not licensed.
BRM4040
Access denied for user &1.
BRM40A2
BRMS product initialization required.
CPF9800
All CPF98xx messages could be signaled. xx is from 01 to FF.
Top