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