配置 z/OS 组件

在 z/OS® 系统上安装 CICS® TS Feature Pack for Dynamic Scripting V2.0 后，必须对其进行配置以完成设置。

1. 将样本 JVMPROFILE DFHPHP 从 @phpinst@/JVMProfiles 复制到 SIT 选项 JVMPROFILEDIR上指定的目录，其中 @phpinst@ 是功能部件包的位置。 将复制的 DFHPHP JVMPROFILE 重命名为 DFHPHP.jvmprofile。
2. 在步骤 1中复制并重命名的 DFHPHP.jvmprofile JVMPROFILE 中，根据您的需求为 -Dcom.ibm.cics.jvmserver.wlp.autoconfigure 指定值。 有关更多信息，请参阅 JVM 系统属性。
3. 在步骤 1中复制并重命名的 DFHPHP.jvmprofile JVMPROFILE 中，根据您的需求为 -Djava.util.Arrays.useLegacyMergeSort 指定值。 由于 java.util.Arrays.sort 在 Java™ 7 中使用的排序算法发生更改，因此要使某些 PHP 函数 (例如 sort() ) 的行为方式与 php.net中的 PHP 一致，请指定 -Djava.util.Arrays.useLegacyMergeSort=true。
4. 在步骤 1中复制并重命名的 DFHPHP.jvmprofile JVMPROFILE 中，根据您的需求为 JAVA_HOME 指定值。 将 Java 安装的位置替换为字符串 ///&JAVA_HOME///。
5. 检查 JVMPROFILE 并确保其包含用于 php 扩展的 LIBPATH_SUFFIX 语句。
   例如：

   LIBPATH_SUFFIX=@phpinst@/lib

   将 @phpinst@ 替换为该功能部件包的位置。
6. 创建或生成 server.xml 文件，然后进行定制，并指定必需参数:
   如果在步骤 2中指定 -Dcom.ibm.cics.jvmserver.wlp.autoconfigure=true ，那么将自动生成 server.xml 文件，并且必须完成以下步骤:
   1. 根据您自己的环境为 -Dcom.ibm.cics.jvmserver.wlp.server.host和 -Dcom.ibm.cics.jvmserver.wlp.server.http.port 或-Dcom.ibm.cics.jvmserver.wlp.server.https.port 指定值。
   2. 安装 Liberty JVM 服务器以生成 server.xml 文件。 JVM 服务器要求配置文件要位于工作目录中的 WLP_USER_DIR/servers/server_name 目录中，其中 WLP_USER_DIR 是 WLP_USER_DIR 选项的值，server_name 是 -Dcom.ibm.cics.jvmserver.wlp.server.name 属性的值。 如果您要安装样本应用程序，那么必须安装样本组 DFH$PHP。
   如果指定 -Dcom.ibm.cics.jvmserver.wlp.autoconfigure=false，那么在步骤 2中，不会自动生成 server.xml ，您必须改为完成以下步骤:
   1. 创建 server.xml 文件。 有关创建此文件的更多信息，请参阅 配置 Liberty JVM 服务器。
      确保在 servers.xml 文件中定义了 CICS 运行 PHP 应用程序所需的功能。 这些功能部件包括 cicsts:core-1.0、jsp-2.2 和 blueprint-1.0。
   2. 指定您所需的 HTTP 端点属性主机名和端口号。
      例如：

      <httpEndpoint host="winmvs2c.example.com" httpPort="28216" httpsPort="28217"
       id="defaultHttpEndpoint"/>

   3. 根据您的需求，指定其他参数。 有关更多信息，请参阅 手动定制 server.xml。
7. 更新 JVM 服务器 DFH$PHP 的 CICS Liberty 概要文件中的 server.xml 文件，以将 com.ibm.cics.php OSGi 捆绑软件添加到共享捆绑软件存储库。
   例如：

   <bundleRepository id="php">
    <fileset dir="@phpinst@/repository" includes="com.ibm.cics.php_1.0.0.jar"/>
   </bundleRepository>

   其中，@phpinst@ 为该功能部件包的位置。
   注: JVMSERVER DFH$PHP 和 JVMPROFILE DFHPHP 是功能部件包随附的样本。 如果您正在使用自己的 JVMSERVER 和 JVMPROFILE ，那么必须更新它们，如步骤 3 和 5中所示。
8. 可选: 使用类型为 JVMSERVER 的 URIMAP ，并将缺省 CJSA 事务更改为可以应用 CICS 事务安全性的用户事务。 com.ibm.cics.server.examples.php.web 中的资源组 DFH$PHP 中提供了样本 URIMAP 和事务定义。 DFH$PURI 是样本 URIMAP 定义，而 CPTN 是事务。
9. 可选: 实现 Liberty 安全性。 有关实现 Liberty 安全性的更多信息，请参阅 配置安全性。