variables: "Set" variables

The following variables for the set subcommand have special meanings:

$asciichars

Any dbx operation that displays the value of a character will interpret the binary representation of the character as ASCII.

$asciistrings

Any dbx operation that displays the value of a string will interpret the binary representation of the string as ASCII.

$c<n>

Condition variables.

$catchbp

Catches breakpoints during the execution of the next command.

$charset="destCodePage,srcCodePage"

Converts character strings before displaying them. The character strings are converted from the code page srcCodePage to destCodePage. The destCodePage must be IBM-1047. The default setting is not to convert the character strings.

$commandedit

Enables the command-line facility.

$current

Defined as a constant with the value of the current thread.

$cv_events

Notifies the user but does not stop when a condition variable event is processed. The following trace information is sent to the user for the different events:

(dbx) cont
.
.
cv initialize, object=0x2e04567
cv wait, object=0x2e04567, mutex=0x2d04567, thid=0x0102030405060708
cv unwait, object=0x2e04567, mutex=0x2d04567, thid=0x0102030405060708
cv destroy, object=0x2e04567
.
.

$dll_loads

Set by default. dbx processes symbolics for DLLs as they are loaded.

$dll_loadstop

Set by default. dbx stops the function call that caused the DLL to be loaded. If the DLL was loaded due to a variable reference or an explicit load, dbx stops at the source line that caused the DLL to be loaded.

$expandunions

Displays values of each part of variant records or unions.

$expressionexhaustivesearch

Searches all scopes in a user's program to determine and verify the scope for an expression. Selecting this option might degrade performance.

$fl_precison

Determines the precision in bytes of floating-point registers when used in expressions, displays and during assignment. Valid values are 4, 8 or 16.

$fr<n>

Hexadecimal floating-point register.

$frb<n>

Binary floating-point register

$frd<n>

Decimal floating-point register

$hexchars

Prints characters as hexadecimal values.

$hexin

Input is interpreted in hexadecimal format.

Restriction: The $hexin variable is only supported in dbx command-line mode and does not affect the interpretation of GUI input. If the user of the GUI debugger wants input to be interpreted in hexadecimal format, the input must be prefixed with "0x".

$hexints

Prints integers in hexadecimal format instead of decimal format.

$historypage

Specifies the number of history items to be traversed when using the page up and page down keys.

$history_unique

Prevents consecutive duplicate commands from being saved to the history list.

$historywindow

Specifies the number of commands to display and retain in the history list.

$hold_next

Automatically holds all threads except the current thread during next, nexti, step or stepi command execution. If not set, all threads resume execution and might hit the breakpoint set by the next, nexti, step, or step command execution.

$l<n>

Read/write locks variables.

$listwindow

Specifies the number of lines to list around a function and to list when the list subcommand is used without parameters.

$lv_events

Notifies the user but does not stop when a read/write lock object event is processed. The following trace information is sent to the user for the different events:

(dbx) cont
.
.
lv initialize, object=0x2d04567
lv wait, object=0x2d04567, thid=0x0102030405060708
lv unwait, object=0x2d04567, thid=0x0102030405060708
lv lock, object=0x2d04567, thid=0x0102030405060708
lv unlock, object=0x2d04567, thid=0x0102030405060708
lv relock, object=0x2d04567, thid=0x0102030405060708
lv unrelock, object=0x2d04567, thid=0x0102030405060708
lv destroy, object=0x2d04567
.
.

$m<n>

Specifies mutex variables.

$maxstring

Specifies the maximum number of characters to be displayed when printing a string. String printing stops when $maxstring characters are printed. Set to zero to completely display strings. The default value is zero.

$mv_events

Notifies the user but does not stop when a mutex object event is processed. The following trace information is sent to the user for the different events:

(dbx) cont
.
.
mv initialize, object=0x2d04567
mv wait, object=0x2d04567, thid=0x0102030405060708
mv unwait, object=0x2d04567, thid=0x0102030405060708
mv lock, object=0x2d04567, thid=0x0102030405060708
mv unlock, object=0x2d04567, thid=0x0102030405060708
mv relock, object=0x2d04567, thid=0x0102030405060708
mv unrelock, object=0x2d04567, thid=0x0102030405060708
mv destroy, object=0x2d04567
.
.

$noargs

Omits arguments from subcommands, such as where, up, down, and dump.

$noflbregs

Does not display the binary floating point representation of the floating point registers with the registers subcommand.

$nofldregs

Does not display the decimal floating point representation of the floating point registers with the registers subcommand.

$noflregs

Does not display the hexadecimal floating point representation of the floating point registers with the registers subcommand.

$novregs

When set, omits the display of vector registers from the registers subcommand. End of change

$octin

Interprets input in octal format. The $octin variable is only supported in dbx command-line mode and does not affect the interpretation of GUI input. If the user of the GUI debugger wants input to be interpreted in octal format, the input must be prefixed with 0.

$octints

Prints integers in octal format.

$pc

Program counter register.

$psw

First word of the program status word register.

$psw0

First word of the program status word register.

$psw1

Second word of the program status word register.

$r<n>

General register.

$r_precision

Sets the amount of precision, in bytes, to use when displaying an integer value. Possible values are 4 and 8.

$repeat

Repeats the previous command if no command was entered.

$showbases

Displays the base class data when a derived class is printed.

$sigblock

Blocks all signals from reaching the program being debugged.

$sticky_debug

Recognizes sticky bit programs and DLLs in the loadmap.

$t<n>

Thread variables

$tv_events

Notifies the user but does not stop when a thread object event is processed. Trace information similar to the following example is sent to the user for the different events:

(dbx) cont
.
.
IPT create, thid=0x1234567890123456, stack=5200
IPT exit, thid=0x1234567890123456
tv create, thid=0x1234567890123456,  created thid=0x1234567890123422,
           stack=5200
tv created, thid=0x1234567890123456, stack=5200
tv exit, thid=0x1234567890123456
tv wait, thid=0x1234567890123456, joining thid=0x1234567890123422
tv unwait, thid=0x1234567890123456, joined thid=0x1234567890123422

$unsafeassign

Turns off strict type checking between the two sides of an assign subcommand.

$unsafebounds

Turns off subscript checking on arrays.

$unsafegoto

Turns off the goto subcommand destination checking.