Product Information > JADE Error Messages and System Messages > 3000 through 3199 - Database Engine Errors > 3015 - Database role change in progress

3015   Database role change in progress

Cause

This error occurs when a Synchronized Database Service (SDS) administration method of the JadeDatabaseAdmin class is invoked and a database role change (or takeover operation) is in progress.

This error can also be returned if a user process running on a primary system attempts to initiate a persistent transaction while a role change is in progress.

Action

To avoid this error in an SDS administration application, arm an exception handler to deal with the possibility of this error being raised. Most query-related administration methods can be called while a database is changing roles, while most commands result in this error.

To avoid this error in user applications, shut down updating applications running the primary system before initiating the takeover operation or arm an exception handler to deal with the error. Note that updating applications running on a primary system need to revert to an inquiry-only mode when the role change is complete. Applications can subscribe to the SDS_RoleChangeEvent event notified on the system instance, in order to be informed of database role changes.