Chapter Contents

Previous

Next
Window Directory

Termout Window

Termout Window

[IMAGE]

DESCRIPTION
The Termout window displays output that is directed to the terminal by your program. By default, the debugger intercepts output from functions such as printf, opens the Termout window, and displays the terminal output in the window. As shown in Termout Window, there are three areas in the Termout window: a status and prompt line, an optional scale or ruler line, and an output area.

Status and prompt line The Termout window is controlled by the following fields that are located in the status and prompt line:

More... prompt
flashes to indicate that more information is waiting to be displayed in the Termout window. (See Pause: below)

Intercept:
controls the output intercept. By default, Intercept: is set to Y (yes), which causes the Termout window to automatically intercept terminal output. Typing N (no) in this field stops the output intercept.

Log:
determines whether intercepted output is copied to the Log window. By default, Log: is set to N (no). Typing Y (yes) in this field sends a copy of the output to the Log.

Note:    The Config window can be used to select a unique color for terminal output that is copied to the Log window.  [cautionend]

Display:
can be set to one of the following values:

Y (yes)
displays intercepted output in the Termout window. The output appears the next time that control is transferred to the debugger.

N (no)
does not display intercepted output in Termout window.

I (intercept)
displays intercepted output immediately. I is the default setting for the Display: field.

Regardless of whether Y or I is in effect, the debugger does not display intercepted output until there is a complete line, since line length is determined by the usable window area. A \ n in the output also completes a line.

Pause:
pauses the debugger if the output area is full and the debugger needs to output another line. By default, this field is set to Y (yes), which enables the pause feature; setting the field to N (no) disables the feature.

If the debugger is paused, you are notified of this state by the appearance of a flashing More... prompt on the first line of the Termout window. Pressing the ENTER key when the cursor is inside the Termout window causes the display to be cleared and the new line is displayed.

While the debugger is paused, you can move between windows and examine variables; however, you cannot issue any command that continues execution. Also, you cannot close the Termout window while the debugger is in the paused state. Pressing the ENTER key in the Termout window is the only way to cause the debugger to return control to the program to automatically continue execution. If you are intercepting output in the Termout window with pause in effect, then if there is any output that you have not seen at program completion time, the debugger stops to let you view it.

Scale:
displays a scale, or column ruler, on the second line of the Termout window. By default, this field is set to Y (yes), displaying the scale. If set to N (no), the scale is not displayed and that area becomes an additional line that is available for output. Changing the setting while output is displayed has the following effects:

Intercepting output When the appropriate settings are in effect (Intercept: Y, Display: Y or I), the Termout window is automatically opened whenever there is a complete line of output to be displayed. However, if it is not possible to open the window, the debugger stops the intercept.

If you do not want to intercept terminal output, change the default prompt settings by making the selections that you want in the Termout window and save the changes to your configuration file. Changes are saved with the config save command. See Setting Up a Configuration File for more information.

Clearing the Termout window The output area is cleared each time the window is opened. The window clear command also clears the output area.

Resizing the Termout window Resizing the window to a smaller width can cause data to be truncated on the right. Resizing to a larger size does not cause the truncated data to reappear. Furthermore, resizing the window to a smaller size can cause the output area to be cleared. If the resized window has fewer lines in the output area than are currently displayed, the output is cleared.

ADDITIONAL DISCUSSION
Looking at Terminal I/O

SEE ALSO
Termin Window


Chapter Contents

Previous

Next

Top of Page

Copyright © 2001 by SAS Institute Inc., Cary, NC, USA. All rights reserved.