Structure of the positive message filter

msgid statement

<msgid [wgt] [SOURCE=src] [DEVICE=dev]

       [PATTERN=/pat1[/..patx]] [ACKNOWLEDGE=YES]>

msgid

Specifies a message code.
The following wildcards are permitted for message code entries:

?	replaces any character
*	replaces any number of characters
[s]	replaces exactly one character in a string s
[c1 - c2]	replaces any character in the range c1 to c2

The backslash character "\" must be specified for special characters.
Msgid can not contain any lowercase characters.

wgt

Specifies a message weight. A weight can be assigned to the message codes. The weight is prefixed to the actual message in the trap string. This allows the user to set the importance of messages himself and transmit this to the management station. The message code is assigned the value 0 as default if no weight is specified.
The entry is expected as an integer in the range 0 - 999.

src

Specifies a source name. The source is supplied with BS2-<source> in the trap string. The default value BS2Console is used if no value is specified. You can set an alarm to a specific object in the network map with this entry. The entry is alphanumeric up to 12 characters long.

pat

Specifies one or more search patterns (pattern).

?	replaces any character
*	replaces any number of characters
[s]	replaces exactly one character in a string s
[c1 - c2]	replaces any character in the range c1 to c2

The character "\" (backslash) must be specified to invalidate special characters. A distinction is made between upper case and lower case.

dev

If DEVICE is specified, the Console Monitor agent sends this trap with the DEVICE entry as Community.

ACKNOWLEDGE=YES

If you specify ACKNOWLEDGE=YES, the agent is informed that this trap must be acknowledged.

QUESTION statement

Question filters all messages that contain a question, i.e. expect an answer. If a question is encountered, the Console Monitor first checks whether a pattern of QUESTION entries matches. If not, the MSGID entries or the TYPIO entries are searched for the relevant message type.

<QUESTION [wgt] [SOURCE=src] [DEVICE=dev] [PATTERN=/pat1[/..patx]]

[ACKNOWLEDGE=YES]>

wgt

see above

src

see above

dev

see above

pat

see above

ACKNOWLEDGE=YES

see above

Example:

<QUESTION PATTERN=*REW0010*>

Selection of all questions that contain REW0010 string.

TYPIO statement

 TYPIO messages are a special case. These include, for example, messages sent to the BS2000 console with /INFORM-OPERATOR. Their reception is also controlled via the message filter file. Only the string after the UCON prefix in the console message is checked whether it matches the filter pattern. The entry for a TYPIO message is as follows:

<TYPIO [wgt] [SOURCE=src] [DEVICE=dev] [PATTERN=/pat1[/..patx]] [ACKNOWLEDGE=YES]>

wgt

see above

src

see above

dev

see above

pat

see above

ACKNOWLEDGE=YES

see above

Example:

 <TYPIO PATTERN=/*abc*/xyz>
 <TYPIO PATTERN=/Hallo*>
 <TYPIO PATTERN=/?\?*>
 All TYPIO messages that contain the string "abc", are
 only made up of "xyz", start with "Hello" or have a
 question mark as their second character, are sent to the
 management platform as a trap.