Release Notes

Topaz Workbench 17.02.04

April 3, 2017

Obtaining the Latest Release Notes

What’s New in Release 17.02

Software and Hardware Requirements

Technical Notes

Known Issues

Product Documentation

Support Resources

Obtaining the Latest Release Notes

For the most current version of these Release Notes , go to FrontLine , Compuware’s customer support website. 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. 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 in Release 17.02

Topaz Workbench provides an Eclipse-based IDE to streamline mainframe application development with System z software. Its intuitive and easy-to-use interface provides the essentials of modern mainframe application development, testing, and maintenance powered by Compuware Abend-AID, File-AID, Hiperstation, Xpediter, and Strobe.

The Topaz Workbench media is composed of Topaz Workbench, a branded Eclipse Rich Client Platform application that includes the Compuware z/OS Product Plug-ins. Topaz Workbench plug-ins are also made available on the Topaz Workbench media for installation into Eclipse and IBM RDz environments.

The Topaz Workbench Release Notes include all information--such as new features, system requirements, technical notes, and known issues--for Topaz Workbench.

Release 17.02 includes the following enhancements:
April 3, 2017

Topaz Workbench has been enhanced as follows:

Topaz for Total Test

In this release, Topaz for Total Test adds:

  Support for installation into IBM Rational Developer for z Systems (RDz).

  Additional command parameters for the Topaz for Total Test Command Line Interface (CLI) to support future Code Coverage and DB2 support.

January 4, 2017

Topaz Workbench has been enhanced as follows:

Topaz for Total Test

Topaz for Total Test is a new testing product with automation to speed testing development and provide higher confidence during program deployment process.

The initial release introduces the ability to build repeatable unit tests for batch COBOL programs. Topaz for Total Test utilizes Xpediter to identify where unit test cases are wanted and collect test data for unit tests. Topaz for Total Test will take the information from an Xpediter COBOL Batch debugging session and generate the unit test case and format the data collected so it can be used by the test cases. Topaz for Total Test will provide a method to stub out parts of the program to allow it to run more isolated with fewer system requirements.

The test case execution can be automated so the unit test cases can be run as a regression test suite to verify that previously resolved issues stay fixed.

Topaz for Total Test can be executed as part of a continuous integration and build process.

Notes:

  Topaz for Total Test does not currently install into IBM Rational Developer for z Systems (RDz).

  Install the Topaz Command Line Interface (CLI) in a directory where Topaz CLI users will have read/write access.

Note: Topaz for Total Test (COBOL Batch) requires:

  Xpediter/TSO and IMS Release 17.2 with the latest maintenance applied

  Enterprise Common Components (ECC) 17.2 with the latest maintenance applied

  Topaz Workbench 17.2.3

  64-bit Java Runtime Environment (JRE) for the Topaz for Total Test Command Line Interface (CLI).

Xpediter/Eclipse Support for Channels and Containers in CICS Debug Sessions

Xpediter/Eclipse can now provide a list of active channels associated with a CICS Debug Session. Users can request a container list from any channel, then proceed to browse any available containers. While in browse mode, users can toggle between EBCDIC and ASCII (UTF-8). Find capabilities and hexadecimal view are available as well.

Note: Xpediter/Eclipse support for Channels and Containers requires Xpediter/CICS Release 17.2 with the latest maintenance applied.

IMS DBD Visualization in File-AID/Eclipse

This release brings IMS DBD Visualization to Topaz Workbench. Application Developers can visualize the structure of their physical or logical IMS databases to understand the segments, keys, logical relationships, and other fields defined within the DBD. Simply right-click on an IMS DBD from Host Explorer and select Visualize DBD or--while in a File-AID Data Editor Browse or Edit session--click the Visualization icon.

File-AID/EX in Topaz Workbench

Selected File-AID/EX functionality is now available within Topaz Workbench; File-AID/EX 16.03.07 is required for this functionality. The File-AID/EX perspective within Topaz Workbench includes the following:

  File-AID Explorer to navigate the File-AID/EX repository content and request actions for specifications

  Selection Criteria editor to create selection criteria for use with Related Extract

  Related Extract editor to create and edit Related Extract specifications. This editor allows users to do the following:

-- Select a driving table and discover relationships based on the selected relationship type.

-- View objects and relationships within the extract.

-- Adjust the extract results by excluding objects and/or relationships and setting navigation options.

-- Visualize the set of objects in the extract.

-- Specify the Data Privacy repository and project for applying Dynamic Privacy Rules.

