The J2EE specification requires support for a client container
that runs stand-alone Java applications (known as J2EE application clients)
and provides J2EE services to the applications. J2EE services include naming,
security, and resource connections.
About this task
You are ready to run your application client using this tool after
you:
- Write the application client program.
- Assemble and install an application module (.ear file) in the
application server run time.
- Deploy the application using the Application Client Resource Configuration
Tool (ACRCT) on Windows.
Alternatively, you can use the ACRCT
scripting tool on z/OS.
This task only applies to J2EE application clients. To launch J2EE
application clients using the launchClient script, perform the following steps:
Procedure
Start the Qshell environment. On
the CL command line, enter the command:
STRQSH
- Enter the following command to launch J2EE application clients:
app_server_root/bin/launchClient
where app_server_root is
/QIBM/ProdData/WebSphere/AppServer/V61/Base or /QIBM/ProdData/WebSphere/AppServer/V61/ND
- Pass parameters to the launchClient command or to your
application client program as well. The launchClient command allows
you to do both. The launchClient command requires that
the first parameter is either:
- An EAR file specifying the application client to launch.
- A request for launchClient usage information.
The following example illustrates the command line invocation syntax
for the launchClient tool:
launchClient [-profileName pName | -JVMOptions options | -help | -?] <userapp> [-CC<name>=<value>] [app args]
All other parameters intended for the launchClient command
must begin with the -CC prefix. Parameters that are not EAR files, or usage
requests, or that do not begin with the -CC prefix, are ignored by the application
client run time, and are passed directly to the application client program.
The
launchClient command
retrieves parameters from three places:
- The command line
- A properties file
- System properties
The parameters are resolved in the order listed above, with command line
values having the highest priority and system properties the lowest. Using
this prioritization you can set and override default values.
- Specify the server name.
By
default, the launchClient command uses the localhost for the BootstrapHost property
value.
By default, the launchClient command
uses your_server_name for the BootstrapHost property value.
This
setting is effective for testing your application client when it is installed
on the same computer as the server. However, in other cases override this
value with the name of your server. You can override the
BootstrapHost value
by invoking
launchClient command with the following parameters:
launchClient myapp.ear -CCBootstrapHost=abc.midwest.mycompany.com
You
can also override the default by specifying the value in a properties file
and passing the file name to the launchClient shell.
Security is controlled
by the server. You do not need to configure security on the client because
the client assumes that security is enabled. If server security is not enabled,
then the server ignores the security request, and the application client functions
as expected.