Release notes: Version 20.07.01 of BMC Compuware Topaz Workbench

Support for GitHub Enterprise Actions

With support added for GitHub Enterprise Actions, you can now perform the following actions:

• Build and extend your DevOps toolchain to provide access to more tools and modernize the App Dev process.
• Edit your ISPW source in GitHub. When ready for mainframe compile and testing, you can invoke the actions via a Push request to load the components to ISPW on the mainframe, and then compile (generate or build) to enable your testing.
• Use the generate, build, deploy, and sync actions.

For more information, see:

• https://github.com/marketplace/actions/ispw-sync

• https://github.com/marketplace/actions/ispw-sync-local
• https://github.com/marketplace/actions/ispw-generate
• https://github.com/marketplace/actions/ispw-build
• https://github.com/marketplace/actions/ispw-deploy

Sandboxes in ISPW

We are introducing Sandbox Assignments in ISPW, which are isolated areas for developers on which to perform their generate, build, and test actions at the Test level. Sandboxes are stand-alone environments that are independent from other changes at the same level. For example, a generate action references only copybooks from your sandbox or above the Test level of the life cycle leg where the assignment for the sandbox is located.

As a developer using Git, you can now use the sandbox to build and test the changes. You can import your code from Git into ISPW directly to a Sandbox Assignment.

Enhanced Git integration

• Topaz Git projects configured for ISPW can now automatically look up copybooks that are referenced by the source code being edited within other ISPW projects. While most copybooks can be found within the current project, applications frequently use common copybooks across multiple applications. Local copybooks are always found if the project is included in the Copybook Concatenation list within the project in which the source code is located.
• When importing components from Git, the Commit information is stored in ISPW and is displayed in the Assignment and Release Views in Topaz.

Improved DevOps pipeline

A new webhook now alerts you when something is waiting for approval so that you can use the Approval API to approve and continue.

Enhanced Topaz interface usability

Based on user feedback, the Containers View is now sorted in descending order when you click a column header.

Based on feedback from users to improve usability, the Outline View in the editor is now the default view in the ISPW perspective.

In the editor, you can now switch from browse mode to edit mode without having to exit and reopen the Editor.

Topaz Strobe measurement plug-in

In the JES Explorer, when you initiate a Strobe measurement, you can select all Strobe environments. Navigate to Strobe Request > Target > Strobe Environment > System and select ALL.

The value ALL is available when you have installed Strobe on a SysPlex. You can select ALL for both Active and Next Run measurements.

Brazil Tax ID number

Data Privacy functions are added to recalculate check digit after disguising of CPF (Individual Tax ID) or CNPJ (Business Tax ID).

Certificate Authentication for CLI

You can use certificate authentication from the TED CLI and the Topaz for Total Test to TED CLI.

File counts

When editing z/OS data sets, Data Source Statistics are available to report counts of records processed and selected and the total number of records on the file.

Improved Copy/Paste

Copy/Paste is improved within edit and between editors. TED uses clipboard to allow copy/paste for non-Topaz locations.

If a paste operation causes data to be truncated or data incompatibility, warnings are displayed on a cell.

Key navigation

When editing a VSAM KSDS data set, you can directly navigate to a specified key value via the Goto key.

Record numbers

When editing a z/OS data set, the record number within the original file is displayed for each record.

COBOL parser

Processing and usability improvements to the COBOL editor parser.

Default typing mode for Topaz Editors

You can select the default typing mode for Topaz Editors. The available values are Insert and Overwrite.

For more information, see Default typing mode.

Enhancement to z/OS to Windows copy function

When you copy a member from z/OS to Windows, the member is copied into the specified directory without creating a parent directory of the PDS name.

Recognizing EIB and DFHRESP functions

The Topaz COBOL editor now recognizes EIB and DFHRESP functions.

Save JES Explorer search criteria

You can save search criteria to recall a JES queue, when necessary.

For more information, see the following topics:

• Toolbar-buttons-in-the-JES-Explorer-view
• JES_Job-list-filtering

ISPW/Eclipse

ISPW Distributed Deploy is no longer supported.

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

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.

Code Coverage/Eclipse

Code Coverage Annotated Listings uses language-specific editor for display instead of the Text editor.

ISPW/Eclipse

In Topaz, the recovery file is deleted if you perform a browse before an edit.

When using the Eclipse Fast View feature to minimize the Assignment view, the refresh action logs you in, if not logged in, which causes the minimized view to be hidden.

The editor opens as dirty when selecting mainframe copy during recovery dialog.

