IBM^(R) Everyplace^(R) Client Version 4.3.0 Fix Pack 5 Interim Fix 4 for Palm OS devices
Readme

This document contains information for IBM Everyplace Client Version 4.3.0 Fix Pack 5 Interim Fix 4 for Palm OS devices. This interim fix provides support for the following devices: Tungsten W, Tungsten C, and Treo 600.

This Readme contains the following information:

• What's included in Fix Pack 5 Interim Fix 4
• Prerequisites and corequisites
• Installing Fix Pack 5 Interim Fix 4
• Configuring DateBk5
• Enabling your device to synchronize with the server using VersaMail
• Working with invitations
• Limitations
• Notices
• Trademarks
  

What's included in Fix Pack 5 Interim Fix 4

Refer to the following list for the most recently updated APARS for this interim fix.

• PQ84340 - Special characters in the file attachment do not synchronize correctly. File names that include an accented character are truncated before the first accented character, and as a result the remaining characters in the file name, including the extension, is deleted. Because the file extension is deleted, Palm cannot determine which viewer to use to open the file.
• PQ84748 - If the synchronization is interrupted or stopped before the synchronization completes, the device starts a full synchronization as the next synchronization. However, an unnecessary full synchronization might cause the device data to overwrite the server data and use up unnecessary bandwidth and time. Instead, the device should resume the previous synchronization instead of starting a full synchronization.
• PQ84733 - The client does not synchronize recurring events with exceptions and does not handle time zone and daylight savings time properly. The DateBk5 support added for this release addresses all of these issues. In addition to these changes, All Day events on the server are represented as "No Time" events on the client, and similarly, All Day events on the client are represented as "No Time" events on the server.
• PQ87351 - The full synchronization message was confusing and had been reworded. During a full synchronization, all of the data from the device is sent to the server, and the server compares the data on the server with the data that the device just sent to the server. The server determines which data to keep using the modification times and conflict resolution rules defined in the user's synchronization profile on the server and sends the new set of data back to the device. The full synchronization process does not erase everything on the device an download a new copy of the data from the server.
• PQ87503 - The client returns a 413 error in the log for any event that is too big to store in the calendar. The event should be truncated to display on the device with as much preserved data as possible.

Refer to the following sections for an overview of the fixes from the previous release that are included in the Fix Pack 5 Interim Fix 4:

• E-mail and PIM application fixes
• Sametime Connect application fixes

E-mail and PIM application fixes

This interim fix is a cumulative release and includes the following list of APARS from the previous release:

• APAR PQ78686 The TZTOOL program was added to the package, and it will automatically be invoked when the user changes the time zone on the device. The user is then asked whether or not to change all the Calendar records for the new time zone.
• APAR PQ76902 While synchronizing e-mail with server, a fatal exception error occurs on Palm device
  In some cases, a dialog box whose title is "Fatal Exception" appears on Palm devices while synchronizing relatively large e-mail which includes many special characters.
• APAR PQ76935 During normal synchronization, error code 513 is displayed on the e-mail and PIM application's log
  When an invitation mail is synchronized down to the Palm devices, the user receives an Error code 513 message. This error is displayed because e-mail and PIM application does not support the synchronization of invitation mails. However, since no other information is provided, the user cannot determine what the error means. With the fix for APAR PQ76935, an invitation mail is synchronized to Palm Device as an e-mail with "Unknown" type attachment which includes raw data. Although this mail includes the information about the event, the function of invitation mails like Accept meeting or Reject meeting does not work, since the e-mail and PIM application does not fully support the synchronization of invitation mails.
• APAR PQ76915 When a communication line is disconnected during synchronization, a refresh synchronization occurs at the next synchronization.
  If a refresh synchronization occurs, the e-mail and PIM application sends all the data on the device to server. This results in the increased communication cost. This problem is fixed so that the type of synchronization after an interrupted synchronization will not be a refresh synchronization unless user intentionally sets synchronization type to "refresh" on the e-mail and PIM configuration panel.
• APAR PQ77399 e-mail and PIM application does not try to recover from previous network error state
  If a user initiates a synchronization session and an Internet session cannot be established due to a PPP timeout or some other error, the e-mail and PIM application will display one of the following message: Failed to open net library or Unknown Network Error. This message continues to be displayed in the subsequent synchronization until the device is reset or the user switches to another application such as a Web browser to establish a network session. The Fix Pack includes a fix that the e-mail and PIM application tries to reopen a connection if it is not open every time Synchronization starts.