-- Define input and output keys.

-- Set extract options.

  The ability to execute specifications and view execution logs

  The ability to execute Related Extract specifications without saving them to the repository

  The ability to edit specifications for ConverterPro, ComparePro, and Related Loader from Topaz Workbench, which launches the existing standalone File-AID/EX wizard for each feature

Note: The following information applies to the coexistence of standalone File-AID/EX and Topaz Workbench:

-- Related Extract specifications edited in Topaz Workbench default to using the new Related Extract editor. Once a Related Extract specification is saved from Topaz Workbench Related Extract editor, it can no longer be edited in standalone File-AID/EX.

-- Within the File-AID Explorer tree, the icon displayed for each specification differentiates the standalone File-AID/EX Related Extract specifications from the Topaz Workbench Related Extract specifications.

-- When a Related Extract specification created in standalone File-AID/EX is opened, it is automatically transformed to the format used by Topaz Workbench Related Extract. When the specification is saved, it is saved in the new format within the existing File-AID/EX repository structure. Warning messages requiring user confirmation prevent accidentally overwriting a specification created by standalone File-AID/EX with a new Topaz Workbench specification.

-- The ability to define embedded Data Privacy rules, apply file encryption, filter on schema, and set a limit for dependent records to fetch are not yet supported in the Topaz Workbench Related Extract editor. When an existing specification that uses an unsupported feature is opened within Topaz Workbench Related Extract a warning message is displayed and the user has a choice to open in standalone File-AID/EX or drop the unsupported features and open in Topaz Workbench.

-- There is no mass conversion of existing Related Extract specifications; specifications are transformed to the new Topaz Workbench format when they are edited from Topaz Workbench Related Extract.

ISPW Eclipse Enhancements

This release adds a number of significant capabilities:

  You can now import new source code members into ISPW from an external PDS mainframe file.

  It is now possible to multi-select Sets, Assignments, and Release containers and issue actions against them.

  You are now able to create a New Assignment or Release from the Add to Assignment dialog.

  The Generate List view has been renamed to Generate Impacts to better reflect how it’s used.

  When you create a New Task, ISPW will now automatically show the Tasks View and select that new task.

October 1, 2016

Topaz Workbench has been enhanced as follows:

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.

Topaz Workbench Cloud-Based Licensing

Another enhancement in this release further simplifies Topaz Workbench administration. While the base Topaz Workbench is available, unlicensed, to any customer with a Compuware mainframe product, Compuware has introduced chargeable options to Topaz Workbench. Currently there are two: Enterprise Data , which enables additional off-mainframe database editing and analysis functionality, and Program Analysis , which brings a wealth of visualization of both static and runtime code analysis. These options are licensed via Compuware Enterprise Services (CES). This new option allows for sites to choose Compuware as the licensing infrastructure provider, meaning that a POC for a Topaz Workbench chargeable option can be turned on in minutes without having to wait for a CES to be configured.

Password Phrase and MFA Support

This release brings password phrase and multi-factor authentication (MFA) support to Topaz Workbench. Password phrases provide an improved level of security and can be up to 100 characters long. MFA uses dynamically generated tokens to provide further enhanced security.

File-AID Compare Files

This release introduces the ability to compare mainframe files from within Topaz Workbench. Compare requests can be saved, reused, imported, and exported. Users can use copybook-driven compares if desired; this is the first formatted and unformatted data compare utility in Eclipse. Graphical reports and easy-to-read results bring the power of File-AID/MVS Compare to Topaz Workbench.

File-AID/EX in Topaz - Extract

File-AID/EX users will now have access to selected File-AID/EX functionality from within Topaz Workbench. The File-AID/EX perspective includes the File-AID Explorer view, which can be used to view and act upon the contents of existing File-AID/EX repositories. A new interface is being introduced for creating related extract specifications; this interface includes the ability to choose a driving object, discover RI and AR relationships, and apply selection criteria to objects within the extract. Additional features will be added in future releases.

The new interfaces for Related Extract and Selection Criteria are now available as editors within Eclipse. In addition, launching is available for the existing File-AID/EX wizards for Related Extract, Related Load, ConverterPRO, and ComparePRO. Execution of saved specifications is also available from File-AID Explorer.

The File-AID/EX product must be installed and licensed for this functionality to be available within Topaz Workbench.

ISPW Eclipse Enhancements

This release adds powerful “Quick Search” capabilities to two frequently-used, table-related views in ISPW Eclipse:

  Containers List View

  Task List View.

