IBM E027SLL-H - Tivoli Monitoring - PC Troubleshooting Manual page 62

component_type
ENTRY
entry_point
UNIT Indicates that the trace is to look for a match between the compilation unit
unit_name
class
Setting the trace option for the portal client trace
A log file is created automatically the first time you start the Tivoli Enterprise
Portal, and is named install_dir\cnp\logs\kcjras1.log. This log file contains all
of the RAS1 tracing for the portal client. Whenever you start a new work session,
the log file is purged and rewritten for the current work session. If you want to
preserve the log file from the last work session, you must rename it or copy it to
another directory before starting the portal client again. The kcj.log file contains
errors generated by the Java
Procedure
1. Always backup the files before altering them.
2. From the Tivoli Enterprise Portal menu, select File > Trace Options.
3. Select a trace class from the list or as instructed by IBM Software Support (such
4. Click OK to close the window and turn on logging.
Setting the trace option for the portal server trace
Set the trace options for the Tivoli Enterprise Portal Server through Manage Tivoli
Enterprise Monitoring Services.
44
IBM Tivoli Monitoring: Troubleshooting Guide
used to trace groups of routines related by function (or component). Use
this keyword only at the explicit request of an IBM Software Support
representative.
Identifies a component type. An IBM Software Support representative can
tell you what value to specify.
Narrows a filtering routine to specify a specific ENTRY POINT. Since
multiple entry points for a single routine are rare, use this keyword only at
the explicit request of an IBM Software Support representative.
Represents the name of the entry point. An IBM Software Support
representative can tell you what value to specify.
dispatched and the fully or partially qualified compilation unit specified on
the RAS1 statement. A match results in a trace entry.
Represents the name of the compilation unit. In most instances, this name
defines the component that is being traced. The value is likely to be the
three-character component identifier for the monitoring agent (KHL for
®
OMEGAMON z/OS Management Console).
One of the same values specified for global_class but, because of its
position inside the parentheses, narrowed in scope to apply only to the
unit_name specified.
as UNIT:Workspace ALL):
v ALL provides data for all classes. Use the setting temporarily, because it
generates large amounts of data.
v ERROR logs internal error conditions. This setting provides the minimum
level of tracing, with little resource overhead, and ensures that program
failures will be caught and detailed.
v NONE turns off the error log so no data is collected.
™
libraries used in the portal client.