独立客户机的跟踪用户界面

要启用跟踪,请使用长格式或短格式系统属性。

注: 本主题引用一个或多个应用程序服务器日志文件。 作为建议的替代方法,您可以将服务器配置为使用高性能可扩展日志记录 (HPEL) 日志和跟踪基础结构,而不是在分布式系统和 IBM® i 系统上使用 SystemOut.logSystemErr.logtrace.logactivity.log 文件。 您还可以将 HPEL 与本机 z/OS® 日志记录工具结合使用。 如果您正在使用 HPEL,那么可以从服务器概要文件 bin 目录使用 LogViewer 命令行工具来访问所有日志和跟踪信息。 有关使用 HPEL 的更多信息,请参阅 有关使用 HPEL 对应用程序进行故障诊断的信息。

长格式系统属性

长格式系统属性优先于短格式,并使用 WebSphere® Application Server独有的系统属性。

表 1. 长格式系统属性 下表包含长格式系统属性的列表以及对属性的描述。
属性 描述
com.ibm.ejs.ras.lite.traceSpecification 跟踪规范字符串
com.ibm.ejs.ras.lite.traceFileName The trace destination (<文件>, stdout, stderr, java,util.logging)
com.ibm.ejs.ras.lite.maxFileSize 最大跟踪文件大小,以 MB 计(如果跟踪目标是文件)
com.ibm.ejs.ras.lite.maxFiles 保留的跟踪文件的最大数目(如果跟踪目标是文件)
com.ibm.ejs.ras.lite.traceFormat 跟踪输出格式,可以是基本格式或高级格式(缺省值为基本格式)

长格式示例:

-Dcom.ibm.ejs.ras.lite.traceSpecification=SIB*=all
-Dcom.ibm.ejs.ras.lite.traceFileName=c:/trace.log
-Dcom.ibm.ejs.ras.lite.maxFileSize=20
-Dcom.ibm.ejs.ras.lite.maxFiles=8

短格式系统属性

短格式使用与现有 WebSphere Application Server 客户机兼容的系统属性,但由于此属性未限定,因此可能与在同一 Java™ 运行时环境 (JRE) 中运行的其他第三方技术发生冲突。

短格式系统属性为:

traceSettingsFile
此属性必须指定可包含下列属性的可装入属性文件:
表 2. 可装入系统属性文件中的属性。 下表包括可装入系统属性的列表以及对属性的描述。
属性 描述
traceFileName 跟踪目标(file、stdout、stderr 和 java,util.logging)
maxFilesSize 最大跟踪文件大小,以 MB 计(如果跟踪目标是文件)
maxFiles 保留的跟踪文件的最大数目(如果跟踪目标是文件)
<traceSpec> 跟踪规范
traceFormat 跟踪输出格式,可以是基本格式或高级格式(缺省值为基本格式)

以下示例显示如何使用短格式系统属性:

SIBTrm=all:SIBMfp=all
traceFileName=c:/trace.log

跟踪文件名称值的特殊含义

某些跟踪文件名称值具有特殊含义:
  • stdout - 导致跟踪记录写至 stdout
  • stderr - 导致跟踪记录写至 stderr
  • java.util.logging - 导致跟踪记录写至 java.util.logging

使用任何其他名称会导致跟踪记录写至该名称的文件。