friedkiwi/ibm-information-center
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
master
ibm-information-center/dist/eclipse/plugins/i5OS.ic.cl_5.4.0.1/dmpbrm.htm

310 lines
11 KiB
HTML
Raw Permalink Blame History

<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Dump BRMS (DMPBRM)</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="DMPBRM.Top_Of_Page"></a>
<h2>Dump BRMS (DMPBRM)</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="#DMPBRM.PARAMETERS.TABLE">Parameters</a><br>
<a href="#DMPBRM.COMMAND.EXAMPLES">Examples</a><br>
<a href="#DMPBRM.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="DMPBRM"></a>
<p>The Dump BRM (DMPBRM) command saves BRMS files and related files to assist IBM support personnel in problem determination. You can specify various levels of detail and one or more job logs to dump. This command saves various files from QUSRBRM and related system files (depending on the specified level) to a device or save file. This information is used in problem determination by your technical representative. Processing this command should be done in conjunction with this representative.
</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="#DMPBRM.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="DMPBRM.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="#DMPBRM.DEV"><b>DEV</b></a></td>
<td valign="top">Device</td>
<td valign="top"><i>Name</i>, *SAVF</td>
<td valign="top">Required, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#DMPBRM.VOL"><b>VOL</b></a></td>
<td valign="top">Volume identifier</td>
<td valign="top"><i>Character value</i>, <b><u>*MOUNTED</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#DMPBRM.LVL"><b>LVL</b></a></td>
<td valign="top">Level</td>
<td valign="top">1-9, <b><u>*ALL</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#DMPBRM.TGTRLS"><b>TGTRLS</b></a></td>
<td valign="top">Target release</td>
<td valign="top"><i>Character value</i>, <b><u>*CURRENT</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#DMPBRM.DMPDEV"><b>DMPDEV</b></a></td>
<td valign="top">Dump device</td>
<td valign="top">Single values: <b><u>*ALL</u></b>, *NONE<br>Other values (up to 10 repetitions): <i>Name</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#DMPBRM.JOBLOG"><b>JOBLOG</b></a></td>
<td valign="top">Joblog to dump</td>
<td valign="top"><b><u>*NONE</u></b>, *JOB</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="5"><a href="#DMPBRM.JOB"><b>JOB</b></a></td>
<td valign="top">Job name</td>
<td valign="top">Single values: <b><u>*</u></b><br>Other values (up to 10 repetitions): <i>Element list</i></td>
<td valign="top" rowspan="5">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Job name</td>
<td valign="top">
<i>Qualified job name</i></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Qualifier 1: Job name</td>
<td valign="top"><i>Name</i></td>
</tr><tr>
<td valign="top" style="padding-left:10pt">Qualifier 2: User</td>
<td valign="top"><i>Name</i></td>
</tr><tr>
<td valign="top" style="padding-left:10pt">Qualifier 3: Number</td>
<td valign="top">000000-999999</td>
</tr></table>
<table width="100%">
<tr><td align="right"><a href="#DMPBRM.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="DMPBRM.DEV"></a>
<h3>Device (DEV)</h3>
<p>Specifies the name of the device or save file to which you want the dump information to be saved.
</p>
<dl>
<dt><b>*SAVF</b></dt>
<dd>Write the dump information to a save file.
</dd>
<dt><b><i>device-name</i></b></dt>
<dd>Specify the name of the device to which you want to write the dump information.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DMPBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DMPBRM.VOL"></a>
<h3>Volume identifier (VOL)</h3>
<p>Specifies the volume identifier to dump the data to.
</p>
<dl>
<dt><b><u>*MOUNTED</u></b></dt>
<dd>Any labeled volume that is placed in the specified device is used.
</dd>
<dt><b><i>volume-identifier</i></b></dt>
<dd>Specify the identifier of the labeled volume to use.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DMPBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DMPBRM.LVL"></a>
<h3>Level (LVL)</h3>
<p>Specifies the level of detail to be included in the dump. The level of detail can range from 1 to 9 with 1 being the least amount of detail and 9 being the most detail. You should ask your support representative for the level of detail to specify.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>Include all information required by your service provider.
</dd>
<dt><b><i>level-of-detail</i></b></dt>
<dd>Specify the level of detail that you want to include in the dump.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DMPBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DMPBRM.TGTRLS"></a>
<h3>Target release (TGTRLS)</h3>
<p>Specifies the release of the operating system on which you intend to restore the objects being saved.
</p>
<dl>
<dt><b><u>*CURRENT</u></b></dt>
<dd>The objects are to be restored on a system that is running the same release of the operating system currently running on your system. For example, if V5R2M0 is running on the system, *CURRENT means that you intend to restore the objects on a system with V5R2M0 installed. The objects can also be restored on a system with any subsequent release of the operating system installed.
</dd>
</dl>
<dl>
<dt><b>*PRV</b></dt>
<dd>The objects are to be restored on a system that is running on the previous release with modification level 0 of the operating system. For example if V5R2M0 is running on your system, *PRV means you intend to restore the objects on a system with V5R1M0 installed. The object can also be restored on a system with any subsequent release of the operating system installed.
<p>
<b>Note: </b>Not all objects can be targeted to another release. Objects that are new to a release typically cannot be saved to a previous release.
</p>
</dd>
</dl>
<dl>
<dt><b><i>target-release</i></b></dt>
<dd>Specify the release in the format VxRxMx, where Vx is the version, Rx is the release, and Mx is the modification level. For example, V5R2M0 is version 5, release 2, modification level 0.
<p>The objects can be restored on a system with the specified release or with any subsequent release of the operating system installed.
</p>
<p>
<b>Note: </b>Not all objects can be targeted to another release. Objects that are new to a release typically cannot be saved to a previous release.
</p>
<p>Valid values depend on the current version, release, and modification level, and they change with each new release. If you specify a release-level that is earlier than the earliest release level supported by this command, an error message is sent indicating the earliest supported release.
</p>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DMPBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DMPBRM.DMPDEV"></a>
<h3>Dump device (DMPDEV)</h3>
<p>Specifies a device or devices for which you would like to get diagnostic information. When specified, BRMS invokes the QTADMPDV API to gather this information using the special value *SPLF as the problem identifier.
</p>
<p>
<b>Note: </b>When an *APPC or *NET type device is specified for this parameter, BRMS will dump the save/restore flight recorder.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>All devices defined to BRMS are included in the information to be gathered.
</dd>
<dt><b>*NONE</b></dt>
<dd>No devices are specified.
</dd>
</dl>
<p><b>Other values (up to 10 repetitions)</b>
</p>
<dl>
<dt><b><i>device-name</i></b></dt>
<dd>Specify the device for which you want to gather diagnostic information.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DMPBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DMPBRM.JOBLOG"></a>
<h3>Joblog to dump (JOBLOG)</h3>
<p>Specifies whether you want to dump job log information.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>Do not dump job log information.
</dd>
<dt><b>*JOB</b></dt>
<dd>Dump job log information from the specified jobs.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DMPBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DMPBRM.JOB"></a>
<h3>Job (JOB)</h3>
<p>Specifies the name of the job whose job log information is to be retrieved.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*</u></b></dt>
<dd>Dump information from the current job.
</dd>
</dl>
<p><b>Other values (up to 10 repetitions)</b>
</p>
<p><b>Qualifier 1: Job name</b>
</p>
<dl>
<dt><b><i>job-name</i></b></dt>
<dd>Specify the name of the job to be dumped. If no job qualifier if given, all of the jobs currently in the system are searched for the simple job name.
</dd>
</dl>
<p><b>Qualifier 2: User</b>
</p>
<dl>
<dt><b><i>user-name</i></b></dt>
<dd>Specify the name that identifies the user profile under which the job is run.
</dd>
</dl>
<p><b>Qualifier 3: Number</b>
</p>
<dl>
<dt><b><i>number</i></b></dt>
<dd>Specify the job number assigned by the system.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DMPBRM.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="DMPBRM.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
DMPBRM DEV(TAP01) LVL(2) JOBLOG(*JOB)
</pre>
</p>
<p>This command causes level 2 dump information, along with the job log for the current job, to be written to tape unit TAP01.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#DMPBRM.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="DMPBRM.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>BRM4060</b></dt>
<dd>BRMS product initialization required.
</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="#DMPBRM.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>
Reference in New Issue View Git Blame Copy Permalink