Release notes: Version 20.09.01 of BMC Compuware Topaz Workbench

Codeline path as default column in ISPW views

The Codeline path is now a default column for the Assignment, Release, and Set views. This helps indicate when a component is in an isolated codeline.

Component Versions dialog box to perform the Checkout action

When you perform the Add to Assignment action from the Add Task dialog box, the Check out from level field has been removed. Instead, when performing the Checkout action, the user interface displays the Component Versions dialog box if multiple active versions exist in the ISPW life cycle where the inactive or active version can be selected.

Enhanced table entries in the Component Versions dialog box

The table in the Component Versions dialog box allows a selection instead of using checkboxes for table entries.

ISPW warehouse files transferred as binary

Any files stored in the ISPW warehouse is now transferred to Topaz Workbench as binary if the file is defined as a binary content type in ISPW.

Console view as a default view in the ISPW perspective

The Console view is now available as a default view in the ISPW perspective. This ensures that you receive all important messages and can resolve issues, if any.

Ability to browse a remote deploy log

You can now browse an RX (deploy) log when you connect to HCI on the "remote" LPAR.

Column chooser added to Containers View and Tasks View

The Containers View and Tasks View provide the ability to choose which columns to display in the view.

Additional information in views

The Tasks View Properties, Deployment View Request and Package Details, and Set View now display additional information when you point the mouse over Owner/User ID.

Enhancements in the Add Task dialog box

For the Add Task action, if you type a component that does not exist within the repository, the user interface displays an alert. This prevents a typo in the component name from being accidently added as a new component.

The Add Task dialog box that displays for the Add to Assignment with Check Out action now shows the Base Component Version table instead of the Check out from level field to provide more information about the base version.

Ability to add a component to an existing unlocked set

You can now add a component to an existing unlocked set for processing ISPW actions such as Regress, Fallback, Promote, and Deploy. For more information, see:

• https://docs.bmc.com/docs/display/bctwb2009/Deploy
• https://docs.bmc.com/docs/display/bctwb2009/Promote
• https://docs.bmc.com/docs/display/bctwb2009/Regress
• https://docs.bmc.com/docs/display/bctwb2009/Fallback

Parts view translated to UTF-8 

Any ISPW parts such as LOADLIB or OBJECT is now translated to UTF-8 in the Parts view. This allows text to display as readable characters.

New look for Data Editor

The layout of the Data Editor is changed to display three sections:

• Table mode editor
• Row mode editor
• Metadata viewer

The new layout makes switching between modes and scrolling within each view easier.

The Metadata Viewer displays the layout of the currently selected record. Functionality will be added to Metadata Viewer in future releases.

Improved editing for ODOs

Table mode display is now available when editing a data set which contains a COBOL Occurs Depending ON (ODO) or PL/I REFER

• Multiple ODOs and data beyond ODOs are displayed
• A new preference is added to limit the number of occurrences displayed in table mode
• All occurrences will always be displayed in row mode

Reuse MVS Edit request 

Saved MVS Edit requests can now be opened and reused even when the original data set no longer exists.

Export data headings

When data is exported from within the Edit session, you can now choose to have full heading, only column names or no heading.

Configure FAS for Execution Servers

When Data Privacy is to be applied, each Execution Server must know the location of the File-AID Services (FAS) component. You can now configure the FAS location for each defined Execution Server from the Tools Menu within the File-AID/EX perspective. 

Function to convert value to hex

The TO_HEX_STR function is added to the Data Privacy Expression Builder. This function is used when defining Rule Logic to convert text into a hexadecimal string value. 

Nested Pointer Support

Topaz for Total Test now supports nested pointer structures. The pointers will stub out so that you can see the data inside the field. You can target up to 25 pointer levels deep.

Continued PL/I support

Added support for Bit String PL/I data type.

ISPW/Eclipse

ISPW Distributed Deploy is no longer supported.

SonarLint Analyze Changed Files option is not functional for ISPW controlled files.

