IBM Rational Application Developer for WebSphere Software, Version 7.0 Release Notes

Contents

1.0 About this release
   1.1 New in this release
   1.2 Discontinued function
2.0 Installation information
   2.1 Hardware requirements
   2.2 Software requirements
3.0 Known limitations, problems, and workarounds
4.0 IBM Rational Software Support
5.0 Notices and trademarks

1.0 About this release

You can use IBM^® Rational^® Application Developer for WebSphere^® Software to quickly design, develop, analyze, test, profile, and deploy high-quality Web, service-oriented Architecture (SOA), Java^™, J2EE, and portal applications.
Built on Eclipse 3.2.1, an extensible platform for constructing and integrating software development tools, Rational Application Developer is part of the Rational Software Development Platform series of products.

Rational Application Developer for WebSphere Software, Version 7.0 contains new features and enhancements and fixes to Version 6.x releases.

The latest version of this document is available at http://download.boulder.ibm.com/ibmdl/pub/software/rationalsdp/v7/rad/70/docs/readme/readme.html.

Additional updates about limitations and problems can be found in the form of individual technotes in the Support knowledge base at http://www.ibm.com/software/rational/support/. As problems are discovered and resolved, the IBM Rational Support team updates the knowledge base. By searching the knowledge base, you can quickly find solutions or workarounds to problems.

This file is available in the following national languages:

Brazilian Portuguese	Czech	French	German
Hungarian	Italian	Japanese	Korean
Polish	Russian	Simplified Chinese	Spanish
Traditional Chinese

1.1 New in this release

This release of Rational Application Developer contains enhancements to version 6.x releases and new features, including:

• JavaServer Faces, Site designer, and Page designer
  • New AJAX support in JavaServer Faces framework: New tools make it easier for you to develop Ajax applications in the Faces framework. New Ajax components include:
    • inputTypeAhead
    • ajaxRefreshRequest
    • ajaxSubmitRequest
    • ajaxExternalRequest
  • Support for standard JSF mode only: You can now design pages that use only standard JavaServer Faces tags and features. In the standard JSF mode, the IBM components are not used.
  • New JSF components: You can now take advantage of many new JSF components, including the following components:
    • requestLink
    • requestRowAction
    • selectOneColor
    • progressBar
    • panelFormBox
    • inputMiniCalendat
    • panelSection
    • panelMenu
    • dataIterator
    • panelDialog
  • Support for third party JSF tags in the JSP: Third party JSF tags are now recognized by Properties view and JSF Validator. The tools attempt to render their appearance at run time.
  • Dynamic page templates: You can now create pages with templates applied dynamically on the server. You create the template and instance pages with wizards, and you edit the content areas in the editor.
  • Struts Tools:
    • Updated Struts tools to work with the new Web Diagram Editor.
    • Support for Struts version 1.1.
    • Performance and memory footprint improvements.
• Improved Web security tools: Significant tooling for J2EE security makes it easier to create, assign, integrate and test the application's security requirements.
• Improved Web Diagram editor: Enables you to quickly create Web applications by diagramming Web pages and their associated links and automated flow-logic. You can integrate relational data and Web services into Web pages by dragging and dropping. You can now directly manipulate artifacts such as creating and renaming web pages and updating relevant configuration files. The tool auto-generates page content based on the links or page commands, enabling you to quickly produce applications for prototyping.
  • New look and feel:
    • More intuitive and usable user interface
    • More consistent GMF-based look and feel
    • Usability improvements
    • Improved auto-layout and connection routing
  • Direct manipulation of underlying artifacts: As you work in the Web Diagram Editor, the editor now keeps your Web application artifacts (Web pages, configuration files, etc.) synchronized with your Web Diagram.
  • More informative nodes: The Web Diagram Editor now displays some of the significant internal structure of the nodes. For example, a Web page now shows the links that it contains and the data that it accesses.
  • Data integration:
    • From within the Web Diagram Editor, you can now create Web applications that query and manipulate data objects and data lists.
    • You can add UI components to Web pages to query and manipulate data objects and data lists without having to explicitly edit each page.
    • The Web Diagram Editor displays the data objects and data lists that each Web page accesses.
