122 lines
4.8 KiB
HTML
122 lines
4.8 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>Work with Traces (WRKTRC)</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="WRKTRC.Top_Of_Page"></a>
|
|
<h2>Work with Traces (WRKTRC)</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="#WRKTRC.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#WRKTRC.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#WRKTRC.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="WRKTRC"></a>
|
|
<p>The Work with Traces (WRKTRC) command can be used to show a panel with the list of existing communications traces, job traces, licensed internal code (LIC) traces and performance explorer (PEX) traces around the system. You can work with the existing traces or start a new trace. When you run this command, the Work with Traces panel is shown.
|
|
</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 the 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>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#WRKTRC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="WRKTRC.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="#WRKTRC.TRC"><b>TRC</b></a></td>
|
|
<td valign="top">Trace</td>
|
|
<td valign="top">Single values: *ALL<br>Other values (up to 4 repetitions): *CMN, *JOB, *LIC, *PEX</td>
|
|
<td valign="top">Required, Positional 1</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#WRKTRC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="WRKTRC.TRC"></a>
|
|
<h3>Trace (TRC)</h3>
|
|
<p>Specifies the type of traces to be shown on the Work with Traces panel.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>All communications traces, job traces, licensed internal code (LIC) traces and performance explorer (PEX) traces are listed in the Work with Traces panel.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Other values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>*CMN</b></dt>
|
|
<dd>All communications traces are shown in the Work with Traces panel.
|
|
</dd>
|
|
<dt><b>*JOB</b></dt>
|
|
<dd>All job trace session identifiers are shown in the Work with Traces panel. This includes trace sessions started by the Start Trace (STRTRC) command and the Trace TCP/IP Application (TRCTCPAPP) command specifying the <b>Additional traces (ADLTRC)</b> parameter.
|
|
</dd>
|
|
<dt><b>*LIC</b></dt>
|
|
<dd>All LIC traces are shown in the Work with Traces panel. This includes traces started by the Trace Internal (TRCINT) command, the Trace Connection (TRCCNN) command, the Trace TCP/IP Application (TRCTCPAPP) command specifying the <b>Additional traces (ADLTRC)</b> parameter, the Start System Service Tools (STRSST) command, or the Start DST (STRDST) command.
|
|
</dd>
|
|
<dt><b>*PEX</b></dt>
|
|
<dd>All PEX traces are shown in the Work with Traces panel.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#WRKTRC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="WRKTRC.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p>
|
|
<pre>
|
|
WRKTRC TRC(*LIC)
|
|
</pre>
|
|
</p>
|
|
<p>This command displays the Work with Traces panel, showing all traces started issuing the Trace Internal (TRCINT) command, the Trace Connection (TRCCNN) command, the Trace TCP/IP Application (TRCTCPAPP) command specifying the <b>Additional traces (ADLTRC)</b> parameter, the Start System Service Tools (STRSST) command, and Start DST (STRDST) command.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#WRKTRC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="WRKTRC.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF98A2</b></dt>
|
|
<dd>Not authorized to &1 command.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#WRKTRC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|