Compact JADE can be run in the thin client configuration on Windows Mobile devices.
For details about accessing JADE applications from IIS or the Apache HTTP Server, see "Connecting to JADE Applications from Internet Information Server (IIS)" or "Connecting to JADE Applications from an Apache HTTP Server", in Chapter 3.
The Compact JADE control panel configuration program jadeconfig.cpl enables you to:
Configure the initiation settings for the JADE application to be run on a Windows Mobile device (for example, a PDA).
Modify JADE initialization settings for the Windows Mobile device.
With the release of Windows Mobile 6.5.3, Microsoft has moved the OK and X buttons from the top of a maximized form to the soft menu bar at the bottom of the screen. However, as JADE creates a user‑defined menu bar and Windows does not add the OK or X button to that type of menu bar, users could not close a maximized form. For all supported versions of Windows Mobile:
The Compact JADE control panel configuration program (jadeconfig.cpl) adds a permanent soft menu bar. Under Windows Mobile 6.5.3, this bar contains an OK button. For earlier Windows Mobile versions, the OK button is displayed in the caption line of forms.
This enables users to commit configuration changes under version Windows Mobile 6.5.3.
The jade.exe program for all Windows Mobile versions creates a standard Windows soft menu bar if there are two or fewer visible top‑level menu items and they do not have images defined. Those top‑level menus are assigned to the soft menu buttons on the menu bar (a maximum of two are available).
Under Windows Mobile 6.5.3, the menu bar also contains the Windows button and an X or OK button, if required, for a maximized form. For earlier Windows versions, the X or OK button continues to be displayed in the caption line of the form. If there are more than two visible top‑level menu items or a top‑level item has a defined image, a standard Windows soft menu bar cannot be created. The menu bar is user‑defined, and under Windows Mobile 6.5.3, there is no X or OK button displayed.
In this situation, your application has to include a user‑defined menu item that performs the close functionality using JADE logic. The alternative solution is to redefine the menu structure so that there are two top‑level menu items only.
With the use of a standard Windows menu bar, a soft menu item button displays only a small amount of text. If the text is too long, the text is truncated with trailing points of ellipsis (…).
If you want your application to retain the previous JADE menu bar style:
Ensure that the form is created with three or more visible top‑level menu items (or one with an image).
In the load event of the form, hide any menu items that do not need to be shown. If the number of menu items is decreased to two or fewer, the menu bar style remains as user‑defined.
However, if the number of visible top‑level items is increased beyond two, Windows changes the menu bar to a user‑defined style and the X or OK button will again not be displayed.
The Compact JADE installation process automatically installs the Compact JADE control panel configuration program jadeconfig.cpl in the \Windows directory. When the file is located in the \Windows directory of the Windows Mobile device, the JADE icon is displayed with a caption of Compact Jade in the System folder of the Settings menu of the Windows Mobile device.
The thin client download install program automatically copies any downloaded .cpl files into the \Windows directory.
Click the Compact Jade icon in the System folder, to display the Startup sheet of the Configure Compact Jade dialog.
To define your Compact JADE start-up options
In the Schema text box, specify the name of the schema that you want to invoke.
In the App text box, specify the name of the application that you want to initiate.
In A/S Host text box, specify the application server host address.
In the A/S Port text box, specify the application server port number.
Click the Ini File Options tab at the lower left of the dialog, to display the Ini File Options sheet. The Ini File Options sheet enables you to view and modify JADE initialization options stored in the Windows registry.
The Named combo box currently contains only the name of the CompactJade registry entry that holds all of the JADE initialization sections, and this value cannot be changed. (It is included for possible future enhancement.)
In the Section combo box, select the section name that you require from the list of all defined sections in the JADE initialization CompactJade registry section.
If the selected section has no defined parameters (keys), the Delete Key button is displayed as the Delete Section button, enabling you to delete the selected JADE initialization section.
In the Key combo box, select the parameter that you require from the list of all of the parameters defined within the JADE initialization section selected in the previous step.
In the Value text box, modify the displayed value of the selected parameter to meet your requirements.
To add a new JADE initialization section, click the Add Section button. This button is enabled only if the name displayed in the Section combo box in step 6 of this instruction has been modified so that it does not match the name of an existing JADE initialization section.
Click the Update Value button to set the value of the selected parameter to the contents of the Value text box or to create a new parameter with the value specified in the Value text box if the value displayed in the Key combo box has also been modified so that it does not match the names of an existing parameter in the JADE initialization section displayed in the Section combo box.
Click the Delete Key, to delete the parameter currently selected in the Key combo box.
Click OK button at the top right of the dialog to save any changes made to these controls and to close the program.
The changes made using this dialog are immediate, and are saved independent of clicking the OK button.