Map definition file

The Socket Gateway writes the alerts received from the various tables in the ObjectServer onto the socket in a format defined by the map definition file.

The default map definition file, socket_java.map, is installed in the following location:

$OMNIHOME/gates/socket_java

Gateway mapper attributes

You can configure the mapping functions of the gateway by using the mapper attributes.

Syntax

Mappings for use with the Socket Gateway must use the following syntax:

CREATE MAPPING mappingname 
( 
'' = '@fieldname' [ON INSERT ONLY], 
['' ='@fieldname' [ON INSERT ONLY]]... 
) ;

Where:

mappingname is the name of the mapping to be created.

fieldname must be the name of a field in one of the ObjectServer tables.

The optional ON INSERT ONLY controls the updating of the field during the life of the alert. When omitted, the field is updated for any change in the state of the alert. When included, the field is only set when the alert is created.

Creating name-value pairs in the gateway output

To create a list of name-value pairs in the gateway output, configure the map file using the following example.

'' = 'Identifier : ' + '@Identifier',

'' = 'Serial : ' + TO_STRING('@Serial'),

Where Identifier and Serial are the values you want named in the gateway output.

Note: You need to do a type conversion for non-string valued fields.

For details about the map definition file, see the IBM Tivoli Netcool/OMNIbus Probe and Gateway Guide.