z/OS Version 2 Release 4 JES3 Diagnosis IBM GA32-1002-40 Note Before using this information and the product it supports, read the information in “Notices” on page 387. This edition applies to Version 2 Release 4 of z/OS (5650-ZOS) and to all subsequent releases and modifications until otherwise indicated in new editions. Last updated: 2019-07-10 © Copyright International Business Machines Corporation 1988, 2019. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents Figures................................................................................................................. ix Tables.................................................................................................................. xi About this document...........................................................................................xiii Who should use this document.................................................................................................................xiii How to use this document.........................................................................................................................xiii Where to find more information................................................................................................................ xiv How to send your comments to IBM.................................................................... xvii If you have a technical problem............................................................................................................... xvii Summary of changes...........................................................................................xix Summary of changes for z/OS Version 2 Release 4 (V2R4)..................................................................... xix Summary of changes for z/OS Version 2 Release 3 (V2R3)..................................................................... xix Summary of changes for z/OS Version 2 Release 2 (V2R2)..................................................................... xix Chapter 1. Diagnosing, Resolving, and Reporting JES3 Problems............................ 1 Diagnostic methodology.............................................................................................................................. 1 Gathering relevant system supplied data.............................................................................................. 1 Solving JES3 problems................................................................................................................................ 1 Obtaining an exact description of the problem..................................................................................... 2 Determining the Status of the System.........................................................................................................2 Documentation that can Assist in Diagnosing JES3 Problems...................................................................2 Recommendations for Use of JES3 Dumps and DUMPCORE..................................................................... 3 JES3 WANTDUMP Recommendation.....................................................................................................3 Taking JES3 dumps................................................................................................................................ 3 DUMPCORE............................................................................................................................................. 3 Viewing the Contents of Dumps.................................................................................................................. 4 Viewing JES3 Control Blocks....................................................................................................................... 4 Types of problems in JES3 and associated address spaces.......................................................................4 JES3 address space performance problems.........................................................................................4 Hangs or loops in the JES3 address space............................................................................................ 5 Abends in the JES3 Address Space....................................................................................................... 6 Miscellaneous JES3 Problem Areas.......................................................................................................9 JES3 problems in user address space.................................................................................................12 JES3 SSI processing problems............................................................................................................ 12 Problems in the FSS address space.....................................................................................................12 Problems in the JES3DLOG Address Space.........................................................................................13 Problems in the JESXCF Address Space..............................................................................................14 Problems in the BDT Address Space................................................................................................... 14 JES3 Netserv (TCP/IP/NJE) address space problems........................................................................ 15 Typical JES3 Problems and Their Resolutions..........................................................................................15 Shortage of JES3 Job Numbers........................................................................................................... 16 Misrouted Messages.............................................................................................................................16 Job related diagnosis.................................................................................................................................17 Control Block Print DSP (CBPRNT)...................................................................................................... 21 Converter/Interpreter debug facility................................................................................................... 21 JCLTEST Facility....................................................................................................................................23 iii JSTTEST facility (Print JCL allocation decisions)................................................................................ 23 Chapter 2. General Diagnosis............................................................................... 27 General System Diagnosis.........................................................................................................................27 Display DJC Network (DISPDJC)..........................................................................................................27 The Monitor DSP...................................................................................................................................29 Dump core............................................................................................................................................ 30 JESJCLIN utility....................................................................................................................................32 Displaying JES3 Statistics (Statistics Data Area)................................................................................ 32 Displaying Initialization Related Information......................................................................................34 Displaying output scheduling elements (OSEs) for a job.................................................................... 38 Displaying Single Track Table (STT) Information................................................................................ 41 Displaying contents of a spool record..................................................................................................44 JES3 control statement tracking......................................................................................................... 44 Format of trace tables and JES3 diagnostic facilities...............................................................................44 Format of a JES3 event trace table......................................................................................................44 Format of a Functional Subsystem (FSS) Address Space Trace Table................................................60 Data set status block (DSS) spool trace tables................................................................................... 64 Communication traces......................................................................................................................... 66 Dump Job Trace Output..................................................................................................................... 123 Storage Dumps...................................................................................................................................125 JES3 Dump Suppression....................................................................................................................126 Output Service Diagnostic Mode....................................................................................................... 126 IOERR Output.....................................................................................................................................130