为 Axis2 配置 JVM 服务器

如果要在管道中运行 Java™ Web Service 或处理 SOAP 请求，请配置 JVM 服务器以运行 Axis2 。

关于此任务

Axis2 是一个 Java SOAP 引擎，可以处理提供者和请求者管道中的 Web Service 请求。 配置 JVM 服务器以运行 Axis2时， CICS® 会自动将所需的 JAR 文件添加到类路径中。

您可以使用 CICS 联机资源定义或在 CICS 束中定义 JVM 服务器。

过程

  1. 为 JVM 服务器创建 JVMSERVER 资源。
    1. 指定 JVM 服务器的 JVM 概要文件的名称。
      在 JVMSERVER 的 JVMPROFILE 属性上，指定 1-8 字符名称。 此名称用于 JVM 概要文件的前缀，该文件包含 JVM 服务器的配置选项。 您无需在此处指定后缀 .jvmprofile。
    2. 指定 JVM 服务器的线程限制。
      在 JVMSERVER 的 THREADLIMIT 属性上，指定 JVM 服务器的 Language Environment ® 封套中允许的最大线程数。 所需的线程数取决于要在 JVM 服务器中运行的工作负载。 首先，您可以接受缺省值，然后调整环境。 您可以在 JVM 服务器中设置多达 256 个线程。
  2. 创建 JVM 概要文件以定义 JVM 服务器的配置选项。
    可以使用样本概要文件 DFHJVMAX.jvmprofile作为基础。 此概要文件包含适合于启动 JVM 服务器的选项子集。 JVM 概要文件验证和属性中描述了 JVM 概要文件的所有选项和值。 遵循 用于对概要文件进行编码的规则中的编码规则 (包括概要文件名称的编码规则)。
    1. 设置 JVM 概要文件的位置。
      JVM 概要文件必须位于您在系统初始化参数 JVMPROFILEDIR 上指定的目录中。 有关更多信息，请参阅 设置 JVM 概要文件的位置。
    2. 对样本概要文件进行以下更改:
      • 将 JAVA_HOME 设置为已安装的 IBM® Java SDK 的位置。
      • 设置 JAVA_PIPELINE 以运行 Axis2。
      • 设置 CLASSPATH_SUFFIX 以指定以 Java 编写的 Axis2 应用程序和 SOAP 处理程序的类。
      • 将 WORK_DIR 设置为您为来自 JVM 服务器的消息，跟踪和输出选择的目标目录。
      • 设置 TZ 以指定来自 JVM 服务器的消息上的时间戳记的时区。英国的示例为 TZ=GMT0BST,M3.5.0,M10.4.0。
    3. 将更改保存到 JVM 概要文件。
      JVM 概要文件必须在 z/OS UNIX System Services 文件系统上另存为 EBCDIC。
  3. 安装并启用 JVMSERVER 资源。

结果

CICS 创建 Language Environment 相关可调度单元组，并将选项从 JVM 概要文件传递到 JVM 服务器。 JVM 服务器启动并装入 Axis2 JAR 文件。 当 JVM 服务器成功完成启动时， JVMSERVER 资源将以 ENABLED 状态安装。

如果发生错误 (例如， CICS 无法找到或读取 JVM 概要文件) ，那么 JVM 服务器无法启动。 JVMSERVER 资源安装处于 DISABLED 状态， CICS 向系统日志发出错误消息。

下一步操作

  • 指定包含本机 C 动态链接库 (DLL) 文件的任何目录，例如 Db2® 或 IBM MQ。 在 JVM 概要文件中的 LIBPATH_SUFFIX 选项上指定这些目录。
  • 配置 CICS 以在 JVM 服务器中运行 Web Service 请求，如 将 Java 与 Web Service 配合使用中所述。