Analyzing Batch Abends

This section describes how to analyze batch abends using the Diagnostic Summary. Because the summary provides you nearly all the information you need for diagnosing the abend, begin your analysis using this screen. Also described are the following screens that you can access from the Diagnostic Summary for additional information about the abend:

• Root Cause Analysis Menu
• Root Cause Analysis Information
• Program Detail
• Library Concatenation
• Program Listing
• Storage Disassembly
• Expanded Data Field
• Program Summary Information
• Data Locator Search Criteria
• Data Locator Results
• Impact Analysis Menu
  • Impact Analysis Results
  • Impacts - Programs
  • Impacted By - Programs
  • Impacts - Data Items
  • Impacted By - Data Items
  • Program Details
  • Data Item Details
  • Impact Analysis Listing
• Extended Search Listing
  • Field Usage Summary
  • Other Fields
• COBOL Storage Areas menu

COBOL Supporting Data

• PL/I Storage Areas menu
• Assembler Storage Areas menu
  • Assembler Storage Selection List
  • Assembler Storage Area
  • Save Area Screen
• Compiler Options
• Expanded Data Field
• LE Information menu
  • LE Run Time Options
  • LE Heap Summary
  • LE Control Blocks Menu
• File Summary
• PSW Information
• Registers
• Db2 Information menu
  • DB2 Diagnostic Summary
  • Host Variables
  • Bind Information
  • Precompile Information
  • Columns Referenced
  • Dependencies
  • SQL Communications Area
  • Warnings
  • File-AID for DB2 access
• IMS Information menu
  • IMS Diagnostic Summary
  • IMS PCBs menu
  • DL/I Database Call Statistics
  • IMS Control Blocks screen
  • IMS Text Summary
• Abend Re-creation Menu
  • Db2 Abend Re-creation 
  • File Abend Re-creation
  • MQ Abend Re-creation
  • Linkage Section Abend Re-creation
• CA-IDMS Information screen
  • Database Command Trace screen
  • Database Cross Reference screen
  • CA-IDMS Environment Data screen
  • Data Base Statistics screen
  • Current Records screen
  • Current Sets Screen
  • Record Contents screen
• Abend-AID for WebSphere MQ Menu
  • WebSphere MQ Reason Code
  • Last WebSphere MQ Call Information screen
  • Handle Information
  • Message Descriptor screens
  • Report Options screen
  • GMO Detail screen
  • Message Buffer Area
  • Local Queue Definition
  • Open Options screen
  • GMO Options screen
  • PMO Detail screen
  • PMO Options screen
  • Open Queues at Dump Time

Before beginning your analysis of the abend using the Diagnostic Summary, make sure you read Abend-AID Viewer Interface to familiarize yourself with the Abend-AID screen layout and text display defaults. Note how to enter fast-path and line commands. In particular, review Cursor Point-and-Shoot Feature for an explanation of the alternative methods for accessing program storage and detailed information about specific data elements. Online help is available for any Abend-AID screen, field, system message, or command.

For information about using the Diagnostic Summary for SVC dump analysis, see Analyzing-SVC-Dumps  .

Diagnostic Summary

The Diagnostic Summary, shown in Diagnostic Summary, page 1 through Diagnostic Summary, page 4, gives you the information you need for diagnosing a batch program error. The summary analyzes the abend, provides a probable reason why it occurred, and usually suggests a resolution. For COBOL, PL/I, and Assembler programs compiled with source support, the actual statement number and source code of the statement in error are shown. The Diagnostic Summary consists of two or more pages and contains the following sections:

• Analysis of the Error
• Root Cause Analysis (S0CB, S0C4, S0C7, and S0C9 errors in COBOL only)
• Impact Analysis (if your site also has DevEnterprise installed)
• SQL Return Code (Db2 only)
• Host Variables (Db2 only)
• SQL Statement (Db2 only)
• COBOL Information, if applicable
• IBM message text
• Error Location
• Next Sequential Instruction
• Call Trace Summary
• Load Module Data sets
• Application Program Attributes
• Supporting Information.

 Diagnostic Summary, page 1 

 Diagnostic Summary, page 2 

 Diagnostic Summary, page 3 

 Diagnostic Summary, page 4 

Access the Diagnostic Summary by doing one of the following:

• Enter S as a line command on the Abend-AID Directory next to the entry for the batch abend you want to analyze.
• If you have already selected the batch abend, do one of the following:
  • Directly access the summary from the Abend-AID Report menu (Report Menu for Batch Abend Analysis).
  • Enter DIAG as a fast-path command or =1 as a jump command on any Abend-AID screen.

To analyze the selected batch entry, do the following:

1. Obtain from the first two sentences of the summary the error type, the program name, and the completion code associated with the error.
2. Review the Analysis of Error section for a description of the error and an explanation of the probable cause. For S0CB, S0C4, S0C7, and S0C9 errors in COBOL programs only, use the cursor point-and-shoot feature and press Enter at the analysis field to display the Root Cause Analysis Menu for this abend, as described in Root Cause Analysis Menu.
   If your site has installed integration with DevEnterprise and you’re using source support for this program, impact analysis may be available. Use the cursor point-and-shoot feature and press Enter at the Impact Analysis field to display the Impact Analysis Menu for this abend, as described in Impact Analysis Menu.
   For programs compiled with source support, Abend-AID displays the abending statement. Use the cursor point-and-shoot feature and press Enter at the statement number field to access the Program Listing screen, which is explained in Program Listing Screen.
3. For COBOL programs, the Abend-AID Viewer identifies the fields in error. Use the cursor point-and-shoot feature and press Enter at any entry in the Level/Field Name field to display the Program Listing screen for working storage, which is explained in Program Listing Screen. Press Enter at any entry in the Value field to display the Expanded Data Field screen, which is explained in Expanded Data Field Screen.

4. From the Error Location section, determine where the program was executing when it abended, and obtain the following information about the abending program:

   • Program’s compile date
   • Program’s link-edit date
   • Program name and module lengths
   • Load module name and the load library name
   • Next statement to be executed after the abending statement.

   Use the cursor point-and-shoot feature to access additional information about data displayed in the Error Location section as follows:

   • Press Enter at the statement number field to access the Program Listing screen, which is explained in Program Listing Screen.
   • If the program is not COBOL or PL/I or was not compiled with source support, the Abend-AID displays the displacement of the next sequential instruction. Type the DISASM primary command on COMMAND line, and use the cursor point-and-shoot feature and press Enter at the displacement to disassemble the program and display the Storage Disassembly screen, which is explained in Storage Disassembly Screen.
   • Press Enter at the program name field to access the Program Detail screen, which is explained in Program Detail Screen.
   • Press Enter at the load library name field to access the Library Concatenation screen, which is explained in Library Concatenation Screen.
5. Note other supporting data:
   • Call Trace Summary
   • Load Modules Data sets
   • Application Program Attributes
