Oracle Mobile Applications

Graphical User Interface Client

An Oracle White Paper
February 2005
 Oracle Mobile Applications GUI Client

Overview............................................................................................................. 3
Advantages ......................................................................................................... 3
Software updates ............................................................................................... 3
Server Installation/Setup Instructions ........................................................... 4
Optional Server Side Setup.......................................................................... 4
Client Installation/Setup Instructions............................................................ 6
Desktop Client .............................................................................................. 6
On RF Device ............................................................................................... 7
For CrEme JVM....................................................................................... 7
For J9 JVM................................................................................................ 7
For Jeode JVM.......................................................................................... 7
Barcode Scanning.......................................................................................... 8
Capturing Trace Information...................................................................... 8

Oracle Mobile Applications Graphical User Interface Client Page 2

 Oracle Mobile Applications GUI Client

OVERVIEW
Until Applications Release 11.5.10 Consolidate Update 1 (CU1), users could view
the transactions on their mobile devices only in character-mode interfaces. From
Applications Release 11.5.10 Consolidate Update 1 (CU1) release, users can
optionally view all their mobile device transactions in graphical user interfaces. To a
large extent, these GUIs are similar to the desktop windows. The performance
characteristics of the new GUIs are the same as that of the character-mode
interfaces.
To use the GUIs, users need to install a J2ME compatible Java VM and the GUI
client application on their mobile devices. Users can also work with the GUIs on
their desktops for which standard Java support in Windows is sufficient. Network
access requirements for the GUIs are the same as that of the character-mode
interfaces. Similar requirements apply to desktop units. There are no additional
MWA middle-tier requirements. Within an installation, a mix of graphical and
character-mode devices may be used, driven from the same MWA middle-tier
server. In addition, any device that can run the graphical version can optionally
switch to the character mode at any time.

ADVANTAGES
• In the GUIs, the read-only and required fields are more visible with a different
background color unlike in the character-mode client.
• Users can navigate more easily to the fields/command buttons before or after
the current position in the screen using their mouse instead of tabbing through
fields to get to the desired one in the character-mode client.

SOFTWARE UPDATES
4178862: Mobile Applications Telnet GUI Server Patch
4205328: Mobile Applications Telnet GUI Client Patch

Oracle Mobile Applications Graphical User Interface Client Page 3

 SERVER INSTALLATION/SETUP INSTRUCTIONS
Download and install Applications Release 11.5.10 Consolidate Update 1 (CU1),
Note: Patch 4178862 is a must when
patch or Mobile Applications Telnet GUI Server Patch 4178862.
Dispatcher is used.

For GUI Client, user can select any of the existing devices from the device list
displayed on the device selection page. No additional setup is required.
Same port could be used for both character mode and GUI clients.

Optional Server Side Setup

A new "GUI Client" entry on the device selection page is seeded with
$MWA_TOP/secure/gui_key.ini file. The following are the newly added GUI
parameters in gui_key.ini files. Optionally these parameters can be
customized/modified if required.

Parameter Default Value Description

mwa.gui.height 350 Window Height (in pixels) of the

Telnet GUI Client

mwa.gui.width 300 Window Width (in pixels) of the

Telnet GUI Client

VISIBLE_TEXT_WIDTH 10 Used to determine if the cursor

should stop on read-only fields
while navigating upwards.
Default is 10, i.e. during upward
navigation the cursor would stop
on a read-only field only if it
contains more than 10 characters

mwa.gui.showOracleLogo TRUE Show/Hide the Oracle Logo that is

displayed on top of the Telnet GUI
window.
Possible values: TRUE or FALSE

mwa.gui.showLovIcon TRUE Show/Hide the LOV icon for the

LOV fields on the Telnet GUI
client window.
Possible values: TRUE or FALSE

mwa.gui.FontSize 12 Font Size of the characters

displayed on the client

Oracle Mobile Applications Graphical User Interface Client Page 4

mwa.gui.BackgroundColor #FFFFFF Background color of the client
window. Defaults to White color

mwa.gui.PageTitleColor #336699 Color to be used for Page Title

mwa.gui.TableBackgroundCol #F7F7E7 Color to be used for LOV/Menu

or Table background

mwa.gui.ReadOnlyTextColor #000000 Font Color to be used for read

only text

mwa.gui.RequiredTextBackGr #FFFF77 Background Color to be used for

oundColor required field

mwa.gui.GrayColor #CCCCCC Color to be used for the read only

text field's background

mwa.gui.TableBorderColor #CCCC99 Color to be used for the table

borders

mwa.gui.LogEnabled FALSE Determines whether the Log

should be enabled or not
Possible values: TRUE or FALSE

mwa.gui.logdir \j2me\log Log directory on the client

device/desktop

mwa.gui.SystemLog system.log Filename for log messages

mwa.gui.LogLevel ERROR LogLevel: Different log levels can

be set for obtaining more debug
information. Possible values
include: error, warning, debug,
trace

mwa.gui.EnableLogRotation Yes Enable log rotation of files based

on size (Yes/No)

mwa.gui.MaxLogFileSize 100000 If log rotation is enabled, then

rotation occurs when log file
exceeds MaxLogFileSize

Oracle Mobile Applications Graphical User Interface Client Page 5

 CLIENT INSTALLATION/SETUP INSTRUCTIONS

Desktop Client
Perform the following steps to install GUI Client on Windows Desktop
1. Create the following directory structures
%MWA_GUI_TOP%\lib
%MWA_GUI_TOP%\log
2. Download and install JDK 1.1.8 from
Note: Tab keys will NOT work if JDK other
http://java.sun.com/products/archive/jdk/1.1.8_010/index.html.
than 1.1.8 is used.

