.help mrotlogr Jul86 "noao.imred.vtel"
.ih
NAME
mrotlogr -- Make a log of header information from a fits tape (Carrington maps).
.ih
USAGE
mrotlogr input_dev out_file startfnum endfnum append
.ih
PARAMETERS
.ls input_dev
Tape drive, e.g. "mta1600" or just "mta"
.le
.ls out_file
Name of output file to store information. Information is appended to this
file to allow one to update a previously created file.
.le
.ls startfnum
Tape file to start logging.
.le
.ls endfnum
Tape file to stop logging.
.le
.ls append
Flag to signal that we are appending to an existing file.
.le
.ih
DESCRIPTION
Mrotlogr reads FITS headers from successive tape files and compiles
certain information into a single line of output for each file.
Currently, the information output for each file includes:

.nf
        Tape file number, IRAF image name, date, time, and the
	Carrington longitude for each image.
.fi

If all of these header parameters are not present, only the ones found
will be printed out and garbage will come out for the empty parameters.
The date is stored in a header parameter called OBS_DATE, the time is
stored as 'seconds since midnight' in OBS_TIME and the Carrington
longitude is stored in L_ZERO.
To use this script, both the DATAIO package and the VTEL package must
be loaded.
.ih
EXAMPLES
1. To log all of the FITS images on a tape mounted on 'mta' and store the
information in a file called 'CX052' the command would be:

.nf
	vt> mrotlogr mta CX052 1 999 no
.fi

2. To log just the 40th through 60th files on mtb and see the output on
your terminal, the command would be:

.nf
	vt> mrotlogr mtb STDOUT 40 60 no
.fi

.ih
SEE ALSO
rfits
.endhelp