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 FrontLine , 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.
The Topaz Workbench media is composed of Topaz Workbench, a branded Eclipse Rich Client Platform application that includes a number of z Innovation Plug-ins and 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.
Refer to the Known Issues section for important related information.
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 16.03.02 is the culmination of several Progressive releases of Eclipse-based functionality that have been released on a quarterly basis starting in July, 2015. This release is now a “Classic” release and will be supported for three years. Maintenance going forward will be limited to currency and bug fixes.
Topaz Workbench is also the upgrade path for both of Compuware’s Eclipse-based IDEs: Topaz and Workbench. Going forward, Topaz Workbench will provide a set of base features and additional chargeable features (Topaz for Program Analysis and Topaz for Enterprise Data) that can be enabled through licensing. If chargeable features are desired, then CES (Compuware Enterprise Services) is required to support them.
Topaz Workbench supports a seamless integration with SonarSource’s SonarLint COBOL plugin. Users can now get on-the-fly feedback on code quality and adherence to standards as they edit mainframe source code.
Topaz Workbench has an available command line interface (CLI) for downloading source into Jenkins from PDS libraries or the ISPW or CA-Endevor source code management systems. This allows development teams to do batched analysis of source code changes. Jenkins plugins download source for analysis by SonarQube’s COBOL plugin. This allows organizations to view, in the SonarQube dashboard, summarized code quality metrics with the ability to drill down into specific details regarding metric violations.
The Runtime Visualizer was enhanced to provide the user with File DD, IMS DBD, and DB2 Table information. This allows the Topaz Workbench user to see the I/O as the program is running and understand the types of calls that are being made. Additional enhancements to Runtime Visualizer include:
Compuware’s new Runtime Visualizer is an Eclipse plug-in you can use to view a dynamic visualization of program and I/O calls presented in the sequence in which they occur. The events shown can be replayed, exported to various formats, and imported for replay. By observing these execution events, you can quickly achieve greater understanding of your complex, mission-critical applications while increasing your confidence in modifying or extending these applications.
Note: Associated PTFs are required for Runtime Visualizer. See Software and Hardware Requirements for details.
Compuware’s Topaz for Program Analysis has been enhanced with the addition of a new, graphical Hierarchy view that can help you understand the implications of modifying programs and copybooks in an online Compuware mainframe project. The view is based on a prior analysis of the online project and can be used to view either a hierarchy of copybooks or a hierarchy of program calls. You can use the copybook hierarchy to display both an include hierarchy and an included by hierarchy. The program hierarchy can display both a calls program hierarchy or a called by program hierarchy. The table adjacent to the hierarchy provides details about the individual program calls or copybook includes in the Hierarchy view and can be used to open a selected resource and position to the line identified.
Topaz has been enhanced to include Online Projects in which you can create logical collections of source members that point to existing mainframe resources--nothing is moved, copied or duplicated. These logical collections provide easy access to your most frequently used datasets, and can be exported and imported to enable sharing with other team members.
• Progressive releases provide the latest functionality and have a permanent release number, for example 17.02.00, where the first two digits are the upcoming year and the second two digits are the quarter of initial release. Licensees who choose Progressive releases acknowledge that their cumulative maintenance, which includes defect fixes and currency updates, may also require them to accept new functionality or reinstall with possible changes to the end-user experience.
• On January 1 of each year, the prior year’s Progressive release is transitioned to become that year’s Classic release. Cumulative maintenance on Classic releases will include currency updates and bug fixes, but will not introduce new functionality.
Although Progressive releases are generally backward-compatible with Classic releases of related products, new Progressive release functionality may require a related product to also be a Progressive release.
Host Explorer’s high speed copy feature improves the existing Host-to-Host copy feature by adding compression and zIIP-enabling the copy. By off-loading processing from general processors to zIIP processors, the new copy functionality results in dramatic reduction in elapsed time and reduced impact on network bandwidth. Requires CSS PTF CXO0843, CXP0686, or CXQ0354.
Data Flow gives the programmer an unparalleled understanding, with both graphical and tabular displays, of the use of fields within their program: identifying other fields that impact this field, are impacted by this field, or are compared to this field. This provides an extra tier of information to Topaz Program Analysis.
The ability to launch and debug a batch job directly from Host Explorer has been expanded to allow the user the option of choosing an existing launch configuration for that JCL or selecting from a list of most recently used launches that match the job. Requires CSS PTF CXO0837, CXP0661, or CXQ0315.
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.
-- 9.4 (minimum required for specifying watch variables by name in a CICS debugging session)
with PTFs XD*O064 and XD*O081 (if using Runtime Visualizer, where * 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)
-- 9.4 (minimum required for multiple step batch debugging in a single Xpediter/Eclipse session or for specifying watch variables by name)
with PTF XTL0042 and PTF XTL0056 (if using Runtime Visualizer) and
PTF XTL0045 (if debugging multiple IMS transactions in a single Xpediter/Eclipse launch)
• 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.
Support for Password Phrase and Multi-Factor Authentication does not include support for interactive TSO debugging from within Topaz Workbench. This is due to TSO limitations that will not allow passwords of more than 8 characters. Refer to this IBM Knowledge Center topic for more information.
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, http://go.compuware.com .
Access the Topaz Workbench documentation on the FrontLine documentation site at 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.
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.
For your convenience, Compuware also provides the Topaz Workbench manuals in the Hypertext Markup Language (HTML) format. View HTML files with any standard web browser. Click the icon in the HTML column on the selected FrontLine Documentation page.
You can access online information for Compuware products via our FrontLine customer support website at http://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 http://go.compuware.com .
To access Compuware’s site on the Web, go to http://www.compuware.com .