SCO HipCheck Java ME Client - Installation and Use Information

The HipCheck Java ME client runs on a wide range of modern handsets that are capable of running mobile Java applications.

Supported Devices

HipCheck runs on all BlackBerry handsets with OS version 4.1 or higher. This includes all the trackball models such as the Curve, the Pearl and the 88xx series. It also includes many trackwheel models still in use such as the 87xx and older models.

Hipcheck runs on Nokia Series 60 third edition devices and Series 40 devices with sufficient memory (such as the Nokia 6230i). It also runs on Sony Ericsson models with JP5 or higher Java software (this includes most models released since January, 2005).

For other manufacturers, such as Motorola, Samsung and LG, any Java enabled model released since January, 2006 should have the necessary version of the Java ME software (MIDP 2.0 and CLDC 1.1) and enough memory to run HipCheck.

HipCheck also runs on PalmOS based Treo and Centro handsets once the WebSphere Micro Environment has been download from the Palm support site and installed onto the handset.

Installation

There are three versions of the software. BlackBerry users must use the version created for BlackBerry handsets to be able to gain full use of the trackball (or trackwheel) and menu keys. Palm Treo users must install the version for PalmOS in order to be able to access HipCheck from the main application screen. But in all other respects, the three versions are identical. All other users should download the version labeled for use with Standard Java ME.

Installation on Standard Java ME handsets

To install using the handset's browser:

Select the link for the Standard Java ME client.
Click OK to accept the download.

To install without the browser (i.e. via cable, Bluetooth, infrared), follow the manufacturer's instructions for installing third party Java applications. You will need to download these files to your PC:

Installation on BlackBerry

To install using the BlackBerry browser:

Select the link for the BlackBerry client.
Click OK to accept the download.

To install using the BlackBerry Desktop Manager:

Download HipCheck.alx onto your PC.
Download HipCheck110_152.cod to the same folder location on your PC.
Start the Desktop Manager.
select "Add" and browse to the folder where you saved HipCheck.alx.
select HipCheck.alx.
in the Application Loader Wizard, make sure that the HipCheck checkbox is selected.
select "Next" to complete the installation.

Installation on PalmOS handsets - Treo and Centro

First you must install the requisite Java ME environment for PalmOS if you do not already have it on your phone. (You may already have it, if for example you have previously installed the Opera Mini-Browser, or if you have previously installed another Java ME-based application.) Instructions are given at the referenced Palm web page.

Then you must install the HipCheck Java ME Client package itself: HipCheck.prc . Follow the same general method as before with Palm Desktop Quick Install; it proceeds in a similar fashion to other Palm Treo applications.

Alternatively, you can also install the HipCheck Java ME Client "over the air". Start up the PalmOS Blazer web browser (the "Web" application on a Treo), and

Click on the PalmOS Treo link, and the HipCheck.prc application will begin to download. Respond "yes" to the subsequent questions you are asked.

Using either method, following successful installation you will see two new applications on the Treo "All Applications" screen: one is labeled "IBM Java VM", the other is labeled "HipCheck".

There is now one more very important step. Also in the Treo "All Applications" screen is an application called "Prefs". Start it, then under the category "Other" select "IBM Java VM". Under "Global preferences", select both "Use Double Buffering" and "Use high resolution coordinates" and enable them. (The phone may reboot at this point.) Without this step, the HipCheck Java ME client will not function properly, as it will have misdrawn screens and missing menu items.

If you are installing a new version of the client, there is no need to remove the old one first. You may simply install the new one over the old. If you just wish to remove the client, you may do so in the same way as you remove any other Treo application.

You are now ready to use the client. Start HipCheck by selecting the HipCheck application on the "All Applications" screen (there is no need to select or start the "IBM Java VM" application, that happens in the background).

Using HipCheck

The user interface for the HipCheck Java ME Client has the same overall functionality as the HipCheck Windows Mobile Client, and so there is no separate user documentation for it. Although many of the screens may look substantially different, especially on smaller screen sizes, you will find that the same same command choices are available to you. The exception is the "Tasks" menu option, normally available in the Windows Mobile version. In the Java ME client, it is frequently absent because the Alert or the Action is typically narrow in scope; for example it only applies to a particular printer or a single service. In these cases, you will find that the "Tasks" capabilities will be found in the associated Details screen.

