HP 3000 Manuals

System Debug Reference Manual

LIST 

Controls the recording of input and output to a list file.

Syntax 

      LIST
      LIST  [filename]

      LIST  [ON ]
      LIST  [OFF]

      LIST  [CLOSE]

All Debug input/output is recorded to an open, active list file.  This
includes the prompt, user command input, and all resulting output, with
the exception of window displays and updates.  Users typically use the
list file to record Debug output to a file for later reference or
printing.

LIST, entered alone, displays the state of the list file, including the
file name, if open, and current status (ON/OFF).

LIST filename opens the specified file and activates (turns ON) the list
file.  If another list file was already opened, it is first closed
(saved), before the new file is opened.

LIST ON and LIST OFF can be used to activate/deactivate the currently
opened list file.  The file remains open (pending), but Debug output is
not recorded if the list file is OFF.

LIST CLOSE closes (saves) the current opened list file.

Parameters 

filename         The file name for the list file that is to be opened.
                 If the file already exists, it is automatically purged
                 (without warning), and reopened new.

                 If omitted, the status of the current list file is
                 displayed.

Examples 

     %cmdebug > list junk1 

Open a new list file named junk1 and activate it (ON). All Debug
input/output is automatically recorded in this file until it is
explicitly deactivated (LIST OFF) or closed (LIST CLOSE).

     %cmdebug > list off 
     %cmdebug > dq-40, 200 
     %cmdebug > list on 

Temporarily disable the list file, while we display 200 Q-relative words,
then enable the list file again.

     %cmdebug > list close 

Close (and save) the current list file.  Auto-listing is now off.

Limitations, Restrictions 

Unless a file equation is used, the list file is opened as follows:

  CCTL, FIXED, ASCII, 20000 Records.

The record size is based on the LIST_WIDTH environment variable.


CAUTION  The output format of all System Debug commands is subject to
         change without notice.  Programs that are developed to
         postprocess System Debug output should not depend on the exact
         format (spacing, alignment, number of lines, uppercase or
         lowercase, or spelling) of any System Debug command output.

MPE/iX 5.0 Documentation