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

部署后Java EE客户端应用程序安装到安装了应用程序客户端的机器上，或者WebSphere® Application Server节点，您可以使用launchClient该机器上的命令。

准备工作

必须先部署 Java EE 客户机应用程序，然后才能使用 launchclient 命令来运行该应用程序。

此任务仅适用于Java™ EE客户端应用程序。

有关此任务

这Java Platform, Enterprise Edition（ Java EE ) 规范要求支持运行 Java 应用程序的客户端容器（称为Java EE客户端应用程序）并提供Java EE服务到应用程序。 Java EE服务包括命名、安全和资源连接。

过程

  1. [IBM i]启动 Qshell 环境。
    在 CL 命令行中，输入以下命令：
    STRQSH
  2. 输入以下命令启动Java EE应用客户端：
    app_client_root/bin/launchClient

    [IBM i]在哪里应用程序客户端根目录是/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 选项不是必需的。
    • -JVM选项是有效的 Java 标准或非标准选项字符串。 用引号将字符串引起来。
    • -帮助， -？打印使用信息。
    所有其他要求 launchClient 命令的参数必须以 -CC 前缀开始。

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

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

    [IBM i]默认情况下，launchClient命令用途你的服务器名称为了BootstrapHost适当的价值。

    当此应用程序客户机与服务器安装在同一台计算机上时，此设置对于测试应用程序客户机是有效的。 但是，在其他情况下，用您的服务器名重设此值。 您可通过调用带有下列参数的 launchClient 命令来重设 BootstrapHost 值：
    launchClient myapp.ear -CCBootstrapHost=abc.midwest.mycompany.com
    您还可以通过在属性文件中指定值并将文件名传递至 launchClient shell 来重设缺省。

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

示例

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

[IBM i]
 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