Commands Reference, Volume 6

wallevent Command

Purpose

Broadcasts an event or a rearm event to all users who are logged in.

The wallevent command broadcasts a message on an event or a rearm event to all users who are currently logged in to the host when the event or the rearm event occurs. Event or rearm event information is captured and posted by the Event Response resource manager in environment variables that are generated by the Event Response resource manager when an event or a rearm event occurs. The wallevent 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 following message template is displayed at the consoles of all users who are logged in when an event or a rearm event for which wallevent is a response action occurs:

Broadcast message from <user@host> <tty> at <hh:mm:ss>...
<Severity> <Event Type> occurred for the condition <Condition Name>
 on the resource <Resource Name> of <Resource Class Name> at <Event Time>

The environment variables have the following meanings:

Severity: Significance of the Condition resource that caused the event. The value can be one of the following: Critical, Warning, or Informational.
Event Type: Type of event that occurred. The value can be: event or rearm event.
Condition Name: Name of the Condition resource whose attribute value changed to cause this event or rearm event.
Resource Name: Name of the resource whose attribute value 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 is observed.

The wallevent command captures the preceding environment variable values and uses the wall command to write a message to the currently logged-in user consoles.

Note: The following restrictions apply:

This script must be run on the host where the Event Response resource manager is running.
The wall command is used to write a message to currently logged-in user consoles. Refer to the wall man page for more information on the wall command.

Flags

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

Exit Status

0	Script has run successfully.
1	Error occurred when the script was run.

Examples

Assume the wallevent command is a predefined action in the critical-notification response, which is associated with the /var space used condition on the resource /var. The threshold of the event expression defined for this condition is met, and an event occurs. The critical-notification response takes place, and wallevent is run. The following message is displayed on the consoles of all logged-in users:
```
Broadcast message from joe@neverland.com (pts/6) at 18:42:03...
 
Critical event occurred for the Condition /var space used 
on the resource /var of JFS at 18:43:03 03/28/00
```

When a rearm event occurs for the /var space used condition on the resource /var, the following message is displayed on the consoles of all users who are logged in:

Broadcast message from joe@neverland.com (pts/6) at 18:42:03...
 
Critical rearm event occurred for the Condition /var space used 
on the resource /var of JFS at 18:43:03 03/28/00

Files

/usr/sbin/rsct/bin/wallevent

Location of the wallevent script

Related Information

The wall command