Compiling and running the GoISyncConsole sample Java synchronization application

GoISyncConsole is a Java sample application to demonstrate the use of the DB2 Everyplace Sync Client Java API.

File contents for GoISyncConsole

• GoISyncConsole.java
• GoISyncConstants.java
• GoISyncListener.java
• isyncdb2.properties
• isyncdb2e.properties
• isyncdb2j.properties

Prerequisites

• Installation and configuration of the DB2 Everyplace Sync Server.
• Installation of the Sync Client binaries on the device. These are located in the Clients\platform\sync directories.
• If you are using a Cloudscape client, installation of Cloudscape on the device.

Procedure

1. Compile the GoISyncConsole application:

   This requires the isync4j.jar file, which is one of the Sync Client binaries.

   1. Open a command prompt.
   2. Type the following command:

      javac -classpath isync4j.jar *.java
      

2. Set up the environment:

   The path environment must be setup so that the Sync Client binaries can be located.

   • For Win32: Set your PATH variable to include the folder where the Sync Client binaries are located.
   • For Linux or Neutrino: Export the LD_LIBRARY_PATH to include the folder where the Sync Client binaries are located.
3. Run the sample:

   GoISyncConsole can be used with either the C client or with the Java DB2j client. A property file is used to determine which client to use. Sample properties files for both DB2e and DB2j are provided.

   • To use the C client, pass in the provided isyncdb2e.properties file by typing the following command:

     java -classpath isync4j.jar;. GoISyncConsole isyncdb2e.properties
     

   • To use the Java DB2j client, include the DB2j Sync Client jar, the Cloudscape jar file, and pass in the isyncdb2j.properties file by typing the following command (modify the text in italics if your Cloudscape installation directory is different):
     

     java -classpath c:\cloudscape_5.1\lib\db2j.jar;
     db2jisync.jar GoISyncConsole isyncdb2j.properties
     

   The application starts with a text menu containing the following options:

   • (1) Perform Synchronization
   • (2) Enable, Disable or Reset Subscription Sets
   • (3) Change Server Settings
   • (4) View The Log
   • (5) About Sync Client
   • (6) Exit
4. Specify option (3) to configure the server settings. This option will allow you to specify the Sync Server's IP address, your sync user name and password, and other options.
5. Specify option (1) to perform the synchronization.

   The GoISyncConsole application creates another property file called ISync.properties to save your preferences. If you change a property in isyncdb2e.properties or isyncdb2j.properties, you should delete ISync.properties before you rerun GoISyncConsole to ensure that the new changes go into effect.

Related concepts

• Overview of DB2 Everyplace synchronization providers