在 z/OS 中安装和升级 R4Z 产品

本部分介绍如何在 z/OS 中安装和升级 R4Z 产品。

在 z/OS 中安装 R4Z 产品

以下配置步骤包括提交在 INSTALL 库中找到的作业（称为 <r4z-vnd-hlq>.INSTALL ，其在 R4Z 产品库中）。每个作业都需要 INSTALL 库（或其副本）作为其 JCLLIB，并且必须具有符合现场规定的作业卡和 JES 控制声明。

在处理环境中应用安装

在安装过程中，您需要提交库中带有前缀“DO*”的大多数成员。在提交这些成员之前，您必须按以下方式对其进行编辑：

1. 设置作业名称、作业卡参数和 JES 控制语句以符合系统要求。
2. 设置库，其指定于 JCLLIB ORDER 参数，作为 INSTALL 库。

第 1 步：设置 INSTALL 库 INCLUDE 成员

在运行任何作业之前，您需要设置下面的 JCL 符号，因为“DO”作业使用这些JCL符号来配置 R4Z 处理。要更改它们的值，需要首先使用旧值运行“UNDO”作业，然后使用新值运行“DO”作业。

编辑此成员以设置此库中作业使用的 JCL 符号，然后保存（覆盖）该成员。下面的 安装符号 表列出了这些符号。

以下是几个参数的更详细说明：

• 指定 R4Z 产品库名称的参数：
  &R4ZHLVL - 设置为 R4Z INSTALL、LOAD 和 CONFIG 库通用的高级限定符，即这些库名称中最长的通用部分：
  • &R4ZVNDH - 设置为接收 INSTALL 和 LOAD 库时用作“版本化”高级限定符 (<r4z_vnd_HLQ>) 的值。
  • &R4ZBSCH - 设置为您为“基本”高级限定符选择的值 (<r4z_bsc_HLQ>)，这将在创建 CONFIG 库时使用。
  • &R4ZINSTL, &R4ZLOADL, &R4ZCNFGL - 仅当它们的值与 DFSYMLST 成员中设置的值不同时，才能根据上述符号指定这些值。
• 控制 DASD 分配的参数：

  • ALCSMSPM, &ALCVLSER - 使用这些参数指定将在其上分配 CONFIG 库和一些中间数据集的卷。

    使用 &ALCSMSPM 以逗号分隔、以空格结尾的字符串指定 SMS 分配属性，格式如下：

    '[STORCLAS=…][,MGMTCLAS=…][,DATACLAS=…] '

    使用 &ALCVLSER 指定卷序列号。

    如果 SMS 管理的分配由 ACS 例程驱动，则可以省略所有属性并指定 &ALCSMSPM=' '(a single space) 替代。

    如果您指定 &ALCSMSPM=' '(a single space)，则必须指定值，该值属于 &ALCVLSER 参数：

    对于非 SMS 管理的分配，请使用 &ALCVLSER 指定卷序列号。

• CDC 服务和 UDF 相关变量：

  DFSYMPER	根据 CDC 服务限定符定义 UDF、WLM 应用程序 env 和 STC 程序的名称	每个 R4Z 安装
  使用： &CDCSRV 设置 &R4ZWLMPR, &R4ZAPPNV, &R4ZIFITF, &R4ZSCNM, &STCUSER, &UDFUSER
  DFSYMONE	定义 UDF、WLM 应用程序 env 和 STC 程序的名称，假设使用单个 CDC 服务	每个 DB2 子系统
  设置 &R4ZWLMPR, &R4ZAPPNV, &R4ZIFITF, &R4ZSCNM, &STCUSER, &UDFUSER

根据为 DEFWLMAE、ONE 或 PER 选择的值，分别编辑成员 DFSYMONE 或 DFSYMPER，并为 CDC 读取器 UDTF 的 WLM APPLENV、WLM JCL 程序选择值。

第 2 步：执行配置操作

