Release Notes for Openwave SDK 6.2 WAP Simulator Plug-in


Contents

Installing the WAP Simulator Plug-in
Using the SDK
Using the Command-Line Arguments
Arguments and Parameters
Known Problems


The OpenwaveTM SDK 6.2 WAP simulator plug-in is a package that includes the WAP version of the Openwave Mobile Browser 6.2 simulator, Release Notes for the WAP version of the simulator, and supporting files. You must install the Openwave SDK 6.2 before you can install the WAP simulator plug-in. These release notes describe how to install the Openwave SDK 6.2 WAP simulator plug-in and how to use the WAP version of the Openwave Mobile Browser 6.2 simulator. For more information about the Openwave SDK 6.2, including what's new in this release, see the Openwave SDK 6.2 Release Notes.


Installing the WAP Simulator Plug-in

Once you have downloaded and installed the Openwave SDK 6.2, as described in its Release Notes, you can install the WAP simulator plug-in.

To install the Openwave SDK 6.2 WAP simulator plug-in, download its InstallShield package from the Openwave Developer Program web site and install it in the same directory as you installed the Openwave SDK 6.2 package.


Using the SDK

Important: These release notes describe how to use the WAP version of the Openwave Mobile Browser 6.2 simulator. If you're using the HTTP version of the Openwave Mobile Browser 6.2 simulator, be sure to read the release notes for the HTTP version of the simulator: The file names, arguments, and parameters supported by the HTTP version are different than those supported by the WAP version.

When you install the Openwave SDK 6.2 WAP simulator plug-in, the installer creates an Openwave SDK 6.2 WAP menu item in the Start > Programs > Openwave SDK 6.2 menu. This menu item is in fact a link to a batch file:

C:\Program Files\Openwave\SDK 6.2\program\wap\OSDK62wap.cmd

You can choose this menu item to start the SDK in its default configuration.

However, to take full advantage of Openwave SDK, you can change the default configuration and control the SDK at startup or after it's running by:

When you install the Openwave SDK 6.2 WAP simulator plug-in with the default installation options, the WAP version of the Openwave Mobile Browser 6.2 simulator is installed in:

C:\Program Files\Openwave\SDK 6.2\program\wap\OSDK62wap.exe

When you start the SDK, the Openwave SDK 6.2 window opens, with a simulation of a mobile device featuring keys you can click and a display for content, useful menu commands, and so on.

The simulator's View menu includes commands that display additional information in the Phone Information window. You can use the -showphoneinfo command-line argument to set the SDK open the Phone Info window at start-up.

The Phone Information window displays a wide variety of information about the commands you execute and their results, including debugging information. The information displayed in the Phone Info window is also written to a log file, named sim.log, which is stored in the same directory as the SDK application file. Each time you start the SDK, a new sim.log file is created, and the log file from the last session is renamed sim.bck.


Using the Command-Line Arguments

Keep the following in mind as you use the command-line tools to control the SDK.


Arguments and Parameters

The following arguments to OSDK62wap.exe are supported by the SDK.

Argument -help
Description Displays a summary of SDK command-line arguments in the SDK's Phone Information window.
Example OSDK62wap.exe -help


Argument -showphoneinfo
Description Starts the SDK with the Phone Information window open.
Example OSDK62http.exe -showphoneinfo
Notes This argument replaces the -noconsole argument from previous SDKs.


Argument -exit
Description Causes the SDK to exit.
Example OSDK62wap.exe -exit
Notes Equivalent to choosing the SDK's File > Exit command.


Argument <URL>
Description If the first string after the SDK executable does not start with a dash ( - ), the SDK tries to load that string as a URL, as if it were parameter of the -reload argument.
Example OSDK62wap.exe file://c:/mydecks/index.html

OSDK62wap.exe http://developer.openwave.com/dhome5.cgi


Argument -reload [<URL>]
Description When used without the optional URL, reloads the current URL in the SDK's simulator window.

When used with a URL, marks that URL as invalid in the SDK's cache and then opens the specified URL.
Example OSDK62wap.exe -reload

OSDK62wap.exe -reload file://c:/mydecks/index.html
Notes When used without a URL, equivalent to the SDK's Edit > Reload menu command (F9).


Argument -go <URL>
Description Opens the URL in the SDK's simulator window.
Example OSDK62wap.exe -go http://developer.openwave.com/dhome5.cgi

OSDK62wap.exe -go developer.openwave.com/dhome5.cgi

