IBM(R) Content
Manager Client for Windows(R)
Version 8 Release 2
About these release notes
Hints and tips
Installation
Known problems and limitations
Documentation
Notices
These release notes contain new information, describe known problems, and
include updates to the documentation in support of Client for Windows Version
8.2.
This section contains hints and tips for administrators and for end
users.
- Menu behavior regarding Item Type Views, in conjunction with Access
Control Lists (ACLs).
- Client for Windows sometimes shows a menu enabled, but when the user tries
a feature, it fails due to insufficient user privileges. This is
because sub-view privileges and base-view privileges must both be enabled for
some features to be fully enabled. This is true only when user
authorization is based on sub-view ACL, as determined by the library
server's binding level.
The following menu options are affected:
- Add To Folder
- Remove From Folder
- Add to new Folder
- Check Out
- Attributes (Editing Attributes and Re-Indexing
- Delete
- Parts and ACLs
- Client for Windows does not perform part-level ACL validation.
Therefore, menu items like Open, Browse, menu items related to annotations,
menu items related to note log, and so forth are not disabled even if the user
does not have access to these parts. To avoid these problems, the
Content Manager system administrator should associate an ACL (to each of the
parts) that authorizes the user to read/add/update the parts under the
Document Management tab of the system administration client when
creating the item type.
- Deleting registry keys
- If item type definitions have been modified on the server and you
experience inconsistencies in the item lists (e.g., missing or
inconsistent attribute columns), try deleting registry keys under:
HKEY_CURRENT_USER\Software\IBM\Content Manager\8.x\Client
- Searching on item types that have child components
-
Consider the following setup on the server:
Item type 'Employee' has the following schema:
- SSN
- root attribute
- Name
- root attribute
- Business Address
- child component with minimum cardinality of 0
- Street
- child attribute
- City
- child attribute
- Phone
- child attribute that is NULLABLE (not required)
This item type currently has two items with the following attributes (see Table 1).
Table 1. Items and attributes
Item
| Attribute
| Value
|
1
| SSN
| 123-45-6780
|
| Name
| John Smith
|
| Business Address (child component 1)
|
- Street: 123 Sunshine St
- City: New York
- Phone: NULL**
|
| Business Address (child component 2)
|
- Street: 456 Sunset St.
- City: Albany
- Phone: (123) 456-7890
|
2*
| SSN
| 987-65-4321
|
| Name
| Chris Doe
|
* Note: this item has no child components ** Note NULL attribute
value.
|
- What results to expect when search against Employee where
BusinessAddress/Phone 'Is NULL'
- This search only returns the first item (from above) because it is the
only item that HAS a child component with attribute value of NULL. The
second item does not have a child component, and therefore does not have any
child attribute values to search against. There is, however, a way to
search against items that have no child components. To do this, you
need to know the internal name (as opposed to the display name) of the child
component and use the advanced search dialog to incorporate some advanced
query syntax (see Workaround below).
- Workaround for the example scenario above:
-
- Bring up the Advanced search dialog by clicking
Search-->Advanced... and click
New to create a new search.
- Select the Employee item type.
- Select Business Address/Phone from the Attributes box, and
Is Null from the Operators box.
- Select Add to Search.
In the large edit box below, the query you have just built is added.
The text in this box is editable. If you add OR (NOT
./BusinessAddress) to the end of the existing query, it adds a
condition that returns items that have no "BusinessAddress" child
components.
Important: Use the internal name of the child component
here.
- Understanding the difference between an empty string and a NULL
value.
- In character type attributes, an empty string, "", is not the same
as a NULL value. This might cause some confusion in the item lists, in
which for an attribute value, there seems to be no value shown, and might be
interpreted either as an empty string or a NULL value. Queries that use
the operators other than "Is NULL" and "Is not NULL"
(i.e., "Equal to", "Not equal to", "Less
than", "Greater than", "Like", "Not like", and so
forth) do not evaluate values where the attribute has a NULL value because
this value is "unknown" to the database. For example, there is
an item type with three items: one with attribute value of
"Fairfield", one with an empty string value, and one with a NULL
value. A query searching for items where the attribute is not equal to
"Fairfield" only returns the item with an empty string value, and not
the one with a NULL value. Queries using the operator "Is NULL"
return items where the attribute value is the NULL value, and not an empty
string.
This section contains information about installing and uninstalling Client
for Windows.
Uninstall does not clean up all environment variables. On some
systems, after an uninstallation is performed, some environment variables
might still exist on the machine. Prior to installing the new Client
for Windows, remove any instances of the OIVT environment variable from your
system variables. This can be done using the System Properties panel in
the Control Panel. If neither Content Manager nor Enterprise
Information Portal are installed on your system, then you can manually remove
the CMCOMMON environment variable. Important: Removing this
variable when you still have Content Manager or Enterprise Information Portal
on the system might prevent these products from working properly.
This section describes general and specific known problems and
limitations.
- Corruption of fixed-width character attributes on Unicode database.
- DB2(R) does not correctly handle fixed-width character
(i.e., CHAR) attributes on databases that store data in
Unicode. Workaround: Until a fix for this problem is available
from IBM DB2 support, use variable-width character (VARCHAR) attributes
instead of fixed-width character attributes when defining item types if you
created your library server using Unicode as the codepage.
- Incompatible EIP version
- If an incompatible version of EIP is installed after the Client and ODMA,
you might need to manually update the PATH environment variable in order for
the Client and ODMA to function properly. In the PATH, simply place the
Client's install directory BEFORE any other directories that may contain
similar EIP DLLs.
- Time stamps
- Time stamp fields are in an ISO-standard format and are not localized, so
you should expect to see
YYYY-MM-DD-hh.mm.ss.tttttt.
- Restrictions when running more than one instance of the client at a
time.
- It is possible to run more than one instance of the client application at
a time. However, this is not recommended and there are several
restrictions when running in this mode:
- Custom code written to the client's OLE interfaces can only
communicate with one instance of the client. The first instance of the
client that is started will process all OLE requests
- Display of thumbnails when viewing documents will not work if more than
one client is running. Thumbnails should be turned off via the menu bar
Option in this case.
- The default method of retrieving documents from the server (via URLs) will
not work. It is necessary to disable this method and use a slower
method of retrieval. To turn off the URL mode, the value of the
DisableURLCode line in the Options section of the
ICMClient.ini file in the Windows directory must be changed
so that it appears as follows:DisableURLCode=yes.
- Display of Stamp Annotation with Image
- In Windows 98 and Me, there is a problem displaying the stamp annotation
with image. Stamp annotation with text displays correctly.
- HTML documents
- As documented in the online help, we only support HTML versions through
3.0. We do not support javascript or XML.
- Display of "Office" format documents
- We do not guarantee 100% fidelity for display of non-image or Office
formats such as Lotus(R) 1-2-3(R), or RTF.
- Display of Microsoft(R) Works format documents
- We do not support the display of Microsoft Works formatted
documents.
- Display and printing of Lotus WordPro (.lwp) format documents
- Only one Lotus WordPro (.lwp) document can be displayed or printed
at a time. Any attempt to display or print a second WordPro document
when the first one is displayed causes the viewer to display an error
message.
- Printing annotations with a document
- Annotations must already be saved to a document before they can be printed
with it.
- Keyboard shortcuts
- The keyboard shortcuts (arrow keys, Home, End, Page Up and Page Down) do
not currently perform the scrolling and page navigation actions that are
described in the Keyboard shortcuts page of the documentation. This
will be corrected in the future.
- National language limitations for Thai
- We do not support the display of Thai text (other than possibly plain
text) in our viewer. This includes, but is not limited to: HTML,
RTF, and WordPro formats.
- National language limitations for Bi-Directional (BiDi) support
- We do not support the display of Right-to-Left HTML ("<HTML
DIR=RTL>" tag) or BiDi MSWord/RTF files.
- National language limitations for Turkish
- We might not support Turkish HTML encoded as
CHARSET=iso-8859-9. However, we do support Turkish HTML
encoded as CHARSET=windows-1254.
- All Item Type Search
- Depending on the complexity and number of item types on the server, a
search on <All Item Types> might not execute, and the following message
occurs: "The query is too long or complex". This can
occur if the DB2 configuration for SQL statement heap is too small.
To see the current stmtheap size, type:
db2 get db cfg for <database_name>.
To increase the size, type:
db2 update db cfg for <database_name> using stmtheap <size>.
If this error message still occurs, it could be due to the complexity and
number of item types defined on the server. One possible workaround is
to use the "Advanced Search" dialogs to create the query on a union of
item types. Selecting a specific subset of the item types, instead of
querying across all the item types, reduces the resulting SQL string that
would otherwise be "too long or complex". If an attribute
exists in many component types, then the error message might still occur, but
this workaround helps in many situations.
- Scanning with SCSI Drivers
- If you use a SCSI Adapter on a Windows XP machine to connect to the
scanner, then the latest version of the drivers (Version 4.71) can be
downloaded from the Adaptec web site:
http://www.adaptec.com.
- Selecting "Any Scanner w/ PIXTWAIN" in the scanner selection
dialog might not work for all scanners
- The Client for Windows uses software provided by Pixel Translations for
scanning purposes. This software is designed to work best with ISIS
drivers, so you should try to obtain an ISIS driver for your scanner.
However, some scanners only support TWAIN drivers.
To help with this problem, the Client for Windows is shipped with a special
driver called PIXTWAIN. This driver allows you to use TWAIN compliant
drivers with the Client for Windows. To configure a TWAIN source,
follow these instructions:
- Install the TWAIN drivers for the scanner.
- Run PIXCONFG.EXE from WINNT\PIXTRAN directory.
- Verify that you can see the TWAIN scanner in the Data Source drop-down box
in the PIXTWAIN Configuration dialog.
- Click Configure and follow the instructions to configure the ISIS over
TWAIN driver.
- Open the Client, and click Scan (or click File-->Scan from the
menu).
- Click on Device and in the scanner selection dialog, select this
entry: Name of Scanner w/PIXTWAIN.
Restriction: Do not select the Any scanner
w/PIXTWAIN entry.
If the Name of Scanner w/PIXTWAIN entry is not found, it implies
that Pixel was unable to locate the TWAIN driver. This is the only
situation when the Any scanner w/PIXTWAIN option should be
selected, and if this option is selected then the TWAIN driver for the scanner
has to be added manually by clicking Add on the scanner selection
dialog.
- Annotation preferences under the General tab do not take effect until
Client is restarted
- When you change viewer related settings from the Preferences dialog, the
changes are only reflected when the client is restarted, because viewer
settings are initialized when the client starts up.
- Inability to successively open files using ODMA-enabled Microsoft Word for
Windows.
- With certain versions of Microsoft's ODMA-enabled Word for Windows,
the application might not display the ODMA client's File-Open dialog
after a file that was previously opened via the ODMA client has been
closed. Workaround: Before attempting to open another
file stored on a Content Manager server via Microsoft Word for Windows,
terminate Microsoft Word for Windows and restart it. A fix for this
problem requires a fix to Microsoft Word. The IBM ODMA client is not
the source of this problem.
- Search results dialog header too small when ODMA client is used with Lotus
WordPro
- The column headers used to display the names of child component attributes
in the ODMA client's search results dialog might appear too narrow when
the client is used with Lotus WordPro. The headers are the correct size
when the client is used with Microsoft Office applications. This
problem is currently being investigated with Lotus.
- Incorrect file type in ODMA search results dialog for files saved with
Lotus WordPro.
- The ODMA client's search results dialog displays "ICM system
reserved" as the file type for files saved with Lotus WordPro. This
is due to a problem with Lotus WordPro.
- If you select Home on the Options menu in the ODMA help, you receive this
error message: The page cannot be displayed.
- This error does not impact the functionality of the help. ODMA help
does not have a home page.
This section contains corrections to the online help and to the
documentation.
- Performing basic searches:
- From the Basic Search dialog, click Help. The Performing basic
searches help panel opens. Expand the help topic How to perform a basic
search. In step #3, it states that child components and their
attributes are separated by dots (.). For example, in step #3,
it shows that "PolicyHolder.Last.Name" represents a
child component and its attribute. When, in fact, instead of
"PolicyHolder.Last.Name", it should say
"PolicyHolder/LastName". Attributes are NOT separated by dots
(.), they are separated by slashes (/). Also, the client does
not show three levels of an item, only two: the first level child
component and an attribute of that child component.
- Working with index information:
- In the help panel Working With index Information, expand the help topic,
Working with special attribute values. Step #1 in the instructions
about adding a new row tells users to add a row by clicking on the arrow in
the bottom row. The word "arrow" should be replaced by
"plus sign". This section should also include how to delete
rows. To delete a row:
- Select the row that you want to delete by clicking on the bullet.
- Push the Delete key.
- Using the Versions List:
- The Client for Windows online help, under Using the Versions List in the
Versions List dialog, says:
"If you select a previous version, the Client closes the current document
and displays the selected version in its place. If you select any
version other than the most recent one, the document is displayed in read-only
mode."
Correction to the help:
You can "browse" any version of the document, but you can only
"open" the current version. If you do not first close a
previous version of a document before attempting to browse/open a different
version, the previous version remains open.
- Process information
- The Getting work process information and Item lists
preferences pages of the online help refer to Step type and Date and
Time the item entered the step columns. These columns are not available
in this release of the Client for Windows.
- Keyboard shortcuts
-
The Keyboard shortcuts section of the documentation lists a number of
shortcuts for actions that are not currently supported. These actions
are:
- cut/copy/paste
- undo/redo
- move to front / send to back
- resize selected annotation
- view the first/last document
- new document
- toggle to next annotation
You should ignore these entries.
Additionally, shortcuts are listed for show/hide thumbnails and close all
documents, but these actions do not have shortcuts. Finally, the table
lists Ctrl + D as the shortcut for opening the scan window.
The correct shortcut is Ctrl + Shift + I, as shown in program on
the menu and toolbar.
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, Japan
The 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
J46A/G4
555 Bailey Avenue
San Jose, CA 95141-1003
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 document 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, the 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 was 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 the International Business Machines
Corporation in the United States, other countries, or both:
IBM
Microsoft, Windows, and Windows NT are registered trademarks of Microsoft
Corporation in the United States, other countries, or both.
Other company, product, and service names may be trademarks or service
marks of others.
First Edition (March 2003)
This edition applies to Version 8 Release 2 of IBM Content Manager for
Multiplatforms (product number 5724-B19).
(C) Copyright International Business Machines Corporation 2003.
All rights reserved. US Government Users Restricted Rights - Use,
duplication or disclosure restricted by GSA ADP Schedule Contract with IBM
Corp.