sp_cycle_errorlog (Transact-SQL)

THIS TOPIC APPLIES TO:yesSQL Server (starting with 2008)noAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse

Closes the current error log file and cycles the error log extension numbers just like a server restart. The new error log contains version and copyright information and a line indicating that the new log has been created.

Topic link icon Transact-SQL Syntax Conventions

Syntax


sp_cycle_errorlog  

Return Code Values

0 (success) or 1 (failure)

Result Sets

None

Remarks

Every time SQL Server is started, the current error log is renamed to errorlog.1; errorlog.1 becomes errorlog.2, errorlog.2 becomes errorlog.3, and so on. sp_cycle_errorlog enables you to cycle the error log files without stopping and starting the server.

Permissions

Execute permissions for sp_cycle_errorlog are restricted to members of the sysadmin fixed server role.

Examples

The following example cycles the SQL Server error log.

EXEC sp_cycle_errorlog ;  
GO  

See Also

System Stored Procedures (Transact-SQL)
sp_cycle_agent_errorlog (Transact-SQL)