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

[Contents][Index][Back][Next]

Severity changing definition file (jcochsev.conf)

Format

DESC_VERSION=version-information
 
#severity-changing-definition-parameter
 
def definition-name-1
    cnd
        event-condition
    end-cnd
    sev event-level
end-def
 
def definition-name-2
    cnd
        event-condition
    end-cnd
    sev event-level
end-def

File

jcochsev.conf (severity changing definition file)

jcochsev.conf.model (model file for the severity changing definition file)

Storage directory

In Windows
Console-path\conf\chsev\
shared-folder\jp1cons\conf\chsev\ (logical host)

In UNIX
/etc/opt/jp1cons/conf/chsev/
shared-directory/jp1cons/conf/chsev/ (logical host)

Description

This file defines conditions for changing the event level of JP1 events and the new event level. The event severity changing function changes the event level of a JP1 event if it satisfies an event condition defined in this file. Specify this file using the language encoding that is used by JP1/IM - Manager.

The maximum size of this file is 17 megabytes (17,825,792 bytes).

There are two types of parameters in the severity changing definition file:

When the definitions are applied

The definition takes effect when the event severity changing function has been enabled and one of the following occurs:

Information that is specified (severity changing definition file version)

DESC_VERSION
Specifies the file version that determines the format of this severity changing definition file. The file version of severity changing definition file version 09-00 is 1. If DESC_VERSION is omitted, 1 is assumed as the file version.
Specify DESC_VERSION on the first line of the definition file (the first line in the file excluding any null lines and comment lines). If there is no file version on the first line, the system assumes 1 as the file version.

Information that is specified (severity changing definition parameter)

def to end-def (definition block)
These are the start and end parameters for a severity changing definition. The block from def to end-def can be omitted, in which case the system assumes that the event level is not to be changed for any JP1 events. After def, specify the names of severity changing definitions. If you specify def...definition-1...definition-2..., then definition-1, definition-2, ... are treated as the definition names.
For a definition name, specify a character string of from 1 to 50 bytes. Each definition name must be unique within the severity changing definition file. The permitted characters are all characters other than the control characters (from 0x00 to 0x1F and 0x7F to 0x9F).

cnd to end-cnd (event condition block)
These are the start and end parameters for the block that specifies a condition for the JP1 events whose event level is to be changed. You must specify one event condition block in a definition block. The event condition block cannot be omitted. If a received JP1 event satisfies multiple event conditions, the definition block closest to the beginning of the severity changing definition file is effective. Tabs and spaces before and after the cnd and end-cnd parameters are ignored.

event-condition
Specifies a condition for the JP1 events whose event level is to be changed. You can specify from 1 to 256 event conditions per event condition block. When multiple event conditions are specified, it is assumed that they are connected with the AND condition. Specify 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. The attribute names are case sensitive.
The following table lists and describes the combinations of attribute names and comparison keywords and the operands that can be specified.

Table 2-40 Combinations of attribute names and comparison keywords and the operands that can be specified

No. Item Attribute name Comparison keyword Operand
1 Event ID B.ID
  • Match
  • Does not match
 A maximum of 100 event IDs can be specified.
Specify event IDs in hexadecimal notation. Event IDs are not case sensitive.
The permitted range is from 0 to 7FFFFFFF.
2 Reason for registration B.REASON
  • Match
  • Does not match
 A maximum of 100 reasons for registration can be specified.
3 Source process ID B.PROCESSID
  • Match
  • Does not match
 A maximum of 100 source process IDs can be specified.
The permitted value range is from -2,147,483,648 to 2,147,483,647.
4 Source user ID B.USERID
  • Match
  • Does not match
 A maximum of 100 source user IDs can be specified.
The permitted value range is from -2,147,483,648 to 2,147,483,647.
5 Source group ID B.GROUPID
  • Match
  • Does not match
 A maximum of 100 source group IDs can be specified.
The permitted value range is from -2,147,483,648 to 2,147,483,647.
6 Source user name B.USERNAME
  • First characters
  • Match
  • Does not match
  • Is contained
  • Is not contained
  • Regular expression
 A maximum of 100 source user names can be specified. However, if a regular expression is used, only one source user name is allowed.
7 Source group name B.GROUPNAME
  • First characters
  • Match
  • Does not match
  • Is contained
  • Is not contained
  • Regular expression
 A maximum of 100 source group names can be specified. However, if a regular expression is used, only one source group name is allowed.
8 Event-issuing server name (source host) B.SOURCESERVER
  • First characters
  • Match
  • Does not match
  • Is contained
  • Is not contained
  • Regular expression
 A maximum of 100 event-issuing server names can be specified. However, if a regular expression is used, only one event-issuing server name is allowed.
