ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzajt_5.4.0.1/rzajtrzajtprbcomtraceinsts.htm

92 lines
5.4 KiB
HTML
Raw Normal View History

2024-04-02 14:02:31 +00:00
<?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 xmlns="http://www.w3.org/1999/xhtml" lang="en-US" xml:lang="en-us">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="dc.language" scheme="rfc1766" 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. -->
<meta name="dc.date" scheme="iso8601" content="2005-09-06" />
<meta name="copyright" content="(C) Copyright IBM Corporation 1998, 2006" />
<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))' />
<title>Solve communication problems using communications trace</title>
<link rel="stylesheet" type="text/css" href="ibmidwb.css" />
<link rel="stylesheet" type="text/css" href="ic.css" />
</head>
<body>
<a id="Top_Of_Page" name="Top_Of_Page"></a><!-- Java sync-link -->
<script language = "Javascript" src = "../rzahg/synch.js" type="text/javascript"></script>
<a name="rzajtprb-comtraceinsts"></a>
<h3 id="rzajtprb-comtraceinsts">Solve communication problems using communications trace</h3>
<p>Sometimes, program debugging tasks are easier if you can trace the data
that is sent and received on the communications line or within the network
server. To perform a communications trace, you must have IBM&reg; *SERVICE special
authority or be authorized to the Service Trace function of i5/OS&trade; through iSeries&trade; Navigator. See <a href="../books/sc415302.pdf" target="_blank">iSeries Security
Reference</a>
<img src="wbpdf.gif" alt="Link to PDF" /> (SC41-5302), Chapter 4 User Profiles, for more information
on this special authority.</p>
<p>To run a communications trace, see <a href="../rzaku/rzakuperformt.htm">Perform
a communications trace</a> for the specific steps you should use.</p>
<p>The following commands might be used to perform a communications trace.</p>
<dl class="parml">
<dt class="bold">STRSST (Start Service Tools)</dt>
<dd>The STRSST command takes you to a menu of tools to obtain error log
information and communications trace information. For a detailed description
of system service tools, see: <a href="rzajtrzajtprbcomssttoolinsts.htm#rzajtprb-comssttoolinsts">Communications trace and communication problems</a>
</dd>
<dt class="bold">STRCMNTRC (Start Communications Trace)</dt>
<dd>The STRCMNTRC command starts a communications trace for the specified
line, network interface description, or network server description. The communications
trace continues until one of the following occurs:
<ul>
<li>The system runs the End Communications Trace (ENDCMNTRC) command</li>
<li>A physical line problem causes the trace to end</li>
<li>The Communications Trace function of the STRSST command ends the trace</li>
<li>The *STOPTRC parameter is specified, and the buffer becomes full</li></ul>
</dd>
<dt class="bold">ENDCMNTRC (End Communications Trace)</dt>
<dd>The ENDCMNTRC command ends the trace currently running on the specified
line, network interface description, or network server description. The ENDCMNTRC
command saves the communications trace buffer and the associated System Licensed
Internal Code (SLIC) data.
</dd>
<dt class="bold">PRTCMNTRC (Print Communications Trace)</dt>
<dd>The PRTCMNTRC command writes the communications trace data for the
specified line, network interface description, or network server description
to a spooled file or a database file. The system can print trace data multiple
times in either form, and parameters on the command allow for dividing and
formatting of the data.
</dd>
<dt class="bold">DLTCMNTRC (Delete Communications Trace)</dt>
<dd>The DLTCMNTRC command deletes the communications trace buffer and associated
SLIC data for the specified line, network interface description, or network
server description. The communications trace can be deleted once the trace
has ended.
</dd>
<dt class="bold">CHKCMNTRC (Check Communications Trace)</dt>
<dd>The CHKCMNTRC command returns the communications trace status for a
specific line, network interface description, or network server description.
The CHKCMNTRC command returns status for all of the traces of a specific type
that exist on the system. The system returns the status through a message.
</dd>
<dt class="bold"><a href="rzajtrzajtprbcomtraceinstss.htm#rzajtprb-comtraceinstss">TRCCPIC</a> (Trace Common
Programming Interface (CPI) Communications)</dt>
<dd>You can start to trace Common Programming Interface (CPI) Communications
either before running a job or after a job is active to find out where the
error might have occurred. The TRCCPIC command captures information about
CPI-Communications calls that is processed by your program.
</dd>
</dl>
<p>For more information on how to access System Service Tools, see the <a href="../books/sc415304.pdf" target="_blank">Backup and Recovery</a>
<img src="wbpdf.gif" alt="Link to PDF" /> book.</p>
<a id="Bot_Of_Page" name="Bot_Of_Page"></a>
</body>
</html>