IBM Tivoli Netcool/OMNIbus SNMP Writer Gateway: Reference Guide

Syntax
You can configure the mapping functions of the gateway by using the mapper
attributes.
Mappings for use with the SNMP Writer Gateway must use the following syntax:
CREATE MAPPING mappingname
(
varbindint = ’@fieldname’
[,varbindint = ’@fieldname’ [ ON INSERT ONLY ] ]...
);
where:
v mappingname is the name of the mapping to be created.
v varbindint is the integer value for the varbind field that will be written to in the
SNMP trap.
v fieldname is the name of a field in the ObjectServer alerts.status table.
Example mapping
The following default mapping is supplied in the snmp.map file:
CREATE MAPPING StatusMap
(
’0’ = ’@Summary’,
’1’ = ’@Severity’,
’2’ = ’@Location’,
’3’ = ’@Node’,
’4’ = ’@AlertGroup’,
’Node’ = ’@Node’
);
Defining a lookup table
You can define a lookup table within the map file and use it to transform values
found in particular fields to a different set of values before constructing SNMP
traps.
The following is an example lookup table definition:
CREATE LOOKUP ExampleTable (
{ ’source1’, ’target1’}
{ ’source2’, ’target2’}
etc )
This example is used in the map as follows:
’3’ = Lookup(’@myfield’, ’ExampleTable’)
Note: Changes or additions to the lookup table will only take effect after the
gateway is stopped and restarted.
Startup command file
The startup command file contains a set of commands that the gateway performs
automatically each time it starts. These commands allow the gateway to transfer
any subsidiary table data to a set of target tables.
The default startup command file is $OMNIHOME/gates/snmp/snmp.startup.cmd.
IBM Tivoli Netcool/OMNIbus SNMP Writer Gateway 17