sp_forceonline_db

Description

Provides access to all the pages in a database that were previously marked suspect by recovery.

Syntax

sp_forceonline_db dbname, 
	{"sa_on" | "sa_off" | "all_users"}

Parameters

dbname: is the name of the database to be brought online.

sa_on: allows only users with the sa_role access to the specified page.

sa_off: revokes access privileges created by a previous invocation of sp_forceonline_page with sa_on.

all users: allows all users access to the specified page.

Examples

Example 1

Allows the system administrator access to all suspect pages in the pubs2 database:

sp_forceonline_db pubs2, "sa_on"

Example 2

Revokes access to all suspect pages in the pubs2 database from the system administrator. Now, no one can access the suspect pages in pubs2:

sp_forceonline_db pubs2, "sa_off"

Example 3

Allows all users access to all pages in the pubs2 database:

sp_forceonline_db pubs2, "all_users"

Usage

A page that is forced online is not necessarily repaired. Corrupt pages can also be forced online. Adaptive Server does not perform any consistency checks on pages that are forced online.

sp_forceonline_page with all users cannot be reversed. When pages have been brought online for all users, you cannot take them offline again.
sp_forceonline_db cannot be used in a transaction.
To bring only specific offline pages online, use sp_forceonline_page.

Permissions

Only a system administrator can execute sp_forceonline_db.

Auditing

Values in event and extrainfo columns from the sysaudits table are:

Event	Audit option	Command or access audited	Information in extrainfo
38	exec_procedure	Execution of a procedure	Roles – Current active roles Keywords or options – NULL Previous value – NULL Current value – NULL Other information – All input parameters Proxy information – Original login name, if set proxy in effect