Termout Window
![[IMAGE]](./images/02109952.gif)
-
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]](../common/images/cautend.gif)
-
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
Copyright © 2001
by SAS Institute Inc., Cary, NC, USA. All rights reserved.
