Readme file for IBM WebSphere Developer Asset Analyzer Technology Preview Version 7 Release 0, Modification Level 0 Program Number 5724-L44 This readme file provides installation information for the WebSphere Developer Asset Analyzer v7.0 Technology Preview. The technology preview is available for downloading at the following Web site: http://www.ibm.com/software/awdtools/devzseries/ ----------------------------------------------------------------------------- I. Technology preview content ----------------------------------------------------------------------------- This technology preview adds the following functions to WebSphere Developer for System z v7.0 or v7.1, when it is available: - Automatic scanning of COBOL and PL/I assets on the workstation - Search for programs - Search for declarations, references, and modifications of data elements - Search for declarations of data elements from the LPEX editors - Display programs in a tree view - Display external assets used by a program in a diagram - Display data elements in a program in a table - Search remote z/OS hosts - Edit z/OS programs through search results - Impact analysis for data elements - Displaying unreachable code ----------------------------------------------------------------------------- II. Technology preview limitations ----------------------------------------------------------------------------- This technology preview has the following limitations: - Only COBOL and PL/I files are supported - COBOL and PL/I files that cannot be compiled will not be properly scanned - Path names of COBOL and PL/I files cannot have spaces - Performance has not been optimized--some functions may be performed slowly ----------------------------------------------------------------------------- III. Prerequisites ----------------------------------------------------------------------------- This technology preview requires a workstation with 768MB of RAM, 600MB of free space, and the following software installed: - Microsoft Windows 2000 with Service Pack 2+ or Microsoft Windows XP - WebSphere Developer for System z v7.0 or v7.1 - IBM DB2 V7.21 with Fixpack 6 or later, or IBM DB2 V8.1 with Fixpack 7 or later, or IBM DB2 Express C - Open Object Rexx V3.1.2 or later, available from www.oorexx.org - WebSphere Studio Asset Analyzer v5.1, to support searching assets on a z/OS host - WebSphere Developer for System z host components, to support editing of z/OS files ------------------------------------------------------------------------------ IV. Installing WebSphere Developer Asset Analyzer ------------------------------------------------------------------------------ 1. Ensure that you have met all of the prerequisites. 2. WARNING: Do not install the WDAA tech preview on a machine where WSAA has already been installed. 3. Download the install jar file, wdaasetup.jar, to a temporary location on your workstation. 4. Start the installation program by typing java -jar wdaasetup.jar 5. Select your installation language. 6. If you are shown a prompt that says, "WD/z was not detected on this machine. You must enter an install password to proceed," you do not have WebSphere Developer for System z Version 7.0 or 7.1 installed on your workstation. This technology preview will not install without WebSphere Developer for System z Version 7.0 or 7.1. Please do not contact IBM to request an install password; one will not be provided. 7. Click "Next" and read and accept the license agreement. 8. When prompted for an install directory, make sure that the path does not contain spaces. Click "Next". 9. Select the IBM WebSphere Developer Asset Analyzer Technology Preview install. Click "Next". 10. Ensure that the Java and DB2 directories provided point to the proper locations and then click "Next." 11. When prompted for the host information about this machine, specify "localhost". Click "Next". 12. Enter a site name and an optional description to identify this machine in the WebSphere Developer Asset Analyzer database, then click "Next". 13. Ensure that the IBM Installation Manager home directory is correct and click "Next". 14. When prompted for properties to use when creating the DB2 database, enter a username and password with DB2 administrator privileges. Click "Next". 15. Change the log and temp directories if desired and click "Next". Do not enter a path name that contains spaces. 16. On the summary information page, click "Next" to start the install. 17. Wait for IBM Installation Manager to start, then click "Next". 18. Read and accept the license agreement. 19. Click "Next" to install with the existing package group. 20. Click "Next" to install the WebSphere Developer Asset Analyzer feature. 21. Click "Install". 22. Select "None" for packages to start and click "Finish". 23. Click "Next" on the summary information page, then click "Finish". 24. Restart your machine. ------------------------------------------------------------------------------ V. Uninstalling WebSphere Developer Asset Analyzer ----------------------------------------------------------------------------- To uninstall WebSphere Developer Asset Analyzer, follow these steps: 1. From the Windows Control Panel, select Add/Remove Programs. 2. Select WebSphere Developer Asset Analyzer from the list, and then select Remove. 3. Start IBM Installation Manager. 4. Click "Uninstall Packages". 5. Select WebSphere Developer Asset Analyzer. Click "Next". 6. Click "Uninstall". 7. Click "Finish". ------------------------------------------------------------------------------ VI. User Guide Updates ----------------------------------------------------------------------------- The User Guide does not include a description of how to set the extensions of the files to scan in your workspace and how to show unreachable code. The WDAA Preferences page has a new field, "File Extensions To Scan", that enables you to specify what files will be scanned when they are changed in your workspace. You may add your own extensions or modify the existing ones. Only files in your workspace with the extensions you specify will be scanned. To show unreachable code, display the Program Tree View for a program. Right click on the program node, and click "Show Unreachable Code". The unreachable code in the program will be shown with a gray background color. (NOTE: You may need to click on the file in the editor window to jump to the first line of unreachable code.) Scroll through the file to observe all of the dead code. To remove the gray background, choose "Hide Unreachable Code" from the context menu of the program node. Copyright IBM Corporation 2005, 2008. All Rights Reserved.