• APAR PQ77506 A mail created on Palm device cannot be delivered to the destination if e-mail addresses in the "To" field are long
  When a mail on Palm device is synchronized to server, invalid "To" address is sometimes set in the mail. Consequently, this mail cannot be delivered to the destination. This error occurs when e-mail addresses in the "To" field are long.
• APAR PQ78686 Calendar entry times are not automatically updated when time zone is changed. After the time zone is changed, calendar entry times are not correct on a Palm device. Then, when synchronizing with server, duplicate calendar entries with different times are created if these entries have been synchronized before this synchronization. This problem is caused by a limitation on Palm Date Book. Therefore, no fixes are available.
• APAR PQ78592 When using filters, there are cases when e-mail size can still be bigger than 50 KB after it is encoded in base64.
• APAR PQ78610 A Fatal Alert is displayed in the Title bar when synchronizing more than 50 contacts. The error displayed is : MemoryMgr.c,Line:4450 Invalid chunk ptr occur.
• APAR PQ77953 Synchronization fails when Palm Tungsten W receives a call.
• APAR PQ78292 There is a delay between the time the user taps the Cancel button on e-mail and PIM application and when the synchronization actually stops.
• During synchronization, the Cancel button does not work in reasonable time.
• APAR PQ78135 If a calendar entry has a long subject line (longer than 77 characters) a space is added.
• e-mail in VersaMail with locales other than English are not synchronized with the server.
• E-mail in VersaMail Inbox disappear during synchronization.
• After synchronization, the subject of an e-mail is not shown.
• An e-mail with 50 KB crashes the e-mail and PIM application.
• e-mail and PIM application does not work with Everyplace Synchronization Server Version 1.3.0 Fix Pack 2
• A timeout value longer than 5 minutes does not work correctly.
• When using SSL, the timeout value is not used and Cancel does not work immediately.
• Synchronization will not finish immediately after a timeout occurs.

Sametime Connect application fixes

This interim fix is a cumulative release and includes the following list of APARS from the previous release:

• APAR PQ79519 Groups should not be expanded by default Save the info of collapsed groups and selected groups. The info are saved to preference on Palm and registry on Pocket PC. These info will be referred at each login to show groups on the Contact List. In the case of first login or the login user or hostname is different from the last login, then all groups will be shown and expanded by default on the Contact List.
• APAR PQ79520 Automatically sorted - Cannot unsort. The groups will be listed on the Contact List as the order that group info comes from Sametime Server.
• APAR PQ79521 "Show online only" not remembered. Remember the info of show online, show Shortname (Nickname). The info are saved to preference on Palm and registry on Pocket PC. These info will be referred at each login to show people on the Contact List.
• APAR PQ78256 Sametime Connect will not display any users if there are more than 10 groups. The groups are displayed, but they appear empty. Also, when a user is added, the new user appears to be offline, even if the user is online. The new user can send a message, but user cannot send a message to the new user, since the new user appears to be offline.
• In the Sametime Connect user interface, users cannot enter a user name that is longer than 16 characters.

Prerequisites and corequisites

PC requirements

• Palm Desktop
• 100 MB of temporary space

Device requirements

• Supported Palm OS device
• 8 MB of memory
• IBM Everyplace Client Version 4.3.0 (only required to use the Express Client Update application, included in WebSphere Everyplace Access Version 4.3.0 Fix Pack 5)
• Cradled connection is required to use the Everyplace Client install program
• Network connection to WebSphere Everyplace Access server is required to use the Express Client Update application

Device corequisites

• WebSphere Everyplace Connection Manager 5.0.1.3 Mobility Client for Palm OS is required if you want use Everyplace Client and the Mobility Client for Palm OS on the same device. You can download this from the WebSphere Everyplace Connection Manager support page. More details are included in the Everyplace Client Version 4.3.0 Fix Pack 5 Readme, EC_4305_Readme.html.
• DateBk5 version 5.1b.
• VersaMail version 2.5.1 for the Tungsten C, VersaMail version 2.5.2 for the Tungsten W, and VersaMail version 2.7 for the Treo 600.
• mRouter.

Server requirements

• Everyplace Synchronization Server Version 1.3.0 Fix Pack 5 with Interim Fix 2.
• WebSphere Everyplace Access Core Services Fix Pack 5 is required to use the Express Client Update application to distribute IBM Everyplace Client using Device Manager.

