RecyclingSettings Class [IIS 7 and higher]

Article
07/13/2012

Specifies recycling settings for worker processes.

Syntax

class RecyclingSettings : EmbeddedObject

Methods

This class contains no methods.

Properties

The following table lists the properties exposed by RecyclingSettings.

Name	Description
DisallowOverlappingRotation	A read/write boolean value. true if the Windows Process Activation Service (WAS) starts up another worker process to replace one that is still running; otherwise, false. The default is false. Set DisallowOverlappingRotation to true if the worker process loads any application code that does not support two worker processes at the same time.
DisallowRotationOnConfigChange	A read/write boolean value. true if WAS rotates worker processes in an application pool after the application pool configuration has changed; otherwise, false. The default is false. Application pool configuration changes do not affect worker processes that are already running. Set DisallowRotationOnConfigChange to true if the worker process loads any application code that does not support two worker processes at the same time.
LogEventOnRecycle	A read/write sint32 value that contains a mask that specifies which recycling events will be logged. The possible values are listed later in the Remarks section.
PeriodicRestart	A PeriodicRestartSettings object that specifies the conditions under which worker processes will be recycled.

Subclasses

This class contains no subclasses.

Remarks

Instances of this class are contained in the Recycling property of the ApplicationPool class and the ApplicationPoolElementDefaults class. ApplicationPoolElementDefaults is in turn exposed as the GlobalApplicationPoolDefaults property on the Server class.

The following table lists the possible values and the associated keywords and recycling events for the LogEventOnRecycle property. The defaults are 1 (Time), 8 (Memory), and 128 (PrivateMemory).

Value	Keyword	Recycling event
1	Time	The time specified in PeriodicRestartSettings.Time has elapsed since the last recycle. Enabled by default.
2	Requests	The number of requests specified in PeriodicRestartSettings.Requests has been reached.
4	Schedule	A scheduled recycle specified in PeriodicRestartSettings.Schedule has occurred.
8	Memory	A used or virtual memory limit specified in PeriodicRestartSettings.Memory has been reached. Enabled by default.
16	IsapiUnhealthy	An ISAPI has failed to respond to a health-monitoring request.
32	OnDemand	An administrator has manually triggered a recycle.
64	ConfigChange	Application pool configuration changes have been made.
128	PrivateMemory	Private memory has reached the amount specified in PeriodicRestartSettings.PrivateMemory. Enabled by default.

Inheritance Hierarchy

EmbeddedObject

RecyclingSettings

Requirements

Type	Description
Client	Requires IIS 7 on Windows Vista.
Server	Requires IIS 7 on Windows Server 2008.
Product	IIS 7
MOF file	WebAdministration.mof

Share via