6. Review the Supporting Information section, which gives you a dynamic menu allowing direct access to areas related to the error that may help in your analysis. Use the cursor point-and-shoot feature and press Enter to access the following additional screens when available:
   • File Summary
   • Program Summary Information Screen
   • Load/PDSE Object Modules Screen
   • Library Concatenation Screen
   • JES2 Submitted JCL Screen
   • Batch Entry Information Screen
   • PSW Information Screen
   • Registers Screen
   • Extended Search Listing Screen
   • Optional z/Architecture Features Screen

Root Cause Analysis Menu

The Root Cause Analysis Menu, shown in the following figure, displays a list of the fields associated with the abending statement.

Root Cause Analysis Menu 

Use the cursor point-and-shoot feature and press Enter at a field to access diagnostic information for this error, as shown in following Root Cause Analysis Information through Root Cause Analysis Information.

Root Cause Analysis Information, page 1 

 Root Cause Analysis Information Screen, page 2 

 Root Cause Analysis Information Screen, page 3 

You can view additional Root Cause Analysis Information screens for this error by using the cursor point-and-shoot feature and pressing Enter at the highlighted fields on these screens.

Program Detail Screen

The Program Detail screen, shown in Program Detail Screen, provides detailed information about the selected program. You can use the cursor point-and-shoot feature to access the library concatenation and program storage.

Access the Program Detail screen in one of the following ways:

• Use the cursor point-and-shoot feature to position the cursor at the program name on the Diagnostic Summary screen and press Enter.
• Enter D as a line command on the  Program Summary Information screen.

 Program Detail Screen 

To obtain additional information about the abending program, do the following:

1. Note general information about the abending program, such as compile date and time, program size, Rmode/Amode, and language.
2. Use the cursor point-and-shoot feature and press Enter at the data set name to access the STEPLIB Concatenation Screen, which is described in Library Concatenation Screen.

3. Use the cursor point-and-shoot feature and press Enter at the Listing field to access the Program Listing screen, which is explained in Program Listing Screen.

   Important

   The Program Listing screen is available only for COBOL, PL/I, and Assembler programs compiled with the COBOL language processor, the PL/I language processor, or the Assembler language processor, respectively.

4. Use the cursor point-and-shoot feature and press Enter at the Storage Areas field to display:
   • Working storage, linkage section, external cells, and task global table (TGT) for COBOL programs.
   • Formatted storage for PL/I programs with source support.
   • Automatic, static, controlled, and external storage areas in hexadecimal format for PL/I programs.
   • Save areas in hexadecimal format for Assembler programs.
5. Use the cursor point-and-shoot feature and press Enter at the Language field to display the Compiler options screen, which is described in Compiler Options Screen.
6. Use the cursor point-and-shoot feature and press Enter at the LE/370 Enabled field to display the LE Information menu, which is described in LE Information Menu.

Library Concatenation Screen

The Library Concatenation screen, shown in Library Concatenation Screen, displays the data sets and their associated volsers for the JOBLIB or STEPLIB DD statement defined in the JCL at the time of this abend. The highlighted data set name is the load library name. You can access the Library Concatenation screen using the cursor point-and-shoot feature to position the cursor on the load library name in the Diagnostic Summary or on the Library Field in the Other Areas of Interest section of the Diagnostic Summary and pressing Enter. You can also access this screen by entering LIBRARY as a fast-path command on any Abend-AID Viewer screen for this report.

 Library Concatenation Screen 

Program Listing Screen

The Program Listing screen, shown in Program Listing Screen for COBOL Programs, displays the source listing statements of the selected program, identifying the active statement (abending offset, program call, and so forth) with a highlight bar. For COBOL programs, the Abend-AID Viewer displays the Procedure Division of the selected program. You can use the PF keys to scroll throughout the section.

For PL/I (Program Listing Screen for PL/I Programs) and Assembler programs (Program Listing Screen for Assembler Programs), the Abend-AID Viewer displays the entire source listing. For PL/I programs, use the cursor point-and-shoot feature to tab to a Field value and press Enter to display the Expanded Data Field (Expanded Data Field Screen), which shows the selected data in vertical-hex format. For both PL/I and Assembler programs as you move through the listing, to reposition the display to the active statement, use the cursor point-and-shoot feature to tab to the RESET field and press Enter.

To reposition the display to the statement at the point of entry, use the cursor point-and-shoot feature to tab to the ENTRY field and press Enter. Besides accessing the Program Listing screen from the Diagnostic Summary, you can access this screen by using the cursor point-and-shoot feature and pressing Enter at the Listing field on the Program Detail screen. Alternatively, you can enter L as a line command on the  Program Summary Information screen for a program compiled with the COBOL language processor, the PL/I language processor, or the Assembler language processor. You can also enter PLIST program-name as a fast-path command on any Abend-AID screen.

 Program Listing Screen for COBOL Programs 

For COBOL programs only, you can access related storage for a variable from the Program Listing screen using the following methods:

Tab to the corresponding statement number for the variable and do one of the following:

• Press Enter.
• Enter the P or P1 (Peek) line command to display program storage for the first variable on the statement. To position the program storage display at other than the first variable, enter Pn, where n is the relative number of the variable on the statement. For example, enter P3 to access program storage positioned at the storage for the third variable on the statement.

After using either of these methods for accessing program storage, press the END PF key (PF3) to reposition the display to the statement for the variable in the Procedure Division as the first line.

 Program Listing Screen for PL/I Programs 

 Program Listing Screen for Assembler Programs 

Storage Disassembly Screen

The Storage Disassembly screen, shown in Storage Disassembly Screen, displays the selected program in disassembled format. To scroll the Storage Disassembly display to a specific offset from offset zero, enter +offset or -offset in the command field. To reposition the Storage Disassembly to offset zero, enter RESET as a primary command. Use the cursor point-and-shoot feature and press Enter at the Address field to display the Memory Display, which is described in Memory Display. Access the Storage Disassembly screen by using the DISASM primary command, which is described in DISASM .

 Storage Disassembly Screen 

Program Summary Information Screen

The Program Summary Information screen, shown in 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. This screen allows you to quickly verify whether the correct version of a module is in use.

You can access the current search criteria used by the Data Locator facility by tabbing to the FINDDATA field and pressing Enter. The Data Locator Search Criteria screen is displayed.

 Program Summary Information Screen 

Access the  Program Summary Information screen from the Program Information menu or by entering PROG as a fast-path command on any Abend-AID screen. Enter the following line commands next to the program name in the Load Module field to display additional information about each program:

• D: Displays the Program Detail screen, which is described in Program Detail Screen.
• L: Displays the Program Listing screen, which is described in Program Listing Screen. The Program Listing line command is available only for COBOL, PL/I, and Assembler programs compiled with the COBOL language processor, the PL/I language processor, or the Assembler language processor, which provide source support.
• S: Displays all user storage associated with the selected program:
  • For COBOL programs, this command displays the COBOL Storage Areas menu, as described in COBOL Storage Areas Menu.
  • For PL/I programs with source support, this command displays the PL/I Source listing screen (Program Listing Screen for PL/I Programs). For PL/I programs without source support, it displays the PL/I Storage Areas menu, as described in PL/I Storage Areas Menu.
  • For Assembler programs, this command displays the Assembler Storage Areas menu, as described in Assembler Storage Areas Menu.
