Oracle Forms Developer – Form Builder Reference, Volume 1

FORM_FATAL built-in
Description
Returns the outcome of the action most recently performed during the current Runform session.
Outcome Returned Value
success FALSE
failure FALSE
fatal error TRUE
Use FORM_FATAL to test the outcome of a built-in to determine further processing within any trigger.
To get the correct results, you must perform the test immediately after the action executes. That is,
another action should not occur prior to the test.
Note: "Another action" includes both built-ins and PL/SQL assignment statements. If another action
occurs, FORM_FATAL may not reflect the status of the built-in you are testing, but of the other, more
recently executed action. A more accurate technique is, for example, when performing a
COMMIT_FORM, to check that the SYSTEM.FORM_STATUS variable is set to ’QUERY’ after the
operation is done.
Syntax
FUNCTION FORM_FATAL;
Built-in Type unrestricted function
Return Type:
BOOLEAN
Enter Query Mode yes
Parameters
none
FORM_FATAL examples
146
/*
** Built-in: FORM_FATAL
** Example: Check whether the most-recently executed built-in
** had a fatal error.
*/
BEGIN
User_Exit(’Calculate_Line_Integral control.start
control.stop’);
/*
** If the user exit code returned a fatal error, print a
** message and stop executing this trigger.