Compuware Test Drive Using Abend-AID for Batch - COBOL Drive/AA...This takes you to the COBOL...

of 23/23
1 Compuware Test Drive Using Abend-AID for Batch - COBOL Revised: 11/6/2020 This test drive will guide you through the basic functionality of Abend-AID for Batch under Topaz workbench with an abending program written in COBOL.
  • date post

    31-Aug-2020
  • Category

    Documents

  • view

    1
  • download

    0

Embed Size (px)

Transcript of Compuware Test Drive Using Abend-AID for Batch - COBOL Drive/AA...This takes you to the COBOL...

  • 1

    Compuware Test Drive

    Using Abend-AID for Batch - COBOL Revised: 11/6/2020

    This test drive will guide you through the basic functionality of Abend-AID for Batch under Topaz

    workbench with an abending program written in COBOL.

  • The Mainframe Software Partner for the Next 50 Years

    2

    Table of Contents

    Bringing up Abend-AID..................................................................................................................... 3

    The Diagnostic Section ..................................................................................................................... 8

    Program Detail Panel ..................................................................................................................... 10

    File Summary Panel ........................................................................................................................ 19

    Program Summary Panel ............................................................................................................... 22

    NEXT STEPS .................................................................................................................................... 23

  • The Mainframe Software Partner for the Next 50 Years

    3

    Bringing up Abend-AID

    To access Abend-AID for Batch within Topaz workbench,

    • Click on the Compuware tab.

    • Click on Operations,

    • Click on Abend-AID,

    • Click on Testdrive.

    It opens up a new view containing the Abend-AID Logon panel.

  • The Mainframe Software Partner for the Next 50 Years

    4

    Double-click on the tab for the Abend-AID view to maximize the view. Enter your test drive ID and password, and then press enter:

    Upon successful logging on, it will then take you to the Abend-AID main menu:

    In addition to the 6 icons that are displayed, there are 2 other icons on this panel of note.

    Click on the tool icon to display the dropdown menu:

    Click on the ‘Command Line’:

  • The Mainframe Software Partner for the Next 50 Years

    5

    Abend-AID has a number of commands that you can invoke through the Command Line. These will be discussed later in the test drive.

    Close the Command Line pop-up.

    In addition to the icons, you can also select which section you want to go to through the menu icon.

    Click on the menu icon to bring up the drop-down menu:

    From any panel, you can click on the menu icon and go to one of the listed sections.

    For the purposes of this test drive, we will be looking at the Fault Summary icons.

    Click on Fault Summary and it will take you to the following screen

    The Fault Summary panel displays a summary of the batch, CICS, IMS, and SVC dumps that were generated by job name, CICS region name, IMS message region name, etc. Under each column, are the counts of the number of abends for the respective job. In addition, the first entry under

    the Job Name is ‘Total Entries’.

  • The Mainframe Software Partner for the Next 50 Years

    6

    This row is the total number of abends for each column. Note that the job name column entries as well as the abend counts are hyperlinked. Therefore, you can click on any one of those individual fields, and it will take you to the report directory for those specific abends and Job Name.

    One other capability on this panel are the asterisks under the job name. These are masking characters that you can specify a specific job name or a portion of one.

    Enter CWEZ in columns 1-4 in the asterisks:

    Press :

  • The Mainframe Software Partner for the Next 50 Years

    7

    All jobnames will be filtered out other than those that start with CWEZ. You can then select the job that you want to look at and on the next panel it would take you to the Abend-AID directory.

    Click on CWEZXXXX hyperlink. This will take you to the report directory for the jobname CWEZXXXX:

    You display the Abend-AID report you want to view one of two ways:

    Click on entry number 0017226, and it will take you to the Diagnostic report, or

    Click on the menu icon to the left of the entry 0017226 to display the dropdown menu, and select ‘diag’ to go to the diagnostic section

    ,

  • The Mainframe Software Partner for the Next 50 Years

    8

    The Diagnostic Section

    The Diagnostic Section provides important information about the abend that occurred. Within this section, you can see the line of code where the abend occurred, the values of the variables that comprise the abending instruction, as well as many other hyperlinked fields that you can click on which will drill down to other sections relevant to the field you selected.

  • The Mainframe Software Partner for the Next 50 Years

    9

    The first line of the diagnostic section contains a hyperlink that will take you to significant information about the abending program and application that invoked it.

    On the first line of the Diagnostic Section, click on the CWAAHOUR hyperlink:

  • The Mainframe Software Partner for the Next 50 Years

    10

    Program Detail Panel

    The program detail panel provides information about the program that abended.

    Click on the STEPLIB hyperlink

    This takes you to a panel that shows you the STEPLIB concatenation.

    The library where the modules loaded from will be highlighted.

    Press will bring you back to the Program Detail panel.

  • The Mainframe Software Partner for the Next 50 Years

    11

    To view your compiled listing, click on the ‘Listing’ hyperlink.

    This will take you directly into your compiled listing at the last instruction that was processed (the abending):

    Click on the ‘Previous’ tab, to bring up the previous page of the listing Scroll down until you can see lines 68-82:

  • The Mainframe Software Partner for the Next 50 Years

    12

    Abend-AID has a very useful command called ‘Peek’. This is similar to the Xpediter command ‘Peek’, where you can view the value of any variable in your listing. The format of the ‘Peek’ command, in Abend-AID, is to place a P in the first column of the line number, and in the second column of the line number, which variable on the line you want to see the value of. For example, we want to see the value of the variable H-EMP-HOURS of line number 78.

    To utilize the ‘Peek’ command, place a P in column 1 of line number 78, and since H-EMP-HOURS is the second variable on that line, enter 2 in the second column of the line number

    Press . You will then be taken to another panel that will display the value of H-EMP-HOURS:

    Note: the ‘Peek’ command is available any time you are viewing the actual listing.

  • The Mainframe Software Partner for the Next 50 Years

    13

    Press to return to the previous panel (which is the listing). Press again to return to the Program Detail panel.

    To view your storage areas, click on the Storage Areas hyperlink.

    This takes you to the COBOL storage areas panel:

  • The Mainframe Software Partner for the Next 50 Years

    14

    Click on the File Section tab to see any of the data from your FD statements (if this is a mainline module):

    Notice that because this is a subroutine, there is no File Section. Abend-AID generates a message to let you know that it will position you on the next area, which will be the working storage. In this section you will see the field name, the picture type, and the value of every variable in storage. Also, notice that there are hyperlinks for the actual values in storage.

    Cursor over to the value of HOURLY-EMP-RATE (025) and click. This brings you to the Expanded Data Field panel where you can view that value in both zone decimal and in character mode:

    the Expanded Data Field section is especially helpful when a field contains a mixture of display, binary, and packed decimal fields.

    Press twice to return back to the ‘COBOL Storage Areas’ panel. Click on the Linkage Section tab and click. This takes you to the linkage section:

  • The Mainframe Software Partner for the Next 50 Years

    15

    Here you will see the fields that comprise the linkage section, the picture types, and the value of each variable.

    Press twice to return to the program detail panel:

    The rest of the information on this panel concerns general program information.

    Press to return to the diagnostic section.

    There are many hyperlinked areas in the diagnostic section. Here is some of the information that is available: The abending line of code is displayed. The line number is hyperlinked.

  • The Mainframe Software Partner for the Next 50 Years

    16

    • The variables that comprise the line of code are displayed along with your picture types in the value at the time of the abend:

    • Abend-AID also provides an English explanation of what the abend was, as well as any IBM messages that accompany the abend.

    • The Program Information subsection provides basic information about when which load library or program object library the module was loaded from, as well as when it was bound:

    • The Last Call or I/O subsection provides information about the last program call or I/O statements that were executed prior to the abend in the paragraph where the statement resided:

    • The Call Trace Summary is one of the more important subsections within the diagnostic section. This subsection displays the sequence of programs that are called from the initial program to the point that the abend occurs:

    You’ll notice that the program names and the

    return offsets are highlighted. Click on CWAAHOUR:

  • The Mainframe Software Partner for the Next 50 Years

    17

    A good rule of thumb to follow is anywhere where you see the program name hyperlinked, clicking on the program will take you directly to the program detail for that application program.

    Press to return to the diagnostic section. Scroll down to the ‘Call Trace Summary’ subsection:

    Click on the offset x’F4E (found under the ‘Return value’ column):

  • The Mainframe Software Partner for the Next 50 Years

    18

    This will take you into the CALL Statement to show you the line of code where CWAACOB1 calls CWAAHOUR. You can also see the call statement arguments as well.

    Press to return to diagnostic section, and scroll down to the Supporting Information subsection:

    • The Supporting Information subsection provides commands that you can click on, or type in in the Command Line box to take you to panels containing relevant information

    • The FILE and PROG commands will be covered in their own sections later in the document

    Click on MODS:

  • The Mainframe Software Partner for the Next 50 Years

    19

    This chart displays the module names in the library where the modules were loaded from for all of the programs (both application and LE) that appear in the act of calling chain.

    Press to go back to the Supporting Information. Click on LIBR:

    This chart displays the steplib or joblib concatenation of the library that the abending module was loaded from. The library where the modules loaded from is highlighted in red.

    Press to go back to the Supporting Information. Click on JES:

    For JES2 shops only, you can display the JCL that was submitted through JES2.

    Press to go back to the Supporting Information. Click on

    File Summary Panel

    The FILE command gives you the capability of getting information about the files allocated to this program by DD statements.

  • The Mainframe Software Partner for the Next 50 Years

    20

    From the Supporting Information subsection of the diagnostic section, Click on the FILE command:

    The File Summary panel displays information about the files that were allocated to the program that abended. The chart displays the DD name, the location and file attributes of the files.

    To the left of the DD name is the memo icon. Click on the memo icon next to EMPFILE:

    Click on ‘Record Image’:

    If the DD statement is a sequential, QSAM, or VSAM file, the operating system will store the current and possibly previous record that was read or written. You can view the record images, if they exist, for any non-spooled DD statement.

    Press to return to the file summary panel. Click on the menu button and select ‘File Detail’.

  • The Mainframe Software Partner for the Next 50 Years

    21

    The File Detail panel provides detailed information about the selected file associated with the abending job. You can view the Record Image, and you can also browse or edit the file through File-AID.

    Press to return to the File Summary panel. Click on the menu button and select File-AID Browse:

    A pop-up window may appear where you need to specify the host. Highlight the host, and then click OK.

  • The Mainframe Software Partner for the Next 50 Years

    22

    You will have to enter your TSO user ID and password (to enable external security on your LPAR to validate that you have rights to view the file), and click OK.

    The File-AID Data Editor is invoked in a new editor view and you will see the file:

    Close the file in the editor view and return back to Abend-AID. You’re still in the File Summary panel. Press to return to the Supporting Information panel. Click on PROG:

    Program Summary Panel

    The Program Summary Information screen identifies all active modules involved in an abending application.

    Click on the menu icon next to program CWAAHOUR:

  • The Mainframe Software Partner for the Next 50 Years

    23

    As you can see from the menu, you can gather a great deal of information about the application programs that comprise the active calling chain.

    • Clicking on Program Detail will take you into the Program Detail panel (see Program Detail panel section for more information)

    • Clicking on Program Listing will take you into the compiled listing at the last instruction processed.

    • Clicking on Program Storage will take you panel where you can view the File Section, Working- Storage Section, and Linkage Section variables - the field names, picture type, and value at the time of the abend.

    • Clicking on the Compiler Options will take you to a panel where you can see the language and version the program was compiled or assembled under, as well as the compile options (if the program was compiled with COBOL)

    NEXT STEPS

    Click on the link below to return to the Compuware Test Drive main page and choose your next road trip!

    COMPUWARE TEST DRIVE