• C: Displays the compiler options, as described in Compiler Options Screen.
• R: Displays the results of the data locator search, as described in Data Locator Results Screen.
• I: Displays the Impact Analysis Fields Listing if your site has DevEnterprise installed. This screen is described in Impact Analysis Listing.
• X: Displays the Extended Search Listing screen for COBOL programs with source support enabled,which is described in Extended Search Listing Screen.
• W: Displays the COBOL Perform Flow screen for Enterprise COBOL programs only if your site is using source support, as described in COBOL Perform Flow Screen.

Load/PDSE Object Modules Screen

The Load/PDSE Object Modules screen, shown in Load/PDSE Object Modulesl Screen, displays the attributes of the load and PDSE object modules listed in the Call Trace section. Access this screen from the Supporting Information section of the Diagnostic Summary or by entering the MODS fast-path command from any relevant batch report screen.

   Load/PDSE Object Modulesl Screen 

JES2 Submitted JCL Screen

The JES2 Submitted JCL screen, shown in JES2 Submitted JCl Screen, displays all submitted JCL records including SYSIN for the job. Access this screen from the Supporting Information section of the Diagnostic Summary, or by entering the JES fast-path command on any relevant batch report screen.

 JES2 Submitted JCl Screen 

Data Locator Search Criteria Screen

The Data Locator Search Criteria screen, shown in Data Locator Search Criteria Screen, displays the default list of data items that comprise the search criteria for COBOL programs that the Abend-AID Data Locator facility uses. You can modify this list or use the defaults. The search criteria are unique to each user, and you can save a maximum of 70 at any one time. String criteria are compared against COBOL user-defined names, picture criteria are compared against COBOL picture clauses, and date criteria are compared against field values of the storage contained in the dump.

Enter the corresponding letter for the line command to the left of a data item to execute an Insert, Replicate, or Delete command. Enter X in the first column next to a data item you want to exclude from the search. After you have saved your changes, if you want to restore the defaults, enter DEFAULTS on the command line. Access the Data Locator Search Criteria screen by pressing Enter at the FINDDATA field on the Program Summary Information screen.

 Data Locator Search Criteria Screen 

Data Locator Results Screen

The Data Locator Results screen, shown in Data Locator Results Screen, displays the results of a search of a COBOL program. The Abend-AID displays the COBOL storage section definitions matching any of the specified criteria along with the COBOL procedure division statements that reference them. The criteria used in the search are summarized following any matches found.

The search is based on a default list of data items, which you can modify. To display the list of data items, tab to the FINDDATA field on the Program Summary Information screen (Program Summary Information Screen) and press Enter. The Data Locator Search Criteria screen is displayed, as shown in Data Locator Search Criteria Screen. To access the Data Locator Results screen, enter the R line command next to a COBOL program on the Program Link Information or Program Summary Information screen.

 Data Locator Results Screen 

Impact Analysis Menu

The Impact Analysis Menu, shown in Impact Analysis Menu, displays program data items that you can select for DevEnterprise impact analysis. Your site must have DevEnterprise installed for integration with Abend-AID, and you must be using source support for the abending program. The server is the server where the DevEnterprise Metadata Analyzer is executing and where the impact analysis is performed. Access this screen from the Diagnostic Summary by using the cursor point-and-shoot feature and pressing Enter at the Impact Analysis field.

Impact Analysis Menu 

Use the cursor point-and-shoot feature to position the cursor at the program name or at any of the displayed fields for analysis and press Enter. The Impact Analysis Results screen is displayed, as shown in Impact Analysis Results Screen.

Impact Analysis Results Screen

The Impact Analysis Results screen, as shown in Impact Analysis Results Screen, displays the results of an impact analysis. The name and type of the source entity that impact analysis was performed on are displayed at the top screen. The table contains the target entities that either impact the source entity or are impacted by the source entity, or both.

Access this screen by using the cursor point-and-shoot feature to position the cursor at the program name or at a field of interest on the Impact Analysis Menu and pressing Enter. Alternatively, access this screen from the Impact Analysis Listing by entering the I line command next to a source line. 

 Impact Analysis Results Screen 

Use the cursor point-and-shoot feature and press Enter at the number displayed in the Impacts or Impacted By field to display the following screens:

• Impacts - Programs screen
• Impacted by - Program screen 
• Impacts - Data Items screen 
• Impacted By - Data Items screen 

Impacts - Programs

The Impacts - Programs screen, shown in Impacts - Programs Screen, displays impact analysis information for programs that the selected target program or data item impacts. Note that the information shown is obtained from the DevEnterprise Metadata Analyzer.

 Impacts - Programs Screen 

Access this screen from the Impact Analysis Results screen (Impact Analysis Results Screen . ) by using the cursor point-and-shoot feature to position the cursor at the number displayed in the Impacts field for the selected target program and pressing Enter. You can use the following line commands on this screen:

• D: Displays the Program Details screen, as described in Program Details Screen.
• I: Displays the Impact Analysis Results screen, as described in Impact Analysis Results Screen.

Impacted By - Programs Screen

The Impacted By - Programs screen, shown in Impacted By - Programs Screen, displays impact analysis information for programs that the selected target program or data item is impacted by. Note that the information shown is obtained from the DevEnterprise Metadata Analyzer.

 Impacted By - Programs Screen 

Access this screen from the Impact Analysis Results screen (Impact Analysis Results Screen) by using the cursor point-and-shoot feature and pressing Enter at the number displayed in the Impacted By field for the target program or data item. You can use the following line commands on this screen:

• D: Displays the Program Details screen, as described in Program Details Screen.
• I: Displays the Impact Analysis Results screen, as described in Impact Analysis Results Screen.

Impacts - Data Items Screen

The Impacts - Data Items screen, shown in Impacts - Data Items Screen, displays impact analysis information for data items that the selected target data item impacts. Note that the information shown is obtained from the DevEnterprise Metadata Analyzer.

 Impacts - Data Items Screen 

Access this screen from the Impact Analysis Results screen (Impact Analysis Results Screen) by using the cursor point-and-shoot feature to position the cursor at the number displayed in the Impacts field and pressing Enter. You can use the following line commands on this screen:

• D: Displays the Data Item Details screen, as described in Data Item Details Screen.
• I: Displays the Impact Analysis Results screen, as described in Impact Analysis Results Screen.
• S: Displays the list of data items for which you can obtain impact analysis, as described in Impact Analysis Listing.

Impacted By - Data Items Screen

The Impacted By - Data Items screen, shown in Impacted By - Data Items Screen, displays impact analysis information for data items that the selected target data item is impacted by. Note that the information shown is obtained from the DevEnterprise Metadata Analyzer.

 Impacted By - Data Items Screen 

Access this screen from the Impact Analysis Results screen (Impact Analysis Results Screen) by using the cursor point-and-shoot feature to position the cursor at the number displayed in the Impacted By field and pressing Enter. You can use the following line commands on this screen:

