HPlogo System Debug Reference Manual: HP 3000 MPE/iX Computer Systems > Chapter 4 System Debug Command Specifications

LIST

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Index

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.
Feedback to webmaster