HPlogo System Debug Reference Manual > Chapter 5 System Debug Command Specifications Fx-LOG

LIST

MPE documents

Complete PDF
Table of Contents
Index

E0201 Edition 4 ♥
E0300 Edition 3
E0692 Edition 3

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.



LEV

LISTREDO