Release Notes

Abend-AID Release 17.02

October 2, 2017

Latest Release Notes

What’s New

Software and Hardware Requirements

Technical Notes

Known Issues

Product Documentation

Support Resources

Latest Release Notes

For the most current version of these Release Notes , go to https://go.compuware.com, Compuware's customer solutions website. The first time you access FrontLine, you are required to register and obtain a password. After logging onto Compuware Go, select your product from the drop-down list. Below the product name at the top of the page, click the Documentation link. You will find the latest Release Notes listed with the other product documentation.


What’s New

Note: Abend-AID and Abend-AID for CICS Release 17.02 requires Enterprise Common Components Release 17.02 or more current, with all current maintenance applied. Click the following link for access to ECC current maintenance: https://go.compuware.com/products/cy/fixes/30240.aspx .

Compuware is pleased to announce Abend-AID and Abend-AID for CICS Release 17.02 with the following enhancements:

Abend-AID and Abend-AID for CICS Enhancements
October 2, 2017
Compuware PARMLIB Enhancement

Compuware has enhanced the Common PARMLIB processing controlled by the Compuware Mainframe Services Controller (CMSC), including centralized parameter validation. Additionally, some parameters were changed to reduce their complexity and make them easier to understand and configure. These changes have been incorporated into the six sample parameter members listed below in the Abend-AID installation sample library ( hlq .CTL). To effect these changes, Enterprise Common Components 17.02 is required with current maintenance applied.

June 28, 2017
Enhanced Abend-AID Sample Parameter Members

To simplify Abend-AID new installations, the parameters used to control the viewing server, BDCAS, and TDCAS that are stored as members in the Compuware Mainframe Services Controller (CMSC) Common PARMLIB have been consolidated into the following six members in the Abend-AID installation sample library ( hlq .CTL):

AAVW00

Contains the core viewing server parameters used to access the Abend-AID Viewer and the Abend-AID Web Browser Interface.

AAVWALL

Contains comprehensive viewing server parameters used to customize the viewing server.

AABD00

Contains the core Batch Dump Capture Address Space (BDCAS) parameters.

AABDALL

Contains comprehensive BDCAS parameters.

AATD00

Contains the core Transaction Dump Capture Address Space (TDCAS) parameters.

AATDALL

Contains comprehensive TDCAS parameters.

Enhanced Abend-AID Configuration Menu

The Configuration Menu of the Abend-AID Configuration and Customization Dialog 17.02 has been enhanced to simplify the Abend-AID Viewer option. Because Abend-AID Viewer configuration is required, this option has been modified as a heading, which installers no longer need to select. They can simply select the Abend-AID and/or Abend-AID for CICS option displayed under this heading.

April 3, 2017
Embedded Source Support

Abend-AID supports the new Embedded Source Support (ESS) feature that was introduced in Enterprise Common Components Release 17.02. If ESS was used when preprocessing or postprocessing your COBOL 5.1 and more current source, then Abend-AID automatically uses the ESS records at view time to provide source support instead of using DDIO files, provided that the PDSE containing the program object is available to the Abend-AID viewing server.

Large Terminal Sizes

The Abend-AID Viewer has been enhanced to support large terminal sizes up to 102x160 (102 rows by 160 columns).

Directory View Change

Available via the Site Defaults Options menu of the Abend-AID Viewer Customization Options facility, the Site User Profile screen has been enhanced with an additional value for the Logon Directory View option. Installers can specify A to bypass display of the Fault Summary (default) at logon and directly display instead the entire Abend-AID Directory for their site. The change takes effect at the next and subsequent sessions. Refer to the

Messages in MVS/Quick-Ref ®

With Release 18.02, Abend-AID messages are now available in the Chicago-Soft, Ltd., files or databases supplied to their MVS/Quick-Ref® customers. Sites no longer need to download the messages from https://go.compuware.com .

go.compuware.com

In the Abend-AID product screens, references to FrontLine have been changed to https://go.compuware.com .

October 3, 2016
Support for IBM Authentication Methods

To provide a higher level of authentication assurance for IBM z/OS applications, Abend-AID, Abend-AID for CICS, and Abend-AID Fault Analytics now support the use of the following authentication methods:

  IBM Password Phrase Authentication for z/OS

  IBM Multi-Factor Authentication for z/OS.

These enhancements require Enterprise Common Components PTF CXR110A.

Abend-AID and Abend-AID for CICS Distributed Viewing does not currently support these enhancements.

Note: See the Technical Notes section for instructions for enabling this authentication feature.

