Remove Log Entries from BRM (RMVLOGEBRM)

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

The Remove Log Entries from BRM (RMVLOGEBRM) command clears the BRMS log based on a type of entry and a date range that you specify.

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
TYPE Type *ALL, *ARC, *BKU, *MAINT, *MED, *MGR, *RCY, *RTV, *SEC Optional, Positional 1
SLTDATE Select dates Element list Optional
Element 1: From date Character value, *CURRENT, *BEGIN
Element 2: To date Character value, *CURRENT
Top

Type (TYPE)

Specifies the type of entries that you want to clear from the BRMS log. Examples of types of entries are backup, archive and so on.

Note: The default for the TYPE parameter depends on the area of BRMS that you use to access this command. For instance, if you access this command from a backup menu, the default Type is *BKU. If you access the command from the archive menu, the default Type is *ARC and so on. If you type the command on a command line or from the System Policy display, the default is *ALL.

*ALL
Selects all log entries to clear within the specified date range.
*ARC
Selects only archive log entries to clear within the specified date range.

Note: The BRMS Advanced feature (Option 2) is required to use this value.

*BKU
Selects only back up log entries to clear within the specified date range.
*MAINT
Selects only maintenance log entries to clear within the specified date range.
*MED
Selects only media management log entries to clear within the specified date range.
*MGR
Selects only migration log entries to clear within the specified date range.

Note: The BRMS Advanced feature (Option 2) is required to use this value.

*RCY
Selects only recovery log entries to clear within the specified date range.
*RTV
Selects only retrieve log entries to clear within the specified date range.

Note: The BRMS Advanced feature (Option 2) is required to use this value.

*SEC
Selects only security log entries to remove within the specified date range. Only log entries whose primary area are security will be removed. An entry may be logged for any reason and have security as a secondary area.
Top

Select date (SLTDATE)

Specifies a range of dates that you want to use when selecting entries to remove from the BRMS log. The From date is the beginning point in the date range and the To date is the end of the date range.

Note: Using this parameter, it is possible to enter a date with no separator, or a number of days which can be up to 5 digits in length. For instance, if you are using month/day/year format, the number 12904 would be formatted as January 29, 2004. If on the other hand, you entered a number 13904, BRMS assume that this is not a date, but rather is a number. BRMS always tries to calculate a calendar date first when a number is entered and then if the date it calculates is not valid, assumes that it is a number of days. If the number that is entered is over 5 digits and the date that it calculates is not valid, you receive an error message.

Element 1: From date

*CURRENT
The current date is the starting point of the range of dates used to remove entries from the BRMS history log.
*BEGIN
The earliest log entry in the BRMS log is the beginning date of the date range.
from-date
Specify the date entered in job date format with or without date separators that you want to be the beginning date of the date range.
number-of-days
Specify the number of days before the current day that is the beginning date of the date range.

Element 2: To date

*CURRENT
The current date is the ending date of the date range.
*END
The last date in the log is the ending date of the date range.
to-date
Specify the date in job date format with or without date separators that you want to be the ending date of the date range.
number-of-days
Specify the number of days before the current day that is the ending date of the date range.
Top

Examples

Example 1: Removing Entries from the BRMS Log Based on a Date Range

RMVLOGEBRM SLTDATE('1/1/03' '4/01/03')

This command removes all log entries from January 1, 2003 to April 1, 2003 from the log.

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