IBM BJ0NJML - Service And Asset Management, Integration Manual

Page: 238 / 330

Inbound Customization
224
Integration Guide
The interface table polling program is run by using the system cron task manager.
The cron task, IFACETABLECONSUMER, has an optional property called
EXITCLASS, where you can place the fully qualified name of a Java exit class.
The Java data structure list represents the record from the interface tables, where
the first element is always the action of the message. The remaining elements of
the list are the mapped data structures, with each map representing a row in the
interface table for each message. The keys in the map are the column names and
the values are the corresponding column values. All the column values (Integers,
Date, Float, Double) are converted to their localized string format before they are
set in the map.
The EXITCLASS class must implement the psdi.iface.intertables.IfaceTbExit
interface and the following three methods:
public void beforeQueue(long transid, String extSys, String
ifaceName, List data, Connection conn)
This method is called after the data is pulled from the interface table and
before the data is inserted into one of the inbound queues.
public void afterCommit(long transid, String extSys, String
ifaceName, Connection conn)
This method is called after the data has been inserted to an inbound queue
and deleted from the interface queue table, and the database commit is
done.
public void afterRollback(long transid, String extSys, String
ifaceName, Connection conn)
This method is like the afterCommit method but called if the transaction is
rolled back.
This class can perform the noted processes:
T Validate data
T Change external data by changing the IR record to be saved in the system
T Stop the transaction from being saved in the queue by throwing an
exception
In this case, the transaction remains in the MXIN_INTER_TRANS table
with the error message and is reprocessed.
T Stop the message from being sent to external system by throwing a
skip_transaction exception
In this case, message the system does not save the message; the message is
removed from the queue.
T Log the transaction
The user exit that uses the afterCommit or afterRollback method can perform the
following processes:
T Perform custom processing and cleanup