User's Guide

DSPASSOC

Displays the contents of associative files.

Function:

Displays the contents of LAS associated files. These files are read from tape by CCTTIPSP, EDIPSIN, FSTFMTIN, PLENTER, JSCIN or LTWGIN. The contents of the files are printed to the terminal, line printer, or disk file.

Parameters:

Subcommand -FFMT:

Displays information from a Fast Format header file. This file may be created when FSTFMTIN is used to read data from tapes to disk.

INFILE
Input file name. The root name of the associated files, to be displayed. The appropriate extensions will be appended to this name (see User Note 1).

PRINT(TERM)
Output destination. The destination of the output.
  = TERM:      Terminal.  Output is sent to the user's 
               terminal.
  = LP:        Line printer.  Output is sent to the 
               printer defined by $PRINTER.
  = Filename:  User-supplied file name.  Output is sent 
               to a disk file named "filename;prt".

Subcommand -TIPSP:

Displays information from TIPSP associated files. These files may be created when CCTTIPSP is used to read data from tapes to disk.

INFILE
Input file name. The root name of the associated files, to be displayed. The appropriate extensions will be appended to this name (see User Note 1).

ASFILE(HDR,ANB,TRA)
Associated files. The associated files present on disk. These files will be read and written to the output destination. The default assumes that all file types exist.
  = ANB:  Annotation and band quality file. Indicates 
	  that the annotation file is to be displayed. 
  = HDR:  Header file.  Indicates that the header
	  file is to be displayed.
  = TRA:  Trailer file.  Indicates that the
          trailer file is to be displayed.
PRINT(TERM)
Output destination. The destination of the output.
  = TERM:      Terminal.  Output is sent to the user's 
               terminal.
  = LP:        Line printer.  Output is sent to the 
               printer defined by $PRINTER.
  = Filename:  User-supplied file name.  Output is sent 
               to a disk file named "filename;prt".

Subcommand -CCTX:

Displays information from a CCTX associated file. This file may be created when PLENTER is used to read data from tapes to disk.

INFILE
Input file name. The root name of the associated files, to be displayed. The appropriate extensions will be appended to this name (see User Note 1).

PRINT(TERM)
Output destination. The destination of the output.
  = TERM:      Terminal.  Output is sent to the user's 
               terminal.
  = LP:        Line printer.  Output is sent to the 
               printer defined by $PRINTER.
  = Filename:  User-supplied file name.  Output is sent 
               to a disk file named "filename;prt".

Subcommand -EDIPS:

Displays information from EDIPS associated files. These files may be created when EDIPSIN is used to read data from tapes.

INFILE
Input file name. The root name of the associated files, to be displayed. The appropriate extensions will be appended to this name (see User Note 1).

ASFILE(HDR,ANB,TRA)
Associated files. The associated files present on disk. These files will be read and written to the output destination. The default assumes that all file types except the ancillary file exist. For geometrically corrected data the ancillary file is not present.
  = ANB:  Annotation file. Indicates that the 
          annotation file is to be displayed. 
  = HDR:  Header  file.  Indicates that the header
	  file is to be displayed.
  = TRA:  Trailer file.  Indicates that the
          trailer file is to be displayed.
  = ANC:  Ancillary file.  Indicates that the 
          ancillary file is to be displayed.
PRINT(TERM)
Output destination. The destination of the output.
  = TERM:      Terminal.  Output is sent to the user's 
               terminal.
  = LP:        Line printer.  Output is sent to the 
               printer defined by $PRINTER.
  = Filename:  User-supplied file name.  Output is sent 
               to a disk file named "filename;prt".

Subcommand -JSC:

Displays information from JSC associated files. These files may be created when JSCIN is used to read data from tapes.

INFILE
Input file name. The root name of the associated files, to be displayed. The appropriate extensions will be appended to this name (see User Note 1).

LINENUM(1)
Line number. The line number for which data from the ancillary file is to be read.