• D: Displays the Data Item Details screen, as described in Data Item Details Screen.
• I: Displays the Impact Analysis Results screen, as described in Impact Analysis Results Screen.
• S: Displays the list of data items for which you can obtain impact analysis, as described in Impact Analysis Listing.

Program Details Screen

The Program Details screen, shown in Program Details Screen, provides detailed information for a selected target program. Note that the information shown is obtained from DevEnterprise Metadata Analyzer. The modified date and time are the last modification for this entity in DevEnterprise. Access this screen by entering the D line command next to a program on the Impacts - Programs screen (Impacts - Data Items Screen) or the Impacted By - Programs screen (Impacted By - Programs Screen).

 Program Details Screen 

Data Item Details Screen

The Data Item Details screen, shown in Data Item Details Screen, provides detailed information for a selected data item. Note that the information shown is obtained from the DevEnterprise Metadata Analyzer. The modified date and time are the last modification for this entity in DevEnterprise. Access this screen by entering the D line command next to a data item on the Impacts - Data Items screen  or the Impacted By - Data Items screen.

 Data Item Details Screen 

Impact Analysis Listing

The Impact Analysis Listing, shown in Impact Analysis Listing, displays a list of all fields available for DevEnterprise impact analysis. Access the Impact Analysis Listing by any of the following methods:

• Enter the S (Program Storage) line command next to a data item on the Impacts - Data items screen, as described in Impacts - Data Items Screen.
• Enter the S (Program Storage) line command next to a data item on the Impacted By - Data items screen, as described in Impacted By - Data Items Screen.
• Enter the I (Impact Analysis) line command next to a program on the Program Summary Information screen, as described in Program Summary Information Screen.

 Impact Analysis Listing 

Enter the I (Impact Analysis) line command next to any field to view further analysis for that field on the Impact Analysis Results screen, as described in Impact Analysis Results Screen.

Extended Search Listing Screen

The Extended Search Listing screen, shown in Extended Search Listing Screen, is available only for COBOL programs with source support enabled. This screen displays all fields available for extended search. Access this screen by using the cursor point-and-shoot feature from the Supporting Information section of the Diagnostic Summary or by entering the ESRCH (Extended Search) fast-path command from any relevant screen for the abending program. You can also access this screen by using the X (Extended Search) line command on the Program Summary information screen.

Enter the following line commands next to a field for other extended search information:

• F: Displays the Field Usage Summary, which is described in Fields Usage Summary.
• O: Displays the Other Fields screen, which is described in Other Fields Screen .

 Extended Search Listing Screen 

Extended Search Warning Pop-Up Window 

Fields Usage Summary

The Field Usage Summary, shown in Fields Usage Summary Screen, displays program statements that directly or indirectly modify the selected field. In addition, it shows data definitions that directly or indirectly reference the selected field.

Fields Usage Summary Screen 

Other Fields Screen

The Other Fields screen, shown in Other Fields Screen, displays other fields and literals that have the same value as the selected field in the extended search.

Other Fields Screen 

Optional z/Architecture Features Screen

The following Optional z/Architecture Features screen displays the unavailable z/Architecture hardware facility when the abend is due to execution of an opcode on hardware that does not support the instruction. Access this screen from the Supporting Information section of the Diagnostic Summary or by entering the ARCH fast-path command on any relevant screen.

Optional zArchitecture Features Screen 

COBOL Perform Flow Screen

The COBOL Perform Flow screen, shown in COBOL Perform Flow Screen, lists the active PERFORM PROCEDURE statement flow through the COBOL program that occurred prior to the abend; or for calling programs, the flow prior to the call. This feature is available for Enterprise COBOL only, requires the viewing server to be using Common Shared Services, and the DDIO listing to have been processed with CSS and the COBOL compiler option LIST.

This screen is accessed from the Program Summary Information screen by entering the W line command.

COBOL Perform Flow reports only those PERFORM verbs that actually exist in the executed module. When you compile with OPTIMIZE(STD) or OPTIMIZE(FULL), any PERFORM verbs used in the source that are converted by the IBM compiler to inline code cannot be displayed.

The Abend-AID installation library hlq.CTL provides sample job $75XLSC6 to demonstrate option W (PERFORM Flow).

COBOL Perform Flow Screen 

Using the PF8 (DOWN) key, scroll down to the next page to see the procedure statements and the source listing in their entirety. You can use the cursor point-and-shoot feature to position the cursor at the ABEND STMT field and press Enter to display the abending statement. You can also use the cursor point-and-shoot feature to position the cursor at the ENTRY field and press Enter to reposition the display at the initial procedure statement.

COBOL Storage Areas Menu

The COBOL Storage Areas menu, shown in COBOL Storage Areas Menu, lets you access six screens that display all storage and memory information for all supported versions of COBOL programs.

Access the COBOL Storage Areas menu from the Program Summary Information screen by entering S as a line command next to any COBOL program. You can also access this menu by using the cursor point-and-shoot feature and pressing Enter at the Storage Areas field on the Program Detail screen.

 COBOL Storage Areas Menu

Enter the option number or use the cursor point-and-shoot feature and press Enter at the mnemonic for the menu options:

• FILE: Displays the Files Section of the Program Listing screen for this COBOL program.
• WORK: Displays the Working Storage Section of the  Program Listing screen for this COBOL program.
• LINK: Displays the Linkage Section of the  Program Listing screen for this COBOL program.
• SUPPORT: Displays the COBOL Supporting Data screen, which is explained in COBOL Supporting Data Screen, for this COBOL program.
• TGT: Displays the Task Global Table (TGT) storage in hexadecimal format on the Memory Display screen, which is explained in Memory Display.
• DSA: Displays the Dynamic Storage Area (DSA) in hexadecimal format on the Memory Display screen, which is explained in Memory Display.

COBOL Supporting Data Screen

The COBOL Supporting Data Screen, shown in COBOL Supporting Data Screen, displays additional program information, such as the contents of the TGT BLW, BLL, and BLF cells. Use the cursor point-and-shoot feature to display the data in hexadecimal format on the Memory Display screen, which is explained in Memory Display. Access the COBOL Supporting Data screen from the COBOL Storage Areas menu, or by entering SUPPORT as a fast-path command on any batch entry screen for COBOL.

 COBOL Supporting Data Screen

PL/I Storage Areas Menu

The PL/I Storage Areas menu, shown in PL/I Storage Areas Menu, lets you access various areas of PL/I storage information:

• Automatic storage areas
• Static storage areas
• Controlled storage area.

Access the PL/I Storage Areas menu by entering the S line command next to a PL/I internal procedure on the Program Summary information screen, or by using the cursor point-and-shoot feature and pressing Enter at the Storage Areas field on the Program Detail screen if source support is not enabled. If source support is enabled, the Program Listing screen is displayed, showing program storage.

 PL/I Storage Areas Menu

Selecting any of the storage areas options displays the storage in hexadecimal format on the Memory Display, which is explained in Memory Display.

Assembler Storage Areas Menu

