haemtrcoff Command

Purpose

Turns tracing off for the Event Manager daemon.

Syntax

haemtrcoff -s subsys_name -a trace_list

Description

The haemtrcoff command is used to turn tracing off for specified activities of the Event Manager daemon. Trace output is placed in an Event Management trace log for the system partition.

Flags

-s subsys_name
Specifies the name of the Event Management subsystem. On a node this is emsvcs. This argument must be specified.
-a trace_list
Specifies a list of trace arguments. Each argument specifies the type of activity for which tracing is to be turned off. At least one argument must be specified. If more than one argument is specified, the arguments must be separated by commas. The list may not include blanks.

Parameters

The following trace arguments can be specified:
init
Stops tracing the initialization of the Event Manager daemon.
config
Stops dumping information from the configuration file.
insts
Stops tracing resource variable instances that are handled by the daemon.
rmctrl
Stops tracing Resource Monitor control.
cci
Stops tracing the client communication (internal) interface.
emp
Stops tracing the event manager protocol.
obsv
Stops tracing resource variable observations.
evgn
Stops tracing event generation and notification.
reg
Stops tracing event registration and unregistration.
pci
Stops tracing the peer communication (internal) interface.
msgs
Stops tracing all messages that come to and are issued from the daemon.
query
Stops tracing queries that are handled by the daemon.
gsi
Stops tracing the Group Services (internal) interface.
eval
Stops tracing expression evaluation.
rdi
Stops tracing the reliable daemon (internal) interface.
sched
Stops tracing the internal scheduler.
shm
Stops tracing shared memory management activity.
all
Stops tracing all activities.
all_but_msgs
Stops tracing all activities except for messages. Message activity is defined by the msgs argument.

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

  1. To turn off all tracing for the Event Management subsystem on one of the cluster nodes, log in to the node and enter:
    haemtrcoff -s emsvcs -a all
  2. To turn off all tracing of initialization and configuration for the Event Management subsystem on a cluster node, log in to the node and enter:
    haemtrcoff -s emsvcs -a init,config

Location

/usr/sbin/rsct/bin/haemtrcoff
Location of the haemtrcoff 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

Implementation Specifics

This command is part of the Reliable Scalable Cluster Technology (RSCT) fileset.