IBM E027SLL-H - Tivoli Monitoring - PC, Troubleshooting Manual

Page: 62 / 310

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.
component_type
Identifies a component type. An IBM Software Support representative can
tell you what value to specify.
ENTRY
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.
entry_point
Represents the name of the entry point. An IBM Software Support
representative can tell you what value to specify.
UNIT Indicates that the trace is to look for a match between the compilation unit
dispatched and the fully or partially qualified compilation unit specified on
the RAS1 statement. A match results in a trace entry.
unit_name
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).
class 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.
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
™
libraries used in the portal client.
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
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.
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