IBM Support

New Features and Enhancements for Rational Asset Analyzer and Rational Asset Analyzer for System z

Product Documentation


This document contains a complete listing of what's new in IBM Rational Asset Analyzer (RAA) and Rational Asset Analyzer for System z (RAAz).


Tab navigation

IBM Software Support Communities
  • Visit the IBM Support Portal for RAA or IBM Support Portal for RAAz to configure your support portal experience and review FAQs, lists of known problems, fixes, and a wealth of important support information.
  • Visit developerWorks to access an online collection of tutorials, sample code, standards, forums and other resources provided by experts at IBM to assist software developers using tools including access to the IBM RFE Community.
  • Visit the Jazz Community if you use an IBM product created using the Jazz platform to interact directly with the Jazz development team and other community members, download product trials and betas and track development progress.

Helpful Hints For Obtaining Technical Assistance:

Before you contact IBM Software Support, gather the background information that you need to describe the problem. When you describe a problem to an IBM software support specialist, be as specific as possible and include all relevant background information so that the specialist can help you solve the problem efficiently. To save time, know the answers to these questions:

  • What software versions were you running when the problem occurred?
  • Do you have logs, traces, or messages that are related to the problem?
  • Can you reproduce the problem? If so, what steps do you take to reproduce it?
  • Is there a workaround for the problem? If so, be prepared to describe the workaround.

If you have helpful information to diagnose or identify the problem on your system, you can provide this data by following the instructions to exchange information with IBM Technical Support.

Table of Contents:

What's new in
Link Date Released
  • The upgrade included an updated to Liberty which changed the default key type from JKS to PKCS12. In order to keep the old behavior when using https, the server.bat command was updated to force the key type to be JKS when the server is created.

    To use another keytype like PKCS12, the user should ensure that the dmh_keytype environment variable is set to the desired type before running "server create". It can either be temporarily set in the Command Prompt window before running "server create" or it can be stored persistently using the Environment Variables dialog of the Windows System Properties.

    For example, from the \bin directory: set dmh_keytype=PKCS12 server create
What's new in
Link Date Released
  • Existing databases must be migrated to schema level v61022.
What's new in
Link Date Released
  • Added a CRUD matrix tab to the Data set details page that lists the I/O record description used for accessing the data set, and whether the access is for create, read, update, or delete of a record. In addition, it lists the relevant batch job, transaction, run unit, and program.
  • Enhanced the proprietary scanner to capture additional details for an EXEC SQL FETCH statement to include the SQL columns and the corresponding data elements they update, including group items and arrays. To capture this additional information, the program must be analyzed. During impact analysis, this information allows for more complete tracing of the impacts.
  • Updated the postprocessor to always check code review rules when performing analysis so that the results are always available on the Code review tab of the Program summary page.
  • Improved impact analysis accuracy for EXEC SQL FETCH statements in COBOL and PL/I programs. For details about rescanning programs to take advantage of this improvement, see
What's new in
Link Date Released

What's new in
Link Date Released
  • Added the ability for specified users to be able to download a zip file containing a program and its included files. To configure which users have the "Download program and included files as a zip file" action on the Program details page, update the enableDownloadForUsers property in Common.cfg, and restart the application server. By default, the setting allows all RAA administrators to have the new option.
What's new in
Link Date Released
  • On the Impact tree tab of the Impact analysis details page, you can right-click an entry and select Copy impact path to clipboard to update the clipboard with an indented list of the impacts that are loaded to the entry.
  • The z/OS Execution and Run unit diagrams include the tables that support link decks.
  • Automated the process of updating the database with the string constants shipped with the product, if the string constants are more recent.
  • Updated the e-business base table page to separate the COBOL and PL/I statements.
  • Updated the Refresh collections queue type processing to use the new DMH_APPLICATION_REFRESH_TIMESTAMP column to determine whether it is necessary to refresh the collection.
  • Added automatic deleting of unreferenced data sets at the end of Delete asset queue processing. This function can be disabled in Common.cfg by setting deleteUnreferencedDataSets to false and restarting the application server.
  • The Batch Loader supports the following new DEFAULT and CONCAT statements, which can be specified in the input file.
    • DEFAULT – sets default site and/or container type used by subsequent CONCAT requests. On Windows, the CNRTYPE defaults to NTFS. On z/OS, the CNRTYPE defaults to PDS.
    • CONCAT ADD – adds a container to a concatenation set definition.
    • CONCAT DELETE – deletes a concatenation set.
    • CONCAT REMOVE – removes a container from a concatenation set.
    • CONCAT SET – uses a concatenation set at a site, container, file, or application level.
    • CONCAT UNSET – removes the usage of a concatenation set at a site, container, file, or application level.
