############################################################################### # IBM Content Manager OnDemand for Multiplatforms # # Web Enablement Kit for # # AIX, HP-UX, Linux, Sun Solaris, Windows, Linux for S/390 # # README # # Release 7.1.2.3 # # June 15, 2005 # # # # 5724-J33 (C) COPYRIGHT IBM CORPORATION 2005 # # 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 =============================================================================== 1. Contents 2. Installation 3. Web Enablement Kit Change History 3.1 CGI/Servlet 3.1.7.1.2.0 Release (7.1.2.0) 3.1.7.1.2.1 Release (7.1.2.1) 3.1.7.1.2.2 Release (7.1.2.2) 3.1.7.1.2.3 Release (7.1.2.3) 3.2 AFP Web Viewer (Plugin/ActiveX) 3.2.7.1.2.0 Release (7.1.2.0) 3.2.7.1.2.1 Release (7.1.2.1) 3.2.7.1.2.2 Release (7.1.2.2) 3.2.7.1.2.3 Release (7.1.2.3) 3.3 Image Web Viewer (Plugin/ActiveX) 3.3.7.1.2.0 Release (7.1.2.0) 3.3.7.1.2.1 Release (7.1.2.1) 3.3.7.1.2.2 Release (7.1.2.2) 3.3.7.1.2.3 Release (7.1.2.3) 3.4 Java Line Data Applet 3.4.7.1.2.0 Release (7.1.2.0) 3.4.7.1.2.1 Release (7.1.2.1) 3.4.7.1.2.2 Release (7.1.2.2) 3.4.7.1.2.3 Release (7.1.2.3) 3.5 Java AFP2HTML Applet 3.5.7.1.2.0 Release (7.1.2.0) 3.5.7.1.2.1 Release (7.1.2.1) 3.5.7.1.2.2 Release (7.1.2.2) 3.5.7.1.2.3 Release (7.1.2.3) 3.6 Java API 3.6.7.1.2.0 Release (7.1.2.0) 3.6.7.1.2.1 Release (7.1.2.1) 3.6.7.1.2.2 Release (7.1.2.2) 3.6.7.1.2.3 Release (7.1.2.3) 4. Testing Environment 5. Reference =============================================================================== 2. Installation - Unix installs are now packaged with InstallShield MP. The native installs using SMIT, swinstall, pkgadd, or RPM are no longer supported - Pre-reqs - for PTF 7.1.2.0 - Previous install of OnDemand Web Enablement Kit V7.1.1 - for all subsequent 7.1.2.x PTFs - Previous install of OnDemand Web Enablement Kit V7.1.2 - Java Runtime Environment 1.4.1 or higher - rpm and rpm-build package for Linux - To install from the command line - odwekaix -console - odwekhp -console - odweksun -console - odweklinux -console - odweklinux390 -console - odwekwin.exe -console - Please read the Installation Documentation in the CMODDoc.zip package for further information 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 CACHEDIR directive in the arswww.ini 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) arsct32.dll (Windows) - This file should be left in the installation directory. icudt30l.dat (Windows, Linux) icudt30b.dat (AIX, SunOS, HPUX) - This file should be left in the installation Locale directory. icudt30.dll (Windows) libicudata30.a (AIX) libicudata30.so (SunOS, Linux) libicudata30.sl (HPUX) icuin30.dll (Windows) libicui18n30.a (AIX) libicui18n30.so (SunOS, Linux) libicui18n30.sl (HPUX) icuuc30.dll (Windows) libicuuc30.a (AIX) libicuuc30.so (SunOS, Linux) libicuuc30.sl (HPUX) - These libraries are used for ICU support. On Windows, these files must be placed in the same directory as the arswww.cgi file or when using the JAVA Api's, a directory that is in the command search path defined by the Path environment variable. ArsWWWServlet.jar ArsWWWInterface.class arswwwsl.dll (NT) libarswwwsl.a (AIX) libarswwwsl.so (SunOS,Linux) 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 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, Windows XP, 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.2.0 Release (7.1.2.0) - Pre-reqs - AIX 5.1 or Later - HP-UX 11.0 or later - Linux Kernal 2.4.21 or Later - Sun Solaris 8 or later (SPARC only) - Windows 2000 or later - Java 1.4.1 or later 3.1.7.1.2.1 Release (7.1.2.1) APARs: PQ97463 - Remove ODWEK 7120 installation restriction on Sun - Removed Operating System prereq check on Sun. PQ97465 - Corrected problems adding Notes from the Applets or hitlist 3.1.7.1.2.2 Release (7.1.2.2) APARs: PK00042 - Msg file displays corrupted NLS chars - Corrected Build problems with message files on Windows PQ89078 - Cannot retrieve THAI folder/doc - Corrected problems with Folders using Thai characters PQ99424 - AOIIE Folder Cookie set to locale chars instead of UTF8 - Changed all Cookies to UTF8 PQ99435 - FRA date in NOTES is invalid in ODWEK - Corrected Date/Time format in French Messages Resource 3.1.7.1.2.3 Release (7.1.2.3) Enhancements: - Added the ability to for "User Alias" logging APARs: PK01901 - ODWEK fails user has access 1 FLDR & 0 AGs - Changed the logon to return an error code PK03071 - ODWEK doesn't issue logoff when DocHitList=0 - Corrected problems with Logoff freeing a NULL pointer PK03766 - ODWEK 390 V2 Migr Fldrs cause some searches to fail - Added a Function to check for V2 Folders PK04568 - ODWEK results AFP2PDF ERROR EXEC FAILED RC=99 ERRNO=2 - Corrected a pointer initialization that allowed invalid values to be passed to the AFP2PDF converter PQ99426 - Num of Current Users increases w/ODWEK functions - Corrected problems with Logoff freeing a NULL pointer -------------end of CGI/Servlet------------------------------------------------ 3.2 AFP Web Viewer (Plugin/ActiveX) 3.2.7.1.2.0 Release (7.1.2.0) - Version 2.7.1.0 - Pre-reqs - Windows XP - Windows 2000 or later 3.2.7.1.2.1 Release (7.1.2.1) Enhancements: - Updated AFP Web Viewer to Version 2.7.1.3 APARs: PQ90598 - AFP Web Viewer shaded boxes display as 'zebra' stripes - Corrected a problem viewing shaded boxes 3.2.7.1.2.2 Release (7.1.2.2) Enhancements: - Updated AFP Web Viewer to Version 2.7.1.4 3.2.7.1.2.3 Release (7.1.2.3) Enhancements: - Updated AFP Web Viewer to Version 2.7.1.5 -------------end of AFP Plugin------------------------------------------------- 3.3 Image Web Viewer (Plugin/ActiveX) 3.3.7.1.2.0 Release (7.1.2.0) - Pre-reqs - Windows XP - Windows 2000 or later - Updated the Pixtrans support for Image Viewing 3.3.7.1.2.1 Release (7.1.2.1) 3.3.7.1.2.2 Release (7.1.2.2) 3.3.7.1.2.3 Release (7.1.2.3) -------------end of Image Plugin----------------------------------------------- 3.4 Java Line Data Applet 3.4.7.1.2.0 Release (7.1.2.0) - Pre-reqs - Java 1.4.1 or later APARs: PQ90893 - JAVA LDV V1 causes 404 errors in the HTTP log - Corrected resource file naming conventions PQ92274 - JVM crashes if APPLETCACHEDIR has invalid value - Catch the IOException and show a dialog box to the user. 3.4.7.1.2.1 Release (7.1.2.1) APARs: PQ97465 - Adding NOTE from hitlist or LDV results in ERROR - Corrected problems with the ODHit.addNote API when using special characters in the note. 3.4.7.1.2.2 Release (7.1.2.2) Enhancements: - Made changes to the line data applet viewer to have similar print functionality to the Windows client. Support page lists and multiple page ranges APARs: PQ87552 - 7111 LDV V1/2 truncates width of report PQ98936 - LDV 2 truncates 1 char on LEFT side - Corrected truncation problems when resizing the browser window PQ89365 - JAVA LDV PRINT RANGE is not reset to pages in doc - Corrected the Print Range not reset to actual number of pages in a new document PQ91897 - LDV - Data not viewable w/FONT SIZE >= 16 after scroll - Corrected display problems when Font Size was set to 16 PQ97306 - JAVA LDV V2 does not work with Java 1.5.0 - Allowed the Applet to work with JVM 1.5.0 3.4.7.1.2.3 Release (7.1.2.3) APARs: PK02414 - SELECT FONT doesn't display text & defaults to DIALOG - Fixed the dialog's initialization code -------------end of Java Line Data Applet-------------------------------------- 3.5 Java AFP2HTML Applet 3.5.7.1.2.0 Release (7.1.2.0) - Pre-reqs - Java 1.4.1 or later 3.5.7.1.2.1 Release (7.1.2.1) 3.5.7.1.2.2 Release (7.1.2.2) 3.5.7.1.2.3 Release (7.1.2.3) Enhancements: - Corrected Security problems with Windows XP SP2 and Internet Explorer -------------end of Java AFP2HTML Applet--------------------------------------- 3.6 Java API - Pre-reqs - Java 1.3.1 or later 3.6.7.1.2.0 Release (7.1.2.0) 3.6.7.1.2.1 Release (7.1.2.1) APARs: PQ92595 - odHit.addNote() fails when doc index has spec chars $%+# - Corrected problems with the ODHit.addNote API when using special characters in the note. PQ95549 - GetServer cores on Redhat performance Load Testing - Corrected a problem with the GetServer API PQ96302 - JAVA API StoreDoc() doesn't release input file lock - Corrected problem with the StoreDoc API not closing files PQ97464 - Changes to CsvGetDocSegment to check NumSegments value - Corrected problems retrieving Large Objects from V2 Servers 3.6.7.1.2.2 Release (7.1.2.2) APARs: PQ98615 - JAVA APIs cannot update SEGMENT DATE fields - Removed restrictions from ODHit.update API when updating values used for segments 3.6.7.1.2.3 Release (7.1.2.3) Enhancements: - Added the ability to do a Bulk Doc Update APARs: PK03161 - JVM crash on doc retrieval w/viewerpassthru - Added checking to validate server pointers PQ89361 - JAVA API DHit.retrieve() fails with FRC char - Changed JAVA method to use UTF-8 PQ90066 - JAVA APIs ODHit.addNote & ODHit.getNote fail w/NLS chars - Allow the SEPARATOR character to be used by Java APIs PQ98129 - JAVA API ODFolder.retrieve() not working w/spec char - Removed an unecessary conversion --------------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 - 5.1 HP-UX: HP-UX - 11.0 SunOS: SunOS - 5.8 Windows: Windows - 2000, 2003, XP SP2 Linux: RedHat - RHES release 3 Kernel 2.4.21-15 SuSE - SLES 8 Kernel 2.4.21-138 Linux for S/390: RedHat - RHES release 3 Kernel 2.4.21-20 SuSE - SLES 8 Kernel 2.4.21-83 -----------------end of OnDemand Testing Environment--------------------------- 5. Reference ------------------------------------------------------------------------------- You can find information updates by searching the Web Based Technical Support web site at www.ibm.com/support. You can find the following additional documents by entering the document # or title in the search field: Document # Document title 1188995 IBM® DB2® Content Manager OnDemand for Multiplatforms Version 8.3 documentation 1190968 Unable to install CM OD ODWEK or Server 7.1.2 on Sun Solaris 1190663 National language support in IBM® DB2® Content Manager OnDemand for Multiplatforms, Version 8.3 1196951 Retrieve multi-segment AFP™ document with ODWEK and AFP2PDF transform 1198444 Running multiple instances of the OnDemand™ Web Enablement Kit servlet 1198643 ODWEK 7.1.2.1 API. ODServer.openFolder() method does not work with connection to local server. 1198650 AFP Web viewer and printed output 1199144 CM OnDemand, Microsoft Windows and TCP/IP sockets left in a TIME_WAIT state 1199560 OnDemand Line Data Viewer Applet Version 2 Printing 1200124 OnDemand Java™ APIs and OLE Control Interface 1200812 DOCID being returned to the Java™ API too long and causing ODWEK to crash 1200814 What is the purpose of ODWEK's viewerPassThru() Java API function? 1200815 UPDATETIMESTAMP: A new parameter in the arswww.ini file 1201316 ODWEK Codepage Settings Result in JAVA API Exceptions 1207552 Why can't the ODWEK files be removed from the cache directory when the maxthreshold has been reached? 1207916 ODWEK JAVA API ODFolder::storeDoc() results in an unexpected exception -----------------end of Reference----------------------------------------------