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
Sample Debug Sessions
Debug Manual—421921-003
F-50
Privileged Commands
The current setting of PRV can be viewed with the ? command. Also, when PRV is set,
additional segments are shown.
Address Range Limitation
Certain address ranges are not allowed for a command when PRV is set to OFF.
Following are two examples of this:
Finding information in the process control block (PCB) involves accessing addresses
that require the privileged mode to be turned on (the use of the PRV or PRV ON
USE SEGMENT ID = %002000
BASE STANDARD IN
BASE STANDARD OUT
TERM \M5.$ZTN00.#PTYX5AA
PRV = ON
050,03,00010-D G 123I, T#8*#12 :h
%155457: 0xFFFF 0x0000 0x0000 0x0000 0x0000 0x0000 0x0000 0x0000
%155467: 0x0000 0x0000 0x0000 0x0000 0x0000 0x0000 0x0000 0x0000
%155477: 0x0000 0x0000 0x0000 0x0000 0x0000 0x0000 0xFFFF 0x0000
%155507: 0xFFFF 0x0000 0x0000 0x0000 0x0000 0x0000 0x0000 0x0000
%155517: 0x0000 0x0000 0x0000 0x0000 0x0000 0x0000 0x0000 0x0000
%155527: 0x0000 0x0000 0x0000 0x0000 0x0000 0x0000 0xFFFF 0x0000
%155537: 0xFFFF 0x0000 0x0000 0x0000 0x0000 0x0000 0x0000 0x0000
%155547: 0x0000 0x0000 0x0000 0x0000 0x0000 0x0000 0x0000 0x0000
%155557: 0x0000 0x0000 0x0000 0x0000 0x0000 0x0000 0xFFFF 0x0000
%155567: 0xFFFF 0x0000 0x0000 0x0000 0x0000 0x0000 0x0000 0x0000
%155577: 0x0000 0x0000 0x0000 0x0000 0x0000 0x0000 0x0000 0x0000
%155607: 0x0000 0x0000 0x0000 0x0000 0x0000 0x0000 0xFFFF 0x0000
050,03,00010-amap G 123I
** DEBUG error 7: PRV ON is required to perform command.
050,03,00010-PRV
050,03,00010-amap G 123I
Address: 0x8003B65E
Kind = 0x0013: Unknown
Attributes: Priv To Read, Priv To Write
050,03,00010-PRV OFF
050,03,00010-DN 0x8003B65E, #24 by 4 :h
** DEBUG error 7: PRV ON is required to perform command.
050,03,00010-prv on
050,03,00010-DN 0x8003B65E, #24 by 4 :h
8003B65E: 0xFFFF0000 0x00000000 0x00000000 0x00000000
8003B66E: 0x00000000 0x00000000 0x00000000 0x00000000
8003B67E: 0x00000000 0x00000000 0x00000000 0xFFFF0000
8003B68E: 0xFFFF0000 0x00000000 0x00000000 0x00000000
8003B69E: 0x00000000 0x00000000 0x00000000 0x00000000
8003B6AE: 0x00000000 0x00000000 0x00000000 0xFFFF0000
Note. To turn PRV mode on, we can enter only PRV, not PRV ON. For the remainder of the
example, we use only PRV.