The first time you use HipCheck, if the handset's screen is able to support anti-aliased fonts, you will be given the option to download custom fonts. These fonts are recommended as they allow you to see much more information on the screen at one time.

Navigation

The HipCheck Java ME client provides accelerator and other special keys to navigate the views efficiently and show as much data as possible at once. Some screen items automatically grow or shrink depending on where you are in the screen. In particular when looking at large tabular data or an extensive details screen, the table or detail list will often grow to fill the whole screen. The itemized details will also automatically expand as you move through them.

When the menu has been activated, a numeric choice next to a menu item can be immediately chosen by selecting that digit on the keypad. On some qwerty devices, you will have to use the shift mechanism to to select a digit, but on others HipCheck will recognize the keypad layout and interpret the digit without the shift key. In time more models will be recognized in this manner.

In general, whenever you are positioned in a table or other item that needs to scroll to show all its contents, you may use the following special keys to quickly move through the data:

2, 8, 4, 6 are pageUp, pageDown, pageLeft, pageRight respectively
1, 9 jump to the top or bottom of the data

Text Input

Today's handsets come with a bewildering array of input options, sometimes with multiple keypads or even a separate Bluetooth keyboard. At the other extreme, there may be no keypad other than an on-screen virtual keypad that comes and goes as needed. Many devices rely on sharing multiple characters and digits on a single key, often providing some form of multiple press or predictive software.

Press the select key (or click the field) to access the full text input capabilities of the handset for a particular input field. This will temporarily switch you to a customized screen (which differs for each handset manufacturer) to input or edit the text. While you will most often use this method to input or edit text, there are cases, usually only when you have a qwerty keypad at your disposal, where entering simple text directly will be more convenient. But you will still need to switch to the special input screen to edit text at the beginning of the field or to insert special symbol characters.

BlackBerry Tips

When in the BlackBerry's separate input screen, the automatic capitalization of input can be managed as follows. On qwerty devices, simply backspace over the wrongly capitalized key, then type the intended key again. It will become lower case the second time. On non-qwerty models like the Pearl (8100), leave the incorrect upper case key in place until you have finished typing the associated word; when it is complete, type the three key sequence: "space, backspace, backspace". Instead of erasing the last character, this will set the first capital letter to lower case (definitely not intuitive, but satisfyingly effective).

On trackwheel models, navigation usually works as expected, but sometimes will move up/down when you really want to go left/right. In these cases press the ALT key while rolling the trackwheel to move left and right.

On older trackwheel devices that don't have a dedicated menu/application key, the menus can also be activated by the 'M' key or the 'Q' key. This has the side effect that you you must switch to the BlackBerry input screen to enter text with these characters.

Some BlackBerry models allow you to configure application permissions. If you would like to reduce or eliminate screens that require you to permit HipCheck to use the network, try the following:

Select "Options" -> "Advanced Options" -> "Applications", then press the menu key.
High-light and select "Edit Permissions", then set all options as "Allow".

Treo Tips

When a HipCheck alert arrives on your phone while working in the HipCheck client, you can read the alert text there on the screen and hit "Clear" and return to the HipCheck application. However, if you hit "Go to" and are taken into the SMS application to read the alert, that will terminate the HipCheck application and you will have to restart it again. This is due to the nature of the PalmOS single-threaded architecture.

HipCheck is unable to access the dedicated menu key on the Treo. The menus can instead be activated from the keypad by using the 'M' key or the 'Q' key. This has the side effect that you must switch to the Treo input screen to enter text containing either of these characters.

Known Issues with the Java ME client

The following are known problems that will be fixed as soon as possible.

There is no Hardware View.
There is no capability to specify a sort order for the table data.
There is no automatic update facility of the client when a new HipCheck version is released.

Please read the following export notice:
Please note that the electronic transfer of this data to a destination outside of the United States constitutes an export (as defined by the U.S. Bureau of Export Administration) and is authorized ONLY to the end user. Any subsequent re-exportation of this data requires that the end user obtain an additional export license. Also note that it is illegal to re-route SCO product to Cuba, Iran, Iraq, Libya, North Korea, Sudan or Syria and that you must file a special license if you intend to reroute goods to the embargoed regions of Taliban controlled areas of Afghanistan. Placement of this order constitutes an agreement to comply with these stipulations.