管理操作员消息传递

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

可以将许多具有 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® V 1.13开始，您可以使用 JES2 DD 关键字通过定期向输出流写入换页字符来对输出进行分段。
如果您正在 z/OS V 1.12 或更低版本上运行，并且正在使用 JES2，那么如果要使用定期向输出流写入换页字符来对输出进行分段，那么可以将 SEGMENT = 参数添加到 SYSPRINT 和 SYSOUT DD 卡。根据 ras_stderr_ff_interval、ras_stdout_ff_interval、ras_stderr_ff_line_interval 和 ras_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

要使用这些消息传递变量，必须执行两项操作：

使用 "环境-> 管理 WebSphere® 变量" 下的 "管理控制台" 将这些参数添加到服务器定义中:
- ras_default_msg_dd =DEFALTDD
- ras_hardcopy_msg_dd =HRDCPYDD
可以为各个控制和服务方流程设置这些变量，但更简单的是在整个单元的环境变量中设置它们。对于守护程序，您必须给它们加上前缀“DAEMON_”，并在单元级别设置它们：
- DAEMON_ras_default_msg_dd =DEFALTDD
- DAEMON_ras_hardcopy_msg_dd =HRDCPYDD
更新 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
```
此外，您可以使用 JES2 SPIN 参数按行或时间间隔旋转数据。以下示例代码每 5000 行传输一次数据:
```
SPIN=(UNALLOC,5K)
```
以下示例代码以 20 分钟的时间间隔传输数据:
```
 SPIN=(UNALLOC,'+00:20')
```
有关 SPIN 参数的更多信息，请参阅 z/OS 文档中的 SPIN 参数。

注：

如果指定了新的环境变量，但在该过程中没有指定 DD 卡，那么您不会收到指出缺少 DD 卡的错误消息，并且不会在任何地方写跟踪输出。
如果尝试将多个流的输出导向同一 DD，例如将 ras_default_msg_dd 和 ras_hardcopy_msg_dd 都设置为 DEFALTDD（或 SYSPRINT），那么分配将失败，并且输出将被发送至缺省位置 (JOBLOG/SYSLOG)。

例如，这些 DD 文件用于分隔消息并使它们几乎全部脱离硬拷贝控制台 (SYSLOG):

JESMSGLG －一些启动和关闭消息
JESYSMSG - MVS 分配和取消分配信息
SYSOUT －一些启动和关闭消息
SYSPRINT －一些启动和关闭消息
HRDCPYDD －通常将转至 SYSLOG 的审计消息
DEFALTDD －通常将转至 SYSLOG 的参考消息