drcl.ruv
Class System

java.lang.Object
  drcl.DrclObj
      drcl.comp.Component
          drcl.ruv.System

All Implemented Interfaces:

java.lang.Cloneable, ObjectDuplicable, java.io.Serializable

public class System

extends Component

The entry class of the DRCL RUntime Virtual (RUV) system. It will set up a terminal along with a shell and several system "directories":

• /.system: The System object itself.
• /.system/monitor: the system monitor (ComponentTester).
• /.term: stores all the terminals and shells.

One may specify the shell class, the terminal class and/or the initial script to execute. By default, Dterm and ShellTcl will be used to start the system. The complete usage is as follows:

drcl.ruv.System ?-auenh? ?-s <shell_class>? ?-t <terminal_class>? ?<init_script>?
      -a	use the RUV system as part of other programs (e.g. GUI), where "exit" or
          "quit" only terminates the terminal instead of the Java program.
      -u	uninteractive execution; no terminal is created.
      -e	end the Java program when there is no activity in the system; used with the "-u" option.
      -h	display help.
      -n	no terminal display.
 

See Also:

Serialized Form

Nested Class Summary

Nested classes inherited from class drcl.comp.Component

Component.Locks

Field Summary

Fields inherited from class drcl.comp.Component

FLAG_COMPONENT_NOTIFICATION, FLAG_DEBUG_ENABLED, FLAG_DIRECT_OUTPUT_ENABLED, FLAG_ENABLED, FLAG_ERROR_ENABLED, FLAG_EVENT_ENABLED, FLAG_EXPOSED, FLAG_GARBAGE_DISPLAY_ENABLED, FLAG_GARBAGE_ENABLED, FLAG_HAS_EXPOSED_CHILD, FLAG_PORT_NOTIFICATION, FLAG_STARTED, FLAG_STOPPED, FLAG_TRACE_ENABLED, FLAG_UNDEFINED_START, id, infoPort, locks, name, parent, PortGroup_DEFAULT_GROUP, PortGroup_EVENT, PortGroup_SERVICE, Root, Trace_DATA, Trace_SEND

Constructor Summary

System()

System(java.lang.String id_)

Method Summary

void	_newTerminal() Creates a new terminal in the RUV system.
void	_newTerminal(java.lang.String initScript_, java.lang.String[] args_) Creates a new terminal in the RUV system and executes the script in the terminal.
void	addTerminal(Term terminal_, Shell shell_, java.lang.String initScript_, java.lang.String[] args_)
static void	cleanUpSystem() Removes all the components, except system objects, in the RUV system.
static Term	getTerminal(Shell shell_)
java.lang.String	info() Returns information regarding this component.
static void	main(java.lang.String[] args)
static void	newTerminal() Creates a new terminal in the RUV system.
static void	newTerminal(java.lang.String initScript_, java.lang.String[] args_) Creates a new terminal in the RUV system and executes the script in the terminal.
static void	resetSystem() Resets all the components in the RUV system.
protected void	setRuntime(ACARuntime m_) Overrides Component.setRuntime(ACARuntime) to prevent changing the runtime by accident.

Methods inherited from class drcl.comp.Component

_resume, _start, _stop, addComponent, addComponent, addEventPort, addEventPort, addForkPort, addPort, addPort, addPort, addPort, addPort, addPort, addPort, addPort, addServerPort, addServerPort, cancelFork, componentAdded, componentRemoved, connect, containsComponent, containsComponent, containsPort, debug, disconnectAll, disconnectAllPeers, disconnectAllPorts, drop, drop, duplicate, error, error, expose, exposeEventPorts, exposePort, exposePort, exposePort, exposePort, exposePort, findAvailable, findAvailable, findAvailable, finishing, fork, forkAt, getAllComponents, getAllPorts, getAllPorts, getAllWiresInside, getAllWiresInsideOut, getAllWiresOut, getComponent, getComponentFlag, getComponentFlag, getContract, getContractHT, getContractHT, getDebugFlagsInBinary, getDebugLevelNames, getForkManager, getID, getName, getParent, getPort, getPort, getRoot, getRuntime, getTime, iduplicate, isAncestorOf, isComponentNotificationEnabled, isContainer, isDebugEnabled, isDebugEnabledAt, isDirectlyRelatedTo, isDirectOutputEnabled, isEnabled, isErrorNoticeEnabled, isEventExportEnabled, isGarbageDisplayEnabled, isGarbageEnabled, isPortNotificationEnabled, isPortRemovable, isStarted, isStopped, isTraceEnabled, lock, notify, notifyAll, operate, portAdded, portRemoved, process, reboot, removeAll, removeAllComponents, removeAllPorts, removeAllPorts, removeComponent, removeComponent, removePort, removePort, removePort, reset, resume, run, sduplicate, send, sendAt, setComponentFlag, setComponentFlag, setComponentNotificationEnabled, setContract, setDebugEnabled, setDebugEnabled, setDebugEnabledAt, setDebugEnabledAt, setDebugEnabledAt, setDirectOutputEnabled, setDirectOutputEnabled, setEnabled, setErrorNoticeEnabled, setErrorNoticeEnabled, setEventExportEnabled, setEventExportEnabled, setExecutionBoundary, setGarbageDisplayEnabled, setGarbageDisplayEnabled, setGarbageEnabled, setGarbageEnabled, setID, setID, setName, setPort, setPort, setPortNotificationEnabled, setPortRemovable, setTraceEnabled, setTraceEnabled, sleepFor, sleepUntil, stop, toString, unexpose, unlock, useLocalForkManager, useLocalForkManager, wait, yield

Methods inherited from class drcl.DrclObj

clone

Methods inherited from class java.lang.Object

equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

System

public System()

System

public System(java.lang.String id_)

Method Detail

newTerminal

public static void newTerminal()

Creates a new terminal in the RUV system.

newTerminal

public static void newTerminal(java.lang.String initScript_,
                               java.lang.String[] args_)

Creates a new terminal in the RUV system and executes the script in the terminal.

resetSystem

public static void resetSystem()

Resets all the components in the RUV system.

cleanUpSystem

public static void cleanUpSystem()

Removes all the components, except system objects, in the RUV system.

main

public static void main(java.lang.String[] args)

info

public java.lang.String info()

Description copied from class: Component

Returns information regarding this component. Subclasses should override this method to provide useful information at run time.

Overrides:

info in class Component

setRuntime

protected void setRuntime(ACARuntime m_)

Overrides Component.setRuntime(ACARuntime) to prevent changing the runtime by accident.

Overrides:

setRuntime in class Component

_newTerminal

public void _newTerminal()

Creates a new terminal in the RUV system.

_newTerminal

public void _newTerminal(java.lang.String initScript_,
                         java.lang.String[] args_)

Creates a new terminal in the RUV system and executes the script in the terminal.

addTerminal

public void addTerminal(Term terminal_,
                        Shell shell_,
                        java.lang.String initScript_,
                        java.lang.String[] args_)

getTerminal

public static Term getTerminal(Shell shell_)