Chapter Contents

Command Directory

auto

Set Debugger Modes

ABBREVIATION

au{to}

auto KEYWORD KEYWORD . . .

DESCRIPTION

The auto command is used to specify several characteristics of output produced by the debugger. The auto KEYWORDs are as follows:

c{macros}/noc{macros} Default: nocmacros

When the debugger evaluates expressions in commands, macros defined in your program and used in those expressions can be substituted with their text. To do macro substitution in expressions, you must first set the cmacros keyword. You must also have compiled your program with the dbgmacros option (Compiler Options). This keyword affects all debugger commands that use expressions except the whatis command.

c{xx}/noc{xx} Default: nocxx

If you issue an auto cxx command, the debugger automatically saves the current status of auto command's extname keyword and turns on auto extname. When auto cxx is turned off, the most recently saved value of extname is restored. auto extname cannot be turned off while auto cxx is on. The query command displays the state of the cxx keyword. The transfer command supports the cxx keyword. If all auto command settings are transferred, cxx appears between extname and linesize. The minimum lengths you can specify for the cmacros and nocmancros keywords of the autos command are now two and four, respectively.

d{umpabs}/nod{umpabs} Default: nodumpabs

The dumpabs keyword controls the method of addressing used in output from the dump command. Relative addressing is the default, which is selected by the nodumpabs keyword. Absolute addressing is selected by the dumpabs keyword. The method of displaying addresses is affected regardless of whether the dump command output is displayed in the Log window or directed to the Dump window.

{e}cho/{noe}cho Default: noecho

The echo keyword echoes debugger commands (except for break and trace used with no arguments) in an on command's list. The echo keyword is used following the auto command in an on command's CMD-LIST. Subsequent commands in the CMD-LIST are then echoed. Similarly, the noecho keyword is used to turn off echoing of subsequent commands in a CMD-LIST.

ex{ececho}/noex{ececho} Default: noexececho

The exececho keyword 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.

ext{name}/noext{name} Default: noextname

The extname keyword selects extended name support. If selected, function names used with commands such as break, on, and trace can 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 extname compiler option. Refer to the SAS/C Compiler and Library User's Guide for additional information about extended name support.

The default setting, noextname, 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 query command shows the function names as installed.

i{d}/noi{d} Default: id

These keywords determine whether a line is produced for on commands. The noid keyword suppresses both a trace and a source line. For id, the type of line that you receive depends on whether you also specified list or nolist. The nolist keyword produces a trace line; list (the default) produces a source line. However, because the on command generates an output line before executing its CMD-LIST, id or noid 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.

lin{esize} nnn Default: 75

The linesize keyword 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. nnn must specify between 40 and 251 characters (TSO) or between 40 and 130 characters (CMS, OS/390 batch), inclusive. Nonsource lines greater than the linesize value are wrapped. For source lines, see the wrap keyword.

lis{t}/nol{ist} Default: list

In line mode, the list or nolist keywords determine the type of identifying line that the debugger outputs, either when the user gains control due to a break, step, continue, or on command or as the result of executing a trace or on command. (The list and nolist keywords are ignored in full-screen mode.) The list keyword produces a listing line; the nolist keyword produces a trace line.

The list or nolist keywords can be used with the auto command in the CMD-LIST of an on command. However, because the on command generates an output line before executing its CMD-LIST, list/nolist 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 trace 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.

n{ullptr}/non{ullptr} Default: nonullptr

The nullptr keyword enables you to dereference null pointers. These keywords affect expressions that are used in debugger commands.

w{rap}/now{rap} Default: wrap

In line mode, the wrap and nowrap keywords only affect the way the debugger displays output source lines. The wrap keyword wraps an output source line greater in length than specified by the linesize keyword to the next line. The nowrap keyword truncates the line at the line length specified by the linesize keyword 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, id).

The query command can be used to check the settings of the auto command keywords.

auto linesize 100: displays 100 characters on each debugger output line.
auto echo: turns on echoing of debugger commands.
auto cmacros nullptr: substitutes macros in expressions; allows dereferencing of null pointers.

SYSTEM DEPENDENCIES

See the discussion of the linesize keyword earlier in this section.

COMMAND CAN BE ISSUED FROM

PROFILE yes

configuration file no

Source window prefix none

The auto command is not affected by changes in scope.

RETURN CODES SET

	Successful: 0
	Unsuccessful: 1

Chapter Contents
Previous
Next
Top of Page

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