HPEL 文本日志配置设置

允许将记录和跟踪记录写至文本日志文件。

指定记录系统除了以二进制格式写入记录和跟踪记录以外，还以文本格式写入这些记录。可以将文本日志配置为以基本方式 SystemOut.log 文件使用的任一格式进行格式化。

文本日志文件仅包含由控制器进程生成的日志条目，不包含来自服务方或助手进程的日志条目。因此，应用程序日志记录不会写入 z/OS 上的文本日志。要查看所有应用程序服务器进程的日志或跟踪数据，请使用管理控制台中的 LogViewer 命令行工具或 HPEL 日志查看工具。

避免故障： 所有写至文本日志的内容也都会写至日志存储库或跟踪存储库。启用文本日志会降低频繁创建日志或跟踪条目的应用程序的性能。gotcha

指定日志文件将写至的目录。

文本日志文件名称具有以下格式：TextLog_<yy.mm.dd>_<hh.mm.ss>，其中“TextLog_”是固定的前缀，<yy.mm.dd> 是文件中第一条记录的日期（年月日），<hh.mm.ss> 是时间（时分秒）

避免故障： 服务器之间无法共享此路径。服务器将创建一个扩展名为 .owner 的文件，用来帮助检测是否有两个或两个以上的服务器试图对 HPEL 输出使用同一路径。gotcha

指定记录系统避免在每次创建日志记录时都写至磁盘。记录系统创建一个可以保存许多日志记录的缓冲区，并在该缓冲区已满时写入已缓冲的事件。几秒后记录系统还会写入缓存事件，即使缓冲区未满。

选择此设置将显著提高记录性能，然而，如果服务器意外停止，那么可能不会将内容写至文本日志文件。

最佳实践： 在几乎所有情况下都应该启用日志记录缓冲。仅当服务器发生意外故障并且在停止之前无法将已缓冲的内容写至磁盘时，才应该禁用日志记录缓冲。bprac

启用记录框架以关闭日志文件并在指定的时间启动新文件。关闭这些文件会使得容易将其复制到归档中。

最佳实践： 如果要自动将日志文件进行归档，请将备份程序设置为在您配置的新日志启动时间之后复制文件。请将备份过程配置为比配置的新日志启动时间至少晚 10 分钟进行，以确保服务器已关闭先前的文件。bprac

指定要用于从文本日志目录中自动清除最旧的日志记录或配置的空间中不再适合的日志记录的日志清除设置。

选择当日志大小接近最大值时以将日志文件自动清除过程配置为在文本日志文件的总大小接近配置的最大大小时开始。

选择当最旧的记录达到时限时以将日志文件自动清除过程配置为在日志内容达到指定的时限时开始。

选择当达到时限或大小限制时以将日志文件自动清除过程配置为在满足上述任一条件时开始。

无论选择了哪个选项，都将按写入文本日志文件的顺序从文本日志目录中删除文本日志文件。

指定服务器在无法将内容添加到文本日志目录时如何反应。

选择停止服务器以指定在服务器无法写至文本日志目录时停止服务器。

选择清除旧记录以指定服务器继续运行，并且在服务器无法写至文本日志目录时，将立即除去包含最旧的日志记录的文件。

选择停止日志记录以指定服务器继续运行，但服务器在无法写至文本日志目录时不能继续写至日志。

指定在文本日志文件中要使用的格式。

选择基本以指定一种较短的格式，每个记录各占一行。

选择高级以指定一种较长的格式，以指定一种使用完整记录器名称的较长格式和有关每个记录的更多详细信息。

指定文本日志文件中除了日志记录外是否还包含跟踪记录。

指定对正在运行的服务器的动态状态和服务器配置都进行了更改，这些更改在下次重新启动时生效。如果未选中此复选框，那么服务器不会将这些设置复制到服务器配置中。