CONTENTS

  Title Page

  Copyright Page

  Preface

  SDA DESCRIPTION

  1       System Management and SDA
    1.1        The System Dump File
      1.1.1        Dump File Style
    1.2        Saving System Dumps
    1.3        Invoking SDA in the Site-Specific Startup Command Procedure

  2       Analyzing a System Dump
    2.1        Requirements
    2.2        Invoking SDA
    2.3        Mapping the Contents of the Dump File
    2.4        Building the SDA Symbol Table
    2.5        Executing the SDA Initialization File (SDA$INIT)

  3       Analyzing a Running System

  4       SDA Context

  5       SDA Command Format
    5.1        General Command Format
    5.2        Expressions
      5.2.1        Radix Operators
      5.2.2        Arithmetic and Logical Operators
      5.2.3        Precedence Operators
      5.2.4        Symbols

  6       Investigating System Failures
    6.1        General Procedure for Analyzing System Failures
    6.2        Fatal Bugcheck Conditions
      6.2.1        Fatal Exceptions
      6.2.2        Illegal Page Faults

  7       A Sample System Failure
    7.1        Identifying the Bugcheck
    7.2        Identifying the Exception
    7.3        Locating the Source of the Exception
      7.3.1        Finding the Driver by Using the Program Counter
      7.3.2        Calculating the Offset into the Driver's Program Section
    7.4        Finding the Problem Within the Routine
      7.4.1        Examining the Routine
      7.4.2        Checking the Values of Key Variables
      7.4.3        Identifying and Fixing the Defective Code

  8       Inducing a System Failure
    8.1        Meeting Crash Dump Requirements
    8.2        Examples of How to Cause System Failures

  SDA USAGE SUMMARY

  SDA QUALIFIERS
    /CRASH_DUMP
    /RELEASE
    /SYMBOL
    /SYSTEM

  SDA COMMANDS
    @ (Execute Procedure)
    ATTACH
    COPY
    DEFINE
    EVALUATE
    EXAMINE
    EXIT
    FORMAT
    HELP
    READ
    REPEAT
    SEARCH
    SET CPU
    SET LOG
    SET OUTPUT
    SET PROCESS
    SET RMS
    SHOW CALL_FRAME
    SHOW CLUSTER
    SHOW CONNECTIONS
    SHOW CPU
    SHOW CRASH
    SHOW DEVICE
    SHOW EXECUTIVE
    SHOW HEADER
    SHOW LAN
    SHOW LOCK
    SHOW LOGS
    SHOW PAGE_TABLE
    SHOW PFN_DATA
    SHOW POOL
    SHOW PORTS
    SHOW PROCESS
    SHOW RESOURCE
    SHOW RMS
    SHOW RSPID
    SHOW SPINLOCKS
    SHOW STACK
    SHOW SUMMARY
    SHOW SYMBOL
    SHOW TRANSACTIONS
    SPAWN
    VALIDATE QUEUE

  FIGURES

  SDA-1     Pointer Argument List on the Stack

  SDA-2     Mechanism Array

  SDA-3     Signal Array

  SDA-4     Stack Following an Illegal Page-Fault Error

  SDA-5     Call Frame

  TABLES

  SDA-1     Comparison of Full and Subset Dump Files

  SDA-2     SDA Operators

  SDA-3     SDA Symbols

  SDA-4     Modules Containing Global Symbols Used by SDA

  SDA-5     Modules Defining Global Locations Within the Executive Image

  SDA-6     SET RMS Command Keywords for Displaying Process RMS Information

  SDA-7     Contents of the SHOW LOCK and SHOW PROCESS/LOCKS Displays

  SDA-8     Virtual Page Information in the SHOW PAGE_TABLE Display

  SDA-9     Physical Page Information in the SHOW PAGE_TABLE Display

  SDA-10    Page Frame Number Information in the SHOW PFN_DATA Display

  SDA-11    Process Section Table Entry Information in the SHOW PROCESS Display

  SDA-12    Process I/O Channel Information in the SHOW PROCESS Display

  SDA-13    Resource Information in the SHOW RESOURCE Display

  SDA-14    Static Spin Locks

  SDA-15    Process Information in the SHOW SUMMARY Display