96 lines
6.0 KiB
HTML
96 lines
6.0 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="Scenario: Use watch support with a job trace" />
|
||
|
|
<meta name="abstract" content="You can use watch support with a job trace." />
|
||
|
|
<meta name="description" content="You can use watch support with a job trace." />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzakuwatchscenarios.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="watchjobtrcscen" />
|
||
|
|
<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>Scenario: Use watch support with a job trace</title>
|
||
|
|
</head>
|
||
|
|
<body id="watchjobtrcscen"><a name="watchjobtrcscen"><!-- --></a>
|
||
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
||
|
|
<h1 class="topictitle1">Scenario: Use watch support with a job trace</h1>
|
||
|
|
<div><p>You can use watch support with a job trace.</p>
|
||
|
|
<div class="section">Assume that you write a sockets server application
|
||
|
|
that occasionally fails. When the application fails, the TCP3B04 socket API
|
||
|
|
error is sent to the job log. <p>To solve the problem, you need to perform
|
||
|
|
a job trace using watch support so that the trace is automatically stopped
|
||
|
|
when the TCP3B04 error is sent to the job log. This allows you to capture
|
||
|
|
only the data that you need to analyze the problem and prevents the trace
|
||
|
|
from running longer than necessary.</p>
|
||
|
|
<p>To perform the job trace using watch
|
||
|
|
support, follow these steps:</p>
|
||
|
|
</div>
|
||
|
|
<ol><li><span>Start the job trace:</span><ol type="a"><li class="substepexpand"><span>At the command line, type <samp class="codeph">STRTRC</samp> and press
|
||
|
|
F4.</span></li>
|
||
|
|
<li class="substepexpand"><span>For the <em>Session ID</em> prompt, specify a meaningful session
|
||
|
|
identifier, such as <em>mytrace</em>.</span></li>
|
||
|
|
<li class="substepexpand"><span>For the <em>Jobs</em> parameter, specify these values:</span> <ul><li>For the <em>Jobs, Job Name</em> prompt, type the job name, such as <samp class="codeph">SOCKETAPP</samp>.</li>
|
||
|
|
<li>For the <em>Jobs, User</em> prompt, specify the user ID, such as <em>user</em>.</li>
|
||
|
|
<li>For the <em>Jobs, Number</em> prompt, type <samp class="codeph">*ALL</samp>.</li>
|
||
|
|
</ul>
|
||
|
|
</li>
|
||
|
|
<li class="substepexpand"><span>For the <em>Watch for message, Message identifier</em> prompt,
|
||
|
|
type <samp class="codeph">TCP3B04</samp>.</span></li>
|
||
|
|
<li class="substepexpand"><span>For the <em>Watched message queue, Message queue</em> prompt,
|
||
|
|
type <samp class="codeph">*JOBLOG</samp>. This ensures that the communications trace
|
||
|
|
stops running when the TCP3B04 message is sent to the job log.</span></li>
|
||
|
|
<li class="substepexpand"><span>For the <em>Watched job</em> parameter, specify these values:</span> <ul><li>For the <em>Jobs, Job Name</em> prompt, type <samp class="codeph">SOCKETAPP</samp>.</li>
|
||
|
|
<li>For the <em>Jobs, User</em> prompt, specify the user ID, such as <em>user</em>.</li>
|
||
|
|
<li>For the <em>Jobs, Number</em> prompt, type <samp class="codeph">*ALL</samp>.</li>
|
||
|
|
</ul>
|
||
|
|
</li>
|
||
|
|
</ol>
|
||
|
|
</li>
|
||
|
|
<li><span>Verify that the watch support started:</span><ol type="a"><li class="substepexpand"><span>At the command line, type <samp class="codeph">DSPLOG</samp> and press
|
||
|
|
F4.</span></li>
|
||
|
|
<li class="substepexpand"><span>For the <em>Log</em> prompt, type <samp class="codeph">QHST</samp>.</span> You should see the following message: <p><samp class="codeph">Job <em>jobnumber</em>/<em>user</em>/QSCSTT<em>xxxx</em> started
|
||
|
|
on mm/dd/yy at hh:mm:ss in subsystem QUSRWRK in QSYS. Job entered system on
|
||
|
|
mm/dd/yy at hh:mm:ss</samp></p>
|
||
|
|
where user is the name of the user that runs
|
||
|
|
the STRTRC command and where xxxx indicates a unique identifier for the watch
|
||
|
|
job. Note that STT in the middle of the job name indicates that the watch
|
||
|
|
job was started by the STRTRC command.</li>
|
||
|
|
</ol>
|
||
|
|
</li>
|
||
|
|
<li><span>Verify that the watch support is running:</span><ul><li>At the command line, type <samp class="codeph">WRKACTJOB SBS(QUSRWRK)</samp>.</li>
|
||
|
|
<li>You should see the watch job running in the QUSRWRK subsystem. The
|
||
|
|
job is usually in DEQW status if the watched message has not been sent.</li>
|
||
|
|
</ul>
|
||
|
|
</li>
|
||
|
|
<li><span>After the TCP3B04 message is sent to the jobnumber/user/SOCKETAPP
|
||
|
|
job log, you should verify that the trace has ended:</span><ul><li>At the command line, type <samp class="codeph">DSPMSG MSGQ(*SYSOPR)</samp>.</li>
|
||
|
|
<li>You should see the CPI3999 message which indicates that the STRTRC
|
||
|
|
command was ended because of reason code 02. Reason code 02 indicates that <samp class="codeph">Watch
|
||
|
|
for event criteria met because of message id TCP3B04 found in <em>jobnumber</em>/<em>user</em>/SOCKETAPP</samp>.</li>
|
||
|
|
</ul>
|
||
|
|
</li>
|
||
|
|
<li><span><a href="rzakuprtjobt.htm#prtjobt">Format the trace output</a> using
|
||
|
|
the Print Trace (PRTTRC) command to analyze the data you collected.</span></li>
|
||
|
|
</ol>
|
||
|
|
</div>
|
||
|
|
<div>
|
||
|
|
<div class="familylinks">
|
||
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzakuwatchscenarios.htm" title="You can learn how to use the watch function when you perform a trace from these scenarios.">Scenarios: Use watch support with traces</a></div>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
</body>
|
||
|
|
</html>
|