GET-CHANGES( ) method

Loads an empty ProDataSet object with changed rows from either a single temp-table or all temp-tables in another ProDataSet object.

Syntax
`change-handle`:GET-CHANGES(`original-handle` [, `get-parent-mode` ] )

A handle to the ProDataSet object or ProDataSet temp-table buffer to receive the changed rows.

A handle to the source ProDataSet object or ProDataSet temp-table buffer that contains the changed rows.

An optional logical expression where TRUE indicates that the AVM get changed rows in a get-parent mode.

When TRUE, the AVM includes the parent row of each changed child row in the ProDataSet object or ProDataSet temp-table (if any). If there is more than one parent level above the changed row, the AVM includes the parent row at each level. In this case, the parent temp-tables must have a unique primary index that the AVM can use to find the corresponding rows. If a parent row has changed, the AVM copies both the before-image and after-image of the parent row. If a parent row has not changed, there will be no before-image of the parent row, and its change state (ROW-STATE) will be ROW-UNMODIFIED (0) or the Unknown value (?).

Note: When the relation mode of a parent is REPOSITION, no attempt is made to find that parent.

When FALSE, the AVM does not include parent rows. The default value is FALSE.

The ProDataSet objects associated with the change-handle and original-handle must have the same number of temp-table buffers, and the definition of the corresponding temp-tables must match (that is, in the number of columns, data types, and so on).

Once the changed rows are loaded, the AVM sets the ORIGIN-HANDLE attribute on the temp-tables in the receiving ProDataSet object to the corresponding temp-tables in the original source ProDataSet object. The AVM also sets the ORIGIN-ROWID attribute on each of the before-image table rows created in the receiving ProDataSet object to the ROWID of the corresponding before-image table row in the original source temp-table. The MERGE-CHANGES( ) method and MERGE-ROW-CHANGES( ) method uses these values to match up temp-tables and temp-table rows during a merge operation.