Initial Commit
[packages] / xemacs-packages / jde / java / doc / jde / debugger / ThreadCommands.html
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Frameset//EN""http://www.w3.org/TR/REC-html40/frameset.dtd">\r
2 <!--NewPage-->\r
3 <HTML>\r
4 <HEAD>\r
5 <!-- Generated by javadoc on Fri Aug 20 11:02:11 PDT 1999 -->\r
6 <TITLE>\r
7 jdebug Documentation: Class  ThreadCommands\r
8 </TITLE>\r
9 <LINK REL ="stylesheet" TYPE="text/css" HREF="../../stylesheet.css" TITLE="Style">\r
10 </HEAD>\r
11 <BODY BGCOLOR="white">\r
12 \r
13 <!-- ========== START OF NAVBAR ========== -->\r
14 <A NAME="navbar_top"><!-- --></A>\r
15 <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0">\r
16 <TR>\r
17 <TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">\r
18 <A NAME="navbar_top_firstrow"><!-- --></A>\r
19 <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3">\r
20   <TR ALIGN="center" VALIGN="top">\r
21   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../overview-summary.html"><FONT ID="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>\r
22   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT ID="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>\r
23   <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>\r
24   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT ID="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>\r
25   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../deprecated-list.html"><FONT ID="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>\r
26   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../index-all.html"><FONT ID="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>\r
27   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../help-doc.html"><FONT ID="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>\r
28   </TR>\r
29 </TABLE>\r
30 </TD>\r
31 <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>\r
32 </EM>\r
33 </TD>\r
34 </TR>\r
35 \r
36 <TR>\r
37 <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">\r
38 &nbsp;<A HREF="../../jde/debugger/SpecCommands.html"><B>PREV CLASS</B></A>&nbsp;\r
39 &nbsp;NEXT CLASS</FONT></TD>\r
40 <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">\r
41   <A HREF="../../index.html" TARGET="_top"><B>FRAMES</B></A>  &nbsp;\r
42 &nbsp;<A HREF="ThreadCommands.html" TARGET="_top"><B>NO FRAMES</B></A></FONT></TD>\r
43 </TR>\r
44 <TR>\r
45 <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">\r
46   SUMMARY: &nbsp;INNER&nbsp;|&nbsp;<A HREF="#fields_inherited_from_class_jde.debugger.ApplicationCommands">FIELD</A>&nbsp;|&nbsp;<A HREF="#constructor_summary">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>\r
47 <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">\r
48 DETAIL: &nbsp;FIELD&nbsp;|&nbsp;<A HREF="#constructor_detail">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>\r
49 </TR>\r
50 </TABLE>\r
51 <!-- =========== END OF NAVBAR =========== -->\r
52 \r
53 <HR>\r
54 <!-- ======== START OF CLASS DATA ======== -->\r
55 <H2>\r
56 <FONT SIZE="-1">\r
57 jde.debugger</FONT>\r
58 <BR>\r
59 Class  ThreadCommands</H2>\r
60 <PRE>\r
61 java.lang.Object\r
62   |\r
63   +--<A HREF="../../jde/debugger/ApplicationCommands.html">jde.debugger.ApplicationCommands</A>\r
64         |\r
65         +--<B>jde.debugger.ThreadCommands</B>\r
66 </PRE>\r
67 <HR>\r
68 <DL>\r
69 <DT>public class <B>ThreadCommands</B><DT>extends <A HREF="../../jde/debugger/ApplicationCommands.html">ApplicationCommands</A></DL>\r
70 \r
71 <P>\r
72 ThreadCommands.java\r
73  <p>\r
74  Handles thread related commands. Jump to\r
75  '<A HREF="../../jde/debugger/ThreadCommands.html#doSuspend(java.lang.Integer, java.util.List)"><CODE>suspend</CODE></A>', <A HREF="../../jde/debugger/ThreadCommands.html#doResume(java.lang.Integer, java.util.List)"><CODE>resume</CODE></A>',\r
76  '<A HREF="../../jde/debugger/ThreadCommands.html#doInterrupt(java.lang.Integer, java.util.List)"><CODE>interrupt</CODE></A>', <A HREF="../../jde/debugger/ThreadCommands.html#doKillThread(java.lang.Integer, java.util.List)"><CODE>kill_thread</CODE></A>,\r
77  '<A HREF="../../jde/debugger/ThreadCommands.html#doGetThread(java.lang.Integer, java.util.List)"><CODE>get_thread</CODE></A>', '<A HREF="../../jde/debugger/ThreadCommands.html#doGetThread(java.lang.Integer, java.util.List)"><CODE>get_thread</CODE></A>',\r
78  '<A HREF="../../jde/debugger/ThreadCommands.html#doGetObjectMonitors(java.lang.Integer, java.util.List)"><CODE>get_object_monitors</CODE></A>',\r
79  '<A HREF="../../jde/debugger/ThreadCommands.html#doTraceThreads(java.lang.Integer, java.util.List)"><CODE>trace_threads</CODE></A>',\r
80  '<A HREF="../../jde/debugger/ThreadCommands.html#doCancelTraceThreads(java.lang.Integer, java.util.List)"><CODE>cancel_trace_threads</CODE></A>'\r
81  \r
82  <p>\r
83  Created: Fri Jul 30 16:04:07 1999\r
84 <P>\r
85 <DL>\r
86 <DT><B>Since: </B><DD>0.1</DD>\r
87 </DL>\r
88 <HR>\r
89 \r
90 <P>\r
91 <!-- ======== INNER CLASS SUMMARY ======== -->\r
92 \r
93 \r
94 <!-- =========== FIELD SUMMARY =========== -->\r
95 \r
96 <A NAME="fields_inherited_from_class_jde.debugger.ApplicationCommands"><!-- --></A>\r
97 <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">\r
98 <TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">\r
99 <TD><B>Fields inherited from class jde.debugger.<A HREF="../../jde/debugger/ApplicationCommands.html">ApplicationCommands</A></B></TD>\r
100 </TR>\r
101 <TR BGCOLOR="white" CLASS="TableRowColor">\r
102 <TD><CODE><A HREF="../../jde/debugger/ApplicationCommands.html#app">app</A>,  \r
103 <A HREF="../../jde/debugger/ApplicationCommands.html#identifiableEventRequests">identifiableEventRequests</A>,  \r
104 <A HREF="../../jde/debugger/ApplicationCommands.html#store">store</A></CODE></TD>\r
105 </TR>\r
106 </TABLE>\r
107 &nbsp;\r
108 <!-- ======== CONSTRUCTOR SUMMARY ======== -->\r
109 \r
110 <A NAME="constructor_summary"><!-- --></A>\r
111 <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">\r
112 <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">\r
113 <TD COLSPAN=2><FONT SIZE="+2">\r
114 <B>Constructor Summary</B></FONT></TD>\r
115 </TR>\r
116 <TR BGCOLOR="white" CLASS="TableRowColor">\r
117 <TD><CODE><B><A HREF="../../jde/debugger/ThreadCommands.html#ThreadCommands(jde.debugger.Application, jde.debugger.ObjectStore)">ThreadCommands</A></B>(<A HREF="../../jde/debugger/Application.html">Application</A>&nbsp;a,\r
118                <A HREF="../../jde/debugger/ObjectStore.html">ObjectStore</A>&nbsp;s)</CODE>\r
119 \r
120 <BR>\r
121 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</TD>\r
122 </TR>\r
123 </TABLE>\r
124 &nbsp;\r
125 <!-- ========== METHOD SUMMARY =========== -->\r
126 \r
127 <A NAME="method_summary"><!-- --></A>\r
128 <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">\r
129 <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">\r
130 <TD COLSPAN=2><FONT SIZE="+2">\r
131 <B>Method Summary</B></FONT></TD>\r
132 </TR>\r
133 <TR BGCOLOR="white" CLASS="TableRowColor">\r
134 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">\r
135 <CODE>&nbsp;void</CODE></FONT></TD>\r
136 <TD><CODE><B><A HREF="../../jde/debugger/ThreadCommands.html#doCancelTraceThreads(java.lang.Integer, java.util.List)">doCancelTraceThreads</A></B>(java.lang.Integer&nbsp;cmd_id,\r
137                      java.util.List&nbsp;args)</CODE>\r
138 \r
139 <BR>\r
140 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;'cancel_trace_threads' command.</TD>\r
141 </TR>\r
142 <TR BGCOLOR="white" CLASS="TableRowColor">\r
143 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">\r
144 <CODE>&nbsp;void</CODE></FONT></TD>\r
145 <TD><CODE><B><A HREF="../../jde/debugger/ThreadCommands.html#doGetObjectMonitors(java.lang.Integer, java.util.List)">doGetObjectMonitors</A></B>(java.lang.Integer&nbsp;cmd_id,\r
146                     java.util.List&nbsp;args)</CODE>\r
147 \r
148 <BR>\r
149 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;'get_object_monitors' command.</TD>\r
150 </TR>\r
151 <TR BGCOLOR="white" CLASS="TableRowColor">\r
152 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">\r
153 <CODE>&nbsp;void</CODE></FONT></TD>\r
154 <TD><CODE><B><A HREF="../../jde/debugger/ThreadCommands.html#doGetThread(java.lang.Integer, java.util.List)">doGetThread</A></B>(java.lang.Integer&nbsp;cmd_id,\r
155             java.util.List&nbsp;args)</CODE>\r
156 \r
157 <BR>\r
158 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;'get_thread' command.</TD>\r
159 </TR>\r
160 <TR BGCOLOR="white" CLASS="TableRowColor">\r
161 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">\r
162 <CODE>&nbsp;void</CODE></FONT></TD>\r
163 <TD><CODE><B><A HREF="../../jde/debugger/ThreadCommands.html#doGetThreads(java.lang.Integer, java.util.List)">doGetThreads</A></B>(java.lang.Integer&nbsp;cmd_id,\r
164              java.util.List&nbsp;args)</CODE>\r
165 \r
166 <BR>\r
167 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;List all threads.</TD>\r
168 </TR>\r
169 <TR BGCOLOR="white" CLASS="TableRowColor">\r
170 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">\r
171 <CODE>&nbsp;void</CODE></FONT></TD>\r
172 <TD><CODE><B><A HREF="../../jde/debugger/ThreadCommands.html#doInterrupt(java.lang.Integer, java.util.List)">doInterrupt</A></B>(java.lang.Integer&nbsp;cmd_id,\r
173             java.util.List&nbsp;args)</CODE>\r
174 \r
175 <BR>\r
176 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;'interrupt' command.</TD>\r
177 </TR>\r
178 <TR BGCOLOR="white" CLASS="TableRowColor">\r
179 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">\r
180 <CODE>&nbsp;void</CODE></FONT></TD>\r
181 <TD><CODE><B><A HREF="../../jde/debugger/ThreadCommands.html#doKillThread(java.lang.Integer, java.util.List)">doKillThread</A></B>(java.lang.Integer&nbsp;cmd_id,\r
182              java.util.List&nbsp;args)</CODE>\r
183 \r
184 <BR>\r
185 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;'kill' command.</TD>\r
186 </TR>\r
187 <TR BGCOLOR="white" CLASS="TableRowColor">\r
188 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">\r
189 <CODE>&nbsp;void</CODE></FONT></TD>\r
190 <TD><CODE><B><A HREF="../../jde/debugger/ThreadCommands.html#doResume(java.lang.Integer, java.util.List)">doResume</A></B>(java.lang.Integer&nbsp;cmd_id,\r
191          java.util.List&nbsp;args)</CODE>\r
192 \r
193 <BR>\r
194 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;'resume' command.</TD>\r
195 </TR>\r
196 <TR BGCOLOR="white" CLASS="TableRowColor">\r
197 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">\r
198 <CODE>&nbsp;void</CODE></FONT></TD>\r
199 <TD><CODE><B><A HREF="../../jde/debugger/ThreadCommands.html#doSuspend(java.lang.Integer, java.util.List)">doSuspend</A></B>(java.lang.Integer&nbsp;cmd_id,\r
200           java.util.List&nbsp;args)</CODE>\r
201 \r
202 <BR>\r
203 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;'suspend' command.</TD>\r
204 </TR>\r
205 <TR BGCOLOR="white" CLASS="TableRowColor">\r
206 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">\r
207 <CODE>&nbsp;void</CODE></FONT></TD>\r
208 <TD><CODE><B><A HREF="../../jde/debugger/ThreadCommands.html#doTraceThreads(java.lang.Integer, java.util.List)">doTraceThreads</A></B>(java.lang.Integer&nbsp;cmd_id,\r
209                java.util.List&nbsp;args)</CODE>\r
210 \r
211 <BR>\r
212 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;'trace_threads' command.</TD>\r
213 </TR>\r
214 <TR BGCOLOR="white" CLASS="TableRowColor">\r
215 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">\r
216 <CODE>(package private) static&nbsp;<A HREF="../../jde/debugger/LispForm.html">LispForm</A></CODE></FONT></TD>\r
217 <TD><CODE><B><A HREF="../../jde/debugger/ThreadCommands.html#getAllThreadsInformation(com.sun.jdi.VirtualMachine, jde.debugger.ObjectStore)">getAllThreadsInformation</A></B>(com.sun.jdi.VirtualMachine&nbsp;vm,\r
218                          <A HREF="../../jde/debugger/ObjectStore.html">ObjectStore</A>&nbsp;store)</CODE>\r
219 \r
220 <BR>\r
221 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns a representation of all the threads and threadgroups\r
222  in the VM.</TD>\r
223 </TR>\r
224 <TR BGCOLOR="white" CLASS="TableRowColor">\r
225 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">\r
226 <CODE>(package private) static&nbsp;com.sun.jdi.ThreadReference</CODE></FONT></TD>\r
227 <TD><CODE><B><A HREF="../../jde/debugger/ThreadCommands.html#getThread(com.sun.jdi.VirtualMachine, java.lang.String)">getThread</A></B>(com.sun.jdi.VirtualMachine&nbsp;vm,\r
228           java.lang.String&nbsp;name)</CODE>\r
229 \r
230 <BR>\r
231 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns the thread corresponding to this name</TD>\r
232 </TR>\r
233 </TABLE>\r
234 &nbsp;<A NAME="methods_inherited_from_class_jde.debugger.ApplicationCommands"><!-- --></A>\r
235 <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">\r
236 <TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">\r
237 <TD><B>Methods inherited from class jde.debugger.<A HREF="../../jde/debugger/ApplicationCommands.html">ApplicationCommands</A></B></TD>\r
238 </TR>\r
239 <TR BGCOLOR="white" CLASS="TableRowColor">\r
240 <TD><CODE><A HREF="../../jde/debugger/ApplicationCommands.html#addIdentifiableRequest(com.sun.jdi.request.EventRequest)">addIdentifiableRequest</A>, \r
241 <A HREF="../../jde/debugger/ApplicationCommands.html#deleteIdentifiableRequest(java.lang.Long)">deleteIdentifiableRequest</A></CODE></TD>\r
242 </TR>\r
243 </TABLE>\r
244 &nbsp;<A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>\r
245 <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">\r
246 <TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">\r
247 <TD><B>Methods inherited from class java.lang.Object</B></TD>\r
248 </TR>\r
249 <TR BGCOLOR="white" CLASS="TableRowColor">\r
250 <TD><CODE><clinit>, \r
251 clone, \r
252 equals, \r
253 finalize, \r
254 getClass, \r
255 hashCode, \r
256 notify, \r
257 notifyAll, \r
258 registerNatives, \r
259 toString, \r
260 wait, \r
261 wait, \r
262 wait</CODE></TD>\r
263 </TR>\r
264 </TABLE>\r
265 &nbsp;\r
266 <P>\r
267 \r
268 <!-- ============ FIELD DETAIL =========== -->\r
269 \r
270 \r
271 <!-- ========= CONSTRUCTOR DETAIL ======== -->\r
272 \r
273 <A NAME="constructor_detail"><!-- --></A>\r
274 <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">\r
275 <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">\r
276 <TD COLSPAN=1><FONT SIZE="+2">\r
277 <B>Constructor Detail</B></FONT></TD>\r
278 </TR>\r
279 </TABLE>\r
280 \r
281 <A NAME="ThreadCommands(jde.debugger.Application, jde.debugger.ObjectStore)"><!-- --></A><H3>\r
282 ThreadCommands</H3>\r
283 <PRE>\r
284 public <B>ThreadCommands</B>(<A HREF="../../jde/debugger/Application.html">Application</A>&nbsp;a,\r
285                       <A HREF="../../jde/debugger/ObjectStore.html">ObjectStore</A>&nbsp;s)</PRE>\r
286 <DL>\r
287 </DL>\r
288 \r
289 <!-- ============ METHOD DETAIL ========== -->\r
290 \r
291 <A NAME="method_detail"><!-- --></A>\r
292 <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">\r
293 <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">\r
294 <TD COLSPAN=1><FONT SIZE="+2">\r
295 <B>Method Detail</B></FONT></TD>\r
296 </TR>\r
297 </TABLE>\r
298 \r
299 <A NAME="doSuspend(java.lang.Integer, java.util.List)"><!-- --></A><H3>\r
300 doSuspend</H3>\r
301 <PRE>\r
302 public void <B>doSuspend</B>(java.lang.Integer&nbsp;cmd_id,\r
303                       java.util.List&nbsp;args)\r
304                throws <A HREF="../../jde/debugger/JDEException.html">JDEException</A></PRE>\r
305 <DL>\r
306 <DD>'suspend' command.\r
307  <p>\r
308 \r
309  <b>Syntax:</b>\r
310  <pre>\r
311  suspend [threadID]*\r
312  </pre>\r
313 \r
314  <b>Comments:</b>\r
315  <ul>\r
316  <li> threadIDs can be retrieved using the get_threads command\r
317  <li> if the list is omitted, the entire VM is suspended\r
318  <li> threadIDs can refer to either threads or threadgroups.\r
319  </ul></DL>\r
320 <HR>\r
321 \r
322 <A NAME="doResume(java.lang.Integer, java.util.List)"><!-- --></A><H3>\r
323 doResume</H3>\r
324 <PRE>\r
325 public void <B>doResume</B>(java.lang.Integer&nbsp;cmd_id,\r
326                      java.util.List&nbsp;args)\r
327               throws <A HREF="../../jde/debugger/JDEException.html">JDEException</A></PRE>\r
328 <DL>\r
329 <DD>'resume' command.\r
330  <p>\r
331 \r
332  <b>Syntax:</b>\r
333  <pre>\r
334  resume [threadID]*\r
335  </pre>\r
336 \r
337  <b>Comments:</b>\r
338  <ul>\r
339  <li> threadIDs can be retrieved using the get_threads command\r
340  <li> if the list is omitted, the entire VM is resumed\r
341  <li> threadIDs can refer to either threads or thereadgroups.\r
342  </ul></DL>\r
343 <HR>\r
344 \r
345 <A NAME="doInterrupt(java.lang.Integer, java.util.List)"><!-- --></A><H3>\r
346 doInterrupt</H3>\r
347 <PRE>\r
348 public void <B>doInterrupt</B>(java.lang.Integer&nbsp;cmd_id,\r
349                         java.util.List&nbsp;args)\r
350                  throws <A HREF="../../jde/debugger/JDEException.html">JDEException</A></PRE>\r
351 <DL>\r
352 <DD>'interrupt' command.\r
353  <p>\r
354 \r
355  <b>Syntax:</b>\r
356  <pre>\r
357  interrupt [threadID]+\r
358  </pre>\r
359 \r
360  <b>Comments:</b>\r
361  <ul>\r
362  <li> threadID can be retrieved using the get_threads command\r
363  <li> at least one threadId should be specified\r
364  </ul></DL>\r
365 <HR>\r
366 \r
367 <A NAME="doKillThread(java.lang.Integer, java.util.List)"><!-- --></A><H3>\r
368 doKillThread</H3>\r
369 <PRE>\r
370 public void <B>doKillThread</B>(java.lang.Integer&nbsp;cmd_id,\r
371                          java.util.List&nbsp;args)\r
372                   throws <A HREF="../../jde/debugger/JDEException.html">JDEException</A></PRE>\r
373 <DL>\r
374 <DD>'kill' command. Kill a thread with a given exception object.\r
375  <p>\r
376 \r
377  <b>Syntax:</b>\r
378  <pre>\r
379  kill_thread threadID exceptionObjectID\r
380  </pre>\r
381 \r
382  <b>Comments:</b>\r
383  <ul>\r
384  <li> threadID can be retrieved using the get_threads command\r
385  <li> exceptionObjectID is the object id of a Throwable object. It\r
386  can be created using the 'evaluate' command, or an existing throwable\r
387  object can be used.\r
388  </ul></DL>\r
389 <HR>\r
390 \r
391 <A NAME="doGetThreads(java.lang.Integer, java.util.List)"><!-- --></A><H3>\r
392 doGetThreads</H3>\r
393 <PRE>\r
394 public void <B>doGetThreads</B>(java.lang.Integer&nbsp;cmd_id,\r
395                          java.util.List&nbsp;args)\r
396                   throws <A HREF="../../jde/debugger/JDEException.html">JDEException</A></PRE>\r
397 <DL>\r
398 <DD>List all threads. 'get_threads' command.\r
399  <p>\r
400 \r
401  <b>Syntax:</b>\r
402  <pre>\r
403  get_threads\r
404  </pre>\r
405 \r
406  <b>Returns:</b>\r
407  <pre>\r
408  (jde-dbo-command-result cmd_id <A HREF="../../jde/debugger/ThreadCommands.html#getAllThreadsInformation(com.sun.jdi.VirtualMachine, jde.debugger.ObjectStore)"><CODE>thread-info</CODE></A>)\r
409  </pre>\r
410 \r
411  <b>Comments:</b>\r
412  <ul>\r
413  <li> There are a couple of quirks regarding the reporting\r
414  of thread state:\r
415  <ul>\r
416  <li> Quirk 1: Due to a bug in ThreadReference.isAtBreakpoint(),\r
417         a thread will report a breakpoint at a location\r
418               even if a threadFilter has been applied for the\r
419               thread. ie, if test.Test.java:41 is your\r
420               breakpoint, and you've applied a threadfilter\r
421               saying you DON'T want an event if the thread ==\r
422               Thread-A, and you somehow suspend Thread-A at\r
423               exactly that line, and do a 'get_threads';\r
424               Thread-A will report to be suspended on a\r
425               breakpoint, although ordinarily it would have\r
426               skipped it.\r
427 \r
428  <li> Quirk 2: There seems to be no way of reporting the\r
429         status if the user does a\r
430               Thread.suspend(). Well, it's deprecated\r
431               anyways... *shrug*.\r
432  </ul>\r
433  </ul></DL>\r
434 <HR>\r
435 \r
436 <A NAME="getAllThreadsInformation(com.sun.jdi.VirtualMachine, jde.debugger.ObjectStore)"><!-- --></A><H3>\r
437 getAllThreadsInformation</H3>\r
438 <PRE>\r
439 static <A HREF="../../jde/debugger/LispForm.html">LispForm</A> <B>getAllThreadsInformation</B>(com.sun.jdi.VirtualMachine&nbsp;vm,\r
440                                          <A HREF="../../jde/debugger/ObjectStore.html">ObjectStore</A>&nbsp;store)</PRE>\r
441 <DL>\r
442 <DD>Returns a representation of all the threads and threadgroups\r
443  in the VM. For example:\r
444  <pre>\r
445               ThreadGroup-1\r
446                   +- ThreadGroup-2\r
447                   |        +- ThreadGroup-3\r
448                   |        |        \- Thread-1\r
449                   |        +- ThreadGroup-4\r
450                   |        |        +- Thread-2\r
451                   |        |        \- Thread-3\r
452                   |        \- Thread-4\r
453                   \- Thread-5\r
454               ThreadGroup-5\r
455                   +- Thread-6\r
456 \r
457 \r
458           (list\r
459             (list "ThreadGroup" <tgID> "ThreadGroup-1"\r
460               (list \r
461                 (list "Thread" <tID> "Thread-5" ...))\r
462               (list \r
463                 (list "ThreadGroup" <tgID> "ThreadGroup-2"\r
464                   (list \r
465                     (list "Thread" <tID> "Thread-4"))\r
466                   (list \r
467                     (list "ThreadGroup" <tgID> "ThreadGroup-3"\r
468                       (list)\r
469                       (list \r
470                         (list "Thread" <tID> "Thread-1" ...)))\r
471                     (list "ThreadGroup" <tgID> "ThreadGroup-4"\r
472                       (list)\r
473                         (list\r
474                           (list "Thread" <tID> "Thread-2" ...)\r
475                           (list "Thread" <tID> "Thread-3" ...)))))))\r
476           (list "ThreadGroup" <tgID> "ThreadGroup-5"\r
477             (list)\r
478               (list\r
479                 (list "Thread" <tID> "Thread-6" ...))))\r
480  </pre>\r
481  <b>Syntax:</b>\r
482  <pre>\r
483  (list [<A HREF="../../jde/debugger/Rep.html#getThreadGroupRep(com.sun.jdi.ThreadGroupReference, jde.debugger.ObjectStore)"><CODE>top-level thread group</CODE></A>]*)\r
484  </pre><DD><DL>\r
485 <DT><B>Parameters:</B><DD><CODE>vm</CODE> - The virtual machine itself<DD><CODE>store</CODE> - The object store where you should keep references to\r
486  the thread ids. For details, see <A HREF="../../jde/debugger/ObjectStore.html"><CODE>ObjectStore</CODE></A></DL>\r
487 </DD>\r
488 </DL>\r
489 <HR>\r
490 \r
491 <A NAME="getThread(com.sun.jdi.VirtualMachine, java.lang.String)"><!-- --></A><H3>\r
492 getThread</H3>\r
493 <PRE>\r
494 static com.sun.jdi.ThreadReference <B>getThread</B>(com.sun.jdi.VirtualMachine&nbsp;vm,\r
495                                              java.lang.String&nbsp;name)</PRE>\r
496 <DL>\r
497 <DD>Returns the thread corresponding to this name</DL>\r
498 <HR>\r
499 \r
500 <A NAME="doGetThread(java.lang.Integer, java.util.List)"><!-- --></A><H3>\r
501 doGetThread</H3>\r
502 <PRE>\r
503 public void <B>doGetThread</B>(java.lang.Integer&nbsp;cmd_id,\r
504                         java.util.List&nbsp;args)\r
505                  throws <A HREF="../../jde/debugger/JDEException.html">JDEException</A></PRE>\r
506 <DL>\r
507 <DD>'get_thread' command. List a thread in more detail.\r
508  <p>\r
509 \r
510  <b>Syntax:</b>\r
511  <pre>\r
512  get_thread threadID\r
513  </pre>\r
514 \r
515  <b>Returns:</b>\r
516  <pre>\r
517  (jde-dbo-command-result cmd_id <A HREF="../../jde/debugger/Rep.html#getThreadRep(com.sun.jdi.ThreadReference, jde.debugger.ObjectStore, boolean)"><CODE>detailed-thread-info</CODE></A>)\r
518  </pre>\r
519 \r
520  <b>Comments:</b>\r
521  <ul>\r
522  <li> The thread can be waiting for a monitor through entry\r
523  into a synchronized method, the synchronized\r
524  statement, or Object.wait(). The status() method can be used to\r
525  differentiate between the first two cases and the third. \r
526  </ul></DL>\r
527 <HR>\r
528 \r
529 <A NAME="doGetObjectMonitors(java.lang.Integer, java.util.List)"><!-- --></A><H3>\r
530 doGetObjectMonitors</H3>\r
531 <PRE>\r
532 public void <B>doGetObjectMonitors</B>(java.lang.Integer&nbsp;cmd_id,\r
533                                 java.util.List&nbsp;args)\r
534                          throws <A HREF="../../jde/debugger/JDEException.html">JDEException</A></PRE>\r
535 <DL>\r
536 <DD>'get_object_monitors' command. Information about the monitors\r
537  corresponding to a particular object.\r
538  <p>\r
539 \r
540  <b>Syntax:</b>\r
541  <pre>\r
542  get_object_monitors objectID\r
543  </pre>\r
544 \r
545  <b>Returns:</b>\r
546  <pre>\r
547  (jde-dbo-command-result cmd_id <A HREF="../../jde/debugger/Rep.html#getObjectMonitorsRep(com.sun.jdi.ObjectReference, jde.debugger.ObjectStore)"><CODE>object-monitors-info</CODE></A>)\r
548  </pre></DL>\r
549 <HR>\r
550 \r
551 <A NAME="doTraceThreads(java.lang.Integer, java.util.List)"><!-- --></A><H3>\r
552 doTraceThreads</H3>\r
553 <PRE>\r
554 public void <B>doTraceThreads</B>(java.lang.Integer&nbsp;cmd_id,\r
555                            java.util.List&nbsp;args)\r
556                     throws <A HREF="../../jde/debugger/JDEException.html">JDEException</A></PRE>\r
557 <DL>\r
558 <DD>'trace_threads' command.\r
559  <p>\r
560 \r
561  <b>Syntax:</b>\r
562  <pre>\r
563  trace_threads <u>type</u> [threadID]\r
564       [<A HREF="../../jde/debugger/Etc.html#getSuspendPolicyFromArgs(java.util.List)"><CODE>suspend-policy</CODE></A>]\r
565  </pre>\r
566 \r
567  <b>Comments:</b>\r
568  <ul>\r
569  <li> <u>type</u> can be either "start" or "death"\r
570  <li> If no threadID is specified, all the corresponding thread\r
571  events are raised.\r
572  </ul>\r
573 \r
574  <p><DD><DL>\r
575 <DT><B>See Also: </B><DD><A HREF="../../jde/debugger/EventHandler.html#threadStartEvent(com.sun.jdi.event.ThreadStartEvent)"><CODE>EventHandler.threadStartEvent(ThreadStartEvent)</CODE></A>, \r
576 <A HREF="../../jde/debugger/EventHandler.html#threadDeathEvent(com.sun.jdi.event.ThreadDeathEvent)"><CODE>EventHandler.threadDeathEvent(ThreadDeathEvent)</CODE></A></DL>\r
577 </DD>\r
578 </DL>\r
579 <HR>\r
580 \r
581 <A NAME="doCancelTraceThreads(java.lang.Integer, java.util.List)"><!-- --></A><H3>\r
582 doCancelTraceThreads</H3>\r
583 <PRE>\r
584 public void <B>doCancelTraceThreads</B>(java.lang.Integer&nbsp;cmd_id,\r
585                                  java.util.List&nbsp;args)\r
586                           throws <A HREF="../../jde/debugger/JDEException.html">JDEException</A></PRE>\r
587 <DL>\r
588 <DD>'cancel_trace_threads' command.\r
589  <p>\r
590 \r
591  <b>Syntax: </b>\r
592  <pre>\r
593  cancel_trace_threads <u>requestID</u>\r
594  </pre>\r
595 \r
596  <b>Comments:</b>\r
597  <ul>\r
598  <li> <u>requestID</u> is returned in the trace threads reply\r
599  </ul></DL>\r
600 <!-- ========= END OF CLASS DATA ========= -->\r
601 <HR>\r
602 \r
603 <!-- ========== START OF NAVBAR ========== -->\r
604 <A NAME="navbar_bottom"><!-- --></A>\r
605 <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0">\r
606 <TR>\r
607 <TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">\r
608 <A NAME="navbar_bottom_firstrow"><!-- --></A>\r
609 <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3">\r
610   <TR ALIGN="center" VALIGN="top">\r
611   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../overview-summary.html"><FONT ID="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>\r
612   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT ID="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>\r
613   <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>\r
614   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT ID="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>\r
615   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../deprecated-list.html"><FONT ID="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>\r
616   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../index-all.html"><FONT ID="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>\r
617   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../help-doc.html"><FONT ID="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>\r
618   </TR>\r
619 </TABLE>\r
620 </TD>\r
621 <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>\r
622 </EM>\r
623 </TD>\r
624 </TR>\r
625 \r
626 <TR>\r
627 <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">\r
628 &nbsp;<A HREF="../../jde/debugger/SpecCommands.html"><B>PREV CLASS</B></A>&nbsp;\r
629 &nbsp;NEXT CLASS</FONT></TD>\r
630 <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">\r
631   <A HREF="../../index.html" TARGET="_top"><B>FRAMES</B></A>  &nbsp;\r
632 &nbsp;<A HREF="ThreadCommands.html" TARGET="_top"><B>NO FRAMES</B></A></FONT></TD>\r
633 </TR>\r
634 <TR>\r
635 <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">\r
636   SUMMARY: &nbsp;INNER&nbsp;|&nbsp;<A HREF="#fields_inherited_from_class_jde.debugger.ApplicationCommands">FIELD</A>&nbsp;|&nbsp;<A HREF="#constructor_summary">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>\r
637 <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">\r
638 DETAIL: &nbsp;FIELD&nbsp;|&nbsp;<A HREF="#constructor_detail">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>\r
639 </TR>\r
640 </TABLE>\r
641 <!-- =========== END OF NAVBAR =========== -->\r
642 \r
643 <HR>\r
644 \r
645 </BODY>\r
646 </HTML>\r