File-AID Release Notes

Release 10.1

May 14, 2014

Latest Release Notes

What’s New

  File-AID/MVS

  File-AID/Data Solutions

  File-AID/RDX

  File-AID for DB2

  File-AID for IMS

  File-AID/EX Enterprise Edition

File-AID Maintenance Support

Software and Hardware Requirements

Discontinued Support

Technical Notes

Known Issues

Product Documentation

Support Resources

 

The File-AID Single Install Image includes the z/OS versions of all Compuware File-AID products. All products in the File-AID Single Install Image are on the same release level. Compuware recommends that you install and activate all of your licensed File-AID mainframe products at the same time to avoid compatibility issues between different release levels.

Latest Release Notes

These Release Notes may have been revised. For the latest version, go to http://go.compuware.com , Compuware's technical support Web site. The first time you access Compuware Go (formerly known as FrontLine), you are required to register and obtain a password. After logging onto Compuware Go, 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.


What’s New

Starting with File-AID Release 10.1, the following enhancements have been added:

File-AID Single Install Image Installation

The z/OS versions of the Compuware File-AID products are delivered and installed as one single install image when you order any or all of the File-AID mainframe products. The license key(s) you receive from Compuware determine which of the File-AID products you can activate and execute.

Follow the instructions in the File-AID Single Install Image Installation and Configuration Guide , as the installation and configuration of File-AID products has changed from previous releases.


File-AID/MVS

Starting with File-AID/MVS Release 10.1, the following enhancements have been added:

Support for VSAM Linear Datasets (LDS)

File-AID/MVS now allows access to VSAM Linear datasets (LDS). Selection Criteria in EDIT (Option 2) and Option U, UPDATE, in SEARCH/UPDATE (Option 3.6) are not supported for LDS. Allocation of LDS permits CISZ parameter values from 4k (default) to 32k in multiples of 4k.

File-AID SVC

A File-AID authorized SVC generated by a release prior to File-AID Release 10.1 is not compatible with File-AID/MVS Release 10.1. It must be replaced with an authorized SVC generated by File-AID Release 10.1. The new common File-AID authorized SVC is compatible with the current release of all File-AID products and prior releases of File-AID/Data Solutions, File-AID/MVS, and File-AID for IMS .

IAM Support

For File-AID/MVS to continue support of IAM (Innovation Access Method) file types, you must apply the appropriate IAM version fix. IAM Version 9.0 requires fix P900235 and IAM Version 9.1 requires fix P910005.

Reformat Function

File-AID/MVS has added the Disposition NEW parameter to the output dataset specification on the Reformat Execution screens.

File-AID/Batch Parameters

File-AID/Batch has added the following Parameters:

-- IFNOT selects specific records that do NOT contain the specified data value. It scans the specified field for the absence of a data value. IFNOT works on a not equal condition.

-- ORIFNOT allows contiguous IFNOT parameters to be logically ORed with preceding IFNOT parameters. ORIFNOT permits record selection based on more than one selection criterion. The ORIFNOT parameter selects specific records that do NOT contain the specified data value. It scans the specified field for the absence of a data value. ORIFNOT works on a not equal condition.

File-AID/Batch Data Type Parameters

File-AID/Batch has added the following Data Type Parameters:

-- CL nnn and TL nnn for character and text data to specify the length of search string in File-AID/Batch control cards.

-- PL nn for packed data to specify the length of search string in File-AID/Batch control cards.

-- I and IL n for integer (binary) data to specify the length of search string in File-AID/Batch control cards.

File-AID/Batch Data Operator Elements

File-AID/Batch has added the following Operator Elements:

-- BT Between

-- NB Not Between

Calling File-AID/Batch from Another Program

1. When LE enabled user programs call File-AID 10.1.0 they must call XFAFAIDN and must be linked with ALL31(OFF) and STACK BELOW.

2. Non-LE programs should call XFAFAID.


File-AID/Data Solutions

Starting with File-AID/Data Solutions Release 10.1, the following enhancements have been added:

File-AID SVC