Abend-AID Fault Analytics Packaging and Installation with the Compuware Web Products

With Release 17.02, for simplified installation and improved usability, Abend-AID Fault Analytics is now packaged and installed with the following Compuware Web products:

  Compuware Enterprise Services (CES)

  iStrobe

  ISPW Web

  Topaz for Java Performance.

Abend-AID Fault Analytics installers must install CES and Abend-AID Fault Analytics and can optionally install any combination of the above Compuware Web products from the single-image product media or RFN image. Refer to the Compuware Web Products Installation and Configuration Guide at https://go.compuware.com .

June 28, 2016
Abend-AID-Only Enhancements
Point-and-Shoot Support for PL/I Source Listings

Users can employ the point-and-shoot method to display information on a selected field in a PL/I source listing for a batch report. Users tab to the desired field and press the Enter key to display the field contents in a vertical-hexadecimal format. The field name and field type are also displayed.

SYSMDUMP processing without //ABNLTERM or //ABENDAID DD in JCL

Abend-AID now processes reports for jobs with the //SYSMDUMP DD without the requirement for additional Abend-AID DDs in the JCL.

Duplicate SNAP Dump Suppression

Duplicate SNAP dumps invoked by the same program within a defined time interval can now be suppressed in order to restrict resources used during SNAP dump capture.

Abend-AID and Abend-AID for CICS Enhancements

Abend-AID Fault Analytics Rules have been enhanced to include quicker display of rules, pagination, expansion to show rule content, and re-ordering.

April 1, 2016
Compuware Simple Installation for Mainframe Products

Compuware's Simple Installation fundamentally changes the way Compuware mainframe products are installed and configured. Simple installation streamlines the process into logical task flows and checklists, as suggested through numerous customer feedback initiatives. Compuware delivers the first phase of Simple Installation with the introduction of PARMLIB-enabled solutions in Release 17.02 of our mainframe products.

The next phases of Simple Installation are planned and will provide more features to further reduce the time, resources, and effort needed to install and configure Compuware solutions across one or many LPAR instances.

CMSC PARMLIB Enablement

Each mainframe product now uses Compuware Mainframe Services Controller (CMSC) PARMLIB facility, which gives many advantages over previous customization methods. Some of these features include:

  Similarity to the current IBM z/OS PARMLIB, which is readily intuitive and familiar to many z/OS software installers.

  Simple, consistent method to configure human readable parameters for Compuware products using a text editor.

  Use of System Symbolics in PARMLIB members allows for maximum flexibility.

  Easy deployment of installed software to other LPARs and sysplexes by simply copying the current PARMLIB file.

  Migration to newer releases by simply copying the current PARMLIB file, thereby shortcutting or eliminating future repetitive and/or lengthy tasks (such as, compiling or executing configuration dialogs).

Abend-AID PARMLIB Enablement

The Abend-AID parameters used to control the viewing server, BDCAS, and TDCAS are now stored as members in the Compuware Mainframe Services Controller (CMSC) Common PARMLIB. The CMSC is an Enterprise Common Components facility, which is SMP/E-installed as part of the ECC Release 16.05 single-image installation. Refer to the Abend-AID and Enterprise Common Components installation guides for more information about the CMSC Common PARMLIB. Download the guides from the product documentation sites at https://go.compuware.com .

RACF PassTicket Support

With Topaz Workbench Release 17.02 and Enterprise Common Components Release 16.05 (PTF CXR041A), the Abend-AID Eclipse Release 17.02 plugin will support RACF PassTickets. RACF PassTickets are alternatives to using RACF passwords. They are commonly used to remove the need to send passwords across the network in clear text.

Enhanced Abend-AID Directory

The Abend-AID Directory has been enhanced with two additional columns to display the time and date of the most recent occurrence of duplicate dumps. If there are no duplicates, the time and date of the actual report is shown.


Software and Hardware Requirements

For further information about IBM System z software and hardware compatibility--specifically regarding IBM's z/OS Recommended Service Upgrade, IBM's Extended Address Volumes, IBM DB2 for z/OS, and z/OS product compatibility--refer to https://go.compuware.com/charts/hardware.aspx .

Abend-AID and Abend-AID for CICS
Hardware Platforms

Mainframe Systems:

-- z13, z13s

-- zEC12, zBC12

-- z196, z114

-- z10-EC/BC

-- z9-EC/BC

-- z900, z990

-- z800, z890

EAV Storage

Yes

Operating Systems

  IBM z/OS 2.1, 2.2, 2.3

  IBM ISPF for the supported z/OS releases

