219 lines
7.2 KiB
HTML
219 lines
7.2 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>Dump Communications Trace (DMPCMNTRC)</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="DMPCMNTRC.Top_Of_Page"></a>
|
|
<h2>Dump Communications Trace (DMPCMNTRC)</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="#DMPCMNTRC.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#DMPCMNTRC.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#DMPCMNTRC.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="DMPCMNTRC"></a>
|
|
<p>The Dump Communications Trace (DMPCMNTRC) command copies the unformatted trace data for the specified line, network interface description, or network server description to a user-specified stream file. The data in the stream file can be formatted at a later time, either on the current system or a different system, by using the Print Communications Trace (PRTCMNTRC) command and specifying the FROMSTMF parameter.
|
|
</p>
|
|
<p><b>Restrictions:</b>
|
|
</p>
|
|
<ul>
|
|
<li>To use this command, you must have service (*SERVICE) special authority, or be authorized to the Service trace function of Operating System through iSeries Navigator's Application Administration support. The Change Function Usage (CHGFCNUSG) command, with a function ID of QIBM_SERVICE_TRACE, can also be used to change the list of users that are allowed to perform trace operations.
|
|
</li>
|
|
<li>The following user profiles have authority to this command:
|
|
<ul>
|
|
<li>QSECOFR
|
|
</li>
|
|
<li>QSRV
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DMPCMNTRC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="DMPCMNTRC.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="#DMPCMNTRC.CFGOBJ"><b>CFGOBJ</b></a></td>
|
|
<td valign="top">Configuration object</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
<td valign="top">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DMPCMNTRC.CFGTYPE"><b>CFGTYPE</b></a></td>
|
|
<td valign="top">Type</td>
|
|
<td valign="top">*LIN, *NWI, *NWS</td>
|
|
<td valign="top">Required, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DMPCMNTRC.TOSTMF"><b>TOSTMF</b></a></td>
|
|
<td valign="top">To stream file</td>
|
|
<td valign="top"><i>Path name</i></td>
|
|
<td valign="top">Required, Positional 3</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DMPCMNTRC.REPLACE"><b>REPLACE</b></a></td>
|
|
<td valign="top">Replace file</td>
|
|
<td valign="top"><b><u>*NO</u></b>, *YES</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DMPCMNTRC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="DMPCMNTRC.CFGOBJ"></a>
|
|
<h3>Configuration object (CFGOBJ)</h3>
|
|
<p>Specifies the configuration object that was traced. The object is either a line description, a network interface description, or a network server description.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the configuration object.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DMPCMNTRC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DMPCMNTRC.CFGTYPE"></a>
|
|
<h3>Type (CFGTYPE)</h3>
|
|
<p>Specifies the type of configuration description that was traced.
|
|
</p>
|
|
<dl>
|
|
<dt><b>*LIN</b></dt>
|
|
<dd>The configuration object is a line description.
|
|
</dd>
|
|
<dt><b>*NWI</b></dt>
|
|
<dd>The configuration object is a network interface description.
|
|
</dd>
|
|
<dt><b>*NWS</b></dt>
|
|
<dd>The configuration object is a network server description.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DMPCMNTRC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DMPCMNTRC.TOSTMF"></a>
|
|
<h3>To stream file (TOSTMF)</h3>
|
|
<p>Specifies the stream file to which data is copied. All directories in the path name must exist. New directories are not created. If the stream file does not exist, it is created.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>path-name</i></b></dt>
|
|
<dd>Specify the path name for the stream file to be used.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DMPCMNTRC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DMPCMNTRC.REPLACE"></a>
|
|
<h3>Replace file (REPLACE)</h3>
|
|
<p>Specifies whether the dump operation replaces or fails to copy the records to a stream file if a stream file with the specified name already exists. If the stream file does not exist, it is created.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NO</u></b></dt>
|
|
<dd>No records are copied and an error message is signalled if the file already exists.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>The trace data records replace the existing stream file records.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DMPCMNTRC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="DMPCMNTRC.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p>
|
|
<pre>
|
|
DMPCMNTRC CFGOBJ(*QESLINE) CFGTYPE(*LIN)
|
|
TOSTMF('/user/Test.stmf') REPLACE(*YES)
|
|
</pre>
|
|
</p>
|
|
<p>This command dumps the communications trace of line description QESLINE to stream file <i>/user/Test.stmf</i>. If this stream file already exists, it will be replaced.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DMPCMNTRC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="DMPCMNTRC.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF2634</b></dt>
|
|
<dd>Not authorized to object &1.
|
|
</dd>
|
|
<dt><b>CPF39AF</b></dt>
|
|
<dd>Trace is ending - please wait
|
|
</dd>
|
|
<dt><b>CPF39A8</b></dt>
|
|
<dd>Not authorized to communications trace service tool
|
|
</dd>
|
|
<dt><b>CPF39A9</b></dt>
|
|
<dd>Error occurred during communications trace function
|
|
</dd>
|
|
<dt><b>CPF39B0</b></dt>
|
|
<dd>No communications traces exist.
|
|
</dd>
|
|
<dt><b>CPF39B1</b></dt>
|
|
<dd>Trace &1 type &2 does not exist
|
|
</dd>
|
|
<dt><b>CPF39B3</b></dt>
|
|
<dd>Trace &1 type &2 contains no data
|
|
</dd>
|
|
<dt><b>CPF39B6</b></dt>
|
|
<dd>Communications trace function cannot be performed
|
|
</dd>
|
|
<dt><b>CPF39B8</b></dt>
|
|
<dd>No SNA data found in trace &1 type &2
|
|
</dd>
|
|
<dt><b>CPF3CF2</b></dt>
|
|
<dd>Error(s) occurred during running of &1 API.
|
|
</dd>
|
|
<dt><b>CPF9845</b></dt>
|
|
<dd>Error occurred while opening file &1.
|
|
</dd>
|
|
<dt><b>CPF9846</b></dt>
|
|
<dd>Error while processing file &1 in library &2.
|
|
</dd>
|
|
<dt><b>CPF9847</b></dt>
|
|
<dd>Error occurred while closing file &1 in library &2.
|
|
</dd>
|
|
<dt><b>CPF9872</b></dt>
|
|
<dd>Program or service program &1 in library &2 ended. Reason code &3.
|
|
</dd>
|
|
<dt><b>CPFA0D4</b></dt>
|
|
<dd>File system error occurred. Error number &1.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DMPCMNTRC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|