Please refer to Scanning without the web browser page for more details.
What's new in
Link Date Released
  • On the Batch job details page, when the Included files tab has entries for “Proc used”, the corresponding link will lead to the JCL/Procedure File details page rather than a File summary page.
  • Resolving DB2 table-column relationships that refer to common table expressions has been improved to avoid the creation of spurious data for tables and columns.
  • The asset diagrams are simplified by drawing relationship lines using right angles. A new diagramLinkStyle parameter in the [UI] section of the Common.cfg configuration file determines if mixed style (lines at any angle) or orthogonal style (lines at a right angle) is utilized when you relate assets. The default is orthogonal.
  • Scanning inventory without using the web browser on z/OS via Batch Update has replaced BPXBATCH with JZOS Batch Launcher. The change is implemented to improve usability and flexibility for the following operations:
    • Provide consistent return codes that are the values returned from the Java program.
    • Provide the option for output that can be written to SYSOUT, data set, or USS files without affecting return code processing.
    • Allow Java programs that take a data set as input to use a DD as input.
  • The JCL analyzer provides reasonable non-zero-length strings for a subset of the known Control-M System Variables where RAA can approximate replacement values, for example:
  • Table 1. Non-zero-length strings for Control-M System Variables
    Control-M System Variables Non-zero-length strings
    $CENT CC
    " "
    " "
    "  "
    "   "
    "    "
    "     "
    "      "
    "       "
    "        "
    "         "
    "         "      
    DAY DD
    WDAY D
What's new in
Link Date Released
User interface
  • The Entry point details page contains tabbed results for parameters, batch jobs, CICS transactions, IMS transactions, programs, run units, and user-related assets.
  • The Symbol asset link is added to the Common assets tab on the Home page. Symbol assets automatically show up in search results.
  • Entries for data sets and DB2 stored procedures are added on the Unreferenced assets page. To open the page, click Database > Unreferenced assets.
  • If the BMS map set is used in a program, the corresponding Program details page contains a BMS map definition tab.
  • When DB2 catalog assets are reported in a placeholder WSAA subsystem, irrelevant information is hidden on DB2 summary and DB2 details pages.
  • Table action "Configure scanning options" is available on the Application summary page result table.
  • Site links are provided on CICS and IMS transaction summary and transaction details pages.
  • A References column is added on the Link deck summary page to report the sum of all the batch jobs and transactions that directly use a run unit that is defined by the link deck.
  • The "Working sets" dialog provides a search box for displaying only the working sets that contain the filtering text.
  • The Project collection type is added to the advanced search criteria for filtering on z/OS asset summary pages.
  • File and asset name fields are carried over to the message list on the asset details page, so context is displayed when you view the expanded Analysis Messages section.
  • Informational confirmation messages are displayed when assets are added or removed from the following user-defined collector types:
    • Application
    • Project
    • Working set
  • Invalid RAA database triggers are detected at start-up and reported with severe error messages in the Console, RaaRestWar, and WsaaWar logs.
  • When a user logs on, informational messages are reported in the RaaRestWar log.
What's new in
Link Date Released
User interface
  • Introduced a Create custom query button on the Database > Execute a Query page to simplify capturing an ad hoc query and adding it to the inventory as a custom query. The Custom query wizard opens and guides the creation of a new custom query.
  • Added a Data elements tab to the File details page for files that are type Included source. Defined data elements have a check box for impact analysis, and are highlighted as a hyperlink to the corresponding Data elements details page. The Data element details page displays other data element instances, which are especially useful for data elements that are involved in a COPY statement with the REPLACING phrase.
  • Added an I/O record descriptions tab to the Data set details page to display the I/O record descriptions that are used to access the data set. If no I/O records are involved with the data set, "None" is shown.
  • Established an "Other used data elements defined by the same declaration in the included source file" result table on the Data element details page, which replaces the former "Other programs including the file with this declaration" result table. The new result table highlights the actual data element usage of the same data element in other programs. If there are no usage references for the data element, no result table is displayed.

