7 oracdr_monitor

Monitor the ORAC-DR pipeline output

SYNOPSIS

  oracdr_monitor

  oracdr_monitor --tty

  oracdr_monitor --nodisplay

To automatically determine ORAC_DATA_OUT based on a location file:

  oracdr_scuba2_850_summit

  orcadr_monitor --useloc

DESCRIPTION

This program monitors the output from ORAC-DR log files in the ORAC_DATA_OUT directory. If a new log file is created (e.g. by a restart of ORAC-DR) the program will automatically begin monitoring the new one.

If an X-display is running it sends the output to an Xwindow similar to the standard ORAC-DR logging window. If there is no display the output is sent to standard output.

By default the data display is enabled to monitor the live pipeline display requests. On startup only new display requests are handled (any pending from earlier in the pipeline processing are ignored). The data display can be disabled using the -nodisplay option.

OPTIONS

--help

List help text. This prints a summary of this document.

--man

Print the full documentation.

--version

Print the version number.

--tty

This sends the output to the current xterm. It is automatically selected if the DISPLAY environment variable is unset.

--nodisplay

Disable display monitoring. Ignored if DISPLAY environment variable is not set.

--skip

If display monitoring is enabled, by default the monitor will attempt to process every request even if that means it falls behind the pipeline. With this option only the most recent request will be handled with the exception that Group display requests are always processed.

--uselocation

Use the location "declared" by a file in ORAC_LOCATION_DIR (default /jac_sw/oracdr-locations) as ORAC_DATA_OUT.

--recsuffix

Specifies a preferred recipe suffix. This affects the pipeline location file used if the --uselocation option is given.

AUTHOR

Tim Jenness <t.jenness@jach.hawaii.edu >

COPYRIGHT

Copyright (C) 2001 Particle Physics and Astronomy Research Council. Copyright (C) 2007 Science and Technology Facilties Council. All Rights Reserved.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful,but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place,Suite 330, Boston, MA 02111-1307, USA