(ZOS) Trace control settings
The following trace options allow us to capture the information needed to detect problems.
To view or set these options, use the WebSphere Application Server administrative console:
- Select Environment > WebSphere variables.
- Specify the variable name in the name field and specify the setting in the value field. We can also describe the setting in the description field on this tab.
- ras_trace_outputLocation=SYSPRINT | BUFFER | TRCFILE
- Specifies where we want trace records to be sent:
- To SYSPRINT
- To a memory buffer (BUFFER), the contents of which are later written to a CTRACE data set
- To a trace data set (TRCFILE) specified on the TRCFILE DD statement in the start procedure for the server.
Setting ras_trace_outputlocation to TRCFILE requires that we manually modify the start procedure for the new WAS to include a TRCFILE DD statement. This manual modification must be performed before the new WAS and associated daemons are started.
For servers, we can specify one or more values, separated by a space. For clients, we can only specify SYSPRINT.
Defaults:
- For clients, SYSPRINT
- For all other processes, BUFFER
Example: ras_trace_outputLocation=SYSPRINT BUFFER
- ras_time_local=0 | 1
- Specifies whether timestamps in trace records use Greenwich Mean Time (GMT) or local time. This variable setting controls timestamp format in the error log, and in traces sent to SYSPRINT or TRCFILE DD.
Default: 0 (GMT)
Example: ras_time_local=1 sets timestamps to local time.
- DAEMON_ras_trace_ctraceParms=SUFFIX | MEMBER_NAME
- Identifies the CTRACE PARMLIB member. The value can be either:
- A two-character suffix, which is added to the string CTIBBO to form the name of the PARMLIB member, or
- The fully specified name of the PARMLIB member. A fully specified name must conform to the naming requirements for a CTRACE PARMLIB member.
If the specified PARMLIB member is not found, tracing is defined to CTRACE, but there is no connection to a CTRACE external writer.
The Daemon is the only server that recognizes this environment variable.
Default: None
Example: DAEMON_ras_trace_ctraceParms=01 identifies PARMLIB member CTIBBO01
- ras_trace_BufferCount= n
- Number of trace buffers to allocate. Valid values are 4 through 8.
Default: 4
Example: ras_trace_BufferCount=6
- ras_trace_BufferSize= n
- Size of a single trace buffer in bytes. We can use the letters K (for kilobytes) or M (for megabytes). Valid values are 128K through 4M.
Default: 1M
Example: ras_trace_BufferSize=2M
- ras_trace_log_version= n
- Version of trace log to display. Valid values are 1 and 2.
Default: 2
Example: ras_trace_log_version=1
Add logging and tracing to the application Dump control settings