[ Bottom of Page | Previous Page | Next Page | Contents | Index | Library Home | Legal | Search ]

Commands Reference, Volume 2

elogevent Command

Purpose

Logs event information generated by the event response resource manager (ERRM) to a specified log file.

Syntax

elogevent [-h] log_file

Description

The elogevent script always return messages in English. The language in which the messages of the logevent script are returned depend on the locale settings.

These scripts capture event information that is posted by the event response resource manager (ERRM) in environment variables that are generated by the ERRM when an event occurs. These scripts can be used as actions that are run by an event response resource. They can also be used as templates to create other user-defined actions. See the RSCT Guide and Reference to understand how an event response resource runs an action command.

Event information is returned about the ERRM environment variables that are described in the RSCT Guide and Reference, and also includes the following:

Local Time
Time when the event or rearm event is observed. The actual environment variable supplied by ERRM is ERRM_TIME. This value is localized and converted to readable form before being displayed.

These scripts use the alog command to write event information to and read event information from the specified log_file.

Flags

-h
Writes the script's usage statement to standard output.

Parameters

log_file
Specifies the name of the file where event information is logged. An absolute path for the log_file parameter should be specified.

The log_file is treated as a circular log and has a fixed size of 64KB. When log_file is full, new entries are written over the oldest existing entries.

If log_file already exists, event information is appended to it. If log_file does not exist, it is created so that event information can be written to it.

Exit Status

0
The script has run successfully.
1
A required log_file is not specified.
2
The log_file path is not valid.

Restrictions

Standard Output

When the -h flag is specified, the script's usage statement is written to standard output.

Examples

  1. To log information, specify /tmp/event.log in the Web-based System Manager interface. ERRM runs this command:
    /usr/sbin/rsct/bin/logevent/tmp/event.log
    The /tmp/event.log file does not need to exist when the command is run.
  2. To see the contents of the /tmp/event.log file, run this command:
    cat /tmp/event.log  
    The following sample output shows a warning event for the /var file system (a file system resource):
    =============================================================================
    Event reported at Mon Mar 27 16:38:03 2002
    
    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

Location

/usr/sbin/rsct/bin/elogevent
Contains the elogevent script
/usr/sbin/rsct/bin/logevent
Contains the logevent script

Related Information

Commands: alog

Books: see the RSCT Guide and Reference for information about the event response resource manager (ERRM) and about how to use ERRM environment variables

[ Top of Page | Previous Page | Next Page | Contents | Index | Library Home | Legal | Search ]