Abend Analyzer for Mainframe

Abend Analyzer for Mainframe provides an interface to SymDump® CICS and SymDump® Batch. This extension allows you to browse, manage and view formatted abend reports and symbolic data in a modern IDE environment.

Abend Analyzer for Mainframe is also part of Code4z, an all-round package that offers a modern experience for mainframe application developers, including extensions for language support, data editing, testing, and source code management. For an interactive overview of Code4z, see the Code4z Developer Cockpit.

Prerequisites

Before you use Abend Analyzer for Mainframe, ensure that your site and workstation meet the following requirements:

Server

Abend Analyzer for Mainframe requires SymDump version 11 to operate.

Before you use Abend Analyzer for Mainframe, complete the following tasks:

Acquire and install PTFs LU02175, LU03402, LU03403, and LU12023.
Configure the Testing Tools Server and SymDump REST API. If you already have a Testing Tools Server instance for InterTest and SymDump, redeploy it after you install the PTFs from the previous task.
To connect through the Zowe API Mediation Layer, integrate the SymDump REST API with Zowe API ML.

For more information, see the InterTest and SymDump documentation.

Client

Abend Analyzer for Mainframe is supported on Visual Studio Code and Github Codespaces.

Integrate with Zowe Explorer

Integrate Abend Analyzer for Mainframe with Zowe Explorer and set up a Zowe profile containing mainframe credentials to enable the Single Sign-On feature of Zowe API ML.

Getting Started

To get started with Abend Analyzer for Mainframe, create a connection to the mainframe and load your SymDump abend report repository.

Add a Connection

Add a connection to the mainframe to enable communication between Abend Analyzer for Mainframe and the Testing Tools Server. You can connect directly to your Testing Tools Server or API Mediation Layer gateway using basic authentication (username and password), or the Single Sign-On feature of Zowe API ML. To use Single Sign-On, ensure you have a Zowe profile containing mainframe credentials and the host and port of your Zowe API ML gateway.

Select the Abend Analyzer for Mainframe tab in your IDE.
In the sidebar, click Add Connection.
The prompt bar displays at the top of the window.
Enter a name for your connection. Ensure that the connection name is unique.
Select authentication with Username and Password or Zowe API ML SSO.
If you selected Username and Password, do the following:
1. Enter the URL of your Testing Tools Server instance in the format http(s)://host:port, or a Zowe API ML gateway URL in the format http(s)://host:port/service-id/api/v1.
2. (Optional) Enter your mainframe username and password. If you skip this step, the credentials prompt displays when you open a repository.
If you selected Zowe API ML SSO, do the following:
1. Enter your Zowe API ML service ID.
2. Select your Zowe profile from the list.

The connection displays in the sidebar.

To edit your connection, right-click the connection in the sidebar and select Edit connection, then follow the steps above again.

To delete a connection, right-click the connection in the sidebar and select Delete connection.

Load a Repository

Load an abend report repository to view reports.

Click the + icon next to your connection name.
The prompt bar displays at the top of the window.
Enter the full name of your abend report repository data set.
Select either CICS or Batch from the dropdown list.
If you are prompted, enter your mainframe username and password.
The abend report repository loads in the sidebar.

If you specified an incorrect DSN, right-click the repository in the sidebar and select Edit DSN to specify the DSN again.

To remove a repository from the sidebar, right-click the repository and select Remove dataset.

Filter and Sort Reports

To sort reports in the repository by date, right click the repository data set in the tree and select Sort by date (ascending) or Sort by date (descending).

To sort by a different parameter, select Sort and select one of the options that display at the top of the window. To change the order from ascending to descending, select Sort and choose the same option again.

If you have a large number of reports, you might need to apply a filter to find the reports you need.

Right-click the repository data set in the tree and select Filter.
A list of filter options displays at the top of the window.
Select one of the options.
Enter a filter string and press enter.
Records containing the filter string are displayed in the sidebar.

Only one filter can be applied at a time. To reset the filter, click the yellow Cancel filter icon next to the repository data set.

Lock, Unlock and Delete Reports

You can lock abend reports to ensure that they are not edited or deleted by other users. To lock or unlock a report, right-click it and select **Lock report** or **Unlock report**.

To delete a report, click the delete icon next to the report name in the sidebar. The delete icon does not appear if the report is locked.

Load Symbolic Data From a PROTSYM

If you have symbolic data saved in a PROTSYM, you can load the PROTSYM using Abend Analyzer for Mainframe to display the symbolic data in the report.

Under your connection, click the + icon next to PROTSYMS.
The prompt bar displays at the top of the window.
Specify the DSN of your PROTSYM and press enter.
Open the report linked with the specified PROTSYM. If the report is already open, close and reopen it.

Display Options

To display global options for your instance of SymDump Batch, right-click your connection and select **Display global options**.

To display an options table for an individual CICS abend report repository (PROTDMP), right-click the data set and select Display PROTDMP options.

Customize the Report Label

You can customize the format of the report label to choose what data is displayed.

In the Extensions tab, click the cog icon next to Abend Analyzer for Mainframe and select Extension Settings to open the extension settings. Under Symdump - View: Label, specify the text and the variables that you want to include in the report label. Allowed variables are:

${ABEND}
${DATETIME}
${JOB}
${KEY}
${LOCK}
${OFFSET}
${PROGRAM}
${STEP}
${SYSTEM}
${USER}

Technical Assistance and Support for Abend Analyzer for Mainframe

The Abend Analyzer for Mainframe extension is made available to customers on the Visual Studio Code Marketplace in accordance with the terms and conditions contained in the provided End-User License Agreement (EULA).

If you are on active support for SymDump, you get technical assistance and support in accordance with the terms, guidelines, details, and parameters that are located within the Broadcom Working with Support guide.

This support generally includes:

Telephone and online access to technical support
Ability to submit new incidents 24x7x365
24x7x365 continuous support for Severity 1 incidents
24x7x365 access to Broadcom Support
Interactive remote diagnostic support
Technical support cases must be submitted to Broadcom in accordance with guidance provided in “Working with Support”.

Note: To receive technical assistance and support, you must remain compliant with “Working with Support”, be current on all applicable licensing and maintenance requirements, and maintain an environment in which all computer hardware, operating systems, and third party software associated with the affected Broadcom software are on the releases and version levels from the manufacturer that Broadcom designates as compatible with the software. Changes you elect to make to your operating environment could detrimentally affect the performance of Broadcom software and Broadcom shall not be responsible for these effects or any resulting degradation in performance of the Broadcom software. Severity 1 cases must be opened via telephone and elevations of lower severity incidents to Severity 1 status must be requested via telephone.

Privacy Notice

The extensions for Visual Studio Code developed by Broadcom Inc., including its corporate affiliates and subsidiaries, ("Broadcom") are provided free of charge, but in order to better understand and meet its users’ needs, Broadcom may collect, use, analyze and retain anonymous users’ metadata and interaction data, (collectively, “Usage Data”) and aggregate such Usage Data with similar Usage Data of other Broadcom customers. Please find more detailed information in [License and Service Terms & Repository](https://www.broadcom.com/company/legal/licensing).

This data collection uses built-in Microsoft VS Code Telemetry, which can be disabled, at your sole discretion, if you do not want to send Usage Data.

The current release of Abend Analyzer for Mainframe collects anonymous data for the following events:

Activation of this extension
Managing connections
Interaction with data sets, dumps, reports and protsyms
Sorting
Filtering
Display options function

Each such event is logged with the following information:

Event time
Operating system and version
Country or region
Anonymous user and session ID
Version numbers of Microsoft VS Code and Abend Analyzer for Mainframe