[Next] [Previous] [Index] [Top]

Notice

CHAPTER 1 - Introducing RootCause

What Is RootCause?

Java, C++, or Both?

About This Guide

CHAPTER 2 - Installing RootCause

Getting Help

On-line Documentation

System Requirements

Licensing

CHAPTER 3 - Terminology and Concepts

The RootCause Product

The RootCause Registry

The RootCause Log

Aprobe Product

RootCause Data Management

RootCause Overhead Management

Glossary

CHAPTER 4 - Getting Started

Setting Up

The RootCause Process

CHAPTER 5 - RootCause Demo

Set Up

Open the RootCause GUI

Run With RootCause

View the RootCause Log

Open a RootCause Workspace

Define the Trace

Trace With RootCause

View The Data Index

Examine and Revise the Trace

Tracing The Details

Where To From Here?

CHAPTER 6 - Deploying the RootCause Workspace

Installing The RootCause Agent

Building a "Traceable" Application

Deploying A RootCause Workspace

Registering a Deployed Workspace

Collecting Data At The Remote Site

Formatting and Viewing the Remotely-Collected Data

CHAPTER 7 - RootCause Files and Environment Variables

Workspace

UAL File

XMJ File

Data (APD) File

Process Data Set

Deploy File

Collect File

Decollection

RootCause Registry

RootCause Log

.rootcause Directory

rootcause.properties

Environment Variables

CHAPTER 8 - RootCause GUI Reference

Workspace Browser

New Workspace Dialog

Reset Program Dialog

Add UAL Dialog

RootCause Options Dialog

Edit Source Path Dialog

Edit Class Path Dialog

Java Path Dialog

UAL Options Dialog

Java Exceptions Configuration Dialog

Run Program Dialog

Deploy Dialog

Decollect Data Dialog

Trace Setup Dialog

Find In Program Contents Dialog

Global Trace Options Dialog

Edit Wildcard Strings Dialog

Generate Custom XMJ Dialog

New Class Dialog

Trace Data Dialog

Add Process Data Dialog

Trace Index Dialog

Select Data Files Dialog

Select Events Dialog

Find Text In Events Dialog

Trace Display

Find Text in Trace Events Dialog

Table Dialog

Platform-Specific GUI Issues

CHAPTER 9 - RootCause Command Reference

rootcause

rootcause build

rootcause collect

rootcause config

rootcause decollect

rootcause deploy

rootcause format

rootcause log

rootcause merge

rootcause new

rootcause off

rootcause on

rootcause open

rootcause register

rootcause run

rootcause xrun

rootcause status

CHAPTER 10 - Selected Topics

RootCause and Efficiency Concerns

Logging Controls

Multiple Application Tracing

Multiple Executions of a Single Application

Libraries with No Debug Information

Your Application and Different JREs

Using RootCause on an Application with an Embedded JVM

Tracing Java and C++ In One Program

RootCause J2EE Support

RootCause Shipped as Part of Your Application

Tracing System Services

RootCause and Perfmon

CHAPTER 11 - Custom Java Probes

A Simple Example

Applying One Probe to Many Methods

Using Method IDs

Logging Data from Java

The onLine() Method

Advanced Custom Java

Index