The following Assembler Storage Areas menu displays the storage areas that were available during a program call or at the time of the abend. Access this screen by entering the S line command on the Program Summary Information screen next to an Assembler program or by using the cursor point-and-shoot feature and pressing Enter at the Storage Areas field on the Program Detail  screen for an Assembler program.

 Assembler Storage Areas Menu

Enter the option number or use the cursor point-and-shoot feature and press Enter at the mnemonic for the menu options:

• 1 STGCSECT: Displays the Assembler Storage screen for the storage areas for the program CSECT.
• 2 CALLTO: Displays the Save Area  screen that shows the save area used to call this program CSECT.
• 3 CALLFROM: Displays the Save Area screen that shows the save area that this program CSECT used to called another program.

Assembler Storage Selection List Screen

The Assembler Storage screen, shown in the following figure displays the assembler storage areas that are selectable for formatting by the Assembler language processor.

 Assembler Storage Selection List Screen

Assembler Storage Area Screen

The Assembler Storage Area screen, as shown in the following figure, displays the fields contained within the selected program storage area. It provides information about each field such as the field offset, field label, statement number, and field contents. Access this screen by entering the S line command next to a Section address on the Assembler Storage Selection List screen.

 Assembler Storage Area Screen

If the information displayed in the Hex or Character columns is truncated, use the cursor point-and-shoot feature and press Enter on the desired Field Address to access the Memory Display screen for that field.

 Memory Display Screen

Save Area Screen

The Save Area screen, shown in the following figure, displays the save area used to call the named program. The  Save Area screen displays the save area used by the named program to call another program. The address of the save area is shown in hexadecimal format and decimal and includes a description. Use the cursor point-and-shoot feature and press Enter at the tab-selectable fields to display the Memory Display for these addresses.

 Save Area Screen (Call To CSECT)

 Save Area Screen (Call From CSECT)

Compiler Options Screen

The Compiler Options screen, as shown in Compiler Options Screen, displays the program compiler options found in the program information bytes. With source support, all compiler options are available. To find the meaning of each option, refer to the appropriate language programming space. Access this screen from the Program Summary Information  screen by using the C (Compiler Options) line command. Alternately, you can use the cursor point-and-shoot feature and press Enter at the Language field on the Program Detail screen.

 Compiler Options Screen

This screen provides the name of the CSECT, the compile date and time, the language in which the program was written, and the version of the compiler.

Expanded Data Field Screen

The Expanded Data Field  screen displays in vertical-hexadecimal format the value in the selected field and identifies its program storage type. Use the cursor point-and-shoot feature at the address field to display the Memory Display screen, which is explained in Memory Display. New with Release 11.2, Unicode support displays the Program Code Page and the Terminal Code Page.

Access the Expanded Data Field screen from the Diagnostic Summary by using the cursor point-and-shoot feature and pressing Enter at any entry in the Value field of the Analysis of Error section for PL/I programs. For a batch abend with Db2 information, use the cursor point-and-shoot feature and press Enter at any entry in the Data field on the Host Variables screen.

Expanded Data Field Screen

LE Information Menu

The LE Information menu, shown in LE Information Menu, provides access to the following Language Environment information (if available):

• LE runtime options
• LE Heap summary
• LE control blocks

Access the LE Information menu directly from the Report Menu, using the cursor point-and-shoot feature and pressing Enter at the LE/370 Enabled field on the Program Detail Screen, or entering LEINFO on any Abend-AID Viewer screen.

LE Information Menu

LE Run Time Options Screen

The LE Run Time Options screen, shown in the following figure, displays the Language Environment (LE) options available at the time of an application program error. The screen also shows the LE version and from where the LE option was set. Access the LE Run Time Options screen from the LE Information menu or by entering LEOCB as a fast-path command on any Abend-AID screen.

LE Run Time Options Screen

LE Heap Summary

The LE Heap Summary, shown in LE Heap Summary, displays a summary of the LE Information. It allows navigation to other screens showing more detailed LE information. Use the cursor point-and-shoot feature and press Enter at the Segment Address field to display all the heap elements in an LE heap. Use the cursor point-and-shoot feature and press Enter at the Number of Errors field to display all of the element errors found in an LE heap.

Access the LE Heap Summary from the LE Information menu or by entering LEHEAP as a fast-path command on any Abend-AID screen.

LE Heap Summary

LE Control Blocks Menu

The LE Control Blocks Menu, shown in LE Control Blocks Menu, provides access to the LE control blocks, their significant fields, and navigation to the hexadecimal display of the control blocks.

Access the LE Control Blocks Menu from the LE Information menu or by entering LECB as a fast-path command on any Abend-AID screen.

 LE Control Blocks Menu

File Summary

The File Summary, shown in File Summary Screen, provides information about the files associated with the abending job. Use the cursor point-and-shoot feature to position the cursor at the File field in the Other Areas of Interest section of the Diagnostic Summary and press Enter, or type FILES as a fast-path command on any Abend-AID Viewer screen to access the File Summary.

Use the following line commands to access additional files-related information:

• R (Record Image): Displays the Record Image screen for the selected file.
• D (File Detail): Displays the File Detail screen, which provides detailed information about the selected file associated with the abending job.
• I (SMS Information): Displays the SMS information screen, which provides SMS information for the selected file associated with the abending job.
• E (File-AID Edit): Valid in ISPF viewing access mode only. Displays a File-AID edit session window from which you can edit the data set.
• B (File-AID Browse): Valid in ISPF viewing access mode only. Displays a File-AID browse session window from which you can browse the data set.

File Summary Screen

PSW Information Screen

The PSW Information screen, shown in PSW Information Screen, provides information about the program status word (PSW) and parameter data. Access the PSW Information screen by using the cursor point-and-shoot feature to position the cursor at the PSW field in the Other Areas of Interest section of the Diagnostic Summary and pressing Enter. Use the cursor point-and-shoot feature to position the cursor at the REGS field and press Enter to display the registers at the time of the abend, as described in Registers Screen. Further, use the cursor point-and-shoot feature to position the cursor at the first word of the abend PSW and press Enter to display the PSW Analysis screen. The PSW Information screen also displays parameter data if present in the dump. You can also access the PSW Information screen by entering the PSW or PARM fast-path command on any Abend-AID Viewer related screen.

PSW Information Screen

Registers Screen

The following  Registers screen provides the values of the registers at the time of the abend. Use the cursor point-and-shoot feature and press the HEXD PF key at any register address to display the value in hexadecimal format on the Memory Display screen, which is explained in Memory Display. Use the cursor point-and-shoot feature and press Enter at the AMODE24, AMODE31, or AMODE64 field to display storage descriptions based on 24-, 31-, or 64-bit address resolution.

To access the PSW at the time of the abend, use the cursor point-and-shoot feature and press Enter at the PSW field. Besides accessing the Registers screen using the cursor point-and-shoot feature and pressing Enter on the REGS field in the Other Areas of Interest section of the Diagnostic Summary, you can access this screen by entering REGS as a fast-path command on any Abend-AID Viewer screen.

Registers Screen