For tasks generated from a Sandbox Codeline, the Parts view shows incorrect data set names, and the Promote, Regress, and Deploy actions are not yet supported.

Topaz Enterprise Data

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

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.

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.

Topaz Workbench

After installing multiple Topaz components into an Eclipse-based IDE, you are asked to restart. During that restart, however, the Eclipse IDE sometimes fails to rewire the bundle dependencies. Symptoms can include UI components that do not function properly and views that do not display. To correct this, manually close the Eclipse IDE, then start it back up again with the -clean option. This might be necessary to do only once.

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 might not be displayed.

To correct the problem, edit the topaz.ini file (default location is the Topaz Workbench installation’s eclipse directory), replacing the @user.home location with a local drive or absolute path. If Topaz Workbench is installed via p2repo into an Eclipse instance, you must edit the eclipse.ini file instead.

Navigating Topaz COBOL Editor search results do not place the cursor at the exact position of the match in the Editor if the match exists within a non-editable region. This pertains to the Sequence Number or Identity areas within the Editor where either have been set via preferences to be non-editable. The cursor in this case is placed at the beginning of the statement or in the general vicinity of the match in the editable region.

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

Under Open JDK, when the Team Profile Import process finds an invalid profile, it fails to display the full error message.

When analyzing a project, for example after adding a large copybook concatenation PDS, Program Analysis can take a long time or hang Topaz Workbench.

When installing Topaz Workbench plug-ins into IBM Aqua, the following issues might occur:

• Deleting a PDS member in Host Explorer and then trying to open the same member from the Project Explorer might cause Aqua to hang.
• Creating a new folder in a Compuware Online Project and then creating a new file in that folder causes Aqua to hang.
• The shortcut keys for Toggle Comment (Ctrl+/) do not work in the JCL editor.

If you open a file in Host Explorer, perform Search Text > File within it, close the Editor, and then click on the search results, the selected file fails to open. This happens because when the Editor is closed, the file is no longer present in the Topaz Workbench local directory. Reopening the file through Host Explorer re-syncs the search results with the file. The issue affects all Topaz Editors.

Cut (Ctrl+x) is not supported in the Topaz 3270 Emulator.

Topaz Workbench

Cobol and PL/I Outline view will now fully collapse when using the Collapse buttons.

PL/I parser error: missing semicolon at '('. Made changes in grammar of the parser to handle multiple argument lists in a call statement.

NumberFormatException with the PL/I parser. Fixed preprocessor handling of macro calls that have embedded semicolons as a parameter to the macro.

PL/I parser error: Duplicate data transmission option. Adjusted comparison of strings of unequal lengths so that the shorter string is padded on the right to give proper results of comparison.
Changed the parsing priority so concat operation is done after plus operation to give proper results of parsing.

Editing a PL/I program will sometimes prompt twice asking the user if they want to download copybooks.

PL/I parser error processing DO block with %END statement.

INCLUDE copybooks not being downloaded in Project Explorer. In a EXEC SQL INCLUDE .... statement, blank lines and comments are allowed between "EXEC SQL" and "INCLUDE".

Fixed source failing to open in the PL/I editor with error "Failed to create the part's controls" during processing of %DO SKIP ...%END statements.

Opening a PL/I Program for edit from ISPW failed to complete the parse. Therefore the Simple Outline View was displayed in the editor. In the log there is a rule conflict exception.

All items inside a DECLARE (A,B,C,...) BUILTIN; statement will now be correctly color-highlighted as variables.

PL/I parser error: invalid statement '%;'. PL/I preprocessor grammar changed to accommodate non-operational statements in program.

PL/I Parser grammar changes to support alignment attributes in DEFINE alias statement.

Unable to locate the include for a PL/I program after opening the file in the editor. This was due to the file location of the ISPW project being empty. Hence the file in was not getting parsed completely. 

PL/I parser error "java.lang.NullPointer' at AssignmentStatement. The COPY Inbuilt function was not implemented in Pthe preprocessor. 

PL/I parser grammar change to support procedure inside a When statement.