Quick Search will search all columns within the table and return all results, eliminating the need to filter down on specific columns for search functionality.

Other enhancements add the ability to:

  Do a mass add and checkout of multiple components to an Assignment

  Set problem markers on a source listing in the Problems view for Compile Diagnostics

  “Add to Assignment” or “checkout” with a right-click option from the Impacts View , so you can easily bring an impacted program into your Assignment.

Xpediter/Eclipse - Dynamic Transaction Routing Support within Multi-LPAR CICSPlex

This release adds the ability to intercept and debug a CICS workload that has been dynamically routed within a multi-LPAR CICSPlex.

July 1, 2016

Topaz Workbench has been enhanced as follows:

File-AID XREF Create and Update

This release adds the ability to create and update File-AID for MVS XREFs from within Topaz Workbench. (XREFs continue to be stored on the mainframe.)

SonarLint 2.1

Topaz Workbench support for SonarLint has been upgraded and now functions with SonarLint 2.1 exclusively. To utilize SonarLint to analyze COBOL code with mainframe projects, access to a SonarQube installation containing licensed COBOL plugins is required.

ISPW Deploy

The deployment capabilities of ISPW are now available as a stand-alone product.

ISPW Enhancements

The Eclipse interface user experience has been improved.

REXX and CLIST Execution in Topaz Workbench

A new TSO Commands Console has been added to Topaz Workbench allowing you to execute REXX EXECs and CLISTs without needing to switch to an ISPF session.

April 1, 2016

Topaz Workbench 17.02.00 is the first “Progressive” release of Topaz Workbench to debut in 2016. It will continue to receive new functionality in quarterly drops through January of 2017, at which point it will switch to the “Classic” release designation. From that point through its end of service, it will receive maintenance that consists of currency and bug fixes.

This release of Topaz Workbench introduces the following new functionality:

ISPW Eclipse Plugins

Compuware’s recently-acquired ISPW Agile Source Code Management (SCM) system features an alternative Eclipse-based interface for those who prefer working with a GUI instead of the standard 3270 interface. When used in conjunction with Topaz Workbench, developers also have access to Compuware’s full suite of licensed developer tools. See the ISPW Release Notes for more information.

Topaz for Enterprise Data
Data Visualizer Enhancements

Compuware is introducing powerful new extract visualization capabilities to the existing Data Visualizer. Developers, data architects, analysts, and other IT professionals can visually manage their File-AID/RDX extracts, making it easy to understand how the extract ran, determine how to better tune the extract, and realize why a given test data extract may not be fulfilling test/QA requirements for completeness or sample size.

File-AID Data Editor Enhancements

Several new enhancements have been added to the File-AID Data Editor, including:

  Adding a Search dialog for MVS fields and conditions within selection criteria.

  Adding XML and CSV export capabilities from an edit session.

  Enabling an MVS Editor Request to be reassigned to another dataset name.

  Enhanced column selection when editing SQL for DB2 objects.

  Command improvements to COPY/PASTE/ADD/REPEAT/DELETE.

Program Analysis PL/I Improvements

Compuware’s Topaz for Program Analysis has extended its support for PL/I preprocessor statements. This added support improves the analysis provided for complex PL/I programs.


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

The Software and Hardware Requirements section of the Release Notes has been standardized across all Compuware Mainframe products and their Distributed components. Please note that any versions of third-party software that are no longer supported by their vendors under standard published contracts have been removed from the Software and Hardware Requirements section and placed in the Discontinued Support section of the release notes. However, any third-party software that was supported when this Compuware product went GA will continue to be supported until this product release has reached its End of Support date. No functionality has been removed from the product.

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 .

Hardware Platforms

  Distributed Systems:

-- Microsoft Windows x86, x64. 2 GHz minimum

-- Hard Disk: 700 MB minimum

-- Memory: 2 GB minimum

Operating Systems

  Microsoft Windows 7, 8.1 Update (KB 2919355), 10

Languages

  Oracle Java SE 8

For more information, see Configuring Eclipse Memory Settings below.

Corequisites

  Abend-AID (if using the Abend-AID web interface):

-- 12.04 (minimum required for Fix Request functionality), with PTFs AAD258Y, AAD263Y, and AAD264Y (if using Runtime Visualizer)

-- 16.05

-- 17.02

  Abend-AID Common (if using the Abend-AID web interface):

-- 12.04 with PTF ACD264Y (if using Runtime Visualizer)

