Release Notes

Compuware Enterprise Services 17.02.03

January 4, 2017

Obtaining the Latest Release Notes

What’s New

CES Maintenance Support

Software and Hardware Requirements

Discontinued Support

Technical Notes

Known Issues

Product Documentation

Support Resources

Obtaining the Latest Release Notes

If you have 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 FrontLine , Compuware's customer support Web site. The first time you access FrontLine, you are required to register and obtain a password. After logging on to 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
January 4, 2017
New Update Center and Compuware Update Service

The Update Center introduces the ability to connect to an online Compuware update service for directly downloading updates for Compuware Web Products (Compuware Enterprise Services, iStrobe, ISPW Web, Topaz for Java Performance, Abend-Aid Fault Analytics, and Topaz Workbench). The Update Center replaces the previous Maintenance functionality while still allowing users to manually upload maintenance files if an internet connection from Compuware Enterprise Services is not available.

Easier Product Configurations

Compuware Enterprise Services now provides the following configuration features:

  Ability to have Host Connections automatically configured in the Compuware web products when CSMC is configured with the CES_HOST and CES_PORT defined in the CSMC parameters. This functionality requires the Enterprise Common Component January Cumulative Maintenance.

  Ability to change ports used by the Compuware web products in the web user interface.

  Ability to configure SSL in the web user interface.

  Ability to configure a proxy server to be used for connecting to Compuware for product updates and by the REST APIs.

Enhancements to Host Connections

The Host Connections page now provides the following features:

  Status of Host Connection is shown on the Host Connections page.

  Event history is now available through an ‘Event History’ link on the Host Connections page. The event history is designed to give users of Compuware Enterprise Services greater insight into which Compuware products are available on the mainframe. The event history displays both initialization and termination events.

October 1, 2016
Topaz Workbench Centralized Administration

This release brings in the ability to reduce the amount of manual administration required for managing a deployment of multiple Topaz Workbenches. Compuware Enterprise Services (CES) can now host definitions for other resources that Topaz Workbench communicates with. These include:

  HCI definitions

  Abend-AID and iStrobe servers

  Eclipse update P2 repositories for software updates.

Users can choose to either automatically receive updates from a CES server, or browse available updates and import as desired.

A Group designator has been added for HCI definitions, allowing customers to differentiate HCIs by logical business units, testing environments, etc.

Common and Simple Install

The installation for CES, iStrobe, Abend-Aid Fault Analytics, Topaz for Java Performance and ISPW Web have been combined into a single installer executable. This provides installers a single installation interface which allows them to easily choose which products they desire to install without having to manually coordinate running each installation separately.

IBM Password Phrase Authentication

To provide a higher level of authentication assurance, Compuware Enterprise Services now additionally supports the use of the IBM Password Phrase method for authenticating access to DB2 for z/OS.

License Usage History

Compuware Enterprise Services now provides the ability to log Topaz license usage history allowing you to see license requests.

Password Protected Administration

Compwuare Enterprise Services now provides the ability to restrict access to the administration page by requiring a password.

Personal Access Token Used with ISPW APIs

Compuware Enterprise Services now provides the ability to define Personal Access Tokens for completing API requests.

June 28, 2016
New Maintenance Capability

CES now includes an enhanced maintenance capability that allows users to easily install product upgrades. Through a maintenance section accessed within the CES User Interface, users can apply updates provided by Compuware to all web-based products running within CES (CES, iStrobe, Fault Analytics, Topaz for Java Performance and ISPW).

Future patches, as well as new versions of Compuware’s web-based products, will be able to leverage this new maintenance capability. The maintenance process will automatically apply the updates and restart the applications without the user having to log into the z/OS, Windows and Linux systems to directly run the upgrade installation process. The maintenance process functions identically on all the supported platforms for CES and retains all the settings and data of the products.

April 1, 2016
ISPW Web Interface

ISPW's web interface can now be installed into a CES instance. The ISPW Web interface allows users to review and approve requests to move source code changes into higher levels in the code promotion path. With a desktop browser or mobile device, managers and other team members can easily access and manage ISPW approval requests.

DB2 PassTicket Authentication

CES now supports PassTicket authentication as a security type for the DB2 database connection on z/OS UNIX.

Database Import

CES now has the ability to import data into a newly created CES database from iStrobe 5.2.0 and Fault Analytics 12.4.0.

Email Setting Enhancements

CES now has the ability to use a custom host in the URL to web reports in CES generated emails. This is useful in situations where the internal name of the server running CES is not accessible due to a site-specific network configuration. Additionally, the 'From' address in the CES Email settings can now support email addresses of up to 255 characters.

CES Maintenance Support

Compuware is committed to actively supporting its current product releases. Up-to-date product release support and retirement information is available on FrontLine’s FrontLine Support - Product Currency Tables page.

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 Compuware Enterprise Services. Other configurations might be compatible with Compuware Enterprise Services, but have not been tested.

Operating Systems

  IBM z/OS UNIX System Services with JZOS toolkit 1.13, 2.1, and 2.2

  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.


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

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

Hardware Requirements

These are the minimum requirements for CES running in a distributed environment. 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 (New Function Mode), 11.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

  Compuware Enterprise Services 17.02 is the last release to support IBM z/OS UNIX System Services with JZOS
toolkit 1.13.

  Compuware Enterprise Services 17.02 is the last release to support Microsoft SQL Server 2005, Standard and
Enterprise Editions.

Technical Notes

  The logs may indicate an error during the installation stating that either a port is already in use or the ActiveMQ broker is unable to start. These errors are a result of a timing issue and can be ignored provided that the Compuware Enterprise Server is accessible from a web browser and the online help works correctly.

  When performing an upgrade installation of CES, be sure to stop the CES server before beginning the upgrade.

  When running CES, iStrobe, Fault Analytics, and/or TJP in a Java environment that uses hardware encryption, the user ID under which CES runs will require authorization to execute the following CSFSERV functions:






  When running on z/OS, the JCL needs to be updated in order for the new patching feature to work. Refer to the chapter in the CES Installation and Configuration Guide for Installing CES on z/OS UNIX for sample JCL that has the required changes.

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.

  Patching via the Maintenance page within Compuware Enterprise Services is only available for new installations of 17.2.1. Upgrade installations will encounter the following error message:

An exception occurred loading repository. Exception: Unable to locate IArtifactRepositoryManager service.

Customers who encounter this message will need to upgrade to 17.2.2 via the installer.

Product Documentation

The installation package includes the following Compuware Enterprise Services documentation in electronic format:

  Release Notes in HTML format

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

  The Adobe PDF index file (PDX file)

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,

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

The PDX file allows you to quickly search all of the manuals in the documentation set at one time. Click the Compuware Enterprise Services PDF Index File link to launch Adobe Reader and load the file. See the Reader’s help for more information.

Note: In some environments, the link results in a blank browser page. Instead of using the link, start Adobe Reader and open the PDX file.

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.