← Back to branch summary

~ubuntu-branches/ubuntu/quantal/netbeans/quantal

« back to all changes in this revision

Viewing changes to java/helpset/javahelp/org/netbeans/modules/java/helpset/docs/debug/CSH/threads_view.html

  • Committer: Bazaar Package Importer
  • Author(s): Marek Slama
  • Date: 2008-01-29 14:11:22 UTC
  • Revision ID: james.westby@ubuntu.com-20080129141122-fnzjbo11ntghxfu7
Tags: upstream-6.0.1
Import upstream version 6.0.1

Show diffs side-by-side

added added

removed removed

Lines of Context:
java/helpset/javahelp/org/netbeans/modules/java/helpset/docs/debug/CSH/threads_view.html
 
1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
 
2
<!--
 
3
* Copyright � 2007 Sun Microsystems, Inc. All rights reserved.
 
4
*     Use is subject to license terms.
 
5
*
 
6
-->
 
7
<html>
 
8
<head>
 
9
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
 
10
<title>Debugging: Threads Window</title>
 
11
        <link rel="StyleSheet" href="nbdocs://org.netbeans.modules.usersguide/org/netbeans/modules/usersguide/ide.css" type="text/css">
 
12
</head>
 
13
<body>
 
14
 
 
15
<h2>Debugging: Threads Window</h2>
 
16
<p><small><a href="#seealso">See Also</a></small></p>
 
17
 
 
18
<p>The Threads window lists all threads in the current debugging session. 
 
19
You open the Threads window by choosing Window &gt; Debugging &gt; Threads.</p>
 
20
<p>The information given for each thread is the thread name, state and if the thread is suspended. 
 
21
One thread is the current thread. 
 
22
By default, the current thread is the thread in the current session from which the debugger gained control. 
 
23
When you select a different current session, the Threads window is updated to show the threads for that session.</p>
 
24
 
 
25
<h3><a name="threadstates">Thread States</a></h3>
 
26
<p>The following table describes the thread states for the debugger. </p>
 
27
<table border="1" cellpadding="5" cellspacing="0">
 
28
        <tr align="left" valign="top">
 
29
                <th scope="col">State</th>
 
30
                <th scope="col">Description</th>
 
31
        </tr>
 
32
        <tr valign="top">
 
33
                <td>Monitor</td>
 
34
                <td>Thread is waiting on a Java monitor.</td>
 
35
        </tr>
 
36
        <tr valign="top">
 
37
                <td>Not Started</td>
 
38
                <td>Thread has not yet been started.</td>
 
39
        </tr>
 
40
        <tr valign="top">
 
41
                <td>Running</td>
 
42
                <td>Thread is runnable.</td>
 
43
        </tr>
 
44
        <tr valign="top">
 
45
                <td>Sleeping</td>
 
46
                <td>Thread is sleeping. <tt>Thread.sleep()</tt> was called.</td>
 
47
        </tr>
 
48
        <tr valign="top">
 
49
                <td>Unknown</td>
 
50
                <td>Thread status is unknown.</td>
 
51
        </tr>
 
52
        <tr valign="top">
 
53
                <td>Wait</td>
 
54
                <td>Thread is waiting. <tt>Object.wait()</tt> was called.</td>
 
55
        </tr>
 
56
        <tr valign="top">
 
57
                <td>Zombie</td>
 
58
                <td>Thread has completed execution.</td>
 
59
        </tr>
 
60
</table>
 
61
 
 
62
<h3><a name="icons">Icons</a></h3>
 
63
<p>The following table describes the icons displayed to the left of the object name.</p>
 
64
<table border="1" cellpadding="5" cellspacing="0">
 
65
        <tr align="left" valign="top">
 
66
                <th scope="col">Icon</th>
 
67
                <th scope="col">Description</th>
 
68
        </tr>
 
69
        <tr>
 
70
                <td align="center"><img src="../images/CurrentThreadGroup.gif" alt="Current thread group"></td>
 