Impact analysis
Added an Impact tree tab to the Impact analysis project details page. In the Impact tree pane, a hierarchical view of the impacted assets is shown. It is presented as an indented list of nodes that can be expanded and collapsed to reveal or hide assets. The Impact tree page has options and a toolbar to provide the tools that enable you to navigate through and work with the nodes in the tree.

Optimized the performance and scalability of the following functions:
  • Relating data elements to business terms, term properties, or both.
  • Processing a Refresh collections request during postprocessing.

Introduced two new parameters to the Common.cfg configuration file:
  • refreshCollectionsMsgIntervalTime
  • refreshCollectionMsgAllThreshold
In concert, the preceding parameters provide customizable timing and message generation controls that log progress status messages for each Project and Working set collection types that are processed during a Refresh collections request in the Analysis queue.
What's new in
Link Date Released
  • Introduced Advanced search option for finding referenced and unreferenced assets on data set, DB2 table, DB2 view, DB2 stored procedure, online data store, program, and run unit summary pages.
  • Improved readability of summary page list results by using alternating background colors for even and odd rows.
  • The Number of lines in program count is displayed on the Metrics – detailed and Metrics – overview tabs of the Home page, and the Site, Application, Project, and Working set details pages.
  • Comment lines count surfaced on the Metrics – overview tab.
  • Added a Program: field to the "DB2 stored procedure details" page to display a name hyperlink for the implementation program of the DB2 stored procedure.
  • Nonessential I-level messages for Code review were eliminated from the DMH_ACTIVITY_LOG table, which reduces the volume of messages that are not an error or warning. Code review results continue to be reported on the Program summary and details pages.
  • Extraneous stale project messages for Impact analysis were eliminated from the DMH_ACTIVITY_LOG table, which reduces the volume of messages. "Impact analysis project details" page now reports staleness in the Status: field, as necessary.
What's new in
Link Date Released
Inventory and analysis:
  • Introduced language-based SQL concatenation sets for resolution of EXEC SQL INCLUDE statements, such as SQLCA and SQLDA.
  • Established the BATCHTSO control file for handling custom entry point names that are processed as synonyms for IBM's Batch TSO module IKJEFT01.
  • Added COBOL 2002 to the language level options for the COBOL proprietary scanner.
  • Improved IMS™ DBD metadata for capturing and sequencing the DATASET macro DD names, data set groups and DSGROUP parameters, and database access types.
  • Expanded COBOL and PL/I metadata for capturing the general characteristics and editing requirements of data elements, for example, the COBOL PICTURE clause.
  • Improved SQL column to table resolution for multiple table subselects.
Impact analysis:
  • The Data elements tab in the Literal details page now provides selection capability for impact analysis for the 1 – n data elements that are initialized by the literal.
  • In the Set up panel, the JDBC host name was lengthened, which allows the host name field to wrap like the other host name fields on the DMHINSTL panel.
  • Converted DMH_FILE_TO_CONT table to a view.
  • Dropped unused column PROCESSING_TYPE_CD from the DMH_QUEUE_TYPE table.
  • Eliminated obsolete inventory insert, update, and delete triggers for selected asset types.

User interface:
  • Logging control parameters were established in the Common.cfg file. The maximum number of logs in a sequence and the maximum file size for a log can now be customized through the logCount and logLimit parameters, which allows the number of logs and volume of logging messages to be increased for debugging, troubleshooting and other investigative tasks, or reduced for typical analyzing and processing tasks. Logging is visible to administrative users only. The Logs page can be accessed by clicking Database > Logs.
  • The Execute a query page is more forgiving of certain syntax, such as SQL comment lines, trailing semicolons, and WITH UR (uncommitted read) clauses. The Execute a query page can be accessed by clicking Database > Execute a query.
  • Default columns on the Analysis queue summary page were reordered for improved usability.
  • Viewing source file restrictions were lifted in certain scenarios, which ensures more files are viewable. No view source option is available for files of type archive, class, or binary, or if a file is classified as empty or gone.