• Unit testing with WebSphere^® Application Server Version 6.1: Fully integrated WebSphere Application Server Version 6.1 environment embedded in the product.
• Portal and portlet development: New features and enhancements include support for the JSR 168 standard, cooperative portlets, and wizard enhancements.
  • JSR 168 portlet support for WebSphere Application Server 6.1: The portlet tools now support developing, testing, and debugging portlets based on the JSR 168 specification. "Empty" and "Faces" portlets are supported.
  • Business Process portlet: With business process supported, you can create a process and handle the process flow using two main types of portlets: initiation portlets and task portlets.
  • Cooperative portlets enhancements: A new wizard helps you to develop portlets that exploit portlet cooperation. The wizard generates a complete guide in HTML format that is tailored to your selections in the wizard. The guide provides best practices and code examples for enabling the portlet for cooperation. You can cut and paste or follow the steps in the guide. You can see cooperative action and data type information in the Project Explorer.
  • Portal 6 support:
    • The edit_defaults portlet mode is supported.
    • WebSphere Portal 6.0 target runtime is provided.
    • Migration from IBM portlet to JSR 168 portlets (config files only) is supported.
  • Improved wizard for creating portlet projects: You can use a single wizard for portlet and API selection. The wizard determines supported APIs and types based on the target runtime that you select. The wizard also indicates supported portlet modes based on your selected runtime, API, and type.
• Java and XML Web Service Tool Enhancements
  • Simplified wizards to enable easy creation of bottom-up and top down Web Services allowing simple control with less clutter to develop, assemble, deploy, install, run and test your service and client.
  • Improved XML Schema Editor has enhanced its graphical visualization to provide a 'type-oriented' view of an XML Schema. A type is displayed as a box-like figure. If the type contains elements and attributes, these are listed as fields within the box.
  • Allow greater control while simplifying Web service and client generation. You can generate clients and services without necessarily requiring a server to be configured and started.
  • Enhanced preferences are available to optimize Web service development on WebSphere Application Server v6.1.
  • WSDL validation has been integrated into the Web service (top-down) and client wizards.
  • A JAX-RPC Java class analyzer has been integrated into the Web service (bottom-up) wizard for Apache Axis and WebSphere Web services.
  • Support for merging the new skeleton created by the Web services wizards with any previous skeletons in an effort to preserve your existing code in the skeleton.
  • The JAX-RPC/JSR-109 handler configuration wizard for WebSphere Web services and clients has been enhanced to configure a handler over multiple Web services or clients if desired.
  • Web services can now be secured using a wizard that allows you to easily enable integrity, confidentiality, and authentication.
  • You can copy security configurations from one Web service to another.
  • A new extensible Ant task, "wsgen.xml", and an associated batch/shell script, are provided to allow you to generate Apache Axis and WebSphere Web services (top-down or bottom-up) and Web service clients in a headless fashion.
  • Support for XML attributes. Form fragments are rendered for attributes based upon their (simple) types in essentially the same way as for simple typed elements.
  • Support for nillable elements (elements declared in XML Schema with attribute xsd:nillable="true"). Form fragments for nillable elements are characterized by the presence of a "Nil?" checkbox. When selected, the WSE will serialize the corresponding element with the "xsi:nil" attribute.
  • The Web Services Explorer and the IBM WebSphere UDDI Private Registry configuration wizard have been enhanced so that you no longer need to tell the Web Services Explorer that you are connecting to a Private Registry. Private registries, their publication and discovery URIs, and any custom taxonomies are all automatically loaded into the Web Services Explorer.
• Improved XML Schema editor
  • Support for multiple view modes in the XML Schema editor: A view mode drop down box is visible at the top right of the XML Schema editor to enable you to switch between the simplified and detailed views. The simplified view hides many of the complicated XML schema constructs so you can create XML data structures that conform to best practice authoring patterns. The detailed view exposes the full set of XML schema constructs so you can create XML data structures using any authoring pattern.
  • Support for rename refactoring: There is inter-file refactoring in addition to preexisting intra-file refactoring support. This means that if you rename a complex type, any references to it from other schemas in the current project or workspace will be updated.
  • Search for component references: XML Schema allows named components (such as elements and types) to be referenced. A search view will now display the locations in your workspace where the component is referenced.
  • Browsing for types and elements: You can select a browse action to invoke the new Set Type dialog where you can choose a type from the current schema, or any schema in the current project or workspace. Once you've chosen the type, and if it belongs to an external schema, an import will be automatically added for you. Similarly, you can browse for elements when editing element references.
  • Property sheet enhancements: You can restrict built-in simple type values, add enumeration and pattern facets, and add specialized extension information to your schemas via the extensions tab.
  • Support for XML Schema Validator: The default Eclipse XSD-based XML Schema Validator is based on the Eclipse XSD model. Adopter products are free to include their own alternative validators.
  • Navigation enhancements: Navigate across type references by drilling down. Use the workbench's navigational framework to switch back and forth between contexts. The design view is enhanced to support viewing in various zoom modes.
  • Drag and drop enhancements: You can drag elements from a model group to another model group within the same complex type or to some other complex type in the design view.
