Debug Manual
Table Of Contents
- What’s New in This Manual
- About This Manual
- 1 Introduction
- Execution Modes on TNS/R Systems
- What User Access Is Required for Debugging
- How to Make a Process Enter Debug
- How to Select Debug as the Debugger
- Why a Process Enters Debug
- How to Determine Process State on a Trap or Signal
- Ending a Debug Session
- What Appears in the Debug Header Message
- How to Use Debug
- How Debug Breakpoints Work
- 2 Using Debug on TNS/R Processors
- 3 Debug Command Overview
- 4 Debug Commands
- Command Summary
- A Command
- AMAP Command
- B Command
- BASE Command
- BM Command
- C Command
- CM Command
- D Command
- DJ Command
- DN Command
- EX[IT] Command
- F[ILES] Command
- FC Command
- FN Command
- FNL Command
- FREEZE Command
- HALT Command
- H[ELP] Command
- I Command
- IH Command (TNS/R Native and OSS Processes)
- INSPECT Command
- LMAP Command
- M Command
- MH Command (TNS/R Native and OSS Processes)
- P[AUSE] Command
- PMAP Command (Accelerated Programs)
- PRV Command
- R Command
- S[TOP] Command
- T Command
- V Command
- VQ Command
- VQA Command
- = Command
- ? Command
- A Error Messages
- B ASCII Character Set
- C Command Syntax Summary
- Register Syntax
- Expression Syntax
- Address Syntax
- A Command
- AMAP Command
- B Command
- BASE Command
- BM Command
- C Command
- CM Command
- D Command
- DJ Command
- DN Command
- EX[IT] Command
- F[ILES] Command
- FC Command
- FN Command
- FNL Command
- FREEZE Command
- HALT Command
- H[ELP] Command
- I Command
- IH Command
- INSPECT Command
- LMAP Command
- M Command
- MH Command
- Output-Device Syntax
- P[AUSE] Command
- PMAP Command
- PRV Command
- R Command
- S[TOP] Command
- T Command
- V Command
- VQ Command
- VQA Command
- = Command
- ? Command
- D Session Boundaries
- E Correspondence Between Debug and Inspect Commands
- F Sample Debug Sessions
- Glossary
- Index

Debug Command Overview
Debug Manual—421921-003
3-4
Modify Commands
Modify Commands
The modify commands are listed in Table 3-3.
PMAP Print code
map
Display corresponding
blocks of TNS and
RISC code
Displays the contents of specified
memory as TNS code and
corresponding RISC code for
accelerated programs.
T Trace Trace stack markers Displays key attributes of the
process’s stack frames (procedure
activations), up to ten at a time.
= Equal Compute a value Computes and displays the value of
an expression in decimal,
hexadecimal, octal, binary, ASCII, or
instruction code. Translates and
displays an expression as both forms
of the ENV register: the hardware
ENV register and the stack marker
ENV register.
Table 3-3. Modify Commands
Command Meaning Function Description
M Modify Modify data Modifies the contents of specified
variables.
Modify register
contents
Modifies the contents of a specified
register.
Modify space identifier Modifies the current space identifier in
order to cause a different code segment
to become the current code segment.
MH Modify
handling
Modify signal handling Modifies signal handling by associating a
new signal handler or signal action with
a signal.
Note. You can change the current location of a process running in TNS or accelerated mode
by modifying the value of the P register. If the process is a multiple-segment process, you must
also change the space identifier. You change the space identifier in order to change the
location of the process to a different code segment. It is also possible to change the current
location of a process running in native mode, but doing so requires knowledge of native mode
internals and is beyond the scope of this manual.
Table 3-2. Display Commands (page 2 of 2)
Command Meaning Function Description