PL/I parser error: "extraneous input.." when variable name is continued on a second line.

PL/I parser - added support for qualified variable names in call statements and on conditions.

PL/I parser displays more of the parser error message when it contains the word "expecting".

Cobol Outline view: User selects a procedure in the Outline view and then collapses the outline view. When moving the cursor to a different procedure, the Outline view will expand and the correct procedure will be highlighted.

Cobol Parser error near top of program flags Identification Division as an invalid statement. Identification Division section was parsed and added twice in resulted document while doing incremental parsing.

EIB support updated to add CICS DFHEIBLK and other variables that were missing for the Cobol editor.

Cobol parser now supports numeric edit format PIC strings with blanks and floating minus signs.

Cobol editor: all procedure names starting in column 8 through 11 will be displayed in the Outline view, not only the ones starting in column 8.

When sequence area tagging is enabled and a user clicks "Enter" on an empty source line in a Cobol program, only the newly created line will be tagged, not both lines.

Cobol Editor will now correctly indent the source.

COBOL Outline view will now correctly show FILLER variables.

When a user collapses nodes in the Outline view for the Cobol editor, those nodes will stay collapsed if user starts to edit. When adding a new line inside a node, the correct node will be highlighted in the Outline view. In case of source code being collapsed, correct node will be highlighted in Outline view.

The Cobol Editor now acts as expected when typing the backspace or delete key, even when the sequence/identity areas are locked.

Cobol editor: when auto-tagging is on and user deletes a line, the SEQUENCE area tags and ID area tags will be properly deleted too.

Cobol editor: code folding will produce correct results in case of INCLUDE statements covering multiple lines.

Cobol editor: variables declared under SPECIAL-NAMES are now recognized and not flagged as undefined.

Cobol editor: if Sequence Number Area and/or Identity Area are non-editable, the user will not have the option to "Revert Line" after an edit, since this was corrupting the source.

JCL Editor: all trailing blank lines will be removed when saving the JCL source.

When saving a JCL source which has blank lines at the end of the source, editor will strip off the blank lines.

REXX keywords and variables not colored correctly. Keywords were detected at the beginning of the line only if line continuation there. Parser now able to evaluate the keywords anywhere in the line and detect line continuations properly.

ESS and DDIO members will now open with the Text Editor. 

User should now be able to save files in Project Explorer even when file is being compared.

Copy/Paste will now work when automatically switching editor from browse to edit mode from projects.

When multiple Windows files are selected, the Paste option was removed from the right-click menu on a data set member or VSAM file. This is to prevent multiple files being concatenated into one data set. 

Save of a local PL/I file throws NPE. Open doesn't parse, error displays in the log file. 

Hostservices: NLS missing messages in log slowing down startup.

Groovy compiler messages appearing in the log during startup of Topaz may be slowing down startup itself. 

When user selects "Save As" for a source file with unmatched ShiftIn/ShiftOut pairs, user will be properly prompted if they want to save or cancel.

Removed org.apache.commons.commons-codec bundle that was causing IBM IDz to hang at startup after the Topaz Enterprise Data feature was installed.

CES https connections can be done using the Windows keystore, if the IBMCAC security provider is added and and Windows-MY/Windows-ROOT defined.

Drop-down list for host nodes will now be in alphabetical/numeric order. 

Saving an empty file to USS would hang after waiting for a timeout. Now it works correctly.

Fixed error log messages that occurred after deleting a USS resource in the Host Explorer view.

In the Copy to dialog, once the datasets with the same name in the source and target are removed, the error will no longer be shown. 

Correct an issue where a copy executed from the Event History view does not complete. A null pointer exception is written to the Eclipse log.

Component: Program Analysis

Line numbers in the structure chart are incorrect when using the PL/I preprocessor. Fixed synchronization in Program Analysis views when the PL/I preprocessor compile option is enabled.

Handle absolute path of the main program when opened in Program Analyzer. Error received: Attempted to beginRule: R/ does not match outer scope rule.

