updateCallback

updateCallback(tranID:           Integer64;
               timestamp:        TimeStamp;
               oid:              Object;
               operation:        Integer;
               tableName:        String;
               dropRowOperation: Boolean io;
               outputRowList:    JadeDynamicObject);

The updateCallback method of the JadeRpsDataPumpIF interface determines whether the row is replicated in the relational database table and, for an object create, update, or load operation, enables you to manipulate the data in the row.

The parameters for this method are listed in the following table.

Parameter Description
tranID A 64-bit integer value that uniquely identifies a transaction
timestamp The timestamp of the journal record that describes the transaction
oid The object being created, updated, deleted, or loaded
operation An integer value identifying whether the object was created, updated, deleted, or loaded
tableName The name of the table being output
dropRowOperation A boolean value that determines whether the transaction is replicated in the relational database
outputRowList A dynamic object with one attribute for each column in the mapped relational table

The dropRowOperation io parameter has the value false by default. If you set it to true, the row is not replicated in the relational database.

For create, update, and load operations, an attribute is added to the outputRowList dynamic object parameter for each column in the mapped relational table. The attribute names are the column names.

The attribute values are populated with default values obtained from the JADE object, including values returned by user-defined column-mapping methods. The updateCallback method can interrogate attributes and access or change attribute values.

For more details and an example of the use of the updateCallback method, see "Implementing User-Defined Output Control", Chapter 2 of the JADE Synchronized Database Service (SDS) Administration Guide.