com.nukernel.jdcf
Interface Communicator

All Known Implementing Classes:

CommunicatorImpl

public interface Communicator

extends java.rmi.Remote

Before a program is started on a node, the system obtains a Communicator from each copy of the program so that the program can perform internode communication.

Method Summary

RemoteThreadInterface	createThread(RemoteRunnable target, java.lang.String name) Called to create a remote thread on the target node.
void	kill() Called when the job should abort execution.
void	resume() Called on a previously suspended job when it should begin executing again.
java.lang.Object	status() Return an object representing the status of the computation.
void	suspend() Called when the job should stop executing temporarily.

Method Detail

status

public java.lang.Object status()
                        throws java.rmi.RemoteException

Return an object representing the status of the computation.

Returns:

status object

Throws:

java.rmi.RemoteException - if a communication error occurs

suspend

public void suspend()
             throws java.rmi.RemoteException

Called when the job should stop executing temporarily.

Throws:

java.rmi.RemoteException - if a communication error occurs

resume

public void resume()
            throws java.rmi.RemoteException

Called on a previously suspended job when it should begin executing again.

Throws:

java.rmi.RemoteException - if a communication error occurs

kill

public void kill()
          throws java.rmi.RemoteException

Called when the job should abort execution.

Throws:

java.rmi.RemoteException - if a communication error occurs

createThread

public RemoteThreadInterface createThread(RemoteRunnable target,
                                          java.lang.String name)
                                   throws java.rmi.RemoteException

Called to create a remote thread on the target node.

Parameters:

target - the run method to invoke

name - desired name for the thread

Returns:

a remote object similar to java.lang.Thread

Throws:

java.rmi.RemoteException - if a communication error occurs