117 lines
7.2 KiB
HTML
117 lines
7.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="Job trace" />
|
|
<meta name="abstract" content="Use the job trace tool to trace data in any job to help identify your problem." />
|
|
<meta name="description" content="Use the job trace tool to trace data in any job to help identify your problem." />
|
|
<meta name="DC.Relation" scheme="URI" content="rzakutoolstrc.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rzakustrjobt.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rzakurecprob.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rzakuendjobt.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rzakuprtjobt.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rzakudltjobt.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rzakuadvjobtrc.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rzakucommunictrace.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rzakutraceconn.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rzakutrctcpapp.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="../books/sc415302.pdf" />
|
|
<meta name="DC.Relation" scheme="URI" content="rzakuservertable.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rzakucommunictrace.htm" />
|
|
<meta name="copyright" content="(C) Copyright IBM Corporation 1997, 2006" />
|
|
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 1997, 2006" />
|
|
<meta name="DC.Format" content="XHTML" />
|
|
<meta name="DC.Identifier" content="jobtrace" />
|
|
<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>Job trace</title>
|
|
</head>
|
|
<body id="jobtrace"><a name="jobtrace"><!-- --></a>
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
|
<h1 class="topictitle1">Job trace</h1>
|
|
<div><p><span>Use the job trace tool to trace data in any
|
|
job to help identify your problem.</span></p>
|
|
<div class="section"> <p> Job trace is a problem analysis tool that allows you to look
|
|
at what any application is doing. Use job trace as a first step in locating
|
|
a problem with an application. You can turn on job trace in any job and see
|
|
the call and return flows of that application. Job trace records the raw data
|
|
and then stores it in a set of database files.</p>
|
|
<p>The job trace is performed
|
|
using a series of CL commands, such as STRTRC (Start Trace), ENDTRC (End Trace),
|
|
and PRTTRC (Print Trace). Starting a job trace consumes relatively few system
|
|
resources. However, ending the job trace and printing the job trace require
|
|
more time and processing resources. If you have a limited amount of interactive
|
|
capability available on your system, you might want to submit the ENDTRC and
|
|
PRTTRC to batch.</p>
|
|
<p>Note that if the application code is created with OPTIMIZE(40),
|
|
the optimization disables call and instruction tracing. Although you can specify
|
|
LICOPT (CallTracingAtHighOpt) to enable job call tracing, the optimization
|
|
might still disable some calls. Therefore, job trace might not be effective
|
|
when using OPTIMIZE(40).</p>
|
|
<p>Use job trace in these situations:</p>
|
|
<ul><li>You want to debug any job on your system. See the server table to understand
|
|
the correlation between the servers and the applications and jobs they represent.</li>
|
|
<li>You want to troubleshoot your sockets application.</li>
|
|
<li>You are developing an application for i5/OS™ and encounter
|
|
a problem. By tracing the application, you can identify the problem.</li>
|
|
</ul>
|
|
<p>To use the CL commands to perform a job trace, you must have *SERVICE
|
|
special authority, or be authorized to the service trace function of i5/OS through iSeries™ Navigator.
|
|
See the chapter on user profiles in iSeries Security Reference for more information
|
|
about this type of authority.</p>
|
|
<p>Use the following job trace instructions
|
|
as a guide. The example demonstrates how to use job trace to troubleshoot
|
|
a sockets application. Sockets adds information to the job trace output when
|
|
errors are returned on the sockets APIs. You might need to specify different
|
|
parameters, depending on the type of application you are troubleshooting.
|
|
Note that communications trace is also useful when troubleshooting sockets
|
|
applications.</p>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<ol>
|
|
<li class="olchildlink"><a href="rzakustrjobt.htm">Start a job trace</a><br />
|
|
</li>
|
|
<li class="olchildlink"><a href="rzakurecprob.htm">Re-create the problem</a><br />
|
|
</li>
|
|
<li class="olchildlink"><a href="rzakuendjobt.htm">End a job trace</a><br />
|
|
</li>
|
|
<li class="olchildlink"><a href="rzakuprtjobt.htm">Print a job trace</a><br />
|
|
</li>
|
|
<li class="olchildlink"><a href="rzakudltjobt.htm">Delete a job trace</a><br />
|
|
</li>
|
|
<li class="olchildlink"><a href="rzakuadvjobtrc.htm">Advanced job trace functions</a><br />
|
|
<span>Job trace offers some advanced functions that
|
|
enhance the results of the job trace.</span></li>
|
|
</ol>
|
|
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzakutoolstrc.htm" title="You can use various trace tools to solve problems with your TCP/IP connectivity.">Tools for tracing data and jobs</a></div>
|
|
</div>
|
|
<div class="relconcepts"><strong>Related concepts</strong><br />
|
|
<div><a href="rzakutraceconn.htm" title="You can trace encrypted data to locate the source of the problem by using trace connection. Trace connection is especially useful for connections, such as virtual Ethernet and OptiConnect, that do not support the general communications trace function.">Trace connection</a></div>
|
|
<div><a href="rzakutrctcpapp.htm" title="Use the Trace TCP Application (TRCTCPAPP) command to trace data that pertains to specific TCP/IP applications servers.">Trace TCP application</a></div>
|
|
</div>
|
|
<div class="reltasks"><strong>Related tasks</strong><br />
|
|
<div><a href="rzakucommunictrace.htm" title="You can use communications trace to determine whether your data is being transmitted correctly across the network.">Communications trace</a></div>
|
|
</div>
|
|
<div class="relref"><strong>Related reference</strong><br />
|
|
<div><a href="rzakuservertable.htm" title="You can use this server table as a reference to find out how servers, server jobs, job descriptions, and subsystems are mapped to one another.">Server table</a></div>
|
|
</div>
|
|
<div class="relinfo"><strong>Related information</strong><br />
|
|
<div><a href="../books/sc415302.pdf" target="_blank">iSeries Security Reference PDF</a></div>
|
|
</div>
|
|
</div>
|
|
</body>
|
|
</html> |