准备迁移单个 IBM MQ for z/OS 队列管理器

在 IBM MQ for z/OS 9.4上启动任何队列管理器之前，请查看 z/OS® 和 IBM® MQ 定制步骤，并更改任何定制。 请按照以下步骤准备迁移 z/OS 上的单个 IBM MQ 队列管理器。

1. 请准备好您的 IBM MQ 配置，以便进行迁移。

   对当前版本的库进行最新维护。 请参阅您的 IBM MQ 版本的预防性服务计划（PSP）桶；请参阅 PSP桶——如何在Web上找到它们。

2. 安装 IBM MQ for z/OS 9.4 ，并使所有运行队列管理器的 z/OS 系统都能访问目标库，并授予访问权限。

   请为每个 z/OS 系统完成以下子步骤。 如果迁移共享队列中的成员，请在迁移该组中的任何成员之前，升级托管该组成员的所有 LPAR 上的早期代码。

   1. 将 IBM MQ 目标库复制到系统，并安装 IBM MQ for z/OS 9.4 的早期代码 (针对每个 z/OS 系统一次)。
   2. APF 授权装入库并使用外部安全系统授予对数据集的访问权。
      请参阅 APF 授权 IBM MQ 装入库 以获取更多信息。
      确保 APF 在 SYS1.PARMLIB 以确保在 IPL 之后动态进行的任何更改仍然有效。
   3. 使 IBM MQ for z/OS 9.4 早期代码和目标库在运行队列管理器的每个 z/OS 系统上可用。
      这涉及更新 LPA; 请参阅 更新 z/OS 链接列表和 LPA 以获取更多信息。
      完成此操作后，将在所有队列管理器启动时在其作业记录中显示以下消息，指示它们正在使用最新版本的早期代码:

      CSQ3111I <cpf> CSQYSCMD - EARLY PROCESSING PROGRAM IS V9.4 LEVEL 010-000

      如果您正在使用 AMS ，还请将 CSQ0DRTM 添加到 LPA ，如先前链接中所述。
   4. 复制文件系统 zFS 并将其安装为只读。
      仅当安装了下列其中一项时，才需要 zFS :

      • IBM MQ for z/OS UNIX System Services Components
      • IBM MQ for z/OS Managed File Transfer
      • IBM MQ for z/OS UNIX System Services Web Components
      • IBM MQ for z/OS 连接器包

      请参阅 "程序目录" 以获取更多信息。 有关程序目录的下载链接，请参阅 IBM MQ for z/OS 程序目录 PDF 文件。
3. 对企业的每个队列管理器执行备份操作，以便在做出任何更改之前，您拥有所有对象和JCL的副本。

   如果您需要，可以轻松地恢复到当前的系统。

   1. 备份 IBM MQ 定义的对象，例如使用 CSQUTIL COMMAND MAKEDEF (..)
      请参阅 使用 CSQUTIL 的 COMMAND 函数 以获取更多信息。
   2. 备份:
      • 队列管理器，通道启动程序和 AMS 地址空间 (如果适用) 的启动式任务过程。
      • CSQINP1 和 CSQINP2 并置中使用的初始化输入数据集
      • 系统参数模块 (ZPARM) 库
      • 包含队列管理器的配置定义的 JCL 库
      • 包含队列管理器配置或过程的其他库。

      注: 您还可以将页集， BSD 和活动日志作为回退选项进行备份。 有关备份 IBM MQ 资源的更多信息，请参阅 如何备份和恢复页集 。
4. 如果您正在使用队列共享组，请绑定并授予 Db2® 计划的执行权限。

   在 hlq.SCSQPROC中定制并运行 CSQ45BPL 和 CSQ45GEX 样本。 使用 Db2 子系统名称和数据集名称，根据您的环境定制这些成员。

   CSQ45BPL 和 CSQ45GEX 中的头信息描述了如何定制样本:

   • hlq.SCSQPROC 的 CSQ45BPL 包含最新版本的 IBM MQ 所需的套餐名称
   • hlq.SCSQPROC 的 CSQ45GEX 包含所需的权限

   请参阅 设置 Db2 环境的步骤 5 和 6 。
5. 如果您正在使用队列共享组，请发送电子邮件至 CSQ5PQSG。

   必须指定 MIGRATE QSG 或 MIGRATE DSG 函数，以验证 QSG 或 DSG 中的所有队列管理器的版本是否与 IBM MQ for z/OS 9.4兼容。

6. 更新添加到STEPLIB连接中的库，使批处理、TSO和RRS适配器可用于应用程序，以便它们始终加载系统中的最高版本 IBM MQ 库。

   更改批处理， TSO 和 RRS 应用程序的 STEPLIB 以引用 IBM MQ for z/OS 9.4 库，然后重新启动这些应用程序。

   请参阅 设置批处理， TSO 和 RRS 适配器 以获取更多信息。

   IBM MQ 库包括:

   thlqual.SCSQANLX

   此库包含您所在国家/地区语言的错误消息信息，其中X是语言字母：

   • C，代表中文
   • E，代表美式英语混合大小写
   • F，法语
   • K，代表日语
   • U，代表美式英语大写

   thlqual.SCSQAUTH

   此库包含应用程序使用的代码。

   注: 您可以:

   1. 将引用 STEPLIB 中 IBM MQ for z/OS 9.4 库的应用程序连接到正在 IBM MQ for z/OS 9.4 或更低版本上运行的队列管理器。 不得将引用 STEPLIB 的应用程序从较低版本连接到在较高版本上运行的队列管理器。
   2. 使用以下命令 (将 thlqual 替换为安装的高级限定符) 来检查哪些作业正在使用指定的库运行:

      TSO ISRDDN ENQ 'thlqual.SCSQAUTH'

      然后，您可以相应地修改这些作业的 JCL。