-- 16.05

-- 17.02

  Abend-AID for CICS (if using the Abend-AID web interface):

-- 12.04 with PTF CFD267* (if using Runtime Visualizer, where * is CICS TS: J=common, K=4.2, L=5.1, M=5.2, X=3.1, Y=3.2, Z=4.1)

-- 16.05

-- 17.02

  Compuware Enterprise Services (if using the Enterprise Data or Program Analysis features)

-- 5.0.2, 5.0.3, 5.0.4, 5.0.5, 5.0.6

-- 16.03

-- 17.02

-- 17.02.02 (if using Centralized Administration)

  Compuware Shared Services:

-- 9.0 with PTFs CXQ0315, CXQ0320, CXQ0354, plus CXQ0396 (if using Runtime Visualizer); Note: CSS 9.0 is not fully compatible with 17.02 releases.

-- 16.05 with PTFs CXR103A (if using REXX/CLIST support), CXR110A (if using Password Phrase/MFA)

-- 17.02

  Fault Analytics (if using the Fault Analytics web interface):

-- 12.04

-- 16.03

-- 17.02

  File-AID Common Components (if using File-AID/Eclipse):

-- 10.02 with VJA2045 (if using Copy with Selection Criteria)

-- 16.03 with PTF VJ16096 (if using Password Phrase/MFA with File-AID/EX Executive)

-- 17.02 with PTF PA00413, PA00419 for Japanese (if using the XREF Utility), PA00565, PA00569 Japanese, and PA00608 (if using File-AID Compare)

  File-AID/RDX (if using Topaz Workbench and Data Visualizer):

-- 10.02 with PTF FRA2040 (if using Data Visualizer Extract Visualization)

-- 16.03

-- 17.02

  File-AID/EX (if using Topaz Workbench and Data Visualizer):

-- 5.03 with July 2014 SP

-- 5.03.01

-- 5.03.02

-- 16.03

-- 16.03.07 (if using File-AID/EX Perspective)

  File-AID for DB2 (if using File-AID/Eclipse):

-- 10.02

-- 16.03

-- 17.02

  File-AID for IMS (if using File-AID/Eclipse):

-- 10.02

-- 16.03 (if using IMS Starting Key)

-- 17.02

  File-AID/MVS (if using File-AID/Eclipse):

-- 10.02

-- 16.03

-- 17.02 with PTF PA00416 (if using the XREF Utility), PA00568 (if using File-AID Compare)

  Hiperstation for Mainframe Servers (if using Hiperstation/Eclipse):

-- 8.0 with fix QQ60540

-- 16.05

-- 17.02

  Hiperstation for VTAM (if using Hiperstation/Eclipse):

-- 8.0 with fix QQ60540

-- 16.05

-- 17.02

  Hiperstation for WebSphere MQ (if using Hiperstation/Eclipse):

-- 8.0 with fix QQ60540

-- 16.05

-- 17.02

  Host Communication Interface:

-- 3.0 with current PTFs (minimum required for VIPA networks)

-- 16.05

-- 17.02

  ISPW:

-- 17.02

  iStrobe (if using the iStrobe interface):

-- 5.02 (minimum required for Fix Request functionality)

-- 16.03

-- 17.02

  Xpediter/CICS (if using Xpediter/Eclipse):

-- 9.03

-- 9.04 with PTFs XD*O064 and XD*O081 (if using Runtime Visualizer)

-- 16.05 with PTF XD*P030 (if using Password Phrase/MFA)

-- 17.02 (if using multi-LPAR CICSPlex support or Password Phrase/MFA)

Note: For PTF naming, * is CICS TS: M=3.1, N=3.2, O=4.1, P=4.2, Q=5.1, R=5.2, and S=5.3.

  Xpediter/Code Coverage (if using Code Coverage/Eclipse):

-- 3.01 with PTFs up to and including XVC0065

  Xpediter/TSO and IMS (if using Xpediter/Eclipse):

-- 9.03

-- 9.04 with PTF XTL0042 and PTF XTL0056 (if using Runtime Visualizer) and
PTF XTL0045 (if debugging multiple IMS transactions in a single Xpediter/Eclipse launch)

-- 16.05

-- 17.02

  File-AID/Data Privacy: Refer to the File-AID/Data Privacy Release Notes .

Distributed

  Browsers and IDEs:

-- Eclipse 4.4.2, 4.5

-- IBM Rational Developer for System z V9.5