A File-AID authorized SVC generated by a release prior to File-AID Release 10.1 is not compatible with File-AID/Data Solutions Release 10.1. It must be replaced with an authorized SVC generated by File-AID Release 10.1. The new common File-AID authorized SVC is compatible with the current release of all File-AID products and prior releases of File-AID/Data Solutions, File-AID/MVS, and File-AID for IMS .

Linking User Exits with AMODE(31),RMODE(24) Required

If you intend to use user exits with File-AID/Data Solutions, you must compile and link them with AMODE(31),RMODE(24). If you plan on using exits from a File-AID/Data Solutions release prior to Release 10.1 that were not compiled and linked with AMODE(31),RMODE(24), you must copy, then recompile and link them with AMODE(31),RMODE(24).

Renamed Audit Trail Exit Load Module UDAAUAXF

The File-AID/Data Solutions audit trail exit, DAAUAXF is now linked into load module UDAAUAXF. If you plan on using a custom audit trail exit from a File-AID/Data Solutions release prior to Release 10.1, you must copy, then rename the load module to UDAAUAXF.

Renamed SMF Exit Load Module UDASMFUX

The File-AID/Data Solutions dynamic SMF exit, DASMFUEX, is now linked into load module UDASMFUX. If you plan on using a custom dynamic SMF exit from a File-AID/Data Solutions release prior to Release 10.1, you must copy, then rename the load module to UDASMFUX. In addition, you must modify the SMF exit name field in the audit exit program source code of the corresponding Audit Trail Exit and recompile and relink it per the instructions in the File-AID Single Install Image Installation and Configuration Guide .

Custom Date Pattern Exits

Custom date pattern exits are now linked into load module DATELIST. If you plan to use custom date pattern exits from a File-AID/Data Solutions release prior to Release 10.1, you must copy the date pattern exit, then update, compile and link the provided DATELIST source per the instruction in the File-AID Single Install Image Installation and Configuration Guide .

Custom Field Level Exits

Custom field level exits are now linked into load module EXITLIST. If you plan to use custom field level exits from a File-AID/Data Solutions release prior to Release 10.1, you must copy the field level exit, then update, compile and link the provided EXITLIST source per the instruction in the File-AID Single Install Image Installation and Configuration Guide .

IAM Support

For File-AID/Data Solutions to continue support of IAM (Innovation Access Method) file types, you must apply the appropriate IAM version fix. IAM Version 9.0 requires fix P900235 and IAM Version 9.1 requires fix P910005.


File-AID/RDX

Starting with File-AID/RDX Release 10.1, the following enhancements have been added:

Key File Relationships

The Key File support has been expanded to create Output KEY File relationships from any valid parent DB2 or MVS object. The Output KEY File can then be used by File-AID/RDX as an input (external) keys file against a driving object in another extract or as input into another process of your choosing. When the relationship is to an IMS segment, use the Output KEY File with File-AID for IMS to extract IMS data.

Support for Temporal Tables

File-AID/RDX now supports Temporal Tables in extract and load processing.

Extract

File-AID/RDX allows extracting related data from Temporal Tables.

SELECT FROM Temporal Table

The new option, SELECT FROM Temporal Table, has been added to the Extract Scope panel to define time periods to be used to select rows from a Temporal Table.

Whenever selection is based on SYSTEM_TIME, it is possible that some rows come from the base table and some from the history table.

Selection based on BUSINESS_TIME will be supported since all rows are from the same table.

When selecting the SELECT FROM Temporal Table option, you can specify separate time periods for system time and/or business time in a popup.

A bitemporal table contains both SYSTEM_TIME and BUSINESS_TIME.

Load

File-AID/RDX supports loading extracted data from Temporal Tables to existing target Temporal Tables using the DB2 Load Method only. You can specify whether File-AID/RDX generates the PERIODOVERRIDE clause when loading data to SYSTEM TEMPORAL tables.

Timestamp with Time Zone

The new TIMESTAMP_TZ function returns a TIMESTAMP WITH TIME ZONE value from the input arguments. The time portion of a timestamp value can include a specification of fractional seconds. The number of digits in the fractional seconds portion is specified using an attribute in the range from 0 to 12 with a default of 6.

DECFLOAT and BIGINT Support

File-AID/RDX now supports DECFLOAT and BIGINT column types for extract, load and delete.

IAM Support

