Ultra Light Client Guide and Reference
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.
- -crStrategy className
- The name of the ULC reconnect token strategy (default: nil).
This turns Client Reconnect feature on if the class exists and inherits from
UlcReconnectTokenStrategy.
- -crTimeout seconds
- Specifies how long a context should be kept alive (default:
300).
- Note:
- You can not turn Client Reconnect off by specifying 0 or less. The
value must be bigger than 0, otherwise the default is taken. This
parameter is only used if the Client Reconnect token strategy
(-crStrategy) is valid.
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 ]