Commands Reference, Volume 4

notifyevent Command

Purpose

Mails event information generated by the Event Response resource manager to a specified userid.

The notifyevent command captures event information that is posted by the Event Response resource manager in environment variables that are generated by the Event Response resource manager when an event occurs. The notifyevent command can be used as an action that is executed by an Event Response resource. It can also be used as a template to create other user-defined actions.

The event information includes:

Condition Name: Name of the Condition resource that caused this event or rearm event.
Severity: Significance of the Condition resource that caused the event or rearm event. The value can be one of the following: Critical, Warning, or Informational
Resource Name: Name of the resource whose attribute changed to cause this event or rearm event.
Resource Class Name: Name of the resource class to which the resource that caused this event or rearm event belongs.
Event Time: Time when the event or rearm event was observed.
Event Type: Type of event that occurred. The values can be event or rearm event.
Expression: Statement that evaluated to true and thereby caused this event or rearm event.
Data Type: Resource attribute type that caused this event or rearm event.
Data Value: Resource attribute value that caused this event or rearm event.

The notifyevent command uses the mail command to send event information to the specified userid. When a userid is specified, it is assumed to be valid, and it is used without verifying it. If a userid is not specified, the user who is running the command is used as the default.

Note: The following restrictions apply:

This command must be executed on the node where the Event Response resource manager is running.
The mail command is used to read the file.

Parameters

userid

Optional ID of the user to whom the event information will be mailed. If UserID is not specified, the user who is running the command is used as the default.

Flags

-h	Writes help information about this command to standard out. No further processing is performed.

Exit Status

0	Command has run successfully.

Examples

Specify user1 in Web-based System Manager to send mail to a user. The Event Response resource manager then runs the following command:
```
/usr/bin/rsct/sbin/notifyevent user1
```

You can use the mail command to read the contents of the event information. The following example shows how a warning event for the /var file system (a file system resource) is formatted and logged:

===========================================================================================
Event reported at Sun Mar 26 16:38:03 2000
 
Condition Name:		 			/var space used
Severity:					Warning
Event Type:		 			Event
Expression: 					PercentTotUsed>90
 
Resource Name:					/var
Resource Class Name:				IBM.FileSystem
Data Type:					CT_UINT32
Data Value:					91

Files

/usr/sbin/rsct/bin/notifyevent

Location of the notifyevent command.

Related Information

The mail command