abend-aid user reference guide rel 9.2

Upload: svdontha

Post on 06-Jul-2018

232 views

Category:

Documents


0 download

TRANSCRIPT

  • 8/17/2019 Abend-AID User Reference Guide Rel 9.2

    1/257

    IBM BookManager Print Preview

    DOCNUM = CWAAUMX9CDATETIME = 09/27/99 15:49:19BLDVERS = 1.2TITLE = Abend-AID User/Reference GuideAUTHOR =COPYR =PATH = /man/compuware/books

    COVER Book Cover

    Abend-AID

    User/Reference Guide

    Release 9.2

    NOTICES Notices

      Please direct questions about Abend-AIDor comments on this document to:

    Abend-AID Technical SupportCompuware Corporation

    31440 Northwestern HighwayFarmington Hills, MI 48334-2564

    1-800-538-7822

    Outside the USA and Canada, please contactyour local Compuware office or agent.

    This document and the product referenced in it are subject to thefollowing legends:

    © 1996-1999 Compuware Corporation. All rights reserved. Unpublishedrights reserved under the copyright laws of the United States.

    Use, duplication, or disclosure by the U.S. Government is subject to

    restrictions as set forth in Compuware Corporation license agreementand as provided in DFARS 227.7202-1(a) and 227.7202-3(a) (1995), DFARS252.227-7013(c)(1)(ii) (OCT 1988), FAR 12.212(a) (1995), FAR52.227-19, or FAR 52.227-14 (ALT III), as applicable.

    This product contains confidential information and trade secrets ofCompuware Corporation. Use, disclosure, or reproduction is prohibitedwithout the prior express written permission of Compuware Corporation.Access is limited to authorized users. Use of this product is subjectto the terms and conditions of the user's License Agreement with

  • 8/17/2019 Abend-AID User Reference Guide Rel 9.2

    2/257

      Compuware Corporation.

    Abend-AID, Abend-AID Viewer, Compuware, Compuware Shared Services,CSS, Compuware Viewing Facility, Compuware/VF, Enterprise CommonComponents, and XPEDITER are trademarks or registered trademarks ofCompuware Corp.

    AD/Cycle, BookManager, COBOL/370, C/370, DB2, DFSMS/MVS, IBM, LanguageEnvironment, OS/390, MVS/ESA, and SAA are trademarks or registeredtrademarks of International Business Machines Corporation.

    Fujitsu, MSP/AE, and MSP/EX are trademarks or registered trademarks ofFujitsu, Limited.

    Hitachi and VOS3/AS are trademarks or registered trademarks ofHitachi, Limited.

    Acrobat (R) Reader copyright (C) 1987-1996 Adobe Systems Incorporated.All rights reserved. Adobe and Acrobat are trademarks of AdobeSystems Incorporated.

    All other company or product names are the trademarks or registeredtrademarks of their respective owners.

    Doc. CWAAUMX9CSeptember 27, 1999

    CONTENTS Table of Contents[Summarize]

    COVER Book Cover

    NOTICES Notices

    CONTENTS Table of Contents

    CHANGES Summary of Changes

    FRONT_1 IntroductionFRONT_1.1 Intended AudienceFRONT_1.2 PublicationsFRONT_1.3 Technical Support

    1.0 Product Overview1.1 System Environment1.2 Facilities

      1.2.1 Abend-AID Report  1.2.2 Extended Language Support  1.2.3 Database Support  1.2.4 SNAP-AID  1.2.5 SMF Cost Analysis Tool  1.2.6 Japanese Language Facility1.3 Operation  1.3.1 Basic Process  1.3.2 Control Structure  1.3.3 IBM Dump Provision

  • 8/17/2019 Abend-AID User Reference Guide Rel 9.2

    3/257

      1.3.4 Utilities  1.3.5 User Manuals

    2.0 Getting Started2.1 Setting Up Output2.2 Before You Begin  2.2.1 Extended Language Support  2.2.1.1 Collect Report Information  2.2.1.2 Create a Sample Report  2.2.2 Basic Language Support  2.2.2.1 Collect Report Information  2.2.2.2 Create a Sample Report2.3 Accessing Abend-AID2.4 Accessing and Browsing a Report2.5 Report Commands  2.5.1 Source Command  2.5.2 F (Find) Command2.6 Source Warnings  2.6.1 COBOL Mismatched Date and Time  2.6.2 PL/I Mismatched Structure  2.6.3 Assembler Unmatched Source Listing  2.6.4 Available Source Listings  2.6.5 Source-Not-Found2.7 Y2K Rapid Response

    3.0 Diagnosing a COBOL Data-Related Error3.1 Resolving an S0C7 with Extended Language Support  3.1.1 Searching Program Listing  3.1.2 Determining Index and Indexed Field Values3.2 COBOL Data Locator3.3 Compiling for Basic Language Support3.4 Resolving an S0C7 with Basic Language Support  3.4.1 Searching Program Storage  3.4.2 Determining Index and Indexed Field Values

    4.0 Diagnosing a PL/I Data-Related Error4.1 Resolving an On-Code 0320 with Extended Language Support

      4.1.1 Searching Program Listing4.2 Types of Basic Language Support4.3 Resolving an On-Code 0320 with Basic Language Support  4.3.1 Searching Program Storage

    5.0 Diagnosing an Assembler Data-Related Error5.1 Resolving an S0CB with Extended Language Support  5.1.1 Report Command5.2 Resolving an S0CB with Basic Language Support

    6.0 Diagnosing VS FORTRAN Errors6.1 VS FORTRAN Diagnostics  6.1.1 VS FORTRAN Extended Error Handling Facility

    7.0 Understanding Database Diagnostics7.1 Abend-AID for DB2  7.1.1 Using Report Types  7.1.2 Using SNAP-AID to Report Negative SQL Codes  7.1.3 With TSO or Call Attach Mode  7.1.4 With IMS or DL/I Attach Mode  7.1.5 Using DB2 Plan Package Support  7.1.6 Using DB2 Stored Procedure Support  7.1.7 Supported Reason Codes

  • 8/17/2019 Abend-AID User Reference Guide Rel 9.2

    4/257

      7.1.8 ROLLBACK Statement  7.1.9 File-AID Access7.2 Abend-AID for IMS  7.2.1 File-AID Access7.3 Abend-AID for IDMS  7.3.1 With SNAP-AID

    8.0 Using SNAP-AID8.1 Invoking SNAP-AID8.2 SNAP-AID Execution8.3 SNAP-AID Return Codes8.4 SNAP-AID Parameter List8.5 Suppressing SNAP-AID

    9.0 Using Abend-AID DD Statements9.1 Abend-AID DD Statements  9.1.1 General Usage  9.1.2 IBM Dump-Related  9.1.2.1 Overrides  9.1.3 Processing Control  9.1.3.1 Enabling Abend-AID  9.1.3.2 Bypassing Abend-AID  9.1.4 Report Output  9.1.4.1 Report File

      9.1.4.2 Defining a Sequential File  9.1.4.3 Routing Output to SYSOUT  9.1.4.4 Controlling Report Format  9.1.5 Storage-Related  9.1.5.1 Overrides  9.1.6 Record Format  9.1.7 IDMS-Related

    10.0 Understanding Language Processors10.1 Use of Language Processors10.2 Operating Modes  10.2.1 Processing Methods10.3 Processing Outputs

      10.3.1 Output Options  10.3.1.1 Change Language Processing Mode  10.3.1.2 Change Language Processor Options

    11.0 Using Abend-AID in Language Environment11.1 Basic Operation  11.1.1 Invoking Abend-AID  11.1.2 Routing Abend-AID Output11.2 Frequently Asked Questions

    12.0 Report Samples12.1 Accessing the Abend-AID Report12.2 Report Sections

      12.2.1 Header Section  12.2.2 Diagnostic Section  12.2.3 Next Sequential Instruction Section  12.2.4 Registers Section  12.2.5 Trace Section  12.2.6 Program Storage Section  12.2.7 Program Listing Section  12.2.8 File Section  12.2.9 DB2 Section  12.2.10 IMS Section

  • 8/17/2019 Abend-AID User Reference Guide Rel 9.2

    5/257

      12.2.11 IDMS Section  12.2.12 Current Sort Record Section  12.2.13 COBOL Data Locator  12.2.14 Epilog Section

    13.0 Understanding the Compuware/VF Interface13.1 Compuware/VF Screens  13.1.1 Entry Panel  13.1.2 Alternate Logon  13.1.3 Dataset Directory  13.1.3.1 Abend-AID Dataset Directory  13.1.3.2 Source Listing Dataset Directory  13.1.3.3 Primary Commands  13.1.3.4 Line Commands  13.1.4 Hardcopy Options  13.1.5 Output Selection Menu13.2 Source Warnings

    14.0 Printing & Utilities14.1 Change Printing Options14.2 Utilities  14.2.1 User Manuals

    A.0 Appendix A. Testing Samples

    GLOSSARY Glossary

    INDEX Index

    CHANGES Summary of Changes

      This section summarizes the enhancements to Abend-AID releases that arecurrently supported.

    | Release 9.2 changes

    | o License Management System (LMS):

    | This release of Abend-AID implements Compuware's new License Management| System (LMS), which is on the Enterprise Common Components (ECC) tape| included in the Abend-AID shipping package. LMS enables you to centrally| administer Compuware's new product license certificates and manage| access to Compuware products at your site. LMS includes several| components that together enable you to establish, maintain, diagnose,| and upgrade access to the Compuware products licensed by your| enterprise. LMS replaces the customer profile utility provided with

    | previous versions of Abend-AID

    | LMS is required to operate this version of Abend-AID. Refer to the ECC| documentation for details on installing and configuring LMS.

    | o Integration with Abend-AID Fault Manager: This new fault management| product automates fault notification as well as the methods of| reporting, reviewing, and monitoring IS troubleshooting activities.| Fault Manager is a revolutionary tool for mainframe development,| testing, and support managers.

  • 8/17/2019 Abend-AID User Reference Guide Rel 9.2

    6/257

     | When faults occur, Fault Manager automatically collects information from| the Abend-AID/XLS or CICS Abend-AID/FX reports into a database on| Windows NT. The fault details can be dynamically displayed in a report| or graphical format for short-term, long-term, or historical| perspectives.

    | Call your sales representative at 1-800-521-9353 for more information.

    Release 9.1 changes

    o Year-2000 Rapid Response Advantages: These practical, new features willcontribute to the success of your Y2K remediation:

    -- Direct access from an Abend-AID report to File-AID/MVS, File-AID/DB2,or File-AID/IMS

    -- Data-locating capability that reports specified data stringoccurrences

    -- Comparison function that flags lines changed in a source listing-- Capability to attach programmer contact information to a job name

    o Abend-AID Reliability, Availability, & Service:

    -- User documentation in three online formats on CD-ROM

    Note: Abend-AID user documentation in BookManager format is no longerprovided on the product installation tape, beginning withAbend-AID 9.1.

    -- Unlimited printing of user documentation-- Automatic generation of installation JCL-- Online utilities for XLS setup and processing

    o OS/390 & Language Environment: New reasons why the Abend-AID reportimproves LE troubleshooting:

    -- Enables faster resolution of LE library mismatches-- Identifies use of Run-Time Library Services-- Interprets the contents of the LE options control block in use at

    time of error-- Diagnostics for all messages and codes for all current OS/390 and

    associated LE releases-- Diagnostics for all MLE COBOL & PL/I messages and codes

    o Load Library Tracing: Identifies the load library for each load moduleactive at the time of fault.

    o IMS Batch Statistics: Provides in the Abend-AID report the count, bytype, of batch database calls.

    o DB2 Version 6 Release 1: Diagnostics for all new messages and codes, aswell as support for new features.

    Release 9.0 Changes: This release offers the following enhancements:

    o XLS for Assembler: This release introduces source-level diagnostics forHigh Level Assembler, giving you considerably broader effectiveness indiagnosing Assembler faults.

  • 8/17/2019 Abend-AID User Reference Guide Rel 9.2

    7/257

      o Distributed Viewing for XLS: You now have online access to Abend-AIDreports -- with source-level diagnostics -- that are on a separate MVSsystem and separate DASD.

    o Basic Assembler Diagnostics: Enhancements to Abend-AID's diagnosticreport include:

    -- Formatted save areas for Assembler programs-- Disassembly of Assembler code around the next sequential instruction-- Identification of access registers.

    o OS/390 Version 2 Release 5 & Language Environment: Abend-AID'sdiagnostics now include:

    -- Reporting of LE-based C and C++ compilers-- First-level diagnostics of system and LE abend and condition codes.

    o IMS Version 6 Release 1: Diagnostics for all messages and codes, aswell as additional enhancements.

    Release 8.4 Changes: This release offers the following enhancements:

    o OS/390 Version 2 Release 4: Abend-AID's diagnostics now include:

    -- Identification of modules loaded from OS/390's dynamic link packarea.

    -- New OS/390 system abend and reason codes.

    o Language Environment: Enhancements to Abend-AID diagnostic reports:

    -- Diagnostics for OS/390 2.4 Language Environment.-- New LE abend and run-time condition codes.-- Helps identify the broken save area chain in a U4083 abend.

    o DB2 Version 5 Release 1: Diagnostic information for all new SQL verbs.

    o VSAM Files: Enhanced descriptive information about VSAM files open atthe time of abend.

    o DFSMS/MVS Version 1 Releases 3 & 4: Significant reduction in the timeAbend-AID requires to process diagnostics for PDSE object libraries.

    Release 8.3 Changes: This release offers the following enhancements:

    o Year 2000 Ready: Changes in the Abend-AID report:

    -- Identifies program compilers that may need upgrading to year 2000

    compliance-- Displays year dates in four digits.

    o Language Environment: Improved dynamic allocation of the ABENDAID DD.

    o SNAP-AID: You can dynamically allocate the ABENDAID DD statement toproduce a SNAP-AID report.

    o COBOL Extended Language Support: Several enhancements to the displayand formatting of working storage.

  • 8/17/2019 Abend-AID User Reference Guide Rel 9.2

    8/257

      o Abend-AID for IMS: Complete GSAM information formatted as a PCB, in theIMS section of the Abend-AID report.

    o Report Routing: Easier access to JES job ID and job accountinginformation.

    o Assembler Program Storage Display: You can limit the amount ofAssembler Program Storage to be displayed in an Abend-AID report.

    o Memory Usage: Abend-AID now summarizes its memory usage.

    o DFSMS/MVS Version 1 Release 3: Support for:

    -- VSAM files larger than 4 GB-- PDSE objects larger than 16 MB-- Record-level sharing (RLS).

    o IBM Support:

    -- Messages and codes support for OS/390 Releases 1 and 2-- Compatibility support for VS FORTRAN Version 2 programs using LE

    Version 1 Release 5.

    o IAM Version 6 Release 3: Compatibility support for this current releaseincludes identification of dynamic file and data changes.

    o Documentation:

    -- The message explanations in the chapter of the Abend-AIDUser/Reference Guide titled "Reference Messages" are now in theMessages chapter of the Abend-AID Installation & Customization Guidein the section titled "General System Messages."

    -- The installation procedure for basic support, in the Abend-AIDInstallation & Customization Guide, has a new step to assemble andlink-edit the JES2 control block offset table. This step was

    previously optional.

    FRONT_1 Introduction

      This manual describes how to use Compuware's Abend-AID. The manualconsists of the following chapters:

    1. Product Overview: Summarizes Abend-AID's facilities and operation.

    2. Getting Started: An introduction to Abend-AID's report. .

    3. Diagnosing a COBOL Data-Related Error: Shows you typical diagnosticsteps with an Abend-AID report.

    4. Diagnosing a PL/I Data-Related Error: Shows you typical diagnosticsteps with an Abend-AID report.

    5. Diagnosing an Assembler Data-Related Error: Shows you typicaldiagnostic steps with an Abend-AID report.

  • 8/17/2019 Abend-AID User Reference Guide Rel 9.2

    9/257

      6. Diagnosing VS FORTRAN Errors: Summarizes diagnostic considerations.

    7. Understanding Database Diagnostics: Introduces you to Abend-AIDdiagnostics for DB2, IMS, and IDMS.

    8. Using SNAP-AID: Explains how to use the SNAP-AID function.

    9. Using Abend-AID DD Statements: Lists and summarizes the purposes ofAbend-AID's DD statements.

    10. Understanding Language Processors: Everything you need to know to getthe most from a Compuware language processor.

    11. Using Abend-AID in Language Environment: Answers typical questionsabout diagnostics and operation in Language Environment.

    12. Report Samples: Describes the Abend-AID report sections.

    13. Understanding the Compuware/VF Interface: Explains screen fields.

    14. Printing & Utilities: Summarizes the management facilities availablefor both installation and operation.

    Appendix A. Testing Samples: Lists sample faulted programs provided withAbend-AID for testing and training.

    Glossary: Defines Abend-AID facilities, features, and associated terms.

    Subtopics:

      FRONT_1.1 Intended Audience  FRONT_1.2 Publications  FRONT_1.3 Technical Support

    FRONT_1.1 Intended Audience

      This manual is intended for use by application programmers.

    FRONT_1.2 Publications

      Compuware Documentation

    Note: Abend-AID user documentation in BookManager format is no longerprovided on the product installation tape, beginning with Abend-AID9.1.

    Abend-AID user documentation is now shipped in three online formats onCD-ROM with Abend-AID: Adobe Acrobat, HTML, and IBM BookManager.

    o Acrobat enables unlimited user printing from a Web site or workstationo HTML enables unlimited user viewing from a Web siteo BookManager ensures precise, fast search capabilities from a network

  • 8/17/2019 Abend-AID User Reference Guide Rel 9.2

    10/257

      server or workstation.

    These documents are shipped in paper format with Abend-AID: Abend-AIDInstallation & Customization Guide, Abend-AID Quick Reference, and ReleaseAnnouncement. Complete documentation sets should be printed as needed fromthe Acrobat files supplied on the documentation CD.

    This is the documentation set that is supplied with Abend-AID:

    o Abend-AID Installation & Customization Guide: Instructions forinstalling Abend-AID and information about setting it up to fit thedevelopment and system configurations at your site.

    o Abend-AID User/Reference Guide: Guidelines and instructions for usingAbend-AID: basic language support, extended language support (XLS),SNAP-AID, Abend-AID for DB2, Abend-AID for IMS, Abend-AID for IDMS, andAbend-AID DD statements.

    o Abend-AID Quick Reference: A handy summary of Abend-AID reportsections, Compuware/VF, SNAP-AID, and DD statements.

    o Abend-AID Product Description Manual: Introduces you to Abend-AIDfacilities and features.

    o SMF Cost Analysis Tool User's Guide: A description of the SMF CostAnalysis Tool, reports, usage, customization, and installation.

    o Enterprise Common Components Installation and Customization Guide:Installation and maintenance instructions for Compuware Shared Services,including all components of extended language support (XLS).

    o Compuware Shared Services User/Reference Guide: Operation and referenceinformation about the components of Compuware Shared Services, whichcomprise extended language support: Compuware/VF and the Compuwarelanguage processor, Compuware's DDIO report and source listing files,and batch file utility (CWDDSUTL).

    Online Help: You will find information about using Abend-AID and the XLScomponents available through the Abend-AID Primary Menu and the F1 key.

    FrontLine Support Web Site: You can access online technical support forCompuware products via our FrontLine support web site. You can read ordownload documentation, frequently asked questions, and product fixes, ordirectly e-mail Compuware with questions or comments. To accessFrontLine, you must first register and obtain a password athttp://frontline.compuware.com. FrontLine is currently available forcustomers in the United States and Canada. FrontLine services for other

    countries will be available in the future.

    Online Documentation: Documentation for Abend-AID is provided on CD-ROMin several electronic formats. BookManager manuals can be viewed with anyversion of IBM BookManager READ or the IBM Library Reader. To learn moreabout BookManager or download the free Library Reader, go tohttp://booksrv2.raleigh.ibm.com. PDF files can be viewed with the freeAdobe Acrobat Reader, available at http://www.adobe.com. HTML files canbe viewed with any standard web browser.

  • 8/17/2019 Abend-AID User Reference Guide Rel 9.2

    11/257

      World Wide Web: Compuware's site on the World Wide Web providesinformation about Compuware and its products. The address ishttp://www.compuware.com.

    IBM Documentation: More information related to Abend-AID can be found inthe following IBM publications:

    o Language Environment for MVS & VM Installation and Customization UnderMVS: Discusses Language Environment for MVS and VM.

    o MVS/ESA Initialization and Tuning Reference: Contains information aboutAPF authorization and the use of (E)LPA.

    o MVS/ESA Planning: Security: Contains information about APFauthorization.

    FRONT_1.3 Technical Support

      If you need information about Abend-AID's operating or performancecapabilities, or assistance in troubleshooting, first refer to theAbend-AID documentation set. Complete online documentation is provided onCD-ROM with each release of Abend-AID, and also accessible for onlinereading or downloading from the Compuware FrontLine Support web site.

    If you call Abend-AID Technical Support for troubleshooting assistance,provide the following information applicable to your problem so that wecan help you as quickly as possible.

    o The client number as provided in the CWCUTIL report or displayed on theheader of the Abend-AID report. JCLUTIL is the Abend-AID installation

    library member used to execute CWCUTIL.

    o The Abend-AID release number displayed on the header of the Abend-AIDreport.

    o The operating system and release in use to help determine operatingsystem dependencies.

    o All printed output from the job in question, including console messages,JCL stream, Abend-AID output, and the standard dump (SYSUDUMP orSYSABEND).

    o Output from jobs that were used to install or customize Abend-AID. This

    output includes the report produced by the CWVERIFY utility. $09VERIFis the Abend-AID installation library member used to execute CWVERIFY.

    Abend-AID Technical SupportCompuware Corporation

    31440 Northwestern HighwayFarmington Hills, MI 48334-2564

  • 8/17/2019 Abend-AID User Reference Guide Rel 9.2

    12/257

      1-800-538-7822

    1.0 Product Overview

    Subtopics:

      1.1 System Environment  1.2 Facilities  1.3 Operation

    1.1 System Environment

      Abend-AID identifies and describes application program failures in thefollowing MVS-based languages and databases:

    o Language Environment:-- Language Environment associated with current releases of OS/390

    -- Language Environment for MVS & VM 1.5o COBOL:-- COBOL for OS/390 & VM 2.1 (*)-- COBOL for MVS & VM 1.2 (*)-- AD/Cycle COBOL/370 1.1, 1.0-- VS COBOL II 1.4, 1.3.2, 1.3.1-- OS/VS COBOL 2.4

    o PL/I:-- PL/I for MVS & VM 1.1.1 (*)-- AD/Cycle PL/I 1.1-- PL/I 2.3

    o Assembler:-- High Level (HLASM) 1.2, 1.1.0

    -- Assembler Ho C:-- C/C++ for MVS & VM-- AD/Cycle C/370-- SAS/C

    o VS FORTRAN 2.6, 2.5o DB2 6.1, 5.1, 4.1, 3.1

    | o IMS 6.1, 5.1, 4.9, 4.1o IDMS 14.0, 12.01

    Abend-AID identifies and describes application program failures on theoperating systems IBM OS/390 and MVS/ESA.

    (*) Compuware supports the MVS portion of this product.

    1.2 Facilities

  • 8/17/2019 Abend-AID User Reference Guide Rel 9.2

    13/257

      Abend-AID intercepts and analyzes application program failures to providecomprehensive fault diagnostics, reacting specifically to the type oferror, the language of the failing program, and the types of files ordatabases in use. A concise, easy-to-read report, available in printedform or online, presents the most important information first and only thedata necessary to solve the problem.

    Abend-AID provides diagnostics for DB2, IMS, and IDMS databases as well asCOBOL, PL/I, Assembler, C/370, and VS FORTRAN languages. This supportincludes those versions of COBOL and PL/I that can be run with LanguageEnvironment.

    For COBOL, PL/I, and Assembler errors, Abend-AID merges actual source codeand diagnostic data into a single report. Online, menu-driven accessenables quick and accurate problem resolution. The specializeddiagnostics for DB2, IMS, and IDMS environments enable programmers toresolve errors independently of the DBA staff.

    Subtopics:

      1.2.1 Abend-AID Report  1.2.2 Extended Language Support  1.2.3 Database Support

      1.2.4 SNAP-AID  1.2.5 SMF Cost Analysis Tool  1.2.6 Japanese Language Facility

    1.2.1 Abend-AID Report

      The Abend-AID report consists of these sections, which may be accessedindividually online by menu selection:

    o Header: Includes environmental information about the program in error,

    the operating system release level, the date and time when the erroroccurred, job name, step name, and job completion code.

    o Diagnostic section: Includes a comprehensive explanation of the errorcondition, specific information about the field(s) contained in thestatement in error, and suggested courses of action whenever possible.

    o Next Sequential Instruction section: Provides information for locatingthe statement in error. When using extended language support,identifies the exact location of the error. The compile date and lengthof the program in error are also identified.

    o Registers section: Provides supporting environmental data. This

    information includes the abending program status word (PSW) and programPSW, entry point and load point addresses, and the contents of theregisters at the time of the error.

    o Trace section: Provides the Call Trace Summary and the ApplicationProgram Attributes. The Call Trace Summary includes a trace ofcalled/linked programs on the save area chain and indicates the programin error. The Application Program Attributes include the program name,language, compile date, and length for each application program.

  • 8/17/2019 Abend-AID User Reference Guide Rel 9.2

    14/257

      Note: The Abend-AID report, Trace section, identifies programcompilers that may be using date-handling routines that don't supportfour-digit years. Warnings appear in the Diagnostic and Next SequentialInstruction sections.

    o Program Storage section: Formats program storage for applicationprograms on the calling chain. Program storage is formatted based onthe programming language.

    o Program Listing section: Available only with COBOL, PL/I, or Assemblerextended language support. Provides the procedure divisions for COBOLprograms on the calling chain and source listings for PL/I or Assemblerprograms on the calling chain with the current statement indicated.

    o File section: Gives a status of each open file along with formattedcurrent and previous records.

    o Specialized Database Support: Provides database-specific support forDB2, IMS, and IDMS if the Abend-AID database support facility for thatenvironment is installed on the system.

    o SORT section: Includes the current COBOL internal sort information.Available only for COBOL programs with internal sort.

    o COBOL Data Locator: Lists occurrences of all or specified data or datestrings and formats, identifying their locations. Available only duringonline viewing of COBOL extended language support.

    o Epilog section: Includes report print and IBM dump information ifapplicable.

    1.2.2 Extended Language Support

      With extended language support you get source code in pertinent sectionsof the Abend-AID report, showing where the fault occurs, the conditions inwhich it occurs, and telling why it occurs. XLS is available for COBOL,PL/I, and Assembler (HLASM) programs.

    XLS contributes the following information to the report:

    o Diagnostic section: Shows the source statement that's in error. Fordata-related errors, also shows the contents of COBOL fields, PL/Ivariables, or Assembler variables in the statement at the time of thefault.

    o Instruction section: Shows the source statement being executed.

    o Program Storage section: Shows the names and contents of all individualCOBOL fields, PL/I variables, or Assembler variables in storage.

    o Program Listing section: Shows the procedure divisions for COBOLprograms on the calling chain or the source listings for PL/I orAssembler programs on the calling chain, with the current statementindicated.

  • 8/17/2019 Abend-AID User Reference Guide Rel 9.2

    15/257

      Report Viewing: The Compuware Viewing Facility (Compuware/VF) providesimmediate, online access to all report sections. The report can beprinted during viewing.

    Compuware/VF uses a self-maintaining report file that stores Abend-AIDoutput in a compressed format, further reducing DASD space. Reports canbe locked to keep them in the report file as long as needed.

    Compuware/VF keeps track of all Abend-AID activity and provides acomprehensive security system. The report file directory summarizesAbend-AID activity in a concise, easy-to-use format. You can sort thedirectory by job name, report number, error code, date, programmer, orreport size.

    Source Viewing: Abend-AID's language processors for COBOL, PL/I, andAssembler enable XLS by capturing the pertinent source code from thecompiler listing. The language processors store the source in a special,self-maintaining source listing file. For XLS, Compuware/VF insertsapplicable information from the source listing file into the reportsections.

    The Abend-AID user can set up a language processor to store the source

    listing either before or after an Abend-AID report is written to thereport file. One or more source listing files are prepared by theinstaller during installation for this purpose. A source listing file canbe used by other Compuware products, such as XPEDITER/TSO.

    The COBOL language processor produces an enhanced compiler listing thatgives diagnostic information not available in a standard listing. Theenhanced listing enables developers to further review program conditionsassociated with report diagnostics.

    Distributed Viewing: Distributed viewing enables application developersto merge Abend-AID report and source listing files that are on different

    MVS images that don't share DASD, or to access the files individually.Users access the files through the Compuware/VF, as they normally would.

    Working from individual local systems, any number of users can accessreport and source listing files that both reside on other MVS images. Thedistance between MVS sites has no affect on the speed or reliability ofthe extended language report presented to a user.

    1.2.3 Database Support

      Abend-AID provides comprehensive support for DB2, IMS, and IDMS databases.These database support facilities are available as additional costoptions.

    Abend-AID for DB2: Abend-AID for DB2 solves difficult S04E and S04Fabends, as well as application program problems associated with unexpectednegative SQL codes. With Abend-AID for DB2, you no longer need to wadethrough DB2 dumps and message manuals. Abend-AID pinpoints what happened,

  • 8/17/2019 Abend-AID User Reference Guide Rel 9.2

    16/257

      as well as when, where, and why a DB2 abend or error occurred.Furthermore, Abend-AID for DB2 usually offers a solution to the problem.

    Abend-AID can diagnose DB2 problems regardless of the environment in whichthe program is executing, and it is applicable to TSO, call attach mode,IMS, and DL/I attach mode environments. It alleviates the complexity ofDB2 as a result of cross-memory services, multiple address spaces, and thedifferent execution modes.

    Abend-AID for IMS: Abend-AID for IMS features special diagnostic routinesfor application failures in IMS DB and TM environments. Abend-AID for IMSreduces the complexity surrounding the IMS environment by giving youcomprehensive, easy-to-understand diagnostics on IMS user abends inaddition to specific database information. Compuware/VF enablesimmediate, online access to Abend-AID output or IBM dumps that would notnormally be available until the region is brought down.

    Abend-AID for IDMS: Abend-AID for IDMS provides diagnostics for failuresunique to the CA-IDMS database system. IDMS application failures arethoroughly analyzed by special modules that produce output reports,accurately describing the cause of the error. With Abend-AID for IDMS,you no longer need to rely on manuals or reference cards when debugging

    IDMS errors.

    1.2.4 SNAP-AID

      The SNAP-AID facility produces Abend-AID output without terminating theapplication program. This facility provides a controlled environment fordebugging logic or data errors. For example, SNAP-AID can be verybeneficial in the DB2 environment when you want Abend-AID diagnostics fora negative SQL code without terminating the program. SNAP-AID is invoked

    by a call to the SNAPAID module in the application program. The amount ofoutput can be customized by using a parameter list in the SNAP-AID call.

    1.2.5 SMF Cost Analysis Tool

      Analyzes user-provided SMF records spanning any time range to show thevolume and type of fault activity on a system. Estimates the MIS time andsystem costs saved by using Abend-AID.

    1.2.6 Japanese Language Facility

      Abend-AID's Japanese language capability uses the IBM double-bytecharacter set (DBCS) to present over 90% of the Abend-AID report inJapanese when viewed online through Compuware/VF. Japanese language isavailable for DB2, IMS, and COBOL diagnostics. Compuware/VF panels,

  • 8/17/2019 Abend-AID User Reference Guide Rel 9.2

    17/257

      tutorials, and messages can be displayed in Japanese.

    1.3 Operation

      Abend-AID remains transparent to the user until an application programfailure occurs. When a program failure occurs, Abend-AID intercedes andreports the information you need to resolve the problem. Abend-AIDoperates according to a control structure preset by system defaults.Abend-AID lets you tailor its control structure for specializedenvironments.

    Subtopics:

      1.3.1 Basic Process  1.3.2 Control Structure  1.3.3 IBM Dump Provision  1.3.4 Utilities  1.3.5 User Manuals

    1.3.1 Basic Process

      When an application program failure occurs in Language Environment, thesystem calls registered Abnormal Termination Exits (ATE) to process thecondition. For abnormal termination processing, Compuware provides themodule LEAID as the entry point to Abend-AID.

    If the application program failure is an abend, the operating system callsSVC51 to create a dump. In this case, Abend-AID operates by interceptingIBM SVC51 dump processing. If a //SYSUDUMP or //SYSABEND DD, or both the//SYSMDUMP and //ABENDAID DD statements are present in the execution JCL,

    Abend-AID intercepts the call to SVC51 and gets control.

    In all Abend-AID processing, Abend-AID modules are then dynamically loadedto process the error. These modules must be available either in a linklist library or via a JOBLIB or STEPLIB library. Abend-AID tables let youfurther control Abend-AID execution. Global default options and userexits provide a means of customizing Abend-AID processing.

    Abend-AID operates in the normal problem-program state rather than thesupervisor state. This operation maintains the integrity of theapplication system.

    Abend-AID's decision-making capabilities selectively invoke the necessary

    diagnostic and reporting modules. This selection is based on variablessuch as the specific abend code, programming language, and file accessmethod. Abend-AID reports information based on the status of the programand the system at the time of the program failure.

    To keep overhead to a minimum, Abend-AID invokes only the required modulesfor each error. Exact memory requirements depend on the particular error,the options installed, and the complexity of the program being analyzed.

  • 8/17/2019 Abend-AID User Reference Guide Rel 9.2

    18/257

    1.3.2 Control Structure

      Abend-AID can operate with the default parameters supplied by Compuware orcan be customized to your needs. Abend-AID reports can be produced forall application program failures because Abend-AID recognizes whichinformation is most helpful for problem resolution. Abend-AID alsoprovides a sophisticated control structure that can be utilized as needed.Compuware recommends that you employ these controls only after you haveidentified variations to the product defaults that will aid in resolutionof specific types of problems.

    Abend-AID offers a six-level control structure that lets you tailorAbend-AID for specialized environments, such as different levels ofsupport for jobs, programs, or abend codes. The structure is ahierarchical sequence with the highest priority first. Use of aparticular control level overrides all of the controls that follow. Thesix levels of the control structure are:

    o JCL modificationo User exitso Job and program selection tables

    o Abend code tableso Global site options tableo System-wide control.

    Each level is described below.

    JCL Modification: This level lets you easily override the user exits,tables, and default system parameters. Examples of JCL modifications are:

    Example 1: Causes Abend-AID to print the Help page:

    //ABNLHELP DD DUMMY

    Example 2: Causes Abend-AID to format and display all program storage andcontrol blocks, regardless of installation options:

    //ABNLALL DD DUMMY

    User Exits: Abend-AID provides optional user exits that you can use totailor output by particular jobs and/or programs. The exits dynamically

    perform specialized processing at execution time. They can beparticularly useful for program development or for a phased installationof Abend-AID. The exits let you:

    o Override job and program tables to specify an alternative abend codetable for particular errors.

    o Alter the report file name, route output by job name or job-name prefix,dynamically suppress output, or automatically route output to a disk orprinter.

  • 8/17/2019 Abend-AID User Reference Guide Rel 9.2

    19/257

      o Display selected storage areas, such as GETMAIN storage, or tables andcontrol blocks from user-written applications.

    o Produce additional Abend-AID output for site-dependent reasons.

    Job and Program Selection Tables: Selection tables let you specify theAbend-AID operation for particular programs or jobs. These operationsinclude dump (request an IBM dump), no dump (do not produce an IBM dump),ignore (do not produce an Abend-AID report), or proc (produce an Abend-AIDreport).

    Abend Code Tables: Tables are supplied with the product that specify --by abend code, PL/I on-code, or LE condition code -- the action thatAbend-AID is to take when a problem is either fully or partially resolved.These actions include options for dump output, control block formatting,and program storage analysis. These tables allow complete flexibility intailoring the system.

    Compuware distributes the abend code tables with the recommended settings.Because these settings are based on Compuware's experience with many

    installations, modifications to the tables are seldom necessary.

    Global Site Options Table: The global site options table provides variousAbend-AID system default options such as report width, the number of linesper page, the default Abend-AID report file name, and language type ofreport text.

    System-Wide Control: This level is used to start Abend-AID on your systemor to stop Abend-AID from intercepting application program failures.

    1.3.3 IBM Dump Provision

      In most cases, the Abend-AID report is all that is needed to resolve theproblem. In the rare case when it cannot fully resolve the problem,Abend-AID provides all the information that can be obtained, and thenautomatically invokes a full IBM dump.

    Abend-AID supplies tables that either request or suppress an IBM dumpbased on abend code, program name, or job name. Abend-AID DD statementscan be used to override any option selected with the installation tables.

    1.3.4 Utilities

      Several Abend-AID utility programs provide users with installation andservicing functions.

  • 8/17/2019 Abend-AID User Reference Guide Rel 9.2

    20/257

      o Installation Verification Report: Check the installation of tables andmodules.

    o Table Listing Program: Review the contents of the abend code tables,global table with site defaults, job/program selection tables, and theCSECT inclusion table.

    | o License Management System: Install, check, or modify license| information.

    o Abend-AID Maintenance Program: Apply object module maintenance to theAbend-AID system.

    Other utilities provide users with operational and processing functions.

    o Compuware/VF: Manage report and source listing files online.

    o CSS Utilities: Set up a language processor or modify processing online.

    o CSS Batch File Utilities: Manage report and source listing files inbatch mode.

    1.3.5 User Manuals

      A complete set of user documentation, in three online formats, is providedon CD-ROM with each release of Abend-AID. Refer to "Publications" intopic FRONT_1.2 for complete information.

    2.0 Getting Started

      This chapter prepares you to use Abend-AID reports.

    Subtopics:

      2.1 Setting Up Output  2.2 Before You Begin  2.3 Accessing Abend-AID  2.4 Accessing and Browsing a Report  2.5 Report Commands  2.6 Source Warnings  2.7 Y2K Rapid Response

    2.1 Setting Up Output

      Abend-AID requires a valid //SYSUDUMP DD SYSOUT= statement added to theexecution JCL in order to produce output. If you have a //SYSUDUMP DDstatement and do not get Abend-AID output, contact an Abend-AID installer.

    Note: In Language Environment, a //SYSUDUMP DD statement is required forabends only. It is not necessary for condition code handling.

  • 8/17/2019 Abend-AID User Reference Guide Rel 9.2

    21/257

      With Compuware/VF: In order for you to use Compuware/VF, Abend-AID outputmust be routed to an Abend-AID report file. Compuware/VF uses the outputthat is stored in the report file. If your output is not automaticallydirected to a report file, you must include an //ABNLTERM DD DSN statementin the abending program's JCL:

    //STEP03 EXEC PGM=PROGNAME...//SYSUDUMP DD SYSOUT=*//ABNLTERM DD DSN=YOUR.REPORT.FILE,DISP=SHR

    Without Compuware/VF: If your site does not use Compuware/VF, Abend-AIDoutput is written to the //SYSUDUMP DD or to the //ABENDAID DD statementif present in the execution JCL.

    You can view Abend-AID reports as part of your job output from the SystemDisplay and Search Facility (SDSF).

    2.2 Before You Begin

      This section will help you prepare a sample Abend-AID report to look at inthe following section, "Accessing and Browsing a Report" in topic 2.4.You will find it of most help in the following situations:

    o Your system or site installed Abend-AID for the first timeo Your system or site licensed XLS for the first timeo You are using Abend-AID or XLS for the first time.

    Subtopics:

      2.2.1 Extended Language Support  2.2.2 Basic Language Support

    2.2.1 Extended Language Support

    Subtopics:

      2.2.1.1 Collect Report Information

      2.2.1.2 Create a Sample Report

    2.2.1.1 Collect Report Information

      The information requested below will be helpful if Abend-AID and XLS arenew to your site or system, or if you are new to XLS. If XLS is new, youmay have to refer to an Abend-AID installer.

  • 8/17/2019 Abend-AID User Reference Guide Rel 9.2

    22/257

      ________________________________________________________________________| ||. Verify that Abend-AID reports are being automatically routed to a || report file by means of the global table, job table, or user exit. || Provide the name of the Abend-AID report file that you will use: || || || ||________________________________________________________________________|| || || ||. If report routing is by job name, identify the name required: || || || ||________________________________________________________________________|| || || ||. Identify the Compuware source listing file that you will use: || || |

    | ||________________________________________________________________________|| || || ||. Identify how you will access Abend-AID from ISPF, such as with a menu || option, CLIST, or other method: || || || ||________________________________________________________________________|| || |

    | ||. Identify the menu, PROC, or JCL member you will use to compile source || code with the Compuware language processor: || || || ||________________________________________________________________________|| || || ||. Identify any changes or special parameters required when you use the || activating menu, PROC, or JCL member: || |

    | || ||________________________________________________________________________|

    2.2.1.2 Create a Sample Report

  • 8/17/2019 Abend-AID User Reference Guide Rel 9.2

    23/257

      Create a sample abend and report for the orientation procedure thatfollows. You can identify an applicable program containing a sample abendin Appendix A, "Testing Samples." These samples are in the Abend-AIDinstallation library (SORMAC). If Abend-AID has been in use on yoursystem or at your site for more than several weeks, you probably havereports available. Or, make a change to a program or alter data to causethe program to abend.

    1. Obtain a sample abended program, or create your own, containing a S0C7,on-code 0320, or S0CB.

    2. Using the information you recorded in items 5 and 6 in topic 2.2.1.1above, compile the program incorporating the Compuware languageprocessor.

    3. Check the JOBLOG to make sure the Compuware language processorcompleted with a return code of 0 or 4.

    4. Run the program, making sure that it abends.

    If routing is by job name, make sure you run the job with an appropriatejob name. Refer to item 2 in the preceding section.

    2.2.2 Basic Language Support

    Subtopics:

      2.2.2.1 Collect Report Information  2.2.2.2 Create a Sample Report

    2.2.2.1 Collect Report Information

      The information requested below will be helpful if Abend-AID is new toyour site or system. If Abend-AID is new, you may have to refer to anAbend-AID installer.

    With Compuware/VF

     ________________________________________________________________________| ||. Verify that Abend-AID reports are being automatically routed to a || report file by means of the global table, job table, or user exit. |

    | Provide the name of the Abend-AID report file that you will use: || || || ||________________________________________________________________________|| || || ||. If report routing is by job name, identify the name required: || |

  • 8/17/2019 Abend-AID User Reference Guide Rel 9.2

    24/257

      | || ||________________________________________________________________________|| || || ||. Identify how you will access Abend-AID from ISPF, such as with a menu || option, CLIST, or other method: || || || ||________________________________________________________________________|| || || ||. Identify any changes or special parameters required when you use the || activating menu, PROC, or JCL member: || || || ||________________________________________________________________________|

    Without Compuware/VF: If your site does not use Compuware/VF:

     ________________________________________________________________________|. Identify your SDSF SYSUDUMP output: || ||________________________________________________________________________|

    2.2.2.2 Create a Sample Report

      Create a sample abend and report for the orientation procedure that

    follows. You can identify an applicable program containing a sample abendin Appendix A, "Testing Samples." These samples are in the Abend-AIDinstallation library (SORMAC). If Abend-AID has been in use on yoursystem or at your site for more than several weeks, you probably havereports available. Or, make a change to a program or alter data to causethe program to abend.

    1. Obtain a sample abended program, or create your own, containing a S0C7,on-code 0320, or S0CB.

    2. Run the program, making sure that it abends.

    If routing is by job name, make sure you run the job with an appropriate

    job name. Refer to item 2 in the preceding section.

    2.3 Accessing Abend-AID

      With Compuware/VF: Compuware/VF users typically access Abend-AID throughan ISPF/PDF menu, like the one shown below. Your menu selection presents

  • 8/17/2019 Abend-AID User Reference Guide Rel 9.2

    25/257

      the Compuware/VF Entry Panel. If you cannot access the entry panel fromyour menu, notify an Abend-AID installer.

     ____________________________________________________________________________  ______

    ||

    | ----------------------- ISPF/PDF PRIMARY OPTION MENU ------------------------ |

    | OPTION ===> A|

    | USERID - USER01 |

    | 0 ISPF PARMS - Specify terminal and user parameters TIME - 15:56 |

    | 1 BROWSE - Display source data or output listings TERMINAL - 3278 |

    | 2 EDIT - Create or change source data PF KEYS - 24|

    | 3 UTILITIES - Perform utility functions|

    | 4 FOREGROUND - Invoke language processors in foreground|

    | 5 BATCH - Submit job for language processing

    || 6 COMMAND - Enter TSO Command, CLIST, or REXX exec|

    | 7 DIALOG TEST - Perform dialog testing|

    | A ABEND-AID - Abend-AID|

    | C CSS - Compuware CSS Utilities|

    | S SDSF - System Display and Search Facility|

    | T TUTORIAL - Display information about ISPF/PDF|

    | XT XPEDITER/TSO - Compuware interactive test/debugging product|| X EXIT - Terminate ISPF using log and list defaults

    ||

    || Enter END command to terminate ISPF.

    ||

    ||

    ||

    ||

    ||____________________________________________________________________________ 

     ______|

    Figure 1. Sample ISPF/PDF Menu

  • 8/17/2019 Abend-AID User Reference Guide Rel 9.2

    26/257

      Without Compuware/VF: Without Compuware/VF, users typically access theAbend-AID report in their SDSF SYSUDUMP or ABENDAID output. The file willbe identified the same as an IBM dump of the abended program, but containinstead an Abend-AID report. Use scroll and search inside the report.

    2.4 Accessing and Browsing a Report

      If you are using Abend-AID without Compuware/VF, refer to "WithoutCompuware/VF" in the preceding section.

    The following procedure describes accessing and browsing an Abend-AIDreport through the Compuware/VF. The description differentiates XLS andbase language support and is directed toward a new Abend-AID installation.

    Note: You can find complete information about the screens referred to inthis procedure, including commands and field summaries, in "Understandingthe Compuware/VF Interface."

    1. Access the Compuware/VF Entry Panel as described in "AccessingAbend-AID."

    2. At the Compuware/VF Entry Panel (Figure 2), you specify report andsource listing datasets. You can also identify the remote MVS images,if applicable, that they're located on. Complete the steps below asapplicable, then press Enter.

    o For extended language support:a. Type 0 in the Dataset choice field to select the report dataset.

    To look only at a compiled source listing instead of a report,specify a source dataset (1 - 8).

    b. If necessary, name the report dataset on the 0 line and one ormore source listing datasets on the lines 1 - 8.

    c. If a dataset is located on a different MVS system, in the field

    Remote Server identify the Abend-AID server on that system. Atthe field Local Server SSID, identify the Abend-AID server on thelocal MVS system. Server IDs are assigned when the servers areconfigured for distributed viewing.

    d. Specify YES at Merge report+source.o For base language support:

    a. Type 0 in the Dataset choice field to select the report dataset.b. If necessary, name the report dataset on the 0 line.c. If a dataset is located on a different MVS system, in the field

    Remote Server identify the Abend-AID server on that system. Atthe field Local Server SSID, identify the Abend-AID server on thelocal MVS system. Server IDs are assigned when the servers areconfigured for distributed viewing.

     ____________________________________________________________________________  ______

    ||

    | COMPUWARE/VF ENTRY PANEL --------- COPYRIGHT COMPUWARE CORPORATION 1976, 1999. |

    | Command ===>|

  • 8/17/2019 Abend-AID User Reference Guide Rel 9.2

    27/257

      ||

    | Dataset choice . 0 (Select 0 - 8, from below, or C for Contact Data)  |

    | Member . . . . . (MVS:jobname, CICS:tran/term, SOURCE:pgm, or member*) |

    | Remote  |

    | Name Volume Server  |

    | Report . . 0 'AA.R900.CXR706.RPTFILE'|

    | Source(s). 1 'AA.R900.CXR706.LSTFILE'|

    | 2|

    | 3|

    | 4|

    | 5|

    | 6|

    | 7|| 8

    ||

    || Processing options: Source browsing options:

      || Merge report+source YES (Yes or no) Unit . . . . . VIO

    || Confirm delete . . YES (Yes or no) Blocking . . . 10

    || Show print setup . YES (Yes or no)

    || Show source warning YES (Yes or no, used only for Abend-AID)|

    | Language . . . . . USAMIX|

    | Local Server SSID . AA01 (Required for Viewing Remote DDIO files)|

    ||

    |____________________________________________________________________________  ______|

    Figure 2. Compuware/VF Entry Panel

    3. If you're accessing a dataset on a different MVS system, Compuware/VFwill present its Alternate Logon screen. Enter your user ID andpassword for the Abend-AID server on that system in the applicablefields.

     ____________________________________________________________________________ 

  • 8/17/2019 Abend-AID User Reference Guide Rel 9.2

    28/257

     ______|

    || ------------------------- COMPUWARE/VF ALTERNATE LOGON -------------------

    ----- || Command ===>

    ||

    ||

    ||

    ||

    || Logon attempt to AASRV01 requires a USERID/PASSWORD. Please

    || supply an alternate userid/password to complete access requirement

    || for DDIO file: AA.R900.CXR706.RPTFILE

    ||

    ||

    || Alternate USERID: PFHAJF0 SCROLL ===> PAGE |

    | ABEND-AID DATASET DIRECTORY|

    ||

    | S - View C - Contact Info D - Delete P - Print L - Lock U - Unlock|

    ||

  • 8/17/2019 Abend-AID User Reference Guide Rel 9.2

    29/257

      | JOBNAME REPT NUMBER JESID CODE DATE TIME DESCSIZE(K|

    | S TSS070CS 71 J08263 S0C7 05 MAR 1998 17.50.22 CLAYTON D31 |

    | TSS070CS (L) 70 J07553 U1035 05 MAR 1998 16.45.18 DONNA C15 |

    | TSM050TS 68 J09691 U0240 02 MAR 1998 9.11.49 WOODS15 |

    | TSM050TS (L) 67 J09465 S0C2 02 MAR 1998 8.51.20 T WOODS15 |

    | TSM030SN 66 J05446 SNAP 01 MAR 1998 16.33.07 T SMITH15 |

    | TSM020TX 65 J00942 S0C1 01 MAR 1998 9.31.15 GARY K15 |

    | TSM050TS 64 J00406 U1020 01 MAR 1998 8.42.12 WOODS TINA15 |

    | TSM050TS 63 J07030 S0C7 10 FEB 1998 16.54.14 KAYLOR G31 |

    | TSM050TS (L) 62 J06927 S0CB 10 FEB 1998 16.46.36 WOODS T31 |

    | TSM030LP 61 J05611 S0C7 10 FEB 1998 15.07.38 SMITH15 |

    | TSM030PL 59 J09984 S213 10 FEB 1998 14.50.09 T SMITH15 |

    | TSM050X1 (M) 58 J08064 SD37 08 FEB 1998 11.29.39 TINA WOODS15 || TSS070CS 57 J08885 S0C7 05 FEB 1998 16.53.20 DONNA C

    31 || TSA060RI 55 J00512 U2222 03 FEB 1998 13.54.07 RANDY S

    31 || TSA060RO 52 J08065 S0C7 02 FEB 1998 17.36.52 SMITH R

    31 || TSM020ST 51 J03476 S0CF 02 FEB 1998 10.19.17 KAYLOR G

    15 || TSA060RA 50 J09305 U2222 01 FEB 1998 15.41.46 RANDY S

    31 || TSA080PR 46 J05500 S0C7 01 FEB 1998 9.19.48 HEIDI M

    15 || TST020LB 45 J06929 SD37 31 JAN 1998 12.52.31 FRANKEN S15 |

    ||

    |____________________________________________________________________________  ______|

    Figure 4. Abend-AID Dataset Directory

    5. At the resulting Output Selection Menu (Figure 5), press Enter toobtain the report Header section. You can directly obtain any report

    section by entering its identification number or name in the SelectSection field.

    If a suitable source listing can't be found (XLS only) you will receivea notification screen. The screens are explained in "Source Warnings"in topic 2.6.

     ____________________________________________________________________________  ______

  • 8/17/2019 Abend-AID User Reference Guide Rel 9.2

    30/257

      ||

    | COMPUWARE/VF --------------- OUTPUT SELECTION MENU ----------------------|

    | SELECT SECTION ===>|

    ||

    | 'ABENDAID.REPORT.FILE' REPT.71 AA900XLS J08263|

    ||

    | 0 or HEADER - System, job, and client information|

    | 1 or DIAGS - Diagnostic information|

    | 2 or NSI - Next Sequential Instruction (location in program)|

    | 3 or REGS - Register contents and PSWs|

    | 5 or TRACE - Trace of program flow and program attributes|

    | 6 or PROG - Program Storage|

    | 7 or PLIST - Program Listing (XLS only)|| 8 or FILES - Data management control blocks

    || 9 or IMS - IMS diagnostic information and PCBs

    || 10 or IDMS - CA-IDMS diagnostic and status information

    || 11 or DB2 - DB2 diagnostic and status information

    || 12 or SORT - Current COBOL sort information

    || 13 or DATALOC - COBOL Data Locator

    || 14 or EPILOG - Abend-AID termination information|

    ||

    ||

    ||

    ||

    | Key section number or name and press ENTER.|

    | Or press ENTER to start at top of output and view sections 0 through 5. |

    ||

    |____________________________________________________________________________  ______|

    Figure 5. Output Selection Menu

  • 8/17/2019 Abend-AID User Reference Guide Rel 9.2

    31/257

      6. Scroll down to the Diagnostic section to see the text of the abendedstatement (XLS only) and information about all fields in the statement.Continue scrolling to the Trace section.

     ____________________________________________________________________________  ______

    ||

    | COMPUWARE/VF --------------------------------------- ROW 1 TO 17 OF 241|

    | COMMAND INPUT ===> SCROLL ===> PAGE|

    ||

    | 'ABENDAID.REPORT.FILE' REPT.71 AA900XLS J08263|

    ||

    | FRIDAY 10 APR 1998 H09.00.01 19980406-R09.00.01|

    | *****************************************************************|

    | * A b e n d - A I D D i a g n o s t i c s *

    || * *|

    | * Copyright (C) 1976, 1998, Compuware Corporation. *|

    | * Unpublished - Rights Reserved Under The *|

    | * Copyright Laws Of The United States. *|

    | * Licensed for use at: *|

    | * COMPUWARE CORPORATION *|

    | * Company Number: T0TECH *|| *****************************************************************

    ||

    || Model - 9672 OPSYS - OS/390 1.3.0 Job - AA900016

    || CP FMID - HBB6603 Step - VSTEST

    || System - CW01 Time - 10.01.12

    || DFSMS/MVS - V1R3M0

    || JES2 - OS 1.3.0

    ||

    || Completion Code - S0CB

    ||

    ||____________________________________________________________________________ 

  • 8/17/2019 Abend-AID User Reference Guide Rel 9.2

    32/257

     ______|

    Figure 6. Header Section

    Note: You can activate these functions at the COMMAND INPUT fieldwithin the report:

    o Obtain any report section by entering its menu number or nameo Search for specific data with the F (Find) commando Suppress source information by entering Source On and Source Off (XLS

    only).

    For complete information about functions available within the reportrefer to "Output Selection Menu" in topic 13.1.5 or "Report Commands"in topic 2.5.

     ____________________________________________________________________________  ______

    ||

    | COMPUWARE/VF -------------------------------------------- ROW 20 TO 36 OF129 |

    | COMMAND INPUT ===> SCROLL ===> PAGE ||

    || 'ABENDAID.REPORT.FILE' REPT.71 AA900XLS J08263

    ||

    || **********************

    || * Diagnostic Section *

    || **********************

    |||

    ||

    | A Data Exception occurred in program PAYROLLX in the following statement  |

    ||

    | 000115 SUBTRACT TCR-TOTAL-TAXES FROM TCR-GROSS-PAY|

    | 000116 GIVING WS-NET-PAY|

    ||

    ||

    | Current values of fields on abending statement|

    | Level/Field Name Picture/Type Offs Value|

    | ---------------------------------- ----------------- ----+----1----+----2  |

  • 8/17/2019 Abend-AID User Reference Guide Rel 9.2

    33/257

      | 02 TCR-TOTAL-TAXES 9(4)V99 013222|

    | 02 TCR-GROSS-PAY # 9(5)V99 X'7C7CF3F3F1F1F0'|

    | 77 WS-NET-PAY # S9(5)V99 COMP-3 X'CC33110F'|

    | 02 RPT-GROSS-PAY $ZZ,ZZZ.99 $ 1,203.33|

    | --------------------------------------------------------------------------- |

    ||

    |____________________________________________________________________________  ______|

    Figure 7. Diagnostic Section

    7. Sections after the Trace section can be selected individually at theCOMMAND INPUT field. Enter 6 on the command input line to see theProgram Storage (PROG) section.

     ____________________________________________________________________________  ______|

    || COMPUWARE/VF ------------------------------------------ ROW 96 TO 112 OF 1

    29 || COMMAND INPUT ===> 6 SCROLL ===> PAGE

    ||

    || 'ABENDAID.REPORT.FILE' REPT.71 AA900XLS J08263

    ||

    || **********************|

    | * Call Trace Summary *|

    | **********************|

    ||

    | ******Calling****** ***Return*** ******Called*******|

    | Load-Mod Program Type Value Program Load-Mod|

    ||

    | *SYSTEM Calls PAYROLLX PAYLOAD *  |

    | PAYLOAD PAYROLLX DISP 000007A2 Calls IGZCSPA IGZCPAC|

    | Program Causing Error *|

    ||

  • 8/17/2019 Abend-AID User Reference Guide Rel 9.2

    34/257

      ||

    | ******************************************************************|

    | * Application Program Attributes *|

    | ******************************************************************|

    ||

    | Load-Mod Program Compile Date Length Language|

    | PAYLOAD PAYROLLX 15 FEB 1998 00000FB8 VS COBOL II V1R3M2|

    | **************************** BOTTOM OF DATA ****************************|

    ||

    |____________________________________________________________________________  ______|

    Figure 8. Trace Section

    8. If more than one program was on the calling chain at the time of theabend, you will see a Program Storage Selection List (Figure 9).Select a program by entering S to the left of the program name.

     ____________________________________________________________________________  ______

    ||

    | COMPUWARE/VF PROGRAM STORAGE SELECTION LIST ---------------- ROW 1 TO 2 OF 2 |

    | COMMAND INPUT ===> SCROLL ===> P

    AGE |||

    | PROGRAM / PROCEDURE NAME LOAD LANGUAGE COMPILE DATE -TIME  |

    ||

    | S PAYROLLX PAYLOAD VS COBOL II 15 FEB 1998 11:23:36 |

    | UPDATE PAYLOAD VS COBOL II 15 FEB 1998 11:24:10 |

    | ******************************* BOTTOM OF DATA ******************************* |

    ||

    Figure 9. Program Storage Selection List

    9. You will see the Working-Storage and Linkage sections of the program(Figure 10). You may have to press the Down key once or twice tobypass the compiler options information. Enter 7 on the command lineto see the Program Listing (PLIST) section.

  • 8/17/2019 Abend-AID User Reference Guide Rel 9.2

    35/257

      ____________________________________________________________________________  ______

    ||

    | COMPUWARE/VF-------------------------------------------ROW 39 TO 57 OF 163|

    | COMMAND INPUT ===> 7 SCROLL ===> PAGE|

    ||

    | 'ABENDAID.REPORT.FILE' REPT.71 AA900XLS J08263|

    ||

    | Working-Storage Section|

    ||

    | Working storage referenced by BLW cell 0 (X'0')|

    ||

    | Level/Field Name Picture/Type Offs Value|| ---------------------------------- ----------------- ----+----1----+----2

      || 77 WS-RECORD-CTR S999 COMP-3 +4

    || 77 WS-TOTAL-NET-PAY S9(7)V99 COMP-3 +339117

    || 77 WS-NET-PAY S9(5)V99 COMP-3 X'CC33110F'

    || 77 WS-EMP-NO 9(8) 04060293

    || 01 WS-TIMECARD-REC

    || 02 TCR-EMP-NO 9(8) 04060293|

    | 02 TCR-MONTH-CODE 99 02|

    | 02 TCR-EMP-NAME X(32) EDWARDS, ALEXANDER|

    | 02 TCR-GROSS-PAY 9(5)V99 X'7C7CF3F3F1F1F0'|

    | 02 TCR-TOTAL-TAXES 9(4)V99 013222|

    ||

    ||

    ||

    ||

    |____________________________________________________________________________  ______|

  • 8/17/2019 Abend-AID User Reference Guide Rel 9.2

    36/257

      Figure 10. Program Storage Section (Working Storage)

    10. If more than one program is available, you will see a Program ListingSelection List similar to the Program Storage Selection List inFigure 9. Select a program by entering S to the left of the programname.

    11. You will see the paragraph containing the current statement(Figure 11). The command PLIST ALL will show the complete division orlisting. To return to the Output Selection Menu, press the End key.You may have to press it more than once.

     ____________________________________________________________________________  ______

    ||

    | COMPUWARE/VF---------------------------------------------ROW 1 TO 24 OF 24 |

    | COMMAND INPUT ===> SCROLL ===> PAGE  |

    ||

    | 'ABENDAID.REPORT.FILE' REPT.71 AA900XLS J08263||

    || **********************************************************************

      || * Program Listing Section - PAYROLLX *

      || **********************************************************************

      ||

    || 000100 READ-A-RECORD.

    || 000101 READ TIMECARD INTO WS-TIMECARD-REC|

    | 000102 AT END GO TO END-OF-JOB.|

    | 000103 MOVE WS-TIMECARD-REC TO MASTER-RECORD.|

    | 000104 ADD 1 TO WS-RECORD-CTR.|

    | 000105 IF TCR-EMP-NO > WS-EMP-NO|

    | 000106 MOVE TCR-EMP-NO TO WS-EMP-NO|

    | 000107 ELSE|

    | 000108 DISPLAY 'EMPLOYEE# SEQ ERROR ',|

    | 000109 TCR-EMP-NO,|

    | 000110 SPACE,|

    | 000111 WS-EMP-NO UPON SYSOUT,|

  • 8/17/2019 Abend-AID User Reference Guide Rel 9.2

    37/257

      | 000112 GO TO READ-A-RECORD.|

    | 000113 MOVE TCR-EMP-NO TO RPT-EMP-NO.|

    | 000114 MOVE TCR-EMP-NAME TO RPT-EMP-NAME.|

    ||

    |____________________________________________________________________________  ______|

    Figure 11. Program Listing Section

    12. If your program has open files, you may want to view the File sectionby entering 8.

     ____________________________________________________________________________  ______

    ||

    | COMPUWARE/VF --------------- OUTPUT SELECTION MENU ----------------------|

    | SELECT SECTION ===> 8||

    || 'ABENDAID.REPORT.FILE' REPT.71 AA900XLS J08263

    ||

    || 0 or HEADER - System, job, and client information

    || 1 or DIAGS - Diagnostic information

    || 2 or NSI - Next Sequential Instruction (location in program)

    || 3 or REGS - Register contents and PSWs|

    | 5 or TRACE - Trace of program flow and program attributes|

    | 6 or PROG - Program Storage|

    | 7 or PLIST - Program Listing (XLS only)|

    | 8 or FILES - Data management control blocks|

    | 9 or IMS - IMS diagnostic information and PCBs|

    | 10 or IDMS - CA-IDMS diagnostic and status information|

    | 11 or DB2 - DB2 diagnostic and status information|

    | 12 or SORT - Current COBOL sort information|

    | 13 or DATALOC - COBOL Data Locator|

    | 14 or EPILOG - Abend-AID termination information|

  • 8/17/2019 Abend-AID User Reference Guide Rel 9.2

    38/257

      ||

    ||

    ||

    ||

    | Key section number or name and press ENTER.|

    | Or press ENTER to start at top of output and view sections 0 through 5. |

    ||

    |____________________________________________________________________________  ______|

    Figure 12. Output Selection Menu

    13. If more than one file is open at the time of abend, you will see alist of all open files on the File Summary Selection List (Figure 13).Select the file you want to view by entering S to the left of the file

    name. To open a file through File-AID's edit or browse modes, enter Eor B.

     ____________________________________________________________________________  ______

    ||

    | COMPUWARE/VF FILE SUMMARY SELECTION LIST ------------------ ROW 1 TO 8 OF 8 |

    | COMMAND INPUT ===> SCROLL ===> PAGE |

    |

    || S - view file control blocks E - File-AID Edit B - File-AID Browse|

    | (except JES spooled datasets)|

    ||

    | DDNAME DEVICE UNIT VOLSER DISP AMTYPE EXCPS ------ DCB INFORMATION ------- |

    ||

    | OUTLIST JES2 spooled QSAM 81 (DSORG=PS,RECFM=FBA,|

    | LRECL=133,BLKSIZE=13300)  |

    | MASTER 3380 3AB CWX018 NEW QSAM 0 (DSORG=PS,RECFM=FBA,|

    ||

    | S TIMECARD VSAM 1|

    | SYSUT1 3380 2C9 SMS801 SHR VSAM 4|

  • 8/17/2019 Abend-AID User Reference Guide Rel 9.2

    39/257

      | SYSUT1 3380 2C9 SMS801 SHR BDAM 4 (DOSORG=DA,RECFM=F,|

    | LRECL=121,BLKSIZE=12100)  |

    | ******************************* BOTTOM OF DATA **************************|

    ||

    ||

    ||

    ||

    ||

    ||

    ||

    ||

    |____________________________________________________________________________  ______|

    Figure 13. File Summary Selection List

    14. Press the Down key to view the complete file information (Figure 14).Press the End key to return to the File Selection Menu. Press Endagain to return to the Output Selection Menu.

     ____________________________________________________________________________  ______

    |

    || COMPUWARE/VF -------------------------------------------- ROW 1 TO 24 OF 36 |

    | COMMAND INPUT ===> SCROLL ===> PAGE |

    ||

    | 'ABENDAID.REPORT.FILE' REPT.71 AA900XLS J08263|

    ||

    | Data Management Control Blocks for DDNAME - TIMECARD|

    ||

    | DSNAME=CWV.TSO000.AA.TIMECARD|

    | ACC METH=VSAM|

    ||

    | File EXCP Count=1|

  • 8/17/2019 Abend-AID User Reference Guide Rel 9.2

    40/257

      ||

    | File Summary:|

    ||

    | Access type........BASE CLUSTER|

    | Dataset type.......ESDS|

    | Processing type....ADR,AMODE31,NFX,DDN,NDF,SEQ,NCI,IN,NIS,NRM,NRS,NSR,|

    | NUB|

    ||

    | File errors........None|

    ||

    | Current record:|

    ||

    | 00044F70 CHAR 4058829912DOE, WILLIAM T. 00|@#200||

    ||____________________________________________________________________________ 

     ______|

    Figure 14. File Section

    15. Exit Compuware/VF by entering End at Select Section.

     ____________________________________________________________________________  ______|

    || COMPUWARE/VF --------------- OUTPUT SELECTION MENU ----------------------

    || SELECT SECTION ===>

    ||

    || 'ABENDAID.REPORT.FILE' REPT.71 AA900XLS J08263

    ||

    || 0 or HEADER - System, job, and client information

    || 1 or DIAGS - Diagnostic information

    || 2 or NSI - Next Sequential Instruction (location in program)

    || 3 or REGS - Register contents and PSWs

    || 5 or TRACE - Trace of program flow and program attributes

  • 8/17/2019 Abend-AID User Reference Guide Rel 9.2

    41/257

      || 6 or PROG - Program Storage

    || 7 or PLIST - Program Listing (XLS only)

    || 8 or FILES - Data management control blocks

    || 9 or IMS - IMS diagnostic information and PCBs

    || 10 or IDMS - CA-IDMS diagnostic and status information

    || 11 or DB2 - DB2 diagnostic and status information

    || 12 or SORT - Current COBOL sort information

    || 13 or DATALOC - COBOL Data Locator

    || 14 or EPILOG - Abend-AID termination information

    ||

    ||

    ||

    |||

    | Key section number or name and press ENTER.|

    | Or press ENTER to start at top of output and view sections 0 through 5. |

    ||

    |____________________________________________________________________________  ______|

    Figure 15. Output Selection Menu

    2.5 Report Commands

      You can scroll through the first five report sections. Other sectionsmust be accessed individually. Enter the section number or name in theCOMMAND INPUT field. Inside the report use standard scrolling commands.

    The commands summarized below are also available.

    Subtopics:

      2.5.1 Source Command  2.5.2 F (Find) Command

    2.5.1 Source Command

  • 8/17/2019 Abend-AID User Reference Guide Rel 9.2

    42/257

      You can suppress the presence of source information in the report or lookat a directory listing of the members in your source datasets. The SOURCEcommand is available when YES is specified in the Merge report+sourcefield on the Entry Panel.

    Apply SOURCE in the COMMAND INPUT field of any report section containingsource information or in the SELECT SECTION field of the Output Selectionmenu.

    Source OnDefault. Display source. Applicable only to the open report.

    Source OffSuppress source.

    Source MismatchWhen you're working with COBOL or PL/I XLS, this command presents asource warning screen at which you can access a directory listing ofthe source datasets specified on the Entry Panel. For Assembler XLS,it directly presents the directory listing.

    2.5.2 F (Find) Command

      When viewing a report section, use the F (Find) command to search forspecific characters or character strings within the section:

    Note: The word Find cannot substitute for any of the following syntax.

    F xxxFinds the characters specified by xxx in the current report section.Ignores letter case.

    F 'xxx yyy'Finds the character string specified by 'xxx yyy' with embedded blanks.Ignores letter case.

    FFinds the character string specified in the previous FIND command.Ignores letter case. Use this command instead of the key.

    FS xxxFinds the characters specified by xxx in the current report section.Case-sensitive.

    FS 'xxx yyy'Finds the character string specified by 'xxx yyy' with embedded blanks.Case-sensitive.

    FSFinds the character string specified in the previous FIND command.Case-sensitive. Use this command instead of the key.

    2.6 Source Warnings

  • 8/17/2019 Abend-AID User Reference Guide Rel 9.2

    43/257

      You receive a source warning if the following conditions are in effect:

    o You entered YES in the Merge report+source field on the Entry Panel.o You entered YES in the Show source warning field on the Entry Panel.o The source listing files specified on the Entry Panel do not contain asource listing that matches the program identified in the selectedreport.

    When you recompile your program to create a listing to be placed in thesource listing file, several factors can affect the matching of there-created listing with the original program object module. These factorsinclude the following:

    o The source program and any included source code must be the same.o Compiler levels must be the same.o Compiler options affecting object code generation, such as OPTIMIZE,must be the same.

    As a result, you may encounter the following warning screens.

    Subtopics:

      2.6.1 COBOL Mismatched Date and Time  2.6.2 PL/I Mismatched Structure  2.6.3 Assembler Unmatched Source Listing  2.6.4 Available Source Listings  2.6.5 Source-Not-Found

    2.6.1 COBOL Mismatched Date and Time

      When the compile date and time of a COBOL program being diagnosed does notmatch a program in the source listing file, you receive the Mismatched

    Date and Time Warning, shown in Figure 16. You also obtain this screenwith the SOURCE MISMATCH command.

     ____________________________________________________________________________  ______

    ||

    | COMPUWARE/VF --------------------------------------------------------- --  |

    | COMMAND INPUT ===>|

    ||

    | 'CWX0236.BD60.RAAP' REPT.(L) 13 AA900XLS J07490|

    ||

    | * * * * * * * * * * * * W A R N I N G * * * * * * * * * * * *|

    | * Program Most recent listing *|

    | * ------------------------------------------------------- *|

  • 8/17/2019 Abend-AID User Reference Guide Rel 9.2

    44/257

      | * Name: WTP#1074 WTP#1074 *|

    | * Load: WTPLI1 *|

    | * Date: 10 MAY 1998 12 MAY 1998 *|

    | * Time: 16:07:14 16:16:18 *|

    | * *|

    | * The program date and time stamp does not match a source listing.*|

    | * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *|

    ||

    | Type an S next to the desired option and press ENTER.|

    ||

    | _ Use the MOST RECENT source listing shown above|

    | _ Display available source listings|

    | _ Provide BASIC support without a source listing||

    || Enter END command to exit.

    ||

    ||____________________________________________________________________________ 

     ______|

    Figure 16. COBOL Mismatched Date and Time Warning

    From this screen, you can choose one of the following:

    o Continue with the most recent available source listingo Display available source listingso Continue without source supporto Exit the selected section.

    2.6.2 PL/I Mismatched Structure

      When the compile time of a PL/I program is not in the load module,Abend-AID can't report it. A mismatch results. When a PL/I date or timemismatch occurs, Abend-AID automatically checks the most recent sourcelisting for matching program structure. If the structures do not match,you receive the Mismatched Structure Warning, shown in Figure 17. Youalso obtain this screen with the SOURCE MISMATCH command.

     ____________________________________________________________________________  ______

  • 8/17/2019 Abend-AID User Reference Guide Rel 9.2

    45/257

      ||

    | COMPUWARE/VF ------------------------------------------------------------  |

    | COMMAND INPUT ===>|

    ||

    | 'CWX0236.BD60.RAAP' REPT.(L) 10 AA900XLS J04452|

    ||

    | * * * * * * * * * * * * W A R N I N G * * * * * * * * * * * *|

    | * Program Most recent listing *|

    | * ------------------------------------------------------- *|

    | * Name: WTP#1074 WTP#1074 *|

    | * Load: WTPLI1 *|

    | * Date: 03 MAR 1998 12 MAR 1998 *|

    | * Time: 10:46:18 16:16:18 *|| * *

    || * The selected source listing for program WTP#1074 exists, but *

    || * its internal structure does not match the program in the *

    || * Abend-AID report. *

    || * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *

    ||

    || Type an S next to the desired option and press ENTER.|

    ||

    | _ Display available source listings|

    | _ Provide BASIC support without a source listing|

    ||

    | Enter END command to exit.|

    ||

    |____________________________________________________________________________  ______|

    Figure 17. PL/I Mismatched Structure Warning

    From this screen, you can choose one of the following:

  • 8/17/2019 Abend-AID User Reference Guide Rel 9.2

    46/257

      o Display available source listingso Continue without source supporto Exit the selected section.

    2.6.3 Assembler Unmatched Source Listing

      Due to the characteristics of Assembler, Abend-AID may not be able toreliably identify a matching source listing file for Assemblerdiagnostics. In this case you will receive a directory similar to the oneshown in Figure 18. Select the member you need.

    The directory is immediately presented when Abend-AID can't identify amatching source listing for Assembler diagnostics. In a diagnostic reportfor Assembler, you can also obtain this directory with the SOURCE MISMATCHcommand.

     ____________________________________________________________________________  ______

    ||

    | COMPUWARE/VF - ------------------------------------------- ROW 1 TO 12 OF 57 || COMMAND INPUT ===> SCROLL ===> P

    AGE ||

    || CSECT Name: AAAASOC1

    || Assembled: 04 JUN 1998 Load module: MODUS0C1

    ||

    || The CSECT name and date do not uniquely match a source listing.

    || Type an S next to the correct source listing and press the ENTER key,|

    | or enter the END command to view the report without a source listing.|

    ||

    | ASSEMBLER SOURCE LISTING DATASET DIRECTORY|

    | PROGRAM LIST NUMBER ASMB DATE TIME RC LANGUAGE SIZE(K)|

    | -----------'TEST.SOURCE.DDIO'------------------------------------------|

    | CCAADEMO (L) 3 01 JUN 1998 16.02.02 00 HLASM R2 127 KB|

    | TMCICS0A 2 01 JUN 1998 11:08:18 00 HLASM R2 287 KB|

    | CCAADEMO 1 01 JUN 1998 09.41.10 00 HLASM R2 95 KB|

    | AA01DEMO (M) 2 01 JUN 1998 12.40.10 00 HLASM R2 95 KB|

    | AAMYDEMO (L) 1 01 JUN 1998 10.39.10 00 HLASM R2 95 KB|

  • 8/17/2019 Abend-AID User Reference Guide Rel 9.2

    47/257

      ||

    Figure 18. Assembler Mismatch Warning

    2.6.4 Available Source Listings

      If you choose Display available source listings in response to mismatchwarnings for COBOL and PL/I disgnostics, you receive a Dataset Directorysimilar to the one shown in Figure 19.

    You can use these commands in the directory:

    B: Browse.D: Delete.L: Lock.P: Print.S: Select.U: Unlock.

     ____________________________________________________________________________  ______|

    || COMPUWARE/VF ----------------------------------------------- ROW 1 TO 13

    OF 13 || COMMAND INPUT ===> SCROLL ===> P

    AGE || SOURCE LISTING DATASET DIRECTORY

    || PROGRAM LIST NUMBER COMP DATE TIME RC LANGUAGE SIZE

    || ---------- 'CWX0236.TECH.FIL1169.SLS2' -------------------------------

    || WTP#1074 (L) 16 05 MAY 1998 16:16:18 00 PL/I V2 48 KB|

    | WTP#1074 8 29 MAR 1998 09:16:26 00 PL/I V2 32 KB|

    | ---------- 'CWX0236.TECH.FIL1169.SLS1' -------------------------------|

    | WTP#1074 (L) 17 04 MAY 1998 10:49:45 00 PL/I V2 82 KB|

    | WTP#1074 16 03 MAR 1998 09:16:26 00 PL/I V2 82 KB|

    | ---------- 'CWX0236.BD60.SLSP' ---------------------------------------|

    | WTP#1074 (L) 19 05 MAY 1998 16:16:18 00 PL/I V2 44 KB|

    | WTP#1074 (L) 12 04 FEB 1998 10:49:45 00 PL/I V2 40 KB|

    | WTP#1074 (L) 10 02 FEB 1998 09:16:26 00 PL/I V2 32 KB|

    ||

    | ******************************* BOTTOM OF DATA ******************************* |

  • 8/17/2019 Abend-AID User Reference Guide Rel 9.2

    48/257

      ||

    Figure 19. Source Listing Dataset Directory

    2.6.5 Source-Not-Found

      You receive the warning shown in Figure 20 when the program name andlanguage identified in the report can't be found in a specified sourcelisting file.

     ____________________________________________________________________________  ______

    ||

    | COMPUWARE/VF ------------------------------------------------------------  |

    | COMMAND INPUT ===>|

    |

    || 'CWX0236.DD57.RAA1' REPT.(L) 7 AA900XLS J17222|

    ||

    | * * * * * * * * * * * * W A R N I N G * * * * * * * * * * * * *|

    | * *|

    | * An appropriate source listing could not be found. *|

    | * *|

    | * Either: *|| * 1. a source listing for program JBERNAT does not *

    || * exist, or *

    || * 2. a source listing exists, but it does not match *

    || * the compiler language and release of the program *

    || * in the Abend-AID report. *

    || * *

    || * *

    || * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *

    ||

    || Press ENTER to continue without a source listing.

    ||

  • 8/17/2019 Abend-AID User Reference Guide Rel 9.2

    49/257

      || Enter END command to exit.

    ||

    ||____________________________________________________________________________ 

     ______|

    Figure 20. Source-Not-Found Warning

    From this screen, you can choose one of the following:

    o Continue without source supporto Exit the selected section.

    2.7 Y2K Rapid Response

      Abend-AID is one of the find-and-fix tools in Compuware's Y2K RapidResponse survival kit. In addition to diagnostic reporting at the time ofabend, several Abend-AID facilities enable applications programmers to

    respond as quickly as possible to program faults that may be associatedwith Y2K and Euro-currency program changes. These facilities provideadvantages in development and testing stages, as well as duringproduction.

    Abend-AID's Rapid Response advantages, summarized below, require thecurrent release (7.6) of Compuware Shared Services. For completeinformation refer to the Compuware Shared Services User/Reference Guide orthe Compuware/VF online help. You can also find additional informationabout the report Data Locator section in "Diagnosing a COBOL Data-RelatedError."

    | File-AID Access: Abend-AID users can keystroke directly into a Compuware| File-AID product from an Abend-AID report:

    | o From the File section you can access File-AID/MVS.| o From the DB2 section you can access File-AID/DB2.| o From the IMS section you can access File-AID/IMS.

    | Edit and Browse commands in the report take you into File-AID edit and| browse modes within a dataset or database. A current version of the| applicable File-AID product must be available on the operating system.

    Data Locator: An online report section for COBOL diagnostics presents all

    data-related source and fields, including Millenium Language Extensionsmodifications if MLE is active. Selecting COBOL Data Locator on theoutput menu shows you all formats used and flags data or formats that maybe invalid.

    Access the Data Locator section as you would any report section. Datalocator specifications may be customized for any data strings or fields.

    Source Comparison: A CSS batch utility command enables you to compare any

  • 8/17/2019 Abend-AID User Reference Guide Rel 9.2

    50/257

      two source listings in a source listing file. The Flag command identifiesany lines in a more recent listing that differ from a previous listing.You can also compare listings in different source listing files.

    Contact Information: You can attach a contact name and additionalinformation to an abended job for future reference. Access the ContactInformation summary from the Abend-AID Primary Menu, the Entry Panel, orthe Abend-AID Dataset Directory.

    CSS Utilities: With the CSS Utilities you can modify compile JCL topreprocess or postprocess source code for XLS, or create and format reportand source listing files, all by entering specifications on ISPF panels.These operations previously involved JCL preparation and were typicallydone by a systems programmer. Access the utilities through the Abend-AIDPrimary Menu.

    3.0 Diagnosing a COBOL Data-Related Error  This chapter describes how to use Abend-AID to diagnose a common COBOL

    error. Abend-AID provides two levels of COBOL support: extended languagesupport and basic language support.

    Subtopics:

      3.1 Resolving an S0C7 with Extended Language Support  3.2 COBOL Data Locator  3.3 Compiling for Basic Language Support  3.4 Resolving an S0C7 with Basic Language Support

    3.1 Resolving an S0C7 with Extended Language Support

      When you select a report section online through the Compuware ViewingFacility (Compuware/VF), with the applicable Compuware language processorin use, program source code can be automatically merged into the report.An Abend-AID report containing source code comprises Abend-AID extendedlanguage support.

    COBOL XLS provides:

    o The source code of the statement in error, shown in the Diagnosticsection. For data-related errors, all COBOL fields in the statement inerror are shown with their attributes and current values.

    o The source code of the statement being executed, shown in theInstruction section.

    o The names and contents of all individual COBOL fields in workingst