Purpose
Turns tracing on for the event
manager daemon.
Syntax
haemtrcon -s subsys_name -a trace_list
Description
The haemtrcon command is used to turn tracing on for specified activities
of the event manager daemon. Trace output is placed in an event management
trace log for the system partition. When used, the regs, dinsts, iolists, and olists parameters perform
a one-time trace. The specified information is placed in the trace
log, but no further tracing is done.
Flags
- -s cluster_name
- Specifies the name of the event management subsystem. On a node, cluster_name is emsvcs. This flag and parameter must be specified.
- -a trace_list
- Specifies a list of trace parameters. Each parameter specifies
the type of activity for which tracing is to be turned on. At least
one parameter must be specified. If more than one parameter is specified,
the parameters must be separated by commas. The list may not include
blanks.
Parameters
The following trace parameters
can be specified:
- init
- Traces the initialization of the event manager daemon.
- config
- Dumps information from the configuration file.
- insts
- Traces resource variable instances that are handled by the daemon.
- rmctrl
- Traces resource monitor control.
- cci
- Traces the client communication (internal) interface.
- emp
- Traces the event manager protocol.
- obsv
- Traces resource variable observations.
- evgn
- Traces event generation and notification.
- reg
- Traces event registration and unregistration.
- pci
- Traces the peer communication (internal) interface.
- msgs
- Traces all messages that come to and are issued from the daemon.
- query
- Traces queries that are handled by the daemon.
- gsi
- Traces the group services (internal) interface.
- eval
- Traces expression evaluation.
- rdi
- Traces the reliable daemon (internal) interface.
- sched
- Traces the internal scheduler.
- shm
- Traces shared memory management activity.
- all
- Traces all activities.
- all_but_msgs
- Stops tracing all activities except for messages. Message activity
is defined by the msgs argument.
- regs
- Traces currently registered events.
- dinsts
- Traces all resource variable instances known to the daemon.
- iolists
- Traces immediate observation lists
- olists
- Traces observation lists
Restrictions
Do not use this command during
normal operation. Use this command only under the direction of the IBM® Support Center. It
provides information for debugging purposes and may degrade the performance
of the event management subsystem or anything else that is running
in the system partition.
Implementation Specifics
This command is
part of the Reliable Scalable Cluster Technology (RSCT) fileset.
Examples
- To turn on all tracing for the event management subsystem on one
of the cluster nodes, log in to the node and enter:
haemtrcon -s emsvcs -a all
- To turn on all tracing of initialization and configuration for
the event management subsystem on a cluster node, log in to the node
and enter:
haemtrcon -s emsvcs -a init,config
Location
- /usr/sbin/rsct/bin/haemtrcon
- Location of the haemtrcon command