Hitachi

JP1 Version 12 JP1/Integrated Management 2 - Event Gateway for Network Node Manager i


4.1.1 Format of the NNMi incident forwarding filter definition file

The NNMi incident forwarding filter definition file consists of the following two blocks:

The filter condition block and the mapping block constitute a forwarding condition block. When multiple forwarding condition blocks are specified in the NNMi incident forwarding filter definition file, comparison processing is performed as specified in the file (from top down). If any condition in the forwarding condition block is satisfied, following comparison processing is not performed. If all conditions in the forwarding condition blocks are not satisfied, NNMi incidents are not converted into JP1 events.

The following table shows the structure of an NNMi incident forwarding filter definition file.

Table 4‒1: Structure of an NNMi incident forwarding filter definition file

Block

Setting item

Description

Forwarding condition block

Filter condition block

Conditional statement

Specifies a condition for determining NNMi incidents that are to be converted into JP1 events.

Exclusion condition

Specifies a condition for determining NNMi incidents that are not to be converted into JP1 events.

Mapping block

Message

Specifies the mapping of messages.

Severity

Specifies the mapping of severities.

Extended attribute

Specifies the mapping of extended attributes.

The following figure shows an example of an NNMi incident forwarding filter definition file.

Figure 4‒1: Example of an NNMi incident forwarding filter definition file

[Figure]

forward-condition: Declares the beginning of a forwarding condition block.

filter: Declares the beginning of a filter condition block.

EXCLUDE: Indicates exclusion conditions.

end-filter: Declares the end of a filter condition block.

mapping: Declares the beginning of a mapping block.

end-mapping: Declares the end of a mapping block.

end-forward-condition: Declares the end of a forwarding condition block.

Rules for the NNMi incident forwarding filter definition file

The following rules apply to the NNMi incident forwarding filter definition file:

  • The maximum size of the NNMi incident forwarding filter definition file is 10 megabytes.

  • You can specify a maximum of 100 forwarding condition blocks.

  • Do not specify multiple filter condition blocks or mapping blocks in a single forwarding condition block. An error results if one forwarding condition block contains multiple filter condition blocks or multiple mapping blocks.

  • You can specify multiple conditions by using OR to link multiple conditional statements or exclusion conditions.

  • Specify each message or extended attribute mapping setting on a single line without inserting a linefeed code.

  • A line beginning with a hash mark (#) is treated as a comment line.