9 Target event server name B.DESTSERVER
  • First characters
  • Match
  • Does not match
  • Is contained
  • Is not contained
  • Regular expression
 A maximum of 100 target event server names can be specified. However, if a regular expression is used, only one target event server name is allowed.
10 Message B.MESSAGE
  • First characters
  • Match
  • Does not match
  • Is contained
  • Is not contained
  • Regular expression
 A maximum of 100 messages can be specified. However, if a regular expression is used, only one message is allowed.
11 Severity E.SEVERITY
  • Match
 Multiple severity values can be specified. However, if a regular expression is used, only one severity value is allowed. The following are the specifiable values: Emergency, Alert, Critical, Error, Warning, Notice, Information, or Debug.
12 User name E.USER_NAME
  • First characters
  • Match
  • Does not match
  • Is contained
  • Is not contained
  • Regular expression
 A maximum of 100 user names can be specified. However, if a regular expression is used, only one user name is allowed.
13 Product name E.PRODUCT_NAME
  • First characters
  • Match
  • Does not match
  • Is contained
  • Is not contained
  • Regular expression
 A maximum of 100 product names can be specified. However, if a regular expression is used, only one product name is allowed.
14 Object type E.OBJECT_TYPE
  • First characters
  • Match
  • Does not match
  • Is contained
  • Is not contained
  • Regular expression
 A maximum of 100 object types can be specified. However, if a regular expression is used, only one object type is allowed.
15 Object name E.OBJECT_NAME
  • First characters
  • Match
  • Does not match
  • Is contained
  • Is not contained
  • Regular expression
 A maximum of 100 object names can be specified. However, if a regular expression is used, only one object name is allowed.
16 Root object type E.ROOT_OBJECT_TYPE
  • First characters
  • Match
  • Does not match
  • Is contained
  • Is not contained
  • Regular expression
 A maximum of 100 root object types can be specified. However, if a regular expression is used, only one root object type is allowed.
17 Root object name E.ROOT_OBJECT_NAME
  • First characters
  • Match
  • Does not match
  • Is contained
  • Is not contained
  • Regular expression
 A maximum of 100 root object names can be specified. However, if a regular expression is used, only one root object name is allowed.
18 Object ID E.OBJECT_ID
  • First characters
  • Match
  • Does not match
  • Is contained
  • Is not contained
  • Regular expression
 A maximum of 100 object IDs can be specified. However, if a regular expression is used, only one object ID is allowed.
19 Occurrence E.OCCURRENCE
  • First characters
  • Match
  • Does not match
  • Is contained
  • Is not contained
  • Regular expression
 A maximum of 100 occurrences can be specified. However, if a regular expression is used, only one occurrence is allowed.
20 Termination code E.RESULT_CODE
  • First characters
  • Match
  • Does not match
  • Is contained
  • Is not contained
  • Regular expression
 A maximum of 100 termination codes can be specified. However, if a regular expression is used, only one termination code is allowed.
21 Program-specific extended attribute E.xxxxxxx#
  • First characters
  • Match
  • Does not match
  • Is contained
  • Is not contained
  • Regular expression
 For the attribute name, you can specify a name with a maximum length of 32 bytes that begins with an upper-case letter and consists of upper-case letters, numeric characters, and the underscore (_).
A maximum of 100 extended attributes can be specified. However, if a regular expression is used, only one extended attribute is allowed.

#
You can also specify a JP1 product-specific extended attribute. For example, the program-specific extended attribute for the JP1/AJS job execution host is E.C0. For details about the product-specific extended attributes, consult the documentation for the products that issue JP1 events.

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.
Separate multiple operands 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, only one operand can be specified.
To specify a space, a tab, linefeed code (CR or LF), or % as part of an operand, specify as follows:
No. Value to be set 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.ID[Figure]IN[Figure]100[Figure]200
Legend:
[Figure]: Space (0x20)
You can specify a maximum of 4,096 bytes of operands per event condition and per event condition block (total length in bytes of all operands that are specified in the event condition block).

sev
Specifies the new event level after the change.
You must specify one sev parameter in a definition block. This parameter cannot be omitted.
You can specify in the sev parameter Emergency, Alert, Critical, Error, Warning, Notice, Information, or Debug.

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

Example definition

Change the event level to Emergency when the event ID is 100 or 200, the existing event level is Warning, and the source host is hostA, hostB, or hostC:

 
DESC_VERSION=1
def Event level change 1
    cnd
        B.ID IN 100 200
        E.SEVERITY IN Warning
        B.SOURCESERVER IN hostA hostB hostC
    end-cnd
    sev Emergency
end-def

[Contents][Back][Next]

[Trademarks]

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