Chapter 11 Creating Application Clients

Running application clients

To run an application client on a client machine:

Copy the application client JAR file to the client's machine and import the JAR file - see "Importing and exporting application clients".
Set up the environment - see "Setting up a client's workstation".
Start the application client's runtime container - see "Starting the runtime container".

Setting up a client's workstation

To set up a client's workstation, add these to the CLASSPATH:

%JAGUAR%\Client\AppClientContainer.jar
%JAGUAR%\Client\JagClient.zip
%JAGUAR%\html\classes\jconn2d.jar
%u_appclient%

Starting the runtime container

The runtime container enables the application client to look up EJB and resource references. The container also provides security and authenticates the client when the application is started. Use these options to define the runtime parameters:

Option	Description
- client	Application client JAR file
- name	Client's name
- login	Displays a login dialog to authenticate the client

This example illustrates the command-line syntax to start an application client's runtime container, where my_appclient.jar is the name of the application client JAR file and my_client is the name of the client:

java -classpath %JAGUAR%\Client\AppClientContainer.jar;
%JAGUAR%\Client\JagClient.zip;
%JAGUAR%\Client\my_appclient.ear com.sun.enterprise.appclient.Main 
-client my_appclient.jar -name my_client -login