14.1.9 Considerations for changing display messages for JP1 events
For easier system monitoring and event management, consider changing the format of display messages for JP1 events.
The display message change function enables you to change the display message text for JP1 events to a desired format so that you can display only the important parts of the message text during monitoring to make them more readable.
Carefully evaluate the following items of the display message change definition:
-
Determine which JP1 events' display messages need to be changed
-
Determine the parts of the original messages you want to be displayed after the change
-
Determine the format of the messages after the change
For details about the display message change definition file, see Display message change definition file (jcochmsg.conf) (Chapter 2. Definition Files) in the manual JP1/Integrated Management 3 - Manager Command, Definition File and API Reference.
- Organization of this subsection
(1) Considerations for the display message change definition
The following table shows an example of a message for a JP1 event.
Message type |
Message contents |
---|---|
Message before change |
KAVS0265-E Job ended abnormally. (name: job-name: execution-ID, status: status, code: code, host: host-name, JOBID: job-number) |
Message after change |
Job: job-name ended abnormally with RC=code: Contact job supervisor (ext:xxxx) |
- Legend:
-
Underline (__): Information that is inherited from the message before change.
The following figure shows an example of the definition in the display message change definition file.
|
To use the display message change definition shown here, copy the following code:
def display-message-change-definition-1 define enable addflag false cnd B.ID IN 4107 E.SEVERITY IN Error B.MESSAGE REGEX KAVS0265-E.*\((.+):.+\).*code:%20(.+),%20host: end-cnd msg Job: $EVENV1 ended abnormally with RC=$EVENV2: Contact job supervisor (Ext: xxxx) end-def |
(2) Events for which display messages can be changed
You can change display messages for JP1 events and events in the JP1/SES format. Note that display messages cannot be changed for events whose display messages have already been changed or for JP1 events whose display messages have been converted by JP1/IM - MO (the event ID in both cases is 00006400).
(3) Functions that can use messages whose display messages have been changed
The following functions can use messages whose display messages have been changed:
-
Automated action (inheritance to actions)
-
View filter
-
Event search (search object is the integrated monitoring database)
-
Command execution
-
Event output