• New XML Mapping process: Mapping is done by graphically connecting elements from source to target documents using simple drag-and-drop operations. XSL code is automatically generated to produce the desired document transformation based on the mapping information. A useful set of built-in transformation functions are available and can be extended by using custom XPath expressions and XSLT templates.
  • New Inline Map: Transform complex documents by recursively breaking them down into smaller pieces.
  • New Submap: Create a reusable sub-map which can be referenced each time the transformation of the Schema type is required.
  • Support for custom code: Built-in transformation functions can be extended using external XSLT Template files. A custom XPath expression can also be used to modify the parameter values before these are passed to the template.
• New support for SIP Applications: The Session Initiation Protocol (SIP) Tools Feature provides a development environment for the creation of new SIP-based services. The feature provides tools to develop and export JSR 116 SIP Servlets, including wizards to create SIP Servlets
• New data specific projects provided by data tools
  • New data specific projects:  These new project types are displayed in Data Project Explorer and include SCM support for sharing:
    • Data development project for creating and storing database objects such as routines and SQL statements
    • Data design project for data modeling
  • New physical data modeling functionality:
    • Store physical data models in data design projects
    • Analyze model
    • Editing via data diagram, Properties view, Data Project Explorer
  • New features for managing database changes
    • Compare and sync with compare editor (customized for data objects)
    • Impact Analysis
  • New data management features:
    • Table data edit
    • Data extract and load
  • XML support (for DB2^® LUW V9):
    • Register XML schemas
    • XML document validation
    • AXSD (Annotated XSD) editor
    • Support for XML data type
  • New databases supported:
    • DB2/LUW V9
    • SQL Server 2005
    • Informix/IDS V10
    • Sybase V15
    • Derby V10.1
  • Enhancements for deployment of routines:
    • Deploy to unlike servers
    • Binary deploy
  • Stored procedure debug enhancements: Support for Java stored procedure debugging.
• J2EE Connector (J2C) tools and support: Provide a robust set of tools to help you create J2C client applications for CICS^® and IMS^™ systems. Use the data binding wizards to create Java marshalling code for COBOL, PL/I, and C languages:
  • New PL/I support: J2C now supports the PL/I language, along with COBOL and C, for creating enterprise applications that connect to a CICS or IMS system. Available for the Windows^® platform only, now you can create Java data binding beans that marshal PL/I data structures.
  • J2C session recording: When you create Java beans and data bindings using the J2C wizards, you can now save the settings in an Ant file. You can then invoke the Ant script inside the workbench or from the command line to generate J2C Java beans and data bindings.
  • Exposed interaction and connection specifications properties support: Exposing your interactionSpec and connectionSpec properties is a common task that has now been made extremely easy with the addition of a new page in the Add Method and Edit Method wizards. You can interactively choose which fields you want to externalize, and modify the input argument names to be used on the method.
  • Faces JSP support: With the addition of the J2C Java bean palette entry in Page Designer, you can now add J2C Java beans to a Faces JSP from Page designer's palette. Simply drag and drop the J2C Java bean onto the Faces JSP page, and select the method and data elements you want to create controls for.
• Debug tools
  • New Debugger for WebSphere Jython scripts: A full-function debugger for WebSphere administrative scripts written in Jython. Typical debugger functions are available such as breakpoints, stepping, variable inspection and watch expressions.
  • Support for DB2 V9: Stored Procedure debugging is supported on DB2 V9.1 Linux^®/UNIX^®/Windows, DB2 V9 z/OS^® and DB2 iSeries^™ V5R4. Java Stored Procedures are now supported in addition to SQL Stored Procedures.
  • New "Show Running Threads" filter: When debugging WebSphere applications there are typically dozens of running threads, most of which are not interesting or useful for problem determination. To only show threads that are suspended, right-click the debug target and toggle the Show Running Threads filter.
  • Ability to step into JVM classes: Step Filters for java.* and javax.* are now visible in the Step Filters preferences.
    Note: Step Filters determine the classes the debugger will ignore while stepping. This feature lets you step around in your application code without landing in WebSphere runtime or other system classes. In previous releases, the java.* and javax.* classes were always filtered and not configurable.
  • New check for invalid XSL Breakpoint locations: There are several places in XSL files where breakpoints have no effect. Attempts to set breakpoints at the following XSL file locations will now result in an "invalid breakpoint location" message:
    • blank line
    • comment line
    • <xsl:stylesheet> line
    • <xsl:output> line
    • XML declaration such as <?xml version="1.0">
      Note: If there are other valid tags on the same line as the elements above, a breakpoint is allowed.
  • Column Support in Variables View: The Variables View now provides a column layout for structured display of variable information. While stepping, variables that change value are high-lighted and shown with a different icon.
    Note: To toggle the Column Layout, use Layout > Show Columns from the Variables view pull-down menu.