For File-AID/RDX to continue support of IAM (Innovation Access Method) file types, you must apply the appropriate IAM version fix. IAM Version 9.0 requires fix P900235 and IAM Version 9.1 requires fix P910005.


File-AID for DB2

Starting with File-AID for DB2 Release 10.1, the following enhancements have been added:

DB2 Version 11 -- Initial Support

File-AID for DB2 Release 10.1 now displays DB2 Version 11 information for Tables and Index information.

  SELECT FROM Temporal Table will support views in the following areas:

  Browse

  Edit

  Print

  Related Browse and Related Edit

  EBCDIC tables with individually defined UNICODE columns are supported in Browse, Edit, and Print Table data. UNICODE columns in EBCDIC tables display like UNICODE columns in UNICODE tables.

Table Information Panel

The Table Information panel has been updated with additional DB2 Version 10 and 11 entries HASHKEYCOLUMNS and CONTROL. The panel is scrollable, and table information has been grouped for improved readability.

Index Information Panel

The Index Information panel has been updated with additional DB2 Version 10 and 11 entries PADDED, AVGKEYLEN, IX_EXT_TYPE, COMPRESS, HASH, and SPARSE. The panel is scrollable, and index information has been grouped for improved readability.

File-AID SVC

A File-AID authorized SVC generated by a release prior to File-AID Release 10.1 is not compatible with File-AID for DB2 Release 10.1. It must be replaced with an authorized SVC generated by File-AID Release 10.1. The new common File-AID authorized SVC is compatible with the current release of all File-AID products.

The new File-AID authorized SVC is NOT compatible with prior releases of File-AID for DB2 .


File-AID for IMS

Starting with File-AID for IMS Release 10.1, the following enhancements have been added:

Database Versioning Support for IMS 13

File-AID for IMS will always use the version of the DBD that is defined to IMS or referenced in BMP mode when an EDIT or Browse session is started or when batch execution begins.

File-AID SVC

A File-AID authorized SVC generated by a release prior to File-AID Release 10.1 is not compatible with File-AID for IMS Release 10.1. It must be replaced with an authorized SVC generated by File-AID Release 10.1. The new common File-AID authorized SVC is compatible with the current release of all File-AID products and prior releases of File-AID/Data Solutions, File-AID/MVS, and File-AID for IMS .


File-AID/EX Enterprise Edition

Starting with File-AID/EX Enterprise Edition Release 10.1, the following enhancements have been added:

File-AID Single Install Image Installation

File-AID/EX Enterprise Edition is installed and configured as part of the File-AID Single Install Image. Follow the instructions in the File-AID Single Install Image Installation and Configuration Guide , as the installation and configuration of File-AID products has changed from previous releases.

 


File-AID Maintenance Support

Compuware is committed to actively supporting its current product releases. Click on the z/OS & Product Compatibility link on the Compuware Go customer support website for up-to-date product release support and retirement information. To access Compuware Go, you must first register and obtain a password at http://go.compuware.com .


Software and Hardware Requirements

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 .

Hardware Platforms

  Mainframe Systems:

-- zEC12, zBC12

-- z196, z114

-- z10-EC/BC

-- z9-EC/BC

-- z900, z990

-- z800, z890

Operating Systems

  IBM z/OS V1.12, 1.13, 2.1 (V2.1 is supported in toleration mode without exploiting new features)

  IBM ISPF for the supported z/OS releases

  LE libraries for the supported z/OS releases

  TSO/E for the supported z/OS releases

Notes:

-- IBM's fast data access service of the program management binder uses 64-bit storage rather than a dataspace. Therefore, Compuware recommends changing your system default SMF MEMLIMIT Parameter to NOLIMIT through SMFPRMxx in PARMLIB: MEMLIMIT(NOLIMIT).

-- Refer to each File-AID product's Reference manual for recommended TSO region sizes for batch or online processing. If using a smaller region size, use caution when entering wildcards or working with large amounts of data. Increase region size accordingly when processing a large amount of data.

-- For File-AID Data Privacy jobs using Dynamic Privacy Rules (DPR), specify a region size large enough to run Java (REGION=0M is suggested, 200M is the minimum) in your jobcard.