7. 如果您打算定义 QMINI 数据集 ，请定义数据集并更新队列管理器启动 JCL，添加 CSQMINI DD 以指向您的 QMINI 数据集。
8. 更新您添加的库，以便将 CICS® 连接到队列管理器。

   必须更新 CICS 区域 JCL 的 STEPLIB 和 DFHRPL 并置中的 IBM MQ 库，然后重新启动 CICS。 然后，您可以使用最新的 IBM MQ 功能部件。

   IBM MQ 与 CICS 之间的连接由您必须更新的 CICS 库提供。 如果没有此更改，您将无法使用最新的 IBM MQ 功能部件。 必须更改 IBM MQ提供的 DFHRPL 并置中的 SCSQCICS 库以及 STEPLIB 并置。

   对于连接到 IBM MQ 队列管理器的每个 CICS 区域，请确保存在单独的 CICS 启动过程 JCL。

   这将确保对 CICS 已启动过程 JCL 中特定版本 IBM MQ 库的引用的修改仅对该单个 CICS 区域具有影响。 通过这种方式，您可以迁移一个队列管理器，并且只能迁移与其连接的一个或多个 CICS 区域，这将使登台迁移成为可能。

   CICS STEPLIB 具有 thlqual.SCSQAUTH， DFHRPL 具有 thlqual.SCSQCICS， thlqual.SCSQLOAD和 thlqual.SCSQAUTH。 更多信息，请参阅设置 CICS - IBM MQ 适配器。

   注: 您可以将引用 STEPLIB 中 IBM MQ for z/OS 9.4 库的应用程序连接到在 IBM MQ for z/OS 9.4 或更低版本上运行的队列管理器。 不得将引用 STEPLIB 的应用程序从较低版本连接到在较高版本上运行的队列管理器。
9. 将操作和控制面板库 (CSQOREXX) 更新为 IBM MQ for z/OS 9.4 库。

   有关更多信息，请参阅 设置操作和控制面板。

   注: 您可以将引用 IBM MQ for z/OS 9.4 库的操作和控制面板连接到 IBM MQ for z/OS 9.4或更低版本上运行的队列管理器。 不得将从较低版本引用 IBM MQ 库的操作和控制面板连接到在较高版本上运行的队列管理器。
10. 使用交互式问题控制系统（IPCS）更新系统库，以格式化 IBM MQ 转储。

    有关更多信息，请参阅 包含 IBM MQ 转储格式化成员。

11. 迁移其他软件以使用 IBM MQ for z/OS 9.4 库。

    迁移软件，如 WebSphere® Application Server for z/OS、 Liberty、 IBM Integration Bus 或 IMS。

    1. WebSphere Application Server for z/OS

       如果您正在使用绑定连接的应用程序服务器环境中运行，那么需要使用 IBM MQ 库更新 WAS STEPLIB。

       请参阅 IBM MQ 库和 WebSphere Application Server for z/OS STEPLIB 以获取更多信息。

       您还需要配置 IBM MQ 消息传递提供程序与来自 IBM MQ for z/OS 9.4 的 IBM MQ 安装；请参阅配置 IBM MQ 具有本机库的消息传递提供商以获取更多信息。

       使用 z/OS UNIX System Services中最新级别的本机库。

    2. WebSphere Application Server for z/OS Liberty
       如果您正在使用绑定连接的应用程序服务器环境中运行，那么需要更新 Liberty STEPLIB 以使用更新后的 IBM MQ for z/OS 库。
       您还应该更新wmqJmsClient。 rar.location变量，以及wmqJmsClient nativeLibraryPath属性，在Libertyserver.xml指明新的道路z/OS UNIX System Services组件特征。

       注: 这些步骤也适用于 IBM z/OS Connect EE。
    3. IMS

       有关更多信息，请参阅 设置 IMS 适配器。

    注: 您可以将引用 STEPLIB 中 IBM MQ for z/OS 9.4 库的应用程序连接到在 IBM MQ for z/OS 9.4 或更低版本上运行的队列管理器。 不得将引用 STEPLIB 的应用程序从较低版本连接到在较高版本上运行的队列管理器。
12. 如果您已配置了 IBM MQ Console 或 REST API ，您可能需要准备迁移 mqweb 服务器。

    托管 IBM MQ Console 和 REST API 的 mqweb 服务器只能直接连接到同一版本的 IBM MQ上的队列管理器。

    如果 z/OS 系统上只有一个队列管理器，那么现在不需要执行任何操作。 您可以在迁移队列管理器的同时迁移现有 mqweb 服务器。

    如果在 z/OS 系统上具有多个队列管理器 (在迁移期间将在不同版本的 IBM MQ 上运行) ，请在最新级别创建新的 mqweb 服务器。

    1. 通过遵循 创建 mqweb 服务器中的过程来创建新的 mqweb 服务器。
    2. 通过遵循 为 mqweb 服务器创建过程中的过程，为新的 mqweb 服务器创建启动式任务过程。
    3. 将任何相关配置设置从现有服务器的 mqwebuser.xml 配置文件复制到新 mqweb 服务器的 mqwebuser.xml 文件。
       mqwebuser.xml 文件位于 WLP_user_directory/servers/mqweb 目录中，其中 WLP_user_directory 是运行 crtmqweb 脚本以创建 mqweb 服务器定义时指定的目录。

       将新服务器配置为使用与现有服务器不同的 HTTP 和 HTTPS 端口。

    4. 通过发出 MVS START procname 命令来启动新的 mqweb 服务器，其中 procname 是新的 mqweb 服务器启动式任务过程的名称。