Release Notes

File-AID Data Privacy 18.02

January 23, 2018

Obtaining the Latest Release Notes

What's New in Release 18.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 technical 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 18.02
Release 18.02 includes the following enhancements:
January 4, 2018

No new features have been added in this release.

October 2, 2017
Topaz for Enterprise Data

The File-AID Data Privacy and File-AID/EX features of Topaz Workbench are now included as part the Topaz Enterprise Data feature.

New media, called Topaz for Enterprise Data, has been created for installing the following:

  File-AID Services

  File-AID Rules Engine

  File-AID/EX

  File-AID Execution Servers.

This new packaging means that, starting with release 18.02.03, File-AID Data Privacy and standalone File-AID/EX are no longer ordered as individual products.

Additionally, to use the File-AID/EX and File-AID Data Privacy features that are available in Topaz Workbench, users must install the appropriate options listed above and install the following features during Topaz Workbench installation:

  File-AID/EX feature

  File-AID Data Privacy feature

  Topaz for Enterprise Data feature (allows use of Enterprise Data Editor and Data Visualizer).

June 28, 2017
Enhanced Expression Builder Editor

The Expression Builder editor has been improved to include color coding, FIND/REPLACE, UNDO/REDO, matching bracket identification, and immediate syntax checking.

Multiple Derby Databases

Repository Management now supports the creation of Derby databases so that multiple Derby databases can be defined for the Rules Repository.

Support for IAM Files as Translate Tables

You can store your Data Privacy translate tables in IAM files.

April 3, 2017

No new features have been added in this release.


