MWA Server and Dispatcher Configuration Quick Start Reference
Key Mappings
This quick start reference is for setting up the
MWA telnet server and Dispatcher
MWA Configuration file
Setup mwa.cfg file
1. Locate file in $MWA_TOP/secure
2. Copy mwa_template.cfg to mwa.cfg
3. Edit mwa.cfg and configure following
parmameters:
a. Set mwa.DbcFolder=full directory of
.dbc file ending with /
b. Set mwa.DbcFile=dbc file name
c. Set mwa.logdir=full directory of log file
d. Set mwa.TelnetPortNumber=default
port#
e. Setmwa.DropConnectionTimeout=
no. of minutes
f. Set mwa.StaleSessionTimeout=
no. of minutes
g. Set mwa.LogLevel=error or trace
Environment Verification
Setup default_key.ini
1. Locate file in $MWA_TOP/secure
2. Use the default_key.ini if there is no
change
3. If you need to customize, create a new
file e.g. intermec2415_key.ini
a. Assocate Server-Defined actions
to Device keys
<Action> =<Key>=<Description>
e.g. MWA_CLEAR_FIELD=CONTROLK=Clear
b. Specify device’s width and height
Device IP
Setup deviceIP.ini
1. Locate file in $MWA_TOP/secure
2. Copy deviceIP_template.ini to
deviceIP.ini
3. This file is to associate device with a key
mapping file
4. Map the device name and IP address as
follows:
a) Mapping by device name
Intermec 2415=intermec2415_key.ini
b) Mapping by IP address
130.35.112.*=intermec2415.ini
(January 2003)
ü Verify the telnet port that is not in use
ü Verify the environment that is set
correctly by sourcing the
APPLSYS.env file
ü Verify $MWA_TOP is set correctly
ü Verify the DbcFolder and DbcFile
in the mwa.cfg file that is set to
the location and file name of your
Oracle Application .dbc file
ü Verify the log directory that exists
ü Verify the $CLASSPATH that
includes appsborg.zip and
apps.zip
Starting/Shutdown the MWA Server
To start the MWA telnet server:
1. Source the APPLSYS.env
2. cd $MWA_TOP/bin
3. mwactl.sh start [port number]
To shutdown the MWA telnet server
1. cd $MWA_TOP/bin
2. mwactl.sh –login xxx/yyy stop port#
where xxx is application user id with
system administrator responsibility and
yyy is the application user password
Note: for NT server, use mwactl.cmd script to
start/stop servers
 MWA Server and Dispatcher Configuration Quick Start Reference (January 2003)

D mwa.DispatcherClientsPerWorker=10 Alternating the MWA telnet servers

I Server 1 with Dispatcher
S port 2310 Starting/Shutdown the MWA servers
P and Dispatcher See metalink note: 198543.1 on how to use
A the dispatcher to bounce the MWA Servers
T To startup: at predefined intervals, so that database
C Server 2 • mwactl.sh start 2310 sessions can be refreshed, and possible
H port 2320 • mwactl.sh start 2320 memory leaking can be avoided.
E • mwactl.sh start 2330
• mwactl.sh start_dispatcher
R
Server 3 Mobile users connect to the Dispatcher port
2300 2300. Dispatcher will distribute mobile users
port 2330
among the three MWA servers.

Mobile users can hit control-X to view the

If you want to use the Dispatcher to perform
load balance among multiple MWA servers,
use the following steps to configure and
manage the Dispatcher.
Configuring MWA Dispatcher
Setup Dispatcher parameters in mwa.cfg
1. Specify the port number and machine for
running the dispatcher
mwa.Dispatcher=hostname:port#
Note: the dispatcher uses 3 consecutive
ports for internal control
2. Specify the dispatcher worker thread
count
mwa.DispatcherWorkerThreadCount=15
3. Specify the dispatcher clients per worker
MWA server port#, host name and other
connection information
To shutdown:
• mwactl.sh stop 2310
• mwactl.sh stop 2320
• mwactl.sh stop 2330 MWA CONFIGURATION HELP
• mwactl.sh stop_dispatcher For MWA configuration details, please see
following Metalink notes:
Note: MWA server will be terminated only
when all mobile users are disconnected. Mobile Applications Technology Stack:
New users cannot sign-on when the server is 163931.1
stopped. If you want to terminate the server
MWA Dispatcher port number usage:
while users are connected, you can use
stop_force to stop server immediately. 170939.1
Note: for NT server, use mwactl.cmd script to MWA Dispatcher usage and example:
start/stop servers 198543.1