ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzatv_5.4.0.1/rzatvcwbtrc.htm

85 lines
5.0 KiB
HTML

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html lang="en-us" xml:lang="en-us">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="security" content="public" />
<meta name="Robots" content="index,follow" />
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
<meta name="DC.Type" content="reference" />
<meta name="DC.Title" content="CWBTRC - Trace iSeries Access for Linux" />
<meta name="abstract" content="Use this command from a console prompt to configure tracing." />
<meta name="description" content="Use this command from a console prompt to configure tracing." />
<meta name="DC.Relation" scheme="URI" content="rzatvutilodbc.htm" />
<meta name="copyright" content="(C) Copyright IBM Corporation 2004, 2006" />
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 2004, 2006" />
<meta name="DC.Format" content="XHTML" />
<meta name="DC.Identifier" content="cwbtrc" />
<meta name="DC.Language" content="en-us" />
<!-- All rights reserved. Licensed Materials Property of IBM -->
<!-- US Government Users Restricted Rights -->
<!-- Use, duplication or disclosure restricted by -->
<!-- GSA ADP Schedule Contract with IBM Corp. -->
<link rel="stylesheet" type="text/css" href="./ibmdita.css" />
<link rel="stylesheet" type="text/css" href="./ic.css" />
<title>CWBTRC - Trace iSeries Access for Linux</title>
</head>
<body id="cwbtrc"><a name="cwbtrc"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1"><span class="cmdname">CWBTRC</span> - Trace iSeries™ Access for Linux<sup>®</sup></h1>
<div><p>Use this command from a console prompt to configure tracing.</p>
<div class="section"><h4 class="sectiontitle">Syntax</h4><pre>cwbtrc [/DT:0-1] [/DPATH:path] [/DWRAP:0-4000] [/DFLTR:0-1] [/DTICK:0-1] [/DFRMT:0-1] [/HL:0-1]
[/HPATH:path] [/HWRAP:0-4000] [/HFLTR:0-1] [/HTICK:0-1]</pre>
</div>
<div class="section"><h4 class="sectiontitle">Parameters</h4><div class="note"><span class="notetitle">Note:</span> Defaults shown in bold.</div>
<ul><li>/DT:0-1 = turn detail trace <strong>off</strong>/on </li>
<li>/DPATH:path = detail trace path, default is $HOME/.iSeriesODBC </li>
<li>/DWRAP:0-4000 = detail trace wrap size (MB), default is 1. An <samp class="codeph">&lt;EOF&gt;</samp> symbol
will be placed after the last record. </li>
<li>/DFLTR:0-1 = detail trace filter <strong>off</strong>/on </li>
<li>/DCOMP:abc,abc = filter component list. Where components are: Configuration,
Communication, Comm-API, Comm-SPI, Comm-System, Comm-Base, License Management,
NLS, ODBC, ODBC-Error, Emulator Remote Command, Service, Security.</li>
<li>/DTICK:0-1 = <strong>timestamp</strong> or tick count in trace entries </li>
<li>/DFRMT:0-1 = limit tcp hex data <strong>off</strong>/on </li>
<li>/HL:0-1 = turn history log <strong>off</strong>/on </li>
<li>/HPATH:path = history log path, default is $HOME/.iSeriesODBC /HWRAP:0-4000
= history log wrap size (MB), default is 1. An <samp class="codeph">&lt;EOF&gt;</samp> symbol
will be placed after the last record. </li>
<li>/HFLTR:0-1 = history log filter <strong>off</strong>/on </li>
<li>/HCOMP:abc,abc = filter component list. Where components are: Configuration,
Communication, Comm-API, Comm-SPI, Comm-System, Comm-Base, License Management,
NLS, ODBC, ODBC-Error, Emulator Remote Command, Service, Security.</li>
<li>/HTICK:0-1 = <strong>timestamp</strong> or tick count in traces entry</li>
</ul>
</div>
<div class="section"><p>Running <span class="cmdname">CWBTRC</span> without any parameters will
show the command syntax and the current status of each parameter. </p>
</div>
<div class="section"><p>The output from <span class="cmdname">CWBTRC</span> will have the following
naming convention: </p>
<pre>cwbdetail-&lt;process name&gt;-pid.csv
cwbhistory-&lt;process name&gt;-pid.csv</pre>
<p> The output files will
be in semicolon separated record format, suitable for input into spreadsheets
for viewing.</p>
</div>
<div class="section"><h4 class="sectiontitle">Examples</h4><p>The following command will turn on detail
trace and allow it to grow to a 10 mg file before wrapping. It will also turn
on history logging. </p>
<pre>cwbtrc /dt:1 /dwrap:10 /hl:1</pre>
</div>
<div class="section"><p>The following command will turn on history log and change the
path to /usr/traces </p>
<pre>cwbtrc /hl:1 /hpath:/usr/traces</pre>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzatvutilodbc.htm" title="The following utilities are included with iSeries Access for Linux and are shipped in /opt/ibm/iSeriesAccess/bin.">iSeries Access for Linux utilities</a></div>
</div>
</div>
</body>
</html>