Userexit Return Codes
In order to control the program flow after returning from userexits at triggers, DataView evaluates the return code of a userexit function. You must provide that the userexits you create and install at the trigger produce the following return codes:
- Userexit executed without any errors -> return code = 0
- Userexit executed with errors -> return code other than 0
If the userexit function delivers a return code unequal to 0, this result will always be interpreted as an error by DataView. At some triggers this has the following results:
- Post_field-userexit:
- You cannot leave the field.
- Post_mask-userexit:
- You cannot close the mask.
- Edit_action-userexit:
- You cannot execute the desired edit operation for the row passed, i.e. DataView does not transfer the row passed into mask edit state.
- Pre_action-trigger:
- You cannot execute the desired transaction for the row passed, i.e. DataView cancels the transaction.
- In update- and insert mode program control is returned into mask edit state.
- In delete mode the return code is ignored, i.e. you cannot prevent the userexit from finally deleting the record.
For a detailed evaluation of userexit return codes in your own routines you can determine the return code of the userexit invoked last using the function dal_usx_ret.