[z/OS]

管理操作员消息传递

使用产品消息路由功能来控制服务器通信流。

可以将许多具有 BBO 前缀的错误消息传递至特定数据集而不是让它们转至 SYSLOG,后者会产 生大量流量。此操作是通过使用环境变量 ras_default_msg_dd 和 ras_hardcopy_msg_dd 并在 JCL 启动过 程中指定 DD 语句实现的。

以下更详细地说明了消息的路由方式。
  • 应用程序服务器在初始化期间发出的 WTO 消息被发送至硬拷贝,但大多数可路由至 ras_default_msg_dd 指定的数据集(请参阅日志输出目标和特征)。
  • Java™ 审计消息也被发送至硬拷贝,但可路由至 ras_hardcopy_msg_dd 指定的数据集。(请参阅日志输出目标和特征)。
  • 跟踪错误、服务和致命消息被发送至 ras_log_logstreamName 指定的错误日志。否则,它们转至 CERR (SYSOUT)。有些也可能转至硬拷贝。在 W500104 服务级别,ras_log_logstreamName 环境变量未设置 为 was.env 变量中的错误日志流名称。

    要设置此环境变量,请在管理控制台上单击环境 > WebSphere 变量,选择作用域,然后单击新建

  • 早期的错误消息转至 SYSOUT,直到产品连接到日志流。会发出 WTO (BBOO0153I),告诉您在连接到日志流前有多少消息转至 SYSOUT。
  • 从 z/OS® V1.13 开始,您可以使用 JES2 DD 关键字将输出进行分段,方法是:向输出流中定期写入换页符。

    如果在 z/OS V1.12 或更低版本上运行且使用 JES2,并且希望通过向输出流中定期写入换页符来对输出进行分段,那么可以将 SEGMENT= 参数添加到 SYSPRINT 和 SYSOUT DD 卡。根据 ras_stderr_ff_intervalras_stdout_ff_intervalras_stderr_ff_line_intervalras_stdout_ff_line_interval 环境变量的值,将换页符写入输出流。“z/OS 的应用程序服务器定制属性”主题中较详细地描述了这些变量。JES3 不支持 SEGMENT= 参数。

    要设置这些环境变量,请在管理控制台上单击环境 > WebSphere 变量,选择作用域,然后单击新建

  • 跟踪消息路由到 ras_trace_outputLocation。
  • System.out.println、System.err.println、STDOUT 和 cout 转至 SYSPRINT(请参阅将 SYSPRINT 和 SYSOUT 输出重定向至 HFS 文件主题获取更多信息。)
  • STDERR 和 cerr 转至 SYSOUT
要使用这些消息传递变量,必须执行两项操作:
  1. 使用管理控制台的“环境”->“管理 WebSphere® 变量”将以下参数添加至服务器定义:
    • ras_default_msg_dd =DEFALTDD
    • ras_hardcopy_msg_dd =HRDCPYDD
    可以为各个控制和服务方流程设置这些变量,但更简单的是在整个单元的环境变量中设置它们。 对于守护程序,您必须给它们加上前缀“DAEMON_”,并在单元级别设置它们:
    • DAEMON_ras_default_msg_dd =DEFALTDD
    • DAEMON_ras_hardcopy_msg_dd =HRDCPYDD
  2. 更新 PROCLIB 中的过程来添加以下新 DD 语句:
    //* Output DDs
    //CEEDUMP DD SYSOUT=*,SPIN=UNALLOC,FREE=CLOSE
    //SYSOUT DD SYSOUT=*,SPIN=UNALLOC,FREE=CLOSE 
    //SYSPRINT DD SYSOUT=*,SPIN=UNALLOC,FREE=CLOSE 
    //DEFALTDD DD SYSOUT=*,SPIN=UNALLOC,FREE=CLOSE
    //HRDCPYDD DD SYSOUT=*,SPIN=UNALLOC,FREE=CLOSE
注:
  • 如果指定了新的环境变量,但在该过程中没有指定 DD 卡,那么您不会收到指出缺少 DD 卡的错误消息,并且不会在任何地方写跟踪输出。
  • 如果尝试将多个流的输出导向同一 DD,例如将 ras_default_msg_dd 和 ras_hardcopy_msg_dd 都设置为 DEFALTDD(或 SYSPRINT),那么分配将失败,并且输出将被发送至缺省位置 (JOBLOG/SYSLOG)。
例如,下列 DD 文件用于隔离消息,并使几乎所有的消息都远离硬拷贝控制台 (SYSLOG):
  1. JESMSGLG - 一些启动和关闭消息
  2. JESYSMSG - MVS™ 分配和释放消息
  3. SYSOUT - 一些启动和关闭消息
  4. SYSPRINT - 一些启动和关闭消息
  5. HRDCPYDD - 通常将转至 SYSLOG 的审计消息
  6. DEFALTDD - 通常将转至 SYSLOG 的参考消息

指示主题类型的图标 参考主题



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