Compuware Test Drive Using Abend-AID for CICS Drive/AA...• The Last Call or EXEC CICS subsection...

25
1 Compuware Test Drive Using Abend-AID for CICS Revised: 4/2/2020 This test drive will guide you through the basic functionality of Abend-AID for CICS under Topaz workbench.

Transcript of Compuware Test Drive Using Abend-AID for CICS Drive/AA...• The Last Call or EXEC CICS subsection...

1

Compuware Test Drive

Using Abend-AID for CICS Revised: 4/2/2020

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

workbench.

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

Task Detail section ......................................................................................................................... 16

Program Summary Panel ............................................................................................................... 24

NEXT STEPS .................................................................................................................................... 25

The Mainframe Software Partner for the Next 50 Years

3

Bringing up Abend-AID

To access Abend-AID for CICS 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.

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 Mainframe Software Partner for the Next 50 Years

6

The Fault Summary panel displays a summary of the CICS, 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’. 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. The CICS region we will be looking at starts with HCCA.

Enter HCCA in columns 1-4 in the asterisks:

Press <enter>:

The Mainframe Software Partner for the Next 50 Years

7

All jobnames, CICS regions, etc. will be filtered out other than those that start with HCCA. If there were multiple regions that start with HCCA, they would also appear.

Click on the HCCAC013 hyperlink:

The Abend-AID directory is now displayed showing the CICS abends in the descending date/time order. Note that the asterisks below each column can also be used as filters.

Use the scroll bar to scroll down the list of CICS abends until you

reach entry number 0016243

You can display the Abend-AID for CICS report one of two ways:

Click on the hyperlink entry number and it will take you to the

diagnostic section, or

The Mainframe Software Partner for the Next 50 Years

8

Click on the menu icon to the left of the entry and select ‘diag’ to go to the

diagnostic section

NOTE: you may see the following message:

You can ignore this message. When Abend-AID merges compiled listings into the report, there may be listing databases that your userid cannot access (due to security rules). It has no effect on your viewing the report with the listing merged in.

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 Mainframe Software Partner for the Next 50 Years

10

The first 2 lines of the diagnostic section contain hyperlinks that will take you to significant information about the abending program and transaction that invoked it.

Click on the ASRA hyperlink to see a description of the actual

abend code:

The Mainframe Software Partner for the Next 50 Years

11

You can access the Program Detail panel, which contains significant information about the abending program from the diagnostic section.

Program Detail Panel

On the first line of the Diagnostic Section, click on the

CWAADEMO hyperlink:

The Mainframe Software Partner for the Next 50 Years

12

The program detail panel provides information about the program that abended. In CICS, you don’t have Steplibs or joblibs, but the CICS region does have the DFHRPL DD statement that shows the concatenated libraries.

Click on CTS530.CICS.HCCAC013.LOADLIB.PDSE

hyperlink to display the DFHRPL concatenation:

The library where the modules loaded from will be highlighted.

Press <F3> will bring you back to the Program Detail panel.

The Mainframe Software Partner for the Next 50 Years

13

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

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 CURR-PAY line number 354.

To utilize the ‘Peek’ command, place a P in column 1

of line number 78, and since CURR-PAY is the second

variable on that line, enter 2 in the second column of

the line number. Press <enter>.

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

The Mainframe Software Partner for the Next 50 Years

14

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.

Click on the Working-Storage Section tab to see any of the fields

in the Working-Storage section:

Click on the value of value of PAYMAO1A-LEN

hyperlink (+1133) and click. This brings you to

The Mainframe Software Partner for the Next 50 Years

15

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 Commarea and other data:

Here you will see the fields that comprise the DFHCOMMAREA, the picture types, and the value of each variable and any other fields passed between programs (if present).

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.

The Mainframe Software Partner for the Next 50 Years

16

Click on the AADM hyperlink to view information about

the transaction invoked:

Task Detail section

Click on the Abending Program and it will bring up the Program

Detail panel :

The Mainframe Software Partner for the Next 50 Years

17

Press <F3> to go back to the Task Detail panel. Then, click

