Set Debugger Modes
autoKEYWORD KEYWORD . . .
autocommand is used to specify several characteristics of output produced by the debugger. The
autoKEYWORDs are as follows:
cmacroskeyword. You must also have compiled your program with the
dbgmacrosoption (Compiler Options). This keyword affects all debugger commands that use expressions except the
auto cxxcommand, the debugger automatically saves the current status of
extnamekeyword and turns on
auto extname. When
auto cxxis turned off, the most recently saved value of
auto extname cannot be turned off while
auto cxxis on. The
querycommand displays the state of the
transfercommand supports the
cxxkeyword. If all
autocommand settings are transferred,
linesize. The minimum lengths you can specify for the
nocmancroskeywords of the
autoscommand are now two and four, respectively.
dumpabskeyword controls the method of addressing used in output from the
dumpcommand. Relative addressing is the default, which is selected by the
nodumpabskeyword. Absolute addressing is selected by the
dumpabskeyword. The method of displaying addresses is affected regardless of whether the
dumpcommand output is displayed in the Log window or directed to the Dump window.
echokeyword echoes debugger commands (except for
traceused with no arguments) in an
oncommand's list. The
echokeyword is used following the
autocommand in an
oncommand's CMD-LIST. Subsequent commands in the CMD-LIST are then echoed. Similarly, the
noechokeyword is used to turn off echoing of subsequent commands in a CMD-LIST.
execechokeyword echoes each line of the EXEC or TSO CLIST, supplied to the debugger by the subcomm interface (used by the debugger to communicate with the EXEC or CLIST) before the debugger parses and executes the line. This echoing behavior occurs both in line mode and full-screen mode. In line mode, the line goes through the normal ouput interface; in full-screen mode, it appears in the Log window.
extnamekeyword selects extended name support. If selected, function names used with commands such as
tracecan be as long as 255 mixed-case characters. This enables the debugger to use extended names that are contained in the debugger symbol table associated with modules that have been compiled with the
extnamecompiler option. Refer to the SAS/C Compiler and Library User's Guide for additional information about extended name support.
The default setting,
limits function names to eight characters. Also, with the default setting,
function names that are eight characters or less in length and do not contain
any uppercase characters are converted to all uppercase when they are issued
as part of a debugger command.
Changing this keyword during a session only affects
requests that are installed after the change is made. Previously issued requests
are not affected. The output from the
command shows the function names as installed.
noidkeyword suppresses both a trace and a source line. For
id, the type of line that you receive depends on whether you also specified
nolistkeyword produces a trace line;
list(the default) produces a source line. However, because the
oncommand generates an output line before executing its CMD-LIST,
noidin the CMD-LIST does not affect the format of the current output line, but it is in effect the next time a breakpoint is hit.
linesizekeyword sets the line size of debugger output to the value specified by
nnn. By default, the debugger displays, at most, 75 characters on each output line.
nnnmust specify between 40 and 251 characters (TSO) or between 40 and 130 characters (CMS, OS/390 batch), inclusive. Nonsource lines greater than the
linesizevalue are wrapped. For source lines, see the wrap keyword.
nolistkeywords determine the type of identifying line that the debugger outputs, either when the user gains control due to a
oncommand or as the result of executing a
nolistkeywords are ignored in full-screen mode.) The
listkeyword produces a listing line; the
nolistkeyword produces a trace line.
nolist keywords can be used with the
command in the CMD-LIST of an
on command. However,
on command generates an output
line before executing its CMD-LIST,
in the CMD-LIST does not affect the format of the current output line, but
it is in effect the next time a breakpoint is hit.
If the CMD-LIST contains the
command, the format of the output line may be changed, depending on whether
a line was generated when the
on command took
effect and the line's format.
nullptrkeyword enables you to dereference null pointers. These keywords affect expressions that are used in debugger commands.
nowrapkeywords only affect the way the debugger displays output source lines. The
wrapkeyword wraps an output source line greater in length than specified by the
linesizekeyword to the next line. The
nowrapkeyword truncates the line at the line length specified by the
linesizekeyword or at the default line length of 75.
If you specify conflicting keywords referring to the
same option (such as
auto noid id ), the last
keyword of the pair goes into effect (in this case,
query command can
be used to check the settings of the
linesizekeyword earlier in this section.
|Source window prefix||none|
autocommand is not affected by changes in scope.
Top of Page
Copyright © 2001 by SAS Institute Inc., Cary, NC, USA. All rights reserved.