Release Notes

Abend-AID Release 16.05

January 4, 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 support 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 16.05 requires Enterprise Common Components 16.05 or more current with all current maintenance applied.

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

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

January 4, 2016
Abend-AID and Abend-AID for CICS Enhancements
Enhancements to Source Shared Directories Support (SSD)

When following the Source Support Best Practices recommendation that Source Shared Directories (SSD) be paired with each load library with SSD as the last node, you can now append .SSD to the end of the load library name instead of replacing the last node. The viewing server will use the appended load library name to merge the listing without any action from the user.

Improved Navigation for Site Customized Utilities (ISPF only)

Using site customized utilities (ISPF only) to obtain the source DDIO for source support has simpler navigation and customization with fewer required keystrokes.

New Abend-AID SMF Record

Abend-AID now has the option to write out SMF records containing information for each abend at the time of dump capture. A DSECT is available for use with the records. Customers with a suitable reporting process can use these records to produce reports on abend activity. The new WRITE_SMF=(NO|yes,SMF record number) server parameter has been created to enable the writing of these SMF records and to allow the user to specify the SMF record number. This parameter can be used with the BDCAS for batch reporting and the TDCAS for CICS reporting.

New Floating Point Register Displays

Abend-AID has enhanced its display and interpretation of floating point registers to make them more readable to the user. Users may choose from any combination of short, long, or extended and binary, decimal, or hexadecimal for their interpretation. These new displays can be accessed by selecting Interpretation from the previously existing floating point register displays or by entering the fast-path command INTFLOAT .

Health Checks

The Health Checks enhancement uses the IBM Health Check for z/OS to perform some environmental health checks in the BDCAS, TDCAS, and the Abend-AID Viewer. The HEALTH_CHECK=YES startup parameter for each of these Abend-AID components activates the new health checks by default. Refer to the Abend-AID Installation and Customization Guide for more information about Abend-AID/Abend-AID for CICS health checks.

Abend-AID Web Browser Interface Freshened with Updated Color and Icons

Changes have been made to the Abend-AID Web Browser Interface for a more modern look and a consistent feel with other Compuware products.

Enterprise Common Components 16.05 New Packaging

Compuware Shared Services (CSS), Base Services, Host Communications Interface (HCI), License Management System (LMS), and Compuware Mainframe Services Controller (CMSC) are now packaged together into an Enterprise Common Components (ECC) single pair of load libraries. This enhancement will make installation and maintenance of Compuware products easier and quicker.

Dynatrace DB2 Hook Support

Abend-AID has added support to enable the true abending program to be identified when the presence of the Dynatrace DB2 hook is recognized.

Find and Fix Integration with Topaz Workbench JIRA Support

If you are licensed for Topaz Workbench, have configured access to Compuware Enterprise Services (CES) from the Abend-AID viewing server, and are using the Abend-AID Web Browser Interface, you now have the ability to create records in JIRA systems that are registered to the CES.

DB2 Dump Capture Processing Performance Improvements

Abend-AID has made minor improvements to message processing during dump capture of the DB2 information. These changes should result in a reduction in storage utilization, processing time, and the elapsed time to collect the DB2 information.

Enhanced Abend-AID HH:MM:SS Timestamp

Abend-AID has extended the timestamp field on the Abend-AID Viewer directory screen to display the time of abend in hours, minutes, and seconds. This change allows the desired report to be more quickly located for periods of high abend activity.

Re-Architected Abend-AID Fault Analytics Release 16.03

The new architecture for Compuware Enterprise Services, iStrobe, Topaz for Java Performance, and Abend-AID Fault Analytics allows the administrator in the future to apply maintenance only to the products. Customers will no longer have to re-install the products for future maintenance and enhancements. In addition, the Licensing page within Compuware Enterprise Services Release 16.03 has been enhanced to show the IP address that has been given a license and when the license will expire. Refer to the Compuware Enterprise Services Release Notes for more information. Abend-AID Fault Analytics Release 16.03 is compatible with Abend-AID and Abend-AID for CICS Release 16.05.


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 http://frontline.compuware.com/charts/hardware.aspx .

Abend-AID and Abend-AID for CICS
Hardware Platforms

Mainframe Systems:

-- zE13, z13s

-- zEC12, zBC12

-- z196, z114

-- z10-EC/BC

-- z9-EC/BC

-- z900, z990

-- z800, z890

EAV Storage

Yes

Operating Systems

  IBM z/OS V1.13, 2.1, 2.2*

  IBM ISPF for the supported z/OS releases

Major Subsystems

  IBM CICS Transaction Server for z/OS V4.1, 4.2, 5.1, 5.2, 5.3 (Abend-AID for CICS only)

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

  IBM IMS Transaction and Database Servers V12.1, 13.1, 14.1

  IBM WebSphere MQ for z/OS V7.1, 8.0, 9.0

Languages

  IBM Enterprise COBOL for z/OS V4.2, 5.1, 5.1.1, 5.2*, 6.1*

  IBM Enterprise PL/I for z/OS V4.2, 4.3, 4.4, 4.5*, 5.1*

  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 16.05 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 16.05 requires Enterprise Common Components (ECC) Release 16.05 or more current.

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 Internet Explorer 9, 10, 11 for the supported Windows releases

ISV Software

  CA IDMS 18.0 SP0, 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 http://frontline.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 six-digit Abend-AID Fault Analytics release
(for example, Abend-AID Fault Analytics 16.03.05 and CES 16.03.05).

Distributed Systems

  Linux x64

  Windows x64

Distributed

  Google Chrome (current version)

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

  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, 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) V9.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 16.05 is the last release to support the following software:

  CA IDMS 18.0 SPO

  IBM Enterprise PL/I for z/OS V4.2

  IBM IMS Transaction and Database Servers V12.1

  IBM z/OS V1.13


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.

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


Known Issues

  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 backslash (\) 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 support 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 support 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.

HTML Format

For your convenience, Compuware also provides the Abend-AID manuals in the Hypertext Markup Language (HTML) format. View HTML files with any standard web browser. Click the icon in the HTML column on the selected FrontLine Documentation page.


Support Resources

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

Compuware FrontLine Customer Support Website

You can access online information for Compuware products via our FrontLine customer support 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 Support

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 Support
Compuware Corporation
One Campus Martius
Detroit, MI 48226-5099

Corporate Website

To access Compuware’s site on the Web, go to https://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.