UltraLite Java Edition Database Transfer utility (ULjDbT)

The ULjDbT utility provides the capability to transfer an UltraLite database from a BlackBerry smartphone to an external device,
such as a desktop, laptop, or server. In addition, you can delete a database, display database information, or view or email
the database transfer log. The utility consists of two applications that must run simultaneously—the UltraLite Java Edition
Database Transfer desktop application (ULjDbT) and the BlackBerry smartphone client application (ULjDatabaseTransfer.cod).

The desktop application receives UltraLite Java edition databases using a USB or HTTP connection method. When you start the
server application, it waits for a BlackBerry smartphone to transfer the database through the specified connection with the
client application. The connection is closed either manually through the application interface, when the application times
out, or when the transfer is complete.

Database Name
The name of the database to transfer to the external device. If the name starts with file:// (this is case sensitive), then the client application tries to find the database in the file system; otherwise, it finds
the database in the object store.

Database Password
The database password used to allow data transfer. If you leave Database Password blank, the default password is used.

Click Next.

The Action screen appears. This is the screen from which you can access all of the client application functionality.

On the Action screen, click the desired connection method (USB or HTTP).

For a USB transfer, click USB database transfer. For an HTTP transfer, proceed to step 4.

Follow the directions to start the database transfer desktop application.

Note

To ensure a successful database transfer, make sure that the device or simulator is connected to the BlackBerry Device Manager.
For a simulator, make sure that a USB connection is simulated using USB Cable Connected.

Click Next on the client application.

On the desktop application, make sure USB is selected and click Start.

The BlackBerry smartphone starts transferring the database to the external device. Progress information appears on the desktop
application.

Click OK on both the client and desktop applications to close them.

For an HTTP transfer, click HTTP database transfer.

On the HTTP Transfer screen, click Next.

Specify the following values:

Host
The IP address of your desktop.

Port
The port specified in Connection Properties on the desktop application.

URL Suffix
The hostname of the server receiving the transfer, including the http:// suffix (this is required).

Click Next.

Note

To transfer through the BES on a non-ident device, leave Suffix empty. On ident devices, use the suffix ;deviceside=false.

To transfer through Direct TCP use the suffix ;deviceside=true. Not all carriers support this feature.

The carrier's WAP gateway can be used if you know the APN information for it. You have to append that information to the suffix
as well. Note that even if you are going through a BES, there may be a firewall between the BES and the machine you are running
the UltraLite Java Edition Database Transfer utility on. In this case you need to use an SSL tunneler. On the HTTP Transfer Parmsscreen, specify the port and name or IP address of the SSL server running on the BES-side of the firewall. You also need to
specify the port the SSL client is mapped to the transfer application.

If you are transferring a database from a BlackBerry simulator, you need to have a BlackBerry MDS simulator running or specify
a URL suffix of ;deviceside=true to the UltraLite Java Edition Database Transfer utility running in the BlackBerry simulator.

On the desktop application, make sure HTTP is selected and click Start.

Click Next on the client application.

The BlackBerry smartphone starts transferring the database to the external device. Progress information appears on the desktop
application.

Run ULjDbTServ.cmd from the Bin32 directory of your SQL Anywhere installation.

The UltraLite Java Edition Database Transfer application loads.

On the Connect tab, click the desired Connection Method.

Under Connection Properties, specify the following values:

Port
This field only applies to HTTP connections. Type the TCP port number that you want the BlackBerry smartphone to connect
to. Usually, this port number matches the port number specified to the UltraLite Java Edition Database Transfer utility running
on the BlackBerry smartphone; however, if you are using SSL, then this number can be different.

BlackBerry Password
This field only applies to USB connections. Type the password used to access the connected BlackBerry smartphone when
it is locked. Leave this field blank if there is no password.

Timeout
The number of idle minutes before the server application times out and closes the connection.

Output
Specify a file name and location to which to save the transferred database.

Click Start to open a connection to the BlackBerry smartphone.

The server application waits until it either times out or establishes a connection. If you have specified an existing file,
you are asked whether you want to overwrite it.

The Logs tab provides details on the server status and transfer progress, including error messages.