Installing Fix Pack 5 Interim Fix 4

There are two methods available to install Everyplace Client Fix Pack 5 Interim Fix 4. You can install the full Everyplace Client application on a Palm device that does not currently have Everyplace Client installed, or you can distribute just the fix pack to Palm OS devices that are already running Everyplace Client Version 4.3.0 or Everyplace Client Version 4.3.0 with Fix Pack 1, 2, 3, 4, or 5 applied. Use the PalmOS_430504.zip to install the full Everyplace Client application on a device that does not currently have Everyplace Client installed. Use the PalmOS_430504_DMS.zip to distribute Fix Pack 5 Interim Fix 4 to Palm OS devices with Everyplace Client Version 4.3.0 and higher installed.

Pick one of the following installation methods:

• Install IBM Everyplace Client Version 4.3.0 Fix Pack 5 Interim Fix 4 using the install program: Full installation
• Distribute IBM Everyplace Client Version 4.3.0 Fix Pack 5 Interim Fix 4 using Express Client Update: Update

Install IBM Everyplace Client Version 4.3.0 Fix Pack 5 Interim Fix 4 using the install program: Full installation

An install program is included with PalmOS_430504.zip. You cannot use the install program to install Everyplace Client Version 4.3.0 Fix Pack on a Palm OS device that is already running Everyplace Client. If the device is already running Everyplace Client, you must remove it first. If you do not want to remove the current installation, and it is version 4.3.0, you can use the new Express Client Update application to distribute the fix pack to the device. The Express Client Update application is included in WebSphere Everyplace Access server Fix Pack 5. For more information, read Distribute IBM Everyplace Client Version 4.3.0 Fix Pack 5 Interim Fix 4 using Express Client Update: Update below.

The following files are included in PalmOS_430504.zip:

If Everyplace Client is installed on your desktop and on your Palm OS device, you must remove it. When uninstalling Everyplace Client from the desktop, you must use the same version of the program you used to install Everyplace Client on the desktop. For example, if you installed Everyplace Client on your desktop using the Palm OS 3.5 installer, then you must use the Palm OS 3.5 installer to remove Everyplace Client from your desktop. After you remove Everyplace Client from your desktop, remove Everyplace Client from your device. To remove Everyplace Client, refer uninstalling section in Everyplace Client Information Center .

Note: If a user installs WEA 4.3 Palm Client Fix Pack 5 Interim Fix 4 to the same machine where WEA 4.3 Palm Client Fix Pack 5 has been already installed, WEA 4.3 Palm Client Fix Pack 5 is neither uninstalled nor overridden automatically. The user can uninstall WEA 4.3 Palm Client Fix Pack 5 by using the WEA Palm Client Fix Pack 5 Installer or selecting the Add/Remove Programs from the Control Panel.

Note: Before installing the fix pack, confirm the language preset value on the Palm device. Do the following:

1. Tap Preference on Home.
2. Tap Formats.
3. Confirm the language preset value:

Language	Preset value
en	United States, Canada, United Kingdom
fr	France
it	Italy
de	Germany
es	Spanish
pt_BR	Brazilian Portuguese
ja	Japan

 

Installing Everyplace Client Version 4.3.0 Fix Pack 5 Interim Fix:

Only install Everyplace Client on the device's main memory. Installing Everyplace Client to other locations, such as a memory card, is not currently supported.

1. Unzip PalmOS_430504.zip to a temporary file on the PC that connects to the Palm device, such as C:\temp\palmos.
2. Verify the Palm OS device is properly connected to the host PC and that Palm Desktop is running.

Note: If you have not HotSynced the device with the desktop or created a HotSync Desktop User Profile on your desktop for the device, you must create a HotSync Desktop User Profile on the desktop before you can continue.

