ibm-information-center/dist/eclipse/plugins/i5OS.ic.ddp_5.4.0.1/rbal1papptrace.htm

85 lines
5.2 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="task" />
<meta name="DC.Title" content="TCP/IP communications trace" />
<meta name="abstract" content="One of the uses of the trace tool is to show the clear text of a transmission in an environment where the data is encrypted." />
<meta name="description" content="One of the uses of the trace tool is to show the clear text of a transmission in an environment where the data is encrypted." />
<meta name="DC.subject" content="TRCTCPAPP, trace, encrypted, datastreams" />
<meta name="keywords" content="TRCTCPAPP, trace, encrypted, datastreams" />
<meta name="DC.Relation" scheme="URI" content="rbal1gdrf.htm" />
<meta name="DC.Relation" scheme="URI" content="rbal1trcformatting.htm" />
<meta name="DC.Relation" scheme="URI" content="rbal1commt.htm" />
<meta name="DC.Relation" scheme="URI" content="../cl/trctcpapp.htm" />
<meta name="copyright" content="(C) Copyright IBM Corporation 1998, 2006" />
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 1998, 2006" />
<meta name="DC.Format" content="XHTML" />
<meta name="DC.Identifier" content="rbal1papptrace" />
<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>TCP/IP communications trace</title>
</head>
<body id="rbal1papptrace"><a name="rbal1papptrace"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">TCP/IP communications trace</h1>
<div><p>One of the uses of the trace tool is to show the clear text of
a transmission in an environment where the data is encrypted.</p>
<div class="section"> <p>The trace data is captured before encryption at the sender, and
after encryption at the receiver. However, the trace tool is useful in other
environments as well. You can only use this function when you are using TCP/IP
for communication.</p>
<p>To use the <span class="cmdname">Trace TCP/IP Application
(TRCTCPAPP)</span> command, you must have a user profile with *SERVICE
special authority. To start the trace, enter the following line:</p>
<pre>TRCTCPAPP *DDM</pre>
<p>If
you want to restrict the trace to a certain port, for example port 448 for
SSL, follow this example: </p>
<pre>TRCTCPAPP *DDM *ON RMTNETADR(*INET *N '255.255.255.255' 448)</pre>
<p>After
the communication that you are tracing has finished, run the following command
and look at the resulting spooled file:</p>
<pre>TRCTCPAPP *DDM *OFF</pre>
<p id="rbal1papptrace__manytrace"><a name="rbal1papptrace__manytrace"><!-- --></a>If you traced more than one connection, you will need to locate
and match your spool files to each QRWTSRVR job. The spool file name is QZBSTRC
and the job is QRWxxxxxx, where xxxxxx is the job number placed in the user
data for the spool file.</p>
<p><strong>Restriction for use with *DDM application</strong></p>
<p>When
you use the <span class="cmdname">Trace TCP/IP Application (TRCTCPAPP)</span> command
with the *DDM application, the maximum amount of data you can trace for a
single sent or received message is limited to 6000 bytes.</p>
</div>
<div class="section"></div>
</div>
<div>
<ul class="ullinks">
<li class="ulchildlink"><strong><a href="rbal1trcformatting.htm">TCP/IP communication trace formatting</a></strong><br />
The <span class="cmdname">Trace TCP/IP Application (TRCTCPAPP)</span> command
can be used to break down DRDA<sup>®</sup> and DDM flows into an easier-to-read logical representation.
It also displays the information in ASCII which can be of help in unlike environments.</li>
</ul>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rbal1gdrf.htm" title="This topic collection describes the kinds of data that you can print to help you diagnose a problem in a distributed relational database on iSeries servers.">Get data to report a failure</a></div>
</div>
<div class="relconcepts"><strong>Related concepts</strong><br />
<div><a href="rbal1commt.htm" title="If you get a message in the CPF3Exx range or the CPF91xx range when using Distributed Relational Database Architecture (DRDA) to access a distributed relational database, you should run a communications trace.">Communications trace</a></div>
</div>
<div class="relinfo"><strong>Related information</strong><br />
<div><a href="../cl/trctcpapp.htm">Trace TCP/IP Application (TRCTCPAPP) command</a></div>
</div>
</div>
</body>
</html>