Program Analyzer: Fixed synchronization from Structure Chart to editor when the PL/I preprocess compiler option is enabled.

Program Analyzer: Incorrect node for package program. Only one node is displayed for the PL/I source.

Component: Xpediter/Eclipse

NullPointerException occurs in the log during Xpediter debugging when Monitor All Cobol Programs is selected then the session is terminated and started up again. 

Xpediter/Eclipse feature Hovering over a variable doesn't work for subprograms. Code was modified to set the source viewer for Xpediter globally. 

Component: Code Coverage/Eclipse

Fixed source mismatch in Code Coverage for Topaz Worbench CLI. Error occurred when multiple Code Coverage data is received for source lines that contain multiple verbs.

Component: Topaz Connect

Modified some text fields so that they will not disappear when resizing the Create Package Options dialog in Topaz Connect.

Topaz Enterprise Data

Fixed installation of Topaz Enterprise Data components into Eclipse

Deleting a large number of rows no longer takes too long

Improved performance when deleting a large number of records by eliminating unnecessary UI operations that were triggered during processing

Fixed an issue that corrupted a File-AID/EX expression, when a variable with a name matching a defined function name is used with the matching name function. Users can now create and use variables with names that match the function names in the same expression

Fixed an issue that prevented a related loader from pointing at an extract output containing special characters

Corrected support for LOBs in Db2 z/OS in ConverterPro and ComparePro

Added setting to prevent error: Maximum number of child elements exceeded limit (50000) when opening a Data Privacy project.

Added support for secured port in making rest call to FAS for license preferences fetch.

ISPW Eclipse

The Copy all non-conflicting changes functions are incorrectly enabled in the Compare editor when requesting Compare with each other from the Component Versions view and Set view.

A Superseded Gone task is now included as an inactive version in the Component Versions view.

Topaz for Total Test

Prevent conversion of online projects to Total Test projects.

Replaced the OK button with RUN and provided Apply button for Context UI dialog box.

Changed tooltip positioning on hover over drag and drop palette elements.

When making a call with a pointer as input that returns another pointer as output and each points to a unique structure. Topaz for Total Test seems to be displaying the output structure for the input pointer.

Support code coverage collection through IDz15.

Allow copy/paste of a Stub.

Allow editing of Bytes field for all data types 

Changed the way the selection is focused for Stubs in Test Scenario Editor.

Save environment login details for FTP connections.

Corrected program name used when collecting code coverage with the Job Submit element.

0 length arrays and NULL values for array elements are now handled properly and do not log NullPointerException messages in the compuware.log.

Fix to prevent debug information from being lost.

Additional message to indicate no matching host connection for the environment.

Some programs were not being recognized as the main program when all breakpoints loaded during debug.

Engine Version updated.

Fixes problem when record sub-programs returning the incorrect RETURN-CODE.

Removing values from field using either backspace or delete key will set numeric fields to NULL, and character fields to SPACES.

Fixed an issue with sql data records that were more than 4096 bytes long.

Revise settings to use timeout attribute from the context file.

Fixed an error popup when no CICS loadlib found during capture.

Collect diagnostic information for test cases that do not have stubs.

PL/I execution may result in error; output data doesn't conform to metadata specification.

Fixed null pointer exception when editing return code assertions on programs with no linkage section.

Updated code to check for X.509 certificate when connecting to HCI for the VerifyDataset and CompareDataset palette item.

Address issue with playback not filtering duplicate pointers.

Fixed an issue of collecting data for nested pointer.

Properly handle certificates on the repository server.

Fixes stub generation of a RAISE IPC program when recording in Background or Debug Mode

Fixed an issue with target pointer data not being captured correctly.

Support cloud licensing when switching from the repository to local configuration 

Fixed an issue where pointer information is not being sent when the number of arguments on a CALL are varying. 

Check for missing host connections when not using the repository.

Addressed bug in calculation of alignment for substructures with a single field.

Fixed a problem when two different pointers, point to different instances of the same named structure. The captured pointer data is the same for both structures.