Commands Reference, Volume 2

haemd_HACMP Command

Purpose

Start-up program for the Event Manager daemon.

Syntax

haemd_HACMP [ -d trace_arg ]

Description

The haemd_HACMP program is the start-up program for the haemd daemon. When the Event Management subsystem is configured in the System Resource Controller (SRC) by the emsvcsctrl command, haemd_HACMP is specified as the program to be started.

This program can only be invoked by the SRC. To start the Event Management subsystem use the emsvcsctrl command.

The -d flag should only be used under the direction of the IBM Support Center. The possible trace arguments are the same as for the haemtrcon command, except for regs and dinsts. To use this flag the emsvcs subsystem definition in the SRC must be changed using the chssys command with the -a argument. Then the daemon must be stopped and then restarted.

Flags

-a: Adds the subsystem.
-s: Starts the subsystem.
-k: Stops the subsystem.
-d: Deletes the subsystem.
-c: Cleans the subsystems, that is, deletes them from all system partitions.
-u: Unconfigures the subsystems from all system partitions.
-t: Turns tracing on for the subsystem.
-o: Turns tracing off for the subsystem.
-r: Refreshes the subsystem.
-h: Displays usage information.

Parameters

None.

Security

You must have root privilege and write access to the SDR to run this command.

Exit Status

0: Indicates the successful completion of the command.
1: Indicates that an error occurred.

Restrictions

This command is valid in an HACMP environment only.

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 add the Event Management subsystem to the SRC in the current system partition, set the SP_NAME environment variable to the appropriate system partition name and enter:
```
haemctrl -a
```
To start the Event Management subsystem in the current system partition, set the SP_NAME environment variable to the appropriate system partition name and enter:
```
haemctrl -s
```
To stop the Event Management subsystem in the current system partition, set the SP_NAME environment variable to the appropriate system partition name and enter:
```
haemctrl -k
```
To delete the Event Management subsystem from the SRC in the current system partition, set the SP_NAME environment variable to the appropriate system partition name and enter:
```
haemctrl -d
```
To clean up the Event Management subsystem on all system partitions, enter:
```
haemctrl -c
```
To unconfigure the Event Management subsystem from all system partitions, on the control workstation, enter:
```
haemctrl -u
```
To turn tracing on for the Event Management daemon in the current system partition, set the SP_NAME environment variable to the appropriate system partition name and enter:
```
haemctrl -t
```
To turn tracing off for the Event Management daemon in the current system partition, set the SP_NAME environment variable to the appropriate system partition name and enter:
```
haemctrl -o
```

Location

/usr/sbin/rsct/bin/haemd_HACMP: Location of the haemd_HACMP program

Files

/var/ha/log/em.default.cluster_name: Contains the default log of the haemd daemon on the cluster named cluster_name.
/var/ha/log/em.cp: Contains a log of any errors that occurred while copying the Event Management Configuration Database.
/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.mkgroup: Contains a log of any errors that occurred while creating the haemrm group.
/var/ha/log/em.mkdir: Contains a log of any errors that occurred while creating the /var/ha/lck/haem and /var/ha/soc/haem directories.

Related Information

emsvcsctrl, haemd, haemtrcon