************************************************************************************** IBM ImagePlus VisualInfo 2.4 CSD2 for AIX April 13, 2000 This is a formal Corrective Service Delivery that will bring all systems at the syslevels described in the Installation Requirements to 2.4.2.0 (syslevel 2.4.2.0) Table of Contents: 1. Customer Service and Support Information 2. Installation Requirements 3. Installation Instructions 4. APAR Fixes with Descriptions ************************************************************************************* 1.0 CUSTOMER SERVICE AND SUPPORT INFORMATION ________________________________________________________________________ The following customer service and support guidelines apply to the U.S., Canada, and Puerto Rico only. Outside these countries, contact your local IBM representative or Authorized IBM Supplier for information on warranty and software support. In addition to program services described in the License Information, possible sources of help are available: - Through the Internet (http://www.ibm.com/products/support.html) * Search tips and techniques database * Download fixes, device drivers - By telephone (1-800-237-5511) 4.0 TECHNICAL CUSTOMER ASSISTANCE The following customer service and support guidelines apply to the U.S., Canada, and Puerto Rico only. Outside these countries, contact your local IBM representative or Authorized IBM Supplier for information on warranty and software support. In addition to program services described in the License Information, possible sources of help are available: - Through the Internet (http://www.ibm.com/products/support.html) * Search tips and techniques database * Download fixes, device drivers - By telephone (1-800-237-5511) If you are a licensed customer with a support contract and you need defect support, have the following information available when you call 1-800-237-5511. (In Canada, call 1-800-426-7378.) - (IBM) Product name and release - Customer hardware platform - Customer's IBM Customer Number - Customer contact name - What happened and what you were doing when the problem occurred - Whether you tried to solve the problem and how - The exact wording of any messages displayed If you are a licensed customer but do not have a support contract and you need support, call one of the following numbers to purchase a support contract: If you have an IBM Corporate Customer Number, - In the U.S. and Puerto Rico, call 1-888-426-4343 and option 3, This service phones are staffed Monday through Thursday, 8:00 a.m. to 7:00 p.m., Friday 8:00 a.m. to 6:30 p.m. Eastern Standard Time. - In Canada, call 1-800-426-2255 (M-F 8am-8pm est.) or for general questions 1-800-426-4968 (M-F 7am-8pm est.) All other customers with a valid license call 1-800-237-5511. If you have a question regarding your current contract or license agreement call: - In the U.S. call 1-800-456-0550 and option 3, This service phone is staffed Monday through Friday, 8:00 a.m. to 6:00 p.m. Eastern Standard Time. - In Canada, call 1-800-426-2255 or 1-416-383-5000 (M-F 8am-8pm est.) - International (including Puerto Rico), call 1-770-863-1234. Business Partners should call: - Partner Line, 1-800-426-9990 ********************************************* 2. Installation Requirements ********************************************* This CSD is for AIX. In order to install this CSD, you must have one of the following product base levels installed: a) VisualInfo 2.4 with CSD1 applied (syslevel 9061) or b) VisualInfo 2.4.1 (syslevel 9061) ********************************************* 3. Installation Instructions ********************************************* 1. Download the vi2420.tar.gz file in binary mode to a temporary subdirectory on your workstation. You will need at least 90MB of free space in your temporary directory. 2. To unpack the GZIP compression, enter: gzip -d vi2420.tar.gz If you don't have GZIP, you can obtain this freeware tool from: http://aixpdslib.seas.ucla.edu/aixpdslib.html 3. Unpack the vi2420.tar file into your temporary subdirectory using the AIX tar utility. For example: tar -xvf vi2420.tar 4. Log in as root. 5. Start the Installation wizard by entering ./frnxupdate.sh 6. Migration utility files for APAR IR40730 can be found in the migrate directory that is created after the content of the tar files have been extracted. Do not use the frnxmilt_db2.exe or frnxmilt_oracle.exe that are provided in the migrate directory of the CD-ROM. Replace the files provided in the CD-ROM with the new frnxmilt_db2.exe and frnxmilt_oracle.exe files that are part of this CSD. -------------------------------------------------------------------- 4.0 APAR Fixes with Descriptions -------------------------------------------------------------------- APARs contained in FP 4.9 for 2.4.1 APAR NUMBER: IR41948 COMPONENT: OO APIs & C++ PMR NUMBER: 99999,999,000 APAR DESCRIPTION: When using the DKDatastore DL::checkOut() C++ API to check out an item that is already checked out to a different user we get the following error: Ip2CheckOutItem[FRN=0,ExtRc=0] file DKDatastoreCRUDLL.cpp, line:2635 The error is expect, but the FRN and ExtRc code should not be zero. The api should return FRN2650 return code. FRN2650A: The specified item is currently checked out to another user. FIX DESCRIPTION: Set and return the FRN error code in the exception. APAR NUMBER: IR41982 COMPONENT: OO APIs & C++ PMR NUMBER: 99999,999,000 APAR DESCRIPTION: This is the prereq for IR41948. ddo.update() with a new part does not add the new part. FIX DESCRIPTION: Fix ddo.update() with a new part to add the new part. APAR NUMBER: IR40907 COMPONENT: DL PMR NUMBER: N/A APAR DESCRIPTION: On AIX or NT (IR41004) OOAPI makes calls to Folder Manager to retrieve attributes when CONTENT=NO option is passed during a query. FIX DESCRIPTION: On AIX or NT, OOAPI calls SimLibGetItemInfo to retrieve item information when CONTENT=NO option is passed during a query. APAR NUMBER: IR41612 COMPONENT: Text Search PMR NUMBER: 91780 , 500, 0000 APAR DESCRIPTION: The customer tried to index text documents by TSE. During the indexing process the TSE server stopped processing due to failure of retrieving an object from the library. The customer requested support and provided error information from the TSE imldiag.log. L2 support person Stephen Funk tried to solve the problem but finally had to envolve TSE/DL integration development in Germany. The second error was for trying to cleanup after the orginal failure. FIX DESCRIPTION: After the fix is applied ( skip unknown objects )- The indexing function should not be locked after completion of indexing if a not existing item part was detected by the search engine APAR NUMBER: IR41829 COMPONENT: Text Search PMR NUMBER: 99999,999,000 APAR DESCRIPTION: There are three problems 1. TSE ranking sometimes returns zero rank values. 2. Indexing of 100.000 indexing requests fails due to an internal TSE error and locks the indexing function. Workaround was to split loading into two packages of 50.000 each to overcome the problem 3. Merging the index after two times 50.000 docs were indexed successfully failed and locks the merge fct. Problem 2 and 3 are related. They have the same origin and only one fix has to be implemented FIX DESCRIPTION: The problems were located in the TSE server and are fixed now. APAR NUMBER: IR41579 COMPONENT: Library Server PMR NUMBER: 88710,077,724 APAR DESCRIPTION: Newer database default data is not discussed in the publications. EX: SBTCOLLNAME does not show the Media collections in APPL. Prog Ref. Chapter 9 ... and others... FIX DESCRIPTION: Removed references to default data so as not to confuse customers. APAR NUMBER: IR41326.23 COMPONENT: Object Server PMR NUMBER: 65126 APAR DESCRIPTION: This data is entered by R. Simunic for Ingo Grassmann VI Statistics don't get updated correctly, when documents get destaged and purged from staging area. The used size of the staging area is calculated wrong. New documents are added with the size in full 4KB blocks that they use, but when they get destaged and purged, only the real size is subtracted. e.g.: a new document has size 18441 bytes. In an AIX filesystem it needs 5 * 4 KByte blocks = 20480 bytes (assuming default block sizes) For calculation of the space used in the staging area VI addes this 20480 bytes to the internal statistics. But when this document gets destaged, Vi only decreases it by 18441. FIX DESCRIPTION: Fix lbscmn.c and lbspurgr.c size calculation. APARs contained in FP 4.8 for 2.4.1 APAR NUMBER: IR41002 COMPONENT: Object Server PMR NUMBER: n/a APAR DESCRIPTION: Lan cache file copies not left when migrating files from staging area to remote server. Some perfotmance degradation caused if server must cache a copy on a subsequent retrieve request. Impact will vary depending cache usage. FIX DESCRIPTION: Internal value incorrectly translated. Should be applied to all Lan Cache systems. APAR NUMBER: IR40481 COMPONENT: OO APIs PMR NUMBER: 00809,442 APAR DESCRIPTION: The customer uses query to retrieve the item and it's parts. When the customer wants to update an existing part of an item, it will fail using the OOAPI. FIX DESCRIPTION: The parts collection created when the customer uses query need to stop tracking. APAR NUMBER: IR41402 COMPONENT: OO APIs & C++ PMR NUMBER: 99999,999,000 APAR DESCRIPTION: Running Dynamic Page Builder with DP_TMQuery function. When I do get a lot of hits (say 1000), it seems to take longer and longer to display pages of later hitsd (e.g., 991-1000) versus earlier ones (e.g., 1-10). The increase for retrieving the results page seems linear. FIX DESCRIPTION: Provide a start row fetch to DL insync with START_ROW_NUM setup APARs contained in FP 4.7 for 2.4.1 APAR NUMBER: IR41239 COMPONENT: Toolkit (AIX only) PMR NUMBER: 50589,005,000 APAR DESCRIPTION: Migrate or destage to adsm appears to hang or stop after running for a time. Recycling server seems to allow more objects to migrate or destage. FIX DESCRIPTION: Adsm sessions are now initiated and terminated for each unit of work. Any unexpected adsm return code is now surfaced to the frndiag.log. APAR NUMBER: IR41403 COMPONENT: Object Server - AIX PMR NUMBER: 53145,005,0000 APAR DESCRIPTION: FRN4214W - An error occurred in loading the file. This happens on some objects that are trying to be retrieved. Once the error is reported, the object can never be retrieved again. The problem may be due to a duplicate filename being generated FIX DESCRIPTION: Put an error code check on ADSM api dsmBeginQuery call. APARS contained in FP6 for 2.4.1 APAR NUMBER: IR41305 COMPONENT: OO API (AIX only) PMR NUMBER: 99999,999,000 APAR DESCRIPTION: DPB-SQL can't take more than 6 parametric query condition caused by the length limitation on where clause of SQL statement FIX DESCRIPTION: Append limitation up to 1024k APAR NUMBER: IR40730 COMPONENT: Library Server (AIX only) PMR NUMBER: 55189,292,848 APAR DESCRIPTION: The problem was cause by data that was inserted into library server by the migration utility. The problem index classes were never 'created' as such. They were inserted into the library server database by the migration utility and due to an error in the utility they had userid value which was not in the database. If the index classes had been 'created' via sys admin or using the APIs, the proper userid would have been specified. When the user that created the index class is deleted, the userid filed is set to zero which is value that is reserved and never exposed to the user and will always be there. So the problem described will never happen. To fix this APAR, I have fixed the migration utility to set userid field to zero. FIX DESCRIPTION: To fix this APAR, I have fixed the migration utility to set userid field to zero. To install this fix, the migration program files have to be installed somewhere on the user's machine and ask them to use these new pgm and not the ones that are on the cd-rom. APARS contained in FP5 for 2.4.1 APAR NUMBER: IR40749 COMPONENT: Library Server (AIX Only) PMR NUMBER: 14572,021 APAR DESCRIPTION: 3) Problem: The IsoCpConvertString exit is documented in the APG for MVS, but talks only about DLLs on non-MVS platforms. This le to the impression that this exit is available on the MVS platform 4) Problem: APG for AIX talks about DLLs. DLL, however, is an OS and Windows term, and it is not used on AIX. FIX DESCRIPTION: Documentation was updated to add information to IsoCpConvertString to clarify what and when a Code Page is used. Also, IsoCpQuery was added as well. APAR NUMBER: IR40470 (AIX only) COMPONENT: Library Services PMR NUMBER: APAR DESCRIPTION: Client using unsupported codepage hangs the library server during logon. FIX DESCRIPTION: Valid codepage conversion will be tested. IF an invalid codepage combination is in use, the request will be rejected with ISOERR_CONVERSION_NOT_AVAIL 9054. APAR NUMBER: IR40698 COMPONENT: Object Server (AIX only) PMR NUMBER: 94489 APAR DESCRIPTION: Problem with object server. Document isn't available after a time and return code 2041 is logged in frndiag.log. Also problem with performance because Object Server sessions with ADSM are blocked. FIX DESCRIPTION: Cleaned up ADSM API session management within Object Server. APAR NUMBER: IR40906 COMPONENT: Library Services (AIX only) PMR NUMBER: 99999,999 APAR DESCRIPTION: On AIX, if client workload is heavy, users may get bad return code, such as 6274, 6080, etc. indicating bad pointers have been used while these pointers are actually valid. These problems usually happen more often in multi-process or multi-threaded applications. If the AIX VI/DL client workload is not heavy, then these problems will not occur. FIX DESCRIPTION: Modified the DosQueryMem function in coxstub.c file to check if the pointer is in memory segment 0 or not. If yes, then the pointer is invalid. If no, then the pointer is considered valid. APAR NUMBER: IR40963 (AIX only) COMPONENT: Toolkit (NT only) PMR NUMBER: 70467,662,706 APAR DESCRIPTION: Toolkit communications flexibilty requested to allow for more DHCP, Multiple Communications Cards, and firewall configurations. This APAR requests that hostnames and computer names need not be identical when setting up a DHCP client. This APAR also requests that the user be able to specify the hostname/IP address to be used at the client when performing store or retrieve (i.e. the port and address used by the object server to contact the client daemon). This would be useful if the client machine has multiple communication cards with multiple ip addresses and the specific ip address is desired. It also, allows for client/toolkits to sit on one side of a firewall, where the firewall does NAT. In that case, the client can be configured with the external IP address and a Port number which NAT can translate to internally. FIX DESCRIPTION: Provided DHCP flexibility. The restriction that workstation ids and hostnames being the same, has been removed. The dependency on a client TCP/IP hostname has been removed such that the IP address used between the client and the library server is the default ip address used during object store and retrieve. Note: If the client and library server are on the same machine, yet the object server is on a remote machine, use the multiple communication card support to specify the clients ip address to be something other than the default. Client Toolkit Multiple Communication Cards. Using the network table utility, one can specify the ip address to be used by the client toolkit during store and retrieve operations. This is especially useful when there are two communications adapters and it is desired that different adapters be used for requests between the client/ library server and the object server/client (as in store/retrieve). It may also be useful when the client is within a firewall which uses NAT (Network Address Translation) In such a case, the external ip address can be specifie, since the internal ip address would not be understood on the other side of the firewall. The communication component will use the current active communication ip address between the client and the library server when determining how store/retrieve of object will contact the client daemon. If this default is not sufficient, the network table utility can be used to modify the daemon ip address and port. APAR NUMBER: IR40248 COMPONENT: OO API & C++ (AIX only) PMR NUMBER: 99999,999,000 APAR DESCRIPTION: Need to provide a different result format for Text Miner on free text search and boolean search. FIX DESCRIPTION: The fixed provided, allows Text Miner Linguistic search index to be served for both FREE text search and BOOLEAN search. APARs contained in FP4 for 2.4.1 APAR NUMBER: IR40726 AIX COMPONENT: Object Server PMR NUMBER: APAR DESCRIPTION: When image is updated a deadlock occurs. FIX DESCRIPTION: Discard and replace now issues retry when deadlock happens. APARs contained FP3 for 2.4.1 APAR NUMBER: IR40444 (AIX only) COMPONENT: Text Search PMR NUMBER: APAR DESCRIPTION: RLIM option ignored for free-text search FIX DESCRIPTION: RLIM option now works for free-text search APAR NUMBER: IR40592 (AIX) COMPONENT: JAVA SysAdmin PMR NUMBER: 99999,999,000 APAR DESCRIPTION: Program does not perform the correct function in DKDDOBase.setData() and setNull() methods. FIX DESCRIPTION: The code fix in DKAny.cpp and DKDDOBase.cpp will fix the customer problem. APAR NUMBER: IR40716 (AIX) COMPONENT: Toolkit PMR NUMBER: 99999,8999,000 APAR DESCRIPTION: DL occasionally fails to update objects when multiple threads of an application concurrently retrieve and update the same or different objects. FIX DESCRIPTION: In fopopen2.c, changed code in GenerateRandomString function to make sure unique temporary file names have been generated all the time even in a multi-threaded environment.. APAR NUMBER: IR40717 (AIX only) COMPONENT: Object Server PMR NUMBER: 99999,999,000 APAR DESCRIPTION: When retrieving an object from the object server, very little information is logged when the retrieval fails within the communication/system layer. This APAR will ensure additional logging when a file is either stored or retrieved on the object server. For example, if a retrieve failure occurs on the AIX object server due to the fact that the LS and OS Databasees have different part lengths (data is inconsistent) the isolator will log ISOERR_MESSAGE_TOOSHORT (9015) rather than just ISOERR_PARTNER_ABENDED (9036). Additional ERRTRACE logswhere added for when error tracing is turned on. FIX DESCRIPTION: Additional trace logging added. Also, ensured that inadvertant chsiz isn't performed on readonly object. APARs contained in FP2 for 2.4.1 APAR NUMBER: IR40425 COMPONENT: Object Server (AIX only) PMR NUMBER: n/a APAR DESCRIPTION: The migrator ends its cycle prematurely (stalls) if the last object in a batch cannot be migrated. In a system where many migrator errors occur, this can prevent the migrator ever processing some objects and reduces migrator throughput. If all objects in a batch failed the migration, then the rest of objects will not be migrated not even at the next cycle. This is because the entire failing batch will be reselected again at the next cycle. FIX DESCRIPTION: After issueing a migration failure message (FRN9816) for a single object, the migrator will ignore the failure and continue to process other migration candidates. APAR NUMBER: IR40323 COMPONENT: Library Server (AIX only) PMR NUMBER: 85847,49R,000 APAR DESCRIPTION: Parametric search or SimLibSearch with search string contained apostrophes (single quote) failed when search condition has more than one expression. FRN=6056, ExtRC=7147. FIX DESCRIPTION: Library Server handle apostrophes incorrectly before because it didn't keep track of the search string length correctly. The fix corrects this issue. APAR NUMBER: IR40445 COMPONENT: Object Server (AIX only) PMR NUMBER: 99999 APAR DESCRIPTION: During run and recovery synchronization the base object table is updated and prevents object server from coming up FIX DESCRIPTION: No update on base_volume table subdir. APARs contained in FP1 for 2.4.1 APAR NUMBER: IR40071 (AIX only) COMPONENT: Library Server PMR NUMBER: n/a APAR DESCRIPTION: SimLibOpenObject Folder Manager API fifth argument is now a pointer rather than a boolean value. This argument is now used to specify a file name where a retrieved file from the object server will reside. It is stated in the Folder Manager API manual that if the argument is NULL, a random file name is generated for you. The file name generated in this case contains control characters and is unusable by the AIX operating system. FIX DESCRIPTION: Backed out the reentrant code in fopopen2.c for AIX. APAR NUMBER: IR40314 (AIX only) COMPONENT: Library Server PMR NUMBER: n/a APAR DESCRIPTION: When user uses multi-threaded application to continuously update and retrieve the same object using different threads over and over again, both update and retrieve will fail after a while. The pattern of the failure is unpredictable. After the failure occurred, the object cannot be used any more and needs to be re-stored. see fix for IR40115 - Library Services Apar. FIX DESCRIPTION: Enabled the achCapability field in the Store order. APAR NUMBER: IR40315 (AIX only) COMPONENT: Library Services PMR NUMBER: 99999 APAR DESCRIPTION: When user uses multi-threaded application to continuously update and retrieve the same object using different threads over and over again, both update and retrieve will fail after a while. The pattern of the failure is unpredictable. After the failure occurred, the object cannot be used any more and needs to be re-stored. FIX DESCRIPTION: Make elements in the element table unique for both retrieve and update, so the system will not pick up the wrong one (even with the same itemID, part number and Rep type) to process. Following is a list of NEW APARs closed since the last release. These APAR fixes are included in this release of the product. ------------------------------------------------------------------ New Release 2.4.1 APARS Service Level: UR02410 Date: 3/1/99 Following is a list of previous APARs closed since the last release. These APAR fixes are included in this release of the product. APAR Description of APAR Number ------------------------------------------------------------------- IR37283 The Ip2ListHistory API is failing on items which have been stored in a workbasket that contains a comma (',') in its name. The internal parsing of the EventData row in the SBTEVENTS table fails, because the comma is used as separator between the strings. The API can't parse the following ------------------------------------------------------------------- IR38604 Scanned documents converted to AFP data stream clipped when printed ------------------------------------------------------------------- IR38739 Displaying bad message if object server has a problem ------------------------------------------------------------------- IR38740 OLE Automation crash ------------------------------------------------------------------- IR38760 JPEG blue and red switch if there is no JFIF header ------------------------------------------------------------------- IR38781 Auto-foldered items don't get removed from wrong folder when re-indexed ------------------------------------------------------------------- IR38836 Static queries not created ------------------------------------------------------------------- IR38864 VI Client is hanging when closing a document window ------------------------------------------------------------------- IR39019 Object Server posts a vague msg in the application event viewer associated with an error msg icon. This msg in the app event viewer corresponds to a msg in the frndiag.log file, which is unclear to customer what it means. contents of EventData: "SCANNER1","Demo, testwb","100" ------------------------------------------------------------------- IR39268 Alternate Search user exit does not return empty fields ------------------------------------------------------------------- IR39271 Cannot log on to Lotus Notes to receive mail ------------------------------------------------------------------- IR39281 "Missing string" error logged to FFST ------------------------------------------------------------------- IR39292 OS/2 notelog doesn't display correctly under Windows ------------------------------------------------------------------- IR39293 Index class tabs should be sorted ------------------------------------------------------------------- IR39387 SVI PTOCA tag is not processed ------------------------------------------------------------------- IR39391 Object server is unresponsive or is hung. Shared memory is not being released eventually causing an out of memory condition. ------------------------------------------------------------------- IR39434 The page number dissapears if the client loses focus ------------------------------------------------------------------- IR39438 Memory leak problem generates FIW2203A ------------------------------------------------------------------- IR39487 OLE Suspend not handling attributes correctly ------------------------------------------------------------------- IR39506 Note log text should automatically word wrap ------------------------------------------------------------------- IR39512 Adding Euro Support. ------------------------------------------------------------------- IR39552 Occasionally, the wrong annotations appear for documents ------------------------------------------------------------------- IR39580 PCL not automatically selecting paper size ------------------------------------------------------------------- IR39736 Pause scanner after X pages have been scanned ------------------------------------------------------------------- IR39787 Y2K: Two-digit date fields were being saved incorrectly -------------------------------------------------------------------