OSDK62wap.exe -go file://c:/myapplications/demo/index.html
Notes Equivalent to entering a URL or path in the SDK's Go field.

For URLs, you can omit http://.

For files, you must include file://. You can enter an absolute path name or a path name relative to the location of OSDK62wap.exe.


Argument -gohome
Description Opens the current home deck in the SDK's simulator window.
Example OSDK62wap.exe -gohome
Notes Equivalent to entering device:home in the SDK's Go field.

This argument is ignored if used when starting the SDK.


Argument -sethome <URL>
Description Sets the SDK's home deck.
Example OSDK62wap.exe -sethome http://developer.openwave.com/dhome5.cgi

OSDK62wap.exe -sethome developer.openwave.com/dhome5.cgi

OSDK62wap.exe -sethome file://c:/myapplications/demo/index.html
Notes For URLs, you can omit http://.

For files, you must include file://. You can enter an absolute path name or a path name relative to the location of OSDK62wap.exe.

This argument only sets the home deck, it does not instruct the SDK to open it as well.


Argument -pho <.pho file>
Description Changes the device configuration file used by the SDK's simulator.
Example OSDK62wap.exe -pho OPWV-SDK-62.pho
Notes Equivalent to using the SDK's File > Open Configuration command to choose a device configuration file.

You can enter an absolute path for the device configuration file. Or if the .pho file is in the C:\Program Files\Openwave\SDK 6.2\program\devices directory, you can just enter its file name.


Argument -clearcache
Description Clears the SDK's cache and then opens the home deck.
Example OSDK62wap.exe -clearcache
Notes Equivalent to using the SDK's Edit > Clear Cache command (F12).


Argument -g <gateway>
Description Specifies the gateway or other proxy the SDK uses to connect to web servers hosting wireless applications.
Example OSDK62wap.exe -g proxy.mydomain.com -clearcache
Notes You can only specify a gateway or other proxy that can accept a WAP connection, such as an Openwave Mobile Access Gateway (MAG).

This argument is ignored if the SDK is already running.

You can specify a host name or IP address, but in either case it must be for a host that your computer's DNS server can resolve.

Important: When changing gateways with the -g argument, always use the -clearcache argument at the same time.


Argument -pg <port>
Description Specifies the WAP gateway port the SDK uses to make remote TCP/IP network requests.
Example OSDK62wap.exe -g proxy.mydomain.com -pg 9203 -secure -clearcache
Notes The port is secure or nonsecure depending on whether you use the -secure or -nonsecure argument when you start the SDK. The default secure port is 9203; the default nonsecure port is 9201.

Only use the -pg argument to change the port if the WAP gateway is configured to use nonstandard ports. Otherwise, the SDK will not be able to connect to the gateway.

This argument is ignored if the SDK is already running.


Argument -p <local port>
Description The port on your computer that the MAG or other gateway uses to communicate with the SDK. The default is port 8502.
Example OSDK62wap.exe -g proxy.mydomain.com -clearcache -p 1234
Notes This argument is ignored if the SDK is already running.


Argument -anon
Description Directs the SDK to connect to the gateway in anonymous mode.
Example OSDK62wap.exe -g proxy.mydomain.com -clearcache -anon
Notes This argument is ignored if the SDK is already running.


Argument -secure
Description Directs the SDK to connect to the gateway in provisioned, secure mode.
Example OSDK62wap.exe -g proxy.mydomain.com -clearcache -secure
Notes This argument is ignored if the SDK is already running.


Argument -nonsecure
Description Directs the SDK to connect to the gateway in provisioned, nonsecure mode.
Example OSDK62wap.exe -g proxy.mydomain.com -clearcache -nonsecure
Notes This argument is ignored if the SDK is already running.


Argument -clientid <hex string>
Description The ID of the subscriber provisioned on the gateway.
Example OSDK62wap.exe -g proxy.mydomain.com -clearcache -secure -clientid 0202010101040007050505010201020000
Notes This is the client ID in hexadecimal format, obtained when an administrator provisions a subscriber. The ID is available in the MAG administrative UI, except that you need to eliminate the first four digits from the ID displayed in the MAG administrative UI.

This argument is ignored if the SDK is already running.


Argument -charset utf8
Description Overrides just the character set portion of the language and script settings you establish with the -lang argument, setting the character set advertised in the simulator's accept header to UTF8.
Example OSDK62http.exe -lang ru-ru -charset utf8
Notes This argument must follow a correct use of the -lang argument.

