(ZOS) Set up component trace (CTRACE)

WebSphere Application Server for z/OS uses z/OS component trace (CTRACE) facilities to manage the collection and storage of trace data. CTRACE data is written to address space buffers in private (pageable) storage, which can be formatted using IPCS if a dump of the address space is taken. CTRACE data can also be written to trace data sets on disk or tape using an external writer.

Although CTRACE data is primarily output for use by IBM service personnel, using CTRACE capabilities at the installation allows us to have additional trace data available when a problem first occurs. Because CTRACE efficiently uses system resources, we can collect valuable trace data with minimal impact on performance. For detailed information about the CTRACE facilities, see z/OS MVS™ Diagnosis: Tools and Service Aids, GA22-7589.

If we choose to write CTRACE data to trace data sets, create an external writer. We can set up separate trace data sets for each cell or for each WAS for z/OS release, or we can use a single trace data set for all WAS activity on a particular z/OS system.

Tasks

To implement a CTRACE data trace, read the following articles on preparing and starting CTRACE in the application server:

• Prepare CTRACE controls and resources
• Starting CTRACE as part of WAS for z/OS initialization
• Starting CTRACE while WAS for z/OS servers are active
• CTRACE to collect trace data for Java server applications

After you read articles we will be able to implement CTRACE data tracing in the applications.

Subtopics

• Prepare CTRACE controls and resources
  We must prepare CTRACE controls and resources before we can use it for trace data.

• Starting CTRACE as part of WAS for z/OS initialization
  We can start CTRACE as part of the initialization process for a WAS for a z/OS cell using this information.

• Starting CTRACE while WAS for z/OS servers are active
  Start CTRACE when a WAS for z/OS server already is active.

• CTRACE to collect trace data for Java server applications
  Applications that run in WAS for z/OS can use JRas to provide tracing support that is consistent with WebSphere tracing.

Trace control settings

ICPS CTRACE command