haemunlkrm Command

Purpose

Unlocks and starts a resource monitor.

Syntax

haemunlkrm -s subsys_name -a resmon_name

Description

If the event management daemon cannot successfully start a resource monitor after three attempts within a two-hour interval, or if the daemon has successfully connected to the instances of a resource monitor n times within a two-hour interval, the resource monitor is "locked" and no further attempts are made to start it or to connect to any of its instances. n is 3 in an HACMP/ES cluster. Once the cause of the failure is determined and the problem corrected, the haemunlkrm command can be used to unlock the resource monitor and attempt to start it or connect to the resource monitor instances.

The status of the event manager daemon, as displayed by the lssrc command, indicates whether a resource monitor is locked.

Flags

-s subsys_name
Specifies the name of the event management subsystem. On a node, subsys_name is emsvcs. This flag and parameter must be specified.
-a resmon_name
Specifies the name of the resource monitor to unlock and start.

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

  1. This example applies to unlocking a resource monitor on a node.
    If the output of the lssrc command indicates that the program resource monitor IBM.PSSP.harmpd is locked, correct the condition that prevented the resource monitor from being started and enter:
    haemunlkrm -s emsvcs -a IBM.PSSP.harmpd

Location

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