Technical data

System Dump Analyzer

EXAMINE

Displays either the contents of a location or range of locations in physical memory,

or the contents of a register. You can use location parameters to display speciﬁc

locations or use qualiﬁers to display entire process and system regions of memory.

Format

EXAMINE [/qualiﬁer[,...]] [location]

Parameter

location

Location in memory to be examined. You can represent a location by any valid

SDA expression (see Section 7.2). To examine a range of locations, use the

following format:

m:n Range of locations to be examined, from m to n

m;n Range of locations to be examined, starting at m and continuing for n

bytes

The default location that SDA uses is initially 0 in the program region (P0) of

either of the following:

• The process that was executing at the time the system failed (if you are

examining a crash dump)

• Your process (if you are examining the running system)

Subsequent uses of the EXAMINE command with no parameter speciﬁed increase

the last address examined by 4. Use of the /INSTRUCTION qualiﬁer increases

the default address as appropriate to the translation of the instruction. To

examine memory locations of other processes, you must use the SET PROCESS

command.

Qualiﬁers

/ALL

Examines all the locations in the program and control regions and parts of

the writable system region, displaying the contents of memory in hexadecimal

longwords. Do not specify parameters when you use this qualiﬁer.

/CONDITION_VALUE

Examines the speciﬁed longword, displaying the message the $GETMSG system

service obtains for the value in the longword.

/INSTRUCTION

Translates the contents of the speciﬁed range of memory locations into

MACRO instruction format. If more than 16 bytes are speciﬁed in the range,

/INSTRUCTION processing might skip some bytes at the beginning of the range

to ensure that SDA is properly synchronized with the start of each instruction.

You can override this synchronization by specifying the /NOSKIP qualiﬁer.

The length of the instruction displayed varies according to the opcode and

addressing mode. If SDA cannot decode a memory location, it issues the following

message:

SDA–53