Creates a pool for a given Javelin connector.

A Pool is a set of preloaded Convertigo contexts on a defined connector.
When the Convertigo engine starts, the pool’s contexts are loaded, executing a starting transaction defined in the properties.
Thanks to the execution of the starting transaction, the pool’s contexts are led to a steady state.
Notes:

• The steady state can be defined as a particular screen class that has to be reached by the connector (Javelin screen class).
• Defining a pool is useful for performance optimization, in that it allows accessing to pre-established and advanced connections with the host.

Property Type Category Description
Comment String standard Describes the object comment to include in the documentation report.
This property generally contains an explanation about the object.
Connection address String standard Replaces the connection address (optional).
If defined, this property overrides the connection address set as connector parameter for the loaded contexts.
Initial screen class String standard Defines the steady state screen class.
On connectors for which it applies (Javelin connector), this property allows to define the steady state screen class.
This initial screen class has several implications:

• it’s the screen class that must be reached by the context thanks to the starting transaction execution,
• the transactions that are executed thereafter on one of the pool’s contexts must lead back to this screen class to let the context in steady state for a further use.

If you want to realize non-atomic calls, i.e. call several successive transactions on the same context without restoring the context’s steady state between calls, it is possible to lock the context by setting the context.lockPooledContext property to true.
Note: be sure to reset the context.lockPooledContext property to false at the end of your non atomic calls, otherwise this locked context will remain unavailable.
Number of contexts int standard Defines the size of the pool.
This property defines the number of contexts to load for this pool.
Starting transaction String standard Defines the transaction to be automatically executed when loading the Convertigo context.
This transaction must lead the connector to a steady state (a particular screen class).
Starting transaction variables XMLVector standard Defines the starting transaction variables.
This property allows to define a list of variables that will be sent to the starting transaction executed on each context.
For each variable, you have to describe three properties:

Context number: number between 1 and the size of the pool (defined in the the Number of contexts property). The variable will be sent with the associated value only for this context number. To define a variable for all loaded contexts, this property can take the following value: *.
Parameter name: name of the variable.
Parameter value:value of the variable.

Note: A new variable can be added to the list using the blue keyboard icon. The variables defined in the list can be ordered using the arrow up and arrow down buttons, or deleted using the red cross icon.