Ultra Light Client Guide and Reference


About running ULC applications from a command prompt

ULC-packaged images support the following command-line parameters. These parameters are not case-sensitive:

-appName String
Packaged Smalltalk images may contain more than one named application. If this parameter is not set, all applications are accessible. Specifying one or more application names restricts access to the listed applications.

-corba
Sets the default communication protocol of the image to CORBA (IIOP). This parameter works only for images that include the IIOP support (UlcCommunicationIiopApp). If that application is not present when this parameter is passed, the image will not work.

-debug
This parameter starts the debug mode of ULC. If started, all debug aspects are output.

A useful complementary VisualAge parameter is -lFileName, which redirects output to TTY (the default output for ULC debugging) to the file specified. -lCON outputs to the console.

-server XXX
The number specified by XXX defines the port number on which the application server waits for connections.

-url String
The format of String is ULC://hostname:xxxx/ApplicationName.

-userParameter String
String can be any valid single command-line parameter (as supported by the platform). UlcSystem provides access to this parameter via its #userParameter API. This string is not interpreted by ULC. It lets business applications define their own startup parameters.

Examples

MyImage.exe -server 4444 

The application server waits for connections on port number 4444. This configuration allows access to all applications included in the image. To have a UI Engine connect to this server, the command line would read:

UlcUI.exe -url ulc://localhost:4444/myBeautifulApp

MyImage.exe -server 4444 -appName MyBeautifulApp

The application server waits for connections on port number 4444 and restricts access to the application named MyBeautifulApp. This is useful only if the server image includes another application (for example, MyUglyApp).

The UI Engine command lines might read:

UlcUI.exe -url ulc://localhost:4444/myBeautifulApp
result: the MyBeautifulApp starts up 
 
UlcUI.exe -url ulc://localhost:4445/myBeautifulApp
result: nothing happens, because the port is wrong
 
UlcUI.exe -url ulc://localhost:4444/myUglyApp
result: nothing happens, because access to MyUglyApp has been refused 


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]