asp.net.ph

Skip Navigation Links

<processModel> Section

ASP.NET Syntax   ASP.NET Configuration Sections


Configures the ASP.NET process model settings on an Internet Information Services ( IIS ) Web server.

<processModel
   enable = "true | false"
   timeout = "mins" 
   idleTimeout = "mins"
   shutdownTimeout = "hrs:mins:secs"
   requestLimit = "num"
   requestQueueLimit = "num"
   memoryLimit = "percent"
   cpuMask = "num"
   webGarden = "true | false"
   userName = "username"
   password = "password" />

The <processModel> tag supports eleven attributes.

Attribute Option Description
enable     Specifies whether the process model is enabled.
    true Indicates that the process model is enabled.
    false Indicates that the process model is not enabled.
timeout     Specifies the number of minutes until ASP.NET launches a new worker process to take the place of the current one. The default is infinite.
idleTimeout     Specifies the number of minutes of inactivity until ASP.NET automatically shuts down the worker process. The default is infinite.
shutdownTimeout     Specifies the number of minutes allowed for the worker process to shut itself down. When the time out expires, ASP.NET shuts down the worker process. The time is expressed in hr:min:sec format, so 0:00:05 is 5 seconds. The default is 5 seconds, or 0:00:05.
requestLimit     Specifies the number of requests allowed before ASP.NET automatically launches a new worker process to take the place of the current one. The default is infinite.
requestQueueLimit     Specifies the number of requests allowed in the queue before ASP.NET begins returning "503 – Server Too Busy" errors to new requests. The default is 5000.
memoryLimit     Specifies the maximum allowed memory size, as a percentage of total system memory that the worker process can consume before ASP.NET launches a new process and reassigns existing requests. The default is 40%.
cpuMask     Specifies which processors on a multiprocessor server are eligible to run ASP.NET processes. The cpuMask value specifies a bit pattern that indicates the CPUs eligible to run ASP.NET threads. For example, the cpuMask value 13 represents the bit pattern 1101. On a computer with four CPUs, this indicates that ASP.NET processes can be scheduled on CPUs 0, 2, and 3, but not on CPU 1. ASP.NET launches one worker process for each eligible CPU. If the webGarden attribute ( see below ) is set to false, the cpuMask limits worker processes to the number of eligible CPUs. ( The maximum allowed number of worker processes is equal to the number of CPUs ). By default all CPUs are enabled and ASP.NET launches one process for each CPU.
webGarden     Controls CPU affinity when used in conjunction with the cpuMask attribute. ( A multiprocessor Web server is called a Web garden ).
    true Indicates that CPU usage is scheduled by the Windows operating system. The default is true.
    false Indicates that the cpuMask attribute is used to specify which CPUs are eligible to run ASP.NET processes.
userName     If present, this attribute runs the worker process with a different Windows identity than the default process. By default, the process runs as the IIS identity ( System ). If valid credentials are presented in the username and password attributes, the process is run with the given account. The other special value is "Machine", which, when used in conjunction with autogenerate as the password, runs the process as an unprivileged ASP.NET service account. For more information on this feature, please refer to the ASP.NET Hosting specification and DCR73790.doc ( interim ). The default value is "System".
password     If present ( and in conjunction with a user name ), this attribute causes the worker process to run with the configured Windows identity. The default is "autogenerate". See userName for more details on the special names "System" and "Machine", which do not require a password.

Remarks

The managed code configuration system does not read the <processModel> configuration settings. Instead, they are read directly by the aspnet_isapi unmanaged DLL.

Syntax Example

The following example specifies several processModel configuration settings.

<configuration>
   <system.web>
      <processModel
         enable = "true"
         timeout = "15"
         idleTimeout = "25"
         shutdownTimeout = "5"
         requestLimit = "1000"
         requestQueueLimit = "500"
         memoryLimit = "20"
         webGarden = "true" />
   </system.web>
</configuration>
See Also

ASP.NET Configuration   ProcessModelSection Class



© 2025 Reynald Nuñez and asp.net.ph. All rights reserved.

If you have any question, comment or suggestion
about this site, please send us a note