6.9.5 Changing the message displayed for a JP1 event
When you use the integrated monitoring database, you can change the messages to be displayed for events by setting the display message change function.
You can configure the display message change function by using the GUI, or you can define the function in the display message change definition file and execute the jco_spmd_reload command to apply the settings.
- Important
-
Do not set a severity change definition in the GUI and in the definition file at the same time. If you modify the definition file by using a text editor or another method while the definition is being modified in the GUI, data in the definition file might become different from that in memory.
For details about how to set up the integrated monitoring database, see 1.4.2 Setting up the integrated monitoring database (for Windows) or 2.4.2 Setting up the integrated monitoring database (for UNIX) in the JP1/Integrated Management 3 - Manager Configuration Guide.
For details about how to configure the display message change function, see 5.14 Setting the display message change function in the JP1/Integrated Management 3 - Manager Configuration Guide.
The following shows how to change the messages to be displayed for events.
- Organization of this subsection
(1) Setting a display message change definition in the Display Message Change Definition Settings window
To set a display message change definition in the Display Message Change Definition Settings window:
-
Make sure that the display message change function is enabled for the event.
In the Event Console window, under Options, check whether Display Message Change Definitions is displayed. If it is not displayed, enabling the integrated monitoring database will enable the display message change function. When you enable the display message change function, restart JP1/IM - Manager.
In addition, if the IM database was not updated using the jimdbupdate command after an upgrade of JP1/IM - Manager from version 10-50 or earlier, update the IM database. For details about the jimdbupdate command, see jimdbupdate in Chapter 1. Commands of the JP1/Integrated Management 3 - Manager Command, Definition File and API Reference.
-
In the Event Console window, choose Options and then Display Message Change Definitions.
The Display Message Change Definitions window opens.
-
Click the Add, Edit, Copy, or Delete button according to your needs.
-
If you click the Add button:
The Display Message Change Definition Settings window opens. You can set a new display message change definition.
-
If you click the Edit button:
The Display Message Change Definition Settings window opens. You can edit the selected display message change definition.
-
If you click the Copy button:
The selected display message change definition is copied and added to the Display Message Change Definitions window. Copy is added to the beginning of the copied display message change definition.
-
If you click the Delete button:
The selected display message change definition is deleted.
In this case, step 4 is skipped.
-
-
In the Display Message Change Definition Settings window, set the message.
Set an event condition for which you want to change the message. Then, set a new message format in Message after the change. If you specify the facility for converting the event information to inherit, you can standardize the message character count and the number display format so that they are easy to read. For details about the facility for converting the event information to inherit, see Display message change definition file (jcochmsg.conf) in Chapter 2. Definition Files of the JP1/Integrated Management 3 - Manager Command, Definition File and API Reference. After setting, click the OK button.
-
In the Display Message Change Definitions window, click the Apply button to enable the setting.
In the Display Message Change Definition Settings window, select the display message change definition that was set in the Display Message Change Definitions window, and then select the Apply check box to enable it. If you want to set multiple events, repeat steps 3 through 5.
-
A confirmation message appears. To apply the settings, click Yes.
The display message change definition that you set takes effect.
(2) Setting a display message change definition in the display message change definition file
To set a display message change definition from the display message change definition file:
-
Make sure that the display message change function is enabled for the event.
In the Event Console window, under Options, check whether Display Message Change Definitions is displayed. If it is not displayed, enabling the integrated monitoring database will enable the display message change function. When you enable the display message change function, restart JP1/IM - Manager.
In addition, if the IM database was not updated using the jimdbupdate command after an upgrade of JP1/IM - Manager from version 10-50 or earlier, update the IM database. For details about the jimdbupdate command, see jimdbupdate in Chapter 1. Commands of the JP1/Integrated Management 3 - Manager Command, Definition File and API Reference.
-
Define the display message change for the event in the display message change definition file.
Define a display message change definition for each system.
In the display message change definition, specify the event condition for the JP1 event whose display message you want to change, and a new message format.
If you use the facility for converting the event information to inherit, you can standardize the message character count and the number display format so that they can be displayed in an easy-to-read manner in the events list.
For details about the display message change definition file, see Display message change definition file (jcochmsg.conf) in Chapter 2. Definition Files of the JP1/Integrated Management 3 - Manager Command, Definition File and API Reference.
- Specification example for the display message change definition file
-
DESC_VERSION=1
def display-message-change-1
cmt comment-1
define enable
addflag false
cnd
B.ID IN 100 200
E.SEVERITY IN Warning
B.SOURCESERVER IN hostA hostB hostC
end-cnd
msg $EVDATE $EVTIME An error occurred in the database server
end-def
-
Execute the jco_spmd_reload command or restart JP1/IM - Manager.
For details about the jco_spmd_reload command, see jco_spmd_reload in Chapter 1. Commands of the JP1/Integrated Management 3 - Manager Command, Definition File and API Reference.
The message for the JP1 event after the change has been applied is displayed under Changed display message in the events list. The message for the JP1 event before the change was applied is displayed under Message in the events list. Additionally, for the JP1 event whose message was changed, the icon
is displayed under New display message.
Event Base Service changes the messages for the JP1 events received from the Event Service instance on the manager, stores the new messages in Changed display message, and registers them in the integrated monitoring database. During this process, the original messages are not changed.
(3) Adding a display message change definition by using events that occur during operations
During system operations, you can select an event you wish to change, and add a condition for a display message change definition from the Add Display Message Change Definitions window.
If you select an event and then add a definition, the definition is registered at the top of the definitions displayed in the Display Message Change Definitions window, and that definition takes priority.
To add a display message change definition in the Add Display Message Change Definitions window:
-
In the Event Console window, select an event whose display message you want to change, right-click the mouse, and from the popup menu that opens, choose Display Message Change Definitions.
The Add Display Message Change Definitions window opens.
-
In the Add Display Message Change Definitions window, change the display message.
Set the event conditions for changing the message. Then, set a new message format in Message after the change. If you specify the facility for converting the event information to inherit, you can standardize the message character count and the number display format so that they are easy to read. For details about the facility for converting the event information to inherit, see Display message change definition file (jcochmsg.conf) in Chapter 2. Definition Files of the JP1/Integrated Management 3 - Manager Command, Definition File and API Reference. After setting, click the OK button.
-
Click the OK button.
The added display message change definition is applied to the Display Message Change Definitions window. An icon is displayed in the Type column of the display message change definition that was added during operations.
(4) Converting an added display message change definition to a regular display message change definition
To convert a display message change definition that was added during system operations to a regular display message change definition:
-
From the menu in the Event Console window, select Options and then Display message change definitions to display the Display Message Change Definitions window.
-
In the Display Message Change Definitions window, from Display Message Change Definitions, select the added display message change definition (for which an icon is displayed in the Type column) that you want to convert to a regular display message change definition.
-
Click the Type button.
-
A confirmation message appears. To change the type, click Yes.
The added display message change definition that you selected is converted to a regular display message change definition.
-
In the Display Message Change Definitions window, click the Apply button.
-
A confirmation message appears. To apply the settings, click Yes.
The display message change definition that you added takes effect.