Display Log for BRM (DSPLOGBRM)

Where allowed to run: All environments (*ALL)
Threadsafe: No

The Display Log for BRM (DSPLOGBRM) command displays the BRMS log. The BRMS log is a display by date and time of messages that BRMS has created as a result of processing. The DSPLOGBRM command allows you to display or print all or part of the log.

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
TYPE	Type	ALL, ARC, BKU, ENT, MAINT, MED, MGR, RCY, RTV, SEC	Optional, Positional 1
PERIOD	Time period for log output	Single values: *DAYS Other values: Element list	Optional
	Element 1: Start time and date	Element list
	Element 1: Beginning time	Time, *AVAIL
	Element 2: Beginning date	Character value, CURRENT, BEGIN
	Element 2: End time and date	Element list
	Element 1: Ending time	Time, *AVAIL
	Element 2: Ending date	Character value, CURRENT, END
DAYS	Time period in days	1-365, 7	Optional
SEV	Severity	0-99, 00	Optional
OUTPUT	Output	, PRINT	Optional
DETAIL	Detail	BASIC, FULL	Optional
USER	User	Name, *ALL	Optional
MSGID	Message identifier	Name, *ALL	Optional

Top

Type (TYPE)

Specifies the type of entry for which you want to review log entries.

Note: The default parameter for Type (TYPE) parameter depends on the area 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 for display or print.
*ARC: Selects only archive log entries for display or print.
Note: The BRMS Advanced feature (Option 2) is required to use this value.
*BKU: Selects only back up log entries for display or print.
*ENT: Selects only enterprise entries for display or print.
*MAINT: Selects only maintenance log entries for display or print.
*MED: Selects only media management log entries for display or print.
*MGR: Selects only migration log entries for display or print.
Note: The BRMS Advanced feature (Option 2) is required to use this value.
*RCY: Selects only recovery log entries for display or print.
*RTV: Selects only retrieve log entries for display or print.
Note: The BRMS Advanced feature (Option 2) is required to use this value.
*SEC: Selects only security log entries to be displayed or printed. Any log entries whose primary area or secondary area are security will be displayed. An entry may be logged for any reason and have security as a secondary area.

Top

Time period for log output (PERIOD)

Specifies the period of time for which the log entries are selected for the display or report.

Single values

*DAYS: Use the Time period in days (DAYS) parameter to select log entries for the display or printed report.

Other values

Element 1: Beginning time and date

Log entries created on or after the beginning date and time are selected. Log entries created prior to the beginning date and time are not selected.

Element 1: Beginning time

Specifies the beginning time at which or after log entries are selected.

*AVAIL

Any entries available for the beginning date are selected.

begin-time

Specifies the beginning time for the beginning date for which log entries are selected.

The time is specified in 24-hour format and can be specified with or without a time separator:

Without a time separator, specify a string of 4 or 6 digits (hhmm or hhmmss) where hh=hours, mm=minutes and ss=seconds. Hours, minutes, and seconds must each be exactly 2 digits (using leading zeros if necessary).
With a time separator, specify a string of 5 or 8 digits where the time separator specified for your job is used to separate the hours, minutes, and seconds. If you enter this command from the command line, the string must be enclosed in apostrophes. If a time separator other than the separator specified for your job is used, this command will fail.

Element 2: Beginning date

Specifies the beginning date for which the log entries are selected.

*CURRENT: Log entries with the current date are selected.
*BEGIN: Log entries from the beginning of all available log entries are selected.
begin-date: Specifies the beginning date for which log entries are selected. The date must be specified in the job date format.

Element 2: Ending time and date

Log entries created on or before the ending date and time are selected. Log entries created after the ending date and time are not selected.

Element 1: Ending time

One of the following is used to specify the ending time before which log entries are included. Any items created after the specified time and date are not included in the log entries for the report.

Specifies the ending time at which or before log entries are selected.

*AVAIL

Any entries available for the ending date are selected.

end-time

Specifies the ending time for the ending date for which log entries are selected.

The time is specified in 24-hour format and can be specified with or without a time separator:

Without a time separator, specify a string of 4 or 6 digits (hhmm or hhmmss) where hh=hours, mm=minutes and ss=seconds. Hours, minutes, and seconds must each be exactly 2 digits (using leading zeros if necessary).
With a time separator, specify a string of 5 or 8 digits where the time separator specified for your job is used to separate the hours, minutes, and seconds. If you enter this command from the command line, the string must be enclosed in apostrophes. If a time separator other than the separator specified for your job is used, this command will fail.

Element 2: Ending date

Specifies the ending date for which the log entries are selected.

*CURRENT: Log entries with the current date are selected.
*END: Log entries to the end of all available log entries are selected.
end-date: Specifies the ending date for which log entries are selected. The date must be specified in the job date format.

Top

Time period in days (DAYS)

Specifies the number of days from which log entries are selected for the display or printed report. For example, a time period of 7 days would include log entries from midnight seven days ago through the current date and time. Time period in days can be specified from 1 to 365.

Note: Time period in days is ignored unless *DAYS is specified for the Time period for log output (PERIOD) parameter.

7: The default time period in days is seven.
time-period-in-days: Specify the time period in days that you want to use to select log entries.

Top

Severity (SEV)

Specifies the message severity level that you want to include in the display or print. For example, a severity level of 30 would include all messages that are severity level 30 and above. The severity level can be specified from 0 to 99.

00: The default severity level is zero.
severity-level: Specify the message severity level that you want to display.

Top

Output (OUTPUT)

Specifies whether the output from the command is displayed at the requesting work station or printed with the job's spooled output.

*: The output is displayed (if requested by an interactive job) or printed (if requested by a batch job).
*PRINT: The output is printed with the job's spooled output.

The report that is produced is the BRMS Log report. The report, if printed, is written to the printer file QP1ALG.

Top

Detail (DETAIL)

Specifies the format used for the printed output.

*BASIC: The entries are printed in abbreviated list format.
*FULL: The detail of each entry is printed in an expanded format.

Top

User (USER)

Specifies the name of the user profile for the log entries that you want to display or print.

*ALL: Include all user profiles in the display or report.
user-name: Specify the user profile whose log entries you want to include in the display or report.

Top

Message identifier (MSGID)

Specifies the message identifier for the log entries that you want to display or print.

*ALL: Include all message identifiers in the display or report.
message-identifier: Specify the message identifier whose log entries you want to include in the display or report.

Top

Examples

Example 1: Displaying BRMS Log Entries for a Date Range and Severity Level

DSPLOGBRM TYPE(*BKU) PERIOD((*AVAIL *BEGIN) (*AVAIL *END))
          SEV(20)

This command displays backup log entries and the range of dates is from the beginning of the log to the end of the log. Log entries related to backups will be displayed in the Display BRM Log Information display that have a severity level of 20 or above.

Top

Error messages

*ESCAPE Messages

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

Top