|
|
 Copyright © 2003, 2004, Oracle. All rights reserved. | Cookie Preferences | Ad Choices. |
|
|
Oracle® JDeveloper Application Migration Assistant Release Notes
Release 1.2.0 Part No. B13979-01 |
|
Copyright © 2003, 2004, Oracle. All rights reserved.
Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners.
Application Migration Assistant Release Notes
Release 1.2.0
Part No. B13979-01
May 2004
This document contains the following topics:
Our goal is to make Oracle products, services, and supporting documentation accessible, with good usability, to the disabled community. To that end, our documentation includes features that make information available to users of assistive technology. This documentation is available in HTML format, and contains markup to facilitate access by the disabled community. Standards will continue to evolve over time, and Oracle is actively engaged with other market-leading technology vendors to address technical obstacles so that our documentation can be accessible to all of our customers. For additional information, visit the Oracle Accessibility Program Web site at
http://www.oracle.com/accessibility/
Accessibility of Code Examples in Documentation
JAWS, a Windows screen reader, may not always correctly read the code examples in this document. The conventions for writing code require that closing braces should appear on an otherwise empty line; however, JAWS may not always read a line of text that consists solely of a bracket or brace.
Accessibility of Links to External Web Sites in Documentation
This documentation may contain links to Web sites of other companies or organizations that Oracle does not own or control. Oracle neither evaluates nor makes any representations regarding the accessibility of these Web sites.
Oracle JDeveloper Application Migration Assistant (Application Migration Assistant) Release 1.2.0 is a tool that helps you migrate an application. You use Application Migration Assistant to identify source code statements that require modification to run on the Oracle platform. Application Migration Assistant is an extension to Oracle JDeveloper 10g version 9.0.5.2 (JDeveloper). You can download JDeveloper from Oracle Technology Network (OTN) at the following Web site:
http://otn.oracle.com/products/jdev/index.html
|
Note: An error in the Application Migration Assistant online help states the Oracle JDeveloper 10g version as 9.0.5.1. However, the correct version is 9.0.5.2, as stated in this document. |
Application Migration Assistant helps you reduce the time, risk, and financial barriers associated with migrating application layers to the Oracle platform. You use Application Migration Assistant to identify, analyze, and track the status of application migration issues to support your migration. You can customize Application Migration Assistant to suit your requirements and development environment.
This document outlines how to install Application Migration Assistant. It also provides workarounds to known issues. For more information about this tool, see the Application Migration Assistant online help accessible from within the product.
This section describes new features of Application Migration Assistant Release 1.2.0 and provides pointers to additional information:
Compatible with Oracle JDeveloper 10g version 9.0.5.2
Application Migration Assistant is now upgraded to work with Oracle JDeveloper 10g version 9.0.5.2.
New Rule Name Attributes
There are several new attributes for the rule name element in the search rules file template. These include helpurl, stringliteral, and casesensitive attributes. For more information about these attributes, see the Application Migration Assistant online help.
|
Note: If you are running the Application Migration Assistant on a UNIX platform, you must use Netscape Communicator to display the help URL that you specified in thehelpurl attribute.
|
Improvements to the Default Search Rules File
Application Migration Assistant default search rules file, Oracle Search Rules for SQL Migrations, has been improved. It now includes the searching capabilities for embedded string literals to reduce false positives when analyzing embedded SQL applications. It also has added support for generic ODBC and OLEDB interfaces.
Updates to the Search Rules Exchange Web Site
Oracle provides a central repository for search rules files that extend the migration capabilities of Application Migration Assistant. New search rules files are added to the Web site regularly. You can also create your own search rules files using the template that is provided. For more information about creating search rules files, see the Creating an Oracle JDeveloper Application Migration Assistant Search Rules File white paper at the following Web site:
http://otn.oracle.com/tech/migration/ama/docs/ama_searchrules.pdf
The template and search rules files are available for download from OTN at the AMA Search Rules Exchange Web site:
http://otn.oracle.com/tech/migration/ama/exchange/exchange.html
Prior to installing Application Migration Assistant, you must have installed JDeveloper. For more information about installing JDeveloper, see the OTN Web site at:
http://otn.oracle.com/products/jdev/index.html
You have the following options when installing Application Migration Assistant as an extension to JDeveloper:
To manually download and install Application Migration Assistant, do the following:
Download the Application Migration Assistant extension JAR file, ama.jar, from the following Web site:
http://otn.oracle.com/tech/migration/ama/index.html
To download the ama.jar file, do the following:
From the Web site, click Oracle JDeveloper Application Migration Assistant link in the Downloads section.
Read the Oracle Technology Network Developer License Terms, then click I Agree.
Complete the Application Migration Assistant Download Survey.
Right-click the Application Migration Assistant extension file link from the Installing Application Migration Assistant Manually section, then choose Save Target As.
The Save As dialog box appears.
Browse to the location where you want to save the file.
In the File Name field, enter ama.jar as the file name, then click Save.
|
Note: The ama.jar file is automatically saved as an ama.zip file. |
Click Close.
Shut down all instances of JDeveloper.
Copy the ama.jar file into the following directory, where jdev_install is the location of JDeveloper:
jdev_install\jdev\lib\ext
Restart JDeveloper.
You now have access to Application Migration Assistant.
To automatically download and install Application Migration Assistant, do the following:
From the JDeveloper main menu, select Help | Check for Updates.
The Check for Updates wizard automatically appears.
From the Welcome page, click Next.
Enter your OTN user name and password or obtain an account by clicking the Get a free OTN account link.
Click Next.
Select Application Migration Assistant extension from the Available Updates list, then click Next.
From the AMA Extension Update License Agreement page, read the agreement, then click I Agree.
Application Migration Assistant Extension is uploaded to JDeveloper.
Click Finish, then Yes.
You are automatically exited from JDeveloper.
Restart JDeveloper.
You now have access to Application Migration Assistant.
To report a bug, refer to the Online Support page within the product.This section contains the following topics:
The following are known issues with this release of Application Migration Assistant:
Bug 3261986 – Certain File Types Cannot be Loaded or Analyzed by AMA
Certain non-native file types cannot be loaded into a project on UNIX platforms. Therefore, Application Migration Assistant cannot analyze these file types. The following exception occurs when you attempt to analyze the file:
sun.io.Bye.ToCharUTF8.convert exception from oracle.mtg.sqllocator.addin.tag.TagfinderObject
This issue relates to how JDeveloper opens non-native files on UNIX platforms. Application Migration Assistant supports analysis of certain file types, for example, .xls as these may contain native Visual Basic applications. The file types that are impacted by this bug are .doc, .pdf, .dll, and .exe. This issue does not occur with native Windows JDeveloper.
Solution
Do not include non-native binary file types when you are adding your application files to a project. Add application files to a project. For more information about adding a file to a project, see the Application Migration Assistant online help.
Bug 3303375 - Unable to Remove Annotations if Rule Name Has a Trailing Space
If the Rule Name element has a trailing space in the search rules file, the remove annotations option does not work.
Solution
Ensure that the Rule Name element does not contain a space at the beginning or the end of the rule name in the search rules file.
The following table lists the bugs fixed in this release of Application Migration Assistant:
| Bug Number | Description |
|---|---|
| 3615045 | Project Property Window Hanging When User Selects Top and Then Down Button |
| 3601858 | In Selecting Analyze Project If I Select Cancel Exception Is Thrown |
| 3270238 | Migration Progress Report File Name Linux/Unix Entry Field Not Shown |
| 3267708 | Regional Settings Locale Not Being Updated In The Analyze Project Report |
| 3267111 | Create Search Rules Generated Report |
| 3264882 | Annotation Exclusion If I Enter A Along Extension |
| 3264273 | Validation Of A Created Search Rules File |
| 3262068 | Annotate Exclusion Panel *.dll |
| 3238237 | Annotate Exclusion Adding Exclusions The Extension In Question Cannot Be Removed |
| 3238129 | Filter Issue List Time If One Dose Not Have A Review Item Expanded |
| 3229956 | Selecting A Review Item in the SQL Navigate Window Exception Is Thrown in UNIX |
| 3229876 | To Analyze A File One Needs To Make Sure The File Window Isn't Open |
| 3229861 | The Include Patterns With Include File Extension Custom Rules XML |
| 3225118 | Selecting HTML File in the SQL Navigator Window After it has Been Analyzed |
| 3225084 | Include Pattern Exclude File Extension For Each Category of The Default XML File |