Commands Reference, Volume 2

haemd_SP Command

Purpose

Start-up program for the Event Manager daemon.

Syntax

haemd_SP [-T group_name] [ -d trace_arg] ... [syspar_IPaddr ]

Description

The haemd_SP 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 haemctrl command, haemd_SP is specified as the program to be started. The syspar_IPaddr argument is configured if necessary.

This program can only be invoked by the SRC. To start the Event Management subsystem use the haemctrl 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 haem subsystem definition (haem.syspar_name on the control workstation) in the SRC must be changed using the chssys command with the -a argument. Then the daemon must be stopped and then restarted.

The -T flag can be used when testing a new resource monitor. Refer to "Coding and testing the Resource Monitor, Alternative Testing Method in Chapter 1 of the RSCT Event Management Programming Guide and Reference.

Flags

-T group_name: Indicates that the Event Manager daemon is to execute in test mode. The daemon joins a peer group using the group name specified by group_name and uses a local copy of the CDB.
-d trace_arg: Enables tracing for the daemon activity specified by trace_arg. This flag may be specified multiple times.

Parameters

syspar_IPaddr: Specifies the IP address of the system partition in which the haemd daemon is to execute. If the daemon is executing on the control workstation, this argument must be specified. Otherwise, the argument is ignored, if present.

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 a PSSP 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_SP

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

Commands: haemctrl, haemd, haemtrcon

RSCT Event Management Programming Guide and Reference