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 JGAS starts

  • The minimum number of DVMs to have alive while the JGAS is running

  • The maximum number of DVMs to have alive while the JGAS 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 JGAS 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 Services Pool topic in the GAS Architecture section of the Genero Application Server User Guide.

Parent elements

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