388 lines
14 KiB
HTML
388 lines
14 KiB
HTML
|
|
<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<html>
|
|
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
|
|
<title>Display Log for BRM (DSPLOGBRM)</title>
|
|
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
|
|
</head>
|
|
<body bgcolor="white">
|
|
<script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
|
<a name="DSPLOGBRM.Top_Of_Page"></a>
|
|
<h2>Display Log for BRM (DSPLOGBRM)</h2>
|
|
<table width="100%">
|
|
<tr>
|
|
<td valign="top" align="left"><b>Where allowed to run: </b>All environments (*ALL)<br>
|
|
<b>Threadsafe: </b>No
|
|
</td>
|
|
<td valign="top" align="right">
|
|
<a href="#DSPLOGBRM.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#DSPLOGBRM.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#DSPLOGBRM.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="DSPLOGBRM"></a>
|
|
<p>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.
|
|
</p>
|
|
<p>To use this command, you must have the Backup Recovery and Media Services for iSeries, 5722-BR1, licensed program installed.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPLOGBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="DSPLOGBRM.PARAMETERS.TABLE">Parameters</a></h3>
|
|
<table border="1" cellpadding="4" cellspacing="0">
|
|
<!-- col1="10" col2="15" col3="30" col4="10" -->
|
|
<tr>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Keyword</th>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Description</th>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Choices</th>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Notes</th>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DSPLOGBRM.TYPE"><b>TYPE</b></a></td>
|
|
<td valign="top">Type</td>
|
|
<td valign="top"><b><u>*ALL</u></b>, *ARC, *BKU, *MAINT, *MED, *MGR, *RCY, *RTV, *SEC</td>
|
|
<td valign="top">Optional, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="7"><a href="#DSPLOGBRM.PERIOD"><b>PERIOD</b></a></td>
|
|
<td valign="top">Time period for log output</td>
|
|
<td valign="top"><i>Element list</i></td>
|
|
<td valign="top" rowspan="7">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Start time and date</td>
|
|
<td valign="top">
|
|
<i>Element list</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" style="padding-left:10pt">Element 1: Beginning time</td>
|
|
<td valign="top">
|
|
<i>Time</i>, <b><u>*AVAIL</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" style="padding-left:10pt">Element 2: Beginning date</td>
|
|
<td valign="top">
|
|
<i>Character value</i>, <b><u>*CURRENT</u></b>, *BEGIN</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: End time and date</td>
|
|
<td valign="top">
|
|
<i>Element list</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" style="padding-left:10pt">Element 1: Ending time</td>
|
|
<td valign="top">
|
|
<i>Time</i>, <b><u>*AVAIL</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" style="padding-left:10pt">Element 2: Ending date</td>
|
|
<td valign="top">
|
|
<i>Character value</i>, <b><u>*CURRENT</u></b>, *END</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DSPLOGBRM.SEV"><b>SEV</b></a></td>
|
|
<td valign="top">Severity</td>
|
|
<td valign="top">0-99, <b><u>00</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DSPLOGBRM.OUTPUT"><b>OUTPUT</b></a></td>
|
|
<td valign="top">Output</td>
|
|
<td valign="top"><b><u>*</u></b>, *PRINT</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DSPLOGBRM.DETAIL"><b>DETAIL</b></a></td>
|
|
<td valign="top">Detail</td>
|
|
<td valign="top"><b><u>*BASIC</u></b>, *FULL</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DSPLOGBRM.USER"><b>USER</b></a></td>
|
|
<td valign="top">User</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*ALL</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DSPLOGBRM.MSGID"><b>MSGID</b></a></td>
|
|
<td valign="top">Message identifier</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*ALL</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPLOGBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="DSPLOGBRM.TYPE"></a>
|
|
<h3>Type (TYPE)</h3>
|
|
<p>Specifies the type of entry for which you want to review log entries.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>The default parameter for <b>Type (TYPE)</b> 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.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>Selects all log entries for display or print.
|
|
</dd>
|
|
<dt><b>*ARC</b></dt>
|
|
<dd>Selects only archive log entries for display or print.
|
|
<p>
|
|
<b>Note: </b>The BRMS Advanced feature (Option 2) is required to use this value.
|
|
</p>
|
|
</dd>
|
|
<dt><b>*BKU</b></dt>
|
|
<dd>Selects only back up log entries for display or print.
|
|
</dd>
|
|
<dt><b>*MAINT</b></dt>
|
|
<dd>Selects only maintenance log entries for display or print.
|
|
</dd>
|
|
<dt><b>*MED</b></dt>
|
|
<dd>Selects only media management log entries for display or print.
|
|
</dd>
|
|
<dt><b>*MGR</b></dt>
|
|
<dd>Selects only migration log entries for display or print.
|
|
<p>
|
|
<b>Note: </b>The BRMS Advanced feature (Option 2) is required to use this value.
|
|
</p>
|
|
</dd>
|
|
<dt><b>*RCY</b></dt>
|
|
<dd>Selects only recovery log entries for display or print.
|
|
</dd>
|
|
<dt><b>*RTV</b></dt>
|
|
<dd>Selects only retrieve log entries for display or print.
|
|
<p>
|
|
<b>Note: </b>The BRMS Advanced feature (Option 2) is required to use this value.
|
|
</p>
|
|
</dd>
|
|
<dt><b>*SEC</b></dt>
|
|
<dd>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.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPLOGBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPLOGBRM.PERIOD"></a>
|
|
<h3>Time period for log output (PERIOD)</h3>
|
|
<p>Specifies the period of time for which the log entries are selected for the display or report.
|
|
</p>
|
|
<p><b>Element 1: Beginning time and date</b>
|
|
</p>
|
|
<p>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.
|
|
</p>
|
|
<p><b>Element 1: Beginning time </b>
|
|
</p>
|
|
<p>Specifies the beginning time at which or after log entries are selected.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*AVAIL</u></b></dt>
|
|
<dd>Any entries available for the beginning date are selected.
|
|
</dd>
|
|
<dt><b><i>begin-time</i></b></dt>
|
|
<dd>Specifies the beginning time for the beginning date for which log entries are selected.
|
|
<p>The time is specified in 24-hour format and can be specified with or without a time separator:
|
|
</p>
|
|
<ul>
|
|
<li>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).
|
|
</li>
|
|
<li>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.
|
|
</li>
|
|
</ul>
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Beginning date </b>
|
|
</p>
|
|
<p>Specifies the beginning date for which the log entries are selected.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*CURRENT</u></b></dt>
|
|
<dd>Log entries with the current date are selected.
|
|
</dd>
|
|
<dt><b>*BEGIN</b></dt>
|
|
<dd>Log entries from the beginning of all available log entries are selected.
|
|
</dd>
|
|
<dt><b><i>begin-date</i></b></dt>
|
|
<dd>Specifies the beginning date for which log entries are selected. The date must be specified in the job date format.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Ending time and date </b>
|
|
</p>
|
|
<p>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.
|
|
</p>
|
|
<p><b>Element 1: Ending time </b>
|
|
</p>
|
|
<p>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.
|
|
</p>
|
|
<p>Specifies the ending time at which or before log entries are selected.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*AVAIL</u></b></dt>
|
|
<dd>Any entries available for the ending date are selected.
|
|
</dd>
|
|
<dt><b><i>end-time</i></b></dt>
|
|
<dd>Specifies the ending time for the ending date for which log entries are selected.
|
|
<p>The time is specified in 24-hour format and can be specified with or without a time separator:
|
|
</p>
|
|
<ul>
|
|
<li>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).
|
|
</li>
|
|
<li>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.
|
|
</li>
|
|
</ul>
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Ending date </b>
|
|
</p>
|
|
<p>Specifies the ending date for which the log entries are selected.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*CURRENT</u></b></dt>
|
|
<dd>Log entries with the current date are selected.
|
|
</dd>
|
|
<dt><b>*END</b></dt>
|
|
<dd>Log entries to the end of all available log entries are selected.
|
|
</dd>
|
|
<dt><b><i>end-date</i></b></dt>
|
|
<dd>Specifies the ending date for which log entries are selected. The date must be specified in the job date format.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPLOGBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPLOGBRM.SEV"></a>
|
|
<h3>Severity (SEV)</h3>
|
|
<p>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.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>00</u></b></dt>
|
|
<dd>The default severity level is zero.
|
|
</dd>
|
|
<dt><b><i>severity-level</i></b></dt>
|
|
<dd>Specify the message severity level that you want to display.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPLOGBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPLOGBRM.OUTPUT"></a>
|
|
<h3>Output (OUTPUT)</h3>
|
|
<p>Specifies whether the output from the command is displayed at the requesting work station or printed with the job's spooled output.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*</u></b></dt>
|
|
<dd>The output is displayed (if requested by an interactive job) or printed (if requested by a batch job).
|
|
</dd>
|
|
<dt><b>*PRINT</b></dt>
|
|
<dd>The output is printed with the job's spooled output.
|
|
</dd>
|
|
</dl>
|
|
<p>The report that is produced is the BRMS Log report. The report, if printed, is written to the printer file QP1ALG.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPLOGBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPLOGBRM.DETAIL"></a>
|
|
<h3>Detail (DETAIL)</h3>
|
|
<p>Specifies the format used for the printed output.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*BASIC</u></b></dt>
|
|
<dd>The entries are printed in abbreviated list format.
|
|
</dd>
|
|
<dt><b>*FULL</b></dt>
|
|
<dd>The detail of each entry is printed in an expanded format.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPLOGBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPLOGBRM.USER"></a>
|
|
<h3>User (USER)</h3>
|
|
<p>Specifies the name of the user profile for the log entries that you want to display or print.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>Include all user profiles in the display or report.
|
|
</dd>
|
|
<dt><b><i>user-name</i></b></dt>
|
|
<dd>Specify the user profile whose log entries you want to include in the display or report.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPLOGBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPLOGBRM.MSGID"></a>
|
|
<h3>Message identifier (MSGID)</h3>
|
|
<p>Specifies the message identifier for the log entries that you want to display or print.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>Include all message identifiers in the display or report.
|
|
</dd>
|
|
<dt><b><i>message-identifier</i></b></dt>
|
|
<dd>Specify the message identifier whose log entries you want to include in the display or report.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPLOGBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="DSPLOGBRM.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Displaying BRMS Log Entries for a Date Range and Severity Level</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
DSPLOGBRM TYPE(*BKU) PERIOD((*AVAIL *BEGIN) (*AVAIL *END))
|
|
SEV(20)
|
|
</pre>
|
|
</p>
|
|
<p>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.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPLOGBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="DSPLOGBRM.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>BRM1917</b></dt>
|
|
<dd>Feature not installed.
|
|
</dd>
|
|
<dt><b>BRM1921</b></dt>
|
|
<dd>Feature not licensed.
|
|
</dd>
|
|
<dt><b>BRM4040</b></dt>
|
|
<dd>Access denied for user &1.
|
|
</dd>
|
|
<dt><b>BRM4041</b></dt>
|
|
<dd>Access denied for user &1.
|
|
</dd>
|
|
<dt><b>BRM40A2</b></dt>
|
|
<dd>BRMS product initialization required.
|
|
</dd>
|
|
<dt><b>CPF9800</b></dt>
|
|
<dd>All CPF98xx messages could be signaled. xx is from 01 to FF.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPLOGBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|