Ignored if the SDK is already running.


Argument -lang <language code>
Description Specifies the language and character set (or "script") that the SDK tells content servers it prefers to receive, for servers that can deliver content in more than one language or character set. The SDK's browser declares these preferences in HTTP accept headers, which it sends to content servers when it connects to them. The -lang argument also sets the font used to display content in the simulator.
Example OSDK62wap.exe -lang zh-hk
Notes The SDK only accepts the -lang argument parameters from the following table, which lists the character set, font, and related settings included with each parameter.

The text in the SDK browser simulator's UI (softkeys, menus, the status bar, error messages, and so on) are presented in English, regardless of the language you specify.
-lang
parameter
Language Charset Font Style Size Script
ar-sa Arabic iso-8859-6 Set by .pho file (Arial) Regular Set by .pho file Arabic
zh-cn Chinese
(Simplified)
gb-2312 MSHei, SimSun, or similar Regular Set by .pho file Chinese_GB2312
zh-hk Chinese
(Traditional)
big5 MingLiU, PMingLiU, or similar Regular Set by .pho file Chinese_BIG5
cs-cz Czech iso-8859-2 Set by .pho file (Arial) Regular Set by .pho file Latin2
da-dk Danish iso-8859-1 Set by .pho file (Arial) Regular Set by .pho file Western
nl-nl Dutch iso-8859-1 Set by .pho file (Arial) Regular Set by .pho file Western
en English iso-8859-1 Set by .pho file (Arial) Regular Set by .pho file Western
fi-fi Finnish iso-8859-1 Set by .pho file (Arial) Regular Set by .pho file Western
fr-fr French iso-8859-1 Set by .pho file (Arial) Regular Set by .pho file Western
de-de German iso-8859-1 Set by .pho file (Arial) Regular Set by .pho file Western
el-gr Greek iso-8859-7 Set by .pho file (Arial) Regular Set by .pho file Greek
iw-il Hebrew iso-8859-8 Set by .pho file (Arial) Regular Set by .pho file Hebrew
hu-hu Hungarian iso-8859-2 Set by .pho file (Arial) Regular Set by .pho file Latin2
it-it Italian iso-8859-1 Set by .pho file (Arial) Regular Set by .pho file Western
ja-jp Japanese Shift-JIS MS Gothic, MS UI Gothic, or similar Regular Set by .pho file Japanese
ko-kr Korean ks_c_5601 GulimChe, Batang, or similar Regular Set by .pho file Hangul
no-no Norwegian iso-8859-1 Set by .pho file (Arial) Regular Set by .pho file Western
pl-pl Polish iso-8859-2 Set by .pho file (Arial) Regular Set by .pho file Latin2
pt-pt Portuguese iso-8859-1 Set by .pho file (Arial) Regular Set by .pho file Western
ru-ru Russian windows-1251 Set by .pho file (Arial) Regular Set by .pho file Cyrillic
es-sp Spanish iso-8859-1 Set by .pho file (Arial) Regular Set by .pho file Western
sv-se Swedish iso-8859-1 Set by .pho file (Arial) Regular Set by .pho file Western
tr-tr Turkish iso-8859-9 Set by .pho file (Arial) Regular Set by .pho file Latin5


Known Problems

The following problems have not been fixed in this release of the Openwave SDK.


Legal Notice

Copyright (c) 1999-2003 Openwave Systems Inc. All rights reserved.

Openwave, the Openwave logo, and Services OS are registered trademarks and/or trademarks of Openwave Systems Inc. in various jurisdictions. All other trademarks are the property of their respective owners.

This Software shall not be shipped, transferred, exported or re-exported into any country or used in any manner prohibited by the United States Export Administration Act or any other export laws, restrictions or regulations (collectively the "Export Laws"). In addition, if this Software is identified as an export controlled item under the Export Laws, you represent and warrant that you are not located within an embargoed nation (including without limitation Cuba, Iran, Iraq, Libya, North Korea, Sudan and Syria) and that you are not otherwise prohibited under the Export Laws from receiving the Software. All rights to use the Software are granted on condition that such rights are forfeited if you fail to comply with the terms of this Agreement. Export or re-export of this software to the embargoed countries, and any other countries that the Bureau of Export Administration may subsequently add to the list of embargoed countries, is forbidden. In addition, this Software may not be sold as part of any product developed for or used exclusively by government agencies.

SDRN-62W-004
January 2003