升级 CICSPlex SM

开始之前

建议您在升级 CICSPlex SM 环境或单个 CICS 区域之前将 CICS Explorer® 升级到最新发行版。 这将确保 CICS Explorer 可以支持目标 CICS 发行版。 有关详细指示信息，请参阅 升级 CICS Explorer。

升级操作

表 1 列出了升级到更高的 CICS 发行版时必须执行的操作，而不考虑当前发行版和目标发行版。 详细描述这些操作的部分使用 所有版本进行标记。

表 2 列出了依赖于当前发行版和目标发行版的操作。 详细描述依赖于版本的操作的部分还列出了适用的当前-目标对。

检查不同级别的 CICSPlex SM 的兼容性需求

所有版本

您可以同时运行此发行版的 CICSPlex SM 和更低发行版，但必须考虑许多条件以实现兼容性。

PTF

将服务应用于 CICSPlex SM时，应用于环境服务系统服务 (ESSS) 的 PTF 不打算向下兼容同一发行版中的较早维护级别。 这意味着所有 CMAS ， MAS ， WUI 服务器区域和 API 程序都必须在与其发行版的 ESSS 相同的维护级别运行。 否则，可能会发生异常终止，数据损坏和意外结果。 请参阅 设计 CICSPlex SM 环境 ，以获取有关 CICSPlex SM 组件配置的更多注意事项。 将 PTF 应用于 CICSPlex SM 时，必须仔细遵循与 SMP/E 维护相关的所有 ++HOLD ACTION 项目。

CMAS

您可以在 Beta 版本运行CMAS，该版本可连接至运行于 CICS TS 支持级别的CMAS。 但是：

• 适用于 z/OS® CICS TS ， beta 版 CICSPlex SM CMAS 仅在 CICS 系统中以 beta 版运行。
• 在由最新级别和一个或多个较早级别的 CMAS 组成的 CICSplex 中，维护点 CMAS (MP CMAS) 必须处于最新级别。 因此，当CICSplex包含多个层级的CMAS时，首次升级至测试版的CMAS必须是MP CMAS。 参见升级维护点 CMAS。
• 您无法通过运行较早版本的CMAS来查看某个 CICS TS 为 z/OS, beta 区域的所有资源。
• 如果您打算将较低级别的 CMAS 连接到较高级别的 CMAS ，那么需要将以下 APAR 的 PTF 应用于每个较低级别的环境。 下表显示了在较低级别的 CMAS 上需要哪些 APAR 才能连接到下一个较高级别的 CMAS。 例如， V5.3 CMAS 必须应用 APAR PI81780 才能连接到 V5.4、 V5.5 或 V5.6 CMAS。

  表 3. CMAS 兼容性 APARs

  较低级别 CMAS 的发行版	5.3	5.4	5.5	5.6	6.1	6.2	6.3	beta
  6.3	-	-	-	-	-	-	无	无
  6.2	-	-	-	-	-	-	PH66023, PH66743	无
  6.1	-	-	-	-	-	无	PH66023, PH66743	无
  5.6	-	-	-	-	无	无	PH66022, PH66742	无
  5.5	-	-	-	无	无	无	PH66022, PH66742	无
  5.4	-	-	无	无	无	无	无	无

MAS

对于要通信的 CMAS 和 MAS (包括充当 Web 用户界面服务器的那些 MAS) ，它们必须在同一发行版的 CICSPlex SM上运行。 对于最新发行版的 MP CMAS ，要与运行较早发行版的 CICS 区域进行通信， MP CMAS 必须处于最新发行版。 通过与 MAS运行同一级别的 CMAS 将 MP CMAS 连接到后级别 MAS 。 例如，运行版本 5.3 的 MAS 已连接到同时运行版本 5.3的 CMAS。 此 CMAS 依次连接到运行最新级别的 MP CMAS。 最新级别的 MP CMAS 与后级别 MAS 之间的通信是通过与 MP CMAS 连接的后级别 CMAS 进行的。

CICS 运行在受支持 CICS TS 级别的管理系统(MASs)可连接至CICSPlex SM beta。 要连接到 C ICSPlex SM beta， CICS 系统必须使用CICSPlex SM beta的 MAS 代理，因此其 CICS JCL中必须包含CICSPlex SM beta 库。

下表列出了 CICS 发行版的 MAS 代理程序支持的每个在职发行版级别。

表 4. MAS支持的运行时CICSTS版本

