Both these tools manage the behavior of the Hub and multiple servers (although they can be used to manage any arbitrary executable). The process_monitor is a Python GUI which provides a pane for each managed executable; the panes can be hidden and redisplayed, and each process can be stopped and restarted. The csh_process_monitor is a version which provides a separate xterm for each process (so it does not provide some of the process management support). If <GC_HOME>/templates/config.make has not enabled Python at compilation time, process_monitor will be identical to csh_process_monitor.
There are two different ways of configuring the Python GUI: through command line flags or through a configuration file. You may use one or the other, but not both. For the csh tool, only the command line flag option is available.
You can also consult the process monitor tutorial.
Argument | Applicable to Python | Appicable to csh | Description |
-T <string> | yes | yes | The title of the particular process |
--open | yes | Should the pane start open? (default is closed in Python, always open in csh) | |
--start | yes | Should the process be started automatically? (default is no in Python, always started in csh) | |
--keep_alive | yes | If specified, restart this process if it dies | |
--input_line | yes | Should a typein window be provided for this process? (default is no in Python, always available in csh) | |
--input_return | yes | Should a button be provided for inputting a carriage return? (default is no in Python, always available in csh) | |
-c <string> | yes | yes | The command line of the process. This command line should always be something that can be preceded with "exec". |
In addition to these arguments there are five other, global arguments:
% setenv MITRE_ROOT $GC_HOME/contrib/MITREThis invocation of the process monitor creates three panes, all of which are open at startup, all of which must be started by the user by hand.
% setenv DEMO_ROOT $MITRE_ROOT/examples/sql_explore
% $MITRE_ROOT/tools/bin/process_monitor --master_title "DB Interaction" \
-T "DB" --open -c "$MITRE_ROOT/tools/bin/run_server $GC_HOME/contrib/MITRE/servers/bin/db_server -dblogin galaxy/galaxy" \
-T "SQL Monitor" --open --input_line -c "$MITRE_ROOT/servers/bin/c_ui -prompt 'Type a query: ' -verbosity 0" \
-T "Hub" --open -c "$GC_HOME/bin/hub -pgm_file $DEMO_ROOT/bare_query.pgm"
All arguments after a double dash ("--") on the command line are passed to the configuration file, to be substituted into the command lines in the same way that the EXPAND: directive does. These arguments are made available as $1, $2, etc., or as the name listed in the corresponding position in the ARGUMENTS: directive.
All entries in the configuration file are
a single line long. Lines starting with a pound sign ("#") are ignored,
as are lines consisting entirely of whitespace. The first token in the
line is the directive, and the remaining data is the value. By convention,
all the directives end with a colon (":").
Directive | Value | Scope | Starts block | Description |
PROCESS: | yes | process | yes | The command line of the process. This command line should always be something that can be preceded with "exec". Identical to -c. |
PROCESS_KEEP_ALIVE: | no | process | no | f specified, restart this process if it dies. Identical to --keep_alive. |
PROCESS_TITLE: | yes | process | no | The title of the particular process. Identical to -T. |
PROCESS_MONITOR_ARGS: | yes | process | no | Additional command line arguments to specify, such as --input_return, etc. These will be digested as they would in the corresponding set of arguments describing a process on the command line. |
TITLE: | yes | process block | yes | The name of the process block. This name can be used as the second argument to the process monitor to specify one of a number of process blocks in a configuration file. Identical to --master_title. |
EXPAND: | yes | global | no | A pair of tokens, the first being a string to be substituted, the second a string to substitute for. This can be used anywhere in the values for any subsequent entry, but are primarily intended to serve as shorthand in the command line. These expansions can also be chained; that is, subsequent EXPAND: entries can refer to previous EXPAND: entries. Note that the expansion of $GC_HOME to the root of the Galaxy Communicator installation is always available. By convention, these expansions start with a dollar sign ("$"), to evoke the notion of shell variables. |
SUPPRESS_EXPANSIONS: | no | global | no | If present, the expansions specified in EXPAND: will only be applied when the command is actually executed; for display purposes, the unexpanded string will be used |
NUM_DIVISIONS: | yes | global | no | How many columns should the process panes be arranged in? Identical to --ncols. |
COMPRESSED: | no | global | no | if specified, start up in a compressed configuration, with a single process viewer and buttons to switch the viewer between processes. When COMPRESSED: is specified, NUM_DIVISIONS: becomes the number of button rows. This argument can appear anywhere in the command line. Identical to --compressed. |
CLEAR_HISTORY: | yes | global | no | If specified, clears the history of each pane after the specified number of lines are written. This means that long-running processes won't grind to a halt because of Tcl update delays. Identical to --clear_history. |
ARGUMENTS: | yes | global | no | If specified, provides a sequence of tokens which corresponds to the arguments expected after the double dash ("--"). No optional arguments are permitted. If not all arguments are present, the process monitor will fail. If there are extra arguments, they will be ignored. The resulting bound arguments can be referred to by name or position, with a prefixed dollar sign ($). |
EXPAND: $MITRE_ROOT $GC_HOME/contrib/MITRE
EXPAND: $DEMO_ROOT $MITRE_ROOT/examples/sql_exploreTITLE: DB Interaction
PROCESS: $MITRE_ROOT/tools/bin/run_server $MITRE_ROOT/servers/bin/db_server -dblogin galaxy/galaxy
PROCESS_TITLE: DB
PROCESS_MONITOR_ARGS: --open
PROCESS: $MITRE_ROOT/servers/bin/c_ui -prompt 'Type a query: ' -verbosity 0
PROCESS_TITLE: SQL Monitor
PROCESS_MONITOR_ARGS: --open --input_line
PROCESS: $GC_HOME/bin/hub -pgm_file $DEMO_ROOT/bare_query.pgm
PROCESS_MONITOR_ARGS: -T "Hub" --open
Copyright (c) 1999 - 2002
The MITRE
Corporation
ALL RIGHTS RESERVED