3. Download the GUI Client patch and unzip it to C:\Temp

e.g. PATCH_TOP=C:\Temp\4205328
4. Copy %PATCH_TOP%\j4205328.zip to %MWA_GUI_TOP%\lib
5. Create a .cmd file to run the class file oracle.apps.mwa.awt.client.StartGUI
6. Sample content of .cmd file to launch the GUI Client
set MWA_GUI_TOP=C:\mwagui
set JAVA_TOP=C:\jdk1.1.8
%JAVA_TOP%\bin\java -classpath
%JAVA_TOP%\lib\classes.zip;%MWA_GUI_TOP%\lib\j4205328.zip
oracle.apps.mwa.awt.client.StartGUI
7. Enter the hostname and port number in the "Connect" window and hit
the "Connect" button. A maximum of 10 connections can be stored.
Optionally the host name and port number can be passed as parameters to
oracle.apps.mwa.awt.client.StartGUI which would directly connect to the
MWA Telnet Server without displaying the "Connect" window to the user.

Oracle Mobile Applications Graphical User Interface Client Page 6

 On RF Device
Installing GUI Client on RF Device is similar to the setup done for desktop as
Note: Assuming \Windows\CrEme as the
described above. GUI Client can be installed on any RF Device that has Java VM
CrEme JVM installed directory.
installed with J2ME Personal Profile option.
Perform the following steps to install GUI Client on RF Devices
1. Install a J2ME Personal Profile option supported JVM if not already
installed e.g. CrEme, J9, Jeode etc.,
2. Create the following directory structures on the RF Device
MWA_GUI_TOP=\mwagui\
%MWA_GUI_TOP%\lib
%MWA_GUI_TOP%\log
3. Download the Mobile Applications GUI Client patch and unzip it to
C:\Temp (Desktop)
e.g. PATCH_TOP=C:\Temp\4205328
4. Copy %PATCH_TOP%\j4205328.zip (from Desktop) to
%MWA_GUI_TOP%\lib (on RF device)
5. Create a device specific startup script file to run the class file
oracle.apps.mwa.awt.client.StartGUI
6. Sample content of device specific startup script file to launch the GUI
Client on WinCE RF Device

For CrEme JVM

\Windows\CrEme\bin\CrEme.exe -Of -tiny –classpath

Note: Assuming \Windows\CrEme as the
\Windows\CrEme\lib\AWTclasses.zip;%MWAGUI_TOP%\lib\j4205328.zi
CrEme JVM installed directory.
p oracle.apps.mwa.awt.client.StartGUI <hostname> <port>
GUI Client with CrEme JVM must be run in tiny AWT mode. Please refer to
CrEme installation/user manual for setup details on running Java Applications
with -tiny mode.

For J9 JVM

\J9\PPRO10\bin\j9.exe -jcl:ppro10 -classpath

Note: Assuming \J9\PPRO10 is the
\J9\PPRO10\lib\jclPPro10\classes.zip;\J9\PPRO10\lib\jclPPro10\ppro-
directory where J9 JVM is installed.
ui.jar;\j2me\lib\j4205328.zip oracle.apps.mwa.awt.client.StartGUI
<hostname> <port>

For Jeode JVM

\Windows\EVM.exe –classpath %MWAGUI_TOP%\lib\j4205328.zip

Note: Assuming \Windows is the directory
oracle.apps.mwa.awt.client.StartGUI <hostname> <port>
where Jeode JVM is installed.

Oracle Mobile Applications Graphical User Interface Client Page 7

Barcode Scanning
When user performs scan operations on RF device; make sure that scanned value is
pre-appended with DATASTREAMINDICATOR specified in the device’s ini file
e.g. $MWA_TOP/secure/default_key.ini
Default DATASTREAMINDICATOR is ASCII 28.

Capturing Trace Information

The debug trace messages will be logged at the client side based on log level.
The log file and log directory will be taken from the .ini file parameters -
mwa.gui.SystemLog and mwa.gui.logdir. If the logdir parameter is invalid, then the
log file will be generated in the root directory from where the client in invoked.
GUI Client tracing can be captured in two ways.
1. Choosing the log level anything other than “None” on the client’s connect
window. Note: Connect window will be displayed only if the client is started
without specifying the hostname and port in the command line.
2. By specifying the following parameters in the device’s ini file on the server e.g.
$MWA_TOP/secure/default_key.ini
• mwa.gui.LogEnabled
• mwa.gui.logdir
• mwa.gui.SystemLog
• mwa.gui.LogLevel

In Production logging should always be turned off, unless requested by Oracle

Support.

Oracle Mobile Applications Graphical User Interface Client Page 8

White Paper Title
February 2005
Author: Anil Johnson
Contributing Authors: Sreenivas Thammaneni, Wilson Lau, Madhu Punuganti

Oracle Corporation
World Headquarters
500 Oracle Parkway
Redwood Shores, CA 94065
U.S.A.

Worldwide Inquiries:
Phone: +1.650.506.7000125

Fax: +1.650.506.7200
www.oracle.com

Oracle Corporation provides the software

that powers the internet.

Oracle is a registered trademark of Oracle Corporation. Various

product and service names referenced herein may be trademarks
of Oracle Corporation. All other product and service names
mentioned may be trademarks of their respective owners.

Copyright © 2000 Oracle Corporation

All rights reserved.