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

Introduction
Debug Manual—421921-003
1-10
Ending a Debug Session
Ending a Debug Session
Two commands are provided for ending a Debug session: the STOP command and
the EXIT command.
•
The STOP command stops execution of the current process and deletes it.
•
The EXIT command clears all breakpoints and resumes execution of the current
process.
What Appears in the Debug Header Message
When a process enters Debug, regardless of the reason, Debug opens the home
terminal. If Debug cannot open the home terminal, the process stops unless it cannot
stop, in which case, it continues.
When Debug opens the home terminal, it prints a header message on the terminal.
The header message displays the current values of the P or PC and the ENV registers,
the current space identifier, and information as to why your process entered Debug.
These examples illustrate different Debug header messages:
DEBUG P=%001025, E=%000017, UC.%00 ! Gives current values of
101,01,00012- ! TNS environment P and ENV
! registers and space identifier.
DEBUG P=%037175, E=%000017, UC.%03 - TRAP #03 -!Process entered
Debug
099,00,00039- ! when it encountered
! a stack overflow.
Header Message Format
The format of the header message appears in the box below; the element descriptions
follow:
DEBUG {P=P-register, E=ENV-register, space-identifier}[ info
]
{PC=32-bit-address }
sys,cpu,pin [cmd]-