sp_forceonline_page

Description

Provides access to pages previously marked suspect by recovery.

Syntax

sp_forceonline_page dbname, pgid, 
	{"sa_on" | "sa_off" | "all_users"}

Parameters

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

pgid: is the page identifier of the page being 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 a system administrator access to page 312 in the pubs2 database:

sp_forceonline_page pubs2, 312, "sa_on"

Example 2

Revokes access to page 312 in the pubs2 database from the system administrator. Now, no one has access to this page:

sp_forceonline_page pubs2, 312, "sa_off"

Example 3

Allows all users access to page 312 in the pubs2 database:

sp_forceonline_page pubs2, 312, "all_users"

Usage

sp_forceonline_page with all_users cannot be reversed. When pages have been brought online for all users, you cannot take them offline again.

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 cannot be used in a transaction.

sp_forceonline_page works only for databases in which the recovery fault isolation mode is "page." Use sp_setsuspect_granularity to display the recovery fault isolation mode for a database.
To bring all of a database’s offline pages online in a single command, use sp_forceonline_db.

Permissions

The permission checks for sp_forceonline_page differ based on your granular permissions settings.

Granular permissions enabled	With granular permissions enabled, you must be the database owner or a user with own database privilege.
Granular permissions disabled	With granular permissions disabled, you must be a user with sa_role.

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