Oracle Forms Developer – Form Builder Reference, Volume 1

ISSUE_ROLLBACK built-in
Description
When called from an On-Rollback trigger, initiates the default Form Builder processing for rolling back
to the indicated savepoint. This built-in is included primarily for applications that will run against a non-
ORACLE data source.
Syntax
PROCEDURE ISSUE_ROLLBACK
(savepoint_name VARCHAR2);
Built-in Type unrestricted procedure
Enter Query Mode no
Parameters
savepoint name Name of the savepoint to which you want to rollback. A null
savepoint_name causes a full rollback.
ISSUE_ROLLBACK restrictions
Results are unpredictable when ISSUE_ROLLBACK is used outside an On-Rollback trigger or when
used with a savepoint other than that provided by a call to
GET_APPLICATION_PROPERTY(SAVEPOINT_NAME).
ISSUE_ROLLBACK examples
/*
** Built-in: ISSUE_ROLLBACK
** Example: Perform Form Builder standard Rollback processing.
** Decide whether to use this built-in based on a
** global flag setup at startup by the form.
** perhaps based on a parameter.
** trigger: On-Rollback
*/
DECLARE
sp_name VARCHAR2(80);
BEGIN
/*
** Get name of the savepoint to which Form Builder needs to
** rollback. (NULL = Full Rollback)
*/
sp_name := Get_Application_Property(SAVEPOINT_NAME);
/*
** Check the global flag we setup at form startup
*/
IF :Global.Using_Transactional_Triggers = ’TRUE’ THEN
User_Exit(’my_rollbk name=’||sp_name);
ELSE
Issue_Rollback(sp_name);
END IF;
END;
263