-- IBM Rational Developer for the Enterprise V9.5

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

  Microsoft Visio 2010 with Service Pack 2 and Compatibility Pack, 2013 (if exporting from Data Visualizer)

  SonarLint 2.5, access to a SonarQube installation that contains the COBOL plugins, and a valid license for the COBOL plugins (if using SonarLint to analyze COBOL code with mainframe projects)

Note:

  These are the minimum requirements for Topaz Workbench companion products. Visit FrontLine and select the Topaz Workbench product page then select Fixes/Downloads for the latest detailed companion product requirements.

  The FrontLine Topaz Workbench Technical Reference page includes a Distributed Data Types Support Matrix document listing the data types supported by the Topaz Workbench File-AID Data Editor.

  Compuware recommends that all current maintenance be applied to the companion products. In order to use new functionality, the specified PTFs must be applied, otherwise companion products will operate in toleration mode and new features will be disabled.

  File-AID for DB2, File-AID/MVS, File-AID for IMS, and File-AID Common Components make use of APF authorized libraries to be used during the configuration of the Host Communications Interface. The Authorized libraries MUST have universal read access.

  File-AID for DB2, File-AID Common Components, File-AID for IMS and File-AID/MVS are distributed on the File-AID/EP media or via RFN order.

  HCI and CSS are distributed on the Enterprise Common Components (ECC) media.


Technical Notes

Topaz for Total Test

A 64-bit Java Runtime Environment (JRE) is required for the Topaz for Total Test Command Line Interface (CLI).

File-AID/Eclipse

Supported DB2 and IMS Releases

  DB2:

-- V10 CM, NFM

-- V11 CM, NFM

-- V12 (Refer to File-AID for DB2 for further support details)

  IMS:

-- IMSV12.1

-- IMSV13.1

-- IMSV14.1 (Refer to File-AID for IMS for further support details)

Supported Distributed RDBMS Platforms

  Oracle Database 11g, 12c

  DB2 for LUW V9.5, V9.7, V10.1, V10.5

  Sybase 15

  MS SQL Server 2005, 2008, 2012

ISPW Installation in Eclipse or RDz Environments

For the ISPW plug-in to be fully functional in an Eclipse or IBM RDz environment, be sure to select Host Explorer and SlickEdit (optional, for copybook support) for installation along with ISPW.

Running Topaz Workbench in 32-bit mode on a 64-bit OS

If you wish to run a new installation of Topaz Workbench as 32-bit in a 64-bit environment, run the Install32on64.bat file, which launches an installer containing an option to install as 32-bit on 64-bit. The batch file is located in the same folder on the Media Browser disk image as the setup.exe file.

VIPA Networks

A minimum of HCI 3.0 is required for VIPA networks.

Host Explorer and SlickEdit Licensing

Use of Host Explorer and SlickEdit will require a valid Compuware Mainframe License (any product) on any LPAR serving Host Explorer connections. The HCI hosting these communications must have access to Compuware’s License Manager. If there is any licensed Compuware mainframe product running on an LPAR where HCI is executing, no further effort is necessary.

Xpediter/Eclipse

Compuware Shared Services Enhanced Listings

Xpediter/Eclipse does not support Compuware Shared Services (CSS) enhanced listings. For information on enhanced listings, refer to the Compuware Shared Services documentation.

Xpediter/Eclipse requires a direct connection to an LPAR with a working version of Xpediter/CICS, Xpediter/TSO, and/or Xpediter/IMS on any LPAR where Xpediter debugging sessions are to execute.

Audit Preference

By default, the Enable auditing preference is turned on, and an audit file is created on the mainframe. Be aware that when auditing is enabled, the FORCE option on the Concurrent Update view does not work because it would negate the audit.

Hiperstation/Eclipse

  Security for the Hiperstation for WebSphere MQ product is now checked not only when the product is started, but also whenever a Restart command for a global recording request is issued. If security has changed for the request owner or rules have been changed, requests that ran before may no longer run.

  Only single-byte characters are supported on code page 939.

Configuring Eclipse Memory Settings

Java OutOfMemory errors may occur when editing a large file or displaying a large JES report. These errors can often be avoided by increasing the maximum size of the JVM memory heap. The Compuware Workbench and Topaz initialization files (workbench.ini and topaz.ini) include an Xmx parameter (default 512m) used to specify the maximum heap size. The optimum value for this parameter varies depending on the OS used, memory fragmentation, and other factors.

