您可以使用每个 servlet 示例随附的 CICS® 束项目,将应用程序部署到正在 CICS 中运行的 Liberty JVM 服务器。
开始之前
如
servlet 示例入门中所述,您必须创建示例 Web 应用程序。您还必须具有在该资源中创建和安装 CICS 资源的许可权。
关于此任务
CICS 从 zFS 装入并运行 Java™ 应用程序,因此必须将已编译的应用程序部署到 zFS 中可供 CICS 区域访问的目录。对于 DB2® 示例,您还必须具有可用的样本 DB2 数据库。
部署和安装应用程序的首选方法是使用 CICS 束项目,因为这样您可以使用 CICS 设施来管理这些束项目应用程序资源。CICS 束项目将一组插件项目、动态 Web 项目和 CICS 资源打包,在逻辑上将其作为单个单元进行部署和管理。您可将本方法用于简单 Web 应用程序(例如 Hello
World 示例)和更复杂的 Web 应用程序(例如其他 servlet 示例)。
部署和安装应用程序的备选方法是使用 Liberty 部署机制来部署 WAR 或 EBA 文件。您可以将动态 Web 项目作为 WAR 或 EBA 文件导出,并使用 FTP 将文件复制到 Liberty JVM 服务器的 dropins 目录。您可将本方法用于简单 Web 应用程序,例如 Hello
World 示例。
过程
- 要使用 CICS 束项目部署示例,您可使用 CICS Explorer SDK。
- 右键单击束项目,然后单击 z/OS
UNIX 文件系统作为束项目...。
- 按照向导将束部署到可由 CICS 区域访问的 zFS 中的位置。 要在样本组 DFH$WLP 中使用样本 BUNDLE 资源定义,请使用 /tmp/cicsts51 作为 zFS 位置。 CICS Explorer SDK 将 CICS 束和关联的项目部署到 zFS。如果 CICS 束包含 .osgibundle 或 .warbundle 工件,那么关联的项目根据其项目构建属性进行构建并导出。
- 对于 CICS Java 数据库连接 (JDBC) 示例,有两个要部署的束项目。请针对每个束项目完成步骤 1 和 2。
- 编辑 DFHWLP 样本 JVM 概要文件,以通过 -Dcom.ibm.cics.jvmserver.wlp.autoconfigure=true 系统属性开启自动配置选项。 您可以使用 z/OS® UNIX 文件视图来浏览目录结构以编辑文件。如果要使用 DB2 样本,那么还必须为 DB2 更新概要文件。有关更多信息,请参阅 CICS TS 5.1 信息中心内的“针对 Web 应用程序配置 JVM 服务器”。
- 在 CICSplex Explorer
视图中,选择要运行 servlet 示例的 CICS 区域。
- 安装 JVMSERVER 资源 DFH$WLP(位于样本组 DFH$WLP 中)。 样本资源在 CICS 区域中创建 Liberty JVM 服务器。
Liberty JVM 服务器在 zFS 中创建目录结构,包括 Web 应用程序的 server.xml 文件和 dropins 目录。您可以通过单击来检查 JVM 服务器的状态。
- 编辑 JVM 服务器工作目录中的 server.xml 文件,以更改主机名和端口号。 您可以使用 z/OS UNIX 文件视图来浏览目录结构以编辑文件。工作目录通常在区域用户 ID 的目录下创建。
- 单击以打开“束定义”视图。 此视图列出了 CICS 区域的所有束定义。
- 在样本组 DFH$WLP 中安装样本束资源定义。 对于 CICS Hello World 示例,样本束资源定义 WLPHELLO 是必需的。对于 CICS 临时存储器队列 (TSQ) 示例,WLPTSQ 是必需的。
对于 CICS Java 数据库连接 (JDBC) 示例,JDBC 和 WLPJDBC 都是必需的。样本定义将 /tmp/cicsts51 指定为部署 CICS 束的位置。
这样会将 WAR 或 EBA 文件(取决于示例)装入到 Liberty 概要文件服务器中,并且会在 OSGi 框架中注册任何 OSGi 束。
- 要部署遵循 Liberty 部署模型的简单示例,您必须在 CICS 中配置和启用 JVM 服务器。 启用 JVM 服务器会创建 dropins 目录。
- 编辑 DFHWLP JVM 概要文件,以通过 -Dcom.ibm.cics.jvmserver.wlp.autoconfigure=true 系统属性开启自动配置。
- 在 CICSplex Explorer
视图中,选择要运行 servlet 示例的 CICS 区域。
- 安装 JVMSERVER 资源 DFH$WLP(位于样本组 DFH$WLP 中)。 样本资源在 CICS 区域中创建 Liberty JVM 服务器。
Liberty JVM 服务器在 zFS 中创建目录结构,包括 Web 应用程序的 server.xml 文件和 dropins 目录。您可以通过单击来检查 JVM 服务器的状态。
- 在“资源”透视图中,右键单击动态 Web 项目,并将其作为 WAR 或 EBA 文件导出到您的本地工作站。
- 使用 FTP 将 WAR 或 EBA 文件以二进制方式复制到混入目录中。
- 您可以编辑 server.xml 文件来更改主机名和端口号。
结果
您已将包含 servlet 和 JSP 页面的 Web 应用程序部署到正在 CICS 中运行的 Liberty JVM 服务器,并配置了 Liberty JVM 服务器以使用主机名和端口号。
下一步做什么
您可以从 Web 浏览器访问 Web 应用程序,以检查 Liberty JVM 服务器的配置,如
运行 servlet 示例中所述。