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.
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 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.
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.
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.
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:
-- 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.
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:
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.
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.
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 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.
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.
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.
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.
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.
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.
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 .
For more information, see Configuring Eclipse Memory Settings below.
• 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.
• 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.
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.
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.
• 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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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 .
Access the Topaz Workbench documentation on the FrontLine documentation site at https://go.compuware.com .
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 .
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.
1. Go to FrontLine ( https://go.compuware.com ) and navigate to the Documentation page for the desired product.
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.
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.
• All other countries: Contact your local Compuware office. Contact information is available at https://go.compuware.com .
To access Compuware’s site on the Web, go to http://www.compuware.com .