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 Commands
Debug Manual—421921-003
4-46
F[ILES] Command
F[ILES] Command
The FILES (or F) command displays the file name and the latest file-management error
number associated with an open file. The form of the FILES command is:
file-number
is a 16-bit word expression representing the file number returned from the open
operation on the file whose information is to be displayed.
The value -1 causes Debug to display the error associated with the last open,
create, purge, or AWAITIO operation that failed.
If you omit file-number, Debug displays the file number and other information
for all of the process’s open files.
The FILES command displays the file information in this form:
F[ILES] [ file-number ]
[ file-number ] { file-name } error [ suberror ]
{?file-name }
{ ??? }
file-number is displayed in decimal only for currently open files. The file
number is displayed only if you enter the FILES command
without file-number (to display all files).
File number -1 denotes the current error and detail information,
which appears in the first line in the display.
file-name is displayed as a fully qualified external file name for file names
available to Debug.
?file-name a question mark displayed in front of the file name indicates that
the current name is unavailable. The displayed name is the
originally opened name, which can occur, for example, if a
remote disk file is open and the network goes down.
??? is displayed if the file name is not available to Debug.
error is displayed in decimal as a 6-digit signed integer.
suberror is a detail error value displayed in decimal only for values other
than zero.