使用 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]其中 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 选项不是必需的。

      [AIX][Linux][HP-UX][Solaris][Windows][z/OS]缺省值为 default_profile。

    • -JVMOptions 是有效的 Java 标准或非标准选项字符串。用引号将字符串引起来。
    • -help, -? 输出用法信息。
    所有其他要求 launchClient 命令的参数必须以 -CC 前缀开始。

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

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

    [AIX][Linux][HP-UX][Solaris][Windows][z/OS]缺省情况下,launchClient 命令使用 localhost 来表示 BootstrapHost 属性值。

    [IBM i]缺省情况下,launchClient 命令使用 your_server_name 来表示 BootstrapHost 属性值。

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

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

示例

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

[Windows]
 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 
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
 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 

指示主题类型的图标 任务主题



时间戳记图标 最近一次更新时间: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tcli_launchclient
文件名:tcli_launchclient.html