haemtrcon Command

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

  1. 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
  2. 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

/opt/rsct/bin/haemtrcon
Location of the haemtrcon command