4. Navigate to the appropriate folder for your Palm OS device. For example, if you have a Treo 600 device, navigate to the Treo 600 folder.
5. Double-click Setup.exe to start the install program.
6. Select the language that you want to install.
7. On the Welcome to the InstallShield panel, click Next to continue.
8. Click Yes if you accept the terms of the Software License Agreement. If you click No the installation will terminate.
9. Select the Palm Desktop User that matches the device you want to install.
10. On the Destination panel, specify where you want to install the files. To change the default install location, select Browse and select the appropriate location. Select Next.
11. On the Components panel, select the components you want to install and select Next. The available components include:
    • PIM and e-mail Synchronization
      Enables users to synchronize e-mail and PIM data between supported devices and backend servers, such as Lotus(R) Domino(R) and Microsoft(R) Exchange. This also installs invitation support and the code to support DateBk5.
    • DB2 Everyplace
      DB2 Everyplace allows mobile professionals to synchronize data that they need while away from the office.
    • IBM Device Agent
      Device Agent is the client program for the IBM Device Manager Server. Device Manager can be used to identify, configure, inventory, and distribute software.
    • Offline Portal Browsing
      Offline Portal Browsing provides a way to cache Portal Server content for offline operations.

    Note: This component is only available for Tungsten C.

    • Sametime Connect
      Sametime Connect allows current Sametime Server users to send instant messages to other connected users from handheld devices.
12. On the Start Copying Files panel, click Next to continue.
13. On the InstallShield Wizard Complete panel, click Finish.

Return to top

Distribute IBM Everyplace Client Version 4.3.0 Fix Pack 5 Interim Fix 4 using Express Client Update: Update

Use the Express Client Update application that was included with WebSphere Everyplace Access Version 4.3.0 Fix Pak 5 (EAS4305.zip), to install Fix Pack 5 Interim Fix 4 on devices that are already running Everyplace Client Version 4.3.0, or Everyplace Client Version 4.3.0 with Fix Pack 3 or Fix Pack 5 applied. To use the Client Software Express Update application, you will need the Everyplace Client files included in PalmOS_430504_DMS.zip.

The following files are included in PalmOS_430504_DMS.zip:

Note: Before installing the fix pack, confirm the language preset value on the Palm device. Do the following:

1. Tap Preference on Home.
2. Tap Formats.
3. Confirm the language preset value:

Language	Preset value
en	United States, Canada, United Kingdom
fr	France
it	Italy
de	Germany
es	Spanish
pt_BR	Brazilian Portuguese
ja	Japan

To apply Everyplace Client Fix Pack 5 Interim Fix 4 using the Express Client Update application:

1. Unzip PalmOS_430504_DMS.zip to a temporary directory on the WebSphere Everyplace Access server or a mapped network drive, such as C:\temp\wea4305_clients\palmos_update.
2. Open a Web browser and browse to the WebSphere Everyplace Access portal.
3. Log in as an administrator.
4. From WEA Home, click the Administration tab.
5. Create a group that contains only the Tungsten C, Tungsten W, and Treo 600 devices.
6. Click configure on the Express Client Update portlet.
7. Verify the host name of the WebSphere Everyplace Access application server is entered correctly. You should enter the fully-qualified host name.
8. Click OK.
9. Upload the Everyplace Client base package.
   1. Click Browse to find the Everyplace Client base update package, Base41_52.zip.
   2. Click Continue.
   3. On the next page, select the group that contains the Tungsten C, Tungsten W, and Treo 600 devices so that only those devices receive this update.
   4. Select Both.
   5. Click Install.
10. Upload the Sametime Connect package.
    1. Click Browse to find the Everyplace Client Sametime Connect application update package, Sametime41_52.zip.
    2. Click Continue.
    3. On the next page, select the group or groups that should receive this update.
    4. Select Both.
    5. Click Install.
11. Upload the DB2 Everyplace update package.
    1. Click Browse to find the DB2 Everyplace database synchronization application update package, DB2eSync41_52.zip.
    2. Click Continue.
    3. On the next page, select the group or groups that should receive this update.
    4. Select Both.
    5. Click Install.
12. Upload the DB2 Everyplace samples.
    1. Click Browse to find the DB2 Everyplace database synchronization samples update package, DB2eSample41_52.zip.
    2. Click Continue.
    3. On the next page, select the group or groups that should receive this update.
    4. Select Both.
    5. Click Install.
13. The Express Client Update application automatically generates the Device Manager job needed to distribute the update files.

To complete the installation on the device:

1. Perform software reset.
2. Start the IBM Device Agent on the Palm OS device.
3. Verify the server and user information is configured.
4. Tap Connect and follow the instructions on the screen.
   

Tip for installing Everyplace Client on Palm

Use default database name fields: The PIM Servlet field in the e-mail and PIM application configuration panel is filled with the following default names. These names are valid for WebSphere Everyplace Access server only. Modifying these defaults could cause synchronization to fail.

Return to top

Configuring DateBk5

DateBk5 provides support for time zone information and daylight savings time.

Configuring your device to use DateBk5