on the Initial Program:

Because the abending program and the initial program were the same, the same program detail panel came up. In the situation where the initial program invoked is different than the abending program, clicking on the initial program would bring up the program detail for the program that was initiated when the transaction was invoked. The exception to this occurs when one of the programs that were invoked issued a transfer control to a new program. When you transfer control, it resets the base to the program that was just called. Any program storage for any programs prior to the transfer control would be cleared. In this situation clicking on the initial program would return a message ‘no program storage found’.

Press <F3> to return to the Task Detail Panel.

The Mainframe Software Partner for the Next 50 Years

18

The rest of the information provides detailed information about the transaction. There is also control block information for use by the CICS administrators.

Press <F3> to return to the Diagnostic Section. Click on

the Terminal hyperlink to go to the Terminal Detail section:

The Terminal Detail section provides information about the terminal that was used to invoke the transaction. This section is only viewable for terminal based transactions and not message based transactions.

Click on last 3270 image to see what was on the user’s

screen when they invoke the transaction:

Press <F3> to return to the Terminal Detail screen. 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 Mainframe Software Partner for the Next 50 Years

19

• The abending line of code is displayed. The line number is hyperlinked

:

Click on the line number to go into the Program listing:

Press <F3> to return to the Diagnostic section

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

The Field names are hyperlinked. Click on WA-

HOURS to go directly into Working-Storage:

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

• The Next Sequential Instruction subsection provides basic information the next

instruction after the abend as well as the load library or program object library the

The Mainframe Software Partner for the Next 50 Years

20

module was loaded from, as well as when it was bound:

• The Last Call or EXEC CICS subsection provides information about the last program call or last ‘EXEC

CICS’ that were executed prior to the abend in the paragraph where the statement resided:

• The ‘Last Call Arguments and Values’ subsection will display any passed variables rom

the preceding subsections last program call or last EXEC CICS. Since the last exec CICS

that was executed was in ignore condition, there were no arguments to be passed.

• The Program Link 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. In this example, the initial program was the program that abended, so the active calling chain consists of a single module.

You’ll notice that the program names is hyperlinked. Click on CCAADEMO to take you back to

the Program Detail panel:

The Mainframe Software Partner for the Next 50 Years

21

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

Click on the SCREEN command:

The Mainframe Software Partner for the Next 50 Years

22

Just like in the Terminal Detail panel, clicking on the screen command will bring up the image on the user’s terminal.

Press <F3> to return to the Supporting

Information subsection. Click on FILE to bring up

the File Request Summary:

The File Request Summary summarizes key identification data for each file request on the

storage chain at the time of the abend.

Click on the CCAAEMPF hyperlink to bring up the ‘local file detail’:

The Mainframe Software Partner for the Next 50 Years

23

The File Detail panel displays general file information, statistics, and status about the selected

file. In addition, the Local File Detail screen provides access to the Record Image screen.

Click on the ’record image’ hyperlink in the Local File Detail panel:

The image of the Last Record Read is available for local files only. The key and record data

displayed are associated with the selected file request.

You can also get to the Last Record Read panel from the ‘File Request

Summary’ panel by clicking on the menu:

Press <F3> twice to go back to the Diagnostic Section. Scroll down to the

‘Supporting Information’ subsection.

You’ll notice that there is no ‘PROG’ command listed in the Supporting Information panel. There is however, a ‘PROG’ command.

Click on the tools icon, and select ‘Line Command’ from the drop down:

Enter ‘PROG’ in the Line Command box and press <enter> to take you to

the Program Information panel:

The Mainframe Software Partner for the Next 50 Years

24

This section contains information about the application programs that were called that appear in the Program Link Summary subsection of the Diagnostic report.

Click on ‘Program Summary Information’:

Program Summary Panel

The Program Summary Information screen identifies all active modules involved in an abending transaction. Key identification data is summarized for each module used by a transaction up to the abending module.

Click on the menu icon next to program CCAADEMO:

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)

The Mainframe Software Partner for the Next 50 Years

25

• 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 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