Opening a task in Project Explorer that has a recovery file, opens the recovery version without prompting the user.

When in browse mode, switch to edit within the editor did not always work.

Jenkins job tries to commit a change that was already successfully committed in a prior build.

Merging code to main from branch fails the synchronization from GIT to ISPW, when it has been previously synchronized during a push.

Topaz Enterprise Data

Fixed a problem where Compare results were not generated when a compare using the Match Record number was as the key (1 to 1, and others) or Match Records using sort field. The problem occurred when 1 file had a record length shorter than the COBOL layout specified.

Double-byte characters are preserved in Data Editor request names in Request Management file.

Adjusted the document for the Spec Generation utility to include correct parameters.

Workaround added for DB2 JDBC driver issue to correctly calculate length of GRAPHIC and VARGRAPHIC columns defined with CODEUNITS16 specifier.

Fixed a problem where a host alias was contained within another host definition.

Fixed a problem parsing a specification name that contained the META keyword.

Added error handling for migration problem that prevents the Repository Management Utility to hang.

Removed the unnecessary creation of ScrolledForm in row mode.

Topaz for Program Analysis

Program Analyzer does not support FUNCTION TRIM with LEADING or TRAILING argument.

Error occurred during the import operation of the Visualizer RC=-3 when trying to display the Program Structure for source that contained DBCS.

Program Analyzer generates an incorrect report for package programming with PL/I subprograms.

With Program Analyzer, a procedure call is highlighting the wrong node in the program structure diagram.

Topaz for Total Test

Minor UI fixes to REST service and Hiperstation Playback elements

Occurrences of 'Rest' are changed to 'REST' for the REST Service element.

Topaz for Total Test - NV ATV - Add "user directory" parm to XATZCICX

Null Pointer Exception occurs when creating a program stub.

Add logic to Xpediter/CICS API and base product to support Date/Time Service Events.

NVT - PL/I FPL2104 does not produce the proper output when selection input value is supplied.

Error in DB2 Batch Capture Using Build 80-Distributed

Total Test UI - "No load libraries have been defined for unit test" is displayed when runner.jcl option is selected.

Exception when selecting a Variable element containing an Expression (or other replaceable) element.

Total Test (CLI) to use client certificate to access CES

Total Test (Topaz) to use client certificate to access CES

Total Test Web client to use client certificate for HCI authentication

Finalize and enable Hiperstation Replay element.

Finalize and enable REST Service element.

Topaz for Total Test - NV ATV - Create Comparison JCL.

Topaz for Total Test - NV ATV - Create Execution JCL.

FTCLI - When executing old Unit Test Jenkins need to copy JUnit and Sonar to Jenkins workspace

Create Topaz for Total Test Maintenance Display module & Module table

Topaz for Total Test - Update Angular 1.7.8 to 1.8.2 

Topaz Workbench

Opening a local file in the default text editor causes a Null Pointer Exception.

The INIT option of declaring an array now supports (iterator) (repetition).

Updated copyright years in About Dialog and Installation Details dialog.

Preference setting for Cobol Syntax Checking is now preserved when upgrading from 20.05 to a later version.

The certificate selected by the user is correctly used. The user is only asked to select the certificate once.

Corrected a rare Null Pointer Exception when getting a list of data sets.

Update the PL/I parser to allow abnormal as an attribute on an Entry variable declaration.

The PL/I language spec does not specify the keyword ENTRY as optional while declaring an Entry. However, the compiler does allow this, so we have updated the parser to allow it as well. This change covers customers that use the technique. Other similar uses may need parser changes in the future to handle it.

When an HTTP request is made that expects JSON results, and HTML is returned (an HTTP error occurred), a dialog box with a Browser control displays the HTML received.

When multiple files (with .data extension) are selected to open with browse or edit, make sure that the content of every file is examined so that it is opened with the correct editor.

Read in Windows file for copying to z/OS as UTF-8.

Fixed the cause for cached resource map not being repopulated again after a previous logout of the host and the clearing of the cached resources. 

Changing the Other color preference for PL/1 now works.

When logged in with code page 939, entering the Shift-Out placeholder via the context menu or Alt-O while editing source caused the Alt-key to behave as if it were pressed.

Change the NxPromote List Log Selection wizard to allow the user to finish when the Element Filter field is blank. A blank Element Filter should act as an asterisk wildcard character returning all elements.

Updated the PL/I outline view parser (simple parser) to handle the additional Include formats.

The PL/I parser rule for Title was changed to use an expression, which allows !! for concatenation.