Major Subsystems

  IBM CICS Transaction Server for z/OS 4.1, 4.2, 5.1, 5.2, 5.3, 5.4* (Abend-AID for CICS only)

  IBM DB2 for z/OS 10.1, 11.1, 12.1

  IBM IMS Transaction and Database Servers 13.1, 14.1

  IBM WebSphere MQ for z/OS 7.1, 8.0, 9.0*, 9.0.1

Languages

  IBM Enterprise COBOL for z/OS 4.2, 5.1, 5.1.1, 5.2, 6.1, 6.2*

  IBM Enterprise PL/I for z/OS 4.3, 4.4, 4.5, 5.1, 5.2*

  IBM High Level Assembler for z/OS, z/VM, and z/VSE V1.6

  IBM VS FORTRAN Compiler and Library V2.6 (Abend-AID only)

Corequisites

Enterprise Common Components (ECC) Release 17.02 or more current products and components, with all current maintenance applied:

-- Compuware Shared Services

-- License Management System

-- Host Communications Interface

-- Base Services

-- Compuware Mainframe Services Controller


Notes:

1. Abend-AID Release 17.02 requires Enterprise Common Components (ECC) Release 16.05 or more current. ECC Release 17.02 is required for Embedded Source Support (ESS).

2. ECC Release 16.05 or more current cannot be in the same zones as Abend-AID 12.4 and prior releases.

Distributed

Browsers and IDEs:

-- Google Chrome (current version)

-- Mozilla Firefox (current version)

-- Eclipse 3.6

-- Microsoft Edge

-- Microsoft Internet Explorer 9, 10, 11 for the supported Windows releases

ISV Software

  CA IDMS 18.5, 19.0* (Abend-AID only)

  CICS Web Interface (Abend-AID for CICS only)

  Geac Enterprise Server (formerly Dun & Bradstreet Software) E Series Applications (MSA DCI) (Abend-AID for CICS only)

  Hogan System Software (Abend-AID for CICS only)

  Innovation Access Method (IAM) 9.1, 9.2, 9.3 (Abend-AID only)

  Interactive Problem Control System (IPCS) Command Facility

* For specific required PTFs, consult the Product Currency Tables at https://go.compuware.com/charts/default.aspx . Review the Abend-AID and/or Abend-AID for CICS table(s) as applicable to your site.

Additional Abend-AID Fault Analytics-Only Support
IBM Specialty Processors Enablement

  Abend-AID Fault Analytics Collector is zIIP

  Abend-AID Fault Analytics Server is zAAP

Hardware Platforms

Mainframe Systems (for a web server running on IBM z/OS UNIX System Services or IBM Linux on System z):

-- z13, z13s

-- zEC12, zBC12

-- z196, z114

-- z10-EC/BC

-- z9-EC/BC

-- z900, z990

-- z800, z890

Corequisite

Compuware Enterprise Services (CES) version matching the exact release of Abend-AID Fault Analytics
(for example, Fault Analytics 18.02.00 requires CES 18.02.00).

Distributed Systems

  Linux x64

  Windows x64

Distributed

  Google Chrome (current version)

  Microsoft Internet Explorer 10, 11 for the supported Windows releases

  Microsoft Edge

  Mozilla Firefox (current version)

The following sections show the possible software configurations for each of the components tested with Fault Analytics. Other configurations might be compatible with Fault Analytics, but have not been tested.

Operating Systems

  IBM z/OS UNIX System Services with JZOS toolkit (for the supported releases of z/OS)

  Microsoft Windows 7, 8.1, 10 64-bit

  Microsoft Windows Server 2008, 2008 R2, 2012, 2012 R2, 64-bit

  Red Hat Enterprise Linux 5.x, 6.x, 64-bit*

  SUSE Linux Enterprise Server 10, 11, 64-bit*

* Red Hat Enterprise Linux and SUSE Linux Enterprise Server are supported on Intel x64 with IBM Linux on System z.

Languages

  IBM 64-bit SDK for z/OS, Java Technology Edition V7 SR4 FP2, 7.1, 8

  Oracle Java SE 64-bit JDK 7 Update 21, 8

Hardware Requirements

These are the minimum requirements for a server dedicated to Abend-AID Fault Analytics with less than 20 users. If performance problems are encountered, it may be necessary to increase memory or processor speed.

  Hard Disk: 1 GB minimum

  Memory: 4 GB minimum

  Processor: 2 GHz minimum

Database Management Server Requirements
Major Subsystems

