Release Notes

Topaz for Java Performance 17.02

January 4, 2017

Latest Release Notes

What’s New

Software and Hardware Requirements

Technical Notes

Known Issues

Product Documentation

Support Resources

Latest Release Notes

If you accessed this document from a product or documentation media, you may not be reading the latest Release Notes . For the most recent information, go to , Compuware's customer support Web site. The first time you access FrontLine, you are required to register and obtain a password. After logging onto FrontLine, select your product from the drop-down list and click Go. On the left side of the page, click the Documentation link. You will find the latest Release Notes listed with the other product documentation.

What’s New

Topaz for Java Performance collects performance statistics for your Java Virtual Machines (JVMs) on z/OS. It provides information about performance inside of the JVMs. Topaz for Java Performance uses a sampling approach to approximate the amount of CPU that is used by different classes.

Topaz for Java Performance Release 17.02 now integrates with the 17.02 version of Compuware Enterprise Services.

Topaz for Java Performance Packaging and Installation with the Compuware Web Products

With Release 17.02, for simplified installation and improved usability, Topaz for Java Performance is now packaged and installed with the following Compuware Web products:

  Compuware Enterprise Services (CES)


  Abend-AID Fault Analytics

  ISPW Web.

Topaz for Java Performance installers must install CES and Topaz for Java Performance 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, which is available at Compuware GO/FrontLine.

Software and Hardware Requirements

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

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

Distributed Systems

  Linux x64

  Windows x64


  Google Chrome (current version)

  Microsoft Internet Explorer 9 (with Compatibility View disabled), 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 Topaz for Java Performance. Other configurations might be compatible with Topaz for Java Performance, but have not been tested.

Operating Systems

  IBM z/OS UNIX System Services with JZOS toolkit 2.1, 2.2 (Agent and Manager)

  Microsoft Windows 7, 8.1, 10, 64-bit (Manager only)

  Microsoft Windows Server 2008, 2008 R2, 2012, 2012 R2, 64-bit (Manager only)

  Red Hat Enterprise Linux 6.x, 64-bit* (Manager only)

  SUSE Linux Enterprise Server 10, 11, 64-bit* (Manager only)

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

Major Subsystems

  IBM CICS Transaction Server for z/OS 5.1 (OSGi and Liberty Profiles (codebase less than, 5.2 (OSGi Profile)

  IBM WebSphere Application Server for z/OS 7.0, 8.5, 8.5.5


  IBM 64-bit SDK for z/OS, Java Technology Edition 6.0, 6.0.1, 7 SR4 FP2, 7.1, or 8 SR1

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


Compuware products and components with current maintenance applied:

-- Enterprise Common Components 3.03, 16.05, 17.02

  Compuware Shared Services 9.0 PTF CXQ0354, 16.05, 17.02

  License Management System 4.0, 16.05, 17.02

  Host Communications Interface 3.0, 16.05, 17.02

  Base Services 16.05

  Compuware Mainframe Services Controller 16.05, 17.02

-- Compuware Enterprise Services (CES) 17.02 version matching the six-digit release of Topaz for Java Performance
(for example, Topaz for Java Performance 17.02.04 requires CES 17.02.04)

Hardware Requirements

These are the minimum requirements for a server dedicated to 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


IBM DB2 for Linux, UNIX, and Windows (LUW) V9.5, 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

Topaz for Java Performance 17.02 is the last release to support Microsoft SQL Server 2005, Standard and Enterprise Editions.

Technical Notes

  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.

  Topaz for Java Performance and Compuware Enterprise Services (CES) must be at the exact same release level -- for example, Topaz for Java Performance and CES Release 17.02.02.

  If you are performing an upgrade installation of Topaz for Java Performance, 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 Topaz for Java Performance installation, the user's specified JDK must be 64-bit.

Known Issues

  When installing CES on Windows, you 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:


The Path variable is accessed from:

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

  If you specify a temporary directory smaller than that which is required for installation, you may be presented with a message indicating that your evaluation period has expired. You can reallocate space and restart the installation process.

Product Documentation

The product installation package does not include the product documentation. The following Topaz for Java Performance documentation is available in electronic format on the product documentation site at Compuware's customer support website, .

  Release Notes in HTML format

  The product manuals in PDF format.

Access the Topaz for Java Performance product documentation as described in Latest Release Notes .

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 .

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


  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 .


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.


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

Corporate Website

To access Compuware’s site on the Web, go to .

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