PL/I source code coloring stops after encountering SQL statements with comments.

Return the correct codepage to the mainframe when saving a uss file and make sure that carriage returns are correct.

A comment line in between continued line and the continuation line of a data item string does not cause a parser error.

Added missing Auto setting to the list of TLS settings that can be synced

Reload search view when the user performs search. This will happen if the current file is different from the previous one.

Label for host node in Host Explorer is sometimes erased when performing a Logout. 

Document offsets in outline view correctly calculated when Cobol source contains continuation lines.

Added the Color Preference Page to the JCL Editor Preference page when using the context menu.

The INOUT, INONLY, and OUTONLY attributes for declared items are now tracked.

In the PL/I parser, we updated our handling of PUT EDIT SKIP to handle an additional format that does not match the Language Spec but does compile.

Improved installation of eGit using p2Director

Line endings for editing USS files are now set correctly.

Switching from browse to edit mode in ISPW resources is supported.

Use of the RTC (Rational) plug-in no longer causes long delays when clicking items in the Project Explorer that are under Jazz source control management.

Enterprise PL/I displays problems with the Content Assist preview of available variables for UNAL, +=, and %DO SKIP. Also now allow a period (.) to be part of a variable name. 

Fixed bracket highlighting for Do End blocks in the PL/I editor.

Japanese properties files and messages were properly updated and merged.

Hex Editor icon and menu items should be shown only when available for qualifying data set types.

Reduced memory consumption during visualizations.

When deleting a host resource and re-creating the same resource with different parameters (for example, a different LRECL) in the same Topaz session, make sure that the new parameters are used instead of the old ones when processing and in messages.

Cobol Outline view displays Linkage twice for a source file that had a linkage declaration within a string literal.

Grammar updated to improve error reporting/recovery for periods missing after paragraph name or section declaration.

HttpCredentialsCertificate.getAuthenticationString() returns NULL for X509 certificates used by CES with certificate authentication for Total Test.

Declared variables with the DATE attribute now support the optional formatting of a date.

File transfer from Windows to z/OS gives cryptic error message when transferring a file with characters that cannot be mapped by the existing code page.

PL/I Preprocessor - support "stmt" as a shortcut for statement.

Show skipped icon in Windows to z/OS Copy/Move dialog instead of a Warning icon when Copy/Move files are skipped.

Generate a PL/I parsing error when an ANSWER statement is found in a procedure that has a RETURNS statement.

Cobol EXEC DTC, EXEC DECLARE, and EXEC SELECT statements not being handled correctly.

When using SonarLint integration in Project Explorer, it is impossible to run a Sonar analyze at the project level. This should have been done only for Compuware online projects due to performance issues. Ability restored for general Eclipse projects and Compuware offline projects.

Fixed the Comment/Uncomment Block function to work properly for the Cobol editor.

Add support in the PL/I Preprocessor for the Index, Translate, and Verify built-in functions.

PL/I Editor parser does not detect comment after EXEC SQL statement with comment.

Host Explorer login dialog is not allowed in JUnits when trying to automate tests.

Update Search Results view has encountered a problem error displays when performing either a simple Host Explorer Dataset Search or a File-AID Dataset search. This can occur with members whose name starts with a period (.) or an accented character when using code pages.

Toggle block comment adds a space to the first line.

Change how individual members are copied from z/OS to Windows. Instead of creating a subdirectory and copying them to it, the members are simply copied directly to the target directory.

Allow a source file to be opened in several compare editors.

Issue connecting from Topaz Workbench to the z/OS host when logging on with a x.509 certificate that is on a SmartCard. This is due to there being three certificates on the SmartCard that all have the same name.

Undefined variables are not detected by the parser in COBOL sections and paragraphs.

Errors occur causing the parser to stop parsing before the end of the file is reached. This results in data being lost for both the Outline view and the content assist function. A message is generated indicating an unrecoverable error occurred.

Make sure proper indentation is maintained when inserting a template from the pop-up.

Clicking a comment line or a blank line in the Procedure Division or Data Division within the source editor does not highlight the section in the Outline view.  

Copy paste does not always work in Project Explorer when Templates view is open.

Updated messages for z/OS UNIX errors. The message now refers to the IBM documentation for more details.

PL/I copybook with same name as program is not found, parser is showing an error. 

For the Cobol Editor, Data items defined after DB2 includes or cursor declaration are missing from the Outline view.

Editor Preference pages, unchecking option Show Print Margin does not disable the Print Margin Column: field underneath it.

zAdviser events from CES not being received. The Topaz log shows that data was sent to the HCI, but there was no corresponding SMF record. 