-- For File-AID Data Privacy jobs using Dynamic Privacy Rules (DPR), setting the memory values in the LE STACK option to values lower than the IBM default values can cause a performance degradation. The IBM default is: STACK=((128K,128K,ANYWHERE,KEEP,512K,128K),OVR)

Major Subsystems

  IBM CICS Transaction Server for z/OS V3.1, 3.2, 4.1, 4.2, 5.1 (for File-AID products that provide CICS Transactions Server for z/OS support)

  IBM DB2 for z/OS V9.1, 10.1, 11.1 (for File-AID products that provide IBM DB2 support) Using File-AID during enabling-new-function mode (ENFM) of any DB2 version may lead to unpredictable results.

  IBM IMS Transaction and Database Servers V11.1, 12.1, 13.1 (for File-AID products that provide IBM IMS support)

Languages

  IBM Enterprise COBOL for z/OS V3.4, 4.2, 5.1. Enterprise COBOL 5.1 is supported at the current feature level of previous COBOL releases without exploiting new functionality.

  IBM Enterprise PL/I for z/OS V3.9, 4.2, 4.3, 4.4

Corequisites

  Compuware Products and Components:

-- To use File-AID with the Compuware Workbench:

  Compuware Shared Services 8.8, 9.0

  Compuware Workbench 3.2, 4.0

  File-AID/Eclipse 4.0

  File-AID Data Editor 3.2, 4.0

  File-AID Data Privacy 3.2, 4.0

  Host Communications Interface 2.5, 3.0

-- To use File-AID with Xpediter/TSO:

  9.1 with PTF XTI0110

  9.2 with PTF XTJ0060

  9.3 with PTF XTK0017

-- To use File-AID with Abend-AID:

  12.2 with PTF N92552

  12.3 with PTF ACB181Y

Note: When configuring File-AID support for the Compuware Workbench, you cannot mix versions of File-AID products prior to Release 10.1 with File-AID 10.1 products on the same host and port. Refer to the Compuware Workbench Installation Guide for more details.

Discontinued Support

File-AID 10.1 is the last release to support the following:

  Host Communication Interface 2.5

  IBM DB2 for z/OS V9.1

  IBM Enterprise COBOL for z/OS V4.1

File-AID no longer supports the following:

  IBM z/OS V1.11 and earlier

  IBM Enterprise COBOL for z /OS V3.3 and earlier

  IBM Enterprise PL/I for z /OS V4.1, 3.8 and earlier

  IBM DB2 UDB for z/OS Version 8, including V8 mode running subsystems in V10 and V9

  IBM IMS V10 Transaction and Database Servers and earlier

  IBM CICS Transaction Server for z/OS V3.0 and earlier


Technical Notes
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

File-AID for IMS

File-AID for IMS requires the following IBM APARs:

  PM68699

  PM67324


Known Issues
File-AID for IMS/ISPF

Compuware has identified an issue when specifying partitioned datasets (PDS or PDSE) to unload database data in File-AID for IMS/ISPF Option 4 Extract/Load. The generated jobs do not execute successfully when extracting/loading data to/from a partitioned dataset. Manually correcting these jobs will have unintended results and should not be attempted. Compuware recommends to only use sequential datasets for these processes.


Product Documentation

The Receive from Network (RFN) product installation package does not include the product documentation. The following File-AID documentation is available in electronic format on the product documentation site at Compuware's customer support website, http://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 product documentation at the FrontLine documentation site at Compuware GO/FrontLine .

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.

The PDX file allows you to quickly search all of the manuals in the documentation set at one time. Click the PDF Index File link to launch Adobe Reader and load the file. See the Reader’s help for more information.

Note: In some environments, the link results in a blank browser page. Instead of using the link, start Adobe Reader and open the .pdx file for the respective File-AID product.

HTML Format

For your convenience, Compuware also provides the File-AID 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.

 


Support Resources

Compuware provides a variety of support resources to make it easy for you to find the information you need.

Compuware Go Customer Support Website

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 .

Contacting Customer Support

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 http://go.compuware.com .

Web

You can report issues via the Quick Link Create & View Support Cases on the Compuware Go home page.

Note: Please report all high-priority issues by telephone.

Mail

Compuware Customer Support
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.