Setting up a Palm mobile device or emulator for synchronization

This section provides information about setting up a Palm mobile device or emulator for synchronization. The topics covered are:

Setting up a Palm OS mobile device for synchronization

This section describes steps involved in setting up, configuring, and synchronizing a Palm OS mobile device for synchronization.

Procedure

To set up a Palm OS mobile device for synchronization:

  1. Set up and configure the Palm OS mobile device or emulator.
  2. Install files on the Palm OS mobile device or emulator.
  3. Synchronize and verify data on the Palm OS mobile device or emulator.

Related tasks

Setting up the Palm OS mobile device or emulator

This topic describes how to set up and configure a Palm OS mobile device or emulator for synchronization.

This task is part of the main task of Setting up a Palm OS mobile device for synchronization. After you complete these steps, return to Setting up a Palm OS mobile device for synchronization.

Procedure

Palm OS mobile device

Before you can test synchronization using a Palm OS device, you need a TCP/IP connection to the device. You can set up a TCP/IP connection by using either Windows Remote Access Service, or Mocha W32 PPP, which is a shareware utility. The Windows Remote Access Service or Mocha W32 PPP must be running on your workstation when your Palm OS device attempts to establish a TCP/IP connection.

Palm OS devices come with the HotSync Manager application, which runs on your workstation to synchronize personal information such as contacts and to-do lists. Most Palm OS devices connect to a workstation through a COM port. HotSync Manager, Mocha W32 PPP, or Remote Access Service must have access to this COM port to work properly. To avoid conflict, before you start Remote Access Service or Mocha W32 PPP, you must exit the HotSync Manager. Similarly, if you want to use the HotSync Manager, you must terminate Remote Access Service or exit Mocha W32 PPP.

To install and configure Mocha WP2 PPP:

  1. Download W32 PPP from http://www.mochasoft.dk/.
  2. Install Mocha W32 PPP on your workstation.
  3. Configure the Palm OS device using the directions in Installing files on a Palm OS mobile device or emulator.

Palm OS emulator

The Palm OS emulator is available to download from the Palm OS Web site at:
http://www.palmos.com/dev/tech/tools/emulator/

After you download the emulator, unzip the files to a directory.

The Palm OS emulator requires a ROM image file to run. You can obtain ROM image files from Palm by joining the Palm Solution Provider Program, or you can download a ROM image from your Palm OS device. For information on the Palm Solution Provider Program, visit www.palmos.com/dev/.

To transfer a ROM image from your Palm OS device:

  1. Use the install tool included with your Palm OS device to install ROM Transfer.prc and then synchronize with the Palm OS device to install this program. The ROM Transfer.prc file is included with the Palm OS emulator.
  2. Start the Palm OS emulator by running Emulator.exe.
  3. Click Download in the Palm OS emulator window.
  4. Complete the transfer of the ROM image by following the instructions displayed by the Palm OS emulator.

After you have a ROM image, configure the emulator to test synchronization.

Related tasks

Installing files on a Palm OS mobile device or emulator

This topic describes how to install files on your Palm OS mobile device or emulator.

This task is part of the main task of Setting up a Palm OS mobile device for synchronization. After you complete these steps, return to Setting up a Palm OS mobile device for synchronization.

Procedure

Palm OS mobile device

After the Palm OS device is connected to the DB2 Everyplace Sync Server, you can install the necessary files on your Palm OS device:

  1. Use the DB2 Everyplace Install on Mobile Device tool to install DB2 Everyplace. The Install on Mobile Device tool is available from the IBM DB2 Everyplace folder of Windows Start menu.
  2. Perform a HotSync operation to complete the installation of the files to the Palm OS device, then close the HotSync manager.
  3. Start the Palm OS Prefs application.
  4. Tap the menu title in the upper right corner of the Preference window, and select Network.
  5. Tap Connect. If the device fails to connect, verify that you correctly configured Mocha W32 PPP or Windows Remote Access Service.
  6. Tap OK. The Properties window closes.

Palm OS emulator

After you set up the Palm OS emulator and obtain a ROM image, install the DB2 Everyplace Sync Client, sample files, and the IBM Sync application on the Palm OS emulator. To install files on a Palm OS emulator:

  1. Start the Palm OS emulator.
  2. Right-click the emulator and select New.
  3. Click the ROM File push button and select Other. Open the ROM file that you obtained.
  4. Select a Device, Skin, and RAM Size for the emulator. The Device type must be the compatible with the ROM image that you obtained.
  5. Click OK. The Palm OS device emulation begins.
  6. Right-click on the Palm OS emulator window and select Install Application/Database -> Other. Alternatively, you can drag and drop or copy and paste the files to the Palm OS emulator window.
  7. Install applications from the DB2 Everyplace installation directory as described in Installing DB2 Everyplace files on a Palm OS device.
  8. Right-click on the Palm OS emulator and select Reset. The Palm OS emulator resets.
  9. Right-click on the Palm OS emulator and select Settings -> Properties.
  10. Select Redirect NetLib calls to host TCP/IP and click OK. The Properties window closes.

Related tasks

Synchronizing and verifying data on a Palm OS mobile device or emulator

This task is part of the main task of Setting up a Palm OS mobile device for synchronization. After you complete these steps, return to Setting up a Palm OS mobile device for synchronization.

Procedure

To synchronize and verify your synchronization:

  1. Start the Sync Server. For Windows, click Start -> Programs -> DB2 Everyplace -> Start Servlet for Sync Server from the Start menu. On UNIX, login as the DB2 Everyplace Sync Server instance owner and change directory to $DSYINSTDIR/Server/bin and execute dsysync.sh

    To verify that the Sync Server is running, go to http://127.0.0.1:<port>/db2e/db2erdb and ensure that you see the following message:

    DB2eSyncServer<datetime string>
    
    Note:
    Replace the port with the actual port of the DB2 Everyplace Sync Server.
  2. Start the mobile device or emulator.
  3. Click IBM Sync.
  4. Click Synchronize. The synchronization begins. You can stop a synchronization at any time by clicking the Cancel button. When the synchronization ends, one of the following messages will appear as the final synchronization status:
  5. When the Palm OS emulator or device displays the message Synchronization succeeded, open QBE.
  6. Specify a user name and password.
  7. Click the Select Table menu and select the VNMEDICALRECORD table. The contents of the table show on the screen.
  8. Open the Mobile Devices Administration Center and DB2 Control Center. For Windows, select Start -> Programs -> IBM DB2 Everyplace -> Start Mobile Devices Administration Center.

    For UNIX, login as the DB2 Everyplace Sync Server instance owner and change the directory to $HOME/db2everyplace81/Server/bin and execute dsyadmin.sh.

  9. Expand the object tree in the DB2 Control Center until you see the VNURSE database. Select the Tables folder of the VNURSE database to show the VNURSE tables.
  10. Right-click the VNMEDICALRECORD table and select Sample Contents from the menu.
  11. Compare the contents of the table on the Palm OS emulator or device to the sample contents of the table in the DB2 Control Center.

You have successfully synchronized data between your mobile device and DB2 Everyplace Sync Server.

Related tasks