ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzahh_5.4.0.1/rzahhcommtrace.htm

96 lines
5.3 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="Commtrace classes" />
<meta name="abstract" content="" />
<meta name="description" content="" />
<meta name="copyright" content="(C) Copyright IBM Corporation 2006" />
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 2006" />
<meta name="DC.Format" content="XHTML" />
<meta name="DC.Identifier" content="rzahhcommtrace" />
<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>Commtrace classes</title>
</head>
<body id="rzahhcommtrace"><a name="rzahhcommtrace"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Commtrace classes</h1>
<div><p></p>
<div class="section"><p>The IBM<sup>®</sup> Toolbox
for Java™ commtrace
classes enable your Java programs to work with communications
trace data for a specified LAN (Ethernet or token ring) line description.
The commtrace package includes a class that you can run as a standalone utility
program to format communications trace data.</p>
<p>When you dump a communications
trace for an iSeries™ server
to a stream file, the information is saved in a binary format. The commtrace
classes enable you to work with the various components of the stream file.</p>
<div class="note"><span class="notetitle">Note:</span> Communications
trace files may contain confidential information, for example, unencrypted
passwords. When the communications trace file is on the iSeries server,
only users who have *SERVICE special authority can access the trace data.
If you move the file to a client, make sure that you protect the file in
an appropriate manner. For more information about communications traces,
see the links at the bottom of this page. </div>
<p>Use the commtrace classes
to perform the following tasks:</p>
<ul><li>Format the raw trace data.</li>
<li>Parse any of the data to extract the information you want. You can parse
both raw and formatted data, provided that you used the commtrace classes
to format the data.</li>
</ul>
<p>For a visual representation that shows how the commtrace classes represent
the structures in a communications trace file, see the following page:</p>
<blockquote><a href="rzahhcommtracemodel.htm#rzahhcommtracemodel">Commtrace model</a></blockquote>
<p>The commtrace
package includes the following classes:</p>
<blockquote> <p><a href="rzahhcommtraceformat.htm#rzahhcommtraceformat">Format and FormatProperties classes</a>:
The Format class reads both raw data and formatted data from a communications
trace. FormatProperties sets the properties for your Format object, such
as start and end times, IP addresses, ports, and so on.</p>
<div class="note"><span class="notetitle">Note:</span> You can
also run the Format class as a standalone program.</div>
<p><a href="rzahhcommtraceprolog.htm#rzahhcommtraceprolog">Prolog class</a>:
Retrieves information from the initial 256-byte section of an iSeries server
communications trace.</p>
<p><a href="rzahhcommtraceframe.htm#rzahhcommtraceframe">Frame class</a>:
Retrieves information about the frames of the communications trace.</p>
<p><a href="rzahhcommtracelanheader.htm#rzahhcommtracelanheader">LanHeader class</a>: Retrieves
information from the section of data that occurs once, near the beginning
of a frame. This section typically contains hardware-specific information
that includes general information about the frame, such as the frame number,
data length, and so on.</p>
<p><a href="rzahhcommtraceippacket.htm#rzahhcommtraceippacket">IPPacket class</a>:
Retrieves information from the data in the packet. IPPacket is the abstract
parent class for the different types of data packets that are supported by
the commtrace package.</p>
<p><a href="rzahhcommtraceheader.htm#rzahhcommtraceheader">Header class</a>:
Retrieves information from the packet header and the associated data. Header
is the abstract parent class for the different types of packet headers that
are supported by the commtrace package.</p>
</blockquote>
<p>Most of the remaining
classes in the com.ibm.as400.commtrace package are specific to the type of
trace data that you want to work with. For more information about communications
traces and about all the commtrace classes, refer to following pages:</p>
<blockquote><p><a href="../rzaku/rzakucommunictrace.htm">Communications
trace</a></p>
</blockquote>
</div>
</div>
</body>
</html>