
GUIRunCIPRes |
org.cipres.kepler.GUIRunCIPRes |
This actor calls external Cipres applications with GUIGen interfaces.
The GUIRunCIPRes actor provides a template to invoke external Cipres
applications. A set of parameters is configured in the actor to collect
application related information. The value of these parameters will be
fed to the GUIRun object when the actor fires. Thus the GUIRun object
will invoke the corresponding application with those values, like the
input/output file names and the working directory. After the execution,
if the external program returns correctly, the standard output of the
execution will be sent to the standard output file, the standard error
will be sent to the standard error file, and the program output file
name will be sent to the outputParameterValue port.
The user can also set some words to be monitored in the standard output
stream. The observer/observable design pattern is used here. The
GUIRunCIPRes object is an observer. The GUIRun object is an observable.
Whenever the GUIRun object find any of these monitored words in the standard
output steam of the program execution, it will notify the GUIRunCIPRes
objects to promote the user handling the issue. Usually the GUIRunCIPRes
actor will stop the execution of the program.
Author(s): Zhijie Guan
Version:$Id: GUIRunCIPRes.java,v 1.2 2006/05/19 11:51:23 guan Exp $
standardOutput
The standard output stream of the execution is sent out through this port.
standardError
The standard error stream of the execution is sent out through this port.
exitCode
The exit code of the execution is sent out through this port.
outputParameterValue
The output parameter value, usually the name of the output file of the execution,
is sent out throught this port.
inputParameterName
The input parameter name (usually "infile") is sent through this port.
inputParameterValue
The input parameter value (usually the name of the input file of the execution)
is sent through this port.
command
The command path and name are defined in this parameter.
uiXMLFile
The GUIGen xml file's path and name are defined in this parameter.
outputFile
The standard output file's path and name are defined in this parameter.
errorFile
The standard error file's path and name are defined in this parameter.
workingDirectory
The workfing directory of the external program is defined in this parameter.
parameterForOutput
The GUIRun parameter to be send out is defined in this parameter.
Usually this GUIRun parameter is "outfile".
monitoredErrorWords
The monitored words are defined in this parameter.