sp-cycle-errorlog-transact-sql.md

title	sp_cycle_errorlog (Transact-SQL) | Microsoft Docs
ms.custom
ms.date	03/14/2017
ms.prod	sql
ms.prod_service	database-engine
ms.reviewer
ms.technology	system-objects
ms.topic	language-reference
f1_keywords	sp_cycle_errorlog_TSQL sp_cycle_errorlog
dev_langs	TSQL
helpviewer_keywords	sp_cycle_errorlog
ms.assetid	61a12cbf-78a3-4052-8604-3b29d07573fd
author	stevestein
ms.author	sstein

sp_cycle_errorlog (Transact-SQL)

[!INCLUDEtsql-appliesto-ss2008-xxxx-xxxx-xxx-md]

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.

Transact-SQL Syntax Conventions

Syntax

  
sp_cycle_errorlog  

Return Code Values

0 (success) or 1 (failure)

Result Sets

None

Remarks

Every time [!INCLUDEssNoVersion] 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 [!INCLUDEssNoVersion] error log.

EXEC sp_cycle_errorlog ;  
GO  

See Also

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