ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzahw_5.4.0.1/rzahwtooco.htm

90 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="reference" />
<meta name="DC.Title" content="Commands that report thread-related data" />
<meta name="abstract" content="Most of the commands used to service jobs were not changed to support multithreaded processes. Therefore, the existing commands will continue to operate against the job and not individual threads within the job." />
<meta name="description" content="Most of the commands used to service jobs were not changed to support multithreaded processes. Therefore, the existing commands will continue to operate against the job and not individual threads within the job." />
<meta name="DC.Relation" scheme="URI" content="rzahwbugco.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="rzahwtoo-tooco" />
<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>Commands that report thread-related data</title>
</head>
<body id="rzahwtoo-tooco"><a name="rzahwtoo-tooco"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Commands that report thread-related data</h1>
<div><p>Most of the commands used to service jobs were not
changed to support multithreaded processes. Therefore, the existing commands
will continue to operate against the job and not individual threads within
the job.</p>
<div class="section"><p>The following commands were enhanced to report thread-related
data:</p>
<dl><dt class="dlterm"><span class="cmdname">Dump Job (DMPJOB)</span> command:</dt>
<dd> <p>The <span class="cmdname">Dump Job</span> command now dumps all threads within
a job. The thread-related data is available though use of the JOBTHD parameter
on the command. The following example shows how to obtain a multithreaded
job dump that contains the thread-related data: </p>
<pre>STRSRVJOB JOB(000000/USER/JOBNAME)
DMPJOB PGM(*NONE) JOBARA(*NONE) ADROBJ(*NO) JOBTHD(*THDSTK)
ENDSRVJOB</pre>
</dd>
<dt class="dlterm"><span class="cmdname">Start Trace (STRTRC)</span> command:</dt>
<dd> <p>The <span class="cmdname">Start Trace</span> command allows you either to trace
all threads within a multithreaded job or to specify up to 20 specific threads
to be traced in a multithreaded job. The thread identifier is included in
each trace record to indicate the thread that caused the record to be entered
into the log. The following example shows how to obtain a trace for a multithreaded
job: </p>
<pre>STRTRC SSNID(MYSSNID) JOB((000000/USERNAME/JOBNAME (*ALL)))
... tracing the job
ENDTRC SSNID(MYSSNID) DTALIB(MYLIB) PRTTRC(*YES) </pre>
<p>The following
example shows how to obtain a trace for specified threads in a multithreaded
job: </p>
<pre>STRTRC SSNID(MYSSNID) JOB((000000/USERNAME/JOBNAME (00000001 00000002 00000003)))
... tracing the job
ENDTRC SSNID(MYSSNID) DTALIB(MYLIB) PRTTRC(*YES) </pre>
</dd>
<dt class="dlterm">First Failure Data Capture (FFDC) function:</dt>
<dd> <p>FFDC is a function that you can use in your program, service program,
or module to report a problem for an authorized program analysis report (APAR).
FFDC logs the problem, builds a symptom string, and collects problem analysis
data.</p>
<p>FFDC is not fully functional when used in a multithreaded program.
When it is called in a multithreaded program, FFDC provides partial support
that includes: </p>
<ul><li>Collecting data item information and storing this information in the QPSRVDMP
spool file.</li>
<li>Storage of the point of failure, symptom string, and the detecting and
suspected program information in the QPSRVDMP spool file. The job log also
contains this information.</li>
<li>Starting the <span class="cmdname">Dump Job (DMPJOB)</span> command.</li>
</ul>
<p>FFDC support for object dumping, problem entry creation, or data collection
for problem determination is not provided within a multithreaded job.</p>
</dd>
</dl>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzahwbugco.htm" title="Use the concepts and techniques that are described here to learn about debugging and servicing multithreaded jobs:">Debugging and servicing of multithreaded jobs</a></div>
</div>
</div>
</body>
</html>