z/VM Version 7 Release 1 VM Dump Tool IBM GC24-6335-00 Note: Before you use this information and the product it supports, read the information in “Notices” on page 247. This edition applies to version 7, release 1, modification 0 of the IBM z/VM (product number 5741-A09) and to all subsequent releases and modifications until otherwise indicated in new editions. Last updated: 2018-09-05 © Copyright International Business Machines Corporation 2001, 2018. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents List of Figures....................................................................................................... ix List of Tables........................................................................................................ xi About This Document..........................................................................................xiii Intended Audience.................................................................................................................................... xiii Syntax, Message, and Response Conventions..........................................................................................xiii How to Use the Online HELP Facility.........................................................................................................xvi Where to Find More Information...............................................................................................................xvi Links to Other Documents and Websites............................................................................................ xvi How to Send Your Comments to IBM................................................................... xvii Summary of Changes for z/VM VM Dump Tool.....................................................xviii GC24-6335-00, z/VM Version 7 Release 1.............................................................................................xviii Chapter 1. Introduction......................................................................................... 1 Major Functions............................................................................................................................................1 Formatting Dump Data........................................................................................................................... 1 Interactively Analyzing Dump Data........................................................................................................1 Types of Dumps the VM Dump Tool Processes........................................................................................... 1 Requirements for Using the VM Dump Tool................................................................................................ 1 Storage Requirements............................................................................................................................2 Causes for a Dump....................................................................................................................................... 2 Hardware-Initiated Dumps.................................................................................................................... 2 Software-Initiated Dumps......................................................................................................................2 User-Initiated Dumps.............................................................................................................................3 Location of a Dump...................................................................................................................................... 3 Use of Dump Information............................................................................................................................ 3 Problem Determination................................................................................................................................4 Problem Source Identification.....................................................................................................................4 Using Error Messages............................................................................................................................. 4 Using the Symptom Record to Identify Duplicate Problems.................................................................5 Commands of the VM Dump Tool................................................................................................................ 5 Pageable and Resident Modules................................................................................................................. 6 Servicing the VM Dump Tool........................................................................................................................ 6 Saving Dump Data to Tape...........................................................................................................................7 Chapter 2. Usage Guide......................................................................................... 9 Preparing a Dump for Use with the VM Dump Tool.....................................................................................9 Viewing Dumps.............................................................................................................................................9 Using the Session File.......................................................................................................................... 10 Analyzing Dumps....................................................................................................................................... 10 User Tailoring............................................................................................................................................. 10 Writing VMDUMPTL Macros....................................................................................................................... 10 Address Spaces and the VM Dump Tool....................................................................................................10 Scenario 1: Analyzing a CP FRE016 Abend Dump.................................................................................... 15 Step 1: Checking the Error Message and Symptom Record................................................................15 Step 2: Analyzing the Trace Table........................................................................................................16 Step 3: Summarizing the Dump Analysis.............................................................................................17 Scenario 2: Analyzing a PRG004 Abend Dump.........................................................................................18 Step 1: Checking the Error Message and Symptom Record................................................................18 Step 2: Checking the Symptom Record with the VM Dump Tool........................................................ 18 iii Step 3: Checking the Symptom Record for the Abend........................................................................19 Step 4: Analyzing the Trace Table........................................................................................................19 Step 5: Summarizing the Dump Analysis.............................................................................................21 Chapter 3. VM Dump Tool Subcommands and Macros............................................23 VMDUMPTL Command...............................................................................................................................25 ABSOLUTE Subcommand.......................................................................................................................... 28 ANALYZE Subcommand.............................................................................................................................29 AREGS Subcommand.................................................................................................................................30 BLOCK Macro............................................................................................................................................. 31 CALLERS Macro..........................................................................................................................................34 CCW Subcommand.................................................................................................................................... 36 CHAIN Subcommand.................................................................................................................................38 CLOCKS Subcommand...............................................................................................................................40 CMS Subcommand.....................................................................................................................................41 CODE Subcommand...................................................................................................................................42 CONSOLES Macro...................................................................................................................................... 43 CP Subcommand........................................................................................................................................45 CPEBK Subcommand.................................................................................................................................46