set subcommand for dbx: Define a value for a dbx variable

Format

set [variable=expression]

Description

The set subcommand defines a value, which is specified by the expression argument, for the dbx debug program variable, which is specified by the variable argument. The name of the variable must not conflict with names in the program being debugged. A variable is expanded to the corresponding expression within other commands. If the set subcommand is used without arguments, the variables currently set are displayed.

Variables

The following variables are set with the set subcommand:

$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

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 focus 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. When set, dbx processes symbolics for DLLs as they are loaded.

$dll_loadstop

Set by default. When set, 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.

$flprecision

Determines the precision in bytes of floating-point registers when the values of the register are displayed; for example, in expressions or 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 in hexadecimal format.

$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 decimal format instead of hexadecimal 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 focus thread during the next, nexti, step, or stepi command execution. If not set, all threads resume execution and may reach the breakpoint set by the next, nexti, step, or stepi 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

When set, dbx 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

When set, dbx 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.

$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.

$showcodelines

Indicates the lines where the debugger can stop and where breakpoints can be set.

$sigblock

Blocks all signals from reaching the program being debugged.

$sticky_debug

When set, dbx will recognize 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.

Usage notes

The $unsafe variables limit the usefulness of the dbx debug program in detecting errors.
The set subcommand can be run only while the dbx debug program is running.

Examples

To change the default number of lines to be listed to 20, enter:
```
set $listwindow=20
```
To disable type checking on the assign subcommand, enter:
```
set $unsafeassign
```

Related information

The unset subcommand.