Use the cursor point-and-shoot feature and Press Enter at the Other field to display the Access/Floating Point Registers screen.

Access/Floating Point Registers Screen

The following Access/Floating Point Registers screen displays the Access Registers and Floating Point Registers at the time of the error. If a set of registers is not found in the dump, it will not be displayed. Access this screen by using the cursor point-and-shoot feature and pressing Enter at the Other field on the Registers screen.

Access/Floating Point Registers Screen

Use the cursor point-and-shoot feature and press Enter at the Interpretation field to display the Floating Point Interpretation screen.

Floating Point Interpretation Screen

The Floating Point Interpretation screen, displays the content of the 16 floating point registers, along with the value they represent. Access this screen by entering the INTFLOAT fast-path command on most screens for batch reports. This screen shows the interpretation based on one of the following types and formats:

• Decimal Floating Point short format
• Binary Floating Point short format
• Hexadecimal Floating Point short format

Floating Point Interpretation Screen

Use the cursor point-and-shoot feature and press Enter at the Short, Long, or Extended fields to display the alternate types and formats. An attempt is made to interpret the content of all floating point registers based on the requested combination of type (DFP, BFP, HFP) and format (short, long, extended), but the result is accurate only if the floating point register was being used in that manner. For example, if a floating point register is being used in the extended mode, then the wrong interpretation will be shown if it is displayed in short or long. Similarly, if a floating point register is being used as a decimal FP, then a binary or Hexadecimal interpretation will not yield the correct result.

It is not possible to determine the type or format by examining the content as most content is valid for all combinations but just represents a different value in each combination.

Vector Registers Screen

The following Vector Registers screen displays the vector registers at the time of the error occurrence. Any vector registers not present in the dump will not be displayed.

To access this screen, use the cursor's point-and-shoot feature, and press Enter when positioned at the Vector field on the Registers screen.

 Vector Registers screen

Db2 Information Menu

The following Db2 Information menu lets you display additional Db2 information about the abending transaction if your site is licensed for, and has installed, the Abend-AID for Db2 extra-cost option. After you select a batch abend with Db2 information, you can access this screen from the Report Menu, the Diagnostic Summary, or any other relevant screen for this report by entering DB2 as a fast-path command.

Db2 Information Menu

DB2 Diagnostic Summary

The DB2 Diagnostic Summary, shown in DB2 Diagnostic Summary through DB2 Diagnostic Summary provides diagnostic information for solving Db2 program errors. It includes the SQL return code and diagnostic information about Db2 program errors.

DB2 Diagnostic Summary

DB2 Diagnostic Summary

DB2 Diagnostic Summary

DB2 Diagnostic Summary

DB2 Diagnostic Summary

Host Variables

The Host Variables screen, shown in the following figure, displays information about the host variables that are referenced in the last executed SQL statement. Use the cursor point-and-shoot feature and press Enter at the variable data field to display the data in character format as described in Expanded Data Field Screen, or in hexadecimal format as described in Memory Display. In addition, use the cursor point-and-shoot feature and press Enter at the EXPAND field to toggle the display between expanded and collapsed view. Access this screen from the  Db2 Information menu.

Host Variables Screen

Bind Information

The Bind Information screen, shown in the following figure, displays the bind information for the abending program. Access this screen from the Db2 Information  menu.

Bind Information Screen

Precompile Information

The Precompile Information screen, shown in the following figure displays information related to the options that were specified at the time of the compile. Access this screen from the Db2 Information  menu.

 Precompile Information Screen

Columns Referenced

The Columns Referenced screen, shown in the following figure displays information about the columns that are referenced in the Db2 request. Use the cursor point-and-shoot feature and press Enter at the EXPAND field to toggle the display between expanded and collapsed view. Access this screen from the Db2 Information menu.

Columns Referenced Screen

Dependencies

The Dependencies screen displays information about the plan or package dependencies. Use the cursor point-and-shoot feature and press Enter at the EXPAND field to toggle the display between expanded and collapsed view. Access this screen from the Db2 Information menu.

Dependencies Screen

DB2 SQL Communications Area

The DB2 SQL Communications Area screen displays the contents of the SQLCA. Use the cursor point-and-shoot feature to position the cursor at the address of the SQLCA and press Enter to display storage in hexadecimal format as described in Memory Display. Use the cursor point-and-shoot feature to position the cursor at any field in the Name column and press Enter or the HELP key (PF1) for its field description. Access this screen from the Db2 Information  menu.

DB2 SQL Communications Area Screen

Warnings

The Warnings option displays any Db2-related warnings for the abending program.

File-AID for DB2 Access

The File-AID for DB2 Access option provides access to this BMC product from the Abend-AID Viewer. This option is available only if you access the Abend-AID Viewer via the ISPF viewing access method, as explained in Logging onto the Abend-AID Viewer. A current File-AID for DB2 release must be available on the operating system. Browse and Edit commands are available once you access the database.

DB2 Text Summary

The DB2 Text Summary, shown in the following figure is a display-only, multiple-screen formatting of the available Db2 information. Access this screen from the Db2 Information menu. Use the UP/DOWN Scroll keys (PF7and PF8) to view the complete text summary.

DB2 Text Summary

IMS Information Menu

The IMS Information menu lets you display additional IMS information about the abending transaction if your site is licensed for, and has installed, the Abend-AID for IMS extra-cost option. The IMS Information menu provides access to IMS-related information such as diagnostics, IMS PCBs, statistics, and the control blocks.

After you select a batch abend with IMS information, you can access this screen from the Report Menu, or any other Abend-AID screen, by entering IMS as a fast-path command.

IMS Information Menu

IMS Diagnostic Summary

The IMS Diagnostic Summary, shown in IMS Diagnostic Summary and IMS Diagnostic Summary, displays IMS diagnostic information relating to the abending program. Access this screen from the IMS Information menu.

If your site has installed BMC COPE, when an IMS application that is running in a COPE environment abnormally terminates, Abend-AID will be invoked to provide a diagnosis of the error. In addition, Abend-AID now provides the name of the COPE logical system (Lsys) that the user application was executing in when the error occurred. For examples, see IMS Diagnostic Summary for DL/I Batch Region in COPE Environment, IMS Diagnostic Summary for BMP Online Region in COPE Environment, and IMS Diagnostic Summary for MMP Online Region in COPE Environment.

IMS Diagnostic Summary

IMS Diagnostic Summary

IMS Diagnostic Summary for DL/I Batch Region in COPE Environment

IMS Diagnostic Summary for BMP Online Region in COPE Environment

IMS Diagnostic Summary for MMP Online Region in COPE Environment

IMS PCBs Menu

The IMS PCBs menu provides access to the Database PCB Summary and the I/O PCB Summary. Access the IMS PCBs menu from the IMS Information menu.

IMS PCBs Menu

Database PCB Summary

The Database PCB Summary shown in the following figure provides information about the IMS PCBs. Access the Database PCB Summary from the IMS PCBs menu.

Enter the following line commands to the left of the selected PCB address to display additional information about the PCB:

• T (JCB Call Trace): Displays the JCB Database Call Trace screen.
• S (SSA Information): Displays the SSA Information screen.
• E (Edit): Available in ISPF-only access mode. Allows editing with File-AID for IMS.
• B (Browse): Available in ISPF-only access mode. Allows browsing with File-AID for IMS.

Use the cursor point-and-shoot feature to position the cursor on any PCB address and press Enter to display the address in hexadecimal format on the Memory Display screen, which is described in Memory Display.

Database PCB Summary

DL/I Call Statistics

The DL/I Call Statistics screen, shown in the following figure, provides statistics that come from the PST accounting area. Access this screen from the IMS Information menu. Use the cursor point-and-shoot feature to position the cursor on the DLIMSG field and press Enter to toggle to the DL/I Message Call Statistics screen. Use the cursor point-and-shoot feature to position the cursor on the SYSSERV field and press Enter to toggle to the DL/I Message Call Statistics screen.

DL/I Call Statistics Screen

DL/I Message Call Statistics Screen

The DL/I Message Call Statistics screen, shown in the following figure, provides statistics from the PST accounting area. Access this screen from the DL/I Call Statistics  screen. Use the cursor point-and-shoot feature and press Enter at the DLIDB field to toggle to the DL/I Call Statistics screen.

DL/I Message Call Statistics

DL/I System Service Statistics Screen

The DL/I System Service Statistics screen provides statistics from the PST accounting area. Access this screen from the IMS Information menu. Use the cursor point-and-shoot feature and press Enter at the DLIDB field to toggle to the DL/I Database Call Statistics screen.

DL/I System Service Statistics

IMS Control Blocks Screen

The IMS Control Blocks screen, shown in the following figure, provides addresses of IMS control blocks. Access this screen from the IMS Information menu. Use the cursor point-and-shoot feature to position the cursor on the address of the control block and press Enter to display storage in hexadecimal format on the Memory Display screen, which is described in Memory Display.

IMS Control Blocks Screen

IMS Text Summary

The IMS Text Summary, shown in the following figure is a display-only, multiple-screen formatting of the available IMS information. Access this screen from the IMS Information menu. Use the UP/DOWN Scroll keys (PF7and PF8) to view the complete text summary.

 IMS Text Summary Screen

Abend Re-creation 

The Abend Re-creation menu allows you to access information required to re-create an abend as described in Db2 Abend Re-creation, MQ Abend Re-creation, File Abend Re-creation and Linkage Section Abend Re-creation section.

You can access this screen from the Report Menu, the Diagnostic Summary, or any other relevant screen for a Batch Db2 report by entering ABREC as a fast-path command.

Abend Re-creation Menu

Db2 Abend Re-creation

You can access the following Db2 Abend Re-creation information from Abend Re-creation menu. To do this, use the cursor point-and-shoot feature and press Enter at the variable data field to display the data in character format as explained in the Expanded Data Field Screen, or in hexadecimal format as explained in the Memory Display.

File Abend Re-creation 

You can access the following File Abend Re-creation information from the Abend Re-creation menu to obtain the information required for re-creating abends with file information. 

MQ Abend Re-creation 

You can access the following MQ Abend Re-creation information from Abend Re-creation menu. This screen displays information such as:

• Return code
• Reason Code
• The opened Queues
  • Get/Put/Open options
• information on Message buffer
• A sample of message present in the opened queue at the time of the abend.

You can use the cursor point-and-shoot feature and press Enter on the variable data field to get more information on Local Queue Definitions, Get options, Put Options and  Open Options for a specific queue.

Linkage Section Abend Re-creation:

You can access the following File Abend Re-creation information from the Abend Re-creation menu. This screen displays information regarding linkage section variables.

In case Source is not present the below screen would be displayed

CA-IDMS Information Screen

The CA-IDMS Information menu, shown in the following figure displays IDMS summary information. Access this screen from the Report Menu for a batch entry that contains IDMS information. Use the cursor point-and-shoot feature to position the cursor on the Trace field and press Enter to display the DataBase Command Trace screen, as described in Database Command Trace Screen. Enter the following line commands to the left of the Program Name field for additional IDMS information:

• E (Environment Data): Displays the Environment Data screen as described in CA-IDMS Environment Data Screen
• D (Data Base Statistics): Displays the Data Base Statistics screen as described in Data Base Statistics Screen.
• R ( Current Records): Displays the Current Records screen as described in Current Records Screen.
• A (Current Areas): Displays the Current Areas screen as decsribed in Current Areas Screen.
• S (Current Sets): Displays the Current Sets screen as described in Current Sets Screen.

CA-IDMS Information Screen

Database Command Trace Screen

The Database Command Trace screen displays the program flow of the last ten calls, including the following:

• Program reference statement of each call
• Complete text of the database command
• Status code of each call

Access the Database Command Trace screen by using the cursor point-and-shoot feature to position the cursor on the Trace field and pressing Enter.

Use the cursor point-and-shoot feature to position the cursor on the Status field and press Enter to display a pop-up window with a description for the status code. Use the cursor point-and-shoot feature to position the cursor on the DB XREF field and press Enter to display the Database Cross Reference  screen.

Database Command Trace Screen

Database Cross Reference Screen

The Database Cross Reference screen displays the database key cross-reference with the time and actual database (DB) key in both hexadecimal and decimal format. Access this screen from the Database Command Trace screen by using the cursor point-and-shoot feature to position the cursor on the DB XREF field and pressing Enter.

Database Cross Reference Screen

CA-IDMS Environment Data Screen

The following CA-IDMS Environment Data screens displays the IDMS environmental information that includes:

• Subschema
• Version number
• Region type
• IDMS release number
• Central version system ID.

This screen may also display a specialized Error Analysis section that includes:

• The text and location of the IDMS command in error
• The particular error status code
• An error message.

Access this screen by entering the E (Environment Data) line command to the left of a program name on the CA-IDMS Information screen.

CA-IDMS Environment Data

CA-IDMS Environment Data

Data Base Statistics Screen

The following Data Base Statistics screen displays the database statistics for this particular run unit. Access this screen from the CA-IDMS Information screen by entering the D (Data Base Statistics) line command to the left of a program name.

Data Base Statistics Screen

Current Records Screen

The Current Records screen displays the current records for the run unit. Access this screen from the CA-IDMS Information screen by entering the R (Current Records) line command to the left of a program name. Use the cursor point-and-shoot feature to position the cursor on the AREAS field or the SETS field and press Enter to toggle between the Current Areas  screen and the Current Sets screen respectively.

Use the cursor point-and-shoot feature to position the cursor on a record name and press Enter to display the Record Contents screen, as described in Record Contents Screen.

Current Records Screen 

Current Areas Screen

The following Current Areas screens displays the current areas for the run unit. Access this screen from the CA-IDMS Information screen by entering the A (Current Areas) line command to the left of a program name. Press the RIGHT PF key (PF11) to scroll the display of the screen to the right to view additional fields.

Use the cursor point-and-shoot feature to position the cursor on the RECORDS field or the SETS field and press Enter to toggle between the Current Records screen and the  Current Sets screen respectively.

