Command Considerations › Expression Components › Debugger Symbols

Debugger Symbols

Three Categories

Debugger symbols can:

• Designate general registers
• Designate certain DC/UCF system entities
• Point to specific addresses

Address Symbols and Markers

Three special characters can be used in debugger expressions to address particular locations in a program or dialog:

Each type of location is described separately below.

Absolute Address

The at sign (@) functions as the debugger marker that prefaces an absolute address notation. An absolute address cannot exceed eight digits.

Syntax for the marker is shown below:

►►─── @ hex-value ────────────────────────────────────────────────────────────►◄

In a debug expression, @hex-value can be used interchangeably with the address notation Xhex-value. For example, an absolute address could be represented as @2B90 or X'002B90'; an offset value could be represented as +@C0 or +X'C0'.

For more information about the hexadecimal values recognized by the debugger, see Data Values.

Load Address

The dollar sign ($) functions as the debugger label that expresses the load address of the current program. In a command that uses debug expressions, the dollar sign ($) can be used by itself or in combination with other expression components.

This example illustrates the use of the dollar sign ($) in an expression requesting a display of the current CSECT address:

list $

This example sets a breakpoint at an offset address 16 bytes from the load address:

at $ + @10

Address of Current Dialog Process

The cent sign (¢) functions as the debugger label that expresses the address of the current dialog process. In a command that uses debug expressions, the cent sign (¢) can be used by itself or in combination with other expression components.

This example illustrates the use of the cent sign (¢) to request the load address of the current dialog process:

list &cent.