69 lines
7.2 KiB
HTML
69 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="Start a job trace" />
|
|
<meta name="DC.Relation" scheme="URI" content="rzakujobtrace.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rzakurecprob.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rzakuservertable.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rzakumultrc.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="strjobt" />
|
|
<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>Start a job trace</title>
|
|
</head>
|
|
<body id="strjobt"><a name="strjobt"><!-- --></a>
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
|
<h1 class="topictitle1">Start a job trace</h1>
|
|
<div><div class="section"> <div class="p">This action starts a job trace for one or more jobs. You can start any number of trace sessions, but active trace session identifiers must be unique across the system.<div class="note"><span class="notetitle">Note:</span> If you have not identified the job that needs to be traced, use the <a href="rzakuservertable.htm#servertable">server table</a> as a reference in identifying jobs and their corresponding servers.</div>
|
|
</div>
|
|
<p>To start a job trace, follow these steps:</p>
|
|
</div>
|
|
<ol><li class="stepexpand"><span>At the command line, type <samp class="codeph">STRTRC</samp> (Start Trace), and press F4 (Prompt).</span></li>
|
|
<li class="stepexpand"><span>For the <em>Session ID</em> prompt, specify a meaningful session identifier, such as <samp class="codeph"><em>mytrace</em></samp>. You will use this session identifier later, to specify the trace you want to end or print.</span></li>
|
|
<li class="stepexpand"><span>For the <em>Jobs</em> parameter, you need to specify values for these three prompts. Remember that you cannot specify the value *ALL for all three of these prompts. At least one of the prompts must contain a value other than *ALL.</span> <ul><li>For the <em>Jobs, Job Name</em> prompt, choose one of these options: <ul><li>To trace only the job that issued the Start trace (STRTRC) command, type <samp class="codeph">*</samp> .</li>
|
|
<li>To trace a specific job, specify the name of the job you want to trace, such as <samp class="codeph"><em>job</em></samp>. You can specify up to ten jobs.</li>
|
|
<li>To trace a set of jobs that all begin with the same string, specify the job name in a manner such that it is not a specific job, such as <samp class="codeph"><em>job*</em></samp>. This traces all jobs that begin with the prefix JOB. See <a href="rzakumultrc.htm#multrc">Start multiple generic traces</a> to find out different ways to format a generic job trace.</li>
|
|
<li>To trace all the jobs, type <samp class="codeph">*ALL</samp>. However, tracing all jobs is not recommended.</li>
|
|
</ul>
|
|
</li>
|
|
<li>For the <em>Jobs, User</em> prompt, specify the name of the user of the job, such as <samp class="codeph">USER</samp>. Other valid values include USER* and *ALL. However, tracing all users is not recommended.</li>
|
|
<li>For the <em>Jobs, Number</em> prompt, type <samp class="codeph">*ALL</samp> or the job number. If you type <samp class="codeph">*ALL</samp>, the <em>Job Name</em> prompt specification is considered a generic job name.</li>
|
|
</ul>
|
|
</li>
|
|
<li class="stepexpand"><span>For the <em>Thread ID to include</em> prompt, type <samp class="codeph">*ALL</samp> unless you want to trace a specific thread.</span></li>
|
|
<li class="stepexpand"><span>For the <em>Maximum storage to use</em> prompt, specify a value that you think will be large enough to collect the trace information you need. The amount of storage used for the trace buffer depends on how long the trace runs and how busy the job being traced is. The default value is 10000 KB (10 MB).</span></li>
|
|
<li class="stepexpand"><span>For the <em>Trace full</em> prompt, type <samp class="codeph">*WRAP</samp> or <samp class="codeph">*STOPTRC</samp>, depending on what you want to happen when the trace buffer gets full. If you want to collect trace information until the problem occurs, type <samp class="codeph">*WRAP</samp>; the older trace information is overlaid with newer trace information when the buffer is full. If you do not want the trace information to be overlaid, type <samp class="codeph">*STOPTRC</samp>.</span></li>
|
|
<li class="stepexpand"><span>For the <em>Trace type</em> prompt, type <samp class="codeph">*ALL</samp> to store all of the job trace data.</span></li>
|
|
<li class="stepexpand"><span>For the <em>Trace type: Component</em> prompt, type <samp class="codeph">*SOCKETS</samp>.</span></li>
|
|
<li class="stepexpand"><span>For the <em>Trace type: Trace level</em>, specify <samp class="codeph">*VERBOSE</samp>.</span></li>
|
|
<li class="stepexpand"><span>For the <em>Trace filter</em> prompt, type <samp class="codeph">*NONE</samp>. If you want to use a filter to collect specific information in the trace, specify the name of the trace filter, such as <samp class="codeph">tracefiltername</samp>. If you have not already created a trace filter, do so by using the Add Trace Filter (ADDTRCFTR) command. The trace filter applies to the *FLOW trace only.</span></li>
|
|
<li class="stepexpand"><span>Press Enter. You should receive the message <samp class="codeph">STRTRC session ID MYTRACE successfully started.</samp></span> If you meet problem with configuration or starting or ending servers, you can specify *TCPIPCFG, checking whether your configuration is right.</li>
|
|
</ol>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzakujobtrace.htm" title="Use the job trace tool to trace data in any job to help identify your problem.">Job trace</a></div>
|
|
<div class="nextlink"><strong>Next topic:</strong> <a href="rzakurecprob.htm">Re-create the problem</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><a href="rzakumultrc.htm" title="You can use generic job traces to enhance the results of the trace.">Multiple generic traces</a></div>
|
|
</div>
|
|
</div>
|
|
</body>
|
|
</html> |