71
                <td>The thread group that contains the current thread</td>
 
72
        </tr>
 
73
        <tr>
 
74
                <td align="center"><img src="../images/ThreadGroup.gif" alt="Thread group"></td>
 
75
                <td>A thread group that does not contain the current thread</td>
 
76
        </tr>
 
77
        <tr>
 
78
                <td align="center"><img src="../images/CurrentThread.gif" alt="Current thread"></td>
 
79
                <td>The current thread</td>
 
80
        </tr>
 
81
        <tr>
 
82
                <td align="center"><img src="../images/RunningThread.gif" alt="Running thread"></td>
 
83
                <td>A thread that is running and is not current</td>
 
84
        </tr>
 
85
        <tr>
 
86
                <td align="center"><img src="../images/SuspendedThread.gif" alt="Suspended thread"></td>
 
87
                <td>A thread that is suspended and is not current</td>
 
88
        </tr>
 
89
</table>
 
90
 
 
91
<h3><a name="actions">Actions</a></h3>
 
92
<p>Right-clicking the Threads window opens the pop-up menu, where you can choose the following actions:</p>
 
93
<table border="1" cellpadding="5" cellspacing="0">
 
94
        <tr align="left" valign="top">
 
95
            <th scope="col">Menu Item</th>
 
96
            <th scope="col">Description</th>
 
97
        </tr>
 
98
        <tr valign="top">
 
99
          <td>Make Current </td>
 
100
          <td>Makes the selected thread the current thread. This command is equivalent to double-clicking the thread.</td>
 
101
        </tr>
 
102
        <tr valign="top">
 
103
          <td>Resume</td>
 
104
          <td>Resumes execution of the selected thread. </td>
 
105
        </tr>
 
106
        <tr valign="top">
 
107
          <td>Suspend</td>
 
108
          <td>Suspends execution of the selected thread. </td>
 
109
        </tr>
 
110
        <tr valign="top">
 
111
          <td>Interrupt</td>
 
112
          <td>Interrupts execution of the selected thread. </td>
 
113
        </tr>
 
114
        <tr valign="top">
 
115
            <td>Go to Source</td>
 
116
            <td>Shows the source code for the newest frame on the selected thread's stack.</td>
 
117
        </tr>
 
118
        <tr valign="top">
 
119
            <td>List Options</td>
 
120
            <td>Enables you to customize the display of the Threads window, including adding and removing columns of information, reordering the columns, and sorting the columns. 
 
121
            See <a href="../debug_customize_views.html">Customizing a Debugger Window</a> for more information. </td>
 
122
        </tr>
 
123
</table>
 
124
 
 
125
<h3>Properties</h3>
 
126
 <p>By default, all thread properties are displayed directly in the Threads window, except for the Suspended property.
 
127
 To display the Suspended property in the Threads window, 
 
128
 click the <img src="../images/ChangeColumn.gif" alt="Change Column">&nbsp;icon in the upper right corner of the window, 
 
129
 or right-click in the window and choose List Options &gt; Change Visible Columns and then select the Suspended checkbox in the dialog box.</p>
 
130
 <p>If a thread is suspended (for example because a breakpoint was reached during the debugging session), 
 
131
 the checkbox for that thread is selected in the Suspended column.
 
132
Deselecting the Suspended checkbox causes the thread to resume.</p>
 
133
 
 
134
<dl>
 
135
        <dt><a name="seealso">See Also</a></dt>
 
136
        <dd><a href="../debug_context.html">Current Context in the Debugger</a></dd>
 
137
        <dd><a href="../debug_threads.html">Debugging Threads in the IDE</a></dd>
 
138
        <dd><a href="debug_window.html">Debugger Windows</a></dd>
 
139
</dl>
 
140
<hr>
 
141
<small><a href="../../credits.html">Legal Notices</a></small>
 
142
<table cellpadding="50" border="0">
 
143
<tr>
 
144
<td>&nbsp;</td>
 
145
</tr>
 
146
</table>
 
147
</body>
 
148
</html>