MAS 代理程序的发行版级别	受支持的 CICS 发行版
beta	6.1, 6.2, 6.3, 测试版
6.3	5.6, 6.1, 6.2, 6.3
6.2	5.5, 5.6, 6.1, 6.2
6.1	5.4, 5.5, 5.6, 6.1
5.6	5.3, 5.4, 5.5, 5.6
5.5	5.3, 5.4, 5.5

若您使用 API 或 WUI 管理连接至早期版本 CMAS 的 MAS，请确保这些 MAS 由 beta CMAS 进行间接管理：

• 建议在最新发行版中运行 WUI 服务器。 如果它们不存在，那么它们将无法了解最新发行版的任何资源。 如果您混用了多个发行版，那么建议仅使用最新发行版的 WUI 服务器来定义或变更资源。
• 如果需要通过使用 CICSPlex SM API 的程序从运行最新发行版的 MAS 访问最新字段，请确保 API 程序连接到运行最新发行版的 CMAS。 如果 API 程序连接到运行较早发行版的 CMAS ，那么包含新发行版的新字段或已更新字段的资源表不会返回到 API 程序。

WUI 服务器

若某早期版本的WUI服务器连接至早期版本的CMAS，且该CMAS参与了CICSplex的管理，则该WUI服务器可从连接至 beta版 CMAS的 MAS 中检索数据。 但是， WUI 服务器无法检索有关先前发行版中不可用的资源类型的数据。

要创建以下任何 CICSPlex SM 对象，必须使用与 MP CMAS 在同一 CICSPlex SM 发行版级别运行的 WUI 服务器:

• CPLEXDEF (CICSPlex 定义)
• CMTCMDEF (CMAS 到 CMAS 链路定义)
• CSYSGRP (系统组定义)
• PERIODEF (时间段定义)
• MONSPEC (监视器规范)
• MONGROUP (监视组)
• MONDEF (监视器定义)
• RTAGROUP (RTA 组)
• RTADEF (RTA 定义)
• WLMSPEC (WLM 规范)
• WLMGROUP (WLM 组)
• WLMDEF (WLM 定义)
• TRANGRP (事务组)

同样，如果使用 API ， EYU9XDBT 或 BATCHREP 批处理存储库更新工具来创建这些对象，请确保这些工具在与 MP CMAS 相同的 CICSPlex SM 发行版级别运行。

工作负载管理

工作负载功能由拥有工作负载的 CMAS 控制。 将工作负载所有者分配给 CMAS ，该 CMAS 管理导致初始化工作负载的首次启动的 TOR。 如果工作负载未显示为 ACTIVE ，那么与工作负载关联的首次启动的 TOR 将导致其关联的 CMAS 成为工作负载所有者。

要确保工作负载可以利用 UOW 亲缘关系，请确保将现有工作负载克隆到新名称，并将任何必需的 UOW 亲缘关系定义应用于新名称。

备份 CICSPlex SM 配置

所有版本

升级维护点 CMAS

所有版本

您必须在升级CICSPlex SM CMAS所运行的 CICS 系统时，同时将其升级至测试版。 CICSPlex SM CMAS仅能在相同版本级别的 CICS 系统中运行。 启动时，CMAS会检查 CICS 的版本号，若版本不匹配则停止 EYUXL0142 并显示错误信息。

在一个由处于beta 级别的CMAS和一个或多个较早级别的CMAS组成的CICSplex中，维护点CMAS（MP CMAS）必须处于 beta 级别。 因此，当CICSplex包含多个层级的CMAS时，首个升级至测试版的CMAS必须是MP CMAS。 要升级 MP CMAS ，请使用以下步骤。

1. 如果 MP CMAS 正在运行，请将其停止。 当 MP CMAS 关闭时，您可以继续在 CICSplex 中运行工作负载。 缺少 MP CMAS 不应影响正在运行的工作负载，但请勿在 MP CMAS 关闭时更改任何定义。

2. 将 CICS 模块升级至测试版。 有关动态更新 DFHIRP 的更多信息，请参阅《 升级 MRO》。

3. 在包含CMAS的 z/OS 映像中，请确认用于 z/OS 初始化的 SYS1.PARMLIB 库中的IEASYSxx成员包含 和 NSYSLX MAXCAD 参数，且每个参数均具有适当的值。 在 IEASYSxx 中正确指定每个 CMAS 说明了适合的值。 若您同时运行了CICSPlex SM 的旧版本和测试版 ，则每个版本都会启动一个环境服务系统服务（ESSS）空间，因此您可能需要修改该值 NSYSLX 。

4. 通过将测试版库添加到 SYS1.PARMLIB 中相应PROGxx或IEAAPFxx成员的APF授权库列表中，对其进行授权。 参见 《 CICS 和CICSPlex SM库的授权说明》。

