Job Management Partner 1/Integrated Management - Manager Command and Definition File Reference

Filter file

Format

event-condition : OR event-condition : EXCLUDE event-condition :

File

Use any file.

Storage directory

In Windows

Any folder

In UNIX

Any directory

Description

This file defines filter conditions to be applied during output of event reports. To load the file, execute the jcoevtreport command with the -f option specified.

The maximum size of this file is 256 kilobytes (262,144 bytes).

When the definitions are applied

When the jcoevtreport command with the -f option specified is executed, the specified item file is loaded and the JP1 events that satisfy the specified condition are acquired from the integrated monitoring database and then output to an event report.

Contents of the file

pass-conditions group, exclusion-conditions group

The jcoevtreport command outputs the JP1 events that do not satisfy any of the exclusion-conditions groups and that satisfy one of the pass-conditions groups. For the filter conditions, you can specify from 0 to 5 pass-conditions groups and from 0 to 5 exclusion-conditions groups.

In a pass-conditions group or exclusion-conditions group, you can specify from 0 to 50 event conditions. In the case of an extended attribute (user-specific information), you can specify a maximum of 5 event conditions per pass-conditions group or exclusion-conditions group.

OR

If you specify multiple condition groups, specify OR between the condition groups.

EXCLUDE

Specify EXCLUDE between a pass-conditions group and an exclusion-conditions group. Any event condition that follows EXCLUDE is treated as an exclusion-conditions group. If no event condition follows EXCLUDE, only the pass-conditions groups take effect.

event-condition

Specifies an event condition in the following format:

 
  attribute-name comparison-keyword operand [ operand]...
 

Note that a line consisting of only spaces or tabs is ignored during processing.

attribute-name

Specifies the name of the attribute that you want to compare. To specify a basic attribute, place B. immediately before the name; to specify an extended attribute (common information or user-specific information), place E. immediately before the name. Attribute names are case sensitive.

comparison-keyword

Specifies one of BEGIN (begins with), IN (matches), NOTIN (does not match), SUBSTR (includes), NOTSUBSTR (does not include), or REGEX (regular expression) as the comparison keyword. The comparison keyword is case sensitive.

operand

Specifies a character string as the value that is to be compared with the attribute value by the specified comparison keyword. Operands are case sensitive.

Specify multiple operands by separating them with one or more consecutive spaces or a tab. The OR condition is applied to the specified operands. Note that if a regular expression is specified for the comparison keyword, only one operand can be specified.

To specify a space, a tab, linefeed code (CR or LF), or % as a part of an operand, specify as follows:

No.	Value to be specified	How to specify
1	Tab (0x09)	%09
2	Space (0x20)	%20
3	% (0x25)	%25
4	Linefeed code LF (0x0a)	%0a
5	Linefeed code CR (0x0d)	%0d

During maximum value checking for the definition format, %20 and %25 are each treated as a single character. The following shows an example of defining ID matches 100 and 200, which selects multiple operands:

 
B.IDIN100200

Legend:

: Space (0x20)

You can specify a maximum of 4,096 bytes of operands per event condition and per event condition block (total length of operands in bytes that are specified in the event condition block).

Example definition

 
B.ID IN 1
B.MESSAGE SUBSTR Warning
E.SOURCESERVER IN host1 host2 host3 host4
OR
B.ID IN 1
B.MESSAGE SUBSTR Error
E.SOURCESERVER IN host1 host2 host3 host4
EXCLUDE
E.SOURCESERVER IN host3

[Contents][Back][Next]

All Rights Reserved. Copyright (C) 2009, Hitachi, Ltd.