90 lines
5.2 KiB
HTML
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> |