| Input Parameters | Significance |
| DtvLong idm | mask Id |
| DtvLong row | row position of the records in the mask |
| char drt |
dirty flag of the record: 0 = record "clean" + = record selected m = record modified |
| Output Parameters | Significance |
| no | - |
| Return Code | Significance |
| 0 | no error |
| 1 | mask is no list |
| 2 | wrong flag specification |
| 3 | wrong row position |
The record-dirty flag signals a change of the record contents after an edit operation in a list.
You should set the record-dirty flags after inserting a record in the mask in insert- or copy mode of mask edit state via a userexit, or when you used userexits to change the field contents of a record in update mode of mask edit state.
If the record-dirty flag is set, DataView writes the entire row entry for newly created records, and the fields with their field-dirty-flag set for updated records, back into the data base.
The record-dirty-flag needs only be set for modified records in lists. In forms DataView can clearly determine modified field contents via the field-dirty-flags.
In case of interactive manipulations of records or field contents DataView sets the record-dirty-flag automatically.