Configuring the service activity monitoring facility

To configure the service activity monitoring (SAM) facility, take the following steps:

1. Change the default elements configuration in the sam.properties file as required.
   The default configuration of sam.properties contains all the elements from the previous release of InfoSphere® MDM. You can change the elements that appear as well as in what sequence they should be in the transactiondata.log file by using the following properties entry: sam.reports

   You can define a wrapper tag to capture select SQL statements, so everything enclosed by the wrapper tag belongs to one SQL statement. Use the properties entry sam.reports.sql.wrapper to configure the wrapper.

2. Add your own elements to the sam.properties file so those elements can also be monitored.
   Elements you add must start with sam_ so that SAM can pick them up. For example, if you wanted to report the current timestamp, you could add an element called sam_cur_time.
   1. Add a monitoring point in the client extension or rule to set the value of those elements to DWLControl.
      It can be implemented in the following way:

      // marks the monitoring point. For example:

      DWLControl control=getControl();//getcontrol()

      illustrates that the control should be available in this context. You would then insert the monitoring point as follows:

      control.put(‘sam_cur_time’, 
      System.currentTimeMillis());

      // marks the end of the monitoring point.

      Note: In case DWLControl is not available from the context, you can use the static method DWLControlHolder.getCtl(); to get DWLControl.
   2. Put the information into the sam.properties file with the other elements:
      sam.reports=…, sam_cur_time where ’...’ represents all other elements which are not listed here for the sake of clarity.
3. Build and redeploy the sam.properties file.
4. Restart the server.