What's new in
Link Date Released
Inventory and analysis
  • Improved Enterprise COBOL V5.2 syntax support.
  • Enhanced SQL syntax coverage, including DB2 extensions for Oracle applications.
  • The classification scanner and JCL analyzer now tolerate Control-M symbolic parameters that are detected in batch job source files. Control-M symbolic parameters are also known as variables and functions.

Impact analysis
  • Improved tracing analysis of IMS data stores.
  • Introduced a Tracing direction control option on the specifications page of the Impact analysis (IA) wizard. This new option provides users with a mechanism to scope analysis tracing. You can perform analysis tracing in backward, forward, or both directions:
      • Backward analysis to find assets that lead to the IA project starting points.
      • Forward analysis to find assets that are impacted by the IA project starting points.
      • Analysis tracing in both directions to find assets that lead to the IA project starting points and assets that are impacted by the IA project starting points. This is the default setting.

User interface:
  • Introduced the Link deck error rate on the Database > Errors page to display the percentage of link deck files that are in the inventory with a Status of error, as a proportion of the total number of link deck files that have been inventoried.
  • Added a “Link deck errors” page to provide details of the analysis of link decks, including a breakdown by analysis status of the link deck files that have been inventoried.
  • PSB and DBD source containers can now be linked to an IMS subsystem via a user edit action on the “Container details” page, which provides the means to improve PSB resolution from non-binary inputs.
  • PSB and DBD source files can now be viewed via the Show source icon and Actions user option on the “File details” page.
  • Improved performance and scalability of the Rule mining tab on the “Run unit summary” page.
  • Improved performance and scalability of the Code review tab on the “Program details” page.
What's new in
Link Date Released
Collection assets:
  • Established new configuration parameters to provide flexibility for controlling non-administrative users options to create Applications, Projects, and Working sets.
  • A new Refresh collection user action provides the ability to evaluate and reset related asset relationships for a single collection asset on demand and outside of the standard Refresh collections step of Analysis queue postprocessing.

Custom queries:
  • Custom queries now support WITH common table expressions for overall improved efficiency and tolerance for recursive queries.

  • Equipped the Analysis queue summary page with Move first and Move last controls so that a user can raise or lower the priority of a request or requests type within the set of that request type.
  • Introduced advanced options for Run postprocessing for controlling the number of queue requests to process for an instance of analysis queue execution, and to provide additional granularity for debug output.
  • Changed the behavior for queuing assets for deletion so that the postprocessor is not automatically started, which gives the administrator more control over when the deletion occurs.

User interface:
  • Modified the Advanced search criteria on the File summary page to allow multi-select capability for the Language and Type fields.
  • Introduced the Show data flow diagram icon on the Data element details page to illustrate the movement of that data item.
  • Enabled the Other scanning options page for the Collect Inventory wizard for use with the proprietary scanners of RAA to allow SQL options such as QUOTESQL or APOSTSQL to be specified for source file analysis.
  • Enhanced the Program details page for COBOL and PL/I programs to include a tooltip that shows where the various scanning options that affect the program are configured.
  • Included Rule mining information on the Data element, DB2 column, DB2 table, DB2 view, and IMS DBD details pages to provide an easy way to view business term and business term property associations.
  • Added tabs for Run units and Link decks to the Batch job details page to summarize Run units used by the Batch job, and Link decks that define Run units used by the Batch job.
  • Included DB2 table/view information on the Run unit details page to highlight DB2 access for programs that comprise the Run unit.
What's new in
Link Date Released
Custom query actions are now assignable to the summary and details pages for the following asset types:
  • Link deck
  • Project
  • Working set

PL/I program support is enhanced to include:
  • Code review
  • Control flow diagram
  • Metrics

Performance improvements have been implemented for Run unit building and JDBC connection concurrency.

Rule mining information tabs have been introduced for Program and Run unit summary pages for Rational Asset Analyzer for System z.
What's new in
Link Date Released
Inventory functionality enhanced
  • The import file load performance has been improved.

