UP.SDK 4.1.1 replaces UP.SDK 4.1, so you must uninstall UP.SDK 4.1 before installing UP.SDK 4.1.1.

In addition to the operating systems supported by UP.SDK 4.1 (see the UP.SDK 4.1 Readme file), UP.SDK 4.1.1 also runs on Windows 2000.

As with many Windows applications, you can start the UP.Simulator by entering the file name of its application (upsim411.exe) in a Command Prompt window, by including it in a batch file or script, or by calling it from another application -- such as a third-party integrated development environment (IDE). UP.SDK 4.1.1 adds arguments you can append to the application name to control how the UP.Simulator starts, or to control the UP.Simulator if it's already running. (As part of this enhancement, you can run only one instance of the UP.Simulator at a time.)

The following arguments to upsim411.exe are supported in UP.SDK 4.1.1.

Argument	-help
Description	Displays a summary of UP.Simulator command-line arguments in the UP.Simulator's Phone Information window (if used when starting the UP.Simulator, the Phone Information window is minimized, so you need to restore it to read the command summary).
Example	upsim411.exe -help

Argument	-reload [<URL>]
Description	When used without the optional URL, reloads the current URL. When used with a URL, marks that URL as invalid in the UP.Simulator's cache and then opens the specified URL.
Example	upsim411.exe -reload upsim411.exe -reload file://c/mydecks/index.wml
Notes	When used without a URL, equivalent to the UP.Simulator's Edit > Reload menu command (F9). This argument does not always work as expected when starting the UP.Simulator: It is reliable if when the UP.Simulator is already running.

Argument	-go <URL>
Description	Opens the URL in the UP.Simulator.
Example	upsim411.exe -go http://developer.openwave.com/dhome5.cgi upsim411.exe -go developer.openwave.com/dhome5.cgi upsim411.exe -go file://c:/program files/openwave/upsdk411/examples/wml/index.wml upsim411.exe -go file://examples/wml/index.wml
Notes	Equivalent to entering a URL or path in the UP.Simulator's Go field. For URLs, you can omit http://. For files, you must include file://. In addition, you can enter an absolute path name or a path name relative to the location of upsim411.exe.

Argument	-gohome
Description	Opens the current home deck in the UP.Simulator.
Example	upsim411.exe -gohome
Notes	Equivalent to clicking the UP.Simulator's Home key or entering device:home in the Go field. This argument is ignored if used when starting the UP.Simulator.

Argument	-sethome <URL>
Description	Sets the UP.Simulator's home deck when connecting in HTTP Direct mode.
Example	upsim411.exe -sethome http://developer.openwave.com/dev/wml/devhome4.wml upsim411.exe -sethome developer.openwave.com/dev/wml/devhome4.wml upsim411.exe -sethome file://c:/program files/openwave/upsdk411/examples/wml/index.wml upsim411.exe -sethome file://examples/wml/index.wml
Notes	Equivalent to entering a URL in the UP.Simulator's UP.Link Settings dialog box. For URLs, you can omit http://. For files, you must include file://. In addition, you can enter an absolute path name or a path name relative to the location of upsim411.exe. This argument is ignored if used when the UP.Simulator running and is set to connect via a real UP.Link. This argument only sets the home deck, it does not instruct the UP.Simulator to open it as well.

Argument	-exit
Description	Causes the UP.Simulator to exit.
Example	upsim411.exe -exit
Notes	Equivalent to choosing the UP.Simulator's File > Exit command.

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

Argument	-pho <.pho file>
Description	Changes the device configuration file used by the UP.Simulator.
Example	upsim411.exe -pho c:/program files/openwave/upsdk411/configs/OWG1.pho upsim411.exe -pho configs/OWG1.pho
Notes	Equivalent to using the UP.Simulator's File > Open Configuration command to choose a device configuration file. You can enter an absolute path name or a path name relative to the location of upsim411.exe.

Keep the following in mind as you use the command line tools.

• When using these command-line tools in the Command Prompt window, you must first change to the same directory as the upsim411.exe file (C:\Program Files\Openwave\UPSDK411 by default) or include its absolute path name.
  
  
• When using these tools in batch files or scripts, use them as arguments to the Windows start command when starting the UP.Simulator: Otherwise your batch file or script will be blocked until you exit the UP.Simulator.
  
  
• If you pass an invalid argument to upsim411.exe, the argument is ignored and an error message appears in the Phone Info window.
  
  
• When starting the UP.Simulator, you can concatenate arguments. For example:
  upsim411.exe -pho configs/OWG1.pho -go file://c:/mydecks/index.wml
  Not all combinations (particularly nonsensical combinations) have been tested.
  
  
• When the UP.Simulator is running, you can only use one argument at a time.
  
  
• If you open a modal dialog box in the UP.Simulator UI, such as the UP.Link Settings dialog box, you can't control the UP.Simulator from the command line until you close the dialog box.
  
  
• The SDK supports only HTTP-style slashes ( / ) in URLs or arguments for Web sites and local files. The SDK does not support Windows-style slashes ( \ ).
  
  
• When using -go or another command-line argument to open a URL that includes the & character, you need to enclose the URL in quotation marks.
  
  
• If you're controlling the UP.Simulator using a third-party IDE, start the UP.Simulator first. If the UP.Simulator isn't running and you start it by sending it a command from the IDE, the UP.Simulator may not process that first command correctly.

Legal Notice

Copyright (c) 1999-2002 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-411-008
August 2002