HP 3000 Manuals

D DEBUG command [ MPE Debug/Stack Dump Reference Manual ] MPE/iX 5.0 Documentation


MPE Debug/Stack Dump Reference Manual

D 
DEBUG command 

Displays memory contents of a specified number of locations relative to a
given code base or data base.

SYNTAX 

        D [ dispbase][ offset][ ,count] [ ,mode]

PARAMETERS 

dispbase         One of the following stack (data) relative display
                 bases:

                                            DB, DL, Q, S

                 or one of the following code relative display bases:

                                            PB, P, PL

                 If dispbase is omitted, DB is specified by default.
                 (Optional parameter.)

Privileged Mode 

Includes all of the above plus the following:

A                = Absolute Relative (base = location 0).

SY               = System Global Relative (base = system base).

CO               = Code Segment Relative (base = base of segment).

COX              = Program Logical Code Segment Relative (base = base of
                 segment).

DA               = Data Segment Relative (base = base of segment).

DX               = Current Absolute DB Relative (base = absolute DB).

EA               = Extended Absolute Address (base = bank specified).

The bank number in EA mode follows EA; for example:

D EA2+ 10        Displays one word at location 10 of bank 2.

For CO, COX, and DA, the segment and offset immediately follow the
mnemonic (CO, COX, or DA) unless it is an expression requiring a
calculation.  Expressions requiring calculation are enclosed in
parentheses; for example:

D DA22+ 6,6      Displays 6 words starting at location 6 of data segment
                 22.

D CO(4+ 6),3     Displays first 3 words of segment 12 (octal).

D COX12,3        Displays first 3 words of your program segment 12 (that
                 is, segment 11 from PMAP).

offset           The offset relative to the display base which specifies
                 the starting memory location of the area to be
                 displayed.  It is written in the following format:

                      [+] expression [ : [ [+] expression] ]

                 If no sign is given, positive offset is assumed.  If
                 expression is followed by a colon, indirect addressing
                 is indicated.  The indirect addressing is relative to
                 the specified dispbase or, if omitted, to DB for stack
                 relative display or PB for code relative display bases.

                 The first expression can be followed by an additional
                 offset expression.  For example:

                 D 6:+2           Display contents of address found by
                                  adding two words to address stored in
                                  DB+ 6.

                 Multiple levels of indirect are permitted.  For example:

                 D 6:+'Q+3':      Display contents of address found by
                                  adding address stored in Q+ 3 to
                                  address stored in DB+ 6.

                 If offset is omitted, location 0 is specified by
                 default.  (Optional parameter.)

count            An expression which defines the number of memory
                 locations to be displayed.  If omitted, count is
                 assigned a default value of 1.  (Optional parameter.)

mode             A one-character specifier to indicate the representation
                 mode for output values:  O for octal, I for decimal, H
                 for hexadecimal, A for ASCII or C for code.  When the C
                 specifier for mode is used, the actual octal content of
                 a location is displayed along with the code it
                 represents.  Note that all numbers in this code are
                 octal.  If omitted, default mode is octal.  (Optional
                 parameter.)

EXAMPLES 

     ?D5                        ?D Q+1:,A 
     DB+5            047516      DB+0      MA
     ?D 0-5                    ?D Q+1:,4,A 
     Q-5           177777        DB+0      MAIN'PROG
     ?D Q-5:                   D PB+4,C 
     DB+177777      000020       PB+4 045403       LOAD Q+3,X

Location DB + 5.  DB is assumed when dispbase omitted.

Location Q - 5.

Location pointed to by Q - 5.

One word in ASCII at location pointed to by Q+ 1.

Four ASCII words at location pointed to by Q+ 1.

Code at location PB+4.



MPE/iX 5.0 Documentation