POOL

The POOL element sets the limitations regarding the number of Virtual Machines (DVMs) that are attached to a Web Service.

You specify four values within a POOL element:

The number of DVMs to start when the GAS starts
The minimum number of DVMs to have alive while the GAS is running
The maximum number of DVMs to have alive while the GAS is running.
The maximum number of requests a DVM can handle before being stopped by the pool.

Note: The POOL element is only available for Web Services.

Syntax

<POOL>
 [<START> startValue </START>] 
 [<MIN_AVAILABLE> minValue </MIN_AVAILABLE>]
 [<MAX_AVAILABLE> maxValue </MAX_AVAILABLE>] 
 [<MAX_REQUESTS_PER_DVM> maxRequests </MAX_REQUESTS_PER_DVM>]
</POOL>

Child elements

The POOL element may contain the following child elements:

Zero or one START elements.
Zero or one MIN_AVAILABLE element.
Zero or one MAX_AVAILABLE element.
Zero or one MAX_REQUESTS_PER_DVM element.

Example

<POOL>
  <START>5</START>
  <MIN_AVAILABLE>3</MIN_AVAILABLE>
  <MAX_AVAILABLE>10</MAX_AVAILABLE>
  <MAX_REQUESTS_PER_DVM>1</MAX_REQUESTS_PER_DVM>
</POOL>

In this example, 5 DVMs are started to service the Web service when the GAS starts; the number can fall as low as 3 DVMs or rise as high as 10 DVMs. For more information on setting service pool elements, see the Service Pool section of the GAS Architecture topic.

Parent elements

This element is a child of one of the following elements: