Bug 261400 - Port the PDA example debugger's virtual machine from Perl to Java

63 files changed, 2659 insertions, 378 deletions

diff --git a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/pda/breakpoints/PDALineBreakpoint.java b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/pda/breakpoints/PDALineBreakpoint.java
index 24062b0b5..894d7432c 100644
--- a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/pda/breakpoints/PDALineBreakpoint.java
+++ b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/pda/breakpoints/PDALineBreakpoint.java
@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2005, 2007 IBM Corporation and others.
+ * Copyright (c) 2005, 2009 IBM Corporation and others.
  * All rights reserved. This program and the accompanying materials
  * are made available under the terms of the Eclipse Public License v1.0
  * which accompanies this distribution, and is available at
@@ -8,6 +8,7 @@
  * Contributors:
  *     IBM Corporation - initial API and implementation
  *     Bjorn Freeman-Benson - initial API and implementation
+ *     Pawel Piech (Wind River) - ported PDA Virtual Machine to Java (Bug 261400)
  *******************************************************************************/
 package org.eclipse.debug.examples.core.pda.breakpoints;
 
@@ -16,14 +17,18 @@ import org.eclipse.core.resources.IResource;
 import org.eclipse.core.resources.IWorkspaceRunnable;
 import org.eclipse.core.runtime.CoreException;
 import org.eclipse.core.runtime.IProgressMonitor;
-import org.eclipse.debug.core.DebugException;
 import org.eclipse.debug.core.model.IBreakpoint;
-import org.eclipse.debug.core.model.IThread;
 import org.eclipse.debug.core.model.LineBreakpoint;
 import org.eclipse.debug.examples.core.pda.DebugCorePlugin;
 import org.eclipse.debug.examples.core.pda.model.IPDAEventListener;
 import org.eclipse.debug.examples.core.pda.model.PDADebugTarget;
 import org.eclipse.debug.examples.core.pda.model.PDAThread;
+import org.eclipse.debug.examples.core.protocol.PDAClearBreakpointCommand;
+import org.eclipse.debug.examples.core.protocol.PDAEvent;
+import org.eclipse.debug.examples.core.protocol.PDARunControlEvent;
+import org.eclipse.debug.examples.core.protocol.PDASetBreakpointCommand;
+import org.eclipse.debug.examples.core.protocol.PDASuspendedEvent;
+import org.eclipse.debug.examples.core.protocol.PDAVMSuspendedEvent;
 
 
 /**
@@ -108,7 +113,7 @@ public class PDALineBreakpoint extends LineBreakpoint implements IPDAEventListen
 		//#ifdef ex3
 //#		// TODO: Exercise 3 - create breakpoint request in interpreter 		
 		//#else
-    	target.sendRequest("set " + (getLineNumber() - 1));
+    	target.sendCommand(new PDASetBreakpointCommand((getLineNumber() - 1), false));
 		//#endif
     }
     
@@ -123,7 +128,7 @@ public class PDALineBreakpoint extends LineBreakpoint implements IPDAEventListen
 		//#ifdef ex3
 //#		// TODO: Exercise 3 - clear breakpoint request in interpreter
 		//#else
-    	target.sendRequest("clear " + (getLineNumber() - 1));
+        target.sendCommand(new PDAClearBreakpointCommand((getLineNumber() - 1)));
 		//#endif
     }
     
@@ -154,16 +159,12 @@ public class PDALineBreakpoint extends LineBreakpoint implements IPDAEventListen
     /**
      * Notify's the PDA interprettor that this breakpoint has been hit.
      */