ASFILE(UHDR,LHDR)
Associated files. The associated files present on disk. These files will be read and written to the output destination. The default assumes that all file types except the ancillary file exist.
  = LHDR:  LANDSAT header.  Indicates that the LANDSAT
	   header is to be displayed. 
  = UHDR:  Universal header  file.  Indicates that 
	   the universal header file is to be 
           displayed.
  = ANC:   Ancillary file.  Indicates that the
           ancillary file is to be displayed.
PRINT(TERM)
Output destination. The destination of the output.
  = TERM:      Terminal.  Output is sent to the user's 
               terminal.
  = LP:        Line printer.  Output is sent to the 
               printer defined by $PRINTER.
  = Filename:  User-supplied file name.  Output is sent 
               to a disk file named "filename;prt".

Subcommand -LTWG:

Displays information from LTWG associated files. These files may be created when LTWGIN is used to read data from tapes.

INFILE
Input file name. The root name of the associated files, to be displayed. The appropriate extensions will be appended to this name (see User Note 1).

LINENUM(1)
Line number. The line number for which data from the image data recotd is to be read.

ASFILE(LEAD)
Associated files. The associated files present on disk. These files will be read and written to the output destination. The default assumes that the leader file exists.
  = VDF:   Volume directory file.  Indicates that the volume
	   directory file is to be displayed.
  = LEAD:  Leader file.  Indicates that the leader file is
	   to be displayed.
  = TRAI:  Trailer file.  Indicates that the trailer file is
	   to be displayed.
  = SUPP:  Supplemental file.  Indicates that the supplemental 
	   file is to be displayed.
  = IDR:   Image data records.  Indicates that the image data
	   records is to displayed.
PRINT(TERM)
Output destination. The destination of the output.
  = TERM:      Terminal.  Output is sent to the user's 
               terminal.
  = LP:        Line printer.  Output is sent to the 
               printer defined by $PRINTER.
  = Filename:  User-supplied file name.  Output is sent 
               to a disk file named "filename;prt".

Examples:

LAS> dspassoc-ffmt infile=test print=(term,lp)
DSPASSOC will read the contents of the Fast Format header file that is associated with the image TEST and will print the contents to the terminal and the line printer specified by the global TAE $PRINTER.
LAS> dspassoc-edips infile=north asfile=(hdr,tra,anb,anc)
DSPASSOC will read the contents of the header, trailer, annotation, and ancillary files associated with NORTH. This information will be displayed to the terminal.

Description/Algorithm:

The input parameter values are read. The contents of the associative files are retrieved, and written to the device(s) specified in PRINT. If an associated file is specified but does not exist, a fatal error message is displayed.

Nonfatal Error Messages:

[dspfhdr-nonfatal] Nonfatal error encountered
A nonfatal error was encountered. The error message that is displayed immediately preceding this message is the specific error that was encountered. Processing continues.

Fatal Error Messages:

[dspfhdr-fatal] Fatal error encountered
A fatal error was encountered. Processing is terminated. The message that is displayed immediately preceding this error message is the specific error that was encountered.
[dspfhdr-open] Error opening the print file
An error occurred while trying to open the output print file. Check to ensure that there is sufficient disk space and that there is write permission in the specified directory.

User Note:

The default file extensions for each type are:

        CCTX	";cctx_siat"
	EDIPS	";edips_ancil"
		";edips_annot"
		";edips_headr"
		";edips_trail"
	FFMT	";fhdr"
	JSC	";uhdr"
		";lhdr"
		";anc"
	TIPSP	";tipsp_annot"
		";tipsp_head"
		";tipsp_trail"
        LTWG    ";vdf"
 		";lead"
		";trai"
		";supp"
		";idr"

Routines which are used to read associated files in from tape are CCTTIPSP, EDIPSIN, FSTFMTIN, JSCIN, PLENTER, and LTWGIN.
The LTWG option produces a large amount of data. Print the output to a file, then print only what you need to look at.