4.1.2 Associating events with correlation events

To handle multiple events as a single error, you use correlation events. You can set correlation events in the correlation event generation definition file.

Prerequisites

The OS user who will execute the jcoimdef and jcoegschange commands must have Administrator or root permissions.

Procedure

1. Execute the following jcoimdef command to enable the correlation event generation function:

   • In Windows:

     "Console-path\bin\jcoimdef" -egs ON

   • In Linux:

     /opt/jp1cons/bin/jcoimdef -egs ON

2. Using a text editor, open a correlation event generation definition file (example: teigi1.conf), which is in the following location:

   • In Windows: Any folder

   • In Linux: Any directory

   Use .conf as the extension of the correlation event generation definition file. In the file name, you can use alphanumeric characters and underscores (_).

3. Enter the following specifications:

   -----------------------------------------------------

   VERSION=2

   [error_gradation]

   CON=E.SEVERITY==Error,B.SOURCESERVER==hostA

   CON=E.SEVERITY==Error,B.SOURCESERVER==hostB

   CON=E.SEVERITY==Error,B.SOURCESERVER==host1

   TYPE=combination

   SUCCESS_EVENT=E.SEVERITY:Warning,B.MESSAGE:"Errors occurred on hosts A, B, and 1, which are hindering operations."

   FAIL_EVENT=E.SEVERITY:Information,B.MESSAGE:"Operations are continuing, but one or more errors might have occurred on host A, B, and/or 1."

   -----------------------------------------------------

4. Save the information specified in teigi1.conf.

5. Execute the jcoegschange command on the manager to apply the settings of the correlation event generation definition file.

   • In Windows:

     "Console-path\bin\jcoegschange" -f correlation-event-generation-definition-file-name

   • In Linux:

     /opt/jp1cons/bin/jcoegschange -f correlation-event-generation-definition-file-name

   Specify the name of the correlation event generation definition file in relative or absolute path format. For example, if teigi1.conf is stored in C:\jp1im in Windows, specify C:\jp1im\teigi1.conf as the absolute path name of the correlation event generation definition file.

6. Restart JP1/IM - Manager.

   The correlation event generation function is enabled when JP1/IM - Manager restarts.

Related topics

• 3.3 Issue of correlation events in the Overview and System Design Guide

• 4.6 Setting correlation event generation in the Configuration Guide

• 5.1.10 Displaying and handling correlation events in the Administration Guide

• 1. jcoegschange in the manual Command and Definition File Reference

• Correlation event generation definition file in 2. Definition Files in the manual Command and Definition File Reference

To Page Top