Host Explorer local drive filters containing the following special characters cannot find files:

• $
• (
• )
• +
• [
• ^

When pressing Alt+O (shift-out) and Alt+I (shift-in) keys continuously several times not releasing the Alt key, the shift-in character cannot be displayed. The i and o characters start being inserted instead.

When CES sync fails due to invalid credentials, give the user the option to change and test the credentials.

Keyword RES/RESERVE not supported by Cobol Editor.

Newly created custom templates are inserting blank lines into the code.

The COBOL parser now recognizes CICS DFHRESP code description keywords.

Long PL/I parser time for a large program that receives ambiguity errors for input fields starting with a period (.) and numerous mismatched input errors. 

Topaz startup can be inconsistent and take a long time because of complicated plug-in dependencies. We have refactored the major contributors to this problem to improve Topaz startup times.

PL/I template editor is in a different font then the PL/I Editor.

Language not detected by Topaz editor when opening a Cobol member from the Search results view.

In Host Explorer, editor could not be initialized error after doing a Search, closing the file, clicking a result in the Search view, closing the not found message, then reopening the original source file. 

Allow a certificate to be passed through the Jenkins Common plug-in. Update credential store retrieval.

Program code does not always load into the Cobol editor when initially starting up Topaz then opening the file.

Pressing CTRL-ALT+Up Arrow or Down Arrow does not work when you switch from Browse to Edit.

Variable colors not correctly set and displayed for PL/I Editor.

Update SonarLint currency to support v5.7 and v5.8. 

Enqueue not released when the Cobol editor is closed after closing the Compare editor, which included that member, when multiple edit sessions also active.

The BEGIN block in question is legitimate code that is generated by one of the PL/I copybooks. This change now treats "generated" code (code that a macro procedure returns/answers during the pre-processor phase) as if it came from a copybook effectively filtering it out from the outline view.

Outline view not displaying an icon for variables defined with LIKE.

PL/I preprocessor - %push, %pop, and %noprint should not be flagged as errors.

Cobol parser error: SYSIN cannot be resolved.

Perspective tab icon not listing name for Host Explorer and Program Analysis when Topaz installed into IBM IDz 15.1. 

COBOL Line numbering/tagging settings not being honored causing auto-indentation not to start in the proper column when entering a new line. 

While invoking a template, the parameters are displayed in alphabetical order. They are expected to be in the same order as they were defined.

Many static definitions and values for COBOL EIB fields coming from the EXEC interface are not be recognized and generate errors.

CBL statement not recognized in a COBOL 6.2 program containing CBL CICS(NOLINKAGE) as the first statement in the source.

Cobol Parser shows error for function TRIM with LEADING or TRAILING argument.

An Invalid thread access error popup is displayed upon initial restart of Eclipse after installing the Topaz p2repo. It is displayed again if a new workspace is used. 

Topaz JCL Editor - Toggle command does not comply with the program coding rules.

Warn users before opening large PDS members more than 100-MB in size.

When Topaz Workbench is closed with the Cobol Editor still open, some functionality is missing when the editor is restored on startup.

When adding columns CPU% or CPU Time, and possibly EXCP, in the JES Explorer view, it fails with a return code 269 with message No space exists in the partitioned dataset directory.

Code containing an invalid SELECT DISTINCT statement caused parse to terminate prematurely. This caused code folding to not have the required information from the parser. Consequently, fold did not work till the End statement. 

Problems when multiple COPY REPLACING clauses occur on the same line. A part of the section name defined in a Copybook is being derived from the word specified for the Replacing By clause.  

If user leaves an edit session open and the HCI gets recycled, the lock on the file being edited becomes invalid. Another user can edit the file and save it. If original user continues editing and tries to save, Topaz automatically renews the lock and saves, thereby potentially overwriting changes another user might have made. To avoid this, a dialog box is now displayed informing the user that the HCI was recycled and the file might have been modified by another user, giving the options to continue to save or to cancel.

Fixed unresolved variables in the Topaz Cobol Editor for Report Writer Generate, Initiate, and Terminate statements. Also handle multiple report names defined in the Initiate and Terminate statements.

No prompt to switch from Browse to Edit if the delete key is used while browsing a file.

Topaz hangs when too many results found for a File-AID DB2 filter in Host Explorer.

PL/I preprocessor - forward declaration/activation/deactivation of a macro procedure not parsing correctly.

Add an editor preference to set default text entry mode to insert or overwrite.

Add support to the CLI for authenticating with X509 certificates.