Display Log for BRM (DSPLOGBRM)

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

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 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
PERIOD Time period for log output 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
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.
*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.

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

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