-    protected void notifyThread() {
+    protected void notifyThread(int threadId) {
     	if (fTarget != null) {
-			try {
-				IThread[] threads = fTarget.getThreads();
-				if (threads.length == 1) {
-	    			PDAThread thread = (PDAThread)threads[0];
-	    			thread.suspendedBy(this);
-	    		}
-			} catch (DebugException e) {
-			}    		
+			PDAThread thread = fTarget.getThread(threadId);
+			if (thread != null) {
+    			thread.suspendedBy(this);
+    		}
     	}
     }
 
@@ -173,9 +174,12 @@ public class PDALineBreakpoint extends LineBreakpoint implements IPDAEventListen
 	 * 
 	 * @see org.eclipse.debug.examples.core.pda.model.IPDAEventListener#handleEvent(java.lang.String)
 	 */
-	public void handleEvent(String event) {
-		if (event.startsWith("suspended breakpoint")) {
-			handleHit(event);
+	public void handleEvent(PDAEvent event) {
+		if (event instanceof PDASuspendedEvent || event instanceof PDAVMSuspendedEvent) {
+		    PDARunControlEvent rcEvent = (PDARunControlEvent)event;
+		    if (rcEvent.fReason.equals("breakpoint")) {
+		        handleHit(rcEvent);
+		    }
 		}
 	}
     
@@ -184,16 +188,16 @@ public class PDALineBreakpoint extends LineBreakpoint implements IPDAEventListen
      * 
      * @param event breakpoint event
      */
-    private void handleHit(String event) {
-    	int lastSpace = event.lastIndexOf(' ');
+    private void handleHit(PDARunControlEvent event) {
+    	int lastSpace = event.fMessage.lastIndexOf(' ');
     	if (lastSpace > 0) {
-    		String line = event.substring(lastSpace + 1);
+    		String line = event.fMessage.substring(lastSpace + 1);
     		int lineNumber = Integer.parseInt(line);
     		// breakpoints event line numbers are 0 based, model objects are 1 based
     		lineNumber++;
     		try {
 				if (getLineNumber() == lineNumber) {
-					notifyThread();
+					notifyThread(event.fThreadId);
 				}
     		} catch (CoreException e) {
     		}
diff --git a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/pda/breakpoints/PDAWatchpoint.java b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/pda/breakpoints/PDAWatchpoint.java
index ab819d0b5..651532909 100644
--- a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/pda/breakpoints/PDAWatchpoint.java
+++ b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/pda/breakpoints/PDAWatchpoint.java
@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2005, 2007 IBM Corporation and others.
+ * Copyright (c) 2005, 2009 IBM Corporation and others.
  * All rights reserved. This program and the accompanying materials
  * are made available under the terms of the Eclipse Public License v1.0
  * which accompanies this distribution, and is available at
@@ -8,6 +8,7 @@
  * Contributors:
  *     IBM Corporation - initial API and implementation
  *     Bjorn Freeman-Benson - initial API and implementation
+ *     Pawel Piech (Wind River) - ported PDA Virtual Machine to Java (Bug 261400)
  *******************************************************************************/
 package org.eclipse.debug.examples.core.pda.breakpoints;
 
@@ -19,6 +20,11 @@ import org.eclipse.core.runtime.IProgressMonitor;
 import org.eclipse.debug.core.model.IBreakpoint;
 import org.eclipse.debug.core.model.IWatchpoint;
 import org.eclipse.debug.examples.core.pda.model.PDADebugTarget;
+import org.eclipse.debug.examples.core.protocol.PDAEvent;
+import org.eclipse.debug.examples.core.protocol.PDARunControlEvent;
+import org.eclipse.debug.examples.core.protocol.PDASuspendedEvent;
+import org.eclipse.debug.examples.core.protocol.PDAVMSuspendedEvent;
+import org.eclipse.debug.examples.core.protocol.PDAWatchCommand;
 
 
 /**
@@ -177,23 +183,26 @@ public class PDAWatchpoint extends PDALineBreakpoint implements IWatchpoint {
         if (isModification()) {
             flag = flag | 2;
         }		
-		target.sendRequest("watch " + getFunctionName() + "::" + getVariableName() + " " + flag);
+		target.sendCommand(new PDAWatchCommand(getFunctionName(), getVariableName(), flag));
 	}
 	
 	/* (non-Javadoc)
 	 * @see org.eclipse.debug.examples.core.pda.breakpoints.PDALineBreakpoint#clearRequest(org.eclipse.debug.examples.core.pda.model.PDADebugTarget)
 	 */
 	protected void clearRequest(PDADebugTarget target) throws CoreException {
-		 target.sendRequest("watch " + getFunctionName() + "::" + getVariableName() + " " + 0);
+	    target.sendCommand(new PDAWatchCommand(getFunctionName(), getVariableName(), 0));
 	}
     
 	/* (non-Javadoc)
 	 * @see org.eclipse.debug.examples.core.pda.model.IPDAEventListener#handleEvent(java.lang.String)
 	 */
-	public void handleEvent(String event) {
-		if (event.startsWith("suspended watch")) {
-			handleHit(event);
-		}
+	public void handleEvent(PDAEvent event) {
+        if (event instanceof PDASuspendedEvent || event instanceof PDAVMSuspendedEvent) {
+            PDARunControlEvent rcEvent = (PDARunControlEvent)event;
+            if (rcEvent.fReason.equals("watch")) {
+                handleHit(rcEvent);
+            }
+        }
 	}
     
 	/**
@@ -201,8 +210,8 @@ public class PDAWatchpoint extends PDALineBreakpoint implements IWatchpoint {
      * 
      * @param event breakpoint event
      */
-    private void handleHit(String event) {
-        String[] strings = event.split(" ");
+    private void handleHit(PDARunControlEvent event) {
+        String[] strings = event.fMessage.split(" ");
         if (strings.length == 4) {
             String fv = strings[3];
             int j = fv.indexOf("::");
@@ -212,7 +221,7 @@ public class PDAWatchpoint extends PDALineBreakpoint implements IWatchpoint {
 				try {
 					if (getVariableName().equals(var) && getFunctionName().equals(fcn)) {
 						setSuspendType(strings[2]);
-					    notifyThread();
+					    notifyThread(event.fThreadId);
 					}
 				} catch (CoreException e) {
 				}
diff --git a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/pda/launcher/PDALaunchDelegate.java b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/pda/launcher/PDALaunchDelegate.java
index b5fd026dd..be7db91dd 100644
--- a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/pda/launcher/PDALaunchDelegate.java
+++ b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/pda/launcher/PDALaunchDelegate.java
@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2005, 2008 IBM Corporation and others.
+ * Copyright (c) 2005, 2009 IBM Corporation and others.
  * All rights reserved. This program and the accompanying materials
  * are made available under the terms of the Eclipse Public License v1.0
  * which accompanies this distribution, and is available at
@@ -8,6 +8,7 @@
  * Contributors:
  *     IBM Corporation - initial API and implementation
  *     Bjorn Freeman-Benson - initial API and implementation
+ *     Pawel Piech (Wind River) - ported PDA Virtual Machine to Java (Bug 261400)
  *******************************************************************************/
 package org.eclipse.debug.examples.core.pda.launcher;
 
@@ -55,28 +56,23 @@ public class PDALaunchDelegate extends LaunchConfigurationDelegate {
 		
 		List commandList = new ArrayList();
 		
-		// Perl executable
-		IValueVariable perl = VariablesPlugin.getDefault().getStringVariableManager().getValueVariable(DebugCorePlugin.VARIALBE_PERL_EXECUTABLE);
-		if (perl == null) {
-			abort("Perl executable location undefined. Check value of ${perlExecutable}.", null);
-		}
-		String path = perl.getValue();
-		if (path == null) {
-			abort("Perl executable location unspecified. Check value of ${perlExecutable}.", null);
-		}
-		File exe = new File(path);
-		if (!exe.exists()) {
-			abort(MessageFormat.format("Specified Perl executable {0} does not exist. Check value of $perlExecutable.", new String[]{path}), null);
-		}
-		commandList.add(path);
-		
-		// Add PDA VM
-		File vm = DebugCorePlugin.getFileInPlugin(new Path("pdavm/pda.pl"));
-		if (vm == null) {
-			abort("Missing PDA VM", null);
-		}
-		commandList.add(vm.getAbsolutePath());
-		
+        // Get Java VM path
+        String javaVMHome = System.getProperty("java.home");
+        String javaVMExec = javaVMHome + File.separatorChar + "bin" + File.separatorChar + "java";
+        if (File.separatorChar == '\\') {
+            javaVMExec += ".exe";
+        }   
+        File exe = new File(javaVMExec);
+        if (!exe.exists()) {
+            abort(MessageFormat.format("Specified java VM executable {0} does not exist.", new Object[]{javaVMExec}), null);
+        }
+        commandList.add(javaVMExec);
+
+        commandList.add("-cp");
+        commandList.add(File.pathSeparator + DebugCorePlugin.getFileInPlugin(new Path("bin")));
+        
+        commandList.add("org.eclipse.debug.examples.pdavm.PDAVirtualMachine");
+
 		// program name
 		String program = configuration.getAttribute(DebugCorePlugin.ATTR_PDA_PROGRAM, (String)null);
 		if (program == null) {
@@ -106,7 +102,7 @@ public class PDALaunchDelegate extends LaunchConfigurationDelegate {
 		
 		String[] commandLine = (String[]) commandList.toArray(new String[commandList.size()]);
 		Process process = DebugPlugin.exec(commandLine, null);
-		IProcess p = DebugPlugin.newProcess(launch, process, path);
+		IProcess p = DebugPlugin.newProcess(launch, process, javaVMExec);
 		// if in debug mode, create a debug target 
 		if (mode.equals(ILaunchManager.DEBUG_MODE)) {
 			IDebugTarget target = new PDADebugTarget(launch, p, requestPort, eventPort);
diff --git a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/pda/model/IPDAEventListener.java b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/pda/model/IPDAEventListener.java
index 6935ad32b..b681dc880 100644
--- a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/pda/model/IPDAEventListener.java
+++ b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/pda/model/IPDAEventListener.java
@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2005, 2007 IBM Corporation and others.
+ * Copyright (c) 2005, 2009 IBM Corporation and others.
  * All rights reserved. This program and the accompanying materials 
  * are made available under the terms of the Eclipse Public License v1.0
  * which accompanies this distribution, and is available at
@@ -8,46 +8,28 @@
  * Contributors:
  *     IBM Corporation - initial API and implementation
  *     Bjorn Freeman-Benson - initial API and implementation
+ *     Pawel Piech (Wind River) - ported PDA Virtual Machine to Java (Bug 261400)
  *******************************************************************************/
 package org.eclipse.debug.examples.core.pda.model;
 
+import org.eclipse.debug.examples.core.protocol.PDAEvent;
+
 /**
  * Listeners are notified of events occurring in a PDA program
  * being interpreted.
- * <p>
- * The events generated by the interpreter are:
- * <ul>
- * <li><code>started</code> - the interpreter has started (guaranteed to be the
- * 		first event sent)</li>
- * <li><code>terminated</code> - the interpreter has terminated (guaranteed to be
- * 		the last event sent)</li>
- * <li><code>suspended X</code> - the interpreter has suspended and entered debug mode;
- * 		<code>X</code> is the cause of the suspension:
- * 		<ul>
- * 		<li><code>breakpoint N</code> - a breakpoint at line <code>N</code> was hit</li>
- * 		<li><code>client</code> - a client request to suspend has completed</li>
- * 		<li><code>drop</code> - a client request to drop a frame has completed</li>
- * 		<li><code>event E</code> - an error was encountered, where <code>E</code> is one
- * 			of <code>unimpinstr</code> or <code>nosuchlabel</code></li>
- * 		<li><code>step</code> - a step request has completed</li>
- * 		<li><code>watch A F::V</code> - a watchpoint was hit for reason <code>A</code>
- * 			(<code>read</code> or <code>write</code>), on variable <code>V</code> in
- * 			function <code>F</code></li>
- * 		</ul>
- * 		</li>
- * <li><code>resumed X</code> - the interpreter has resumed execution in run mode;
- * 		<code>X</code> is the cause of the resume:
- * 		<ul>
- * 		<li><code>step</code> - a step request has been initiated</li>
- * 		<li><code>client</code> - a client request to resume has been initiated</li>
- * 		</ul>
- * 		</li>
- * <li><code>unimplemented instruction X</code> - an unimplemented instruction <code>X</code>
- * 		was encountered</li>
- * <li><code>no such label X</code> - a branch or call to an unknown label <code>X</code>
- * 		was encountered</li>
- * </ul>
- * </p>
+ * 
+ * @see org.eclipse.debug.examples.core.protocol.PDAVMStarted
+ * @see org.eclipse.debug.examples.core.protocol.PDAVMTerminated
+ * @see org.eclipse.debug.examples.core.protocol.PDAVMSuspneded
+ * @see org.eclipse.debug.examples.core.protocol.PDAVMResumed
+ * @see org.eclipse.debug.examples.core.protocol.PDAStarted
+ * @see org.eclipse.debug.examples.core.protocol.PDAExited
+ * @see org.eclipse.debug.examples.core.protocol.PDASuspended
+ * @see org.eclipse.debug.examples.core.protocol.PDAResumed
+ * @see org.eclipse.debug.examples.core.protocol.PDAUnimplementedInstructionEvent
+ * @see org.eclipse.debug.examples.core.protocol.PDARegisterData
+ * @see org.eclipse.debug.examples.core.protocol.PDANoSuchLabelEvent
+ * @see org.eclipse.debug.examples.core.protocol.PDAEvalResultEvent
  */
 public interface IPDAEventListener {
 	
@@ -57,6 +39,6 @@ public interface IPDAEventListener {
 	 * 
 	 * @param event the event
 	 */
-	public void handleEvent(String event);
+	public void handleEvent(PDAEvent event);
 
 }
diff --git a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/pda/model/PDAArray.java b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/pda/model/PDAArray.java
index e27e1bad1..bcc07ba35 100644
--- a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/pda/model/PDAArray.java
+++ b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/pda/model/PDAArray.java
@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2005, 2007 IBM Corporation and others.
+ * Copyright (c) 2005, 2009 IBM Corporation and others.
  * All rights reserved. This program and the accompanying materials 
  * are made available under the terms of the Eclipse Public License v1.0
  * which accompanies this distribution, and is available at
@@ -8,6 +8,7 @@
  * Contributors:
  *     IBM Corporation - initial API and implementation
  *     Bjorn Freeman-Benson - initial API and implementation
+ *     Pawel Piech (Wind River) - ported PDA Virtual Machine to Java (Bug 261400)
  *******************************************************************************/
 package org.eclipse.debug.examples.core.pda.model;
 
@@ -23,7 +24,7 @@ public class PDAArray extends PDAValue {
 	 * @throws DebugException 
 	 */
 	public PDAArray(PDAValue value) throws DebugException {
-		super(value.getPDADebugTarget(), value.getValueString());
+		super(value.getVariable(), value.getValueString());
 	}
 
 	/* (non-Javadoc)
@@ -42,7 +43,7 @@ public class PDAArray extends PDAValue {
 		IVariable[] variables = new IVariable[words.length];
 		for (int i = 0; i < words.length; i++) {
 			String word = words[i];
-			variables[i] = new PDAArrayEntry(getPDADebugTarget(), i, new PDAValue(getPDADebugTarget(), word));
+			variables[i] = new PDAArrayEntry(getPDADebugTarget(), i, new PDAValue(getVariable(), word));
 		}
 		return variables;
 	}
diff --git a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/pda/model/PDADebugElement.java b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/pda/model/PDADebugElement.java
index e64f22050..6bf39f31d 100644
--- a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/pda/model/PDADebugElement.java
+++ b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/pda/model/PDADebugElement.java
@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2005, 2007 IBM Corporation and others.
+ * Copyright (c) 2005, 2009 IBM Corporation and others.
  * All rights reserved. This program and the accompanying materials 
  * are made available under the terms of the Eclipse Public License v1.0
  * which accompanies this distribution, and is available at
@@ -8,6 +8,7 @@
  * Contributors:
  *     IBM Corporation - initial API and implementation
  *     Bjorn Freeman-Benson - initial API and implementation
+ *     Pawel Piech (Wind River) - ported PDA Virtual Machine to Java (Bug 261400)
  *******************************************************************************/
 package org.eclipse.debug.examples.core.pda.model;
 
@@ -17,6 +18,8 @@ import org.eclipse.debug.core.IBreakpointManager;
 import org.eclipse.debug.core.model.DebugElement;
 import org.eclipse.debug.core.model.IDebugTarget;
 import org.eclipse.debug.examples.core.pda.DebugCorePlugin;
+import org.eclipse.debug.examples.core.protocol.PDACommand;
+import org.eclipse.debug.examples.core.protocol.PDACommandResult;
 
 
 /**
@@ -41,61 +44,50 @@ public class PDADebugElement extends DebugElement {
 	}
 	
 	/**
-	 * Sends a request to the PDA interpreter, waits for and returns the reply.
-	 * <p>
-	 * Interpreter commands and replies are as follows:
-	 * <ul>
-	 * <li><code>clear N</code> - clear the breakpoint on line <code>N</code>;
-	 * 		reply is <code>ok</code></li>
-	 * <li><code>data</code> - return the contents of the data stack; reply is the data
-	 * 		from oldest to newest as a single string <code>"value|value|value|...|value|"</code></li>
-	 * <li><code>drop</code> - pops the top stack frame off the call stack setting the 
-	 * 		instruction pointer to the calling statement in the calling frame</li>
-	 * <li><code>eventstop E B</code> - optionally stop the interpreter when an error event
-	 * 		<code>E</code> is encountered; <code>B</code> specifies stop (<code>1</code>) or
-	 * 		continue (<code>0</code>). The possible events are <code>unimpinstr</code> and
-	 * 		<code>nosuchlabel</code>. Reply is <code>ok</code>. When an event is encountered,
-	 * 		the interpreter sends the error event (for example <code>unimlpemented instruction foo</code>)
-	 * 		and corresponding suspend event (for example <code>suspended event unimpinstr</code>).</li>
-	 * <li><code>exit</code> - end the interpreter; reply is <code>ok</code></li>
-	 * <li><code>popdata</code> - pop the top value off the data stack; reply is the value</li>
-	 * <li><code>pushdata V</code> - push the value <code>V</code> onto the data stack; reply is
-	 * 		<code>ok</code></li>
-	 * <li><code>resume</code> - resume execution of the program; reply is <code>ok</code></li>
-	 * <li><code>set N</code> - set a line breakpoint on line <code>N</code> (lines are indexed
-	 * 		from 0); reply is <code>ok</code></li>
-	 * <li><code>setdata N V</code> - set the contents of data stack element <code>N</code> to
-	 * 		value <code>V</code> (the data stack is indexed from 0, 0 being the oldest); reply
-	 * 		is <code>ok</code></li>
-	 * <li><code>setvar N M V</code> - set the contents of variable <code>M</code> from the control
-	 * 		stack <code>N</code> to value <code>V</code> (the control stack is indexed from 0,
-	 * 		0 being the oldest); reply is <code>ok</code></li>
-	 * <li><code>stack</code> - return the contents of the control stack (program counters, function and
-	 * 		variable names); reply is control stack from oldest to newest as a single string
-	 * 		<code>frame#frame#frame...#frame</code> where each frame is a string
-	 * 		<code>"filename|pc|function name|variable name|variable name|...|variable name"</code></li>
-	 * <li><code>step</code> - single step forward; reply is <code>ok</code></li>
-	 * <li><code>stepreturn</code> - single step forward until the next <code>return</code> op code;
-	 * 		stop before executing the <code>return</code> ; reply is <code>ok</code></li>
-	 * <li><code>suspend</code> - suspend execution of the program and listen for debug commands;
-	 * 		reply is <code>ok</code></li>
-	 * <li><code>watch F::V M</code> - set a watchpoint on variable <code>V</code> in function
-	 * 		<code>F</code> to magic value <code>M</code>; the magic value is a bit flag corresponding
-	 * 		to read access (1), write access (2), or both (3); the magic value 0 clears the watchpoint;
-	 * 		reply is <code>ok</code></li>
-	 * <li><code>var N M</code> - return the contents of variable <code>M</code> in the control
-	 * 		stack frame <code>N</code> (stack frames are indexed from 0, 0 being the oldest);
-	 * 		reply is variable value</li>
-	 * </ul>
-	 * </p>
-	 * 
-	 * @param request command
-	 * @return reply
-	 * @throws DebugException if the request fails
-	 */	
-	public String sendRequest(String request) throws DebugException {
-		return getPDADebugTarget().sendRequest(request);
-	}
+     * Sends a request to the PDA interpreter, waits for and returns the reply.
+     * 
+     * @param request command
+     * @return reply
+     * @throws DebugException if the request fails
+     * 
+     * @see org.eclipse.debug.examples.core.protocol.PDATerminateCommand
+     * @see org.eclipse.debug.examples.core.protocol.PDAVMSuspendCommand
+     * @see org.eclipse.debug.examples.core.protocol.PDAVMResumeCommand
+     * 
+     * @see org.eclipse.debug.examples.core.protocol.PDASuspendCommand
+     * @see org.eclipse.debug.examples.core.protocol.PDAResumeCommand
+     * @see org.eclipse.debug.examples.core.protocol.PDAStepCommand
+     * @see org.eclipse.debug.examples.core.protocol.PDADropFrameCommand
+     * 
+     * @see org.eclipse.debug.examples.core.protocol.PDASetBreakpointCommand
+     * @see org.eclipse.debug.examples.core.protocol.PDAClearBreakpointCommand
+     * @see org.eclipse.debug.examples.core.protocol.PDAWatchCommand
+     * 
+     * @see org.eclipse.debug.examples.core.protocol.PDADataCommand
+     * @see org.eclipse.debug.examples.core.protocol.PDASetDataCommand
+     * @see org.eclipse.debug.examples.core.protocol.PDAPopDataCommand
+     * @see org.eclipse.debug.examples.core.protocol.PDAPushDataCommand
+     * 
+     * @see org.eclipse.debug.examples.core.protocol.PDAEvalCommand
+     * 
+     * @see org.eclipse.debug.examples.core.protocol.PDAEventStopCommand
+     * 
+     * @see org.eclipse.debug.examples.core.protocol.PDAStackCommand
+     * @see org.eclipse.debug.examples.core.protocol.PDAStackDepthCommand
+     * @see org.eclipse.debug.examples.core.protocol.PDAFrameCommand
+     * 
+     * @see org.eclipse.debug.examples.core.protocol.PDASetVarCommand
+     * @see org.eclipse.debug.examples.core.protocol.PDAVarCommand
+     * @see org.eclipse.debug.examples.core.protocol.PDAChildrenCommand
+     * 
+     * @see org.eclipse.debug.examples.core.protocol.PDAGroupsCommand
+     * @see org.eclipse.debug.examples.core.protocol.PDARegistersCommand
+     * 
+     * @since 3.5
+     */ 
+	public PDACommandResult sendCommand(PDACommand command) throws DebugException {
+        return getPDADebugTarget().sendCommand(command);
+    }
 	
 	/**
 	 * Returns the debug target as a PDA target.
diff --git a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/pda/model/PDADebugTarget.java b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/pda/model/PDADebugTarget.java
index 6df9fad76..44437af5d 100644
--- a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/pda/model/PDADebugTarget.java
+++ b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/pda/model/PDADebugTarget.java
@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2005, 2007 IBM Corporation and others.
+ * Copyright (c) 2005, 2009 IBM Corporation and others.
  * All rights reserved. This program and the accompanying materials 
  * are made available under the terms of the Eclipse Public License v1.0
  * which accompanies this distribution, and is available at
@@ -8,6 +8,7 @@
  * Contributors:
  *     IBM Corporation - initial API and implementation
  *     Bjorn Freeman-Benson - initial API and implementation
+ *     Pawel Piech (Wind River) - ported PDA Virtual Machine to Java (Bug 261400)
  *******************************************************************************/
 package org.eclipse.debug.examples.core.pda.model;
 
@@ -17,7 +18,11 @@ import java.io.InputStreamReader;
 import java.io.PrintWriter;
 import java.net.Socket;
 import java.net.UnknownHostException;
-import java.util.Vector;
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.LinkedHashMap;
+import java.util.List;
+import java.util.Map;
 
 import org.eclipse.core.resources.IMarker;
 import org.eclipse.core.resources.IMarkerDelta;
@@ -29,6 +34,7 @@ import org.eclipse.core.runtime.IStatus;
 import org.eclipse.core.runtime.Path;
 import org.eclipse.core.runtime.Status;
 import org.eclipse.core.runtime.jobs.Job;
+import org.eclipse.debug.core.DebugEvent;
 import org.eclipse.debug.core.DebugException;
 import org.eclipse.debug.core.IBreakpointManager;
 import org.eclipse.debug.core.IBreakpointManagerListener;
@@ -38,10 +44,22 @@ import org.eclipse.debug.core.model.IDebugTarget;
 import org.eclipse.debug.core.model.IMemoryBlock;
 import org.eclipse.debug.core.model.IProcess;
 import org.eclipse.debug.core.model.IThread;
-import org.eclipse.debug.core.model.IValue;
 import org.eclipse.debug.examples.core.pda.DebugCorePlugin;
 import org.eclipse.debug.examples.core.pda.breakpoints.PDALineBreakpoint;
 import org.eclipse.debug.examples.core.pda.breakpoints.PDARunToLineBreakpoint;
+import org.eclipse.debug.examples.core.protocol.PDACommand;
+import org.eclipse.debug.examples.core.protocol.PDACommandResult;
+import org.eclipse.debug.examples.core.protocol.PDAEvent;
+import org.eclipse.debug.examples.core.protocol.PDAEventStopCommand;
+import org.eclipse.debug.examples.core.protocol.PDAExitedEvent;
+import org.eclipse.debug.examples.core.protocol.PDAStartedEvent;
+import org.eclipse.debug.examples.core.protocol.PDATerminateCommand;
+import org.eclipse.debug.examples.core.protocol.PDAVMResumeCommand;
+import org.eclipse.debug.examples.core.protocol.PDAVMResumedEvent;
+import org.eclipse.debug.examples.core.protocol.PDAVMStartedEvent;
+import org.eclipse.debug.examples.core.protocol.PDAVMSuspendCommand;
+import org.eclipse.debug.examples.core.protocol.PDAVMSuspendedEvent;
+import org.eclipse.debug.examples.core.protocol.PDAVMTerminatedEvent;
 
 
 /**
@@ -62,17 +80,20 @@ public class PDADebugTarget extends PDADebugElement implements IDebugTarget, IBr
 	private Socket fEventSocket;
 	private BufferedReader fEventReader;
 	
+	// suspended state
+	private boolean fVMSuspended = false;
+	
 	// terminated state
 	private boolean fTerminated = false;
 	
 	// threads
-	private IThread[] fThreads;
-	private PDAThread fThread;
+	private Map fThreads = Collections.synchronizedMap(new LinkedHashMap());
 	
 	// event dispatch job
 	private EventDispatchJob fEventDispatch;
+	
 	// event listeners
-	private Vector fEventListeners = new Vector();
+	private List fEventListeners = Collections.synchronizedList(new ArrayList());
 	
 	/**
 	 * Listens to events from the PDA VM and fires corresponding 
@@ -89,18 +110,28 @@ public class PDADebugTarget extends PDADebugElement implements IDebugTarget, IBr
 		 * @see org.eclipse.core.runtime.jobs.Job#run(org.eclipse.core.runtime.IProgressMonitor)
 		 */
 		protected IStatus run(IProgressMonitor monitor) {
-			String event = "";
-			while (!isTerminated() && event != null) {
+			String message = "";
+			while (!isTerminated() && message != null) {
 				try {
-					event = fEventReader.readLine();
-					if (event != null) {
+					message = fEventReader.readLine();
+					System.out.println(message);
+					if (message != null) {
+					    PDAEvent event = null;
+					    try {
+					        event = PDAEvent.parseEvent(message);
+					    }
+					    catch (IllegalArgumentException e) {
+					        DebugCorePlugin.getDefault().getLog().log(
+					            new Status (IStatus.ERROR, "org.eclipse.debug.examples.core", "Error parsing PDA event", e));
+					        continue;
+					    }
 						Object[] listeners = fEventListeners.toArray();
 						for (int i = 0; i < listeners.length; i++) {
 							((IPDAEventListener)listeners[i]).handleEvent(event);	
 						}
 					}
 				} catch (IOException e) {
-					terminated();
+					vmTerminated();
 				}
 			}
 			return Status.OK_STATUS;
@@ -116,9 +147,11 @@ public class PDADebugTarget extends PDADebugElement implements IDebugTarget, IBr
 	 * @param listener event listener
 	 */
 	public void addEventListener(IPDAEventListener listener) {
-		if (!fEventListeners.contains(listener)) {
-			fEventListeners.add(listener);
-		}
+	    synchronized(fEventListeners) {
+    		if (!fEventListeners.contains(listener)) {
+    			fEventListeners.add(listener);
+    		}
+	    }
 	}
 	
 	/**
@@ -167,8 +200,6 @@ public class PDADebugTarget extends PDADebugElement implements IDebugTarget, IBr
 		} catch (IOException e) {
 			requestFailed("Unable to connect to PDA VM", e);
 		}
-		fThread = new PDAThread(this);
-		fThreads = new IThread[] {fThread};
 		fEventDispatch = new EventDispatchJob();
 		fEventDispatch.schedule();
 		IBreakpointManager breakpointManager = getBreakpointManager();
@@ -176,8 +207,8 @@ public class PDADebugTarget extends PDADebugElement implements IDebugTarget, IBr
 		breakpointManager.addBreakpointManagerListener(this);
 		// initialize error hanlding to suspend on 'unimplemented instructions'
 		// and 'no such label' errors
-		sendRequest("eventstop unimpinstr 1");
-		sendRequest("eventstop nosuchlabel 1");
+		sendCommand(new PDAEventStopCommand(PDAEventStopCommand.UNIMPINSTR, true));
+        sendCommand(new PDAEventStopCommand(PDAEventStopCommand.NOSUCHLABEL, true));
 	}
 
     /* (non-Javadoc)
@@ -190,13 +221,15 @@ public class PDADebugTarget extends PDADebugElement implements IDebugTarget, IBr
 	 * @see org.eclipse.debug.core.model.IDebugTarget#getThreads()
 	 */
 	public IThread[] getThreads() throws DebugException {
-		return fThreads;
+	    synchronized (fThreads) {
+	        return (IThread[])fThreads.values().toArray(new IThread[fThreads.size()]);
+	    }
 	}
 	/* (non-Javadoc)
 	 * @see org.eclipse.debug.core.model.IDebugTarget#hasThreads()
 	 */
 	public boolean hasThreads() throws DebugException {
-		return true;
+		return fThreads.size() > 0;
 	}
 	/* (non-Javadoc)
 	 * @see org.eclipse.debug.core.model.IDebugTarget#getName()
@@ -253,14 +286,18 @@ public class PDADebugTarget extends PDADebugElement implements IDebugTarget, IBr
 	/* (non-Javadoc)
 	 * @see org.eclipse.debug.core.model.ITerminate#isTerminated()
 	 */
-	public boolean isTerminated() {
+	public synchronized boolean isTerminated() {
 		return fTerminated || getProcess().isTerminated();
 	}
 	/* (non-Javadoc)
 	 * @see org.eclipse.debug.core.model.ITerminate#terminate()
 	 */
 	public void terminate() throws DebugException {
-		getThread().terminate();
+//#ifdef ex2
+//#     // TODO: Exercise 2 - send termination request to interpreter       
+//#else
+	    sendCommand(new PDATerminateCommand());
+//#endif
 	}
 	/* (non-Javadoc)
 	 * @see org.eclipse.debug.core.model.ISuspendResume#canResume()
@@ -277,22 +314,24 @@ public class PDADebugTarget extends PDADebugElement implements IDebugTarget, IBr
 	/* (non-Javadoc)
 	 * @see org.eclipse.debug.core.model.ISuspendResume#isSuspended()
 	 */
-	public boolean isSuspended() {
-		return !isTerminated() && getThread().isSuspended();
+	public synchronized boolean isSuspended() {
+		return !isTerminated() && fVMSuspended;
 	}
+	
 	/* (non-Javadoc)
 	 * @see org.eclipse.debug.core.model.ISuspendResume#resume()
 	 */
 	public void resume() throws DebugException {
-		getThread().resume();
+	    sendCommand(new PDAVMResumeCommand());
 	}	
 	
 	/* (non-Javadoc)
 	 * @see org.eclipse.debug.core.model.ISuspendResume#suspend()
 	 */
 	public void suspend() throws DebugException {
-		getThread().suspend();
+        sendCommand(new PDAVMSuspendCommand());
 	}
+	
 	/* (non-Javadoc)
 	 * @see org.eclipse.debug.core.IBreakpointListener#breakpointAdded(org.eclipse.debug.core.model.IBreakpoint)
 	 */
@@ -368,7 +407,7 @@ public class PDADebugTarget extends PDADebugElement implements IDebugTarget, IBr
 	 * Notification we have connected to the VM and it has started.
 	 * Resume the VM.
 	 */
-	private void started() {
+	private void vmStarted(PDAVMStartedEvent event) {
 		fireCreationEvent();
 		installDeferredBreakpoints();
 		try {
@@ -391,10 +430,9 @@ public class PDADebugTarget extends PDADebugElement implements IDebugTarget, IBr
 	/**
 	 * Called when this debug target terminates.
 	 */
-	private synchronized void terminated() {
-		fTerminated = true;
-		fThread = null;
-		fThreads = new IThread[0];
+	private void vmTerminated() {
+		setTerminated(true);
+		fThreads.clear();
 		IBreakpointManager breakpointManager = getBreakpointManager();
         breakpointManager.removeBreakpointListener(this);
 		breakpointManager.removeBreakpointManagerListener(this);
@@ -402,29 +440,58 @@ public class PDADebugTarget extends PDADebugElement implements IDebugTarget, IBr
 		removeEventListener(this);
 	}
 	
-	/**
-	 * Returns the values on the data stack (top down)
-	 * 
-	 * @return the values on the data stack (top down)
-	 */
-	public IValue[] getDataStack() throws DebugException {
-		String dataStack = sendRequest("data");
-		if (dataStack != null && dataStack.length() > 0) {
-			String[] values = dataStack.split("\\|");
-			IValue[] theValues = new IValue[values.length];
-			for (int i = 0; i < values.length; i++) {
-				String value = values[values.length - i - 1];
-				theValues[i] = new PDAStackValue(this, value, i);
-			}
-			return theValues;
-		}
-		return new IValue[0];		
+	private void vmResumed(PDAVMResumedEvent event) {
+	   setVMSuspended(false);
+	   fireResumeEvent(calcDetail(event.fReason));
+	}
+	
+	private void vmSuspended(PDAVMSuspendedEvent event) {
+	    setVMSuspended(true);
+	    int detail = DebugEvent.UNSPECIFIED;
+	    fireSuspendEvent(calcDetail(event.fReason));
+	}
+	
+	private int calcDetail(String reason) {
+        if (reason.equals("breakpoint") || reason.equals("watch")) {
+            return DebugEvent.BREAKPOINT;
+        } else if (reason.equals("step")) {
+            return DebugEvent.STEP_OVER;
+        } else if (reason.equals("drop")) {
+            return DebugEvent.STEP_RETURN;
+        } else if (reason.equals("client")) {
+            return DebugEvent.CLIENT_REQUEST;
+        } else if (reason.equals("event")) {
+            return DebugEvent.BREAKPOINT;
+        } else {
+            return DebugEvent.UNSPECIFIED;
+        } 
+	}
+	
+	private void started(PDAStartedEvent event) {
+	    PDAThread newThread = new PDAThread(this, event.fThreadId);
+	    fThreads.put(new Integer(event.fThreadId), newThread);
+	    newThread.start();
+	}
+	
+	private void exited(PDAExitedEvent event) {
+        PDAThread thread = (PDAThread)fThreads.remove(new Integer(event.fThreadId));
+        if (thread != null) {
+            thread.exit();
+        }
+	}
+	
+	private synchronized void setVMSuspended(boolean suspended) {
+	    fVMSuspended = suspended;
 	}
 	
+    private synchronized void setTerminated(boolean terminated) {
+        fTerminated = terminated;
+    }
+    
 	/* (non-Javadoc)
 	 * @see org.eclipse.debug.examples.core.pda.model.PDADebugElement#sendRequest(java.lang.String)
 	 */
-	public String sendRequest(String request) throws DebugException {
+	private String sendRequest(String request) throws DebugException {
 		synchronized (fRequestSocket) {
 			fRequestWriter.println(request);
 			fRequestWriter.flush();
@@ -438,6 +505,11 @@ public class PDADebugTarget extends PDADebugElement implements IDebugTarget, IBr
 		return null;
 	}  
 	
+	public PDACommandResult sendCommand(PDACommand command) throws DebugException {
+	    String response = sendRequest(command.getRequest());
+	    return command.createResult(response);
+	}
+
 	/**
 	 * When the breakpoint manager disables, remove all registered breakpoints
 	 * requests from the VM. When it enables, reinstall them.
@@ -452,74 +524,45 @@ public class PDADebugTarget extends PDADebugElement implements IDebugTarget, IBr
 			}
         }
 	}	
-	
-	/**
-	 * Returns whether popping the data stack is currently permitted
-	 *  
-	 * @return whether popping the data stack is currently permitted
-	 */
-	public boolean canPop() {
-	    try {
-            return !isTerminated() && isSuspended() && getDataStack().length > 0;
-        } catch (DebugException e) {
-        }
-        return false;
-	}
-	
-	/**
-	 * Pops and returns the top of the data stack
-	 * 
-	 * @return the top value on the stack 
-	 * @throws DebugException if the stack is empty or the request fails
-	 */
-	public IValue pop() throws DebugException {
-	    IValue[] dataStack = getDataStack();
-	    if (dataStack.length > 0) {
-	        sendRequest("popdata");
-	        return dataStack[0];
-	    }
-	    requestFailed("Empty stack", null);
-	    return null;
-	}
-	
-	/**
-	 * Returns whether pushing a value is currently supported.
-	 * 
-	 * @return whether pushing a value is currently supported
-	 */
-	public boolean canPush() {
-	    return !isTerminated() && isSuspended();
-	}
-	
-	/**
-	 * Pushes a value onto the stack.
-	 * 
-	 * @param value value to push
-	 * @throws DebugException on failure
-	 */
-	public void push(String value) throws DebugException {
-	    sendRequest("pushdata " + value);
-	}
 
 	/* (non-Javadoc)
 	 * @see org.eclipse.debug.examples.core.pda.model.IPDAEventListener#handleEvent(java.lang.String)
 	 */
-	public void handleEvent(String event) {
-		if (event.equals("started")) {
-			started();
-		} else if (event.equals("terminated")) {
-			terminated();
-		}
+	public void handleEvent(PDAEvent event) {
+		if (event instanceof PDAStartedEvent) {
+			started((PDAStartedEvent)event);
+		} else if (event instanceof PDAExitedEvent) {
+			exited((PDAExitedEvent)event);
+        } else if (event instanceof PDAVMStartedEvent) {
+            vmStarted((PDAVMStartedEvent)event);
+		} else if (event instanceof PDAVMTerminatedEvent) {
+            vmTerminated();
+        } else if (event instanceof PDAVMSuspendedEvent) {
+            vmSuspended((PDAVMSuspendedEvent)event);
+        } else if (event instanceof PDAVMResumedEvent) {
+            vmResumed((PDAVMResumedEvent)event);
+        } 
 	}
 	
 	/**
 	 * Returns this debug target's single thread, or <code>null</code>
 	 * if terminated.
 	 * 
+	 * @param threadId ID of the thread to return, or <code>0</code>
+	 * to return the first available thread
 	 * @return this debug target's single thread, or <code>null</code>
 	 * if terminated
 	 */
-	public synchronized PDAThread getThread() {
-		return fThread;
+	public PDAThread getThread(int threadId) {
+	    if (threadId > 0) {
+	        return (PDAThread)fThreads.get(new Integer(threadId));
+	    } else {
+    	    synchronized(fThreads) {
+    	        if (fThreads.size() > 0) {
+    	            return (PDAThread)fThreads.values().iterator().next();
+    	        }
+    	    }
+	    }
+		return null;
 	}
 }
diff --git a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/pda/model/PDAStackFrame.java b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/pda/model/PDAStackFrame.java
index a3cbe43c8..fbd1c7bb8 100644
--- a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/pda/model/PDAStackFrame.java
+++ b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/pda/model/PDAStackFrame.java
@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2005, 2007 IBM Corporation and others.
+ * Copyright (c) 2005, 2009 IBM Corporation and others.
  * All rights reserved. This program and the accompanying materials 
  * are made available under the terms of the Eclipse Public License v1.0
  * which accompanies this distribution, and is available at
@@ -8,6 +8,7 @@
  * Contributors:
  *     IBM Corporation - initial API and implementation
  *     Bjorn Freeman-Benson - initial API and implementation
+ *     Pawel Piech (Wind River) - ported PDA Virtual Machine to Java (Bug 261400)
  *******************************************************************************/
 package org.eclipse.debug.examples.core.pda.model;
 
@@ -17,6 +18,7 @@ import org.eclipse.debug.core.model.IRegisterGroup;
 import org.eclipse.debug.core.model.IStackFrame;
 import org.eclipse.debug.core.model.IThread;
 import org.eclipse.debug.core.model.IVariable;
+import org.eclipse.debug.examples.core.protocol.PDAFrameData;
 
 /**
  * PDA stack frame.
@@ -37,7 +39,7 @@ public class PDAStackFrame extends PDADebugElement implements IStackFrame {
 	 * @param data frame data
 	 * @param id stack frame id (0 is the bottom of the stack)
 	 */
-	public PDAStackFrame(PDAThread thread, String data, int id) {
+	public PDAStackFrame(PDAThread thread, PDAFrameData data, int id) {
 		super(thread.getPDADebugTarget());
 		fId = id;
 		fThread = thread;
@@ -49,17 +51,13 @@ public class PDAStackFrame extends PDADebugElement implements IStackFrame {
 	 * 
 	 * @param data
 	 */
-	private void init(String data) {
-		String[] strings = data.split("\\|");
-		String fileName = strings[0];
-		fFileName = (new Path(fileName)).lastSegment();
-		String pc = strings[1];
-		fPC = Integer.parseInt(pc) + 1;
-		fName = strings[2];
-		int numVars = strings.length - 3;
-		IVariable[] vars = new IVariable[numVars];
-		for (int i = 0; i < numVars; i++) {
-			vars[i] = new PDAVariable(this, strings[i + 3]);
+	private void init(PDAFrameData data) {
+		fFileName = data.fFilePath.lastSegment();
+		fPC = data.fPC + 1;
+		fName = data.fFunction;
+		IVariable[] vars = new IVariable[data.fVariables.length];
+		for (int i = 0; i < data.fVariables.length; i++) {
+			vars[i] = new PDAVariable(this, data.fVariables[i]);
 		}
 		fThread.setVariables(this, vars);
 	}
@@ -247,5 +245,15 @@ public class PDAStackFrame extends PDADebugElement implements IStackFrame {
 		return fId;
 	}
 	
+    /**
+     * Returns the stack frame's thread's unique identifier
+     * 
+     * @return this stack frame's thread's unique identifier
+     * 
+     * @since 3.5
+     */
+	protected int getThreadIdentifier() {
+	    return fThread.getIdentifier();
+	}
 	
 }
diff --git a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/pda/model/PDAStackValue.java b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/pda/model/PDAStackValue.java
index 2f13211f4..a7909d485 100644
--- a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/pda/model/PDAStackValue.java
+++ b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/pda/model/PDAStackValue.java
@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2005, 2007 IBM Corporation and others.
+ * Copyright (c) 2005, 2009 IBM Corporation and others.
  * All rights reserved. This program and the accompanying materials 
  * are made available under the terms of the Eclipse Public License v1.0
  * which accompanies this distribution, and is available at
@@ -8,15 +8,22 @@
  * Contributors:
  *     IBM Corporation - initial API and implementation
  *     Bjorn Freeman-Benson - initial API and implementation
+ *     Pawel Piech (Wind River) - ported PDA Virtual Machine to Java (Bug 261400)
  *******************************************************************************/
 package org.eclipse.debug.examples.core.pda.model;
 
+import org.eclipse.debug.core.DebugException;
+import org.eclipse.debug.core.model.IValue;
+import org.eclipse.debug.core.model.IVariable;
+
 /**
  * A value on the data stack
  */
-public class PDAStackValue extends PDAValue {
-    
-    private int fIndex;
+public class PDAStackValue extends PDADebugElement implements IValue {
+
+    final private PDAThread fThread;
+    final private String fValue;
+    final private int fIndex;
     
     /**
      * Constructs a value that appears on the data stack
@@ -25,17 +32,55 @@ public class PDAStackValue extends PDAValue {
      * @param value value on the stack
      * @param index index on the stack
      */
-	public PDAStackValue(PDADebugTarget target, String value, int index) {
-		super(target, value);
+	public PDAStackValue(PDAThread thread, String value, int index) {
+		super(thread.getDebugTarget());
+		fThread = thread;
+		fValue = value;
 		fIndex = index;
 	}
 	
+	public PDAThread getThread() {
+	    return fThread;
+	}
+	
+    /* (non-Javadoc)
+     * @see org.eclipse.debug.core.model.IValue#getValueString()
+     */
+    public String getValueString() throws DebugException {
+        return fValue;
+    }
+    /* (non-Javadoc)
+     * @see org.eclipse.debug.core.model.IValue#isAllocated()
+     */
+    public boolean isAllocated() throws DebugException {
+        return true;
+    }
+    /* (non-Javadoc)
+     * @see org.eclipse.debug.core.model.IValue#getVariables()
+     */
+    public IVariable[] getVariables() throws DebugException {
+        return new IVariable[0];
+    }
+    /* (non-Javadoc)
+     * @see org.eclipse.debug.core.model.IValue#hasVariables()
+     */
+    public boolean hasVariables() throws DebugException {
+        return false;
+    }
+    /* (non-Javadoc)
+     * @see org.eclipse.debug.core.model.IValue#getReferenceTypeName()
+     */
+    public String getReferenceTypeName() throws DebugException {
+        return null;
+    }
 	/*
 	 *  (non-Javadoc)
 	 * @see java.lang.Object#equals(java.lang.Object)
 	 */
     public boolean equals(Object obj) {
-        return super.equals(obj) && ((PDAStackValue)obj).fIndex == fIndex;
+        return obj instanceof PDAStackValue && 
+            ((PDAStackValue)obj).fValue.equals(fValue) && 
+            ((PDAStackValue)obj).fIndex == fIndex;
     }
     /*
      *  (non-Javadoc)
diff --git a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/pda/model/PDAThread.java b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/pda/model/PDAThread.java
index 6a4102ac3..e9dfd9bea 100644
--- a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/pda/model/PDAThread.java
+++ b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/pda/model/PDAThread.java
@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2005, 2007 IBM Corporation and others.
+ * Copyright (c) 2005, 2009 IBM Corporation and others.
  * All rights reserved. This program and the accompanying materials 
  * are made available under the terms of the Eclipse Public License v1.0
  * which accompanies this distribution, and is available at
@@ -8,9 +8,11 @@
  * Contributors:
  *     IBM Corporation - initial API and implementation
  *     Bjorn Freeman-Benson - initial API and implementation
+ *     Pawel Piech (Wind River) - ported PDA Virtual Machine to Java (Bug 261400)
  *******************************************************************************/
 package org.eclipse.debug.examples.core.pda.model;
 
+import java.util.Collections;
 import java.util.HashMap;
 import java.util.Map;
 
@@ -19,13 +21,37 @@ import org.eclipse.debug.core.DebugException;
 import org.eclipse.debug.core.model.IBreakpoint;
 import org.eclipse.debug.core.model.IStackFrame;
 import org.eclipse.debug.core.model.IThread;
+import org.eclipse.debug.core.model.IValue;
 import org.eclipse.debug.core.model.IVariable;
+import org.eclipse.debug.examples.core.protocol.PDADataCommand;
+import org.eclipse.debug.examples.core.protocol.PDADropFrameCommand;
+import org.eclipse.debug.examples.core.protocol.PDAEvent;
+import org.eclipse.debug.examples.core.protocol.PDAListResult;
+import org.eclipse.debug.examples.core.protocol.PDANoSuchLabelEvent;
+import org.eclipse.debug.examples.core.protocol.PDAPopDataCommand;
+import org.eclipse.debug.examples.core.protocol.PDAPushDataCommand;
+import org.eclipse.debug.examples.core.protocol.PDAResumeCommand;
+import org.eclipse.debug.examples.core.protocol.PDAResumedEvent;
+import org.eclipse.debug.examples.core.protocol.PDARunControlEvent;
+import org.eclipse.debug.examples.core.protocol.PDAStackCommand;
+import org.eclipse.debug.examples.core.protocol.PDAStackCommandResult;
+import org.eclipse.debug.examples.core.protocol.PDAStepCommand;
+import org.eclipse.debug.examples.core.protocol.PDASuspendCommand;
+import org.eclipse.debug.examples.core.protocol.PDASuspendedEvent;
+import org.eclipse.debug.examples.core.protocol.PDAUnimplementedInstructionEvent;
+import org.eclipse.debug.examples.core.protocol.PDAVMResumedEvent;
+import org.eclipse.debug.examples.core.protocol.PDAVMSuspendedEvent;
 
 /**
  * A PDA thread. A PDA VM is single threaded.
  */
 public class PDAThread extends PDADebugElement implements IThread, IPDAEventListener {
 	
+    /**
+     * ID of this thread as reported by PDA.
+     */
+    private final int fThreadId;
+    
 	/**
 	 * Breakpoint this thread is suspended at or <code>null</code>
 	 * if none.
@@ -38,7 +64,7 @@ public class PDAThread extends PDADebugElement implements IThread, IPDAEventList
 	private boolean fStepping = false;
 	
 	/**
-	 * Wether this thread is suspended
+	 * Whether this thread is suspended
 	 */
 	private boolean fSuspended = false;
 
@@ -50,16 +76,36 @@ public class PDAThread extends PDADebugElement implements IThread, IPDAEventList
 	/**
 	 * Table mapping stack frames to current variables
 	 */
-	private Map fVariables = new HashMap();
+	private Map fVariables = Collections.synchronizedMap(new HashMap());
 	
 	/**
 	 * Constructs a new thread for the given target
 	 * 
 	 * @param target VM
 	 */
-	public PDAThread(PDADebugTarget target) {
+	public PDAThread(PDADebugTarget target, int threadId) {
 		super(target);
-		getPDADebugTarget().addEventListener(this);
+		fThreadId = threadId;
+	}
+	
+	/**
+	 * Called by the debug target after the thread is created.
+	 * 
+	 * @since 3.5
+	 */
+	void start() {
+	    fireCreationEvent();
+        getPDADebugTarget().addEventListener(this);
+	}
+	
+    /**
+     * Called by the debug target before the thread is removed.
+     * 
+     * @since 3.5
+     */
+	void exit() {
+        getPDADebugTarget().removeEventListener(this);
+        fireTerminateEvent();
 	}
 	
 	/* (non-Javadoc)
@@ -67,16 +113,12 @@ public class PDAThread extends PDADebugElement implements IThread, IPDAEventList
 	 */
 	public IStackFrame[] getStackFrames() throws DebugException {
 		if (isSuspended()) {
-			String framesData = sendRequest("stack");
-			if (framesData != null) {
-				String[] frames = framesData.split("#");
-				IStackFrame[] theFrames = new IStackFrame[frames.length];
-				for (int i = 0; i < frames.length; i++) {
-					String data = frames[i];
-					theFrames[frames.length - i - 1] = new PDAStackFrame(this, data, i);
-				}
-				return theFrames;
+		    PDAStackCommandResult result = (PDAStackCommandResult)sendCommand(new PDAStackCommand(fThreadId));
+            IStackFrame[] frames = new IStackFrame[result.fFrames.length];
+		    for (int i = 0; i < result.fFrames.length; i++) {
+		        frames[frames.length - i - 1] = new PDAStackFrame(this, result.fFrames[i], i);
 			}
+            return frames;
 		}
 		return new IStackFrame[0];
 	}
@@ -109,10 +151,11 @@ public class PDAThread extends PDADebugElement implements IThread, IPDAEventList
 	public String getName() {
 		return "Main thread";
 	}
+	
 	/* (non-Javadoc)
 	 * @see org.eclipse.debug.core.model.IThread#getBreakpoints()
 	 */
-	public IBreakpoint[] getBreakpoints() {
+	public synchronized IBreakpoint[] getBreakpoints() {
 		if (fBreakpoint == null) {
 			return new IBreakpoint[0];
 		}
@@ -124,7 +167,7 @@ public class PDAThread extends PDADebugElement implements IThread, IPDAEventList
 	 * 
 	 * @param breakpoint breakpoint
 	 */
-	public void suspendedBy(IBreakpoint breakpoint) {
+	public synchronized void suspendedBy(IBreakpoint breakpoint) {
 		fBreakpoint = breakpoint;
 		suspended(DebugEvent.BREAKPOINT);
 	}
@@ -133,7 +176,7 @@ public class PDAThread extends PDADebugElement implements IThread, IPDAEventList
 	 * @see org.eclipse.debug.core.model.ISuspendResume#canResume()
 	 */
 	public boolean canResume() {
-		return isSuspended();
+		return isSuspended() && !getDebugTarget().isSuspended();
 	}
 	/* (non-Javadoc)
 	 * @see org.eclipse.debug.core.model.ISuspendResume#canSuspend()
@@ -145,7 +188,15 @@ public class PDAThread extends PDADebugElement implements IThread, IPDAEventList
 	 * @see org.eclipse.debug.core.model.ISuspendResume#isSuspended()
 	 */
 	public boolean isSuspended() {
-		return fSuspended && !isTerminated();
+	    if (getDebugTarget().isTerminated()) {
+	        return false;
+	    }
+	    if (getDebugTarget().isSuspended()) {
+	        return true;
+	    }
+	    synchronized (this) {
+	        return fSuspended;
+	    }
 	}
 	/* (non-Javadoc)
 	 * @see org.eclipse.debug.core.model.ISuspendResume#resume()
@@ -154,7 +205,7 @@ public class PDAThread extends PDADebugElement implements IThread, IPDAEventList
 		//#ifdef ex2
 //#		// TODO: Exercise 2 - send resume request to interpreter		
 		//#else
-		sendRequest("resume");
+		sendCommand(new PDAResumeCommand(fThreadId));
 		//#endif
 	}
 	/* (non-Javadoc)
@@ -164,7 +215,7 @@ public class PDAThread extends PDADebugElement implements IThread, IPDAEventList
 		//#ifdef ex2
 //#		// TODO: Exercise 2 - send suspend request to interpreter		
 		//#else
-	    sendRequest("suspend");
+	    sendCommand(new PDASuspendCommand(fThreadId));
 		//#endif
 	}
 	/* (non-Javadoc)
@@ -200,7 +251,7 @@ public class PDAThread extends PDADebugElement implements IThread, IPDAEventList
 	 * @see org.eclipse.debug.core.model.IStep#stepOver()
 	 */
 	public void stepOver() throws DebugException {
-		sendRequest("step");
+		sendCommand(new PDAStepCommand(fThreadId));
 	}
 	/* (non-Javadoc)
 	 * @see org.eclipse.debug.core.model.IStep#stepReturn()
@@ -223,11 +274,7 @@ public class PDAThread extends PDADebugElement implements IThread, IPDAEventList
 	 * @see org.eclipse.debug.core.model.ITerminate#terminate()
 	 */
 	public void terminate() throws DebugException {
-		//#ifdef ex2
-//#		// TODO: Exercise 2 - send termination request to interpreter		
-		//#else
-		sendRequest("exit");
-		//#endif
+	    getDebugTarget().terminate();
 	}
 	
 	/**
@@ -235,7 +282,7 @@ public class PDAThread extends PDADebugElement implements IThread, IPDAEventList
 	 * 
 	 * @param stepping whether stepping
 	 */
-	private void setStepping(boolean stepping) {
+	private synchronized void setStepping(boolean stepping) {
 		fStepping = stepping;
 	}
 	
@@ -244,7 +291,7 @@ public class PDAThread extends PDADebugElement implements IThread, IPDAEventList
 	 * 
 	 * @param suspended whether suspended
 	 */
-	private void setSuspended(boolean suspended) {
+	private synchronized  void setSuspended(boolean suspended) {
 		fSuspended = suspended;
 	}
 
@@ -254,15 +301,15 @@ public class PDAThread extends PDADebugElement implements IThread, IPDAEventList
 	 * 
 	 * @param event one of 'unimpinstr' or 'nosuchlabel' or <code>null</code>
 	 */
-	private void setError(String event) {
+	private synchronized void setError(String event) {
 		fErrorEvent = event;
 	}
 
 	/**
-	 * Returns the most revent error event encountered since the last
+	 * Returns the most recent error event encountered since the last
 	 * suspend, or <code>null</code> if none.
 	 * 
-	 * @return the most revent error event encountered since the last
+	 * @return the most recent error event encountered since the last
 	 * suspend, or <code>null</code> if none
 	 */
 	public Object getError() {
@@ -272,63 +319,65 @@ public class PDAThread extends PDADebugElement implements IThread, IPDAEventList
 	/* (non-Javadoc)
 	 * @see org.eclipse.debug.examples.core.pda.model.IPDAEventListener#handleEvent(java.lang.String)
 	 */
-	public void handleEvent(String event) {
-		// clear previous state
-		fBreakpoint = null;
-		setStepping(false);
-		
-		// handle events
-		if (event.startsWith("resumed")) {
-			setSuspended(false);
-			if (event.endsWith("step")) {
-				setStepping(true);
-				resumed(DebugEvent.STEP_OVER);
-			//#ifdef ex2
-//#			}
-//#			// TODO: Exercise 2 - handle/fire "client" resume event
-			//#else	
-			} else if (event.endsWith("client")) {
-				resumed(DebugEvent.CLIENT_REQUEST);
-			}
-			//#endif
-			//#ifdef ex5
-//#			// TODO: Exercise 5 - handle start of drop event
-			//#else
-			else if (event.endsWith("drop")) {
-				resumed(DebugEvent.STEP_RETURN);
-			}
-			//#endif
-		} else if (event.startsWith("suspended")) {
-			setSuspended(true);
-			//#ifdef ex2
-//#			// TODO: Exercise 2 - handle/fire "client" suspend event
-//#			if (event.endsWith("step")) {
-//#				suspended(DebugEvent.STEP_END);
-//#			} else if (event.startsWith("suspended event") && getError() != null) {
-//#				exceptionHit();
-//#			}
-			//#else
-			if (event.endsWith("client")) {
-				suspended(DebugEvent.CLIENT_REQUEST);
-			} else if (event.endsWith("step")) {
-				suspended(DebugEvent.STEP_END);
-			} else if (event.startsWith("suspended event") && getError() != null) {
-				exceptionHit();
-			} 
-			//#endif
-			//#ifdef ex5
-//#			// TODO: Exercise 5 - handle end of drop event
-			//#else
-			else if (event.endsWith("drop")) {
-				suspended(DebugEvent.STEP_END);
-			}
-			//#endif
-		} else if (event.equals("started")) {
-			fireCreationEvent();
-		} else {
-			setError(event);
-		}
-		
+	public void handleEvent(PDAEvent _event) {
+	    if (_event instanceof PDARunControlEvent && fThreadId == ((PDARunControlEvent)_event).fThreadId) {
+	        PDARunControlEvent event = (PDARunControlEvent)_event;
+    		// clear previous state
+    		fBreakpoint = null;
+    		setStepping(false);
+    		
+    		// handle events
+    		if (event instanceof PDAResumedEvent || event instanceof PDAVMResumedEvent) {
+    			setSuspended(false);
+    			if ("step".equals(event.fReason)) {
+    				setStepping(true);
+    				resumed(DebugEvent.STEP_OVER);
+    			//#ifdef ex2
+    //#			}
+    //#			// TODO: Exercise 2 - handle/fire "client" resume event
+    			//#else	
+    			} else if ("client".equals(event.fReason)) {
+    				resumed(DebugEvent.CLIENT_REQUEST);
+    			}
+    			//#endif
+    			//#ifdef ex5
+    //#			// TODO: Exercise 5 - handle start of drop event
+    			//#else
+    			else if ("drop".equals(event.fReason)) {
+    				resumed(DebugEvent.STEP_RETURN);
+    			}
+    			//#endif
+    		} else if (event instanceof PDASuspendedEvent || event instanceof PDAVMSuspendedEvent) {
+    			setSuspended(true);
+    			//#ifdef ex2
+    //#			// TODO: Exercise 2 - handle/fire "client" suspend event
+    //#			if (event.endsWith("step")) {
+    //#				suspended(DebugEvent.STEP_END);
+    //#			} else if (event.startsWith("suspended event") && getError() != null) {
+    //#				exceptionHit();
+    //#			}
+    			//#else
+    			if ("client".equals(event.fReason)) {
+    				suspended(DebugEvent.CLIENT_REQUEST);
+    			} else if ("step".equals(event.fReason)) {
+    				suspended(DebugEvent.STEP_END);
+    			} else if ("event".equals(event.fReason) && getError() != null) {
+    				exceptionHit();
+    			} 
+    			//#endif
+    			//#ifdef ex5
+    //#			// TODO: Exercise 5 - handle end of drop event
+    			//#else
+    			else if ("drop".equals(event.fReason)) {
+    				suspended(DebugEvent.STEP_END);
+    			}
+    			//#endif
+    		} else if (_event instanceof PDANoSuchLabelEvent ||
+    		           _event instanceof PDAUnimplementedInstructionEvent) 
+    		{
+    			setError(event.fMessage);
+    		}
+	    }    		
 	}
 	
 	/**
@@ -341,9 +390,7 @@ public class PDAThread extends PDADebugElement implements IThread, IPDAEventList
 	 */
 	private void resumed(int detail) {
 		setError(null);
-		synchronized (fVariables) {
-			fVariables.clear();
-		}
+		fVariables.clear();
 		fireResumeEvent(detail);
 	}
 	
@@ -398,12 +445,14 @@ public class PDAThread extends PDADebugElement implements IThread, IPDAEventList
 	 * Pops the top frame off the callstack.
 	 *
 	 * @throws DebugException
+     * 
+     * @since 3.5
 	 */
-	public void pop() throws DebugException {
+	public void popFrame() throws DebugException {
 		//#ifdef ex5
 //#		// TODO: Exercise 5 - send drop request		
 		//#else
-		sendRequest("drop");
+		sendCommand(new PDADropFrameCommand(fThreadId));
 		//#endif
 	}
 	
@@ -411,8 +460,10 @@ public class PDAThread extends PDADebugElement implements IThread, IPDAEventList
 	 * Returns whether this thread can pop the top stack frame.
 	 *
 	 * @return whether this thread can pop the top stack frame
+	 * 
+	 * @since 3.5
 	 */
-	public boolean canPop() {
+	public boolean canPopFrame() {
 		//#ifdef ex5
 //#		// TODO: Exercise 5 - allow pop if there is more than 1 frame on the stack		
 		//#else
@@ -423,4 +474,90 @@ public class PDAThread extends PDADebugElement implements IThread, IPDAEventList
 		//#endif
 		return false;
 	}
+	
+    /**
+     * Returns the values on the data stack (top down)
+     * 
+     * @return the values on the data stack (top down)
+     * 
+     * @since 3.5
+     */
+    public IValue[] getDataStack() throws DebugException {
+        PDAListResult result = (PDAListResult)sendCommand(new PDADataCommand(fThreadId));
+        if (result.fValues.length > 0) {
+            IValue[] values = new IValue[result.fValues.length];
+            for (int i = 0; i < result.fValues.length; i++) {
+                values[values.length - i - 1] = new PDAStackValue(this, result.fValues[i], i);
+            }
+            return values;
+        }
+        return new IValue[0];       
+    }
+    	   
+    /**
+     * Returns whether popping the data stack is currently permitted
+     *  
+     * @return whether popping the data stack is currently permitted
+     * 
+     * @since 3.5
+     */
+    public boolean canPopData() {
+        try {
+            return !isTerminated() && isSuspended() && getDataStack().length > 0;
+        } catch (DebugException e) {
+        }
+        return false;
+    }
+    
+    /**
+     * Pops and returns the top of the data stack
+     * 
+     * @return the top value on the stack 
+     * @throws DebugException if the stack is empty or the request fails
+     * 
+     * @since 3.5
+     */
+    public IValue popData() throws DebugException {
+        IValue[] dataStack = getDataStack();
+        if (dataStack.length > 0) {
+            sendCommand(new PDAPopDataCommand(fThreadId));
+            return dataStack[0];
+        }
+        requestFailed("Empty stack", null);
+        return null;
+    }
+    
+    /**
+     * Returns whether pushing a value is currently supported.
+     * 
+     * @return whether pushing a value is currently supported
+     * 
+     * @since 3.5
+     */
+    public boolean canPushData() {
+        return !isTerminated() && isSuspended();
+    }
+    
+    /**
+     * Pushes a value onto the stack.
+     * 
+     * @param value value to push
+     * @throws DebugException on failure
+     * 
+     * @since 3.5
+     */
+    public void pushData(String value) throws DebugException {
+        sendCommand(new PDAPushDataCommand(fThreadId, value));
+    }
+
+    /**
+     * Returns this thread's unique identifier
+     * 
+     * @return this thread's unique identifier
+     * 
+     * @since 3.5
+     */
+	public int getIdentifier() {
+	    return fThreadId;
+	}
 }
diff --git a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/pda/model/PDAValue.java b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/pda/model/PDAValue.java
index e871004af..e3f371588 100644
--- a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/pda/model/PDAValue.java
+++ b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/pda/model/PDAValue.java
@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2005, 2007 IBM Corporation and others.
+ * Copyright (c) 2005, 2009 IBM Corporation and others.
  * All rights reserved. This program and the accompanying materials 
  * are made available under the terms of the Eclipse Public License v1.0
  * which accompanies this distribution, and is available at
@@ -8,22 +8,27 @@
  * Contributors:
  *     IBM Corporation - initial API and implementation
  *     Bjorn Freeman-Benson - initial API and implementation
+ *     Pawel Piech (Wind River) - ported PDA Virtual Machine to Java (Bug 261400)
  *******************************************************************************/
 package org.eclipse.debug.examples.core.pda.model;
 
 import org.eclipse.debug.core.DebugException;
 import org.eclipse.debug.core.model.IValue;
 import org.eclipse.debug.core.model.IVariable;
+import org.eclipse.debug.examples.core.protocol.PDAChildrenCommand;
+import org.eclipse.debug.examples.core.protocol.PDAListResult;
 
 /**
  * Value of a PDA variable.
  */
 public class PDAValue extends PDADebugElement implements IValue {
 	
-	private String fValue;
+    final private PDAVariable fVariable;
+	final private String fValue;
 	
-	public PDAValue(PDADebugTarget target, String value) {
-		super(target);
+	public PDAValue(PDAVariable variable, String value) {
+		super(variable.getStackFrame().getPDADebugTarget());
+		fVariable = variable;
 		fValue = value;
 	}
 	
@@ -54,12 +59,26 @@ public class PDAValue extends PDADebugElement implements IValue {
 	 * @see org.eclipse.debug.core.model.IValue#getVariables()
 	 */
 	public IVariable[] getVariables() throws DebugException {
-		return new IVariable[0];
+	    PDAStackFrame frame = fVariable.getStackFrame();
+	    PDAListResult result =  (PDAListResult) sendCommand(
+	        new PDAChildrenCommand(frame.getThreadIdentifier(), frame.getIdentifier(), fVariable.getName()) );
+	    
+	    IVariable[] children = new IVariable[result.fValues.length];
+	    for(int i = 0; i < result.fValues.length; i++) {
+	        children[i] = new PDAVariable(frame, result.fValues[i]);
+	    }
+		return children;
 	}
 	/* (non-Javadoc)
 	 * @see org.eclipse.debug.core.model.IValue#hasVariables()
 	 */
 	public boolean hasVariables() throws DebugException {
+	    if (getVariables().length != 0) {
+	        return true;
+	    }
+	    // Value with multiple words can be show as an array using logical 
+	    // structures. If the value has multiple words, it needs to indicate 
+	    // that it has children even if logical structures are not turned on.
 		return fValue.split("\\W+").length > 1;
 	}
 	/*
@@ -76,4 +95,15 @@ public class PDAValue extends PDADebugElement implements IValue {
     public int hashCode() {
         return fValue.hashCode();
     }
+    
+    /**
+     * Returns the variable that this value was created for.
+     * 
+     * @return The variable that this value was created for.
+     * 
+     * @since 3.5
+     */
+    public PDAVariable getVariable() {
+        return fVariable;
+    }
 }
diff --git a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/pda/model/PDAVariable.java b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/pda/model/PDAVariable.java
index b0ddd6433..135a173c7 100644
--- a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/pda/model/PDAVariable.java
+++ b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/pda/model/PDAVariable.java
@@ -1,5 +1,5 @@
 /*******************************************************************************
- * Copyright (c) 2005, 2008 IBM Corporation and others.
+ * Copyright (c) 2005, 2009 IBM Corporation and others.
  * All rights reserved. This program and the accompanying materials 
  * are made available under the terms of the Eclipse Public License v1.0
  * which accompanies this distribution, and is available at
@@ -9,6 +9,7 @@
  *     IBM Corporation - initial API and implementation
  *     Bjorn Freeman-Benson - initial API and implementation
  *     Wind River Systems - added support for IToggleBreakpointsTargetFactory
+ *     Pawel Piech (Wind River) - ported PDA Virtual Machine to Java (Bug 261400)
  *******************************************************************************/
 package org.eclipse.debug.examples.core.pda.model;
 
@@ -16,6 +17,9 @@ import org.eclipse.debug.core.DebugEvent;
 import org.eclipse.debug.core.DebugException;
 import org.eclipse.debug.core.model.IValue;
 import org.eclipse.debug.core.model.IVariable;
+import org.eclipse.debug.examples.core.protocol.PDACommandResult;
+import org.eclipse.debug.examples.core.protocol.PDASetVarCommand;
+import org.eclipse.debug.examples.core.protocol.PDAVarCommand;
 
 /**
  * A variable in a PDA stack frame
@@ -43,8 +47,9 @@ public class PDAVariable extends PDADebugElement implements IVariable {
 	 * @see org.eclipse.debug.core.model.IVariable#getValue()
 	 */
 	public IValue getValue() throws DebugException {
-		String value = sendRequest("var " + getStackFrame().getIdentifier() + " " + getName());
-		return new PDAValue(this.getPDADebugTarget(), value);
+		PDACommandResult result = sendCommand(new PDAVarCommand(
+		    fFrame.getThreadIdentifier(), getStackFrame().getIdentifier(), getName()));
+		return new PDAValue(this, result.fResponseText);
 	}
 	
 	/* (non-Javadoc)
@@ -69,7 +74,8 @@ public class PDAVariable extends PDADebugElement implements IVariable {
 	 * @see org.eclipse.debug.core.model.IValueModification#setValue(java.lang.String)
 	 */
 	public void setValue(String expression) throws DebugException {
-		sendRequest("setvar " + getStackFrame().getIdentifier() + " " + getName() + " " + expression);
+        sendCommand(new PDASetVarCommand(
+            fFrame.getThreadIdentifier(), getStackFrame().getIdentifier(), getName(), expression));
 		fireChangeEvent(DebugEvent.CONTENT);
 	}
 	/* (non-Javadoc)
diff --git a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDABitFieldData.java b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDABitFieldData.java
new file mode 100644
index 000000000..116b3db72
--- /dev/null
+++ b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDABitFieldData.java
@@ -0,0 +1,41 @@
+/*******************************************************************************
+ * Copyright (c) 2008, 2009 Wind River Systems and others.
+ * All rights reserved. This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v1.0
+ * which accompanies this distribution, and is available at
+ * http://www.eclipse.org/legal/epl-v10.html
+ * 
+ * Contributors:
+ *     Wind River Systems - initial API and implementation
+ *******************************************************************************/
+package org.eclipse.debug.examples.core.protocol;
+
+import java.util.LinkedHashMap;
+import java.util.Map;
+import java.util.StringTokenizer;
+
+/**
+ * Object representing a bit field in the stack command results.
+ * 
+ * @see PDARegistersCommand 
+ */
+public class PDABitFieldData {
+
+    final public String fName;
+    final public int fOffset;
+    final public int fCount;
+    final public Map fMnemonics;
+    
+    PDABitFieldData(String bitFieldString) {
+        StringTokenizer st = new StringTokenizer(bitFieldString, "   ");
+        
+        fName = st.nextToken();
+        fOffset = Integer.parseInt(st.nextToken());
+        fCount = Integer.parseInt(st.nextToken());
+        
+        fMnemonics = new LinkedHashMap(0);
+        while (st.hasMoreTokens()) {
+            fMnemonics.put(st.nextToken(), st.nextToken());
+        }
+    }
+}
\ No newline at end of file
diff --git a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAChildrenCommand.java b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAChildrenCommand.java
new file mode 100644
index 000000000..e9392fafb
--- /dev/null
+++ b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAChildrenCommand.java
@@ -0,0 +1,34 @@
+/*******************************************************************************
+ * Copyright (c) 2008, 2009 Wind River Systems and others.
+ * All rights reserved. This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v1.0
+ * which accompanies this distribution, and is available at
+ * http://www.eclipse.org/legal/epl-v10.html
+ * 
+ * Contributors:
+ *     Wind River Systems - initial API and implementation
+ *******************************************************************************/
+package org.eclipse.debug.examples.core.protocol;
+
+
+/**
+ * Retrieves data stack information 
+ * 
+ * <pre>
+ *    C: children {thread_id} {frame_id} {variable_name}
+ *    R: {child variable 1}|{child variable 2}|{child variable 3}|...|
+ *    
+ * Errors:
+ *    error: invalid thread
+ * </pre>
+ */
+public class PDAChildrenCommand extends PDACommand {
+
+    public PDAChildrenCommand(int threadId, int frameId, String name  ) {
+        super("children " + threadId + " " + frameId + " " + name);
+    }
+    
+    public PDACommandResult createResult(String resultText) {
+        return new PDAListResult(resultText);
+    }
+}
diff --git a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAClearBreakpointCommand.java b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAClearBreakpointCommand.java
new file mode 100644
index 000000000..9522b007d
--- /dev/null
+++ b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAClearBreakpointCommand.java
@@ -0,0 +1,31 @@
+/*******************************************************************************
+ * Copyright (c) 2008, 2009 Wind River Systems and others.
+ * All rights reserved. This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v1.0
+ * which accompanies this distribution, and is available at
+ * http://www.eclipse.org/legal/epl-v10.html
+ * 
+ * Contributors:
+ *     Wind River Systems - initial API and implementation
+ *******************************************************************************/
+package org.eclipse.debug.examples.core.protocol;
+
+
+/**
+ * Clears any breakpoint set on given line
+ * 
+ * <pre>
+ *    C: clear {line}
+ *    R: ok
+ * </pre>
+ */
+public class PDAClearBreakpointCommand extends PDACommand {
+
+    public PDAClearBreakpointCommand(int line) {
+        super("clear " + (line - 1));
+    }
+    
+    public PDACommandResult createResult(String resultText) {
+        return new PDACommandResult(resultText);
+    }
+}
diff --git a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDACommand.java b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDACommand.java
new file mode 100644
index 000000000..f3ab89d7a
--- /dev/null
+++ b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDACommand.java
@@ -0,0 +1,40 @@
+/*******************************************************************************
+ * Copyright (c) 2007, 2009 Wind River Systems and others.
+ * All rights reserved. This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v1.0
+ * which accompanies this distribution, and is available at
+ * http://www.eclipse.org/legal/epl-v10.html
+ * 
+ * Contributors:
+ *     Wind River Systems - initial API and implementation
+ *******************************************************************************/
+package org.eclipse.debug.examples.core.protocol;
+
+
+/**
+ * Base class for PDA commands.  Sub-classes should format the request string 
+ * and implement the method to create the proper result object.
+ */
+abstract public class PDACommand {
+
+    final private String fRequest;
+    
+    public PDACommand(String request) {
+        fRequest = request;
+    }
+    
+    /**
+     * Returns the request to be sent to PDA. 
+     */
+    public String getRequest() {
+        return fRequest;
+    }
+
+    /**
+     * Returns the command result based on the given PDA response.  This command 
+     * uses the class type parameter as the return type to allow the compiler to 
+     * enforce the correct command result.  This class must be implemented by 
+     * each command to create the concrete result type. 
+     */
+    abstract public PDACommandResult createResult(String resultText);
+}
diff --git a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDACommandResult.java b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDACommandResult.java
new file mode 100644
index 000000000..737678c44
--- /dev/null
+++ b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDACommandResult.java
@@ -0,0 +1,27 @@
+/*******************************************************************************
+ * Copyright (c) 2008, 2009 Wind River Systems and others.
+ * All rights reserved. This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v1.0
+ * which accompanies this distribution, and is available at
+ * http://www.eclipse.org/legal/epl-v10.html
+ * 
+ * Contributors:
+ *     Wind River Systems - initial API and implementation
+ *******************************************************************************/
+package org.eclipse.debug.examples.core.protocol;
+
+
+
+/**
+ * Basic command result object.  This command result simply allows access to the 
+ * PDA response.  Sub-classes may override to optionally parse the response text
+ * and return higher-level objects.
+ */
+public class PDACommandResult {
+
+    final public String fResponseText;
+    
+    public PDACommandResult(String response) {
+        fResponseText = response;
+    }
+}
diff --git a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDADataCommand.java b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDADataCommand.java
new file mode 100644
index 000000000..f3bddaad2
--- /dev/null
+++ b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDADataCommand.java
@@ -0,0 +1,35 @@
+/*******************************************************************************
+ * Copyright (c) 2008, 2009 Wind River Systems and others.
+ * All rights reserved. This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v1.0
+ * which accompanies this distribution, and is available at
+ * http://www.eclipse.org/legal/epl-v10.html
+ * 
+ * Contributors:
+ *     Wind River Systems - initial API and implementation
+ *******************************************************************************/
+package org.eclipse.debug.examples.core.protocol;
+
+
+/**
+ * Return the contents of the data stack; reply is the data from oldest to newest 
+ * as a single string 
+ * 
+ * <pre>
+ *    C: data {thread_id}
+ *    R: {value 1}|{value 2}|{value 3}|...|
+ *    
+ * Errors:
+ *    error: invalid thread
+ * </pre>
+ */
+public class PDADataCommand extends PDACommand {
+
+    public PDADataCommand(int threadId) {
+        super("data " + threadId);
+    }
+    
+    public PDACommandResult createResult(String resultText) {
+        return new PDAListResult(resultText);
+    }
+}
diff --git a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDADropFrameCommand.java b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDADropFrameCommand.java
new file mode 100644
index 000000000..3955afcd0
--- /dev/null
+++ b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDADropFrameCommand.java
@@ -0,0 +1,44 @@
+/*******************************************************************************
+ * Copyright (c) 2008, 2009 Wind River Systems and others.
+ * All rights reserved. This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v1.0
+ * which accompanies this distribution, and is available at
+ * http://www.eclipse.org/legal/epl-v10.html
+ * 
+ * Contributors:
+ *     Wind River Systems - initial API and implementation
+ *******************************************************************************/
+package org.eclipse.debug.examples.core.protocol;
+
+
+/**
+ * Pops the top stack frame off the call stack setting the instruction pointer to 
+ * the calling statement in the calling frame 
+ * 
+ * <pre>
+ * If VM running:
+ *    C: drop {thread_id}
+ *    R: ok
+ *    E: resumed {thread_id} drop
+ *    E: suspended {thread_id} drop
+ *    
+ * If VM suspended:
+ *    C: drop {thread_id}
+ *    R: ok
+ *    E: vmresumed drop
+ *    E: vmsuspended {thread_id} drop
+ *    
+ * Errors:
+ *    error: invalid thread
+ * </pre>
+ */
+public class PDADropFrameCommand extends PDACommand {
+
+    public PDADropFrameCommand(int threadId) {
+        super("drop " + threadId);
+    }
+    
+    public PDACommandResult createResult(String resultText) {
+        return new PDACommandResult(resultText);
+    }
+}
diff --git a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAEvalCommand.java b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAEvalCommand.java
new file mode 100644
index 000000000..3a8aa7cbf
--- /dev/null
+++ b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAEvalCommand.java
@@ -0,0 +1,43 @@
+/*******************************************************************************
+ * Copyright (c) 2008, 2009 Wind River Systems and others.
+ * All rights reserved. This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v1.0
+ * which accompanies this distribution, and is available at
+ * http://www.eclipse.org/legal/epl-v10.html
+ * 
+ * Contributors:
+ *     Wind River Systems - initial API and implementation
+ *******************************************************************************/
+package org.eclipse.debug.examples.core.protocol;
+
+
+/**
+ * Causes the interperter to execute the given set of instructions.  At the end 
+ * of the evaluation the top value is poped off the stack and returned in the
+ * evaluation result.
+ * 
+ * <pre>
+ *    C: eval {thread_id} {instruction}%20{parameter}|{instruction}%20{parameter}|...
+ *    R: ok
+ *    E: resumed {thread_id} client
+ *    E: evalresult result
+ *    E: suspended {thread_id} eval
+ *    
+ * Errors:
+ *    error: invalid thread
+ *    error: cannot evaluate while vm is suspended
+ *    error: thread running        
+ * </pre>
+ * 
+ * Where event_name could be <code>unimpinstr</code> or <code>nosuchlabel</code>.  
+ */
+public class PDAEvalCommand extends PDACommand {
+
+    public PDAEvalCommand(int threadId, String operation) {
+        super("eval " + threadId + " " + operation);
+    }
+    
+    public PDACommandResult createResult(String resultText) {
+        return new PDACommandResult(resultText);
+    }
+}
diff --git a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAEvalResultEvent.java b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAEvalResultEvent.java
new file mode 100644
index 000000000..397eeca7b
--- /dev/null
+++ b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAEvalResultEvent.java
@@ -0,0 +1,32 @@
+/*******************************************************************************
+ * Copyright (c) 2009 Wind River Systems and others.
+ * All rights reserved. This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v1.0
+ * which accompanies this distribution, and is available at
+ * http://www.eclipse.org/legal/epl-v10.html
+ * 
+ * Contributors:
+ *     Wind River Systems - initial API and implementation
+ *******************************************************************************/
+package org.eclipse.debug.examples.core.protocol;
+
+/**
+ * Eval result event generated when an evaluation has completed. 
+ * 
+ * <pre>
+ *    E: evalresult {result}
+ * </pre>
+ */
+public class PDAEvalResultEvent extends PDAEvent {
+    
+    public final String fResult;
+    
+    public PDAEvalResultEvent(String message) {
+        super(message);
+        fResult = message.substring(getName(message).length() + 1);
+    }
+    
+    public static boolean isEventMessage(String message) {
+        return message.startsWith("evalresult");
+    }
+}
diff --git a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAEvent.java b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAEvent.java
new file mode 100644
index 000000000..fdc217844
--- /dev/null
+++ b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAEvent.java
@@ -0,0 +1,75 @@
+/*******************************************************************************
+ * Copyright (c) 2009 Wind River Systems and others.
+ * All rights reserved. This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v1.0
+ * which accompanies this distribution, and is available at
+ * http://www.eclipse.org/legal/epl-v10.html
+ * 
+ * Contributors:
+ *     Wind River Systems - initial API and implementation
+ *******************************************************************************/
+package org.eclipse.debug.examples.core.protocol;
+
+/**
+ * Base class for PDA events.
+ */
+public class PDAEvent {
+    public final String fMessage;
+    public final String fName;
+    
+    public PDAEvent(String message) {
+        fMessage = message;
+        fName = getName(message);
+    }
+    
+    protected String getName(String message) {
+        int nameEnd = message.indexOf(' ');
+        nameEnd = nameEnd == -1 ? message.length() : nameEnd;
+        return message.substring(0, nameEnd);
+    }
+    
+    public static PDAEvent parseEvent(String message) {
+        if (PDAEvalResultEvent.isEventMessage(message)) {
+            return new PDAEvalResultEvent(message);
+        } 
+        else if (PDAExitedEvent.isEventMessage(message)) {
+            return new PDAExitedEvent(message);
+        } 
+        else if (PDANoSuchLabelEvent.isEventMessage(message)) {
+            return new PDANoSuchLabelEvent(message);
+        } 
+        else if (PDARegistersEvent.isEventMessage(message)) {
+            return new PDARegistersEvent(message);
+        } 
+        else if (PDAResumedEvent.isEventMessage(message)) {
+            return new PDAResumedEvent(message);
+        } 
+        else if (PDAStartedEvent.isEventMessage(message)) {
+            return new PDAStartedEvent(message);
+        } 
+        else if (PDASuspendedEvent.isEventMessage(message)) {
+            return new PDASuspendedEvent(message);
+        } 
+        else if (PDATerminatedEvent.isEventMessage(message)) {
+            return new PDATerminatedEvent(message);
+        } 
+        else if (PDAUnimplementedInstructionEvent.isEventMessage(message)) {
+            return new PDAUnimplementedInstructionEvent(message);
+        } 
+        else if (PDAVMResumedEvent.isEventMessage(message)) {
+            return new PDAVMResumedEvent(message);
+        } 
+        else if (PDAVMStartedEvent.isEventMessage(message)) {
+            return new PDAVMStartedEvent(message);
+        } 
+        else if (PDAVMSuspendedEvent.isEventMessage(message)) {
+            return new PDAVMSuspendedEvent(message);
+        } 
+        else if (PDAExitedEvent.isEventMessage(message)) {
+            return new PDAExitedEvent(message);
+        } 
+        else {
+            return new PDAEvent(message);
+        } 
+    }
+}
diff --git a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAEventStopCommand.java b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAEventStopCommand.java
new file mode 100644
index 000000000..f02519cf9
--- /dev/null
+++ b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAEventStopCommand.java
@@ -0,0 +1,48 @@
+/*******************************************************************************
+ * Copyright (c) 2008, 2009 Wind River Systems and others.
+ * All rights reserved. This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v1.0
+ * which accompanies this distribution, and is available at
+ * http://www.eclipse.org/legal/epl-v10.html
+ * 
+ * Contributors:
+ *     Wind River Systems - initial API and implementation
+ *******************************************************************************/
+package org.eclipse.debug.examples.core.protocol;
+
+
+/**
+ * Optionally stop the interpreter when an error event <code>event_name</code> 
+ * is encountered; <code>{0|1}</code> specifies stop (<code>1</code>) or
+ * continue (<code>0</code>). The possible events are <code>unimpinstr</code> and
+ * <code>nosuchlabel</code>. Reply is <code>ok</code>. When an event is encountered,
+ * the interpreter sends the error event (for example <code>unimlpemented instruction 
+ * foo</code>) and corresponding suspend event (for example <code>suspended event 
+ * unimpinstr</code>).
+ * 
+ * <pre>
+ *    C: eventstop {event_name} {0|1}
+ *    R: ok
+ *    ...
+ *    E: suspended event {event_name}
+ * </pre>
+ * 
+ * Where event_name could be <code>unimpinstr</code> or <code>nosuchlabel</code>.  
+ */
+
+public class PDAEventStopCommand extends PDACommand {
+
+    public static final int UNIMPINSTR = 0;
+    public static final int NOSUCHLABEL = 1;
+    
+    public PDAEventStopCommand(int event, boolean enable) {
+        super("eventstop " + 
+              (event == UNIMPINSTR ? "unimpinstr " : "nosuchlabel ") + 
+              (enable ? "1" : "0"));
+    }
+    
+
+    public PDACommandResult createResult(String resultText) {
+        return new PDACommandResult(resultText);
+    }
+}
diff --git a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAExitedEvent.java b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAExitedEvent.java
new file mode 100644
index 000000000..98ccaa331
--- /dev/null
+++ b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAExitedEvent.java
@@ -0,0 +1,29 @@
+/*******************************************************************************
+ * Copyright (c) 2009 Wind River Systems and others.
+ * All rights reserved. This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v1.0
+ * which accompanies this distribution, and is available at
+ * http://www.eclipse.org/legal/epl-v10.html
+ * 
+ * Contributors:
+ *     Wind River Systems - initial API and implementation
+ *******************************************************************************/
+package org.eclipse.debug.examples.core.protocol;
+
+/**
+ * Exited event generated when a thread has exited.
+ * 
+ * <pre>
+ *    E: started {thread_id}
+ * </pre>
+ */
+public class PDAExitedEvent extends PDARunControlEvent {
+    
+    public PDAExitedEvent(String message) {
+        super(message);
+    }
+    
+    public static boolean isEventMessage(String message) {
+        return message.startsWith("exited");
+    }
+}
diff --git a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAFrameCommand.java b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAFrameCommand.java
new file mode 100644
index 000000000..81b0463ee
--- /dev/null
+++ b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAFrameCommand.java
@@ -0,0 +1,36 @@
+/*******************************************************************************
+ * Copyright (c) 2008, 2009 Wind River Systems and others.
+ * All rights reserved. This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v1.0
+ * which accompanies this distribution, and is available at
+ * http://www.eclipse.org/legal/epl-v10.html
+ * 
+ * Contributors:
+ *     Wind River Systems - initial API and implementation
+ *******************************************************************************/
+package org.eclipse.debug.examples.core.protocol;
+
+
+/**
+ * Retrieves command stack frame information for frame <code>frame_number</code>
+ * (stack frames are indexed from 0, 0 being the oldest).  
+ * 
+ * <pre>
+ *    C: stack {thread_id} {frame_number}
+ *    R: {file}|{line}|{function}|{var_1}|{var_2}|...
+ *    
+ * Errors:
+ *    error: invalid thread
+ * </pre>
+ */
+public class PDAFrameCommand extends PDACommand {
+
+    public PDAFrameCommand(int threadId, int frameNum) {
+        super("frame " + threadId + " " + frameNum);
+    }
+    
+
+    public PDACommandResult createResult(String resultText) {
+        return new PDAFrameCommandResult(resultText);
+    }
+}
diff --git a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAFrameCommandResult.java b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAFrameCommandResult.java
new file mode 100644
index 000000000..953acf704
--- /dev/null
+++ b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAFrameCommandResult.java
@@ -0,0 +1,30 @@
+/*******************************************************************************
+ * Copyright (c) 2008, 2009 Wind River Systems and others.
+ * All rights reserved. This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v1.0
+ * which accompanies this distribution, and is available at
+ * http://www.eclipse.org/legal/epl-v10.html
+ * 
+ * Contributors:
+ *     Wind River Systems - initial API and implementation
+ *******************************************************************************/
+package org.eclipse.debug.examples.core.protocol;
+
+
+
+/**
+ * @see PDAFrameCommand
+ */
+
+public class PDAFrameCommandResult extends PDACommandResult {
+    
+    /**
+     * Frame data return by the frame command.
+     */
+    final public PDAFrameData fFrame;
+    
+    PDAFrameCommandResult(String response) {
+        super(response);
+        fFrame = new PDAFrameData(response);
+    }
+}
diff --git a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAFrameData.java b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAFrameData.java
new file mode 100644
index 000000000..45de9ad46
--- /dev/null
+++ b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAFrameData.java
@@ -0,0 +1,46 @@
+/*******************************************************************************
+ * Copyright (c) 2008 Wind River Systems and others.
+ * All rights reserved. This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v1.0
+ * which accompanies this distribution, and is available at
+ * http://www.eclipse.org/legal/epl-v10.html
+ * 
+ * Contributors:
+ *     Wind River Systems - initial API and implementation
+ *******************************************************************************/
+package org.eclipse.debug.examples.core.protocol;
+
+import java.util.ArrayList;
+import java.util.List;
+import java.util.StringTokenizer;
+
+import org.eclipse.core.runtime.IPath;
+import org.eclipse.core.runtime.Path;
+
+/**
+ * Object representing a frame in the stack command results.
+ * 
+ * @see PDAStackCommand 
+ */
+
+public class PDAFrameData {
+
+    final public IPath fFilePath;
+    final public int fPC;
+    final public String fFunction;
+    final public String[] fVariables;
+    
+    PDAFrameData(String frameString) {
+        StringTokenizer st = new StringTokenizer(frameString, "|");
+        
+        fFilePath = new Path(st.nextToken());
+        fPC = Integer.parseInt(st.nextToken());
+        fFunction = st.nextToken();
+        
+        List variablesList = new ArrayList();
+        while (st.hasMoreTokens()) {
+            variablesList.add(st.nextToken());
+        }
+        fVariables = (String[])variablesList.toArray(new String[variablesList.size()]);
+    }
+}
\ No newline at end of file
diff --git a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAGroupsCommand.java b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAGroupsCommand.java
new file mode 100644
index 000000000..9dcffbdc8
--- /dev/null
+++ b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAGroupsCommand.java
@@ -0,0 +1,33 @@
+/*******************************************************************************
+ * Copyright (c) 2008, 2009 Wind River Systems and others.
+ * All rights reserved. This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v1.0
+ * which accompanies this distribution, and is available at
+ * http://www.eclipse.org/legal/epl-v10.html
+ * 
+ * Contributors:
+ *     Wind River Systems - initial API and implementation
+ *******************************************************************************/
+package org.eclipse.debug.examples.core.protocol;
+
+
+/**
+ * Retrieves register groups information 
+ * 
+ * <pre>
+ *    C: groups
+ *    R: {group 1}|{group 2}|{group 3}|...|
+ * </pre>
+ */
+
+public class PDAGroupsCommand extends PDACommand {
+
+    public PDAGroupsCommand() {
+        super("groups");
+    }
+    
+
+    public PDACommandResult createResult(String resultText) {
+        return new PDAListResult(resultText);
+    }
+}
diff --git a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAListResult.java b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAListResult.java
new file mode 100644
index 000000000..3ba409dd6
--- /dev/null
+++ b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAListResult.java
@@ -0,0 +1,43 @@
+/*******************************************************************************
+ * Copyright (c) 2008 Wind River Systems and others.
+ * All rights reserved. This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v1.0
+ * which accompanies this distribution, and is available at
+ * http://www.eclipse.org/legal/epl-v10.html
+ * 
+ * Contributors:
+ *     Wind River Systems - initial API and implementation
+ *******************************************************************************/
+package org.eclipse.debug.examples.core.protocol;
+
+import java.util.ArrayList;
+import java.util.List;
+import java.util.StringTokenizer;
+
+
+/**
+ * @see PDADataCommand
+ */
+
+public class PDAListResult extends PDACommandResult {
+    
+    final public String[] fValues;
+    
+    PDAListResult(String response) {
+        super(response);
+        StringTokenizer st = new StringTokenizer(response, "|");
+        List valuesList = new ArrayList();
+        
+        while (st.hasMoreTokens()) {
+            String token = st.nextToken();
+            if (token.length() != 0) {
+                valuesList.add(token);
+            }
+        }
+        
+        fValues = new String[valuesList.size()];
+        for (int i = 0; i < valuesList.size(); i++) {
+            fValues[i] = (String)valuesList.get(i);
+        }
+    }
+}
diff --git a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDANoSuchLabelEvent.java b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDANoSuchLabelEvent.java
new file mode 100644
index 000000000..11d6a1b05
--- /dev/null
+++ b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDANoSuchLabelEvent.java
@@ -0,0 +1,40 @@
+/*******************************************************************************
+ * Copyright (c) 2009 Wind River Systems and others.
+ * All rights reserved. This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v1.0
+ * which accompanies this distribution, and is available at
+ * http://www.eclipse.org/legal/epl-v10.html
+ * 
+ * Contributors:
+ *     Wind River Systems - initial API and implementation
+ *******************************************************************************/
+package org.eclipse.debug.examples.core.protocol;
+
+/**
+ * No Such Label event generated when the PDA program encounters an call to a
+ * non-existant label in a PDA program.
+ * 
+ * <pre>
+ *    E: no such label {label}
+ * </pre>
+ */
+public class PDANoSuchLabelEvent extends PDAEvent {
+    
+    public final String fLabel;
+    
+    public PDANoSuchLabelEvent(String message) {
+        super(message);
+        fLabel = message.substring(getName(message).length() + 1);
+    }
+    
+    public static boolean isEventMessage(String message) {
+        return message.startsWith("no such label");
+    }
+    
+    protected String getName(String message) {
+        if (isEventMessage(message)) {
+            return "no such label";
+        }
+        throw new IllegalArgumentException("Invalid event: " + message);
+    }
+}
diff --git a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAPopDataCommand.java b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAPopDataCommand.java
new file mode 100644
index 000000000..bfc7cfe9e
--- /dev/null
+++ b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAPopDataCommand.java
@@ -0,0 +1,34 @@
+/*******************************************************************************
+ * Copyright (c) 2008, 2009 Wind River Systems and others.
+ * All rights reserved. This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v1.0
+ * which accompanies this distribution, and is available at
+ * http://www.eclipse.org/legal/epl-v10.html
+ * 
+ * Contributors:
+ *     Wind River Systems - initial API and implementation
+ *******************************************************************************/
+package org.eclipse.debug.examples.core.protocol;
+
+
+/**
+ * Pops the top value from the data stack  
+ * 
+ * <pre>
+ *    C: popdata {thread_id}
+ *    R: ok
+ *    
+ * Errors:
+ *    error: invalid thread
+ * </pre>
+ */
+public class PDAPopDataCommand extends PDACommand {
+
+    public PDAPopDataCommand(int threadId) {
+        super("popdata " + threadId);
+    }
+    
+    public PDACommandResult createResult(String resultText) {
+        return new PDACommandResult(resultText);
+    }
+}
diff --git a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAPushDataCommand.java b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAPushDataCommand.java
new file mode 100644
index 000000000..6969d3e02
--- /dev/null
+++ b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAPushDataCommand.java
@@ -0,0 +1,36 @@
+/*******************************************************************************
+ * Copyright (c) 2008, 2009 Wind River Systems and others.
+ * All rights reserved. This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v1.0
+ * which accompanies this distribution, and is available at
+ * http://www.eclipse.org/legal/epl-v10.html
+ * 
+ * Contributors:
+ *     Wind River Systems - initial API and implementation
+ *******************************************************************************/
+package org.eclipse.debug.examples.core.protocol;
+
+
+/**
+ * Pushes the given value on top of the data stack.
+ * 
+ * <pre>
+ *    C: pushdata {thread_id} {value}
+ *    R: ok
+ *    
+ * Errors:
+ *    error: invalid thread
+ * </pre>
+ */
+
+public class PDAPushDataCommand extends PDACommand {
+
+    public PDAPushDataCommand(int threadId, String value) {
+        super("pushdata " + threadId + " " + value);
+    }
+    
+
+    public PDACommandResult createResult(String resultText) {
+        return new PDACommandResult(resultText);
+    }
+}
diff --git a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDARegisterData.java b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDARegisterData.java
new file mode 100644
index 000000000..5adfadd3f
--- /dev/null
+++ b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDARegisterData.java
@@ -0,0 +1,43 @@
+/*******************************************************************************
+ * Copyright (c) 2008 Wind River Systems and others.
+ * All rights reserved. This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v1.0
+ * which accompanies this distribution, and is available at
+ * http://www.eclipse.org/legal/epl-v10.html
+ * 
+ * Contributors:
+ *     Wind River Systems - initial API and implementation
+ *******************************************************************************/
+package org.eclipse.debug.examples.core.protocol;
+
+import java.util.ArrayList;
+import java.util.List;
+import java.util.StringTokenizer;
+
+/**
+ * Object representing a register in the registers command results.
+ * 
+ * @see PDARCommand 
+ */
+
+public class PDARegisterData {
+
+    final public String fName;
+    final public boolean fWritable;
+    final public PDABitFieldData[] fBitFields;
+    
+    PDARegisterData(String regString) {
+        StringTokenizer st = new StringTokenizer(regString, "|");
+        
+        String regInfo = st.nextToken();
+        StringTokenizer regSt = new StringTokenizer(regInfo, " ");
+        fName = regSt.nextToken();
+        fWritable = Boolean.getBoolean(regSt.nextToken());
+        
+        List bitFieldsList = new ArrayList();
+        while (st.hasMoreTokens()) {
+            bitFieldsList.add(new PDABitFieldData(st.nextToken()));
+        }
+        fBitFields = (PDABitFieldData[])bitFieldsList.toArray(new PDABitFieldData[bitFieldsList.size()]);
+    }
+}
\ No newline at end of file
diff --git a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDARegistersCommand.java b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDARegistersCommand.java
new file mode 100644
index 000000000..4bdfcaa5f
--- /dev/null
+++ b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDARegistersCommand.java
@@ -0,0 +1,33 @@
+/*******************************************************************************
+ * Copyright (c) 2008, 2009 Wind River Systems and others.
+ * All rights reserved. This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v1.0
+ * which accompanies this distribution, and is available at
+ * http://www.eclipse.org/legal/epl-v10.html
+ * 
+ * Contributors:
+ *     Wind River Systems - initial API and implementation
+ *******************************************************************************/
+package org.eclipse.debug.examples.core.protocol;
+
+
+/**
+ * Retrieves registers definition information 
+ * 
+ * <pre>
+ *    C: registers {group name}
+ *    R: {register name} {true|false}|{bit field name} {start bit} {bit count} {mnemonic 1} {mnemonic 2} ...#{register name} ...
+ * </pre>
+ */
+
+public class PDARegistersCommand extends PDACommand {
+
+    public PDARegistersCommand(String group) {
+        super("registers " + group);
+    }
+    
+
+    public PDACommandResult createResult(String resultText) {
+        return new PDARegistersCommandResult(resultText);
+    }
+}
diff --git a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDARegistersCommandResult.java b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDARegistersCommandResult.java
new file mode 100644
index 000000000..76c935341
--- /dev/null
+++ b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDARegistersCommandResult.java
@@ -0,0 +1,39 @@
+/*******************************************************************************
+ * Copyright (c) 2008, 2009 Wind River Systems and others.
+ * All rights reserved. This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v1.0
+ * which accompanies this distribution, and is available at
+ * http://www.eclipse.org/legal/epl-v10.html
+ * 
+ * Contributors:
+ *     Wind River Systems - initial API and implementation
+ *******************************************************************************/
+package org.eclipse.debug.examples.core.protocol;
+
+import java.util.ArrayList;
+import java.util.List;
+import java.util.StringTokenizer;
+
+
+/**
+ * @see PDARegistersCommand
+ */
+
+public class PDARegistersCommandResult extends PDACommandResult {
+    
+    /**
+     * Array of registers returned by the registers commands.  
+     */
+    final public PDARegisterData[] fRegisters;
+    
+    PDARegistersCommandResult(String response) {
+        super(response);
+        StringTokenizer st = new StringTokenizer(response, "#");
+        List regList = new ArrayList();
+        
+        while (st.hasMoreTokens()) {
+            regList.add(new PDARegisterData(st.nextToken()));
+        }
+        fRegisters = (PDARegisterData[])regList.toArray(new PDARegisterData[regList.size()]);
+    }
+}
diff --git a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDARegistersEvent.java b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDARegistersEvent.java
new file mode 100644
index 000000000..8a79ade44
--- /dev/null
+++ b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDARegistersEvent.java
@@ -0,0 +1,30 @@
+/*******************************************************************************
+ * Copyright (c) 2009 Wind River Systems and others.
+ * All rights reserved. This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v1.0
+ * which accompanies this distribution, and is available at
+ * http://www.eclipse.org/legal/epl-v10.html
+ * 
+ * Contributors:
+ *     Wind River Systems - initial API and implementation
+ *******************************************************************************/
+package org.eclipse.debug.examples.core.protocol;
+
+/**
+ * Registers event generated when the registers' definitions are changed in a 
+ * program.
+ * 
+ * <pre>
+ *    E: registers
+ * </pre>
+ */
+public class PDARegistersEvent extends PDAEvent {
+    
+    public PDARegistersEvent(String message) {
+        super(message);
+    }
+    
+    public static boolean isEventMessage(String message) {
+        return message.startsWith("registers");
+    }
+}
diff --git a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAResumeCommand.java b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAResumeCommand.java
new file mode 100644
index 000000000..a7b084159
--- /dev/null
+++ b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAResumeCommand.java
@@ -0,0 +1,40 @@
+/*******************************************************************************
+ * Copyright (c) 2008, 2009 Wind River Systems and others.
+ * All rights reserved. This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v1.0
+ * which accompanies this distribution, and is available at
+ * http://www.eclipse.org/legal/epl-v10.html
+ * 
+ * Contributors:
+ *     Wind River Systems - initial API and implementation
+ *******************************************************************************/
+package org.eclipse.debug.examples.core.protocol;
+
+
+/**
+ * Resumes the execution of a single thread.  Can be issued only if the virtual 
+ * machine is running.
+ * 
+ * <pre>
+ *    C: resume {thread_id}
+ *    R: ok
+ *    E: resumed {thread_id} client
+ *    
+ * Errors:
+ *    error: invalid thread
+ *    error: cannot resume thread when vm is suspended
+ *    error: thread already running
+ * </pre>
+ */
+
+public class PDAResumeCommand extends PDACommand {
+
+    public PDAResumeCommand(int threadId) {
+        super("resume " + threadId);
+    }
+    
+
+    public PDACommandResult createResult(String resultText) {
+        return new PDACommandResult(resultText);
+    }
+}
diff --git a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAResumedEvent.java b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAResumedEvent.java
new file mode 100644
index 000000000..81bd4f9d7
--- /dev/null
+++ b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAResumedEvent.java
@@ -0,0 +1,29 @@
+/*******************************************************************************
+ * Copyright (c) 2009 Wind River Systems and others.
+ * All rights reserved. This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v1.0
+ * which accompanies this distribution, and is available at
+ * http://www.eclipse.org/legal/epl-v10.html
+ * 
+ * Contributors:
+ *     Wind River Systems - initial API and implementation
+ *******************************************************************************/
+package org.eclipse.debug.examples.core.protocol;
+
+/**
+ * Resumed event generated when a thread is resumed.
+ * 
+ * <pre>
+ *    E: resumed {thread_id} [reason]
+ * </pre>
+ */
+public class PDAResumedEvent extends PDARunControlEvent {
+    
+    public PDAResumedEvent(String message) {
+        super(message);
+    }
+    
+    public static boolean isEventMessage(String message) {
+        return message.startsWith("resumed");
+    }
+}
diff --git a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDARunControlEvent.java b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDARunControlEvent.java
new file mode 100644
index 000000000..3590f04e5
--- /dev/null
+++ b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDARunControlEvent.java
@@ -0,0 +1,69 @@
+/*******************************************************************************
+ * Copyright (c) 2009 Wind River Systems and others.
+ * All rights reserved. This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v1.0
+ * which accompanies this distribution, and is available at
+ * http://www.eclipse.org/legal/epl-v10.html
+ * 
+ * Contributors:
+ *     Wind River Systems - initial API and implementation
+ *******************************************************************************/
+package org.eclipse.debug.examples.core.protocol;
+
+
+/**
+ * Base class for run-control events.
+ */
+public class PDARunControlEvent extends PDAEvent {
+    
+    public final int fThreadId;
+    public final String fReason;
+    
+    public PDARunControlEvent(String message) {
+        super(message);
+        fThreadId = getThreadId(message);
+        fReason = getStateChangeReason(message);
+    }
+    
+    protected int getThreadId(String message) {
+        int nameEnd = getName(message).length();
+        if ( Character.isDigit(message.charAt(nameEnd + 1)) ) {
+            int threadIdEnd = message.indexOf(' ', nameEnd + 1);
+            threadIdEnd = threadIdEnd == -1 ? message.length() : threadIdEnd;
+            try {
+                return Integer.parseInt(message.substring(nameEnd + 1, threadIdEnd));
+            } catch (NumberFormatException e) {
+                throw new IllegalArgumentException("Invalid event: " + message);                
+            }
+        } else {
+            return -1;
+        }
+    }
+
+    protected String getStateChangeReason(String message) {
+        int idx = getName(message).length();
+        if ( Character.isDigit(message.charAt(idx + 1)) ) {
+            idx = message.indexOf(' ', idx + 1);
+            idx = idx == -1 ? message.length() : idx + 1;
+        } else {
+            idx++;
+        }
+        if (idx >=  message.length()) {
+            return "";
+        }
+
+        int endIdx = message.indexOf(' ', idx);
+        endIdx = endIdx == -1 ? message.length() : endIdx;
+        return message.substring(idx, endIdx);
+    }
+    
+    protected String getName(String message) {
+        int nameEnd = message.indexOf(' ');
+        nameEnd = nameEnd == -1 ? message.length() : nameEnd;
+        return message.substring(0, nameEnd);
+    }
+
+    public static boolean isEventMessage(String message) {
+        return message.startsWith("started");
+    }
+}
diff --git a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDASetBreakpointCommand.java b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDASetBreakpointCommand.java
new file mode 100644
index 000000000..098507fc0
--- /dev/null
+++ b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDASetBreakpointCommand.java
@@ -0,0 +1,46 @@
+/*******************************************************************************
+ * Copyright (c) 2008, 2009 Wind River Systems and others.
+ * All rights reserved. This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v1.0
+ * which accompanies this distribution, and is available at
+ * http://www.eclipse.org/legal/epl-v10.html
+ * 
+ * Contributors:
+ *     Wind River Systems - initial API and implementation
+ *******************************************************************************/
+package org.eclipse.debug.examples.core.protocol;
+
+
+/**
+ * Sets a breakpoint at given line
+ * 
+ * <pre>
+ * Suspend a single thread:
+ *    C: set {line_number} 0
+ *    R: ok
+ *    C: resume {thread_id}
+ *    E: resumed {thread_id} client
+ *    E: suspended {thread_id} breakpoint line_number
+ *    
+ * Suspend the VM:
+ *    C: set {line_number} 1
+ *    R: ok
+ *    C: vmresume
+ *    E: vmresumed client
+ *    E: vmsuspended {thread_id} breakpoint line_number
+ * </pre>
+ */
+
+public class PDASetBreakpointCommand extends PDACommand {
+
+    public PDASetBreakpointCommand(int line, boolean stopVM) {
+        super("set " + 
+              line + " " + 
+              (stopVM ? "1" : "0"));
+    }
+    
+
+    public PDACommandResult createResult(String resultText) {
+        return new PDACommandResult(resultText);
+    }
+}
diff --git a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDASetDataCommand.java b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDASetDataCommand.java
new file mode 100644
index 000000000..12d8d177e
--- /dev/null
+++ b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDASetDataCommand.java
@@ -0,0 +1,36 @@
+/*******************************************************************************
+ * Copyright (c) 2008, 2009 Wind River Systems and others.
+ * All rights reserved. This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v1.0
+ * which accompanies this distribution, and is available at
+ * http://www.eclipse.org/legal/epl-v10.html
+ * 
+ * Contributors:
+ *     Wind River Systems - initial API and implementation
+ *******************************************************************************/
+package org.eclipse.debug.examples.core.protocol;
+
+
+/**
+ * Sets a data value in the data stack at the given location (the data stack is 
+ * indexed from 0, 0 being the oldest).
+ * 
+ * <pre>
+ *    C: setdata {thread_id} {index} {value}
+ *    R: ok
+ *    
+ * Errors:
+ *    error: invalid thread
+ * </pre>
+ */
+public class PDASetDataCommand extends PDACommand {
+
+    public PDASetDataCommand(int threadId, int index, String value) {
+        super("setdata " + threadId + " " + index + " " + value);
+    }
+    
+
+    public PDACommandResult createResult(String resultText) {
+        return new PDACommandResult(resultText);
+    }
+}
diff --git a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDASetVarCommand.java b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDASetVarCommand.java
new file mode 100644
index 000000000..4cde68f2c
--- /dev/null
+++ b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDASetVarCommand.java
@@ -0,0 +1,38 @@
+/*******************************************************************************
+ * Copyright (c) 2008, 2009 Wind River Systems and others.
+ * All rights reserved. This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v1.0
+ * which accompanies this distribution, and is available at
+ * http://www.eclipse.org/legal/epl-v10.html
+ * 
+ * Contributors:
+ *     Wind River Systems - initial API and implementation
+ *******************************************************************************/
+package org.eclipse.debug.examples.core.protocol;
+
+
+/**
+ * Set the contents of variable <code>variable</code> from the control stack 
+ * <code>frame_number</code> to value <code>value</code> (the control stack is 
+ * indexed from 0, 0 being the oldest). 
+ * 
+ * <pre>
+ *    C: setvar {thread_id} {frame_number} {variable} {value}
+ *    R: ok
+ *    
+ * Errors:
+ *    error: invalid thread
+ * </pre>
+ */
+
+public class PDASetVarCommand extends PDACommand {
+
+    public PDASetVarCommand(int threadId, int frame, String variable, String value) {
+        super("setvar " + threadId + " " + frame + " " + variable + " " + value);
+    }
+    
+
+    public PDACommandResult createResult(String resultText) {
+        return new PDACommandResult(resultText);
+    }
+}
diff --git a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAStackCommand.java b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAStackCommand.java
new file mode 100644
index 000000000..08f6dd673
--- /dev/null
+++ b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAStackCommand.java
@@ -0,0 +1,39 @@
+/*******************************************************************************
+ * Copyright (c) 2008, 2009 Wind River Systems and others.
+ * All rights reserved. This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v1.0
+ * which accompanies this distribution, and is available at
+ * http://www.eclipse.org/legal/epl-v10.html
+ * 
+ * Contributors:
+ *     Wind River Systems - initial API and implementation
+ *******************************************************************************/
+package org.eclipse.debug.examples.core.protocol;
+
+
+/**
+ * Return the contents of the control stack (program counters, function and
+ * variable names). The reply is control stack from oldest to newest as a single string
+ * <code>frame#frame#frame...#frame</code>, where each frame is a string
+ * <code>"filename|pc|function name|variable name|variable name|...|variable name"</code></li>. 
+ * 
+ * <pre>
+ *    C: stack {thread_id}
+ *    R: {file}|{line}|{function}|{var_1}|{var_2}|...#{file}|{line}|{function}|{var_1}|{var_2}|...#...
+ *    
+ * Errors:
+ *    error: invalid thread
+ * </pre>
+ */
+
+public class PDAStackCommand extends PDACommand {
+
+    public PDAStackCommand(int threadId) {
+        super("stack " + threadId);
+    }
+    
+
+    public PDACommandResult createResult(String resultText) {
+        return new PDAStackCommandResult(resultText);
+    }
+}
diff --git a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAStackCommandResult.java b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAStackCommandResult.java
new file mode 100644
index 000000000..6562dd279
--- /dev/null
+++ b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAStackCommandResult.java
@@ -0,0 +1,40 @@
+/*******************************************************************************
+ * Copyright (c) 2008, 2009 Wind River Systems and others.
+ * All rights reserved. This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v1.0
+ * which accompanies this distribution, and is available at
+ * http://www.eclipse.org/legal/epl-v10.html
+ * 
+ * Contributors:
+ *     Wind River Systems - initial API and implementation
+ *******************************************************************************/
+package org.eclipse.debug.examples.core.protocol;
+
+import java.util.ArrayList;
+import java.util.List;
+import java.util.StringTokenizer;
+
+
+/**
+ * @see PDAStackCommand
+ */
+
+public class PDAStackCommandResult extends PDACommandResult {
+    
+    /**
+     * Array of frames return by the stack commands.  The frames are ordered 
+     * with the highest-level frame first.
+     */
+    final public PDAFrameData[] fFrames;
+    
+    PDAStackCommandResult(String response) {
+        super(response);
+        StringTokenizer st = new StringTokenizer(response, "#");
+        List framesList = new ArrayList();
+        
+        while (st.hasMoreTokens()) {
+            framesList.add(new PDAFrameData(st.nextToken()));
+        }
+        fFrames = (PDAFrameData[])framesList.toArray(new PDAFrameData[framesList.size()]);
+    }
+}
diff --git a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAStackDepthCommand.java b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAStackDepthCommand.java
new file mode 100644
index 000000000..34e40d648
--- /dev/null
+++ b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAStackDepthCommand.java
@@ -0,0 +1,36 @@
+/*******************************************************************************
+ * Copyright (c) 2008, 2009 Wind River Systems and others.
+ * All rights reserved. This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v1.0
+ * which accompanies this distribution, and is available at
+ * http://www.eclipse.org/legal/epl-v10.html
+ * 
+ * Contributors:
+ *     Wind River Systems - initial API and implementation
+ *******************************************************************************/
+package org.eclipse.debug.examples.core.protocol;
+
+
+/**
+ * Retrieves command stack depth 
+ * 
+ * <pre>
+ *    C: stackdepth {thread_id}
+ *    R: {depth}
+ *    
+ * Errors:
+ *    error: invalid thread
+ * </pre>
+ */
+
+public class PDAStackDepthCommand extends PDACommand {
+
+    public PDAStackDepthCommand(int threadId) {
+        super("stackdepth " + threadId);
+    }
+    
+
+    public PDACommandResult createResult(String resultText) {
+        return new PDAStackDepthCommandResult(resultText);
+    }
+}
diff --git a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAStackDepthCommandResult.java b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAStackDepthCommandResult.java
new file mode 100644
index 000000000..81bb90680
--- /dev/null
+++ b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAStackDepthCommandResult.java
@@ -0,0 +1,31 @@
+/*******************************************************************************
+ * Copyright (c) 2008, 2009 Wind River Systems and others.
+ * All rights reserved. This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v1.0
+ * which accompanies this distribution, and is available at
+ * http://www.eclipse.org/legal/epl-v10.html
+ * 
+ * Contributors:
+ *     Wind River Systems - initial API and implementation
+ *******************************************************************************/
+package org.eclipse.debug.examples.core.protocol;
+
+
+
+/**
+ * @see PDADataCommand
+ */
+
+public class PDAStackDepthCommandResult extends PDACommandResult {
+    
+    final public int fDepth;
+    
+    PDAStackDepthCommandResult(String response) {
+        super(response);
+        int depth = 1; // default to something that won't cause NPEs
+        try {
+            depth = Integer.parseInt(response);
+        } catch (NumberFormatException e) {}
+        fDepth = depth;
+    }
+}
diff --git a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAStartedEvent.java b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAStartedEvent.java
new file mode 100644
index 000000000..1a1b5cdec
--- /dev/null
+++ b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAStartedEvent.java
@@ -0,0 +1,30 @@
+/*******************************************************************************
+ * Copyright (c) 2009 Wind River Systems and others.
+ * All rights reserved. This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v1.0
+ * which accompanies this distribution, and is available at
+ * http://www.eclipse.org/legal/epl-v10.html
+ * 
+ * Contributors:
+ *     Wind River Systems - initial API and implementation
+ *******************************************************************************/
+package org.eclipse.debug.examples.core.protocol;
+
+/**
+ * Started event generated when a new thread is started.  A started event 
+ * is always sent for the first thread when a PDA program is started.
+ * 
+ * <pre>
+ *    E: started {thread_id}
+ * </pre>
+ */
+public class PDAStartedEvent extends PDARunControlEvent {
+    
+    public PDAStartedEvent(String message) {
+        super(message);
+    }
+    
+    public static boolean isEventMessage(String message) {
+        return message.startsWith("started");
+    }
+}
diff --git a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAStepCommand.java b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAStepCommand.java
new file mode 100644
index 000000000..e948cfb74
--- /dev/null
+++ b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAStepCommand.java
@@ -0,0 +1,45 @@
+/*******************************************************************************
+ * Copyright (c) 2008, 2009 Wind River Systems and others.
+ * All rights reserved. This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v1.0
+ * which accompanies this distribution, and is available at
+ * http://www.eclipse.org/legal/epl-v10.html
+ * 
+ * Contributors:
+ *     Wind River Systems - initial API and implementation
+ *******************************************************************************/
+package org.eclipse.debug.examples.core.protocol;
+
+
+/**
+ * Executes next instruction 
+ * 
+ * <pre>
+ * If VM running:
+ *    C: step {thread_id}
+ *    R: ok
+ *    E: resumed {thread_id} step
+ *    E: suspended {thread_id} step
+ *    
+ * If VM suspended:
+ *    C: step {thread_id}
+ *    R: ok
+ *    E: vmresumed step
+ *    E: vmsuspended {thread_id} step
+ *    
+ * Errors:
+ *    error: invalid thread
+ * </pre>
+ */
+
+public class PDAStepCommand extends PDACommand {
+
+    public PDAStepCommand(int threadId) {
+        super("step " + threadId);
+    }
+    
+
+    public PDACommandResult createResult(String resultText) {
+        return new PDACommandResult(resultText);
+    }
+}
diff --git a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAStepReturnCommand.java b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAStepReturnCommand.java
new file mode 100644
index 000000000..5211c90a9
--- /dev/null
+++ b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAStepReturnCommand.java
@@ -0,0 +1,46 @@
+/*******************************************************************************
+ * Copyright (c) 2008, 2009 Wind River Systems and others.
+ * All rights reserved. This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v1.0
+ * which accompanies this distribution, and is available at
+ * http://www.eclipse.org/legal/epl-v10.html
+ * 
+ * Contributors:
+ *     Wind River Systems - initial API and implementation
+ *******************************************************************************/
+package org.eclipse.debug.examples.core.protocol;
+
+
+/**
+ * Single step forward until the next <code>return</code> op code. Stop before 
+ * executing the <code>return</code> . 
+ * 
+ * <pre>
+ * If VM running:
+ *    C: stepreturn {thread_id}
+ *    R: ok
+ *    E: resumed {thread_id} client
+ *    E: suspended {thread_id} step
+ *    
+ * If VM suspended:
+ *    C: stepreturn {thread_id}
+ *    R: ok
+ *    E: vmresumed client
+ *    E: vmsuspended {thread_id} step
+ *    
+ * Errors:
+ *    error: invalid thread
+ * </pre>
+ */
+
+public class PDAStepReturnCommand extends PDACommand {
+
+    public PDAStepReturnCommand(int threadId) {
+        super("stepreturn " + threadId);
+    }
+    
+
+    public PDACommandResult createResult(String resultText) {
+        return new PDACommandResult(resultText);
+    }
+}
diff --git a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDASuspendCommand.java b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDASuspendCommand.java
new file mode 100644
index 000000000..3da5f2f53
--- /dev/null
+++ b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDASuspendCommand.java
@@ -0,0 +1,40 @@
+/*******************************************************************************
+ * Copyright (c) 2008, 2009 Wind River Systems and others.
+ * All rights reserved. This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v1.0
+ * which accompanies this distribution, and is available at
+ * http://www.eclipse.org/legal/epl-v10.html
+ * 
+ * Contributors:
+ *     Wind River Systems - initial API and implementation
+ *******************************************************************************/
+package org.eclipse.debug.examples.core.protocol;
+
+
+/**
+ * Suspends execution of a single thread.  Can be issued only if the virtual 
+ * machine is running.
+ * 
+ * <pre>
+ *    C: suspend {thread_id}
+ *    R: ok
+ *    E: suspended {thread_id} client
+ *    
+ * Errors:
+ *    error: invalid thread
+      error: vm already suspended
+ *    error: thread already suspended
+ * </pre>
+ */
+
+public class PDASuspendCommand extends PDACommand {
+
+    public PDASuspendCommand(int threadId) {
+        super("suspend " + threadId);
+    }
+    
+
+    public PDACommandResult createResult(String resultText) {
+        return new PDACommandResult(resultText);
+    }
+}
diff --git a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDASuspendedEvent.java b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDASuspendedEvent.java
new file mode 100644
index 000000000..7ed4eb330
--- /dev/null
+++ b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDASuspendedEvent.java
@@ -0,0 +1,43 @@
+/*******************************************************************************
+ * Copyright (c) 2009 Wind River Systems and others.
+ * All rights reserved. This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v1.0
+ * which accompanies this distribution, and is available at
+ * http://www.eclipse.org/legal/epl-v10.html
+ * 
+ * Contributors:
+ *     Wind River Systems - initial API and implementation
+ *******************************************************************************/
+package org.eclipse.debug.examples.core.protocol;
+
+/**
+ * Suspended event generated when a thread is suspended.
+ * 
+ * <pre>
+ *    E: suspended {thread_id} [reason]
+ * </pre>
+ * 
+ * <code>[reason]</code> is the cause of the suspension and it's optional:
+ * <ul>
+ *   <li><code>breakpoint N</code> - a breakpoint at line <code>N</code> was hit</li>
+ *   <li><code>client</code> - a client request to suspend has completed</li>
+ *   <li><code>drop</code> - a client request to drop a frame has completed</li>
+ *   <li><code>event E</code> - an error was encountered, where <code>E</code> is one
+ *       of <code>unimpinstr</code> or <code>nosuchlabel</code></li>
+ *   <li><code>step</code> - a step request has completed</li>
+ *   <li><code>watch A F::V</code> - a watchpoint was hit for reason <code>A</code>
+ *       (<code>read</code> or <code>write</code>), on variable <code>V</code> in
+ *       function <code>F</code></li>
+ * </ul>
+
+ */
+public class PDASuspendedEvent extends PDARunControlEvent {
+    
+    public PDASuspendedEvent(String message) {
+        super(message);
+    }
+    
+    public static boolean isEventMessage(String message) {
+        return message.startsWith("suspended");
+    }
+}
diff --git a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDATerminateCommand.java b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDATerminateCommand.java
new file mode 100644
index 000000000..1b3eabb1d
--- /dev/null
+++ b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDATerminateCommand.java
@@ -0,0 +1,34 @@
+/*******************************************************************************
+ * Copyright (c) 2008, 2009 Wind River Systems and others.
+ * All rights reserved. This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v1.0
+ * which accompanies this distribution, and is available at
+ * http://www.eclipse.org/legal/epl-v10.html
+ * 
+ * Contributors:
+ *     Wind River Systems - initial API and implementation
+ *******************************************************************************/
+package org.eclipse.debug.examples.core.protocol;
+
+
+/**
+ * Instructs the debugger to terminate.
+ * 
+ * <pre>
+ *    C: terminate
+ *    R: ok
+ *    E: vmterminated
+ * </pre>
+ */
+
+public class PDATerminateCommand extends PDACommand {
+
+    public PDATerminateCommand() {
+        super("terminate");
+    }
+    
+
+    public PDACommandResult createResult(String resultText) {
+        return new PDACommandResult(resultText);
+    }
+}
diff --git a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDATerminatedEvent.java b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDATerminatedEvent.java
new file mode 100644
index 000000000..7a3a55fdd
--- /dev/null
+++ b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDATerminatedEvent.java
@@ -0,0 +1,29 @@
+/*******************************************************************************
+ * Copyright (c) 2009 Wind River Systems and others.
+ * All rights reserved. This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v1.0
+ * which accompanies this distribution, and is available at
+ * http://www.eclipse.org/legal/epl-v10.html
+ * 
+ * Contributors:
+ *     Wind River Systems - initial API and implementation
+ *******************************************************************************/
+package org.eclipse.debug.examples.core.protocol;
+
+/**
+ * Terminated event generated when the PDA program has ended execution.
+ * 
+ * <pre>
+ *    E: termianted
+ * </pre>
+ */
+public class PDATerminatedEvent extends PDAEvent {
+    
+    public PDATerminatedEvent(String message) {
+        super(message);
+    }
+    
+    public static boolean isEventMessage(String message) {
+        return message.startsWith("terminated");
+    }
+}
diff --git a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAUnimplementedInstructionEvent.java b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAUnimplementedInstructionEvent.java
new file mode 100644
index 000000000..8c51c1ef8
--- /dev/null
+++ b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAUnimplementedInstructionEvent.java
@@ -0,0 +1,41 @@
+/*******************************************************************************
+ * Copyright (c) 2008, 2009 Wind River Systems and others.
+ * All rights reserved. This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v1.0
+ * which accompanies this distribution, and is available at
+ * http://www.eclipse.org/legal/epl-v10.html
+ * 
+ * Contributors:
+ *     Wind River Systems - initial API and implementation
+ *******************************************************************************/
+package org.eclipse.debug.examples.core.protocol;
+
+/**
+ * Unimplemented Instruction event generated when the PDA program encounters 
+ * an instruction that it does not recognize.  This event is usually followed
+ * by a VM Suspended event.
+ * 
+ * <pre>
+ *    E: unimplemented instruction {label}
+ * </pre>
+ */
+public class PDAUnimplementedInstructionEvent extends PDAEvent {
+    
+    public final String fOperation;
+    
+    public PDAUnimplementedInstructionEvent(String message) {
+        super(message);
+        fOperation = message.substring(getName(message).length() + 1);
+    }
+    
+    public static boolean isEventMessage(String message) {
+        return message.startsWith("unimplemented instruction");
+    }
+    
+    protected String getName(String message) {
+        if (isEventMessage(message)) {
+            return "unimplemented instruction";
+        }
+        throw new IllegalArgumentException("Invalid event: " + message);
+    }
+}
diff --git a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAVMResumeCommand.java b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAVMResumeCommand.java
new file mode 100644
index 000000000..2c2a03d3e
--- /dev/null
+++ b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAVMResumeCommand.java
@@ -0,0 +1,37 @@
+/*******************************************************************************
+ * Copyright (c) 2008, 2009 Wind River Systems and others.
+ * All rights reserved. This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v1.0
+ * which accompanies this distribution, and is available at
+ * http://www.eclipse.org/legal/epl-v10.html
+ * 
+ * Contributors:
+ *     Wind River Systems - initial API and implementation
+ *******************************************************************************/
+package org.eclipse.debug.examples.core.protocol;
+
+
+/**
+ * Resumes the execution of the whole virtual machine  
+ * 
+ * <pre>
+ *    C: vmresume
+ *    R: ok
+ *    E: vmresumed client
+ *    
+ * Errors:
+ *    error: vm already running
+ * </pre>
+ */
+
+public class PDAVMResumeCommand extends PDACommand {
+
+    public PDAVMResumeCommand() {
+        super("vmresume");
+    }
+    
+
+    public PDACommandResult createResult(String resultText) {
+        return new PDACommandResult(resultText);
+    }
+}
diff --git a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAVMResumedEvent.java b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAVMResumedEvent.java
new file mode 100644
index 000000000..56fbace71
--- /dev/null
+++ b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAVMResumedEvent.java
@@ -0,0 +1,36 @@
+/*******************************************************************************
+ * Copyright (c) 2009 Wind River Systems and others.
+ * All rights reserved. This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v1.0
+ * which accompanies this distribution, and is available at
+ * http://www.eclipse.org/legal/epl-v10.html
+ * 
+ * Contributors:
+ *     Wind River Systems - initial API and implementation
+ *******************************************************************************/
+package org.eclipse.debug.examples.core.protocol;
+
+/**
+ * VM Resumed event generated when the whole virtual machine is resumed.  When 
+ * the VM is resumed all previously suspended threads are resumed as well. 
+ * 
+ * <pre>
+ *    E: vmresumed [reason]
+ * </pre>
+ * 
+ * <code>[reason]</code> is the cause of the resume: and it's optional:
+ * <ul>
+ *   <li><code>step</code> - a step request has been initiated</li>
+ *   <li><code>client</code> - a client request to resume has been initiated</li>
+ * </ul>
+ */
+public class PDAVMResumedEvent extends PDARunControlEvent {
+    
+    public PDAVMResumedEvent(String message) {
+        super(message);
+    }
+    
+    public static boolean isEventMessage(String message) {
+        return message.startsWith("vmresumed");
+    }
+}
diff --git a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAVMStartedEvent.java b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAVMStartedEvent.java
new file mode 100644
index 000000000..a98a10c55
--- /dev/null
+++ b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAVMStartedEvent.java
@@ -0,0 +1,30 @@
+/*******************************************************************************
+ * Copyright (c) 2009 Wind River Systems and others.
+ * All rights reserved. This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v1.0
+ * which accompanies this distribution, and is available at
+ * http://www.eclipse.org/legal/epl-v10.html
+ * 
+ * Contributors:
+ *     Wind River Systems - initial API and implementation
+ *******************************************************************************/
+package org.eclipse.debug.examples.core.protocol;
+
+/**
+ * VM started event generated when the the interpreter has started (guaranteed 
+ * to be the first event sent)
+ * 
+ * <pre>
+ *    E: vmstarted
+ * </pre>
+ */
+public class PDAVMStartedEvent extends PDAEvent {
+    
+    public PDAVMStartedEvent(String message) {
+        super(message);
+    }
+    
+    public static boolean isEventMessage(String message) {
+        return message.startsWith("vmstarted");
+    }
+}
diff --git a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAVMSuspendCommand.java b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAVMSuspendCommand.java
new file mode 100644
index 000000000..693d59a7f
--- /dev/null
+++ b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAVMSuspendCommand.java
@@ -0,0 +1,37 @@
+/*******************************************************************************
+ * Copyright (c) 2008, 2009 Wind River Systems and others.
+ * All rights reserved. This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v1.0
+ * which accompanies this distribution, and is available at
+ * http://www.eclipse.org/legal/epl-v10.html
+ * 
+ * Contributors:
+ *     Wind River Systems - initial API and implementation
+ *******************************************************************************/
+package org.eclipse.debug.examples.core.protocol;
+
+
+/**
+ * Suspends the execution of the whole virtual machine 
+ * 
+ * <pre>
+ *    C: vmsuspend
+ *    R: ok
+ *    E: vmsuspended client
+ *    
+ * Errors:
+ *    error: thread already suspended
+ * </pre>
+ */
+
+public class PDAVMSuspendCommand extends PDACommand {
+
+    public PDAVMSuspendCommand() {
+        super("vmsuspend");
+    }
+    
+
+    public PDACommandResult createResult(String resultText) {
+        return new PDACommandResult(resultText);
+    }
+}
diff --git a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAVMSuspendedEvent.java b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAVMSuspendedEvent.java
new file mode 100644
index 000000000..9385fae59
--- /dev/null
+++ b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAVMSuspendedEvent.java
@@ -0,0 +1,44 @@
+/*******************************************************************************
+ * Copyright (c) 2009 Wind River Systems and others.
+ * All rights reserved. This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v1.0
+ * which accompanies this distribution, and is available at
+ * http://www.eclipse.org/legal/epl-v10.html
+ * 
+ * Contributors:
+ *     Wind River Systems - initial API and implementation
+ *******************************************************************************/
+package org.eclipse.debug.examples.core.protocol;
+
+/**
+ * VM Suspended event generated when the virtual machine is suspended.  If the VM
+ * is suspended as a result of a thread event (e.g. thread hitting a breakpoint), 
+ * then the thread_id is included in the event.
+ * 
+ * <pre>
+ *    E: vmsuspended [thread_id] {reason}
+ * </pre>
+ * 
+ * <code>{reason}</code> is the cause of the suspension:
+ * <ul>
+ *   <li><code>breakpoint N</code> - a breakpoint at line <code>N</code> was hit</li>
+ *   <li><code>client</code> - a client request to suspend has completed</li>
+ *   <li><code>drop</code> - a client request to drop a frame has completed</li>
+ *   <li><code>event E</code> - an error was encountered, where <code>E</code> is one
+ *       of <code>unimpinstr</code> or <code>nosuchlabel</code></li>
+ *   <li><code>step</code> - a step request has completed</li>
+ *   <li><code>watch A F::V</code> - a watchpoint was hit for reason <code>A</code>
+ *       (<code>read</code> or <code>write</code>), on variable <code>V</code> in
+ *       function <code>F</code></li>
+ * </ul>
+ */
+public class PDAVMSuspendedEvent extends PDARunControlEvent {
+    
+    public PDAVMSuspendedEvent(String message) {
+        super(message);
+    }
+    
+    public static boolean isEventMessage(String message) {
+        return message.startsWith("vmsuspended");
+    }
+}
diff --git a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAVMTerminatedEvent.java b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAVMTerminatedEvent.java
new file mode 100644
index 000000000..624afc9f5
--- /dev/null
+++ b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAVMTerminatedEvent.java
@@ -0,0 +1,29 @@
+/*******************************************************************************
+ * Copyright (c) 2009 Wind River Systems and others.
+ * All rights reserved. This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v1.0
+ * which accompanies this distribution, and is available at
+ * http://www.eclipse.org/legal/epl-v10.html
+ * 
+ * Contributors:
+ *     Wind River Systems - initial API and implementation
+ *******************************************************************************/
+package org.eclipse.debug.examples.core.protocol;
+
+/**
+ * Terminated event generated when the PDA program has ended execution.
+ * 
+ * <pre>
+ *    E: termianted
+ * </pre>
+ */
+public class PDAVMTerminatedEvent extends PDAEvent {
+    
+    public PDAVMTerminatedEvent(String message) {
+        super(message);
+    }
+    
+    public static boolean isEventMessage(String message) {
+        return message.startsWith("vmterminated");
+    }
+}
diff --git a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAVarCommand.java b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAVarCommand.java
new file mode 100644
index 000000000..c9c0497fa
--- /dev/null
+++ b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAVarCommand.java
@@ -0,0 +1,39 @@
+/*******************************************************************************
+ * Copyright (c) 2008, 2009 Wind River Systems and others.
+ * All rights reserved. This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v1.0
+ * which accompanies this distribution, and is available at
+ * http://www.eclipse.org/legal/epl-v10.html
+ * 
+ * Contributors:
+ *     Wind River Systems - initial API and implementation
+ *******************************************************************************/
+package org.eclipse.debug.examples.core.protocol;
+
+
+/**
+ * Return the contents of variable <code>variable_name</code> in the control 
+ * stack frame <code>frame_number</code> (stack frames are indexed from 0, 0 
+ * being the oldest). 
+ * 
+ * <pre>
+ *    C: var  {thread_id} {frame_number} {variable_name}
+ *    R: {variable_value}
+ *    
+ * Errors:
+ *    error: invalid thread
+ *    error: variable undefined
+ * </pre>
+ */
+
+public class PDAVarCommand extends PDACommand {
+
+    public PDAVarCommand(int threadId, int frameId, String name) {
+        super("var " + threadId + " " + frameId + " " + name);
+    }
+    
+
+    public PDACommandResult createResult(String resultText) {
+        return new PDACommandResult(resultText);
+    }
+}
diff --git a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAWatchCommand.java b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAWatchCommand.java
new file mode 100644
index 000000000..f45ad0208
--- /dev/null
+++ b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/PDAWatchCommand.java
@@ -0,0 +1,43 @@
+/*******************************************************************************
+ * Copyright (c) 2008, 2009 Wind River Systems and others.
+ * All rights reserved. This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v1.0
+ * which accompanies this distribution, and is available at
+ * http://www.eclipse.org/legal/epl-v10.html
+ * 
+ * Contributors:
+ *     Wind River Systems - initial API and implementation
+ *******************************************************************************/
+package org.eclipse.debug.examples.core.protocol;
+
+
+/**
+ * Set a watchpoint on variable <code>variable_name</code> in function 
+ * <code>function</code> to magic value <code>watch_operation</code>.  The magic 
+ * value is a bit flag corresponding to read access (1), write access (2), or 
+ * both (3); the magic value 0 clears the watchpoint.
+ * 
+ * <pre>
+ *    C: watch {function}::{variable_name} {watch_operation}
+ *    R: ok
+ *    C: vmresume
+ *    R: vmresumed client
+ *    E: vmsuspended {thread_id} watch {watch_operation} {function}::{variable_name}
+ * </pre>
+ */
+public class PDAWatchCommand extends PDACommand {
+
+    public static final int READ = 1;
+    public static final int WRITE = 2;
+    public static final int BOTH = READ | WRITE;
+    public static final int NONE = 0;
+    
+    public PDAWatchCommand(String function, String variable, int operation) {
+        super("watch " + function+ "::" + variable + " " + operation);
+    }
+    
+
+    public PDACommandResult createResult(String resultText) {
+        return new PDACommandResult(resultText);
+    }
+}
diff --git a/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/package.html b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/package.html
new file mode 100644
index 000000000..90bdaae51
--- /dev/null
+++ b/org.eclipse.debug.examples.core/src/org/eclipse/debug/examples/core/protocol/package.html
@@ -0,0 +1,99 @@
+<!doctype html public "-//w3c//dtd html 4.0 transitional//en">
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+<title>PDA Interpreter Debug Protocol</title>
+</head>
+
+<body bgcolor="#FFFFFF">
+
+<p>Provides classes representing PDA protocol commands, command results and events</p>
+
+<h2>Package Specification</h2>
+
+<h3>Virtual Machine execution control</h3>
+<h4>Commands</h4>
+<ul>
+<li>{@link PDATerminateCommand}</li>
+<li>{@link PDAVMSuspendCommand}</li>
+<li>{@link PDAVMResumeCommand}</li>
+<li>{@link PDAEventStopCommand}</li>
+</ul>
+<h4>Events</h4>
+<ul>
+<li>{@link PDAVMStarted}</li>
+<li>{@link PDAVMTerminated}</li>
+<li>{@link PDAVMSuspneded}</li>
+<li>{@link PDAVMResumed}</li>
+<li>{@link PDAUnimplementedInstructionEvent}</li>
+<li>{@link PDANoSuchLabelEvent}</li>
+</ul>
+
+<h3>Thread execution control</h3>
+<h4>Commands</h4>
+<ul>
+<li>{@link PDASuspendCommand}</li>
+<li>{@link PDAResumeCommand}</li>
+<li>{@link PDAStepCommand}</li>
+<li>{@link PDADropFrameCommand}</li>
+</ul>
+<h4>Events</h4>
+<ul>
+<li>{@link PDAStarted}</li>
+<li>{@link PDAExited}</li>
+<li>{@link PDASuspended}</li>
+<li>{@link PDAResumed}</li>
+</ul>
+
+<h3>Breakpoints</h3>
+<h4>Commands</h4>
+<ul>
+<li>{@link PDASetBreakpointCommand}</li>
+<li>{@link PDAClearBreakpointCommand}</li>
+<li>{@link PDAWatchCommand}</li>
+</ul>
+
+<h3>Data stack</h3>
+<h4>Commands</h4>
+<ul>
+<li>{@link PDADataCommand}</li>
+<li>{@link PDASetDataCommand}</li>
+<li>{@link PDAPopDataCommand}</li>
+<li>{@link PDAPushDataCommand}</li>
+</ul>
+
+<h3>Expression evaluation</h3>
+<h4>Commands</h4>
+<ul>
+<li>{@link PDAEvalCommand}</li>
+</ul>
+<h4>Events</h4>
+<ul>
+<li>{@link PDAEvalResultEvent}</li>
+</ul>
+
+<h3>Execution control stack</h3>
+<h4>Commands</h4>
+<ul>
+<li>{@link PDAStackCommand}</li>
+<li>{@link PDAStackDepthCommand}</li>
+<li>{@link PDAFrameCommand}</li>
+<li>{@link PDAVarCommand}</li>
+<li>{@link PDASetVarCommand}</li>
+<li>{@link PDAChildrenCommand}</li>
+</ul>
+
+<h3>Registers</h3>
+<h4>Commands</h4>
+<ul>
+<li>{@link PDAGroupsCommand}</li>
+<li>{@link PDARegistersCommand}</li>
+</ul>
+<h4>Events</h4>
+<ul>
+<li>{@link PDARegistersEvent}</li>
+</ul>
+
+</body>
+</html>