使用 launchClient 来运行 Java EE 客户机应用程序

将 Java EE 客户机应用程序部署到安装了应用程序客户机的机器上或在 WebSphere® Application Server 节点中，您可以在该机器上使用 launchClient 命令来启动应用程序。

1. 启动 Qshell 环境。
   在 CL 命令行中，输入以下命令：

   STRQSH

2. 输入以下命令以启动 Java EE 应用程序客户机:

   app_client_root/bin/launchClient

   ，其中 app_client_root 是 /QIBM/ProdData/WebSphere/AppServer/V85/Base 或 /QIBM/ProdData/WebSphere/AppServer/V85/ND。

3. 将参数传递到 launchClient 命令或应用程序客户机程序。 launchClient 命令允许您同时执行这两项操作。
   launchClient 命令要求第一个参数是下面内容的其中之一：

   • 指定应用程序客户机启动的 EAR 文件。
   • launchClient 使用信息的请求。

   以下示例描述了 launchClient 工具的命令行调用语法：

   launchClient [-profileName pName | -JVMOptions options | -help | -?] userapp [-CCname=value] [app args]
   

   其中，

   • userapp 是包含应用程序客户机的 EAR 文件的路径和名称。
   • -CCname=value 是客户机容器的“名称/值”对参数。 请参阅客户机容器参数部分，以获取支持的“名称/值”对参数的信息。
   • app args 是传递给应用程序客户机的参数。
   • -profileName 定义在多概要文件安装中的 Application Server 进程的概要文件。 对于在单个概要文件环境或应用程序客户机安装中运行，-profileName 选项不是必需的。

     缺省值为 default_profile。

   • -JVMOptions 是有效的 Java 标准或非标准选项字符串。 用引号将字符串引起来。
   • -help ，-? 打印用法信息。

   所有其他要求 launchClient 命令的参数必须以 -CC 前缀开始。

   应用程序客户机运行时忽略不是 EAR 文件或使用请求或者不以 -CC 前缀开始的参数，并将它们直接传递给应用程序客户机程序。

   launchClient 命令检索来自三个位置的参数：

   • 命令行
   • 属性文件
   • 系统属性

   参数以所列顺序解析，命令行值具有最高优先级，而系统属性的优先级最低。 您可以使用该划分优先级方法来设置和重设缺省值。
4. 指定服务器名。

   缺省情况下， launchClient 命令将 localhost 用于 BootstrapHost 属性值。

   缺省情况下， launchClient 命令使用 your_server_name 作为 BootstrapHost 属性值。

   当此应用程序客户机与服务器安装在同一台计算机上时，此设置对于测试应用程序客户机是有效的。 但是，在其他情况下，用您的服务器名重设此值。 您可通过调用带有下列参数的 launchClient 命令来重设 BootstrapHost 值：

   launchClient myapp.ear -CCBootstrapHost=abc.midwest.mycompany.com

   您还可以通过在属性文件中指定值并将文件名传递至 launchClient shell 来重设缺省。

   安全性受控于服务器。 您不需要在客户机上配置安全性，因为客户机假设安全性已启用。 如果未启用服务器安全性，那么服务器忽略安全性请求，并且应用程序客户机按所期望的那样起作用。

示例

您可在属性文件中存储 launchClient 值，这是发分布缺省值的好方法。 然后您可以在命令行上重设一个或多个值。 文件的格式是每行有一个没有 -CC 前缀的 launchClient -CC 参数。 例如：

 verbose=true classpath=c:\mydir\util.jar;c:\mydir\harness.jar;c:\production\G19
\global.jar BootstrapHost=abc.westcoast.mycompany.com tracefile=c:\WebSphere\mylog.txt 

 verbose=true classpath=/usr/lpp/mydir/util.jar;/usr/lpp/mydir/harness.jar;/usr/lpp
/production/G19/global.jar BootstrapHost=abc.westcoast.mycompany.com tracefile=/usr
/lpp/WebSphere/mylog.txt