IBM DB2 for z/OS V10.1, 11.1, 12.1

Distributed

IBM DB2 for Linux, UNIX, and Windows (LUW) 9.7, 10.1, 10.5

ISV Software

  Microsoft SQL Server 2005, Standard and Enterprise Editions

  Microsoft SQL Server 2008, Standard and Enterprise Editions

  Microsoft SQL Server 2008 R2, Standard, Enterprise, and Datacenter Editions

  Microsoft SQL Server 2012, Standard and Enterprise Editions

  Oracle Database 11g, 12c

Discontinued Support

Abend-AID and Abend-AID for CICS Release 17.02 is the last release to support the following software:

  IBM CICS Transaction Server for z/OS 4.1

  IBM DB2 for z/OS 10.1

  IBM Enterprise PL/I for z/OS 4.3

  IBM WebSphere MQ for z/OS 7.1

Abend-AID Fault Analytics 17.02 is the last release to support Microsoft SQL Server 2005, Standard and Enterprise Editions.


Technical Notes

  In order for Abend-AID to support the new IBM Password Phrase Authentication for z/OS and IBM Multi-Factor Authentication for z/OS enhancements, a new Abend-AID viewing server parameter member must be added to the Compuware Mainframe Services Controller (CMSC) Common PARMLIB. The CMSC is an Enterprise Common Components facility, which is SMP/E-installed as part of the ECC Release 16.05 or more current single-image installation. Refer to the Abend-AID and Enterprise Common Components installation guides for more information about the CMSC Common PARMLIB.

Specify YES for the EXTERNAL_SECURITY_PASSPHRASE Abend-AID viewing server parameter to use the higher level of authentication. If not specified, the default NO is used.

  A Google Chrome security update prohibits viewing of WebHelp when the help is deployed locally from a file server (as opposed to a Web server). Attempting to view locally deployed help displays a blank help window. Compuware suggests that online help be viewed using Internet Explorer. Alternatively, Chrome's security feature can be turned off by launching Chrome with the command line option --allow-file-access-from-files. This method should only be used when opening local WebHelp that you trust.

  If you are performing an upgrade installation of Abend-AID Fault Analytics, be sure to do the following in your installation environment before beginning the upgrade:

-- For z/OS UNIX, stop the CES started task.

-- For Linux, stop the CES daemon.

-- For Windows, stop the CES Service.

  Abend-AID Fault Analytics and Compuware Enterprise Services must be at the exact same release level.

  During a CES and Abend-AID Fault Analytics installation, the user's specified JDK must be 64-bit.


Known Issues

  The ability to test Fault Analytics 17.02.01 Rules is not present for this release.

  When installing Fault Analytics 12.04.05 on Windows, if the user chooses to configure HTTPS communications with CES, the path to a keystore is stored with un-escaped back-slashes (\). As a result, the Fault Analytics Manager will not start correctly and, when attempting to launch Fault Analytics, a message will indicate that the product could not obtain configuration information from the Fault Analytics Manager. To correct the problem, edit the file configuration.properties in the Fault Analytics Manager directory by locating the Keystore path near the end of the file and changing all occurrences of back-slash (\) to a forward slash. (/).

  When installing CES on Windows, users may encounter an error referring to the Java VM. This is a problem with InstallAnywhere and Java 8. It can be resolved by removing the following entry from the Path variable:

C:\ProgramData\Oracle\Java\javapath

The Path variable is accessed from:

Control Panel>System>Advanced System Settings>Environment Variables>System Variables

  If a user specifies a temporary directory smaller than that which is required for installation, a message may appear indicating that the evaluation period has expired. Reallocate space and restart the installation process.


Product Documentation

The product installation package does not include the product documentation. The following Abend-AID documentation is available in electronic format on the product documentation site at Compuware’s FrontLine customer solutions website, https://go.compuware.com .

  Release Notes in HTML format

  The product manuals in PDF format, which may include a PDX index file and associated folder.

Access the Abend-AID documentation on the FrontLine documentation site at go.compuware.com .

PDF and PDX Files

View and print the PDF files with Adobe Reader version 6.0 or more current. Download a free copy of the reader from Adobe’s website, http://www.adobe.com .

Note: With a few minor exceptions, the provided PDF files comply with the requirements of section 508 of the Rehabilitation Act of 1973.

How to Use a PDX File to Search a Compuware Documentation Set

Compuware creates a PDX file for each release of every mainframe product. The file is available in ZIP format on FrontLine, Compuware’s customer solutions website, along with this README and a folder containing two data files. By pre-cataloging the content of the product’s PDFs, the PDX file allows you to quickly search across the entire documentation set without having to search each PDF individually.