To configure your device to use DateBk5, complete the following steps:

1. Open the Sync Profile settings panel.
2. Tap Configure Calendar .
3. On the Calendar Configuration panel, select DateBk5 from the drop-down menu.

   Notes:

   • If you select DateBk5, you do not need the TZtool any longer needed and the TZtool will not run. Therefore, the TZtool will no longer be displayed after you select DateBk5.
   • Selecting DateBk5 enables support for time zone and Daylight Savings time. If you do not select DateBk5, you will be limited to the support provided by Date Book.

4. Tap OK.

Configuring the time zone on your device

To configure the time zone on your device, complete the following steps:

1. Tap the dbSetup icon.
2. Verify that the check box for World Timezones is selected.
3. Tap Install Checked Items.
4. Tap the DateBk5 icon.

5. Tap Options->Preferences->Zones.
6. Select the time zone you want to configure from the following options:

Note: Refer to the DateBk5 documentation for more detailed information about these settings.

• Current Zone

  The value you specify for this time zone indicates the time zone where the device is currently resides. The time of the event that is displayed in the calendar views is based on this setting. For example, if the display is 8:00 and the Current Zone is set to EST, that means that the event is at 8:00 in EST. This is the zone that you should adjust when you move from time zone to time zone. This time zone must match the time zone specified in the user's synchronization profile on the server. Whenever one of these is changed, the user needs to change the other. If the Current Zone and the Sync Profile do not match, the times of some events might not match.

• Create Zone

  The value you specify for this time zone indicates which zone to create the event in.

• Home Zone

  The value you specify for this time zone indicates the time zone where you devices usually resides. The Everyplace Client uses this as the default time zone for the device.

  Note: Do not change the time zone value for the Home Zone unless you permanently relocate to another location. If you change the time zone value for the Home Zone, you must delete the entries from your calendar and complete a full synchronization between your device and the server again to initialize your device to the correct home zone.

7. Select the time zone from the drop down list.
8. Tap OK to save your time zone configurations.

Return to top

Enabling your device to synchronize with the server using VersaMail

If you want to synchronize your e-mail with the server, configure your device to use VersaMail by selecting VersaMail on the configuration panel. Then,

Configuring your device to use VersaMail

To configure your device to use VersaMail, complete the following steps:

1. Open the Sync Profile settings panel.
2. Tap Configure Mail.
3. On the Mail Configuration panel, select VersaMail from the drop-down menu.
4. Specify your VersaMail account name and e-mail address.

5. Tap OK.

Return to top

Working with invitations

This interim fix enables you to receive invitations, reschedule notifications, and cancellations through e-mail messages in your inbox. An organizer, the person who invites you to an event, sends an invitation, reschedule notification, or a cancellation as an e-mail attachment. The following sections describe how you can view the invitation attachment and respond to the attachment. The remaining sections in this readme refer to these attachments as invitation attachments, regardless of whether the attachment is an invitation, reschedule notification, or cancellation.

Note: The e-mail message you receive from the organizer does not necessarily identify an invitation attachment differently than any other attachment. Therefore, you cannot tell that an attachment is an invitation, reschedule notification, or cancellation until you open the attachment.

Viewing invitation attachments

Complete the following steps to view an invitation attachment:

1. Tap the paperclip icon to open the invitation attachment.
2. In the Attachments dialog box, select the name of the attachment with an .eci extension that you want to open.
3. Tap View to open the attachment using the Invitation viewer and choose one of the options described in Responding to invitations. After you have finished reviewing the invitation attachment, tap Done.

Note: To save the attachment to your memory card (instead of storing the attachment locally on your device), tap Save To Card.

Responding to invitations

If the invitation attachment you opened is an invitation or reschedule notification, choose one of the following options:

• Tap Accept if you want to accept the invitation or reschedule notification.

The Everyplace Client adds the invitation information to the calendar on your device and deletes the e-mail message that contains the invitation from your inbox. The Everyplace Client also stores an e-mail message that indicates that you accept the invitation in your outbox. The next time you synchronize your mail, the server sends your e-mail message to the organizer.

• Tap Decline if you want to decline the invitation or reschedule notification.

The Everyplace Client deletes the e-mail message that contains the invitation from your inbox and stores an e-mail message that indicates that you decline the invitation in your outbox. If your invitation is a reschedule notification, the Everyplace Client also deletes any previous calendar events you accepted that are related to this reschedule notification. The next time you synchronize your mail, the server sends your e-mail message to the organizer.

