Commands Reference, Volume 2

haemloadcfg Command

Purpose

Loads Event Management configuration data into the System Data Repository (SDR).

Syntax

haemloadcfg [-d] [-r] loadlist_file

Description

The haemloadcfg utility command loads Event Management configuration data into the SDR. Note that before you invoke haemloadcfg, you must ensure that the SP_NAME environment variable is set to the appropriate system partition name.

The configuration data is contained in a load list file, whose format is described by the man page for the haemloadlist file. For details on the SDR classes and attributes that you can use to specify Event Management configuration data, see RSCT Event Management Programming Guide and Reference.

To load the default Event Management configuration data for PSSP, specify the load list file as /usr/sbin/rsct/install/config/haemloadlist.

To add Event Management configuration data for other Resource Monitors, create a file in load list format and specify its name on the command.

Without any flags, the haemloadcfg command does not replace existing objects in the SDR. The data in the load list file is matched with the existing objects in the SDR based on key attributes, as follows:

SDR Class: Key Attributes
EM_Resource_Variable: rvName
EM_Resource_ID: riResource_name, riElement_name
EM_Structured_Byte_String: sbsVariable_name, sbsField_name
EM_Resource_Class: rcClass
EM_Resource_Monitor: rmName

Note that the way in which the haemloadcfg command handles existing SDR objects is different from the way in which the SDRCreateObjects command handles them. The SDRCreateObjects command creates a new object as long as the attributes, taken as a group, are unique.

To change a nonkey attribute of an Event Management object that already exists in the SDR, change the attribute in the load list file. Then run the haemloadcfg command using the -r flag and the name of the load list file. All objects in the SDR are replaced by matching objects in the load list file using the key attributes to match. Any unmatched objects in the load list file are added to the SDR.

To delete Event Management objects from the SDR, create a load list file with the objects to be deleted. Only the key attributes need to be specified. Then run the haemloadcfg command using the -d flag and the name of the load list file. All objects in the SDR that match objects in the load list file are deleted. No unmatched objects, if any in the load list file, are added to the SDR.

Under any circumstances, duplicate objects in the load list file, based on matches in key attributes, are ignored. However, such duplicate objects are written to standard output.

If there is configuration data present in the SDR from an earlier release, the haemloadcfg command automatically migrates the data from the old names to the new names the first time the command is invoked. After successful migration, the objects in the EM_Instance_Vector class are deleted.

Note that rvExpression and rvIndex_element are added to the definition of the EM_Resource_Variable class; rvPredicate and rvIndex_vector are still present in this class but are no longer used after migration.

For compatibility the haemloadcfg command accepts load list files using the old class and attribute names.

Flags

-d: Deletes objects from the SDR that match objects in the load list file.
-r: Replaces objects in the SDR by matching objects in the load list file. Any unmatched objects in the load list file are added to the SDR.

Parameters

loadlist_file: The name of the file that contains the Event Management configuration data to be loaded into the SDR. To load the default PSSP configuration data, specify /usr/lpp/ssp/install/config/haemloadlist.

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

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 load PSSP's default Event Management configuration data into the SDR, enter:
```
haemloadcfg /usr/sbin/rsct/install/config/haemloadlist
```
To load Event Management configuration data for a new Resource Monitor that is contained in a file called /usr/local/config/newrmloadlist, enter:
```
haemloadcfg /usr/local/config/newrmloadlist
```
If nonkey attributes in this load list file are later changed, update the SDR by entering:
```
haemloadcfg -r /usr/local/config/newrmloadlist
```
If this new Resource Monitor is no longer needed, its configuration data is removed from the SDR by entering:
```
haemloadcfg -d /usr/local/config/newrmloadlist
```

Location

/usr/sbin/rsct/install/bin/haemloadcfg: Contains the haemloadcfg command

Files

/usr/sbin/rsct/install/config/haemloadlist: Contains the default configuration data for the Event Management subsystem

Related Information

Commands: haemcfg, SDRCreateObjects, SDRDeleteObjects

Files: haemloadlist

For information about the System Data Repository (SDR) classes and attributes for the Event Management configuration database, see RSCT Event Management Programming Guide and Reference