• New user assistance features:
  • Contextual and dynamic help: Eclipse now provides a dynamic help view where you can find context-sensitive help and related topics for any active area in the development environment. By clicking the question mark icon in a dialog box or wizard, or by pressing a platform-specific trigger key on the keyboard in any context, you can open the Help view.
    This new view gives you a way to navigate and search the help topics, even when you are in a modal dialog box or wizard, by presenting the Help view in an attached fly-out pane. You can see context-sensitive help and related topics links, as well as read all the help topics while you are completing the current task.
    Although the yellow infopops supported in previous versions of the product are still available, seeing the information in context along with search and index options allows you better access to the information you need when you need it.
  • Dynamic search: Now you have a fast and easy way to search virtually all the user assistance in the product to find exactly the type of information you need at any time.
    Open the search pane of the Help view by clicking Help > Search or by clicking the Search icon at the bottom of the Help view. From here, you can run a centralized search of the help topics, the Welcome pages, and the Tutorials and Samples galleries to find conceptual information, detailed help topics, or tutorials and samples to help you to understand and use product features.
    You can set the dynamic search to return Web hits from sites such as eclipse.org and developerWorks^®.
  • Indexed help: Product help topics are now indexed. Open the new Index tab in the Help window and scroll to find topics, or start typing in the top field to have the index automatically locate the term you want. Similarly, in the Help view, click the Index icon at the bottom of the view to open the index pane.
  • Improved access to tours and tutorials: In addition to the Watch and Learn, and Do and Learn tutorial types from earlier releases, you can now find tutorials from IBM developerWorks in the Tutorials Gallery. Another addition to the Tutorials Gallery is the Tours section, which contains a broad range of conceptual tours.
  • Improved access to samples: In addition to the technology and application samples you have become familiar with, you now have samples from IBM developerWorks into the Samples Gallery. Look in the developerWorks samples section of the gallery table of contents.
  • New RSS in the Welcome: Really Simple Syndication (RSS) provides dynamic links to the latest product and technology white papers and other new postings on IBM developerWorks. Check for RSS feeds on the Web Resources page of the Welcome.

1.2 Discontinued function

The following is a list of discontinued function in version 7.0:

• Active Script debugger
• RDB to XML mapping editor
• The following application analysis and developer testing functionality was removed:
  • Line-level code coverage
  • Component test
  • Method-level call graph
  • Leak Analysis
• WebArt Designer
• IBM DB2 v9 is no longer included with the product. As an alternative, you can download DB2 Express C at: http://www-306.ibm.com/software/data/db2/express/.

2.0 Installation information

For information about installing Rational Application Developer Version 7.0, including hardware and software requirements, see the Rational Application Developer Installation Guide (install.html) which can be viewed from the installation launchpad.   This file is also stored in the documentation directory on the first product CD.

The latest version of Installation Guide is available at http://download.boulder.ibm.com/ibmdl/pub/software/rationalsdp/v7/rad/70/docs/install_instruction/install.html

For updated documentation on commands for running Installation Manager in silent mode, refer to the Installation Manager online help.

Note the following changes and corrections that might not be available in the translated version of the Installation Guide:

• The instructions for extracting the Packaging Utility are incorrect in translated versions of the Installation Guide. Correct instructions are available in the Packaging Utility limitations, known problems, and workarounds file.
• Instructions for silently installing the Installation Manager are not available in translated versions of the Installation Guide. Correct instructions are available in the Installation Manager limitations, known problems, and workarounds file.
• To install Crystal Reports Server on Linux, you must use a non-root user ID.
• The installation guide lists incorrect paths for the default shared resources directory and the default directory for the package group. The correct default directories are:
  • For the shared resources directory, the default locations are C:\Program Files\IBM\SDP70Shared on Windows and /opt/IBM/SDP70Shared on Linux.
  • For a new package group, the default locations are C:\Program Files\IBM\SDP70 on Windows and /opt/IBM/SDP70 on Linux.
• When starting an installation of WebSphere Portal version 5.1.0.x test environment on Linux from the electronic image, you might receive a ":bad interpreter : no such file or directory" error. To start the installation successfully, change to the directory of the setup disk image and then run the following command: dos2unix install.sh -W dependency.useValidation=false