File-AID Data Privacy 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 (previously System 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 FrontLine’s System z Compatibility page.

File-AID Data Privacy
Hardware Requirements

  Distributed Systems:

— Processor: 3 GHz minimum*

— Hard Disk: 1 GB minimum

— Memory: 2 GB minimum* (4 GB recommended)

* Processor speed and available memory directly impact performance. The faster the processor, and the more memory available, the better your performance will be.

Operating Systems

  IBM Mainframe

— IBM z/OS V2.1, 2.2, 2.3 (z/OS UNIX for File-AID Rules Engine)

  Linux

— Red Hat Enterprise Linux for Servers 6. x , 7.2, 7.3

  Microsoft Windows 8.1 Update, 10

  Microsoft Windows Server 2012, 2016

Languages

  For supported Windows: Oracle Java SE 8

  For supported Mainframe: IBM Java 31-bit SDK V8.0 or higher (only 31-bit Java is supported on z/OS Unix)

Corequisites

  Compuware Products and Components

— Enterprise Common Components 16.05, 17.02

— File-AID for DB2 16.3, 17.2

— File-AID for IMS 16.3, 17.2

— File-AID/RDX 16.3, 17.2

— File-AID/Data Solutions 16.3, 17.2

— File-AID/EX 16.3, 18.02

— Topaz for Enterprise Data 18.02

Distributed

  Browsers and IDEs

— Microsoft Internet Explorer 10, 11

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 File-AID Data Privacy plug-in is not supported in native Eclipse and IBM RDz environments. Topaz Workbench must be installed.

  Compuware requires that all current maintenance be applied to the companion products. In order to use the newest features, any 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.

  File-AID Data Privacy is an Eclipse-based plug-in distributed with the Topaz Workbench Media or RFN order.

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

File-AID Services
Hardware Requirements

  Distributed Systems:

— Processor: 3 GHz minimum*

— Hard Disk: 1 GB (for executables and Derby database)

— Memory: 2 GB minimum,* (4 GB recommended)

* Processor speed and available memory directly impact performance. The faster the processor, and the more memory available, the better your performance will be.

Operating Systems

  Linux

— Red Hat Enterprise Linux for Servers 6. x , 7.2, 7.3

  Microsoft Windows (x86, x64 mode)

— 8.1 Update

— 10

— Microsoft Windows Server 2012, 2016

Languages

  Oracle Java SE 8

File-AID Rules Engine (FARE) on z/OS UNIX
Hardware Requirements

  Hard Disk: 150 MB (to accommodate the installed files)

Operating Systems

  IBM Mainframe

— IBM z/OS V2.1, 2.2, 2.3 (z/OS UNIX for File-AID Rules Engine)

Languages

  IBM Java 31-bit SDK V8.0 or higher (only 31-bit Java is supported on z/OS Unix)

File-AID Rules Engine (FARE) for Linux, Unix, and Windows

The File-AID Rules Engine must be installed with the File-AID/EX Execution Server. See the File-AID/EX Release Notes in the Software and Hardware Requirements section under File-AID/EX and File-AID/EX Execution Server.

Supported Database Drivers in File-AID Services and File-AID Rules Engine (FARE)

  jTDS 1.2.5 for accessing MS SQL Server/Sybase databases

— Microsoft SQL Server 2012 Standard Edition

— Microsoft SQL Server 2014 Standard Edition

— Microsoft SQL Server 2016 Standard Edition

— SAP Adaptive Server Enterprise 15

  Oracle JDBC 11.2.0, 12.1.0

  IBM z/OS DB2:

— V11 CM, NFM

— V12


Technical Notes
File-AID Rules Engine (FARE) Requires Java 8

When upgrading from a prior version of Data Privacy, the FARE requires the version of Java to be upgraded to Java 8.

IBM Data Server Driver for JDBC and SQLJ

When using IBM Data Server Driver for JDBC and SQLJ, support for DB2 11 for z/OS requires the following APAR/PTFs:

The following table lists the 4.x and 3.x versions of the IBM Data Server Driver for JDBC and SQLJ and the DB2 11 for z/OS APAR that delivers each version.

IBM Data Server Driver for JDBC and SQLJ version

DB2 11 for z/OS APAR/PTF

4.15.105

PM96295/UI12420

3.65.102

PM96293/UI12401

Using IBM System z Application Assist Processors (zAAPs) is Recommended

When zAAPs are available at a site, Compuware’s Test Data Privacy solution will take advantage of them when executing via File-AID/Data Solutions, File-AID/RDX, File-AID for DB2, and File-AID for IMS, resulting in greater performance.

Upgrading Data Privacy

After upgrading Data Privacy, the connected Data Privacy Repositories must be migrated to the new version level before they can be accessed. The repositories can be migrated using the Manage Data Privacy Repositories menu option in the Data Privacy menu. Please contact your Data Privacy administrator if you do not have sufficient access permissions to perform the migration.

File-AID Services, Client, and File-AID Rules Engine (FARE) Compatibility

The Topaz Workbench, File-AID Services, and File-AID Rules Engine must be the same version level. The Topaz Workbench includes the File-AID Data Privacy client. Installation of File-AID Services is independent from that of the Topaz Workbench client and thus can lead to the installed version of one being incompatible with the installed version of the other. Mixed client and server versions could produce error messages or unexpected results.

Note: When updating the z/OS UNIX version of the FARE, if the current FARE was installed in the same directory you originally specified for the transferred installation files, you will need to move the installfare.jar and the installfare.sh files to a different directory before running the installation script again. When updating the FARE, all current files in the target directory are removed and then the new files are added. Therefore, the installfare files must exist in a directory outside the target directory. FARE maintenance is found on Frontline and contains detailed instructions in the readme faremaint file for each supported platform.

Region Size for DPR Disguise

When disguising an extract with File-AID Data Privacy defined Dynamic Privacy Rules (DPR), specify a region size large enough to run Java (REGION=0M is suggested, 200M is the minimum) in your jobcard.


Known Issues
Using Translation Table in Oracle Database from a Data Privacy Engine installed in z/OS UNIX

When a job attempts to connect to an Oracle database that contains the translate table, that job will fail with an error message similar to the following:

Method execPrivacyRules failed (RC=8) at line 353 in file EXECDPR.C

This high-level failure message appears due to a number of possible causes. You must run with debug set to FINEST in order to diagnose this cause. The FAERROR output may have the lines shown below.

Throwable occurred: java.sql.SQLException: Internal - Unexpected value
at oracle.jdbc.driver.T4CTTIoauthenticate.processRPA(T4CTTIoauthenticate.java:516)
at oracle.jdbc.driver.T4CTTIfun.receive(T4CTTIfun.java:295)
at oracle.jdbc.driver.T4CTTIfun.doRPC(T4CTTIfun.java:186)
at oracle.jdbc.driver.T4CTTIoauthenticate.doOSESSKEY(T4CTTIoauthenticate.java:390)
at oracle.jdbc.driver.T4CConnection.logon(T4CConnection.java:356)
at oracle.jdbc.driver.PhysicalConnection.(PhysicalConnection.java:531)
at oracle.jdbc.driver.T4CConnection.(T4CConnection.java:221)
at oracle.jdbc.driver.T4CDriverExtension.getConnection(T4CDriverExtension.java:32)
at oracle.jdbc.driver.OracleDriver.connect(OracleDriver.java:503)
at java.sql.DriverManager.getConnection(DriverManager.java:322)
at java.sql.DriverManager.getConnection(DriverManager.java:358)

The above output indicates a failure to connect to an assumed Oracle database. Verify whether the test was using a translate table stored on an Oracle database. If so, add the following lines to the Java options dataset member, FAJOPTS:

-Dfile.encoding=UTF-8

-Dlog.encoding=IBM1047

Adding these two lines will make it possible to run an Oracle translation while the log will be generated in EBCDIC. The user should make a copy of the existing Java options member before making any modification.

Rounding Numeric Calculations

A defect related to incorrect rounding of numeric calculations has been fixed. This may cause arithmetic operations within rule logic to produce a different result than with prior releases. Previously, rounding was always rounding down; now the result value will be rounded correctly.


Product Documentation

The product installation package does not include the product documentation. The following File-AID Data Privacy 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 File-AID Data Privacy 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 Solutions Website

You can access online information for Compuware products via our FrontLine Customer Solutions 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 Solutions

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 Solutions
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. JAN2018