User interface enhanced
  • Support was added for user-defined Project and Working set assets.
  • The Count, Summary and Detail pages have been modified to render metadata about the z/OS Binder control statements gathered during Link deck file analysis.
  • The user profile details page allows default configuration for summary page filtering by Working set(s).
  • The Batch job, Dataset, File and Program Summary pages now allow mass deletes.
  • User ID handling has changed. After connecting to the database, RAA queries DB2 for the current user name. The current user name is then utilized for the USER_NAME column in the DMH_USER table. So, while you may log into RAA as myuser, DB2 will return it as MYUSER, and the USER_NAME column in the DMH_USER table will be MYUSER. This will be visible to the current user in the upper right-hand corner of the RAA web browser interface.
What's new in
Link Date Released
Inventory functionality enhanced
  • The classification and analysis scans have been modified to recognize and store metadata from files that contain zOS Binder control statements. Metadata from the ALIAS, ENTRY, INCLUDE, MODE and NAME statements is captured and used when building run units.
User interface enhanced
  • The inventory wizard has been modified to allow DB2 catalog reporting and scanning.
  • The inventory wizard has been modified to allow local file imports which get processed by a general import file loader regardless of their RAA import file format.
  • Shortcut icons were added for the view source, delete and annotation functions.

In addition to the above, the following is new for Rational Asset Analyzer for System z:

Eliminate the need for DB2 application binding
  • All metadata database access has been modified to use JDBC connections, eliminating the need to BIND or re-BIND the application's executables at installation time or after updating the database catalog statistics.
What's new in
Link Date Released
What's new for Rational Asset Analyzer:

Business rule mining functionality enhanced
  • The program summary rule mining tab information is now rolled up on the run unit summary page.
  • When relating statement to a new business rule, the statement's source text is automatically captured in the rule's description.

Eliminate the need for DB2 application binding
  • All metadata data base access has been modified to use JDBC connections, eliminating the need to BIND or re-BIND the application's executables at installation time or after updating the data base catalog statistics.

Inventory functionality enhanced
  • The analysis queue process can now be stopped via the user interface.
  • The auto-concatenation build is changed to eliminate the ambiguous concatenation set error by choosing the smallest set of known containers that satisfies the required copybooks requested.

What's new for Rational Asset Analyzer for System z:

Business rule mining functionality enhanced
  • When relating statement to a new business rule, the statement's source text is automatically captured in the rule's description.

Inventory functionality enhanced
  • The analysis queue process can now be stopped via the user interface.
What's new in
Link Date Released
Security enhancement
All password fields are stored using AES-128 encryption.

Trial version
The IBM Rational Asset Analyzer Trial for Windows version is available for download and includes a
temporary license.
What's new in
Link Date Released
Expanded annotation text
The metadata column that stores annotation text is now increased to allow annotations up to 32,000 characters.

Performance improvements for case-insensitive searches
The metadata columns for text in the container, file, symbol, and literal tables are now supplemented with an additional column that displays uppercase characters.

Support for long user IDs
All references to a user in the metadata are now modified from an eight character column to an integer column. This integer column identifies a particular user's name by the user's login id. This name can now be up to 128 characters long. The integer column is a foreign key to the DM_USER table
What's new in
Link Date Released

JCL scanner improvement
The JCL scanner now supports multiple in-stream PROCs with the same name.
Support for the Apache-based IBM HTTP Server
In addition to the Domino-based IBM HTTP Server V5R3, Rational Asset Analyzer now supports the Apache-based IBM HTTP Server V8.5. For more information, see Configuring the IBM HTTP Server.
Batch refresh of user-defined relationships
The "Data integrity check" request that appears in the "Inventory collection requests in progress" list on the "Analysis queue" page now refreshes stale user-defined relationship rows. For more information, see Inventory process requests. Also, see the see the RATLC02830118 request for enhancement at

Qualified node names in diagrams
Diagrams now show qualified node names for names that are ambiguous.

Upgraded support for WebSphere® Application Server Liberty Profile
The embedded application server included with Rational Asset Analyzer is now implemented using the WebSphere Application Server Liberty Profile V8.5.5.1.

