rev. May 6, 2002
This is a formal Corrective Service Delivery that will bring all systems at the syslevels described in the Installation Requirements to 7.1.3.0 (syslevel 07010300).
Enterprise Information Portal's customer support page is:
http://www.ibm.com/software/data/eip/support.html
Content Manager If you are applying this Enterprise Information Portal corrective service to a machine which has Content Manager installed, you must update your Content Manager programs to the latest version. To do this, you need to locate the Content Manager corrective service file and its accompanying ReadMe file.
The Content Manager corrective service file is located in the same directory as the Enterprise Information Portal corrective service file. The Content Manager corrective service file is named CM7105.WIN.EXE (for Windows) or CM7105.tar.gz (for AIX). Refer to the installation instructions below for instructions to locate the correct Enterprise Information Portal corrective service file.
The Content Manager ReadMe file is located in the same directory as this ReadMe file. The Content Manager ReadMe file is named CM7105_ReadMe.txt. Instructions for applying the Content Manager corrective service are contained in the Content Manager ReadMe file.
Note also that once this corrective service is applied to Enterprise Information Portal, if you decide to install Content Manager on the same machine sometime in the future, you must ensure that the Content Manager programs are updated to the 7105 (or later) level.
e-client
If you are using the Content Management e-client, you must get the latest
version.
The e-client CSD is located in FTP site:
ftp://ftp.software.ibm.com/ps/products/enterprise_information_portal/eclient/CSD/
This CSD is for Windows 95/98/NT/2000. In order to install this CSD, you must be at one of these minimum product base levels:
For AIX, to install this CSD, you must be at one of these minimum product base levels:
To determine your version, in a term window enter:
lslpp -L cmb* | moreThis displays all the versions of the EIP filesets.
Server hardware and software requirements -- AIX:
The hardware and software requirements for Enterprise Information Portal for AIX are listed in Planning and Installing Enterprise Information Portal.
To install this CSD on Windows, do the following:
Before starting the installation, be sure you are logged in with root authority. To install, do the following:
This procedure uncompresses the gzip file and extracts the tar file, eip7130.tar.
If you don't have the gzip utility, you can obtain a copy from:
http://aixpdslib.seas.ucla.edu/aixpdslib.html
Running this command first displays all the versions of the filesets that will be updated.
Uninstall removes all components no matter what you select in the components list.
The only way to uninstall any part of EIP is to completely uninstall EIP itself.
This CSD includes performance improvements in federated searches, achieved by caching certain elements from the EIP administration database on the first query to the federated datastore. By eliminating the rereading of entity mapping information on subsequent queries, performance is improved. You should be aware, however, of the following effects of this caching strategy with regard to EIP database administration:
The AFP plug-in shipped with EIP 7.1 (part of sample thin client) will not work with Internet Explorer 5.5sp2 or any later version of Internet Explorer. This restriction applies also to the e-client.
In this CSD, EIP system administration supports extending the system administration application to include custom functions:
This CSD includes a new connector for IBM OnDemand and the related classes and APIs, which now support the search and retrieval of OnDemand documents using the folder or the application group interface. Previous versions of the EIP OnDemand connector supported only searches on application groups. The new OnDemand connector classes are available for Java only.
ENTITY_TYPE=TEMPLATES;;
Be sure to include the semicolons (;) in the string.
Look at the sample programs TRetrieveWithCallbackOD, TRetrieveFolderWithCallbackOD, and TCallbackOD for examples of using asynchronous search.
Other OnDemand Connector Notes:
It is recommended to use a more restrictive search criteria to limit the number of items to be returned. One can also use the newly added executeWithCallback method to issue an asynchronous search. With the executeWithCallback method, one can set a threshold value that defines how many items the EIP should wait before sending them back. With this method, one can cancel the search at any time to reduce the amount of memory being consumed by the HUGE number of the search results.
The problem can be solved by increasing the default Java thread stack size. The default stack size from each Java thread is 400K which allows 3920 items to be returned before the stack overflows. Increasing its value to 800K raises the number items that can be return to about 7840; further increases raise the number accordingly.
To raise the Java stack size, you can use the Java command line option -oss followed by nnnK or nnM, where K stands for KiloBytes and M for MegaBytes. Examples:
java -oss900K classname arguments <== Sets the default stack size to 900KB java -oss2M classname arguments <== Sets the default stack size to 2MB
By default when a Windows socket is closed by an application, the Windows waits 240 seconds before closing it. During this time, the port that socket used is placed on the TIME_WAIT state and cannot be reused. The second restriction placed by the Windows is the highest port number that can be used is 5000 when an application requests any available user port from the system.
Therefore the default Windows socket defaults may not accommodate this very well without some tuning when the traffic is heavy between EIP the OnDemand server. The other connectors may not be transaction based so this problem does not show up as quickly.
To alleviate the problem, we recommend changing the Windows default values of these two parameters for systems running EIP communicating with OnDemand servers. You must use the Windows registry editor (regedit) to make the changes, so be very careful. Make the following changes:
HKEY_LOCAL_MACHINE\System\CurrectControlSet\services\Tcpip\Parameters\TcpTimedWaitDelayfrom its default of 240 to a smaller number. The valid range it 30-300 (decimal).
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Tcpip\Parameters\MaxUserPortfrom its default 5000 (decimal) to a higher number. The valid range is 5000-65534 (decimal).
For more information on these two parameters, you can search for TcpTimedWaitDelay and MaxUserPort on the MS Technet and Knowledge Base.
Also make sure the path name specified in cmbodtrace.ini is valid and that the line containing CMBODTRACEDIR is not preceded with a # sign.
Here is a sample cmbodCtrace.ini file:
#=============================================================== # OnDemand Trace INI file # # OnDemand Trace File Directory Name key - CMBODTRACEDIR # # The CMBODTRACEDIR key defines the directory where the trace files will # be written to. If the directory name does not exist, it will be created. # # Please make sure the path name does not point to an existing file name. # Otherwise, no trace files will be created. # # The trace output directory name can be changed to point to a drive where more # space is available. But it is recommended not to change the trace output # directory name in the middle of an active trace session. # # CMBODTRACESCOPE controls how much trace information to generate. # # CMBODTRACESCOPE=ENTRY_EXIT_ONLY # Trace only the entry and exit of all C++ methods and functions. # # If CMBODTRACESCOPE is missing, or set to anything else, a full trace will be taken. # # To disable the trace, add a leading # character in column 1 on the CMBODTRACEDIR line. # [ODCTRACE] CMBODTRACEDIR=c:\Ctrace #CMBODTRACESCOPE=ENTRY_EXIT_ONLY
The EIP OnDemand connector now supports both synchronous and asynchronous searches against an OnDemand content server in the application group mode from an AIX client. An asynchronous search does not tie up the main thread and allows the search to be canceled at any time. You can use executeWithCallback to perform an asynchronous search.
Take a look at the sample programs TClientRetrieveWithCallbackOD.java and TClientCallbackOD.java for examples of using asynchronous search.
If you are using VI/400 V 5.1, we suggest that you have all the latest fixes for the VI/400(CM/400) server. There have been quite a few since GA. The specific PTF for the retrieve problem is SI01900. Please contact VI/400 support team for the most up-to-date list of PTFs.
With CSD3, you can keep your EIP administration database on AIX; the administration client runs on Windows. After upgrading EIP on AIX to release 7.1.3, see /usr/lpp/cmb/config/readme.txt for instructions on how to install the EIP administration database on AIX.
To view PDF files in an EIP enabled environment:
Follow the existing instructions for associating PDF to Acrobat reader in the EIP enabled environment. Mainly, there are two approaches:
Please refer to the online-help or the user manuals for details.
To view PDF files:
To associate/view/edit OnDemand annotations for PDF files stored in OnDemand
servers in the EIP enabled environment, you need to do the following:
Note: Step (4) is only necessary if Acrobat is installed after EIP. If it is installed before EIP, then the EIP install will copy the file to the correct directory.
This section is for customers who do not have ibmcxx (IBM C and C++ compiler) but have only VisualAge C and C++ compiler (vacpp) and want to install EIPv7 Image Search Server and Client.
First, install all the EIP v7 components/subcomponents of the interest through the TaskGuide GUI except the subcomponents of Image Search Server and Client. Then, install these two using SMIT by selecting explicitly the following 3 filesets:
After the successful installation of the above filesets, do the following steps manually to configure the Image Search Server and Client.
On the Image Search Client, run the following commands:
On the Image Search Server, run the following commands:
chmod 666 $admhome/frn/qbic/qbic.ini
chmod 666 $admhome/frn/qbic/qbic_usr.ini
Also, the following error message might appear while defining a search template in EIP Administration or performing a search using the Enterprise Portal Client sample.
COM.ibm.db2.jdbc.DB2Exception: [IBM][CLI Driver][DB2/NT]
SQL0954C Not enough storage is available in the
application heap to process the statement. SQLSTATE=57011
db2cmd.exe db2clp.bat cmb712-713.bat cmbdb
where cmbdb is the name of the EIP administration database.
Note: If you have more than one EIP administration database, you need to run this batch file against each of them.
The Java Runtime Environment (JRE) 1.1.7 is not compatible with the Pentium(c) processor. JRE 1.1.8 007 or higher is required. Because the JRE is used during the install, the install will fail. "Previous releases of the JDK/JRE 1.1.x for Windows that include the Symantec JIT will not run on Pentium 4 systems (Solaris JDK/JRE 1.1.x for Intel are not affected). JDK 1.1.8_008 for Windows includes support for Pentium 4 systems only, no other changes are included in this release." (referenced from http://java.sun.com/products/jdk/1.1/jre/download-jre-windows.html , August 2001) To fix this problem, replace the JRE 1.1.7 files with JRE 1.1.8 files by completing the following steps:
When you search an EIP federated datastore with the e-client and you select the BETWEEN operator, only one entry field is displayed. You must enter the two criteria values in the field, separated by a comma, in this format:
first_value,second_value
When calling the CMBDocumentViewer terminate() method from within onDocumentClosed( CMBDocumentClosedEvent event) please use SwingUtilities.invokeLater(Runnable) or EventQueue.invokeLater(Runnable).
Usage:
CMBDocumentViewer viewerBean = new CMBDocumentViewer();
...
...
public void onDocumentClosed( CMBDocumentClosedEvent event )
{
...
SwingUtilities.invokeLater(
new Runnable() {
public void run()
{
try { viewerBean.terminate(); }
catch( Exception e) { System.out.println(e); }
}
}
);
....
}
Explanation of problem:
The CMBDocumentViewer terminate() method call waits until all document closed events are processed. Hence, when the terminate() is called from within the document closed event handler, there is a deadlock and the program hangs. The workaround to fix this problem is to call the CMBDocumentViewer.terminate() method using the SwingUtilities.invokeLater( Runnable ) method when calling it from within the onDocumentClosed( CMBDocumentClosedEvent ) event handler. This will add the terminate() call to the end of the event queue and continue with the other events in the queue( such as handling the other document closed events ) before calling the terminate method.
If you encounter problems starting either the EIP Administration client or the Enterprise Portal Client sample, modify the batch files that start these applications to set a smaller maximum Java memory allocation pool.
%CMBROOT%\jdk\jre\bin\java -Xms16M fedsa.client.FeCCMain file:///%CMBROOT%\cmbcs.ini file:///%CMBROOT%\cmbclient.inito this:
%CMBROOT%\jdk\jre\bin\java -Xmx200M -Xms16M fedsa.client.FeCCMain file:///%CMBROOT%\cmbcs.ini file:///%CMBROOT%\cmbclient.ini
These APARs are fixed in this CSD:
************************************
APAR NUMBER: IR46803 / AIX (readme update 25 Jan 2002)
COMPONENT: 5648D0391
PMR NUMBER: 09150,180,000
APAR DESCRIPTION: EIP 7.1.2.0 won't install Dynamic Page Builder due to
prerequisite failure of Net.Data. The prereq should be version 7.1.0.0
but the install requires 7.1.1.0 instead.
FIX DESCRIPTION: The install code has been corrected to reference NetData
7.1.0.0.
************************************
APAR NUMBER: IR47383 / Windows (readme update 25 Jan 2002)
COMPONENT: ONDemand Connector / 5648D03O2
PMR NUMBER: 79128,344,000
APAR DESCRIPTION:
Retrieval failures when connecting to an OnDemand AS/400 backend.
This problem is related to large applications group ID values used on
the OnDemand AS/400 server.
FIX DESCRIPTION:
EIP now uses an updated version of the OnDemand client which supports
application group identifiers greater than 64K.
************************************
APAR NUMBER: IR47258 / Windows (readme update 25 Jan 2002)
COMPONENT:
PMR NUMBER:
APAR DESCRIPTION:
ActiveX DxDataStoreFed.disconnect fails to logoff from
datastores it has connected to (C++ as well).
FIX DESCRIPTION:
Users connecting to CM through Fed layer,
would logon to CM twice, but be logged off
only once...causing a memory leak. Java is
okay, but C++ and ActiveX fails.
************************************
APAR NUMBER: IR42078 / Windows
COMPONENT: 5648D03J2
PMR NUMBER: 02578,111
APAR DESCRIPTION: When using the EIP Java visual beans and the CMBConnection
non-visual bean, the DataManagementEnabled and
SchemaManagementEnabled properties of CMBConnection
must be set to true (the default). If they are set to false,
null pointer exceptions occur in the visual beans.
FIX DESCRIPTION: DataManagementEnabled and SchemaManagementEnabled have
been deprecated. Calls to get these beans from CMBConnection will always
succeed.
************************************
APAR NUMBER: IR43984 / Windows
COMPONENT: JC / 5648D03J2
PMR NUMBER: 99999
APAR DESCRIPTION:
Update , Delete, and Create methods for note logs are not implemented in the
non-visual beans.
FIX DESCRIPTION:
Added Update, Delete, and Create methods for note logs in the CMBDataManagement
bean.
************************************
APAR NUMBER: IR44123
APAR DESCRIPTION:
The Planning and Installation document does not provide
enough instructions on all the steps required to get
this client working.
FIX DESCRIPTION:
In the Enterprise Information Portal for Multiplatforms
Planning and Installing EIP Version 7 Release 1, the
following information is added:
Chapter 5, Installing and configuring EIP server
components on Windows, "Configuring the Desktop client"
How to define a DB2 local alias with Client Configuration
Assistant
Before you begin:
Make sure the DB2 administrator has added you as a user to that
database and has set the privileges as a minimum to connect.
Make sure the remote workstation you are using has a live
network connection.
You must know the network protocol (TCP/IP, NetBIOS, etc.)
or the host name of the workstation where your DB2 database
is installed. You must know the name of the database you
are connecting to.
If you add any new users to the EIP database in DB2, restart
the database before you add the database using Client
Configuration Assistant.
1.Click Start/Programs/DB2/Client Configuration Assistant.
The Client Configuration Assistant window appears.
2.Click Add. The Add Database Wizard window appears.
3.Click the network protocol appropriate for your configuration.
Answer the prompts and click Finish.
4.Click Test the connection. The Connect to DB2 database
window appears.
5.On the EIP workstation, create a cmbds.ini file and
enter DATASOURCE=databasename; REPOSITORY=DB2.
6.Click IBM/DB2/Command Line Processor. At the prompt,
enter connect to dbasename user userid used to test
connection and press Enter. When prompted, enter the password
associated with the userid that gave you a successful test
connection in step 4.
You should now be able to connect the EIP desktop client to
the DB2 EIP database without being prompted for a password.
7.To modify the cmbcs.ini file to tell the client application
that the content connectors are installed locally, you need
to modify the cmbcs.ini file. Set all the backend servers
to LOCAL.
8.Modify the parameters in the cmbclientapp.bat file to start
the client application:
cmbclientapp (CMBROOT) (JAVAROOT ) (DB2HOME) (FEDSERVER) (INIURL)
where:
CMBROOT is the directory where EIP is installed
(default is c:\cmbroot)
JAVAROOT is the directory where the JDK is installed
(default is %CMBROOT%\JRE)
DB2HOME is the directory where DB2 is installed
(default is c:\sqllib)
FEDSERVER is the name of the EIP database
(default is cmbdb)
INIURL is the directory where the .ini files are installed
(default is c:\cmbroot)
Note: The keyword FEDSERVER is for the EIP database name.
Enter the alias of the EIP database, and not the host name of
the database server.
9.Setting the connectionType variable specifies the location of
the content server connectors. Set this variable to DYNAMIC.
Note: The shortcut in the Start menu overrides defaults. Verify the
arguments in the shortcut properties if you experience starting the client.
10.Ensure that the environment variables in the cmbenv.bat file in
the installation directory are set correctly.
************************************
APAR NUMBER: IR44333 / Windows
COMPONENT: JB / 5648D03J2
PMR NUMBER: 99999
APAR DESCRIPTION:
Sometimes cannot launch doc using CMBDocumentViewer and application seems
to be locked.
FIX DESCRIPTION:
A couple of reasons were discovered for this.
1) Locks are not always released when a document is edited.
2) A message window is sometimes hidden. This gives the appearance that the
app is hung, but in reality, the message window is modal, so since it is
waiting for user input, no other eip window will operate. Made the
message window always in the foreground.
************************************
APAR NUMBER: IR44481 / Windows
COMPONENT: 5648D0352
PMR NUMBER: 99999
APAR DESCRIPTION:
API information did not contain information on the connections string.
FIX DESCRIPTION:
Descriptions of the connection strings were added to the
Javadoc comments for DKDatastoreOD.
REFERENCE DOCUMENTATION:
Javadoc for DKDatastoreOD
************************************
APAR NUMBER: IR44615 / Windows
COMPONENT: ODV / 5648D03V2
PMR NUMBER: 30446,001
APAR DESCRIPTION:
Can't display TIFF documents from OnDemand using the CMBDocumentViewer bean.
FIX DESCRIPTION:
Added test for image/tif mimetype to the bridge to the OnDemand viewer.
************************************
APAR NUMBER: IR44616 / Windows
COMPONENT: JB / 5648D03J2
PMR NUMBER: 49448,500
APAR DESCRIPTION: The bridge dll used by CMBDocumentViewer visual bean to launch
the CM viewer is leaking memory.
FIX DESCRIPTION: Fixed problem caused by faulty logic in releasing dispatch
handles.
************************************
APAR NUMBER: IR44897 / Windows
PMR NUMBER: 99999
APAR DESCRIPTION: CMBLogonPanel visual bean: When the Change Passwords button
is pressed, the modal ChangePasswords dialog is displayed. When the password
is successfully changed, the CMBLogonPanel should generate an event.
FIX DESCRIPTION: CMBLogonPanel now generates an event in this situation
(CMBPasswordsChangeCompletedEvent).
************************************
APAR NUMBER: IR45012 / Windows
COMPONENT: Other / 5648D03C2
PMR NUMBER: 38520,370
APAR DESCRIPTION: Unable to change display name for display only search criteria.
FIX DESCRIPTION: Allowing display only criteria name to be changeable.
**************************
APAR NUMBER: IR45032 / Windows
COMPONENT: TC / 5648D03T2
PMR NUMBER: 22142,519
APAR DESCRIPTION: ThinClientInstall.html in EIP71 states in Part 3 Configuring
Web Application Server for EIP Thin Client Sample (Multiple Machines):
1. To set the application server attributes...
Thin Client Attributes
Property Name - cmbcs
Property Value -
Description: URL of the cmbcs.ini file that defines how to
access the content server runtime.
This value is used only when the
connectiontype is set to 2 (dynamic).
Default: not specified (null)
Typical EIP value:
file:///c:/cmbroot/cmbcs.ini
NOTE: This property is ignored when connectiontype is set to 0 (local) or 1 (remote).
This property is required when connectiontype is set to 2 (dynamic)."
Customer says that his connection type is 1 (remote) and that it
is NOT ignored.
When it is not specified, and he tries to search, it does not
try to go through RMI and there is a CMBInvalidQueryException.
Using tracelev 2, there is an InvocationTargetException . It
tries to look for a local connector. Once the customer defined
the cmbcs parameter, everything worked fine.
PS. The same documentation exists in "Managing EIP 71"
SC27-0875-00 (pages 77-78) as well in EIP 61 documents.
FIX DESCRIPTION: Added the following to description of cmbcs parameter
(under Part 3: Configuring Web Application Server for EIP Thin Client Sample
(MultipleMachines), Thin Client Attributes
NOTE: This property must be set regardless of the
connection type. This is because no matter what connectionType is,
the federated OOAPI always looks at cmbcs.ini to determine which
package to use (client, server or cs), and the thin client is only
using the federated datastore.
REFERENCE DOCUMENTATION: thinClientInstall.html/1.23/line 1466/
NOTE: This property must be set regardless of the
connection type. This is because no matter what connectionType is,
the federated OOAPI always looks at cmbcs.ini to determine which
package to use (client, server or cs), and the thin client is only
using the federated datastore.
************************************
APAR NUMBER: IR45038 / Windows
PMR NUMBER: 44009, 519
APAR DESCRIPTION: An application that implements CMBDocumentClosedListener
may hang when the CMBDocumentViewer bean's terminate() method is called
from within the onDocumentClosed( CMBDocumentClosedEvent ) event handler.
FIX DESCRIPTION:
The CMBDocumentViewer terminate() method call waits until all document closed
events are processed. Hence, when the terminate() is called from within the
document closed event handler, there is a deadlock and the program hangs. The
workaround to fix this problem is to call the CMBDocumentViewer.terminate()
method using the SwingUtilities.invokeLater( Runnable ) method when calling it
from within the onDocumentClosed( CMBDocumentClosedEvent ) event handler.
This will add the terminate() call to the end of the event queue and continue
with the other events in the queue( such as handling the other document closed
events ) before calling the
terminate method.
Usage:
...
CMBDocumentViewer viewerBean = new CMBDocumentViewer();
...
...
public void onDocumentClosed( CMBDocumentClosedEvent event ){
...
SwingUtilities.invokeLater( new Runnable() {
public void run(){
try {
viewerBean.terminate();
}catch( Exception e){
System.out.println(e);
}
}
});
...
}
************************************
APAR NUMBER: IR45111 / Windows
COMPONENT: DES / 5648D0382
PMR NUMBER: 28083,1LD
APAR DESCRIPTION: One could successfully Fetch a PDF document using DES connectors
from a DES file system source but could not read the correct mimetype to spinoff
the acrobat reader to display the fetched PDF document.
FIX DESCRIPTION: The DES connector code was not reading the mimetype from the CMBDB.
This is fixed in this APAR.
************************************
APAR NUMBER: IR45305 / Windows
COMPONENT: TS / 5648D0342
PMR NUMBER: 2731
APAR DESCRIPTION: The problem was the XML parser when found any char with
high bit (over 0x80) breaks out and start the algorithm for UTF-8,
So in our case parser will treat 0xB6 as byteOne , Next char
after 0xB6 as byteTwo and must follow UTF-8 rules . But in our
case the next char was space char 0x20 not as parser expected
this will lead to badEncoding "after initial byte of a UTF-8
character sequence" and exit parsing.
The installed driver also comprises fixes for the following APARs:
IR45383 Search within XML files was not correct for intersection word
IR45736 Invalid LIBACCESS library server parameters causes TSE client to crash JVM when using zero session handle in SimLibQueryObject()
IR46042 Text Search SIGPIPE handling causes Websphere to crash
FIX DESCRIPTION: Install the TSE fix delivered in this CSD to get a fix of
the above described problems.
SPECIAL INSTALLATION INSTRUCTIONS:
Install fixpack.
Installation procedure will take care of which parts are client, client and server.
The driver comprises a subset of TSE client and server parts. So please install your TSE AIX clients as well as the TSE server.
1. Stop the TSE server (imlss -stop instanceName) when running tasks
(indexing) are finished.
2. Issue "slibclean" command from root UID
3. Install the fix
4. cleanup the system from all left over shared memory and semaphores owned
by the UID which starts the TSE server
Use "ipcs" command to list.
5. Start TSE server
The TSE release-version installed now is: R5-59 ( imlss -copyright )
For the installation on WinNT apply the same procedure except step 2 and 4.
The installed driver also comprises fixes for the following APARs:
IR45383 Search within XML files was not correct for intersection word
IR45736 Invalid LIBACCESS parameters cause TSE client to crash JVM when using
zero session handle in SimLibQueryObject()
IR46042 Text Search SIGPIPE handling causes Websphere to crash
************************************
APAR NUMBER: IR45380 / Windows
PMR NUMBER: 99999
APAR DESCRIPTION: Unable to "tab" to password after entering the userid on EIP
logon screen.
FIX DESCRIPTION: In login.jsp, added onChange event handler in two places:
<INPUT type="text" maxLength=40 name=userid value="<%= inputUserid %>" align MIDDLE size=17 onChange="password.focus()">
<INPUT type="password" maxLength=40 name="newPassword" value="" align MIDDLE size=17 onChange="verifypassword.focus()">
************************************
APAR NUMBER: IR45421
COMPONENT: thin client
PMR NUMBER: 99999
APAR DESCRIPTION: When using the thin client to retrieve TIFF images, and two
documents are returned, the user clicks on the first one (works fine), but when
the user clicks on the second one, the same image from the first document is
returned.
FIX DESCRIPTION: original: if (!lastItemPid.startsWith(itemPid.substring(0,itemPid.length()-2))) {
fix: if (!lastItemPid.startsWith(itemPid.substring(0,itemPid.length()))) {
The original code caused problems if the pids differed only in the last two
characters (they matched, and the first item was viewed). The fix compares the
first n characters where n=length of the first pid.
**************************
APAR NUMBER: IR45569 / Windows, AIX
COMPONENT: Documentation
FIX DESCRIPTION:
The following Active X classes are not documented in EIP 6 or 7:
DXSequentialCollectionDL, DXSequentialIteratorDL, DXTextQueryDL, DXDDODL,
DXDatastoreDL, DXResultSetCursorDL, DXNVPairDL. All are available classes.
Documentation for EIP V8 will include these classes.
Currently the sort() method requires using a private class and is not
available for Java. This problem will be corrected in V8 and improved
documentation will follow.
************************************
APAR NUMBER: IR45571 / AIX
COMPONENT: API / 5648D0351
PMR NUMBER: 74288,519
APAR DESCRIPTION: When user is multiple parametric queries against DL with the content=no option
the object type not set properly.
FIX DESCRIPTION: Object type is set properly when content=no is used with multiple parametric
query.
************************************
APAR NUMBER: IR45593 / Windows
APAR DESCRIPTION: Wildcard functionality not working correctly. If the wildcard
is the only character used then both % and * the wildcard works with the LIKE
operator. If the wildcard is used at the end of a string (i.e. CRI%) then only
% works. Wildcards do not seem to work at the beginning or in the middle of a
search string.
FIX DESCRIPTION: Fixed function in CMBSearchTemplateViewer, CMBSearchTemplate
beans, and federated java api.
************************************
APAR NUMBER: IR45644 / Windows
PMR NUMBER: 02578,111
APAR DESCRIPTION: If a user is added to a user group that was previously
included on a search template or templates, that user group gets deleted
from the search template(s) and had to be re-added.
FIX DESCRIPTION: Function has been fixed.
************************************
APAR NUMBER: IR45696 / Windows
COMPONENT: Other / 5648D03M2
PMR NUMBER: 41735,001,806
APAR DESCRIPTION: When getMin() or getMax() is called using ActiveX or C++, no
values are being returned.
FIX DESCRIPTION: Function has been fixed.
************************************
APAR NUMBER: IR45736 / Windows
COMPONENT: TS / 5648D0342
PMR NUMBER: 24496,180
APAR DESCRIPTION: User typed "LIBACCESS=(datastore,userid,password)". This caused
the system to crash without reporting errors. Text Search should not call
SimLibQueryObject if the server name is invalid.
FIX DESCRIPTION: TSE library services called FM APIs without checking for a valid
session handle. This caused SimLibQueryObject() call to crash and Java Virtual
Machine with it. With the fix this can't happen any more. Just logging on to
CM will fail if uid and/or psw are wrong.
SPECIAL INSTALLATION INSTRUCTIONS:
The APAR record is just kept as a reference. The driver gets delivered with
fix for APAR IR45305
************************************
APAR NUMBER: IR46042 / AIX
COMPONENT: TS / 5648D0341
PMR NUMBER: 51767,032,724
APAR DESCRIPTION: Text Search SIGPIPE handling causes WebSphere to crash.
FIX DESCRIPTION: Install supplied fix.
SPECIAL INSTALLATION INSTRUCTIONS:
The APAR record is just kept as a reference. The driver gets delivered
and tested with fix for APAR IR45305
************************************
APAR NUMBER: IR46050 / Windows
COMPONENT: API / 5648D0352
PMR NUMBER: 30447,001,806
APAR DESCRIPTION: When doing searches through EIP, performance is slow.
FIX DESCRIPTION: Performance of EIP search was improved with updates
in several areas. The information for mapping federated entities to
native entities is cached so it reduces the database
interaction and the memory usage. SQL calls are also reduced
by caching the mapping information, joining SQL, and retrieving more
information in each SQL call.
************************************
APAR NUMBER: IR46089 / Windows
COMPONENT: TC / 5648D03T2
PMR NUMBER: 99999
APAR DESCRIPTION: The following error occurs when opening a folder in a workpacket.
0-errorreport.jsp: 2001-06-25 10:10:49.75: 9.82.159.164: Begin Exception Report
com.ibm.mm.beans.CMBException: Server error: DGL0303A: Invalid
parameter[56 2 DL6 LIBCM119 FBIData; LIBCM1; Case19 16
Z6C@VI5HR@PENCEHworklist=FBICaseWorkworkpacketid=20010625100806203000]
at com.ibm.mm.beans.CMBException.(CMBException.java:106)
at com.ibm.mm.beans.CMBDataManagement._retrieveAndSortContents(CMBDataManagement.java:3420)
at com.ibm.mm.beans.CMBDataManagement.retrieveItem(CMBDataManagement.java:969)
at C_0003a.CMBROOT.SAMPLES.jsp.clientapp.foldercontents_jsp_2._jspService(foldercontents_jsp_2.java:91)
at com.sun.jsp.runtime.HttpJspBase.service(HttpJspBase.java:175)
at javax.servlet.http.HttpServlet.service(HttpServlet.java:627)
at com.sun.jsp.runtime.JspServlet$JspServletWrapper.service(JspServlet.java:159)
at com.sun.jsp.runtime.JspServlet.serviceJspFile(JspServlet.java:505)
at com.sun.jsp.runtime.JspServlet.service(JspServlet.java:615)
at javax.servlet.http.HttpServlet.service(HttpServlet.java:627)
at
FIX DESCRIPTION: The code in itemlistdisplay.jsp was changed.
Added the & as shown in the following 2 lines.
ild_currWorkList.append("&worklist=").append(ild_workList); // fix
ild_currWorkPacket.append("&workpacketid=").append(ild_workPacketId); // fix
************************************
APAR NUMBER: IR46297 / Windows
PMR NUMBER: 99999
APAR DESCRIPTION: Beans and federated API: When a search template with a text search
criterion is used, and the value for the text search criterion is set to "", a
combined search is still performed.
FIX DESCRIPTION: Beans, ooapi, sample thin client changed to only generate a combined
search only if the text criterion is set.
************************************
APAR NUMBER: IR46297 / AIX
PMR NUMBER: 99999
APAR DESCRIPTION: CMBSTCriterion.setValue("") is not recognized correctly in the
OOAPI layer. Currently, when searching on "", the log files display tqterm = ( ),
when it should actually return tqterm = .
FIX DESCRIPTION: LOCAL FIX: Once bean and OOAPI layer has been fixed, then the .JSP
file can be changed.
For EIP Thin Client, in searchresults.jsp file, when text search criteria set to blank,
you must set crit[i].setValue("") or crit[i].setValue(new String("")).
**************************
APAR NUMBER: IR46355 / Windows, AIX
COMPONENT: Documentation
FIX DESCRIPTION:
The following information is an addition to the information on
DKDatastoreTS in the EIP online Application Programming Interface Reference:
boolean_query
[unary_operator] text_search_criteria
[[binary_operator [unary_operator] text_search_criteria]
... ]
Binary operators are AND or &, OR or |.
NOT is the only unary operator.
Search Argument
text_search_criteria is one of the following keyword/options,
where the dollar sign delimits the keyword/option:
{ search_argument |
$DOC$ '{' proximity_search_argument '}' |
$PARA$ '{' proximity_search_argument '}' |
$SENT$ '{' proximity_search_argument '}'
}
According to this syntax the following should be acceptable:
SEARCH=(COND=(NOT ($SENT$ {UNIX
software})));OPTION=(SEARCH_INDEX=TSTNGRAM)
but the NOT operator is not allowed with the keywords $DOC$,
$PARA$, $SENT$ as documented in the TextSearch API documentation
for EwhSearch.
************************************
APAR NUMBER: IR46451 / Windows
COMPONENT: OD/5648D03O2
PMR NUMBER: 20881,519
APAR DESCRIPTION: The EIP OnDemand connector DLL, cmbod716d.dll,
was not built properly. When running a Microsoft Visual Studio
C++ project with the debug setting linking to cmbod716d.lib, an
assertion failure will occur when a pCur->fetchNext() is called
after a search. The assertion point is in MSVC DBGHEAP.C.
The problem was caused by referencing both MSVCRTD.DLL (debug)
and MSVCRT.DLL (non-debug) in the debug version of OnDemand
connector DLL.
FIX DESCRIPTION: Rebuild the DLL, cmbod716d.dll, with only the
debug version of libraries to ensure MSVCRT.DLL is not referenced.
**************************
APAR NUMBER: IR46452 / Windows
COMPONENT: TC /
PMR NUMBER: 20400,379
APAR DESCRIPTION: When running the thin client samples with EIP 712 and WAS 3.5,
a search template query with a search string containing commas for the LIKE
operator causes "the document contained no data, try again later" error dialog.
After this error occurs, even when a search string with no commas is entered, the
query does not work anymore for the same search template.
FIX DESCRIPTION: Added an if statement to check for
between/not between/in/not in so that
parsing is only done for those operators.
Previously the code was parsing out the
comma for all operators.
************************************
APAR NUMBER: IR46456 / Windows, AIX
COMPONENT: ActiveX, C++, and Java Documentation
EIP online Application Programming Reference
FIX DESCRIPTION: The DKPid.setObjectType() method description should also say:
When associated with a federated datastore, the object type is composed of the
federated entity name, the backend server name, and the backend native entity,
all separated by a semicolon.
For example:
DKPid.setObjectType("FedEntity;BackendServer;NativeEntity")
**************************
APAR NUMBER: IR46464 / Windows
COMPONENT: TC / 5648D03T2
PMR NUMBER: 25965,379
APAR DESCRIPTION: Got a note from the customer that states there're also problems
with the combination of searches that involve the BETWEEN and EQ/LT/GT operator.
Here're the steps to reproduce the problem:
1. Create search template containing integer criterion and specify
BETWEEN/EQ/LT/GT operators.
2. Try EQ or LT or GT first for the search and it should work.
3. Try BETWEEN for the search, specifying a range. This should work
also.
4. Now, try EQ or LT or GT again specifying only a number (no range
specified), the search causes the "document contained no data" error.
5. Now, doesn't matter what you try for that criterion, the search
doesn't work anymore.
FIX DESCRIPTION: In searchresults.jsp,
Added the following because the code was using setValues regardless of the
number of values:
// IR46464 - use setValue if just one value
if (valuesArray.length==1) {
crit[i].setValue(valuesArray[0]);
}
else {
crit[i].setValues(valuesArray);
}
Added the following to clear the search data. After using the BETWEEN
operator, any subsequent searches were including the second value used by
BETWEEN because the array was not cleared. This resulted in an invalid query
exception because the single value operators had two search values.
// IR46464 - Added following to clear search data for criterion
for (int i=0; i <crit.length; i++) {
crit[i].clearSearchData();
}
**************************
APAR NUMBER: IR46475 / Windows, AIX
COMPONENT: Documentation: CM v7.1 SysAdmin Guide, Ch 11, p118
FIX DESCRIPTION:
In the CM v7.1 SysAdmin Guide, Ch 11, p118, the imlclpix command is
described as being used to "Remove all index entries from an existing
index on the text search server." This statement is somewhat half true
... it should say "This is a cleanup function for library server
consistency. This removes all index entries from an existing index on
the text search server which no longer exists in a CM library server"
Command line, imlclpix -h, gives the *correct* information.
**************************
APAR NUMBER: IR46493 / Windows
COMPONENT: FS / 5648D0302
PMR NUMBER: 85102,469
APAR DESCRIPTION: Federated connector returning all native attributes for first search.
FIX DESCRIPTION: Connector failed to register schema mapping to datastore properly.
Problem has been resolved.
**************************
APAR NUMBER: IR46600 / Windows
COMPONENT: API / 5648D0352
PMR NUMBER: 38362,519
APAR DESCRIPTION:
When customers run Federated layer application in a development environment in C++ or
ActiveX, the application would close the development environment unexpectedly.
FIX DESCRIPTION: Code has been fixed.
**************************
APAR NUMBER: IR46619
COMPONENT: 5648D0372
PMR NUMBER: 45219,519,000
APAR DESCRIPTION: DKWorkFlowServiceDL.listWorkBaskets method throws error in VAJ.
FIX DESCRIPTION: A missing statement is added into the code to fix the problem.
************************************
APAR NUMBER: IR46739 / Windows
COMPONENT: JB
PMR NUMBER: 38562
APAR DESCRIPTION: Folder contents not retrieved in method CMBItem.getFolderItem,
causing method to return no items.
FIX DESCRIPTION: Function has been fixed.
************************************
APAR NUMBER: IR46775 / Windows
COMPONENT: API
PMR NUMBER: 47132,519
APAR DESCRIPTION: It seems there are three methods in the
DXResultsFed object which are not implemented - replaceElementAt(),
removeAllElements(), and addElement().
FIX DESCRIPTION: Function has been fixed.
************************************
APAR NUMBER: IR46818 / Windows
COMPONENT: DL
PMR NUMBER: 00159,H39,649
APAR DESCRIPTION: When using the e-client to search for folders that
contain specific items, the search results return the folders. But
if the folders are opened, none of the items inside the folder are
listed. The items are inside the folder, but the e-client does not
list any of these items.
FIX DESCRIPTION: Function has been fixed.
************************************
APAR NUMBER: IR46897 / Windows
COMPONENT: JB
PMR NUMBER: 22014,077,724
APAR DESCRIPTION: The connect string property is being ignored
by CMBConnectionPool when creating connections.
FIX DESCRIPTION: Be sure to pass the connect string to new instances
of CMBConnection created by CMBConnectionPool.
************************************
APAR NUMBER: IR47256 / Windows
COMPONENT: JB
PMR NUMBER: 00160,H39,649
APAR DESCRIPTION: CMBSchemaManagement bean needs to filter CM
internal index class names. These names start with *FRN$ for
country code FRA.
FIX DESCRIPTION: Code has been fixed.
************************************
APAR NUMBER: IR47710 / Windows
PMR NUMBER: 40359
APAR DESCRIPTION: Errors when retrieving documents without
annotations from an ImagePlus/390 server with the e-client
FIX DESCRIPTION: Code has been fixed.
************************************
APAR NUMBER: IR47765 / Windows / AIX
COMPONENT: DL
APAR DESCRIPTION: On Windows and AIX, when changePassword method
is called, nothing happens. During the change, a method was
called to verify passwords. Before password verification, the
changePassword method would encrypt the password. This encryption
failed on certain systems.
FIX DESCRIPTION: Check has been removed, as it is no longer
required.
This information was developed for products and services offered in the U.S.A.
IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service.
IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not give you any license to these patents. You can send license inquiries, in writing, to:
IBM Director of Licensing IBM Corporation North Castle Drive Armonk, NY 10504-1785 U.S.A.For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to:
IBM World Trade Asia Corporation Licensing 2-31 Roppongi 3-chome, Minato-ku Tokyo 106, JapanThe following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you.
This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice.
Any references in this information to non-IBM Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk.
IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you.
Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact:
IBM Corporation J74/G4 555 Bailey Avenue P.O. Box 49023 San Jose, CA 95161-9023 U.S.A.Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee.
The licensed program described in this information and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement, or any equivalent agreement between us.
Any performance data contained herein was determined in a controlled environment. Therefore, results obtained in other operating environments may vary significantly. Some measurements may have been made on development-level systems and there is no guarantee that these measurements will be the same on generally available systems. Furthermore, some measurements may have been estimated through extrapolation. Actual results may vary. Users of this document should verify the applicable data for their specific environment.
Information concerning non-IBM products obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products.
All statements regarding IBM's future direction or intent are subject to change or withdrawal without notice, and represent goals and objectives only. This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental.
COPYRIGHT LICENSE: This information contains sample application programs in source language, which illustrate programming techniques on various operating platforms. You may copy, modify, and distribute these sample programs in any form without payment to IBM, for the purposes of developing, using, marketing or distributing application programs conforming to the application programming interface for the operating platform for which the sample programs are written. These examples have not been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these programs. You may copy, modify, and distribute these sample programs in any form without payment to IBM for the purposes of developing, using, marketing, or distributing application programs conforming to IBM's application programming interfaces.
The following terms are trademarks of International Business Machines Corporation in the United States, other countries, or both:
| IBM | ImagePlus | ||
| DB2 | DB2 Universal Database | ||
| WebSphere | OS/390 | ||
| AIX |
Java and all Java-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States, other countries, or both.
Windows NT is a trademark of Microsoft Corporation in the United States, other countries, or both.
Other company, product or service names may be trademarks or service marks of others.