Improved IPL Performance Using a Saved System ...................................... 420 The Programmable Operator Facility .••.••••..•••.•..•..••.•••....••.•.•.••..•.•.•.•. 422
Overview ...................................................................... 422
The Routing Table .............................................................. 425
How the Programmable Operator Facility Uses the Routing Table ....................... 425
Routing Table Entry Formats ................................................... 425
Tailoring the Routing Table ..................................................... 432
Action Routines ................................................................ 438
Description of Supplied Action Routines ........................................... 438
The Log File ................................................................... 441
Ensuring a Complete Log ...................................................... 442
The Feedback File .............................................................. 443
Installing the Programmable Operator Facility ......................................... 443
Routing Table Conversion ........................................................ 444
Invoking the Programmable Operator Facility ......................................... 445
Manual Invocation ............................................................ 445
Automatic Invocation ......................................................... 447
Communications Checking ........................................................ 448
How the Programmable Operator Establishes Communications with IUCV ................... 449
Message Output Format .......................................................... 450 Exit EXECs ................................................................... 451
Exit EXEC Interface .......................................................... 451
Communication Error Exit ..................................................... 451 LOG Error Exit .............................................................. 451
Problem Determination -Debug Mode ............................................... 452
The Action Routine Interface ...................................................... 453
Action Routine Call Interface ................................................... 453
Action Routine Parameter Interface .............................................. 453
EXEC Action Routines ........................................................ 455
Writing Action Routines ....................................................... 455
Handling Console I/O in an Action Routine ........................................ 456
Auxiliary Directories ••...•..•.•.•.•.•.•••..•.•••••••..•.••...••.•.•••.•..••.•..•• 458
How To Add an Auxiliary Directory ................................................. 458
Generation of the Auxiliary Directory ............................................. 458
Initializing the Auxiliary Directory ............................................... 458
Establishing the Proper Linkage ................................................. 459
An Example of Creating an Auxiliary Directory ........................................ 460 Assembler Virtual Storage Requirements •.•••...•..••••••.•..•..•..•...•.•.••...•••••. 462 Overlay Structures .............................................................. 462
Pre structured Overlay ......................................................... 462
Dynamic Load Overlay ........................................................ 464
Part 3. Debugging with VM/SP ••.•••..•••....•••...••..•..•••.•.•..•.••.••••••...•• 465
Introduction to Debugging ..••.••.••••....••••...•...•..•••.••••.•••..••.••..•••.•• 466
How To Start Debugging ......................................................... 466
Does a Problem Exist? ......................................................... 466
Identifying the Problem ........................................................ 469
Analyzing the Problem ........................................................ 470 How To Use VM/SP Facilities To Debug ............................................ 475
Abend ..................................................................... 475
Unexpected Results ........................................................... 482
Loop ...................................................................... 483
Wait ....................................................................... 485
Summary of VM/SP Debugging Tools ............................................... 488
Comparison of CP and CMS Facilities for Debugging ................................... 495
An Overview of VM/SP Commands that Can Be Used for Debugging ...................... 497
Commands that Display or Dump Virtual Machine Data .............................. 497
Commands that Set and Query System Features, Conditions, and Events .................. 498
Commands to Collect and Analyze System Information ............................... 499
Commands that Trace Events in Virtual Machines ................................... 500 Commands that Alter the Contents of Storage ...................................... 500 Debugging CP in a Virtual Machine ................................................. 501 CP Internal Trace Table .......................................................... 501 Abend Dumps .................................................................. 506 Contents xxi ,
How to Print a CP Abend Dump from Tape ........................................ 506 Reading CP Abend Dumps ........................................................ 506 Reason for the Abend ......................................................... 507 Collect Information ........................................................... 508 Register Usage ............................................................... 508 Save Area Conventions ........................................................ 509 Virtual and Real Control Block Status ............................................. 511
Identifying and Locating a Pageable Module ........................................ 522
VMDUMP Records: Format and Content .......................................... 522
Debugging With CMS ••.••.•••.•.••...••.••.•••.••••.•••••..•.•••...•••...••.•••• 525 CMS Debugging Commands ....................................................... 525 DEBUG ................................................................... 526 &CRASH ................................................................... 527
Nucleus Load Map .............................................................. 529
Load Map ..................................................................... 529
Reading CMS Abend Dumps ...................................................... 529
Reason for the Abend ......................................................... 532
Collect Information ........................................................... 532
Register Usage ............................................................... 534
Appendixes •..•........•••...•.•••..•••..••••.•••....•••...•••...•••...••..•••• 536
Appendix A. System/370 Information .............•......•....•.....•••.•••••.••..••• 537
Control Registers ............................................................... 537
Appendix B. VM/SP Monitor Tape Format and Content .•.....•.••.••...•.••..••••..•••• 542
Header Record ................................................................. 542
Data Records .................................................................. 543
Class Zero - Codes for Tape Header, Trailer, and Data Suspension Records ............. 543
Class Zero - PERFORM .................................................... 544
Class One - RESPONSE .................................................... 550 Class Two - SCHEDULE ................................................... 551
Class Four - USER ........................................................ 553
Class Five - INSTSIM ...................................................... 553
Class Six - DASTAP ....................................................... 555
Class Seven - SEEKS ....................................................... 556
Class Eight - SYSPROF -- Additional data for system profile class .................... 556
Appendix C. CMS Macro Library ••.••...•••••••.•••.•••..••••...•••••...•••..••.••• 558
Index •..•...•.•.•.••.•...•••..•.••.....••••.••.••••.••••••••.••••.••••..••..•. 563
xxii VM/SP System Programmer's Guide
Previous Page Next Page