Raw Header and Subscan Data Stored as One File per Scan

		William Peters			August 27, 1997

	With the addition of a few extra pointers in the raw data records it
is now possible to store the raw data for an entire scan in a single file,
with no loss of the flexibility or generality of the previous scheme.  The new
scheme has been implemented via the subroutines described below.  In addition,
there are four programs based upon these routines:  CATALOG makes a summary of
the contents of a Raw Scan File:  what subscans & versions are contained,
their lengths, and which Front Ends & Back Ends were used.  TRUNCATE truncates
a Raw Scan File, discarding any unused blocks in the file (normally done
automatically by MTWRITE).  The other two are mainly intended as debugging
tools and may have only a limited lifetime: SEPARATE converts a single Raw
Scan File back into separate files as before.  (It might also be used for a
while until the data analysis software can be modified to accept a single file
as input.)  MERGE_RAW takes separate sub-scan files and merges them into the
single Raw Scan File.  (It also might be needed if old raw data must someday
be reprocessed after the modifications are made to the data analysis
software.) 

	The following programs will either take their parameters from the DCL 
line if executed as a "foreign command" or will prompt for them if RUN.  The 
descriptions below assume the former, i.e., symbols of the form 

		<program>:==$<disk>:[<directory>]<program>

have been defined.  (This can be done by including @SYS$SMT:[SMT]SYMBOLS
in your LOGIN.COM file.)


1)    CATALOG file-spec [/OUTPUT=name] [,file-spec[/OUTPUT=name]...]

will catalog the file(s) specified by one or more "file-spec"s (may contain 
wildcards).  The output will be to the terminal unless /OUTPUT is used to 
specify an output file "name".  If /OUTPUT is used, the listing will be sent to 
the file "name" for the "file-spec" to which it is appended and for all
subsequent "file-spec"s (unless another /OUTPUT is appended).  Alternatively,
file-spec may be a scan number (with wild cards), nnnn.  In this case, the 
standard file name is nnnnT.RAW is used.  If the raw data is not found in the
current directory, the TEL$NEW_DATA: directory is searched.

2)    TRUNCATE file-spec [,file-spec...]

will truncate the file(s) specified by one or more "file-spec"s (may contain 
wildcards).  Truncating a file which needs no truncation changes only its 
revision date.

3)    SEPARATE file-spec [/NOOLD | /OLD | /INT ] [,file-spec...]

will write into separate subscan and header files the merged file(s) specified
by the "file-spec"(s) (wildcards may be used).  The qualifiers are only needed 
for debugging purposes.  /OLD produces header files matching those prior to 
7/89, /INT like between 7/89 and 2/90, and /NOOLD (the default), like after 
2/90.  In all cases, the separated files are fully functional.  The qualifiers 
are simply so that DIFFERENCES will not report any "errors" when comparing 
the results of MERGE_RAW (below) followed by SEPARATE.


4)    MERGE_RAW nnnn

where nnnn is the scan number whose subscan files are to be combined.  The
output will be to the file nnnnx.RAW.  "x" will be the letter following nnnn 
in the first header file found (usually "T").