ThreadReference Command Set

TABLE 17 – Structure of Out Data for Name Command
`threadID`	threadObject	The thread object ID.

Reply Data

TABLE 18 – Structure of Reply Data for Name Command
`string`	threadName	The thread name.

Unlike java.lang.Thread.suspend(), suspends of both the virtual machine and individual threads are counted. Before a thread can run again, it must be resumed the same number of times it has been suspended.

Suspending single threads with this command has the same dangers as is the case with method java.lang.Thread.suspend(). If the suspended thread holds a monitor needed by another running thread, deadlock is possible in the target VM (at least until the suspended thread is resumed again).

The suspended thread is guaranteed to remain suspended until resumed through one of the JDI resume methods mentioned above.

Note that this doesn't change the status of the thread (see the ThreadStatus command.) For example, if it was Running, it still appears to other threads to be running.

Out Data

TABLE 19 – Structure of Out Data for Suspend Command
`threadID`	threadObject	The thread object ID.

Reply Data

Resumes the execution of a given thread. If this thread was not previously suspended by the front-end, calling this command has no effect. Otherwise, the count of pending suspends on this thread is decremented. If it is decremented to 0, the thread continues to execute.

Out Data

TABLE 20 – Structure of Out Data for Resume Command
`threadID`	threadObject	The thread object ID.

Reply Data

Returns the current status of a thread. The thread status reply indicates the thread status the last time it was running. The suspend status provides information on the thread's suspension, if any.

Out Data

TABLE 21 – Structure of Out Data for Status Command
`threadID`	threadObject	The thread object ID.

Reply Data

TABLE 22 – Structure of Reply Data for Status Command
`int`	threadStatus	One of the thread status codes. See `KDWP.ThreadStatus`
`int`	suspendStatus	One of the suspend status codes. See `KDWP.SuspendStatus`

Returns the current call stack of a suspended thread. The sequence of frames starts with the currently executing frame, followed by its caller, and so on. The thread must be suspended, and the returned frameID is valid only while the thread is suspended.

Out Data

TABLE 23 – Structure of Out Data for Frames Command
`threadID`	threadObject	The thread object ID.
`int`	startFrame	The index of the first frame to retrieve.
`int`	length	The count of frames to retrieve (-1 means all remaining).

Reply Data

TABLE 24 – Structure of Reply Data for Frames Command
`int`	frames	number of frames retrieved
Repeated frames times:
`frameID`	frameID	The ID of this frame.
`location`	location	The current location of this frame

Returns the count of frames on this thread's stack. The thread must be suspended, and the returned count is valid only while the thread is suspended.

Out Data

TABLE 25 – Structure of Out Data for FrameCount Command
`threadID`	threadObject	The thread object ID.

Reply Data

TABLE 26 – Structure of Reply Data for FrameCount Command
`int`	frameCount	The count of frames on this thread's stack.

Stops the thread with an asynchronous exception, as if done by java.lang.Thread.stop.

Out Data

TABLE 27 – Structure of Out Data for Stop Command
`threadID`	threadObject	The thread object ID.
`objectID`	throwable	Asynchronous exception. This object must be an instance of `java.lang.Throwable` or a subclass

Reply Data

Get the suspend count for this thread. The suspend count is the number of times the thread has been suspended through the thread-level or VM-level suspend commands without a corresponding resume.

Out Data

TABLE 28 – Structure of Out Data for SuspendCount Command
`threadID`	threadObject	The thread object ID.

Reply Data

TABLE 29 – Structure of Reply Data for SuspendCount Command
`int`	suspendCount	The number of outstanding suspends of this thread.

Copyright © 2002 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Third-party software, including font technology, is copyrighted and licensed from Sun suppliers. Sun, Sun Microsystems, the Sun logo, Java and Solaris are trademarks or registered trademarks of Sun Microsystems, Inc. in the US and other countries. Federal Acquisitions: Commercial Software - Government Users Subject to Standard License Terms and Conditions.

Copyright © 2002 Sun Microsystems, Inc. Tous droits réservés. Distribué par des licences qui en restreignent l'utilisation. Le logiciel détenu par des tiers, et qui comprend la technologie relative aux polices de caractères, est protégé par un copyright et licencié par des fournisseurs de Sun. Sun, Sun Microsystems, le logo Sun, Java et Solaris sont des marques de fabrique ou des marques déposées de Sun Microsystems, Inc. aux Etats-Unis et dans d'autres pays.

Chapter 7