################################################################################ # IBM Content Manager OnDemand Web Enablement Kit # # AIX, HP-UX, Linux, Sun Solaris, Windows # # README # # Release 7.1.0.14 # # June 30, 2003 # # # # 5697-G34 (C) COPYRIGHT IBM CORPORATION 2003 # # All Rights Reserved # # Licensed Materials - Property of IBM # # US Government Users Restricted Rights - Use, duplication or # # disclosure restricted by GSA ADP Schedule Contract with IBM Corp. # ################################################################################ The information about OnDemand contained in this README file was not available at the time that the OnDemand publications were printed. Please make a note of these items, which supersede the information in the OnDemand publications. For the latest information about OnDemand, see the OnDemand Web site at: http://www.software.ibm.com/data/ondemand For the latest Release Notes (including upgrade instructions), see: ftp://service.software.ibm.com/software/ondemand/fixes/v71/7.1.0.X/ReleaseNotes.pdf ================================================================================ 1. Contents 2. Installation 3. Web Enablement Kit Change History 3.1 CGI/Servlet 3.1.7.1.0.0 Release (7.1.0.0) 3.1.7.1.0.1 PTF (7.1.0.1) 3.1.7.1.0.3 PTF (7.1.0.3) 3.1.7.1.0.4 PTF (7.1.0.4) 3.1.7.1.0.5 PTF (7.1.0.5) 3.1.7.1.0.6 PTF (7.1.0.6) 3.1.7.1.0.7 PTF (7.1.0.7) 3.1.7.1.0.8 PTF (7.1.0.8) 3.1.7.1.0.9 PTF (7.1.0.9) 3.1.7.1.0.10 PTF (7.1.0.10) 3.1.7.1.0.11 PTF (7.1.0.11) 3.1.7.1.0.12 PTF (7.1.0.12) 3.1.7.1.0.13 PTF (7.1.0.13) 3.1.7.1.0.14 PTF (7.1.0.14) 3.2 AFP Web Viewer (Plugin/ActiveX) 3.2.7.1.0.0 Release (7.1.0.0) 3.2.7.1.0.1 PTF (7.1.0.1) 3.2.7.1.0.2 PTF (7.1.0.2) 3.2.7.1.0.3 PTF (7.1.0.3) 3.2.7.1.0.4 PTF (7.1.0.4) 3.2.7.1.0.5 PTF (7.1.0.5) 3.2.7.1.0.6 PTF (7.1.0.6) 3.2.7.1.0.7 PTF (7.1.0.7) 3.2.7.1.0.8 PTF (7.1.0.8) 3.2.7.1.0.9 PTF (7.1.0.9) 3.2.7.1.0.10 PTF (7.1.0.10) 3.2.7.1.0.11 PTF (7.1.0.11) 3.2.7.1.0.12 PTF (7.1.0.12) 3.1.7.1.0.13 PTF (7.1.0.13) 3.1.7.1.0.14 PTF (7.1.0.14) 3.3 Image Web Viewer (Plugin/ActiveX) 3.3.7.1.0.0 Release (7.1.0.0) 3.3.7.1.0.2 PTF (7.1.0.2) 3.3.7.1.0.5 PTF (7.1.0.5) 3.3.7.1.0.6 PTF (7.1.0.6) 3.3.7.1.0.8 PTF (7.1.0.8) 3.3.7.1.0.9 PTF (7.1.0.9) 3.3.7.1.0.10 PTF (7.1.0.10) 3.3.7.1.0.11 PTF (7.1.0.11) 3.3.7.1.0.12 PTF (7.1.0.12) 3.3.7.1.0.13 PTF (7.1.0.13) 3.3.7.1.0.13 PTF (7.1.0.14) 3.4 Java Line Data Applet 3.4.7.1.0.0 Release (7.1.0.0) 3.4.7.1.0.1 PTF (7.1.0.1) 3.4.7.1.0.3 PTF (7.1.0.3) 3.4.7.1.0.4 PTF (7.1.0.4) 3.4.7.1.0.5 PTF (7.1.0.5) 3.4.7.1.0.6 PTF (7.1.0.6) 3.4.7.1.0.7 PTF (7.1.0.7) 3.4.7.1.0.8 PTF (7.1.0.8) 3.4.7.1.0.9 PTF (7.1.0.9) 3.4.7.1.0.10 PTF (7.1.0.10) 3.4.7.1.0.11 PTF (7.1.0.11) 3.4.7.1.0.12 PTF (7.1.0.12) 3.4.7.1.0.13 PTF (7.1.0.13) 3.4.7.1.0.14 PTF (7.1.0.14) 3.5 Java AFP2HTML Applet 3.5.7.1.0.0 Release (7.1.0.0) 3.5.7.1.0.1 PTF (7.1.0.1) 3.5.7.1.0.3 PTF (7.1.0.3) 3.5.7.1.0.4 PTF (7.1.0.4) 3.5.7.1.0.5 PTF (7.1.0.5) 3.5.7.1.0.6 PTF (7.1.0.6) 3.5.7.1.0.7 PTF (7.1.0.7) 3.5.7.1.0.8 PTF (7.1.0.8) 3.5.7.1.0.9 PTF (7.1.0.9) 3.5.7.1.0.10 PTF (7.1.0.10) 3.5.7.1.0.11 PTF (7.1.0.11) 3.5.7.1.0.12 PTF (7.1.0.12) 3.5.7.1.0.13 PTF (7.1.0.13) 3.5.7.1.0.14 PTF (7.1.0.14) 3.6 Java API 3.5.7.1.0.7 PTF (7.1.0.7) 3.5.7.1.0.8 PTF (7.1.0.8) 3.5.7.1.0.9 PTF (7.1.0.9) 3.5.7.1.0.10 PTF (7.1.0.10) 3.5.7.1.0.11 PTF (7.1.0.11) 3.5.7.1.0.12 PTF (7.1.0.12) 3.5.7.1.0.13 PTF (7.1.0.13) 3.5.7.1.0.14 PTF (7.1.0.14) 4. Testing Environment ================================================================================ 2. Installation Before using the latest version of the Web Enablement Kit, you must delete all of the files from the Web Enablement Kit cache directory. The directory is specified by the ARSWWW_CACHE_DIR directive in the arswww.cfg file. This release includes the following files: README - This file. arswww.cgi - This is the Web Enablement Kit CGI program. This file should be placed into a directory within your Web server directory space which has been designated as executable and can contain CGI applications. arsscknt.dll (Windows) arssck32.dll (Windows) - This file should be left in the installation directory. arsct32.dll (Windows) - This file must be placed in the same directory as the arswww.cgi file. ArsWWWServlet.jar ArsWWWInterface.class arswwwsl.dll (NT) libarswwwsl.a (AIX) libarswwwsl.so (SunOS) libarswwwsl.sl (HPUX) - Servlet support files. ArsWWWServlet.jar should be placed into the web server's servlet directory. Because the servlet uses JNI, you may have to put ArsWWWInterface.class and the shared library file into into a directory other than the web server's servlet directory. This is due to class loader issues. See the documentation for more information. ODApi.jar - Java api. See the documentation for more information on how write applications using the api's. ODApiDoc.zip - Java api documentation. Unzip this file and view index.html with your browser. arswww.ini - This is the configuration file for the cgi/servlet. See the documentation for information on the configuration settings. This file must be placed in the same directory as the cgi or servlet program. afp2html.ini - This is the configuration file for the AFP2WEB Transform. See the documentation for information on the configuration settings. afp2pdf.ini - This is the configuration file for the AFP2PDF Transform. See the documentation for information on the configuration settings. arsxenos.ini - This is the configuration file for the XENOS Transform. See the documentation for information on the configuration settings. api/ODApi.jar - This is the OnDemand Java API jar file api/ODApiDoc.zip - This is the OnDemand Java API Documentation locale/arscpcs.cfg - This file contains the code page to code set mappings. This file should stay in the installation directory. locale/uconvtab/* - These files are the iconv conversion tables. They should stay in the installation directory. samples/template.htm - This is a sample of what a template html file can look like. samples/logon.htm - This is another sample html file demonstrating how to gather logon information from the end user and submit it to arswww.cgi. samples/credit.htm - This is another sample html file demonstrating the use of another script function, dochitlist. samples/frames.htm samples/fcredit.htm samples/fblank.htm samples/ftemplat.htm - These are sample html files demonstrating how to use the _frame parameter to build a frames based application. images/grytxtr4.jpg images/odcol2in.gif - These are the images referenced in the sample html files. images/odic_att.gif - image used for Showing Document Attachments - These images are used for the ODDOC type images/odic_aa.gif - image used for Add Annotation button images/odic_aad.gif - image used for Add Annotation button (disabled) images/odic_va.gif - image used for View Annotation button images/odic_vad.gif - image used for View Annotation button (disabled) images/odic_vd.gif - image used for View Document button images/odic_vdd.gif - image used for View Document button (disabled) - These images are used when enabling commands for the command icons column of the document list table. (See the documentation for more information). To use your own images, simply rename your image to one of the names above. images/* - The remainder of the images are used by the applet toolbars. They should be placed in the ARSWWW_IMAGE_DIR directory. (See the documentation for more information). These images cannot be replaced with your own images. applets/ODLineDataViewer.jar - IBM OnDemand Line Data Viewer applet. applets/ODLineDataViewer2.jar - IBM OnDemand Line Data Viewer applet for Java Runtime 1.4. applets/ODLineDataViewer.cab - IBM OnDemand Line Data Viewer applet. - These applet files are used when enabling the java line data viewer applet. (See the documentation for more information). applets/ODAfp2Html.jar - IBM OnDemand AFP Transform applet. applets/ODAfp2Html.cab - IBM OnDemand AFP Transform applet. - These applet files are used when enabling the java AFP2HTML viewer applet. (See the documentation for more information). plugins/afpplgus.exe - IBM OnDemand AFP Web Viewer (Plugin/ActiveX) - English only plugins/afpplgin.exe - IBM OnDemand AFP Web Viewer (Plugin/ActiveX) - All languages including DBCS support plugins/afpplgin.zip - IBM OnDemand AFP Web Viewer (Plugin/ActiveX) - Zip format for all languages include DBCS support plugins/imgplgin.exe - IBM OnDemand Image Web Viewer (Plugin/ActiveX) - All languages - These are self extracting files (InstallShield). These files should be downloaded to the user's Windows 98, Windows NT, or Windows 2000 system, and run to install the appropriate plug-in. If the user is running a browser while the installation is in progress, then the user must stop and restart the browser before the plugins can be used. --------------end of Installation----------------------------------------------- 3. Web Enablement Kit Change History -------------------------------------------------------------------------------- 3.1 CGI/Servlet 3.1.7.1.0.0 Release (7.1.0.0) - Pre-reqs - AIX 4.3.3 or later - HP-UX 11.0 or later - Linux Kernal 2.2.14 or later - Sun Solaris 8 or later (SPARC only) - Windows NT 4.0 SP5 or later - Windows 2000 or later 3.1.7.1.0.1 PTF (7.1.0.1) - Fixed a bug which caused IE nolinks parameter to not work with IPlanet 4.0.4 or 4.0.6 3.1.7.1.0.3 PTF (7.1.0.3) - Added the ability to specify search string, date format to Java API 3.1.7.1.0.4 PTF (7.1.0.4) - Fixed a bug which caused no hits to be retrieved 3.1.7.1.0.5 PTF (7.1.0.5) - Fixed a bug which caused the CGI to loop indefinately, never returning - Fixed a bug which prevented the use of the Java API's from double byte countries 3.1.7.1.0.6 PTF (7.1.0.6) - Fixed a bug which caused messages to be displayed incorrectly - Fixed a bug which limited resource caching - Fixed a bug which caused line data to be incorrectly converted to ascii 3.1.7.1.0.7 PTF (7.1.0.7) - Fixed a bug which caused ReportServerTimeout to report incorrect message - Fixed a bug in the servlet which caused the wrong path to the servlet to be returned - Fixed a bug which caused TempDir to defect to cgi/servlet directory if not specified, default is now cache directory - Fixed a bug which caused AFP to PDF conversion for large object documents to fail 3.1.7.1.0.8 PTF (7.1.0.8) - Fixed a bug which caused a servlet memory leak - Added support back in for the old _nohtml format - Fixed a bug which prevented the servlet from running under iPlanet on Sun Solaris - Fixed a bug which prevented large object line data from viewing 3.1.7.1.0.9 PTF (7.1.0.9) - Fixed a bug with Linux installs - Fixed a security problem in the CGI - Fixed a problem handling Document Ids with NULL fields - Fixed a problem parsing the _cgibin parameter 3.1.7.1.0.10 PTF (7.1.0.10) - Fixed threading and memory leak problems 3.1.7.1.0.11 PTF (7.1.0.11) - Fixed a problem adding Annotations on Solaris. - Added the ability to use a separate resource file for Xenos 3.1.7.1.0.12 PTF (7.1.0.12) - Removed old URLDecoder.class file - Added a parameter to arswww.ini to control temp file size - Corrected problems searching on zSeries Version 2 server 3.1.7.1.0.13 PTF (7.1.0.13) - Corrected a problem with Server Timout using IE - Corrected a problem using CachedUserIDs 3.1.7.1.0.14 PTF (7.1.0.14) - Corrected a problem with Large Object support --------------end of CGI/Servlet------------------------------------------------ 3.2 AFP Web Viewer (Plugin/ActiveX) 3.2.7.1.0.0 Release (7.1.0.0) - Version 2.0.2.2 - Pre-reqs - Windows 98 or later - Windows NT 4.0 SP5 or later - Windows 2000 or later 3.2.7.1.0.1 PTF (7.1.0.1) - Version 2.0.2.3 3.2.7.1.0.2 PTF (7.1.0.2) - Version 2.0.2.4 - Fixed bug which caused the vertical thumbnail to be incorrect for large object documents - Fixed bug which caused large object data to become skewed during printing 3.2.7.1.0.3 PTF (7.1.0.3) - Version 2.0.2.6 3.2.7.1.0.4 PTF (7.1.0.4) - Version 2.0.2.7 3.2.7.1.0.5 PTF (7.1.0.5) - Version 2.0.2.8 - Added ActiveX version - Fixed a bug which caused text search to fail - Fixed a bug which caused duplex documents to print incorrectly - Fixed a bug which limited Goto dialog box to 32,736 pages 3.2.7.1.0.6 PTF (7.1.0.6) - Version 2.0.2.9 - Fixed a bug which caused the top of the page to be truncated if paper setting is A4 - Fixed a bug which caused the last page to be scrolled continuously - Fixed a bug which caused numeric searches to fail when case sensitivity isn't selected - Fixed a bug which caused the viewer to fail when viewing data containing TIFF images - Fixed several bugs dealing with DBCS data - Fixed a bug which prevented resources from being displaying 3.2.7.1.0.7 PTF (7.1.0.7) - Version 2.0.3.0 - Fixed a bug which caused a viewer GPF while printing a large object document - Fixed a bug which caused viewer to display incorrect page numbers for large documents - Fixed a bug which caused a viewer GPF when query string greater than 256 characters 3.2.7.1.0.8 PTF (7.1.0.8) - Version 2.0.3.1 3.2.7.1.0.9 PTF (7.1.0.9) - Version 2.0.3.2 - Fixed a bug that caused artifacts during viewing - Fixed memory problems in Win98 3.2.7.1.0.10 PTF (7.1.0.10) - Version 2.0.3.3 - Fixed a problem with truncation when copying AFP to ASCII 3.2.7.1.0.11 PTF (7.1.0.11) 3.2.7.1.0.12 PTF (7.1.0.12) - Corrected a problem with Brazilian Portuguese Print Dialog 3.2.7.1.0.13 PTF (7.1.0.13) - Fixed a problem viewing AFP documents with a TLE containing a x'01' triplet - Improved algorithm for Draw Rules using RuleFix=TRUE - Allow the specification of TextFidelity in the FTDPORT2.INI file 3.2.7.1.0.14 PTF (7.1.0.14) --------------end of AFP Plugin------------------------------------------------- 3.3 Image Web Viewer (Plugin/ActiveX) 3.3.7.1.0.0 Release (7.1.0.0) - Pre-reqs - Windows 98 or later - Windows NT 4.0 SP5 or later - Windows 2000 or later 3.3.7.1.0.2 PTF (7.1.0.2) - Updated Pixel Translations Image Viewing code which now supports Microsoft Terminal Server 3.3.7.1.0.5 PTF (7.1.0.5) - Added ActiveX version 3.3.7.1.0.8 PTF (7.1.0.8) - Fixed a defect which prevented plugin from loading on Netscape 6.0 3.3.7.1.0.9 PTF (7.1.0.9) 3.3.7.1.0.10 PTF (7.1.0.10) 3.3.7.1.0.11 PTF (7.1.0.11) 3.3.7.1.0.12 PTF (7.1.0.12) - Fixed a problem with the vertical scrollbar 3.3.7.1.0.13 PTF (7.1.0.13) 3.3.7.1.0.14 PTF (7.1.0.14) - Fixed a printing problem that caused truncation of the image - Corrected toggle gray function --------------end of Image Plugin----------------------------------------------- 3.4 Java Line Data Applet 3.4.7.1.0.0 Release (7.1.0.0) 3.4.7.1.0.1 PTF (7.1.0.1) - Fixed a bug which is caused by a known Microsoft issue which results in getting the wrong user home directory for applets 3.4.7.1.0.3 PTF (7.1.0.3) - Fixed a bug which caused scrolling and repainting issues 3.4.7.1.0.4 PTF (7.1.0.4) - Fixed a bug which caused the applet to not launch - Fixed a bug which caused print drift/font problems with landscape 3.4.7.1.0.5 PTF (7.1.0.5) 3.4.7.1.0.6 PTF (7.1.0.6) - Fixed a bug which caused misaligned columns when viewing dbcs data - Fixed a bug which caused copy and paste of dbcs data to fail - Added support for column searching and find all - Fixed a defect which caused dialogs to only display in english - Fixed a bug which prevented extended ascii characters from being displayed 3.4.7.1.0.7 PTF (7.1.0.7) - Fixed a bug which caused double byte data to display misaligned - Fixed a bug which caused some messages to always display in english - Fixed a bug which caused incorrect character width when printing 3.4.7.1.0.8 PTF (7.1.0.8) 3.4.7.1.0.9 PTF (7.1.0.9) 3.4.7.1.0.10 PTF (7.1.0.10) 3.4.7.1.0.11 PTF (7.1.0.11) - Added ODLineDataViewer2.jar to better support printing of documents - Updated the Certificate 3.4.7.1.0.12 PTF (7.1.0.12) - Corrected a problem Copying Data to Clipboard that removed the first column - Corrected several printing problems - Corrected scrollbar behavior - Corrected several problems with the Select Pages dialog. - Corrected problems with the Next, Last and Previous buttons 3.4.7.1.0.13 PTF (7.1.0.13) - Corrected problems with Page Up and Page Down 3.4.7.1.0.14 PTF (7.1.0.14) --------------end of Java Line Data Applet-------------------------------------- 3.5 Java AFP2HTML Applet 3.5.7.1.0.0 Release (7.1.0.0) 3.5.7.1.0.1 PTF (7.1.0.1) - Fixed a bug which is caused by a known Microsoft issue which results in getting the wrong user home directory for applets 3.5.7.1.0.3 PTF (7.1.0.3) - Fixed a bug which caused scrolling and repainting issues 3.5.7.1.0.4 PTF (7.1.0.4) 3.5.7.1.0.5 PTF (7.1.0.5) 3.5.7.1.0.6 PTF (7.1.0.6) - Fixed a defect which caused dialogs to only display in english 3.5.7.1.0.7 PTF (7.1.0.7) - Fixed a bug which caused some messages to always display in english 3.5.7.1.0.8 PTF (7.1.0.8) 3.5.7.1.0.9 PTF (7.1.0.9) 3.5.7.1.0.10 PTF (7.1.0.10) - Fixed memory leaks 3.5.7.1.0.11 PTF (7.1.0.11) - Updated the Certificate 3.5.7.1.0.12 PTF (7.1.0.12) - Corrected a problem causing the applet to core when USEEXECUTABLE=0 - Added ODApf2Html2.jar 3.5.7.1.0.13 PTF (7.1.0.13) 3.5.7.1.0.14 PTF (7.1.0.14) --------------end of Java AFP2HTML Applet--------------------------------------- 3.6 Java API 3.6.7.1.0.7 PTF (7.1.0.7) - Added support for RMI - Enhancement to return folder names in sorted order - Enhancement to add database field names to ODCriteria object - Enhancement to add folder field subtypes to ODCriteria object - Fixed a bug which caused a hang when using a multithreaded application - Fixed a bug which prevented folder criteria from being returned in query order 3.6.7.1.0.8 PTF (7.1.0.8) - Fixed a bug which caused the server print api to fail 3.6.7.1.0.9 PTF (7.1.0.9) 3.6.7.1.0.10 PTF (7.1.0.10) - Corrected problems core dumping in Java VM - Fixed memory leaks 3.6.7.1.0.10 PTF (7.1.0.10) 3.6.7.1.0.10 PTF (7.1.0.11) - Fixed a bug in odfolder.printdocs on Solaris that causing a core dump - Fixed a bug retrieving documents that caused a core dump - Fixed a problem with the ODHit.getDisplayValue vs ODHit.getDisplayValues giving different results 3.6.7.1.0.12 PTF (7.1.0.12) - Corrected a problem cancelling folder searches - Fixed a bug in ODHit.update that truncated values - Corrected ODHit.getDocLocation to return valid values - Corrected ODFolder.retrieve returning truncated values - Corrected ODFolder.getDisplayOrder to return the correct sort order - Corrected ODFilder.getNumApplGroups to return correct number - Corrected a Java Syntax error in ODHit.getNotes 3.6.7.1.0.13 PTF (7.1.0.13) - Corrected ODCriteria.GetDBFields to return valid values - Corrected ODHit.getNotes to return the correct number of notes - Corrected ODFolder.addHit to support old method - Corrected ODHit.getNoteStatus - Fixed problems with ODFolder.retrieve when the document no longer exists 3.6.7.1.0.14 PTF (7.1.0.14) - Fixed problems accessing a zSeries V2 OnDemand Server --------------end of Java API -------------------------------------------------- ---------------end of Web Enablement Kit Change History------------------------- 4. OnDemand Testing Environment -------------------------------------------------------------------------------- This following is a list of the environments in which IBM tested the latest Release/PTF. AIX: AIX - 4.3.3 HP-UX: HP-UX - 11.0 SunOS: SunOS - 2.8 Windows: Windows - NT 4.0 SP6 Windows - 2000 Linux: RedHat - 2.2.14 ------------------end of OnDemand Testing Environment---------------------------