Positive message filter

The following two filter options are available for selection of messages to be sent to the management station:

• Routing code (assigned to each console message)

• Message key (uniquely identifies each message)

Routing code selection criterion

Each message is assigned a specific routing code. Operator roles contain the routing codes of the messages to be sent to the management station. The operator roles are specified when starting the Console Monitor (see section “Agents-specific options for starting agents manually”).The following statements show you how operator roles are created and assigned to the operator ID. The SECURITY ADMINISTRATION privilege, which the user ID SYSPRIV has as default, is required for issuing the following commands.

Create the operator role: /CREATE-OPERATOR-ROLE OP-ROLE=<op-role-name>, ROUTING-CODES=.......	-
Assign the operator role to the operator ID: /MODIFY-OPERATOR-ATTR USER-ID=<operator-id>,	-

ADD-OPERATOR-ROLE=(<op-role-name1>,...,<op-role-namex>)

Message code selection criterion

The codes of messages to be sent to the management station are stored in the positive message filter file. The statements

• msgid

• QUESTION

• TYPIO

provide three filter options. The name of the message filter file is made known to the Console Monitor when it is started via the -c command argument or it can be entered in the MIB consMonMsgFilter object during a session.

If no message filter file is specified when the Console Monitor is started, all messages are output for which the routing code is specified in the operator role.

If the message filter file contains no key, or no valid key, no traps are sent to the management station.

The following name conventions apply to the message filter file:

/BS2/<file>	BS2000 file
/BS2/[:<catid>:]$<userid>.<file>	BS2000 file
*POSIX(<file>)	POSIX file
/<path>/<file>	POSIX file
<file>	The deciding factor, in this case, is the environment in which the agent was started.

When passing these parameters using either the command line or in scripted format, remember that some special characters such as the dollar sign ("$") need to be prefixed with a backslash escape character ("\").