User's Guide

DUMP

DITTO command ---- Print file contents of a DITTO device

Function:

Prints the contents of a file. May be printed in character or hexadecimal format.

Parameters:

DEVTYPE
Device type. Specifies which input/output device is to be processed. Valid values are:


  = INPUT:  Input device
  = OUTPUT: Output device

NRECS(--)
Number of records. The number of records to be dumped from the current position of the DITTO device. The default is to dump records until an end of file is encountered.

DATAFORM(HEX)
Data format. Specifies how the data is to be printed. Valid values are:


  = ASCII:   ASCII format.  Output ASCII character 
             format.
  = EBCIDIC: EBCDIC format.  Output EBCIDIC character 
             format.
  = HEX:     Hexadecimal format.  Output hexadecimal 
             format.

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".

Example:

  1. DITTO> dump devtype=input nrecs=5 dataform=hex print=term

    The user has requested to print to the terminal (in hexidecimal format) five blocks starting from the current position of the input device.

Description/Algorithm:

From the input parameter DEVTYPE it is determined which DITTO device is to be processed. The file is printed in the specified format to the appropriate destination (terminal, disk file, and/or line printer).

Nonfatal Error Messages:

    None.

Fatal Error Message:

    None.

User Notes:

  1. If end of volume (EOV) is detected on tape, the tape is left positioned between the two tape marks.

                                  file ptr
                                      |
                                      v
         --------------------------------
         |                          |E|E|
         |                          |O|O|
         |                          |F|F|
         --------------------------------
    

  2. If end of file (EOF) is detected on tape, the tape is left positioned after the tape mark.

                                  file ptr
                                      |
                                      v
         ------------------------------
         |                          |E|
         |                          |O|
         |                          |F|
         ------------------------------