记录器环境的需求规划和核对表

概述了设置 CICS® 日志记录环境的需求和过程。

该过程包含 MVS™ 系统程序员， CICS 系统程序员和安全管理员的任务，并且需要所有组之间的密切合作。

  • 规划记录器环境。
    考虑可能的存储器选项，在三种可用硬件选项中选择要使用的一种选项：
    • 非易失性耦合设施，其中日志流数据在 MVS 记录器数据空间中进行双工。 非易失性存储器需要使用备用电池或不间断电源 (UPS)：
      • 当使用 UPS 时，使用硬件控制台命令来更新耦合设施状态。
      • 当使用后备电池时，电池必须是联机且充了电的。
    • 易失耦合设施，这个设施中的日志流数据被复制到登台数据集。
    • 仅限 DASD ，其中日志流数据在 MVS 记录器数据空间中是双工的。
    请参阅 耦合设施或仅 DASD-only?， 以帮助您决定其中一个或两者的组合。
    制定以下规划决策：
    • 确定需要记录器支持的 CICS 区域数，从而确定系统日志流数。
    • 确定区域使用的用户日志和自动日志的数量。
    • 确定 VSAM 数据集需要的正向恢复日志的数量。
    • 确定是否在区间共享任何用户日志或正向恢复日志流（以自动创建合并的数据）。 系统日志流（DFHLOG 和 DFHSHUNT）不能共享。

      仅 DASD 日志流只能在同一 MVS 映像中共享。

    • 确定要使用的耦合设施的数量和大小。

      有关耦合设施类型的信息，请参阅 z/OS MVS Setting Up a Sysplex。 MVS 系统记录器支持的耦合设施的最低级别为 CFLEVEL=1，具有支持 CFLEVEL=1的耦合设施控制代码的相应服务级别。

    • 确定日志流大小：
  • 应用任何维护更新。
    确保应用影响 MVS 系统记录器以及 CICS 日志管理器及其实用程序的所有维护。
    • 与 MVS 系统记录器相关的记录器可维护性 APAR 由 LOGRSERVICE 关键字标识。
    • 与 CICS 日志管理器相关的 APAR 由 CICSLOGR 关键字标识。
  • 创建和格式化 LOGR 耦合数据集。
    必须知道日志流的数量，而对于耦合设施日志流，必须知道结构的数量。 每个 CICS 区域都需要两个系统日志流和以下可选日志流:
    • 用于记录日志的日志流。
    • 用于正向恢复日志的一个或多个日志流。
    • 用于自动日志的一个或多个日志流。
    • 用于用户日志的一个或多个日志流。
    请与 MVS 系统程序员协商，完成以下步骤:
    • 使用 MVS 实用程序 IXCL1DSU 来创建和格式化主和备用 LOGR 耦合数据集。
    • 向 SYS1.PARMLIB 中 COUPLExx 成员中的综合系统标识 LOGR 耦合数据集。
    • 使综合系统可以使用 LOGR 耦合数据集。
    有关更多信息，请参阅 z/OS MVS Setting Up a Sysplex中的 Format the LOGR Couple Data Set and Make it available to the Sysplex 。
  • 定义耦合设施结构。

    如果您将耦合设施用于部分或所有日志流，请使用必需的结构定义来更新 CFRM 策略和 LOGR 耦合数据集。 请参阅 定义耦合设施结构 以获取详细信息，包括样本作业。

  • 建立必需的安全性权限
    确保对运行系统记录器或者定义或访问记录器资源所涉及的所有用户标识进行授权，以及在 LOGSTRM 常规资源类中定义了必要的概要文件。
    • 如果 MVS 系统记录器地址空间 (IXGLOGR) 未被授予 SAF 特权或可信状态，请确保向运行 IXGLOGR 的用户标识授予所需的权限。 例如，如果运行 IXGLOGR (在 RACF® 启动过程表 (ICHRIN03) 中定义或在 RACF STARTED 类概要文件中定义) 的用户标识为 SYSTASK:
      • SYSTASK 需要对 FACILITY 常规资源类中 IXLSTR 结构概要文件的 ALTER 访问权，以便访问日志流耦合设施结构。
      • SYSTASK 需要 DATASET 常规资源类中数据集概要文件 (hlq.data_set_name) 的 ALTER 访问权，用于访问每个 DASD 日志流和登台数据集。
    • 要使用 MVS 系统记录器 IXCMIAPU 实用程序来定义，更新和删除 LOGR 耦合数据集中的条目，必须对 LOGSTRM 和 FACILITY 常规资源类中的相关 RACF 概要文件具有相应的权限。 有关如何执行此操作的信息和示例，请参阅 授权 IXCMIAPU 用户 。
    • 要启用 CICS 以动态创建日志流并写入日志流，请确保 CICS 区域用户标识具有必需的权限。 请参阅 针对 CICS 区域的授权 ，以获取有关如何执行此操作的信息和示例。

    确保对运行系统记录器或者定义或访问记录器资源所涉及的所有用户标识进行授权，以及在 LOGSTRM 常规资源类中定义了必要的概要文件。 有关系统记录器的权限的更多信息，请参阅 z/OS MVS Setting Up a Sysplex。

  • 检查 PARMLIB 中的综合系统 (sysplex) 定义。

    要使用 MVS 系统记录器，每个 MVS 映像都必须是综合系统的成员。 确保在 PARMLIB 成员 IEASYSxx 中的综合系统定义 指定了 PLEXCFG (MONOPLEX) ，单成员综合系统或多成员综合系统的 PLEXCFG (MULTISYSTEM)。 还要确保在 PARMLIB 中定义了 COUPLExx 成员。 COUPLExx 中 SYSPLEX 参数上指定的值是仅 DASD 和登台数据集名称的组成部分。

  • 激活 LOGR 子系统。
    确保 LOGR 子系统处于活动状态，以便 CICS 日志管理器批处理实用程序 DFHJUP 可以格式化和打印日志数据。 LOGR 字系统由 IEFSSNxx PARMLIB 成员中的下列项定义：
    SUBSYS SUBNAME(LOGR) INITRTN(IXGSSINT)
  • 规划登台数据集需求。
    登台数据集同时用于仅 DASD 和耦合设施日志流，如果已指定，那么由 MVS 系统记录器动态分配:
    • 对于仅 DASD 日志流，登台数据集是主（临时）存储器。
    • 对于耦合设施日志流，登台数据集由系统记录器分配，以便在日志数据处于易失配置的情况下，保护日志数据；即：
      • 缺少耦合设施后备电池
      • 导致日志数据的唯一副本位于 MVS 本地存储器缓冲区中的结构故障。
    请查看以下参数：
    • STG_DUPLEX (YES) 和 DUPLEXMODE (COND) 使系统记录器在耦合设施不是独立故障的情况下使用登台数据集 (请参阅 针对耦合设施日志流的登台数据集 以获取更多信息)。
    • STG_MGMTCLAS，指定要用于登台数据集分配的“系统管理存储器（SMS）”管理类（仅当指定了 STG_DUPLEX(YES) 或 DASDONLY(YES) 时有效）
    • STG_STORCLAS，指定要用于登台数据集分配的 SMS 存储器类（仅当指定了 STG_DUPLEX(YES) 或 DASDONLY(YES) 时有效）。
    • STG_SIZE，用于指定登台数据集的大小。
    • SHAREOPTIONS (3, 3) 用于日志流数据集和登台数据集 (请参阅 z/OS MVS 设置综合系统中的 System Logger 的 VSAM 共享选项 )。
  • 规划记录器辅助存储器的 DASD 空间和 SMS 环境。

    系统记录器辅助存储器包括所有日志流（卸载）数据集。 有关与辅助存储器相关的大小参数和其他属性的信息，请参阅 管理辅助存储器 。

  • 定义日志流和日志流模型。
    在 LOGR 策略中定义特定日志流，以及用于动态创建日志流的日志流模型。 确保完成以下步骤：
    • 将 HIGHOFFLOAD 设置为不高于 80% ，以便可以在结构达到 90% 级别之前激活卸载函数，并提供缓冲区，以便 CICS 可以在卸载完成之前继续写入记录而不填充日志流。
    • 将 DFHLOG 和 DFHSHUNT 的 LOWOFFLOAD 设置在范围 40% 到 60% 之内。 对于用户日志和日志的日志，将 LOWOFFLOAD 指定为 0。
    • 针对卸载数据集的高级限定符指定 HLQ。 它不是 CICS 日志流名称的一部分。 缺省值是 IXGLOGR。
    • 为耦合设施中的日志流指定 STG_DUPLEX(YES) 和 DUPLEXMODE(COND)， 以确保如果耦合设施是易变的或者是与故障相关的，会自动使用登台数据集。
    • 设置 STG_SIZE 来控制系统记录器分配的登台数据集的大小（以 4KB 的块为单位）。 对于耦合设施日志流，登台数据集保留的数据必须至少与结构中的日志流一样多， 这样卸载就不会由登台数据集触发。 请参阅 调整耦合设施日志流的大小 和 调整仅 DASD 日志流的大小。
    • 指定 LS_DATACLAS 和 LS_SIZE，分别表示日志流卸载数据集的 SMS 数据类和 4KB 分配块的数量。 请参阅 管理辅助存储器。
    • 指定 MODEL(YES) 来表示日志流定义只是一个模型，而不是实际的日志流。 请参阅 SDFHINST 成员 DFHILG2（耦合设施）和 DFHILG5（仅 DASD），获取模型日志流的样本。

    将 AUTODELETE (YES) 与合适的保留期 (RETPD) 用于常规日志，但 不 用于 CICS 系统日志 (DFHLOG 和 DFHSHUNT)。 有关更新 LOGR 策略的常规信息，请参阅 定义耦合设施日志流 以获取某些样本 IXCMIAPU 作业和 z/OS MVS Setting Up a Sysplex 。

  • 定义 JOURNALMODEL 资源定义。

    在 CICS CSD 中定义 JOURNALMODEL 资源定义，以允许 CICS 将 CICS 日志名称映射到 MVS 系统记录器日志流名称。 请参阅 JOURNALMODEL 资源。

    MVS 系统记录器日志流名称必须与 JOURNALMODEL 资源定义中使用的流名称匹配，否则在 CICS 区域启动时可能会出现以下错误消息:
    • IXG231I IXGCONN REQUEST = CONNECT TO LOG STREAM stream_name 未成功
    • DFHLG0508 未向 MVS 定义日志流 stream_name
    • DFHLG0731 打开系统日志 (DFHLOG）时出错。
  • 复查 AKPFREQ 系统初始化参数。

    此参数表示 CICS 日志管理器在获取活动关键点之前对日志流缓冲区执行的写操作数 (日志记录) ，而在旧日志控制程序下，它指定写入系统日志数据集的连续块数。

    该参数对系统记录器主（临时）存储器的大小有重大影响， 从而影响了在处理活动关键点 (AKP) 期间发生的日志尾部管理。 系统记录器操作如下：
    • 它将删除 CICS 不再关注的记录
    • 针对那些将日志记录写到最后一个 ACP 中的任务，将记录移到 DFHSHUNT。
  • 评估实施后的结果。
    在实现将 MVS 系统记录器用于 CICS 日志流和日志的过程之后，请持续评估结果。 可以使用以下方式：
    • CICS 时间间隔统计信息。 您可以按指定的时间间隔和每天结束时间收集这些数据，以获取 CICS 日志管理器统计信息。 还可以使用 DFH0STAT 样本程序收集统计信息。
    • SMF 类型 88 记录。 这些是由 MVS 系统记录器生成的，可以使用 SYS1.SAMPLIB中提供的 IXGRPT1进行打印。 还可以使用 IXGRPT1J 和 IXGRPT1L 来打印这些记录。