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

90 lines
5.6 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="Options to view thread information" />
<meta name="abstract" content="The Display Job (DSPJOB), Work with Job (WRKJOB), and Work with Active Jobs (WRKACTJOB) commands allow you to display and work with threads associated with an i5/OS job." />
<meta name="description" content="The Display Job (DSPJOB), Work with Job (WRKJOB), and Work with Active Jobs (WRKACTJOB) commands allow you to display and work with threads associated with an i5/OS 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="rzahwork-orkco" />
<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>Options to view thread information</title>
</head>
<body id="rzahwork-orkco"><a name="rzahwork-orkco"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Options to view thread information</h1>
<div><p>The <span class="cmdname">Display Job (DSPJOB)</span>, <span class="cmdname">Work with
Job (WRKJOB)</span>, and <span class="cmdname">Work with Active Jobs (WRKACTJOB)</span> commands
allow you to display and work with threads associated with an <span class="keyword">i5/OS™</span> job.</p>
<div class="section"><div class="p">Through each of these commands, you can select an option that
allows you to display or work with the threads in the job. You can use the
Work with Threads display to view the following information for the job:<ul><li>List of threads:<p>This display shows all of the threads that are currently
associated with the job. The first thread in the list is the initial thread
in the process. An eight-digit number (Thread) identifies threads by their
identifier. This list changes depending on the thread activity in the job.
Other information about this display includes the thread's status
of active or waiting, total CPU usage, total auxiliary storage I/O counts,
and thread run priority.</p>
</li>
<li>Thread call stack option:<p>This option displays the call stack of any
thread. In some conditions, typically when the thread is running an instruction
that cannot be interrupted, the call stack cannot be displayed. In these cases,
a message indicates that no stack information is available is displayed.</p>
</li>
<li>Thread mutual exclusions (mutexes) option:<p>This option allows you to
see all mutexes associated with a specific thread. This includes mutexes that
are held and the mutex for which the thread might be waiting. If the specified
thread has no mutexes that are associated with it, the Job or thread has no
mutexes message is displayed. </p>
</li>
<li>Thread locks option:<p>This option allows you see all the thread-scoped
object locks held by the thread. It also allows you to see all pending process-scoped
locks and thread-scoped locks on which the the thread is waiting. If the specified
thread has no object locks associated with it, the Thread has no locks message
is displayed. </p>
</li>
<li>Hold thread option:<p>This option allows you to temporarily suspend the
running of a specific thread. This option is useful if you suspect that a
thread might be looping or causing some other system problem. You must use
the Hold thread option in conjunction with the Release thread option. Unlike <span class="cmdname">Hold
Job (HLDJOB)</span>, repeated Hold thread requests are cumulative. To resume
the running of a held thread, you must issue the equivalent number of Release
thread requests. </p>
</li>
<li>Release thread option:<p>This option is used to resume the running of
a thread that has been suspended.</p>
</li>
<li>End thread option:<p>This option allows you to end a specific thread.
In general, you should not use of this option because it can cause unpredictable
results. This option requires *SERVICE special authority. </p>
</li>
</ul>
</div>
<p>The <span class="cmdname">Release Job (RLSJOB)</span>, <span class="cmdname">Hold Job
(HLDJOB)</span>, <span class="cmdname">End Job (ENDJOB)</span>, and <span class="cmdname">End
Job Abnormal (ENDJOBABN)</span> commands affect all threads within a multithreaded
job. No commands are planned to provide the equivalent thread-level support.</p>
</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>