Current Areas Screen

Current Areas Screen, Scrolled Right

Current Sets Screen

The Current Sets screen, shown in the following figures , displays the current sets for the run unit. Access this screen from the CA-IDMS Information screen by entering the S (Current Sets) line command to the left of a program name. Press the RIGHT PF key (PF11) to scroll the display of the screen to the right to view additional fields.

Use the cursor point-and-shoot feature to position the cursor on the RECORDS field or the AREAS field and press Enter to toggle between the  Current Records screen and the Current Areas screen respectively.

Current Sets Screen

Current Sets Screen, Scrolled Right

Record Contents Screen

The Record Contents screen displays the current record contents. Access this screen from the Current Records screen by using the cursor point-and-shoot feature to position the cursor on a record name and pressing Enter.

Use the cursor point-and-shoot feature to position the cursor on an address to display it in hexadecimal format on the Memory Display, which is described in Memory Display.

Record Contents Screen

Abend-AID for WebSphere MQ

Your site must be licensed for the Abend-AID for WebSphere MQ optional support in order to view WebSphere MQ-related information for batch dumps in the Abend-AID Viewer. The screens for MQSeries MQPUT and MQGET calls are nearly identical. For purposes of this manual, screens for MQPUT calls are shown unless otherwise indicated.

WebSphere MQ Information Menu

Access MQ information relevant to the abended transaction through the WebSphere MQ Information Menu. Display the menu in one of the following ways:

• From the Abend-AID Directory, enter the M line command next to the report of interest. Then select the MQINFO option from the Report Menu.
• From the Diagnostic Summary, use the cursor point-and-shoot feature and press Enter on the MQINFO field, which is located under the Supporting Information section.
• Use the MQINFO fast-path command from any screen within the selected report.

WebSphere MQ Information Menu

On the Command line, enter one of the following option numbers or use the cursor point-and-shoot feature and press Enter at the associated mneumonic:

• 1 MQDIAG: Displays diagnostic information for the WebSphere MQ reason code. See WebSphere MQ Reason Code Screen.
• 2 MQCALL: Displays detailed information about the last WebSphere MQ call issued from a local queue. See Last WebSphere MQ Call Information Screen.
• 3 MQOPEN: Displays all WebSphere MQ queues that were open at the time of the dump. See Opened Queues at Dump Time Screen.

WebSphere MQ Reason Code Screen

The WebSphere MQ Reason Code screen, shown in the following figures, displays diagnostic information for the WebSphere MQ API reason codes. Access this screen from the WebSphere MQ Information menu or from the Reason field on the Last WebSphere MQ Call Info screen.

WebSphere MQ 2033 Reason Code Screen

WebSphere, MQ 2033 Reason Code Screen

Last WebSphere MQ Call Information Screen

The MQGET call retrieves a message from a local queue that has been opened using the MQOPEN call. The Last WebSphere MQ Call Info screen displays the parameters that were used in the MQGET call. The fields presented on this screen depend upon the type of call being reported. The following figure shows the fields that are displayed for an MQGET.

To access this screen, select option 2 MQCALL from the WebSphere MQ Information Menu or use the MQCALL fast-path command from any screen within the selected report.

Last WebSphere MQ Call Info Screen

Use the cursor point-and-shoot feature and press Enter to access additional information for the selectable fields. For an MQGET, the following fields are selectable:

• Hobj: Presents the Handle Information screen, as described on Handle Information screen.
• MsgDesc: Presents the Message Description screens, as described on Message Descriptor screens
• GetMsgOpts: Presents the GMO Detail screen, as described on PMO Detail screen When you’re looking at an MQPUT, this field’s label is PutMsgOpts, which presents the PMO Detail screen, as described on here.
• Buffer: Presents the Message Buffer Area screen, as described on Message Buffer Area screen.
• Reason: Presents the WebSphere MQ Reason Code Text screen, as described on WebSphere MQ Reason Code screen.
• Queue Used in Call: Presents the Local Queue Definition screens, as described on Local Queue Definition screens.
• Open Options: Presents the Open Options screen, as described on Open Options screen.
• Get Options: Presents the GMO Options screen, as described on Opened Queues at Dump Time screen. When you’re looking at an MQPUT, this field’s label is Put Options, which presents the PMO Options screen, as described on here.

Handle Information Screen

The Handle Information screen displays object handle information for the selected queue.

Access this screen in one of the following ways:

• Use the cursor point-and-shoot feature and press Enter on the Hobj field on the Last WebSphere MQ Call Info  screen. This displays the handle information from the queue used in the last MQ call prior to the dump.
• Enter the H line command next to the handle value of interest on the  Opened Queues at Dump Time screen. This displays the attributes of the selected queue.

Handle Information Screen

Use the cursor point-and-shoot feature and press Enter on the Open Options fields to see information about the MQOPEN call associated with the given transaction. See Open Options Screen for more information.

Message Descriptor Screens

The following Message Descriptor  screens display information interpreted from the MQSeries Message Descriptor (MQMD) structure. Access the Message Descriptor screens from the MsgDesc field on the Last WebSphere MQ Call Information screen, as described in Last WebSphere MQ Call Information Screen.

On the first screen, use the cursor point-and-shoot feature to position the cursor on the Report Options field and press Enter to display the Report Options screen. Use the cursor point-and-shoot feature to position the cursor on the Message ID (Hex) or Correlation ID (Hex) field and press Enter to toggle between the display of these fields’ values in hexadecimal or character format. Similarly, on the second screen, use the cursor point-and-shoot feature to position the cursor on the Account Token (Hex) field to toggle between the display of this field’s values in hexadecimal or character format.

 Message Descriptor Screen

Message Descriptor Screen

Report Options Screen

The Report Options screen displays information interpreted from the MQRO_OPTIONS in the message descriptors. These control the generation of reports. Each option and its setting that is supported on OS/390 is shown. Help information is available for every option. To display the help information, use the cursor point-and-shoot feature to move the cursor to the option on the screen and press the HELP PF key. PF1 is the default Help PF key.

Access the Report Options screen from the Message Descriptor Page 1 screen, as described in Message Descriptor Screens.

Report Options Screen

GMO Detail Screen

The GMO Detail  screen displays information interpreted from the MQSeries Get-Message Options (GMO) structure. This screen is displayed from the Last WebSphere MQ Call Info screen (for an MQGET call). Use the cursor point-and-shoot feature to position the cursor on the GetMsgOpts field and press Enter to display this screen.

Use the cursor point-and-shoot feature to position the cursor on the Options field and press Enter to display the GMO Options screen. Use the cursor point-and-shoot feature to position the cursor on the address in the Signal1 field and press Enter to display the associated Event Control Block (ECB) address in hexadecimal format on the Memory Display, which is explained in Memory Display.

GMO Detail Screen

Message Buffer Area Screen

The Message Buffer Area screen displays the message buffer area in vertical-hexadecimal format.

Access this screen from the Buffer field on the Last WebSphere MQ Call Info screen.

Message Buffer Area Screen