2.1 Hardware requirements

For information about hardware requirements for installing Rational Application Developer, see the Installation Guide.

2.2 Software requirements

For information about software and browser requirements for installing Rational Application Developer, see the Installation Guide.

Note the following updates which might not appear in translated versions:

• To extend an existing Eclipse integrated development environment (IDE), you must have Eclipse version 3.2.1 with the latest updates from eclipse.org.
• If you use SUSE Linux Enterprise Server (SLES) Version 9, then you must have the IBM JRE 1.5 (SR3) installed before you can extend an existing Eclipse IDE.
• The launchpad does not support Mozilla 1.6; if your browser is Mozilla, you need version 1.7 or higher to run the launchpad.

3.0 Known limitations, problems, and workarounds

These release notes include release-specific information, such as such as known limitations, problems and workarounds that were not available until after the product documentation was finalized.

• Agent controller
• Compare/merge
• Crystal Reports Toolkit
• Data tools
• EJB mapping tools
• IBM Installation Manager
• J2EE connector (J2C) tools
• J2EE and Web debug tools
• J2EE tools
• JavaServer Faces
• Java domain modeling
• JET authoring
• Generic log adapter
• Log and trace analyser
• Packaging Utility
• Portal and portlet tools
• Rational ClearCase^® server
• Rational Unified Process^® (RUP^®)
• Reusable Asset Specification support
• Software Development Platform core
• Struts tools
• Struts portlet
• Testing and publishing (server) tools
• Transformation authoring
• UML Modeler
• UML modeling and visualization
• User assistance
• Web services
• WebSphere Application Server Express 5.1.1
• WebSphere Application Server 6.1
• WebSphere Community Edition
• Web tools (Web diagram editor, page designer, Web site designer)
• XML transformations
• XML visual editor

4.0 IBM Rational Software Support

IBM Rational Software Support provides you with technical assistance.

For contact information and guidelines or reference materials that you will need when you require support, read the IBM Software Support Handbook.

For FAQs, lists of known problems and fixes, and other support information, visit the product support page for Rational Application Developer at www.ibm.com/software/awdtools/developer/application/support/index.html.

For product news, events, support, and other information, see the Rational Application Developer home page at www.ibm.com/software/awdtools/developer/application/.

Before you contact IBM Rational Software Support, gather the background information that you will need to describe your problem. When describing 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.

5.0 Notices and trademarks

© Copyright IBM Corporation 2000, 2006. All Rights Reserved.
© Copyright Business Objects Software Limited 2006.

This information was developed for products and services offered in the U.S.A. IBM may not offer the products, services, or features discussed in this documentation in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service.

IBM may have patents or pending patent applications covering subject matter described in this documentation. The furnishing of this documentation does not give you any license to these patents. You can send license inquiries, in writing, to:

IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk, NY 10504-1785
U.S.A.

For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to:

IBM World Trade Asia Corporation
Licensing
2-31 Roppongi 3-chome, Minato-ku
Tokyo 106, Japan

The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OR CONDITIONS OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you.

This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice.

Any references in this information to non-IBM Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk.

Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact:

Intellectual Property Dept. for Rational Software
IBM Corporation
3600 Steeles Avenue East
Markham, Ontario
Canada L3R 9Z7

Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee.

The licensed program described in this documentation and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement or any equivalent agreement between us.

Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained in other operating environments may vary significantly. Some measurements may have been made on development-level systems and there is no guarantee that these measurements will be the same on generally available systems. Furthermore, some measurements may have been estimated through extrapolation. Actual results may vary. Users of this document should verify the applicable data for their specific environment.

Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products.

All statements regarding IBM's future direction or intent are subject to change or withdrawal without notice, and represent goals and objectives only.

This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples may include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental.

Trademarks and service marks

The following terms are trademarks of the IBM Corporation in the United States or other countries or both:

• AIX
• CICS
• ClearCase
• Cloudscape
• DB2
• DB2 Universal Database
• developerWorks
• IBM
• IMS
• iSeries
• Passport Advantage
• Rational
• RUP
• WebSphere
• z/OS

Java and all Java-based trademarks are trademarks of Sun Microsystems, Inc. in the United States, other countries, or both.

Microsoft and Windows are trademarks of Microsoft Corporation in the United States, other countries, or both.

UNIX is a registered trademark of The Open Group in the United States and other countries.

Linux is a registered trademark of Linus Torvalds in the United States, other countries, or both.

Other company, product, or service names may be trademarks or service marks of others.