Download - Compuware Test Drive Using Abend-AID for Batch - COBOL Drive/AA...This takes you to the COBOL storage areas panel: The Mainframe Software Partner for the Next 50 Years 14 Click on

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


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.


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’:


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’.


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 <enter>:


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

,


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.


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:


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 <F3> will bring you back to the Program Detail panel.


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:


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 <enter>. 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.


13

Press <F3> to return to the previous panel (which is the listing). Press <F3> 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:


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 <F3> 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:


15

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

Press <F3> twice to return to the program detail panel:

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

Press <F3> 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.


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:


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 <F3> 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):


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 <F3> 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:


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 <F3> 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 <F3> 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 <F3> to go back to the Supporting Information. Click on <File>

File Summary Panel

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


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 <F3> to return to the file summary panel. Click on the menu button and select ‘File Detail’.


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 <F3> 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.


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 <F3> 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:


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