5. 更新 MVS 链接列表，添加 CICS 和CICSPlex SM 所需的测试版模块。 请参阅 《安装 CICS 所需模块》一文，该文位于 MVS 链接列表中。

6. 使用测试版资源定义组和 CICS 启动组列表升级CMAS使用的CSD文件。 您无需为 CICSPlex SM 执行额外的升级操作，该升级操作依赖于特定版本的定义集。 CICS 在XDFHINST库中提供名为DFHCOMDS的工作，该库在运行DFHISTAR时创建。 此作业假定已创建并初始化新的 CSD。 在许多情况下，您想要复制 CMAS 当前使用的 CSD ，并升级此副本，如以下示例作业中所示:

   //DFHCSDUP JOB MSGCLASS=A,NOTIFY=&SYSUID,CLASS=A                      
   //*                                                                   
   //* UPGRADE THE CSD                                                   
   //*                                                                   
   //CSDADD1  EXEC PGM=DFHCSDUP,REGION=2000K,PARM='CSD(READWRITE)'       
   //SYSPRINT DD SYSOUT=A                                                
   //STEPLIB  DD DISP=SHR,DSN=BLD.CICSDEV.INCCUR.SDFHLOAD                
   //DFHCSD   DD DSN=CTSSVT.ZZAMIG.D111018.CMASZZA.BK.CSD,DISP=SHR       
   //SYSIN    DD *                                                       
     UPGRADE REPLACE                                                     
   /*                                                                    
   //  
   

7. 如果已修改先前发行版的缺省资源定义，请手动升级已修改的资源定义。 CICSPlex SM 在 EYU$CDEF 样本中提供了这些定义，其中包含 CMAS 的定义。 要手动升级您修改过的资源定义，请使用EYU$CDEF示例中对应的测试版内容。

   升级已修改的资源定义的一个好方法是复制已升级的缺省资源定义，然后重新应用您的修改。 请务必升级已修改的定义，以确保使用任何新属性的非缺省值正确定义这些定义。 如果不存在，那么 CICS 会将缺省值分配给任何新属性，并且这些缺省值可能不适合您的需求。

8. 使用 EYU9XDUT 实用程序将CMAS的数据存储库（EYUDREP数据集）升级至 beta 版本。 请注意，必须升级数据存储库文件本身，而不是数据存储库的副本。 否则，当 CMAS 在新级别重新启动时，可能会发生 CMAS 隔离问题。 有关如何升级数据存储库的信息，请参阅《 创建和填充CICSPlex SM数据存储库》。 转换实用程序将现有数据存储库的内容复制到新分配的数据存储库。 现有数据存储库不会修改。

   注: 升级 CMAS 的数据存储库后，下次启动 CMAS 时，它必须指向已升级的 EYUDREP 数据集。 否则，可能会丢失数据存储库更新。 此丢失可能会导致不正确的结果，这可能包括其他 CMAS 在连接到此 CMAS 时自行隔离的 CMAS。 升级后，如果选择回滚到从中升级的版本，请使用带有 PARM = ('TARGETVER=original version number') 的 EYU9XDUT 实用程序来回滚已升级的 CMAS 数据存储库。 如果不执行此操作，那么 CMAS 可能会变为隔离式。

9. 使用 DFHCCUTL 和 DFHRMUTL 实用程序删除，重新定义和初始化 CICS 本地目录和全局目录。 如果使用 DFHISTAR 来安装 CICS，那么它将创建名为 XDFHINST 的库。 此库包含成员 DFHDEFDS ，用于创建 LCD 和 GCD 文件并对其进行初始化。 DFHDEFDS 还会创建 CICS 需要的其他文件，例如 DFHTEMP ， DFHINTRA 和 DFHLRQ。

10. 检查 EYUPARM DD 语句引用的 CICSPlex SM 系统参数。 如果 CASNAME 系统参数存在，请将其删除。 更多信息，请参阅 EYUPARM 数据集中的 CICSPlex SM 系统参数。

11. 检查 CICS 系统初始化参数 GRPLIST 是否引用 CICS 提供的缺省启动组列表 DFHLIST 以及包含已修改的资源定义的任何 CSD 组。

12. 对已升级的 MP CMAS 使用初始启动过程。

升级 WUI 和 WUI 服务器存储库 (EYUWREP) 的内容

所有版本

Web 用户界面 (WUI) 服务器及其连接的 CMAS 必须处于 CICSplex 中 CICSPlex SM 和 CICS 的最高级别。 它们必须与 MP CMAS 处于同一级别。 可以使用尚未升级到与 MP CMAS 相同的级别的 WUI 服务器，但这些服务器可能会返回不可靠的结果，直到您对其进行升级为止。

WUI 服务器只能连接到同一发行版级别的 CMAS。 在升级 WUI 服务器之前，必须使用 升级非维护点 CMAS中的指示信息来升级它所连接的 CMAS。 如果 WUI 服务器所连接的 CMAS 不是 MP CMAS ，那么在启动 WUI 服务器及其所连接的 CMAS 之前，还必须升级 MP CMAS。 在启动任何其他MAS之前，请先将WUI服务器升级至测试版 ，以便其能够管理已升级的MAS。

作为WUI服务器的 CICS 系统是一个本地 MAS。 然而，在升级WUI服务器时，必须将CICSPlex SM （ MAS ）代理和 CICS 区域同时升级至测试版。 在其他MAS系统中，您只需升级 CICSPlex SM的MAS 代理，无需升级 CICS 区域。

截至 CICS TS 5.6 版本，WUI 区域的 CMCI 默认使用 CMCI JVM 服务器。 因此，在升级 WUI 服务器后，您必须升级 CMCI 以使用 CMCI JVM 服务器 ，除非它已经使用 CMCI JVM 服务器。

如果使用 CICS Explorer，那么在升级 WUI 服务器之后，请升级 CICS Explorer ，因为它依赖于 WUI 服务器来返回数据。 您可以随时升级 CICS Explorer ; 请参阅 升级 CICS Explorer。

使用以下步骤来升级 WUI 服务器和 WUI 服务器存储库。

1. 创建一组新的 WUI 文件，或者将现有 WUI 文件的副本升级到最新发行版。

   如果使用了 DFHISTAR ，那么它创建的 XDFHINST 库包含成员 EYUWUIDS。 运行 EYUWUIDS 时，它将创建新的 WUI 服务器存储库 (EYUWREP) 以及一些新的导入 (EYUCOVI) 和导出 (EYUCOVE) 文件，以便稍后在定制或使用您自己的 WUI 视图或菜单时使用这些文件。 EYUWUIDS 还会创建 WUI ，跟踪，转储， IN TD ， LCD ， GCD ， LRQ 和 CSD 文件。

2. 如果您复制自己的文件，那么必须创建空的 WUI 服务器存储库文件 (EYUWREP)。 将在稍后的步骤中进行填充。 如果您定制了 WUI (例如，使用您自己的菜单，视图或用户) 以在升级后保留这些更改，请导出，然后从当前 WUI 重新导入工件。 您可以将 COVC 事务用于导出和导入。 如果仅使用 IBM®提供的 WUI 菜单和视图，那么可以跳过此步骤的其余部分。

   使用先前由 EYUWUIDS 创建的 EYUCOVE (导出) 数据集，将 COVE 文件应用于要从中导出的 WUI 的 WUI 启动 JCL。 例如：

   
   //EYUCOVI  DD DSN=hlq.EYUCOVI,DISP=SHR                        
   //EYUCOVE  DD DSN=hlq.EYUCOVE,DISP=SHR

   在 WUI 以原始版本运行的情况下，您已准备好导出到 EYUCOVE 数据集。 通过选择 导出 选项来使用 COVC 事务。 为 输出 TDQ 名称指定 COVE。 对于 类型，指定 MENU ， VIEWSET ， USERGRP ， USER 或 MAP ，或者指定 ALL 以将所有工件一起抽取。 以下示例将以字符 JON* 开头的所有工件导出到 COVE:

   

   导出数据后，必须稍后在步骤 升级 Web 用户界面服务器存储库 (EYUWREP) 的内容中导入该数据。

3. 授权测试版 CICS 和 CICSPlex SM 库。 参见 《 CICS 和CICSPlex SM库的授权说明》。

4. 若使用链接包区域（LPA），请确定计划何时用测试版模块替换LPA中的先前发布版本模块。 安装在LPA中的每个CICSPlex SM 模块只能由与其相关的 CICSPlex SM 版本使用。

   1. 若立即将测试版模块放入LPA，请将先前发布的MAS修改为使用STEPLIB和DFHRPL组合中的旧版本模块，而非LPA中的模块。
   2. 若在升级流程末尾将测试版模块放入LPA，请确保已升级的MAS系统使用STEPLIB和DFHRPL组合中的测试版模块而非LPA中的模块，待替换模块时再切换为使用LPA中的模块。

   有关更多信息，请参阅 控制使用 LPA 中的模块。

5. 使用测试版资源定义组和 CICS 启动组列表升级WUI使用的CSD文件。 您无需为 CICSPlex SM 执行额外的升级操作，该升级操作依赖于特定版本的定义集。 CICS 在XDFHINST库中提供名为DFHCOMDS的工作，该库在运行DFHISTAR时创建。 此作业假定已创建并初始化全新的 CSD。 在许多情况下，您想要复制 WUI 当前使用的 CSD ，并升级此副本，如以下示例作业中所示。

   //DFHCSDUP JOB MSGCLASS=A,NOTIFY=&SYSUID,CLASS=A               
   //*                                                            
   //* UPGRADE THE CSD                                            
   //*                                                            
   //CSDADD1  EXEC PGM=DFHCSDUP,REGION=2000K,PARM='CSD(READWRITE)'
   //SYSPRINT DD SYSOUT=A                                         
   //STEPLIB  DD DISP=SHR,DSN=BLD.CICSDEV.INCCUR.SDFHLOAD         
   //DFHCSD   DD DSN=CTSSVT.ZZAMIG.D111018.WUIZZA.CSD,DISP=SHR    
   //SYSIN    DD *                                                
     UPGRADE REPLACE                                              
   /*                                                             
   //                                                       

6. 若您曾修改过CICSPlex SM在EYU$WDEF示例中为早期版本提供的动态创建资源定义，请使用EYU$WDEF示例中针对测试版的等效定义手动升级您修改过的资源定义。

   升级修改过的资源定义的好方法是复制测试版资源定义，然后重新应用您的修改。 请务必升级已修改的定义，以确保使用任何新属性的非缺省值正确定义这些定义。 若未指定， CICS 将为所有新属性分配默认值，而这些默认值可能不适用于 CICS 提供的资源定义。

7. 编辑用于启动Web用户界面服务器的JCL，将旧版本库名称替换 CICSPlex System Manager 为测试版名称。 有关 MAS 启动JCL的信息，请参阅在启动 MAS 之前更改启动JCL。

8. 检查是否为 CICS 区域指定了 CICS 系统初始化参数 EDSALIM ，并将其设置为值 800 MB。 在 5.3 及更高版本中，800 MB 是 CICS 区域的默认 EDSALIM 值。 您可以通过与调优 CMAS 中的 CICS 存储器类似的方式来调优此值。 您可以在以下位置中指定启动前的系统初始化参数:

   • 在 DFHSITxx 装入模块中指定的系统初始化表中，其后缀 (xx) 指定为 SIT = 系统初始化参数。
   • 在 EXEC PGM=DFHSIP 语句的 PARM 参数中。
   • 在启动作业流中定义的 SYSIN 数据集中。

9. 检查是否为 CICS 区域指定了 CICS 系统初始化参数 CPSMCONN=WUI 。 此系统初始化参数将 CICS 区域初始化为 Web 用户界面服务器，并动态创建 CICSPlex SM所需的资源定义。

10. 检查 CICS 系统初始化参数 GRPLIST 是否引用了以下工件:

    • CICS提供的缺省启动组列表， DFHLIST
    • 包含您修改的资源定义的任何 CSD 组
    • 您自己的应用程序的定义列表

11. 确保使用 DFHCCUTL 和 DFHRMUTL 实用程序删除，重新定义和初始化 CICS 本地目录和全局目录。

12. 如果使用 MAS 历史记录，请使用 EYUJHIST 样本作业定义新的历史记录数据集。 如果您希望升级现有历史记录数据集，那么还可以使用 EYUJHIST 样本作业以及此样本中提供升级指示信息的注释对其进行升级。 EYUJHIST 样本在 TDFHINST 库中未定制，由 DFHISTAR 在 XDFHINST 库中定制。 请记住编辑 MAS 启动 JCL 以包含历史记录数据集。

升级 Web 用户界面服务器存储库 (EYUWREP) 的内容

完成此任务，将菜单、视图和用户组填充到 WUI 服务器存储库中。 您可以选择使用 IBM 提供的菜单和视图，也可以选择使用自己定制的菜单和视图，或者两者结合使用。

对于 CICS的每个发行版，内部 Web 用户界面存储库记录版本可能会递增，以启用视图定义中的新功能。 因此，即使现有的网络用户界面资源库包含自定义视图集或菜单，也必须升级视图集和菜单定义。

在升级 WUI 服务器的先前步骤中，您使用 COVC 事务将现有视图集和菜单定义从 Web 用户界面服务器存储库导出到导出文件。 当您将Web用户界面服务器存储库升级至测试版时，可将先前版本的视图集和菜单定义导入至新的Web用户界面服务器存储库。 您不需要更改现有定制视图和菜单，但可以考虑在下一个发行版级别修改或创建新的视图集以包含新的属性和资源。

1. 确保已完成先前的 步骤 ，以将视图集和菜单定义导出到 COVE 文件。

2. 修改 WUI 启动 JCL，使导出数据集成为用于 COVI（导入）文件的 DD 名称。 例如：

   
   //EYUCOVI  DD DSN=hlq.EYUCOVE,DISP=SHR

3. 启动 WUI。

4. 使用 COVC 从 TDQ 导入 选项从 COVI 数据集导入视图集和菜单定义。 为 输入 TDQ 名称指定 COVI。 对于 类型，可以指定 MENU ， VIEWSET ， USERGRP ， USER 或 MAP 或 ALL 以将所有工件一起导入。 为 导入选项 指定 OVERWRITE 以硬化更改。 以下示例从 COVI 导入所有更改:

   

将 CMCI 升级为使用 CMCI JVM 服务器

所有版本

从 CICS TS 5.6 版本开始，CMCI 接口默认使用 CMCI JVM 服务器。 根据 CICS TS 6.2 的信息 ，CMCI JVM 服务器由 EYUWUI 参数控制 CMCIPROVIDER。 默认情况下，如果您未在 WUI 初始化参数中进行指定，则 CMCI JVM 服务器将被启用。 可以通过将 CMCIPROVIDER WUI 初始化参数设置为 来关闭 CMCI JVMCICS 服务器。

要为您的 CICSPlex SM 配置 CMCI JVM 服务器，请按照《 使用 CICSPlex SM 设置 CMCI 》中的说明进行操作。

如果您的 CICSPlex SM WUI 区域因升级到更高版本的 CICS TS 而使用 CMCI JVM 服务器，请确保授予用户访问权限，使其能够通过 CMCI JVM 服务器进行身份验证，包括使用 CMCI 的权限。 如果您使用的是 RACF® ，则必须定义 RACF EJBROLE配置文件 &PROFILE_PREFIX.CMCI.CMCIUSER ，并授予所有CMCI用户对此配置文件的读取权限。 有关详细信息，请参阅 在 WUI 区域中配置 CMCI。

请更新您的 CMCI JVM 服务器配置，以使用 Java 11 或更高版本

如果您的 CICSPlex SM WUI 区域已使用 CMCI JVM 服务器 ，则应执行此操作。 此操作取决于当前发行版和目标发行版。

• 当前发行版: 6.1 或更低版本
• 您的目标版本 ： 6.2 或更高版本

如果您的 CMCI JVM 服务器配置文件使用的是 Java 8，则必须更新配置以使用 Java 11 或更高版本。 有关设置 Java 版本的更多信息，请参阅 设置 Java 运行时版本。

6.3 beta 由于截至目前 CICS TS 6.3，Java 8 和 Java 11 尚未获得支持，您必须更新配置以使用 Java 17 或更高版本。

为CICSPlex SM WUI 服务器设置 CICSPlex SM WUI 服务器初始化参数TCPIPSSL

如果 CICSPlex SM WUI 服务器激活了 CICS 安全性（即设置了 SEC=YES 系统初始化参数），则需要使用 CICSPlex SM WUI 服务器初始化参数 TCPIPSSL ，该参数没有默认设置；必须在 EYUWUI 数据集中设置一个值。 有关 CICSPlex SM WUI 服务器初始化参数的更多信息，请参阅 EYUWUI 数据集中的 WUI 初始化参数 和 指定 CICSPlex SM WUI 服务器初始化参数。

升级非维护点 CMAS

所有版本

您必须在升级CICSPlex SM CMAS所运行的 CICS 系统时，同时将其升级至测试版。 CICSPlex SM CMAS仅能在相同版本级别的 CICS 系统中运行。 启动时，CMAS会检查 CICS 的版本号，若版本不匹配则停止 EYUXL0142 并显示错误信息。

您可以在升级 MP CMAS 的同时升级非 MP CMAS ，或者，如果您正在规划分阶段迁移，那么可以稍后升级非 MP CMAS。 如果在升级期间运行工作负载，那么非综合系统优化的工作负载将继续运行，但当 CMAS 关闭时，有关区域运行状况的信息可能不可用。 在此期间，此不可用性可能会影响路由决策。 对于综合系统优化的工作负载，在 CMAS 关闭时，应继续从耦合设施获取区域信息。

升级非 MP CMAS 时，将从其数据存储库中除去所有 CICSplex 记录。 CMAS 无法连接到其 MAS ，也无法连接到连接到其他 CMAS 的 MAS ，直到它重新连接到其 MP CMAS ，此时其数据存储库将针对 CICSplex 进行再同步。 MP CMAS 和非 MP CMAS 都发出 EYULOG 消息 EYUCP0203I 和 EYUCP0204I。 直到两个 CMAS 发出这两个消息之后，数据存储库同步才会完成。 根据 CICSplex 中的记录数， MP CMAS 通常需要比非 MP CMAS 更长的时间。 在这种情况下，非 MP CMAS 上的两条消息之间的时间段很短，但 MP CMAS 上的两条消息之间的时间段更长。

升级 CICSPlex SM 管理的 CICS 系统 (MAS)

所有版本

在将 CICSPlex SM MAS 升级至CICSPlex SM beta 时，您可选择仅升级 CICSPlex SM MAS 代理。 您无需同时将 CICS 区域升级至测试版。

在将CICSPlex SM的MAS 升级至CICSPlex SM beta之前，必须先升级其连接的 CICSPlex SM CMAS。 您还必须升级 CICSplex 的 Web 用户界面服务器。

1. 若使用链接包区域（LPA），请确定计划何时用测试版模块替换LPA中的先前发布版本模块。 安装在LPA中的每个CICSPlex SM模块只能由与其相关的 CICSPlex SM 版本使用。

   1. 若立即将测试版模块放入LPA，请将先前发布的MAS修改为使用STEPLIB和DFHRPL组合中的旧版本模块，而非LPA中的模块。
   2. 若在升级流程末尾将测试版模块放入LPA，请确保已升级的MAS系统使用STEPLIB和DFHRPL组合中的测试版模块而非LPA中的模块，待替换模块时再切换为使用LPA中的模块。

   有关更多信息，请参阅 控制使用 LPA 中的模块。

2. 在用于启动 MAS 的JCL中，将STEPLIB连接中的旧版本SEYUAUTH库名称，以及DFHRPL连接中的旧版本SEYULOAD库名称，替换为测试版的 SEYUAUTH和SEYULOAD库名称。 beta版 SEYUAUTH库必须为APF授权，您在升级CMAS时已完成此操作；但SEYULOAD库则不得授权。 有关 MAS 启动JCL的信息，请参阅在启动 MAS 之前更改启动JCL。

3. 检查是否为 CICS 区域指定了 CICS 系统初始化参数 EDSALIM ，并将其设置为值 800 MB。 800 MB是 CICS 区域在测试版中的 EDSALIM 默认值。 您可以在以下位置中指定启动前的系统初始化参数:

   • 在 DFHSITxx 装入模块中指定的系统初始化表中，其后缀 (xx) 指定为 SIT = 系统初始化参数。
   • 在 EXEC PGM=DFHSIP 语句的 PARM 参数中。
   • 在启动作业流中定义的 SYSIN 数据集中。

4. 如果使用 MAS 历史记录，请使用 EYUJHIST 样本作业定义新的历史记录数据集。 如果您希望升级现有历史记录数据集，那么还可以使用 EYUJHIST 样本作业以及提供升级指示信息的样本中的注释来执行此操作。 EYUJHIST 样本在 TDFHINST 库中未定制，由 DFHISTAR 在 XDFHINST 库中定制。 请记住编辑 MAS 启动 JCL 以包含历史记录数据集。

5. 若您也希望立即将 CICS 区域升级至测试版 ，则必须按照说明升级 CICS 的CSD。 然而，您无需对CSD进行任何额外升级即可获取 CICSPlex SM 的资源定义，因为所有CICSPlex SM 资源均通过动态方式定义和安装。

6. 在启动最新级别的 MAS 之前，仍必须考虑执行更多步骤。 请参阅 《升级 CICS 区域》 以获取有关激活许可证文件，以及在最新版本中删除、定义和初始化全局及本地目录的操作说明。 当 已 准备好启动 MAS时，如果在 MAS中升级了 CPSM 代码和 CICS 代码，请使用初始启动过程。 如果已升级 CPSM 代码但未升级 CICS 代码，那么可以使用冷启动过程或自动启动过程。 但是，如果未执行冷启动或初始启动，那么可能会发出消息 EYUNX0013E 。

将 PLTPI 迁移到使用 CPSMCONN

此操作取决于当前发行版和目标发行版。

• 当前发行版: 5.5 或更低版本
• 您的目标发行版: 5.6 或更高版本

从 CICS TS 5.6开始，不再支持使用 PLTPI 直接运行 CICSPlex SM PLT 程序。 必须使用 CPSMCONN 系统初始化参数进行迁移。

返回顶部

升级 CICSPlex SM API 程序

所有版本

在先前版本中为在 MAS 环境中运行而编写的CICSPlex SM API程序，可在测试版MAS 中运行。 您可以继续访问先前版本提供的数据，或访问测试版中可用的全新数据。 有关在不同版本的CICSPlex SM中使用API程序的信息，请参阅 《CICSPlex SM各版本间的兼容性》。

如果您已修改应用程序以使用 EYUAWTRA COMMAREA 调用 EYU9XLOP ，请使用最新版本重新编译并链接编辑这些程序。

查询 WLMAWTOR (活动路由区域) 资源的 CICSPlex SM API 程序返回的记录数增加，因为 WLMAWTOR 现在包含有关由于新键属性 RPTINGCMAS (报告 CMAS 名称) 而产生的工作单元的额外统计信息。

对于工作负载中的每个 TOR ，将从参与工作负载的每个 CMAS 返回 WLMAWTOR 记录; 即，管理工作负载中的 TOR 的每个 CMAS。 因此，查询 WLMAWTOR 的 API 程序有更多记录要处理。 要处理的数目取决于工作单元计数的结束。 如果将结果集中的第一个记录视为唯一记录，那么现有 API 应用程序不受影响。

退出 CICS 升级

所有版本

要退出升级，请使用以下步骤：

升级区域状态服务器 (仅针对综合系统优化的工作负载用户)

所有版本

区域状态服务器 (RS 服务器) 是标准 CICS 耦合设施数据表 (CFDT) 服务器，保留用于 CICS 区域状态记录和报告。 对 CFDT 服务器功能的任何升级也适用于 RS 服务器。 要升级 RS 服务器，请遵循 升级 CICS 数据共享服务器中的建议。

更新 Tivoli NetView SNA 通用警报的使用者 (仅适用于 Tivoli NetView 用户)

所有版本

升级到新版本的 CICS TS时， CICS TS 产品标识的 GDS MSU 段在 CICSPlex SM生成的 SNA 通用警报中更改。

产品集标识 (X'10') MS 公共子向量是 产品标识 (X'11') 公共子向量，用于将产品标识为 IBM 软件 (X'04')。 它包含用于标识产品编号的 产品编号 (X'08') 产品标识子字段。 请参阅 《CICSPlex SM 的变更》 以了解不同版本的“ CICS Transaction Server for z/OS ”所使用的产品编号。

如果使用基于 SNA 通用警报头 (用于标识产品标识) 的 Tivoli NetView 自动化处理例程，那么必须更新自动化表处理以检查新版本的 CICS TS 以继续处理 SNA 通用警报。

有关使用消息自动化表路由警报的信息，请参阅 《 Tivoli NetView for z/OS 自动化指南》中的“编写自动化表语句以自动化 MSU”。

重新编译程序以匹配 CICSPlex SM 的当前发行版

所有版本

此信息仅适用于连接到先前发行版的 CICSPlex SM的程序。

指定 CRITERIA 字符串以限制 GET 或 PERFORM OBJECT 请求上的结果集的大小，或者使用指定 FILTER 动词的 API 程序可能会经历 CMAS CPU 和 ESSS 存储器的增加。 批处理作业运行时间也可能会增加。

升级到新发行版时，不需要重新编译 CICSPlex SM API 程序。 但是，如果不重新编译受影响的程序，那么 CMAS 必须将记录从当前发行版格式转换为 CONNECT 动词上的 VERSION 关键字上指定的级别。 当结果集非常大 (例如， 30 万到 50 万条记录) 时，对于 CPU 和存储器而言，此变换过程非常密集。 在大多数情况下，当使用条件字符串来过滤结果集时，会观察到增加; 例如，通过对特定或通用程序使用 NAME 键来指定 PROGRAM 对象的条件。 在这种情况下， CICSPlex SM 必须检索所有程序对象并将它们返回到连接 API 的 CMAS ，将记录转换为 API 的版本，然后应用过滤。

如果重新编译程序以指定 VERSION 关键字来与 CICSPlex SM的当前发行版匹配，那么不会进行此转换，并且存储器和 CPU 使用量不会显着增加。

重新运行 EYUJHIST 以升级 CICSPlex SM 历史记录数据集

所有版本

EYUHIST* 数据集的记录大小通常在更高发行版级别增加。 必须重新运行 EYUJHIST 样本作业以升级 CICSPlex SM 历史记录数据集。 请参阅 CICSPlex SM 安装和定义 ，以获取按发行版列出的 EYUHIST* 数据集的记录大小。