Constructing Intelligent Agents with Java A Programmer's Guide to Smarter Applications Copyright (c) 1997 Joseph P. Bigus and Jennifer Bigus Copyright (c) 1997 John Wiley & Sons, Inc. All rights reserved. Reproduction or translation of this work beyond that permitted in Section 117 of the 1976 United States Copyright Act without the express written permission of the copyright owner is unlawful. Requests for further information should be addressed to Permissions Department, John Wiley & Sons, Inc. The purchaser may make back-up copies for his/her own use only and not for distribution or resale. The Publisher assumes no responsibility for errors, omissions, or damages, caused by the use of these programs or from the use of the information contained herein. Disclaimer This software contains files to help you utilize the models described in the accompanying book. By opening the package, you are agreeing to be bound by the following agreement: This software product is protected by copyright and all rights are reserved by the authors, John Wiley & Sons, Inc., or their licensors. You are licensed to use this software on a single computer. Copying the software to another medium or format for use on a single computer does not violate the U.S. Copyright Law. Copying the software for any other purpose is a violation of the U.S. Copyright Law. This software product is sold as is without warranty of any kind, either express or implied, including but not limited to the implied warranty of merchantability and fitness for a particular purpose. Neither Wiley nor its dealers or distributors assumes any liability for any alleged or actual damages arising from the use of or the inability to use this software. (Some states do not allow the exclusion of implied warranties, so the exclusion may not apply to you.) What's on the CD-ROM? This CD-ROM contains the Java source code and compiled class files for all of the applets and applications developed in this book. This includes the Search, Rule, and Learn applets from Part 1, and the PCManager, NewsFilter, and MarketPlace applications from Part 2. The CIAgent software resides in the /ciagent directory on the CD-ROM. The CD-ROM also contains the Windows 95/NT version of the IBM Agent Builder Environment. The Agent Builder Environment software resides in the /abe directory on the CD-ROM. You can open a Web browser on the index.html file in the root directory of the CD-ROM to access the license and installation information on-line. Software Requirements The Java applets and applications require the JDK 1.1 in order to compile and run. The applets can be run using the JDK 1.1 appletviewer, or a Java 1.1 enabled Web browser. The applications require a JDK 1.1 environment. The IBM Agent Builder Environment has its own hardware and software requirements. Please refer to the /abe/READ.ME file for specific information and installation instructions. Running the Software All of the CIAgent software is provided on the CD-ROM. You can run the applets and applications directly from the CD-ROM, or you can install the software on your computer. The IBM Agent Builder Environment software is also provided on the CD-ROM. You can run the examples directly from the CD-ROM, or you can install the software on your computer. Installing the CIAgent Software There is no formal installation program for the CIAgent code. You can use the ciagent.exe, self-extracting zip file to copy the CIAgent files (and directory structure) to your computer. Follow these steps: 1. Start Windows on your computer. 2. Place the CD-ROM into your CD-ROM drive. 3. Create a directory to install the software using the mkdir command. We recommend ciagent as the base directory name. 4. Open a MS-DOS Prompt (command line) window and cd to the installation directory on your hard disk. 5. On the command line, enter: copy g:\ciagent.exe where g is the correct letter of your CD-ROM drive. This command will copy the CIAgent zip file onto your hard disk. 6. Run the executable, enter: ciagent.exe This will create the directory structure and copy the files to the corresponding directories. The ciagent directory contains two subdirectories, part1 and part2. In part1, there are three subdirectories, search, rule, and learn. Each directory contains the source code and Java .class files for the examples from Chapters 2, 4, and 5 respectively. In part2, there are three subdirectories, PCManager, NewsFilter, and MarketPlace. Each directory contains the source code and the Java .class files for the corresponding Java applications from Chapters 8, 9, and 10. Installing the IBM Agent Builder Environment Software You must first read and agree to the terms and conditions described in the IBM License Agreement (LICENSE file in /abe directory) before installing the IBM Agent Builder Environment Developer's Toolkit software. The IBM Agent Builder Environment for Windows 95/NT is a self-extracting zip file. You can use the iagtkw32.exe, self-extracting zip file to copy the ABE files (and directory structure) to your computer. Follow these steps: 1. Start Windows on your computer. 2. Place the CD-ROM into your CD-ROM drive. 3. Create a directory to install the software using the mkdir command. We recommend abe as the base directory name. 4. Open a MS-DOS Prompt (command line) window and cd to the installation directory on your hard disk. 5. On the command line, enter: copy g:\iagtkw32.exe where g is the correct letter of your CD-ROM drive. This command will copy the ABE zip file onto your hard disk. 6. Run the executable: iagtkw32.exe This will create the directory structure and copy the files to the corresponding directories. After the files are unzipped, refer to the /abe/READ.ME for more information. The latest information concerning ABE, as well as additional software for download (for Windows 95/NT, OS/2, and AIX) is available at the IBM Intelligent Agents page. User Assistance and Information The software accompanying this book is being provided as is without warranty or support of any kind. Should you require basic installation assistance, or if your media is defective, please call our product support number at (212) 850-6194 weekdays between 9 am and 4 pm Eastern Standard Time. Or, we can be reached via e-mail at: wprtusw@jwiley.com. To place additional orders or to request information about other Wiley products, please call (800) 879-4539 or visit http://www.wiley.com.