User interface displays the number of key assets in the database
In each page footer of the Rational Asset Analyzer user interface a widget displays the number of key assets in the database. The key assets are:
  • CICS® transactions
  • DB2® tables
  • DB2 views
  • Data sets
  • Files
  • IMS™ segments
  • IMS transactions

What's new in
Link Date Released
No new improvements.
What's new in
Link Date Released
No new improvements.
What's new in
Link Date Released
CICS incremental load
The CICS CSD resource C-based loader is replaced with a Java-based loader which performs an incremental load of only those assets that have been added, changed or deleted - significantly reducing load time. For more information see the RATLC02613204 request for enhancement at

CRUD matrices for IMS data stores
A new "Data store summary" page Action link is added to render an IMS CRUD matrix.

Default the Dojo locale to that of the application server
The application server now sets the Dojo widget's default locale.

Make DMHINSTL Setup option prompt for Java™ home directory
The installation wizard now prompts for the Java home directory.

Option to ignore copy book names beyond eight characters
A new Common.cfg property is added enabling trunctation of ++INCLUDE names before locating include member. For more information see the RATLC02662551 request for enhancement at

REST support export of HTML tables as CSV
REST requests made with contentType=html now allow the results to be exported to a CSV file.

Reuse run unit nodes in transaction diagrams
The transaction diagram is simplified by reusing run unit asset nodes.

Source view window
Scalability performance enhancements are made to the source view window.

Support CICS, DB2, and IMS scanning from the Collect inventory wizard
Remote z/OS® CICS, DB2 and IMS scanning support is added to the inventory wizard.
What's new in 6.1
Link Date Released

Improvements in infrastructure and installation options on Microsoft Windows
  • You now have the option to use an embedded application server instead of IBM WebSphere Application Server. Rational Asset Analyzer (RAA®) embeds an application server, WebSphere Application Server Liberty profile This is an optional use, lightweight application server.
  • Rexx is no longer a mandatory prerequisite. RAA now embeds Open Object Rexx 4.0.1. If a version of Open Object Rexx was previously installed on the system and is not otherwise needed, it can be uninstalled.
  • Java is no longer a mandatory prerequisite. RAA now embeds the Java Runtime Environment.

Code review for COBOL
  • Enables you to monitor various COBOL program coding standards.
  • Complements the Code Review for COBOL feature available in IBM Rational Developer for System z®.
  • Configuration using properties set in the CodeReview section of the RAA Common.cfg file.
  • Activation using the Show control flow diagram or View dead code action link for a given COBOL program.
  • Nineteen built-in rules.
  • Rule results persist in the database as properties of the program.
  • The Code review tab on the "Program details" page, summarizes the rule results and links to the "Related source view" window to review results.
  • For more information, see Code Review for COBOL.

Scanning and analysis
  • DB2 V9 and V10 SQL syntax support for the COBOL and PL/I compiler-based scanners. For more information see the RATLC01995663 request for enhancement at
  • Hash sum-based incremental analysis on Windows. RAA detects if a file has been modified since the last analysis. If it has not changed, the file is skipped during inventory collection, unless the Force rescan check box is selected, thereby reducing processing time by avoiding unnecessary analysis and database updates.

Export capability
  • Export for the current diagram view or the entire diagram as SVG for Internet Explorer 9 and 10. A new toolbar button is available for exporting the entire diagram or only the viewable area as an SVG file.
  • Export of user interface tables to CSV. For more information see the RATLC02649553 request for enhancement at

User interface
  • As an administrator you can now use the Logs menu choice on the Database drop-down menu to easily find and review the logs produced by RAA.
  • The ImpactAnalysisFramework log has been eliminated. All relevant messages formerly targeting the ImpactAnalysisFramework log are now written to the ImpactAnalysis log file.

[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SS3JHP","label":"Rational Asset Analyzer"},"Component":"Documentation","Platform":[{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"6.1;;;;;;;;;;;;;;;;;;,,,;;","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}},{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSHSRW","label":"Rational Asset Analyzer for System z"},"Component":"Documentation","Platform":[{"code":"PF035","label":"z\/OS"}],"Version":"6.1;;;;;;;;;;;;;;;;;;,,,;;","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]

Document Information

Modified date:
31 January 2020