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

Note: Patch 4178862 is a must when
Dispatcher is used.

Download and install Applications Release 11.5.10 Consolidate Update 1 (CU1),

patch or Mobile Applications Telnet GUI Server Patch 4178862.
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
or

Color to be used for LOV/Menu

Table background

mwa.gui.ReadOnlyTextColor #000000

Font Color to be used for read

only text

mwa.gui.RequiredTextBackGr #FFFF77
oundColor

Background Color to be used for

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

Note: Tab keys will NOT work if JDK other

2.

Download and install JDK 1.1.8 from

http://java.sun.com/products/archive/jdk/1.1.8_010/index.html.

3.

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

than 1.1.8 is used.

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
Note: Assuming \Windows\CrEme as the
CrEme JVM installed directory.

Installing GUI Client on RF Device is similar to the setup done for desktop as
described above. GUI Client can be installed on any RF Device that has Java VM
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

3.

MWA_GUI_TOP=\mwagui\
%MWA_GUI_TOP%\lib
%MWA_GUI_TOP%\log
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

Note: Assuming \Windows\CrEme as the
CrEme JVM installed directory.

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

\Windows\CrEme\lib\AWTclasses.zip;%MWAGUI_TOP%\lib\j4205328.zi
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

Note: Assuming \J9\PPRO10 is the

directory where J9 JVM is installed.

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

\J9\PPRO10\lib\jclPPro10\classes.zip;\J9\PPRO10\lib\jclPPro10\pproui.jar;\j2me\lib\j4205328.zip oracle.apps.mwa.awt.client.StartGUI
<hostname> <port>
For Jeode JVM

Note: Assuming \Windows is the directory

where Jeode JVM is installed.

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

oracle.apps.mwa.awt.client.StartGUI <hostname> <port>

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 devices 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 clients 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 devices 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.