A script-enabled browser is required for this page to function properly.

ISSUE_ROLLBACK Built-in

Description

When called from an On-Rollback trigger, initiates the default Oracle Forms 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 Oracle Forms 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 the name of the savepoint to which Oracle Forms 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;