registers subcommand for dbx: Display the value of registers

Format

registers [>file]

Description

The registers subcommand displays the values of general-purpose registers, system control registers, floating-point registers, and the current instruction register, such as the program status word (PSW) for z/OS.

General-purpose registers are denoted by the $rnumber variable, where the number argument indicates the number of the register.
Floating-point registers are denoted by the $frnumber variable. By default, the floating-point registers are not displayed. To display the floating-point registers, use the unset $noflregs dbx subcommand.
Vector registers can be displayed or assigned individually by vector element type using the following predefined register names:
- $vr0 through $vr31, for vector registers of type vector int.
- $vr0c through $vr31c, for vector char.
- $vr0s through $vr31s, for vector short.
Assigning a vector register can either be done a whole register at a time, for example, assign $vr0 = $vr31, or must be done an individual element at a time, using array subscripts. For example, to assign the third short element of vr15, assign $vr15s[2] = <expression>. To assign the sixteenth character element of vr30, assign $vr30c[15]=<expression>.

Options

>file: Redirects output to the specified file.

Usage notes for the registers subcommand of dbx

The registers subcommand can be run only while the dbx debug program is running.
Vector registers can be displayed or assigned individually by vector element type using the following predefined register names:
- $vr0 through $vr31, for vector registers of type vector int
- $vr0c through $vr31c, for vector char
- $vr0s through $vr31s, for vector short
Assigning a vector register can either be done a whole register at a time, for example, assign $vr0 = $vr31, or must be done an individual element at a time, using array subscripts. For example, to assign the third short element of vr15, assign $vr15s[2] = <expression>.

Examples

To display the registers, enter:

registers

Related information

The set and unset subcommands.