[z/OS]

准备 CTRACE 控件和资源

必须先准备好 CTRACE 控件和资源,然后才能将其用于跟踪数据。

开始之前

启动 WebSphere® Application Server for z/OS® 服务器的组件跟踪 (CTRACE) 活动前,需要确定 CTRACE 控件和资源的一些值,以及创建一个外部写程序(如果需要写程序来记录跟踪数据)。

关于此任务

完成以下步骤以准备 CTRACE 控件和资源:

过程

  1. 决定是将 CTRACE 数据写到跟踪数据集(推荐)还是仅在内存缓冲区中保持 CTRACE 数据。
  2. 如果希望使用跟踪数据集,请完成这些步骤。
    1. 决定是为单一 z/OS 系统上所有的 WebSphere Application Server 活动创建一个跟踪数据集,还是为每个单元或 WebSphere Application Server 发行版创建独立的跟踪数据集。

      跟踪数据集不能在 z/OS 系统间共享;每个系统都应该有它自己的跟踪数据集。

    2. 为跟踪数据集选择名称。

      要简化外部写程序设置,请将 z/OS 系统名包含在数据集名称中。

      建议:对于所有 WebSphere Application Server 活动的单一跟踪数据集,请使用类似于 SYS1.sysname.WAS390.CTRACE 的名称。

    3. 在每一个 z/OS 系统上分配跟踪数据集。
      最佳实践 最佳实践:

      请勿指定 DCB 参数 RECFM、LRECL 或 BLKSIZE;外部写程序将使用记录格式 VB 以及系统优化的块大小和逻辑记录长度来分配这些参数。对于磁盘上的跟踪数据集,必须至少使用 10 个柱面 (3390)。次要扩展数据块会忽略,除非在启动了外部写程序时指定了 NOWRAP 选项。例如:

      bprac
      //	EXEC PGM=IEFBR14
      //TRACE DD DSN=SYS1.MVSS14.WAS390.CTRACE,UNIT=3390,VOL=SER=HPK19A,
      //   SPACE=(CYL,(20,0)),DISP=(NEW,CATLG),DCB=DSORG=PS 
    4. 为外部写程序选择作业名。

      建议:如果要对每个 z/OS 系统上的所有 WebSphere Application Server 活动使用同一跟踪数据集,请使用 BBOWTR。

    5. 创建外部写程序编目过程。
      1. 将成员 BBOWTR 从 WebSphere Application Server for z/OS 产品目录 /util/zos/JCL/ 复制到 SYS1.PROCLIB 或另一个对主调度程序定义的过程库。
      2. 将该过程重命名为您选择的外部写程序作业名。
      3. 通过在指示的地方提供您的跟踪数据集名称来定制该编目过程。
      4. 如果该编目过程在几个 z/OS 系统间共享,请确保跟踪数据集 DD 语句指向每个系统上的相应跟踪数据集。
    6. 为外部写程序选择运行时使用的系统用户标识。
      此用户标识必须对跟踪数据集具有读/写访问权;您可能希望使用现有的已启动任务用户标识,例如系统的缺省已启动任务用户标识。使用下面的 RACF® 命令或等价命令来使外部写程序编目的过程在已启动任务用户标识下运行:
      RDEFINE STARTED external_writer_procname.* STDATA(USER(system_user_ID)) TRACE(YES)
      此外部写程序已启动任务在运行时至少应该与用于跟踪的 WebSphere Application Server 地址空间具有一样高的分派优先级。
    7. 启动外部写程序以验证先前步骤是否正确完成。
      输入下列 MVS™ 控制台命令:
      TRACE CT,WTRSTART=external_writer_procname
  3. 创建一个 CTRACE parmlib 成员。
    1. 将成员 BBOCTI00 从 WebSphere Application Server for z/OS 产品目录 /util/zos/JCL/ 复制到系统 parmlib 并置中的数据集。
    2. 将该 parmlib 成员重命名为 CTIBBOxx,其中 xx 是一个与外部写程序关联的两字符后缀。

      此值在 WebSphere Application Server for z/OS 定制期间指定。

    3. 定制 CTIBBOxx parmlib 成员,以指示是否要使用跟踪数据集和外部写程序。如果使用,那么当 WebSphere Application Server 激活 CTRACE 时外部写程序是否自动启动。
  4. 如果计划对不同的 WebSphere Application Server 单元或发行版使用独立的跟踪数据集,那么除为每个单元或发行版选择新的外部写程序名称和 parmlib 成员后缀以外,请重复所有这些步骤。

结果

WebSphere Application Server 的 CTRACE 现在设置好了。使用 parmlib 成员后缀来将特定的 WebSphere Application Server for z/OS 单元与所选的 CTRACE 选项相关联。

指示主题类型的图标 任务主题



时间戳记图标 最近一次更新时间: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=ttrb_prepCTRACEcontrols
文件名:ttrb_prepCTRACEcontrols.html