Release Notes

Topaz for Java Performance 16.03

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.

January 1, 2016
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.

Introducing Topaz for Java Performance

Compuware’s new Topaz for Java Performance product delivers exceptional visibility into the performance of Java -- both Batch and WebSphere -- running on the mainframe, including:

  Peak CPU utilization of specific Java processes and classes

  Issues such as memory leaks and long Java garbage collection intervals

  Threads that are blocked or not doing useful work.

Topaz for Java Performance is designed to run on IBM’s zIIP and zAAP Specialty Processors to minimize the cost of performance sampling.

Managing Topaz for Java Performance Java Agents

The Topaz for Java Performance Measurement Page provides a centralized location to manage Topaz for Java Performance Agents. Users can start immediate measurements or schedule recurring measurements. Users can compare these scheduled measurements using the Trend Reports across different time intervals or different JVMs. Topaz for Java Performance Agents may be installed in many LPARs, yet all measurement requests can be controlled from the Measurement Page.

Measuring Performance

Topaz for Java Performance allows users to view, submit, and manage measurements and shows the following:

  Measurements that have been performed

  Java applications that have a Topaz for Java Performance agent configured

  Active measurements

Three types of measurement requests can be submitted:

  An immediate measurement request

  A startup measurement request, which will run when the selected agent starts up

  A scheduled measurement request, which will run at the specified date, time, and recurrence

Viewing Performance Results

Topaz for Java Performance contains charts about CPU usage, heap, classes, and threads, as well as detailed tables about Java Virtual Machine (JVM) arguments and system properties.

Viewing Trend Information

Topaz for Java Performance allows users to view and manage trend reports to understand the Java program performance over a series of measurement time frames. The reports summarize Topaz for Java Performance measurements to help identify trends based on data gathered from measurements.

Maintaining Historical Data

Topaz for Java Performance maintains historical Measurement data so you can compare before and after measurements to ensure your performance tuning efforts are successful. Each Topaz for Java Performance measurement captures the Java Virtual Machine (JVM) settings. These settings can dramatically affect the performance of the JVM and this information provides context to make changes to these JVM settings. Once settings are changed it is to re-measure and compare results.

Integration with Strobe and iStrobe

Strobe and iStrobe Release 16.03 provide integration with Topaz for Java Performance, allowing users to follow their performance measurement into the Java Virtual Machine (JVM). Strobe and iStrobe provide a broader view of the z/OS system and how it impacts the performance of JVM, whereas Topaz for Java Performance provides a view of the performance behavior inside of the JVM. Strobe measurements of z/OS Java applications cause a command to be issued to Topaz for Java Performance for collection of the Java performance data. Analysis of the application with iStrobe allows the user to easily move between Topaz for Java Peformance measurements and the iStrobe profiles. No site configuration or customization is required for this integration.

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

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

  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 1.13, 2.1, 2.2 (Agent and Manager)

  Microsoft Windows 7, 8.1, 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


  Enterprise Common Components with all current maintenance applied:

-- Compuware Shared Services 9.0 PTF CXQ0354, 16.05 PTF CXR110A

-- License Management System 4.0, 16.05

-- Host Communications Interface 3.0, 16.05

-- Base Services 16.05

-- Compuware Mainframe Services Controller 16.05

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

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 16.03 is the last release to support IBM z/OS UNIX System Services with JZOS toolkit 1.13.

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 installed at the exact same release level -- for example, Topaz for Java Performance and CES Release 16.03.05.

  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, which may include a PDX index file and associated folder.

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.