• Tap Cancel to close the invitation attachment.

The Everyplace Client closes the invitation attachment and does not complete any actions on the attachment. The invitation remains in the inbox until you respond to the invitation attachment or take any other actions on the e-mail message, such as deleting the message.

If the invitation attachment you opened is a cancellation, choose one of the following options:

• Tap Remove Event to remove the invitation from your calendar.

The Everyplace Client removes the event from the calendar on your device and deletes the e-mail message that contains the invitation from your inbox.

• Tap OK to close the cancellation.

The Everyplace Client closes the cancellation, but does not remove the event from the calendar on your device. The cancellation will remain in the inbox until you respond to the invitation attachment or take any other actions on the e-mail message, such as deleting the message.

Uninstalling invitation support

To uninstall the invitation handler, refer to the instructions for removing RamDiskA in the Everyplace Client 4.3 Information Center and replace RamDiskA with ECInvHndlr.

Return to top

Limitations

Refer to the following list of limitations:

• Events cannot span midnight. Any single instance of an event that has an end time after midnight will be truncated to have an end time of 11:55PM on the same day. However, the Everyplace Client will insert a message into the note of the event indicates the event's original duration. By definition, any event longer than 24 hours spans midnight and as a result, will be truncated.
• DateBk5 events that span midnight are not supported. Although you can create these events on the device, the events will be truncated when they are synchronized with the server.
• VersaMail 2.5 does not permit you to tap on the subject field of an e-mail message if the subject field is longer than 128 characters.
  

  If you are using VersaMail 2.5 and you receive an e-mail message with a subject that contains more than 128 characters, do not tap on the subject field with your stylus. If you tap on the subject field, VersaMail will generate a Fatal Alert. You can still process the e-mail as long as you do not tap in the subject field.

• Date Book and DateBk5 only permit alarms with one unit of time, such as days, hours, or minutes. If an event is received from the server that contains mixed units, such as hours and minutes, the client accepts the largest unit of time and ignores the remaining units. For example, if you specify the duration of an event on the server as 1 hour and 30 minutes, the client will register the duration of the event as 1 hour and will ignore the 30 minutes. If an event is scheduled for more than an hour, regardless of whether you specify the event in minutes only or hours and minutes, only the hour is preserved; the minutes are truncated from the event.
• The maximum duration for an event received from the server is 99 hours. Therefore, any alarms longer than 99 hours in length, regardless of which units you specify on the server, will be truncated to 99 hours.
• DateBk5 assumes that Daylight Savings Time starts and ends at 12AM instead of 2AM. Events that start, end, or span these times on the days that Daylight Savings Time starts or ends might result in odd durations.
• On the Tungsten W, the Edit menu for DateBk5 is missing one item (Graffiti) and one is blank (Toggle Alarm).
• Switching between DateBook and DateBk5 is not recommended because switching between the two affects the validity of the data. Therefore, if the user needs to switch between the two, the user should clean the calendar with the following steps and then do a full synchronization.

Deleting all of the calendar entries in DateBk5

1. Tap Menu
2. Tap Purge Items.
3. Choose the appropriate day in On and Before field and check All in Delete from DateBook DB.
4. Tap OK.
5. On the Archive Flat Not Set panel, tap OK.
6. On the Purge Report panel, tap OK.

Return to top

Notices

This information was developed for products and services offered in the U.S.A. IBM might 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 might have patents or pending patent applications covering subject matter 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 information. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this information 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
Department LZKS
11400 Burnet Road
Austin, TX 78758
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 measurement 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.

All IBM prices shown are IBM's suggested retail prices, are current and are subject to change without notice. Dealer prices may vary.

This information is for planning purposes only. The information herein is subject to change before the products described become available.

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 illustrates 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.

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.

Each copy or any portion of these sample programs or any derivative work, must include a copyright notice as follows:

(C) (your company name) (year). Portions of this code are derived from IBM Corp. Sample Programs. (C) Copyright IBM Corp. 2004 All rights reserved.

If you are viewing this information softcopy, the photographs and color illustrations may not appear.

Return to top

Trademarks

IBM, Domino, Everyplace, Lotus, and WebSphere are trademarks or registered trademarks of the IBM Corporation in the United States, other countries, or both.

Microsoft is a registered trademark 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.

(c) Copyright International Business Machines Corporation 2002, 2003, 2004. All rights reserved.
U.S. Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.