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.
To provide a higher level of authentication assurance for IBM z/OS applications, File-AID Data Privacy (with File-AID Common Components 16.03 PTF VJ16096) now supports the use of IBM Password Phrase Authentication for z/OS. File-AID Data Privacy does not support IBM Multi-Factor Authentication for z/OS.
• 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.
File-AID Data Privacy 16.03.02 is the Classic release as of January 1, 2016. From this point on, no new functionality will be added to File-AID Data Privacy 16.03. Maintenance will continue to be delivered during each quarter of 2016 and at planned increments beyond that.
File-AID Data Privacy components will now be orderable as a separate product and will be packaged independently. The Compuware Workbench functionality has been integrated into the Topaz Workbench, so there will now be one Eclipse IDE offering. The default install of Topaz Workbench will include the File-AID Data Privacy client. The Compuware Workbench Server has been replaced by File-AID Services. The new File-AID Services media will include File-AID Services and the File-AID Rules Engine.
The Topaz Workbench and File-AID Services are required to create and maintain privacy rules and definitions for File-AID Data Privacy. Additional File-AID products are required to request the application of privacy rules depending upon what type of data is to be disguised.
Significant changes have been made to the definitions required for Composite and Overloaded processing. Processing types of composite and overloaded have been eliminated from the Data Element definition, and special rule types for composite and overloaded rules have also been eliminated.
Composite and Overloaded processing will now be handled as rule actions, and the definition needed for each will be included in the rule action. As part of migrating an existing Data Privacy Repository to the 16.03.02 release, all existing composite and overloaded rules will be converted to rule actions.
New functionality has been added to rule logic to allow the values and expressions used to identify a data item during composite processing to be changed during execution. This provides highly customizable composite processing, as the rule logic can change how data is identified based on changes in input values.
• Two new types of variables have been added: String List and Number List. These list variables can be used by the Expression Builder in rule logic or by user-written custom functions. Within the Expression Builder, there are several new functions to manage the values in the list, allowing values can be added, removed, and set as needed.
Execution Parameters can be provided to override the initial value of a variable at execution time. The syntax for execution parameters has been expanded to allow a list of values to be provided for list variables. This new syntax includes the ability to specify the delimiter being used between values.
• A standalone JAVA program can use the APIs to request that disguise rules be created for the metadata specified, and then to apply the disguise rules to the values passed in for disguise. The location of File-AID Services, together with the Repository and Project containing the disguise rules, is included in the API specification.
A new category of Resources has been added for Files. In this release, file support is limited to mainframe requests; the function will be ignored for distributed requests. At this point, only one file definition for DPRLOG is available. Any data written to DPRLOG in the rule logic will be written to whatever file is named on the DD statement for DPRLOG specified in the mainframe job.
Two new custom functions are being provided to return Encryption and Hash results which are consistent with the results returned by embedded privacy rules; this consistency is limited to character fields.
These functions are included in the Samples directory for the client and must be added to the repository prior to use. The Resource Administration option for Manage Custom Functions provides this functionality.
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 http://frontline.compuware.com/charts/hardware.aspx .
• These are the minimum requirements for Topaz companion products. Visit FrontLine and select the Topaz product page then select Fixes/Downloads for the latest detailed companion product requirements.
• 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.
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.
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.
After upgrading to Data Privacy 16.03, the connected Data Privacy Repositories must be migrated to the 16.03.02 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.
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 your 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.
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.
Throwable occurred: java.sql.SQLException: Internal - Unexpected value
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:
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.
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 customer support website, http://go.compuware.com .
Access the product documentation at the FrontLine documentation site at Compuware GO/FrontLine .
You can access online information for Compuware products via our Compuware Go customer support website at http://go.compuware.com .
Compuware Go 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 Go, you are required to register and obtain a password. Registration is free.
Compuware now offers User Communities, online forums to collaborate, network, and exchange best practices with other Compuware solution users worldwide. To join, go to http://groups.compuware.com .
• 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 . The Compuware site provides a variety of product and support information.