POOL

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

Syntax

<POOL>
  [<START>...</START>] 
  [<MIN_AVAILABLE>...</MIN_AVAILABLE>]
  [<MAX_AVAILABLE>...</MAX_AVAILABLE>] 
  [<MAX_REQUESTS_PER_DVM>...</MAX_REQUESTS_PER_DVM>]
</POOL>

Child elements

The POOL element may contain the following child elements:

  1. Zero or one START elements.
  2. Zero or one MIN_AVAILABLE element.
  3. Zero or one MAX_AVAILABLE element.
  4. Zero or one MAX_REQUESTS_PER_DVM element.

Usage

You use this element to configure how the Web service is managed. 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.

Pool 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 Pools topic .

Parent elements

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