[ Bottom of Page | Previous Page | Next Page | Contents | Index | Library Home |
Legal |
Search ]
Commands Reference, Volume 2
haemtrcon Command
Purpose
Turns tracing on for the event manager daemon.
Syntax
haemtrcoff -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
Security
You must have root privilege and write access to the SDR to run this command.
You should be running on the control workstation. Before running this command,
you must set the SP_NAME environment variable to the appropriate system partition
name.
Exit Status
- 0
- Indicates the successful completion of the command.
- 1
- Indicates that an error occurred. It is accompanied by one or more error
messages that indicate the cause of the error.
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.
Standard Output
When the command executes successfully, it writes the following informational
messages:
Reading Event Management data for partition syspar_name
CDB=new_EMCDB_file_name Version=EMCDB_version_string
Standard Error
This command writes error messages (as necessary) to standard error.
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
Files
- /var/ha/log/em.trace.cluster_name
- Contains the trace log of the haemd daemon on the cluster named cluster_name.
- /var/ha/log/em.msgtrace.cluster_name
- Contains message trace output from the event manager daemon on the cluster
named cluster_name.
Related Information
Commands: haemtrcoff
Daemons: haemd
Scripts: emsvcsctrl
[ Top of Page | Previous Page | Next Page | Contents | Index | Library Home |
Legal |
Search ]