LIST

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.

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:

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.