Modifying the Gateway for Message Bus mapping

You must modify the Gateway for Message Bus mapping to include the new custom field or fields.

Before you begin

The mapping that you configure in this task must match the order of fields configured in your custom data source type, as specified in Creating a custom data source type.

You must collect the following information prior to performing this task:

Location of a Gateway for Message Bus mapping file that is compliant with the current version of the Netcool®/OMNIbus Insight® Pack.
Name and location of the Gateway for Message Bus properties file.

Procedure

Copy a Gateway for Message Bus mapping file that is compliant with the current version of the Netcool/OMNIbus Insight Pack.
For example, for Netcool/OMNIbus Insight Pack 1.3.0.2 and later, you can copy the file $OMNIHOME/gates/xml/scala/xml1302.map. In the following example, the file is copied to a file called xmlCustom1302.map:
```
cp  $OMNIHOME/gates/xml/scala/xml1302.map  $OMNIHOME/gates/xml/scala/xmlCustom1302.map
```
Add a command after the last entry in the CREATE MAPPING StatusMap section of the file.
For example, if the last entry is a line specifying the ServerSerial field, then add a comma at the end of that line, like this:
```
       'ServerSerial'     =    '@ServerSerial',
  );
```
For the purposes of this task, we assume that you are adding a new custom field that stores a trouble ticket number, and this field is called TicketNumber. Add this custom field after the last entry in the CREATE MAPPING StatusMap section of the Gateway for Message Bus mapping file, before the terminating parenthesis.
```
       'ServerSerial'     =    '@ServerSerial',
       'TicketNumber'     =    '@TicketNumber'
  );
```
Save the Gateway for Message Bus mapping file, xmlCustom1302.map.
Locate the Gateway for Message Bus properties file.
By default this file is called G_SCALA.properties and it is located in the following directory:
```
$OMNIHOME/gates/xml/scala/G_SCALA.props
```
Where $OMNIHOME is /opt/IBM/tivoli/netcool/omnibus/.
Edit the Gateway for Message Bus properties file G_SCALA.properties using a text editor of your choice; for example, vi.
```
vi G_SCALA.properties
```
Change the Gate.MapFile parameter to refer to the new mapping file.
For example:
```
Gate.MapFile        :'$OMNIHOME/gates/xml/scala/xmlClone1302.map'
```
Save and close the Gateway for Message Bus properties file G_SCALA.properties.
Restart the Gateway for Message Bus.