On 32-bit Windows, the theoretical heap size is limited to 2GB due to how Windows allocates memory, but this is reduced by many factors. Generally, the stated maximum is 1536m, while a commonly stated max range is 1200m to 1500m. The optimal setting for a particular installation--with no OutOfMemory errors or noticeable garbage collection pauses--can only be determined by experimenting with different values. Compuware recommends increasing the Xmx value to 1200m as a starting point and increasing or decreasing the value in small increments, such as 512m, until an optimum value is found. However, even with a setting of 1536m, large JES output can easily exceed that value. The only practical solution in such situations is to install the products on a 64-bit OS.

On 64-bit Windows operating systems, heap size is limited by your Windows virtual memory specification, minus a small amount of memory used by the OS and other processes. Specifying 4GB or more for the Xmx parameter can be practical depending on the Windows virtual memory size.


Known Issues

Related Loader Requires Extract Data File

Related Loader does not support the repository extract option for Related Extract specifications created in Topaz Workbench. Therefore, a Related Loader specification created in standalone File-AID/EX that uses a Related Extract specification created in Topaz Workbench must use an extract data file.

Viewing Exported Portable Network Graphics (PNG) Files

When exporting an image from Program Analysis or Visualizer, if the View document after export checkbox is selected, *.png is selected from the Save as type dropdown list, and the default application associated with .png files is Microsoft Paint, the exported image cannot be opened automatically. Browse to the export location and open the file manually.

Overlaid Error and Warning Marks in Overview Ruler

When using Program Analysis, markers for Information items can potentially overlay and obscure Error and Warning markers in the SlickEdit Overview Ruler. The suggested workaround is to deselect the Overview Ruler for Information items, leaving Errors and Warnings displayed without being overlaid.

Potential for Missing Menus and Toolbars

The topaz.ini file sets the osgi.instance.area.default to the @user.home location, which is typically mapped to a local drive or absolute path. If the user has their @user.home set to a UNC network path, the toolbars and menus within Topaz Workbench may not appear. To correct the problem, edit the topaz.ini file (default location is Topaz Workbench installation’s eclipse directory), replacing the @user.home location with a local drive or absolute path. If Topaz Workbench has been installed via p2repo into an Eclipse instance, the edit should be done to the eclipse.ini file instead.

Compuware Editor and Xpediter Editor

An error may occur if a pre-5.0 Topaz or Workbench Assembler, C, COBOL, JCL, or PL/I Compuware or Xpediter editor remains open in a workspace while a migration to a current release of Topaz Workbench is occurring. When Topaz Workbench is opened an error will indicate that the editor type is not supported. To resolve this issue, close the editor and reopen the file.

Internet Explorer 11 Security Update for Windows 7 and 8.1 Causes Topaz Workbench Failure After Closing the Welcome Page

Microsoft Internet Explorer cumulative security update KB2977629 can cause failure of Eclipse-based products when closing the Welcome page. To resolve this issue, install Microsoft Internet Explorer cumulative security update KB2987107 or uninstall KB2977629.

File-AID Data Editor

Potential Loss of Precision

The potential exists for loss of precision on FLOAT and DOUBLE data types between the mainframe and the File-AID Data Editor user interface. See “Chapter 9. Floating-Point Overview and Support Instructions” in IBM's z/Architecture Principles of Operation (SA22-7832-09) for more information.

Formatting of COMP and COMP-4 COBOL Fields

Picture clauses for COMP and COMP-4 (binary data) field types are not used when displaying the decimal numeric value of these fields. Any implied decimals (V) or implied scaling (P) in the Picture are ignored and not used to display the numeric value of the field. The value displayed is a positive or negative integer.

Unformatted Mode Ruler and Data Alignment

The ruler at the top of unformatted mode is intended to line up with the data below it, but this may not always happen. Although the same fixed-width font is used for both the ruler and the data, certain characters on code pages 930 and 939 are narrower than others, causing the ruler and the data to fail to line up when those characters appear in the data.

The recommended solution is to substitute the narrow characters with red “periods” as currently done for binary data that cannot be translated to characters. Any modifications to those letters and punctuation must be done in the 3-line Hex display option.

Locked Oracle Table Postpones Timeout Error

When saving data to a locked Oracle table, the timeout error does not return after the set timeout period. It does return after the lock has been released.


Product Documentation

The product installation package does not include the product documentation. The following Topaz Workbench 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 Topaz Workbench documentation on the FrontLine documentation site at https://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 ( https://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 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 http://www.compuware.com .

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

Doc. APR2017