1. 将 R4Z LOAD 库设置为 APF 授权。

   要将库设置为临时授权的 APF（直到下一次 IPL 或 APF 更新），可以运行以下系统命令之一：

   • 对于非 SMS 管理的数据集：

     setprog apf,add,dsn=<xmit-HLQ>.LOAD,volume=<volser>

   • 对于 SMS 管理的数据集：

     setprog apf,add,dsn=(<xmit-HLQ>.LOAD,sms

     要使设置永久，请将库添加到 PARMLIB 中的 PROGxx 成员。

2. 设置 WLM 应用程序环境以执行 CDC 过程。|
   

   DO2WLMAE	定义 WLM 应用程序环境	每个 CDC 服务
   接受：&CDCSRV 使用： &R4ZAPPNV, &R4ZWLMPR, &CEERUNL, &DB2EXITL, &DB2LOADL, &DB2RUNL
   DO2WLMPR	为 WLM STC 创建 JCL 程序	每个 WLM 程序
   接受：&CDCSRV 使用：&PROCLIB, &R4ZWLMPR, &SSID
   DO2WLMPV	作业：在将 WLM 服务器定义为 RACF 中的资源，并授权 APPLENV 和 DB2 子系统使用它	每个 CDC 服务和 WLM 程序
   接受：&CDCSRV 使用：&R4ZAPPNV, &R4ZWLMPR, &STCUSER

   
   根据为 DEFALMAE 设置的值，在使用相关 CDC 服务限定符设置 JCL 符号 CDCSRV 后，运行以下作业一次（如果选择了一个）或PER每个要定义的 CDC 服务（如果选择 PER）。

   1. 编辑作业 DO2WLMAE；将符号和 CDCSRV 设置为相关 CDC 服务限定符并提交。该作业将在 WLM 策略数据集中定义 WLM APPLENV 并激活它。

      • 先决条件：

        • &R4ZWLMPR 是 WLM 将使用的已启动任务的名称。您需要将一个有效的用户与已启动的任务相关联，并将 &STCUSER 设置为该用户。

        • 提交者需要 MVSADMIN.WLM.POLICY 的 UPDATE 访问权限，以查询和更新 WLM 策略。

        • 对 &PROCLIB 符号中 DSSYMLST 中指定的程序库执行 UPDATE。

   2. 编辑作业 DO2WLMPR；将符号和 CDCSRV 设置为相关 CDC 服务限定符并提交。该作业将为 APPLENV 创建 JCL 过程，并应以 RC 0 终止。

      • 授权：

        PROCLIB 库上的 UPDATE。

   3. 编辑作业 DO2WLMPV；将符号和 CDCSRV 设置为相关 CDC 服务限定符并提交。该作业将设置 APPLENV 使用 WLM 服务器的 RACF 权限，以及 DB2 子系统调用它的 RACF 特权。作业应以 RC 0 终止。

      • 授权：

        SERVER 类上的 ALTER

        如果您使用的是 RACF 以外的安全软件包（例如，CA-TSS 或 CA-ACF2），则需要运行与安全软件包相关的命令。

3. 创建 CDC 读取器 UDTF。
   

   DO3SRVDF	创建默认 CDC 服务 UDTF	每个 DB2 子系统
   使用：&R4ZSCNM, &R4ZIFITF, &R4ZCNFGL, &ALCSMS, &ALCSMSPM, &ALCVLSER, &SSID, &DB2EXITL, &DB2LOADL, &DB2RUNL, &UDFUSER
   DO3SRVTF	创建供特定 CDC 服务使用的 UDTF	每个 CDC 服务和 DB2 子系统
   接受：&CDCSRV 使用：&R4ZSCNM, &R4ZIFITF, &R4ZCNFGL, &ALCSMS, &ALCSMSPM, &ALCVLSER, &SSID, &DB2EXITL, &DB2LOADL, &DB2RUNL, &UDFUSER

   第一个作业创建具有特定名称 &R4ZIFITF（在模式名称 &R4ZSCNM 下）的默认服务 UDTF，并将其执行权限授予 &UDFUSER。它还实例化了一个“提供的”CDC 服务 CDC1（通过创建此类成员 CONFIG 库），并使用默认配置对其进行设置。必须首先运行此作业。

   第二个作业是按照每个明确定义的 CDC 服务运行的，它的执行与第一个作业完全相同，只是每个 UDF 都与一个特定的 CDC 服务相关联，CDC 服务是从 CDC1 服务实例化的。

   1. 运行作业 DO3SRVDF。它将：

      • 创建一个带有非后缀名称的 UDTF，该名称将与默认 CDC 服务 (CDC1) 相关联。
      • 创建 CONFIG 库并放置一个名为 CDCS 的成员，以便在不存在 CDC 服务相关成员时使用。

      作业应终止于 RC4.

   2. 根据您要定义的每个 CDC 服务，编辑作业 DO3SRVTF；将符号和 CDCSRV 设置为相关 CDC 服务限定符并提交。它将：

      • 创建一个名为“__&CDCSRV”的 UDTF，它将与默认 CDC 服务“&CDCSRV”相关联。
      • 在 CONFIG 库中创建名为“&CDCSRV”的成员。
      • 使用相关 CDC 服务限定符 (xxxx) 设置 JCL 符号 CDCSRV，并提交作业。

      作业应终止于 RC4.

      • 授权：

        提交用户必须具有以下授权之一：

        • SYSADM 或 SYSCTRL 权限。
        • 在以下项指定的架构中的 CREATEIN 授权： &R4ZSCNM。

4. 启用指定的用户 ID 以运行 CDC 任务。

   DO4GRANT	授予 ODBC 用户对目录表的访问权限和读取 CDC 的权限	每个 DB2 子系统
   使用：&R4ZUSER, &SSID, &DB2EXITL, &DB2LOADL, &DB2RUNLR

   此作业启用为 ODBC 交互选择的用户 ID。这是“ODBC 用户”，它被授权（在 DB2 方面）读取 CDC 数据和一些 DB2 目录表。

   信息注释

   从 ODBC 用户本身（因为用户不能授予自己权限）或从不拥有其试图授予的权限的用户提交作业是没有意义的。

   运行作业 DO4GRANT。它将：

   • 针对以下表格中的 ODBC 用户的 GRANT SELECT ：

     • SYSIBM.SYSTABLES
     • SYSIBM.SYSTABLESPACE
     • SYSIBM.SYSCOLUMNS
     • SYSIBM.SYSROUTINES
     • SYSIBM.SYSDUMMY1
     • ALTER SYSIBM.SYSTABLES 启用 DATA CAPTURE。

   作业应终止于 RC 0 或 RC 4.

   授权：

   提交用户必须具有以下授权之一：

   • SYSADM 或 SYSCTRL 权限。
   • 具有授权选项的 TRACE/ MONITOR2
5. 为 WLM 启动的任务提供安全权限以取消其自身。在 RACF 中，如下完成此操作：

1. 为 OPERCMS 类定义一个名为 PERMIT MVS.CANCEL.STC.mbrname 的配置文件。*：

   RDEFINE OPERCMDS MVS.CANCEL.STC.mbrname.* UACC(NONE) SETROPTS REFRESH RACLIST(OPERCMDS)

   其中 mbrname 是已启动任务的名称。

2. 授予分配给 WLM 启动 TASK 的 USERID 取消启动任务的权限：

   PERMIT MVS.CANCEL.STC.mbrname.* CL(OPERCMDS) ACCESS(UPDATE) ID(stcuser)

   其中 stcuser 是与 WLM 启动的任务关联的 USERID。

6. 性能注意事项：

   1. 满负载 – 满负载过程将利用任何可用的 ZIIP 处理器。最佳实践是设置性能目标，将流程分类为低于在线工作负载。在非常繁忙的系统中，您可能需要考虑设置 Honor 优先级 的至 NO 用于分配给满负载的服务类别。这需要 z/OS 2.1 + OA50845 或 z/OS 2.2 和以上。

   2. CDC – 最佳实践是将 CDC 进程的性能目标设置为等于任何在线工作负载，并高于满负载目标。这些过程可以使用以下任一方法进行分类：

      - WLM 应用程序环境启动任务的名称

      - 带有“程序名称”的 DDF 分类

在 z/OS 中迁移 R4Z 产品

如果您想升级 R4Z 安装并覆盖当前安装，或者如果您想在不覆盖当前安装版本的情况下升级 R4Z 的安装，则需要执行以下概述的相关步骤。

要升级 R4Z 安装并覆盖当前安装的版本，请按以下步骤暂停使用 R4Z 的所有 CDC 服务：

1. 使用以下操作员命令停止 WLM 应用程序环境，并防止客户端在 CDC 服务准备就绪之前自动激活 CDC 服务：

   VARY WLM,APPLENV=<applic.env-name>,Q

   使用 JCL 程序对所有应用程序环境重复此操作，JCL 程序指定要替换的版本的 LOAD 库。如果主机是并行 Sysplex，请在命令之前使用 ROUT *ALL替代，将其路由到丛中的所有系统。

2. 使用 R4ZUTIL TERMINATE 动词释放 CDC 服务当前使用的所有系统资源。

   在可能正在执行的所有 LPAR 中重复此操作（如果源DB2在这些系统中具有数据共享成员）。