Installing files on a MIDP supported device

This section describes how to install the DB2 Everyplace library and sample files on a MIDP supported device.

Prerequisites

You need to install a Web application server on your workstation before installing the DB2 Everyplace libraries and sample files. WebSphere Application Server 5.x, the embedded version of the IBM WebSphere^(R) Application Server - Express V5.0, or Apache Tomcat can be configured to run with DB2 Everyplace You must install one of these application servers before continuing.

MIDP for DB2 Everyplace has been tested on several different devices including RIM, Nokia, and Motorola. The following section describes how to install if your carrier is Nextel. Some devices load their applications over a data cable, some using infrared ports. Refer to the manufacturer's documentation for details. Before you install the DB2 Everyplace libraries and sample files on one of these devices, you must download an update application, which enables you to transfer files to your phone. To download this application:

1. Go to the Nextel Developer Program Web site at http://developer.nextel.com.
2. Apply to the Nextel Developer Program.
3. After you are registered for the program, download and install the iDEN Update application on your mobile phone.
4. Connect a Motorola RS232 or USB data cable from your computer to your phone.
5. Use the iDEN WebJAL to install the DB2 Everyplace libraries and sample files on your phone.
   • Enter your developer username and password when you launch the iDEN WebJAL application. A series of instructions appears under the heading "Developer Loading Utility."
   • Follow the instructions and click Continue.
   • Browse to DB2e\Clients\Midp\lib and select the VNurse.jad file.
   • Click OK. The installation begins.

     Both the VNurse.jad and VNurse.jar files are sent to the device during installation. The names of these files must match. If the file names are different, the installation will not succeed.

Procedure

To install the DB2 Everyplace libraries and sample application files:

Install the following files on the MIDP supported device. Table 193 contains the DB2 Everyplace library files. The files are located in \DB2Everyplace\Clients:

Table 193. DB2 Everyplace library files

You can use these files to develop your own MIDP applications or work with the sample application:

• The startup script for the Sun Microsystem Wireless Toolkit can be found in \DB2Everyplace\Clients\Midp\bin\run.bat
• MIDP API for ISync Java. Table 194 contains the files for Isync Java. They are located in \DB2Everyplace\Clients\Midp\lib
  

  Table 194. Isync Java files
  

  File Name	Description
  ISyncMidp.jar	MIDP ISync/Java API non-debug archive
  ISyncMidpDebug.jar	MIDP ISync/Java API debug archive

• Sample JAD and JAR files. Table 195 contains sample JAD and JAR files. They are located in \DB2Everyplace\Clients\Midp\lib
  

  Table 195. Sample JAD and JAR files
  

  File Name	Description
  Dump.jad	Dump utility jad file
  Dump.jar	Dump utility jar file for Dump.jad file
  Dump1.jad	Dump utility jad file
  DumpDebug.jar	Debug version of Dump utility
  VNurseDebug.jad	Vistiting Nurse jad file
  VNurseDebug.jar	Vistiting Nurse non-debug jar
  VNurseDebug1.jad	jad file for user1/user1/221 device id
  VNurseDebug2.jad	jad file for user2/user2/222 device id
  VNurseDebug3.jad	jad file for user3/user3/223 device id
  VNurseDebug4.jad	jad file for user4/user4/224 device id
  VNurseDebugt5.jad	jad file for user5/user5/225 device id

• Sample Source Code. Table 196 contains the sample source code. They are located in \DB2Everyplace\Clients\Midp\samples
  

  Table 196. Sample source code
  

  File Name	Description
  com\ibm\mobileservices\demo\Dump.java	Sample Source
  com\ibm\mobileservices\demo\ NursesAid.java	Aid to VNurse
  com\ibm\mobileservices\demo\VNurse.java	Sample Source
  ISyncSample.java	Simple MIDP Synchronization examples
  ISyncWorker.java	Simple MIDP Synchronization examples

• Filter Servlet JAR file and Tomcat setup files. Table 197 contains the filter servlet JAR and Tomcat setup files. These files are located in \DB2Everyplace\Clients\Midp\
  

  Table 197. Filter servlet setup files
  

  File Name	Description
  lib\FilterServlet.jar	MIDP Servlet non-debug jar file
  lib\FilterServletDebug.jar	MIDP Servlet debug jar file
  bin\dsytomcat.bat	Tomcat startup file

The Debug files are too large to fit on most devices, and display lots of trace output. They are intended for debugging your application during development in your IDE of choice. The numbered VNurse.jad files define various user, and password combinations that can run from the Sun Wireless Toolkit emulator (Midp/bin/run.bat). If you want to use one of these files on a phone, the root file name must match the JAR file. For example, VNurse3.jad must be renamed to VNurse.jad before you load it on a phone.

If you want to develop your own applications using the MidpISync.jar and the enclosed build.bat (ANT script) file, you can download and install the following software programs:

• Sun Microsystem's JavaTM 2 Platform Micro Edition, Wireless Toolkit. The toolkit provides a GUI or command line tool to compile and verify your midlet code.
• Apache ANT, used to build midlets and libraries from the Wireless Toolkit.

Related tasks

• Installing using the Install on Mobile Devices tool
• Installing DB2 Everyplace files manually
• Post installation tasks on the mobile device
• Setting up the DB2 Everyplace Update Tool on the Sync Server

Related reference

• DB2 Everyplace Update Tool error messages