User's Guide

MAPPER

List the physical characteristics of tapes, LAS image files, or nonimage disk files.

Function:

Lists the physical characteristics of tapes (subcommand -TAPE), LAS image files (subcommand -IMAGE), or disk files (subcommand -DISK). For tapes and disk files, the number of records and the length of each record in the file(s) are printed to the user-specified destination. For LAS images--the image name, the number of lines and samples, and the data type are printed to the user-specified destination. If MAPPER is run on a tape, the program makes sure that the tape is at the beginning before processing.

Parameters:

Subcommand -TAPE:
Lists tape characteristics. Lists the physical characteristics of tape files. The number of records and the length of each record on the tape is written to the user-specified destination.

COMMENT
Description of tape. A text string sent to the operator's terminal providing information about the tape.

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 filename.  Output is 
               sent to the user-supplied file with 
               the extension ".prt".
Subcommand -IMAGE:
Lists image characteristics. Lists the characteristics of the LAS image. The image name, number of lines, the number of samples, and the data type is written to the user-specified destination.

IN
Input image. The input LAS image name.

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 filename.  Output is 
               sent to the user-supplied file with 
               the extension ".prt".
Subcommand -DISK:
Lists disk file characteristics. Lists the physical characteristics of disk files. The number of records and the length of each record in the disk file is written to the user-specified destination.

INFILE
Input file. The host disk file name or the LAS image name. The parameter IMAGEFLG is used to determine which name was specified.

IMAGEFLG(YES)
Image flag. Flag that indicates that the name specified in the parameter INFILE is a LAS image name or a host disk file name.

  = YES:  LAS image name.  The input name specified
          is a LAS name.
  = NO:   Host file name.  The input name is a host 
          file name.

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 filename.  Output is 
               sent to the user-supplied file with 
               the extension ".prt".

Examples:

  1. LAS> mapper-tape comment="please mount tape kk1962"

    Tape KK1962 is mounted on an available tape drive, and the length of each record of every file on the tape is displayed at the terminal.

  2. LAS> mapper-image in=[image]image1 print=imap

    The number of lines, the number of samples, and the data type of the image IMAGE1 are written into a file named IMAP.PRT.

  3. LAS> mapper-disk infile=[image]image1 imageflg=yes print=lp

    The length of each record in the LAS image file IMAGE1 is sent to the line printer specified by the TAE global variable $PRINTER.

  4. LAS> mapper-disk infile=ny.dat imageflg=no print=(term,lp,dmap)

    The length of each record in the nonimage file NY.DAT is sent to the terminal, line printer, and the file named DMAP.PRT.

Description/Algorithm:

The subcommands -TAPE and -DISK call the DITTO utility application that prints the number of records and the length of each record on the tape or disk file. If the mapper command is run on a magnetic tape, the tape is rewound before processing begins and rewound to the beginning of tape at completion. If the mapper command is run on a disk file, processing begins at the beginning of the file; after completion, the file pointer is returned to the beginning of file. The mapper command for disk files also checks the parameter IMAGEFLG to determine if the input name is a LAS image name or a disk host file name. If the input name is a LAS image name, it is translated into the host file name and passed to the DITTO utility.

The subcommand -IMAGE calls the CMLIST module to print the image name, number of lines, the number of samples, and the data type from the LAS image's data descriptor record (DDR).

Nonfatal Error messages:

    None.

Fatal Error messages:

    None.

User Notes:

  1. Tapes are rewound before the application begins and after program completion.

  2. The minimum record length for a tape is 14 bytes.