To use the PDX file for a Compuware product:

1. Go to FrontLine (go.compuware.com) and navigate to the Documentation page for the desired product.

2. Download all of the PDF files for that product to the same local directory. (The Compuware Installer PDF is only cataloged in the Enterprise Common Components PDX file.)

3. Download the ZIP containing the product’s index file.

4. Extract the contents of the ZIP, sending it to the same directory as the PDF files. Be sure to select “All files/folders in archive” and “Use folder names.”

5. Double click the product’s PDX file (< product >Index.pdx). A Search dialog box will appear with the index pre-selected.

6. Enter a word or phrase to search for. To optimize your search, select one or more qualifiers such as “Whole words only,” then click Search.

Your search results will appear almost instantly, grouped by document. Each document with results can be expanded to show a list of matches, with each match including a brief sample of the context in which it occurred. Every match is hyperlinked to the specific page in the PDF where it was found, enabling you to quickly locate the information you’re looking for.


Support Resources

Compuware provides a variety of support resources to make it easy for you to find the information you need.

Compuware FrontLine Customer Solutions Website

You can access online information for Compuware products via our FrontLine Customer Solutions website at https://go.compuware.com .

Compuware FrontLine provides access to critical information about your Compuware products. You can review frequently asked questions, read or download documentation, access product fixes, or e-mail your questions or comments. The first time you access Compuware FrontLine, you are required to register and obtain a password. Registration is free.

Contacting Customer Solutions

Phone

  USA and Canada: 1-800-538-7822 or 1-313-227-5444.

  All other countries: Contact your local Compuware office. Contact information is available at https://go.compuware.com .

Web

You can report issues via the Quick Link Create & View Support Cases on the Compuware FrontLine home page.

Note: Please report all high-priority issues by telephone.

Mail

Compuware Customer Solutions
Compuware Corporation
One Campus Martius
Detroit, MI 48226-5099

Corporate Website

To access Compuware’s site on the Web, go to http://www.compuware.com .

The Compuware site provides a variety of product and support information.

 

Before Contacting Customer Support

If you need information about Abend-AID’s operating or performance capabilities, or assistance in troubleshooting, first refer to the Abend-AID documentation set.

If you call Abend-AID Customer Support for troubleshooting assistance, provide the following information applicable to your problem so that we can help you as quickly as possible:

  The client number as displayed in the header of the Abend-AID report.

  The Abend-AID release number displayed in the header of the Abend-AID report.

  The operating system and release in use as displayed in the header of the Abend-AID report to help determine operating system dependencies.

  All printed output from the job in question, including console messages, JCL stream, Abend-AID output, and the standard dump (SYSUDUMP, SYSABEND, or SYSMDUMP).

  Output from jobs that were used to install or customize Abend-AID. This output includes the report produced by the CWVERIFY utility. $11VERIF is the Abend-AID installation library member used to execute CWVERIFY.

If a problem arises while installing/using the Abend-AID Viewer or Abend-AID for CICS, consult the documentation. If the problem persists, please obtain the following information (if applicable) before calling Compuware’s 24-hour product support hotline. This information may be required to help determine the cause of the problem:

  The Abend-AID Viewer or Abend-AID for CICS release you are using. To find the release level, enter the SERVINFO fast-path command on any Abend-AID Viewer screen. Position the cursor on the RELEASE field of the displayed screen and press Enter.

  The CICS release you are using.

  The DB2 release you are using.

  The error message, if any, that was displayed. Please note the entire message as some messages report specific information such as parameter values.

  All Abend-AID Viewer or Abend-AID for CICS output for the task you were trying to perform.

  The MVS dump containing the Abend-AID Viewer or Abend-AID for CICS failure.

  An FTP copy of the SVC, SLIP, or SYSMDUMP dump you were trying to import or view.

  The CICS region JES job log.

  The MVS SYSLOG for the involved time period.

  Screen prints of the Dump Analysis Message Log that show the results of importing the region dump.

Note: To display the Dump Analysis Message Log, either select a region dump from the Directory with the G (Messages) line command, or type MLOG in the COMMAND (or OPTION) field on any Abend-AID Viewer screen and press Enter. For MLOG to function, however, you must first select a region dump from the Abend-AID Directory.

  The contents of the viewing server, BDCAS, TDCAS, and CICS region JES output files.

  Any relevant SMP/E output.

  Any other relevant screen prints.