!Overview
	   CDS FITS Generation Software

This program converts CDS telemetry into FITS
files.  It can be used with either a real time
telemetry feed, or with stored telemetry files.

A widget interface is used to set up the
parameters for the processing.  However, once
processing is started, user control is locked out
until either the real time feed is lost, or the
file processing is completed.

TELEMETRY MODES: The following telemetry modes are
currently defined:

	0:	Replay stored telemetry
	1:	Realtime telemetry
	2:	Quicklook tape recorder dumps
	3:	Realtime telemetry archived by ECS
	4:	Final distribution

When additional compression modes are defined, the
software will be upgraded to support them.

!Title
The text window going across the top of the widget
is used to display the current status when data is
being processed.  In other words, it will tell you
if it is processing real time telemetry, or stored
telemetry files.  When not processing data, this
field is blank.

!Start
Use this button to start processing the telemetry
into FITS files.

!Stop
Use this button to stop processing the telemetry.

Note that the action is not immediate--processing
will only stop at the beginning or end of a raster.

!EXIT
Use this button to exit from the FITSGEN program.

!Mode
This pull-down menu is used to select between a
real time telemetry or replaying stored telemetry
files.  Initially one is in "Real time" mode.
When "Replay (TM file)" is selected, additional
buttons and fields will appear within the widget.

Replay mode can be used with stored realtime
telemetry files (tm.), with quicklook tape
recorder dump files (.QKL), with realtime
telemetry as archived by the SOHO ECS (.REL), and
with final distribution files (.DAT1).

!Select TM file
Used in replay mode to select one or more
telemetry files.  Pressing this button causes
another widget to appear.

Not visible when in real time mode.

!Limited/Unlimited Run
This list widget allows one to choose between two
possible run states:

   Limited run:    Only the files selected with
		   the "Select TM file" button
		   will be processed.

   Unlimited run:  Once the selected files are
		   processed, the program will
		   attempt to determine what the
		   next telemetry file in the
		   series should be.

Not visible when in real time mode.

!Operator
This contains the email address of the operator.
Error messages will be mailed to this address.  If
blank, then error messages will only be displayed
on the screen.

!Packet ID
Displays the ID of the packet currently being
processed.

!Log file
Displays the name of the current log file.

If the environment variable CDS_TM_LOG is defined,
then the log file is written into that directory.
Otherwise, the file is written into the current
directory.

The filename is formed from the current (UTC) date
and time with the format

	       YYYYMMDD_HHMM.tmlog

!Current file
Displays the name of the telemetry file currently
being processed.

Not visible in real time mode.

!Start Pkt
Allows one to define the number of packets to skip
in the first telemetry file before processing
begins.  The default is to start with the first
packet (0).

Not visible in real time mode.

!Start study
Any value other than 0 is used to signify a study
counter value that processing should begin with.
Any rasters seen with study counter values less
than this will be skipped over.

If you don't want to start at a specific study,
then leave this parameter as 0.

Not visible in real time mode.

!Start index
Any non-negative value is used to signify a raster
index value that, when combined with the start
study counter, indicates where processing should
begin.

The index is only used when processing the study
indicated by the start study counter value.

If you don't want to start at a specific index,
then leave this parameter as -1.

Not visible in real time mode.

!End study
Any value other than 0 is used to signify a study
counter value that processing should end with.
Any rasters seen with study counter values greater
than this will generate a stop.

If you don't want to end at a specific study, then
leave this parameter as 0.

Not visible in real time mode.

!End index
Any non-negative value is used to signify a raster
index value that, when combined with the end
study counter, indicates where processing should
end.

The index is only used when processing the study
indicated by the end study counter value.

If you don't want to end at a specific study, then
leave this parameter as -1.

Not visible in real time mode.

!Generate stop
This button is used to generate an automatic stop
when the type of telemetry file being read in
changes.  This is used to "glue together" a raster
which spans the boundary between tape recorder
dumps (.QKL) and realtime files (.REL or tm.)

With this button on, when a mode change is seen
then processing will end as soon as the current
raster is completed.

It is recommended that when "Generate stop" is
used, that "Unlimited run" be used as well.

!Processing final distribution
If this button is selected, then the keyword
DATASRC will be written to the FITS file and
catalog saying that the data was generated from
the final distribution CDROM.  Otherwise, the FITS
file and catalog will say that the data was
processed from the realtime and quicklook
telemetry.

It is the responsibility of the operator to ensure
that this is set correctly.

Not visible in realtime mode.

!Messages
A scrollable text window that displays information
about the processing.  Information that is written
into the log file will also appear here.  The
window is restored to its initial state every time
processing is started.
