Updating an Edition

The jomUpdateEdition call, shown in the following example, forces an increment in the edition for the specified object, regardless of whether it has been modified.

int jomUpdateEdition(const DskHandle   *pHandle,
                     const DskObjectId *pOid,
                     UInt32            lineNo)

The JADE Object Manager automatically updates the edition of an object whenever it is modified.

This call can be used by your application to indicate a change in the edition of the object in which the application may be interested but that has not been caused by a direct updating of that object. For example, if a dictionary is being used to obtain the contents of a list and the name of an object in the list changes, this does not cause an update to the dictionary as such.

However, your application may mark the edition of the dictionary as having changed, in order to easily detect the need to update the list.

If this call is issued within transaction state, the object must be locked manually or automatically.

The parameters for this call are described in the following subsections.