DUMPANALYZER

Table of Contents

General Information
DUMPANALYZER Files
Family Substitution
Saved Memory Dumps
Analysis of Memory Resident Information
Compatibility of MCP, DUMPANALYZER and SDASUPPORT Levels
Sensitive Memory Area Dumps
Running DUMPANALYZER
Remote Operation
ODT Operation
Batch Operation
User Library Interface for DUMPANALYZER
Entry Points for the User Library Interface
Analyzing Program Dumps
Basic Constructs
Number
File Title
Simple Address
Multiple Addresses
Simple Value
DUMPANALYZER Commands
AREAS (Memory Areas)
ARRAYLIMIT (Array Limit)
ASD (Actual Segment Descriptor)
ASDNUMBER (Actual Segment Descriptor Number)
BOXINFO (Box Information Array)
BYE (Stop DUMPANALYZER)
CB (Connection Block)
CODEFILE (Code File or Disk Family Name)
COREMAP (Memory Analysis)
CTRACE (Controller Trace Table Analysis)
CU (Core Utilization)
DC (Data Communications)
DCTRACE (Data Comm Trace)
DEADLOCK (Lock Analysis)
DEBUG (Debug Option)
DESCANAL (Descriptor Analysis)
DISKFILE (Disk Output File)
FIB (File Information Block)
FILELOCKS (File Region Locks)
FINDSTACKS (Find Stacks)
GC (Group Configuration)
GRAPHS (Graph Stacks)
HARDINFO (Hardware Information)
HDR (Disk File Header)
HEADING (Heading Page)
HEAP (Heap Analysis)
HEAPSTACK (Heap Stack Analysis)
HELP (Help Information)
HISTORY (History Command)
IO (I/O Analysis)
IOCB (I/O Control Block)
IOCD (Direct I/O Control Block)
IOTRACE (I/O Trace Table)
JOB (Job Command)
KEEP (Keep Command)
LIB (Library)
LINKCHECK (Check Memory Link)
LINKS (Memory Links)
LOADXREF (Load Cross-Reference Files)
LOCKS (Lock Analysis)
LOGRECORD (Log Record Analysis)
LSN (Analyze Datacom Station)
MASK (Mask Register)
MAXPRINTSIZE (MAXPRINT)
MD (Memory Dump)
MEM (Memory)
MEMPOOL (Analyze Memory Pool)
MEMRQ (Memory Result Queue)
MESSAGES (Data Comm Messages)
MIT (Mirror Information Table)
MIX (Mix Number)
MODE (Set Mode)
MSCW (Mark Stack Control Word)
NAMES (MCP Names and Addresses)
NSP (Network Support Processor Tables)
OLAYINFO (Overlay File Allocation)
OPT (Option)
PATTERN (Pattern Register)
PC or PRINTCODE (Print Mnemonic)
PIB (Process Information Block)
PMQ (Primitive Message Queue)
POOL (Analyze Pool Area)
PORT (Port File)
PRIMITIVEDUMP (Primitive Dump Analysis)
PRINTARRAY (Print Array)
PRINTER (Printer Route)
PRINTHEAP (Print Heap)
PROCSTACKS (Processor Stacks)
PROGRAMDUMP (Program Dump)
PV or PRINTVAL (Print Value)
QUEUE (DCALGOL Queue)
RCWTOSEQ (Convert RCW Into Sequence Number)
READYQ (Ready Queue)
RECESS (Recess DUMPANALYZER)
RELEASE (Release File)
RELX (Release Now)
REMOTE (Remote Terminal)
REPEAT (Repeat Command)
RESULTQ (Result Queue)
SAVE (Save to Disk)
SB (Structure Block)
SCRUB (Scrub Sensitive Memory Areas)
SEARCH (Search for Pattern)
SF (System Factors)
SFV (System File Vector)
SHAREDBUFF (Shared Buffers)
SHOW (Show Previous Input)
SSAQ (Storesafe Alert Queue)
STACK (Format Stack Contents)
STACKWINDOW (Stack Window)
STOP (Stop DUMPANALYZER)
SUBPORT (Subport Analysis)
SUMMARY (Summarize Stack Information)
TAB (Task Attribute Block)
TCPINFO (Task Control Processor Information—IOM Systems)
TERMINAL (Terminal Characteristics)
TRACE (Trace Table)
USE (Use Saved Commands)
USERCOMMAND Command
USERLIB (User Library Command)
UTILIZATION (System Utilization Statistics)
WHERE (Show Global Identifier)
WHO (Show D[0] Global Identifier)
@ (Last Referenced Stack)
$ (Last Referenced Segment)
?AX BRK (Interactive Break)
Error Messages

The DUMPANALYZER utility enables you to analyze either a memory dump or a program dump. You can enter DUMPANALYZER commands in either interactive or batch mode. You can use the full set of DUMPANALYZER commands to analyze a memory dump, whereas you can use only a subset of the commands to analyze a program dump. For a list of the commands that you can use with program dumps, refer to “Analyzing Program Dumps” later in this section.

A memory dump can be created as a COMPLETE, ALLINUSE, or PARTIAL dump. A COMPLETE dump contains the entire memory image. An ALLINUSE dump contains only those areas of memory that are in use at the time of the dump. A PARTIAL dump is a subset of an ALLINUSE dump. By default, the PARTIAL dump includes the following areas:

  • The dumping stack and all the areas owned by the stack.

  • The area occupied by all the stacks in a running system, that is, the area from the bottom-of-stack register (BOSR) to the limit-of-stack register (LOSR) of each stack.

  • All the areas owned by the MCP.

  • The ASD tables.

  • Any stack and its associated areas that are linked into the dumping stack's GRAPHHEADWORD, PROCESSFAMILYLINK, or both.

  • For systems that include task control processors (TCPs), some relevant TCP state information. This information includes events and approximately 93 words of statistical data for each stack being dumped.

Refer to the MDT (Memory Dump Type) command in the System Commands Operations Reference Manual for information about creating a memory dump.

A program dump is a dump of memory that was used by a particular program, and optionally, memory areas used by or associated with that program.

Multiple-processor systems and single-processor systems perform memory dumps in the same manner. When one processor of a multiple-processor system performs a memory dump, the stacks of all the processors in that system are also dumped.

Note that DUMPANALYZER requires the presence of the SDASUPPORT system library to help analyze both memory dumps and program dumps.