XML DTD - jrun-ra.dtd
Schema has:
 21 element definitions and 0 element attribute definitions.
Possible root elements: < jrun-connectionfactory >

Element list

Element jrun-connectionfactory
diagram element image
description The jrun-connectionfactory element is the root element for the jrun-specific resource adapter descriptor. It can contain multiple instances of the managedconnectionfactory-instance element.
attributes
uses managedconnectionfactory-class  managedconnectionfactory-instance 
content a sequence of elements
occurrence required (default)

Element managedconnectionfactory-class
diagram element image
description The managedconnectionfactory-instance element specifies the fully qualified name of the class that implements the ManagedConnectionFactory interface

Used in: jrun-connectionfactory

attributes
uses
content character data
occurrence

Element managedconnectionfactory-instance
diagram element image
description The managedconnectionFactory-instance element contains the properties specific to an instance of the managedconnectionfactory. Each instance of the mcf is identified by a unique jndi-name along with the managedconnectionfactory class, security information, config properties and connection-pool information
attributes
uses description  jndi-name  config-property  security-info  connection-pool 
content a sequence of elements
occurrence required (default)

Element jndi-name
diagram element image
description The jndi-name element contains a unique name that identifies this managedconnectionfactory-instance.

Used in: managedconnectionfactory-instance

attributes
uses
content character data
occurrence

Element config-property
diagram element image
description The element config-property element contains a declaration of a single configuration property for a ManagedConnectionFactory instance. Each ManagedConnectionFactory instance creates connections to a specific EIS instance based on the properties configured on the ManagedConnectionFactory instance. The configurable properties are specified only once in the deployment descriptor, even though a resource adapter can be used to configure multiple ManagedConnnection- Factory instances (that create connections to different instances of the same EIS). The config-property entries in this descriptor (JRun-specific descriptor) are used to override those in the generic deployment descriptor. The declaration consists of an optional description, name, type and an optional value of the configuration property. If the resource adapter provider does not specify a value then the deployer is responsible for providing a valid value for a configuration property. Any bounds or well-defined values of properties should be described in the description element.

Used in: resourceadapter

attributes
uses description  config-property-name  config-property-type  config-property-value 
content a sequence of elements
occurrence required (default)

Element config-property-name
diagram element image
description The config-property-name element contains the name of a configuration property. The connector architecture defines a set of well-defined properties all of type java.lang.String. These are as follows: <config-property-name>ServerName</config-property-name> <config-property-name>PortNumber</config-property-name> <config-property-name>UserName</config-property-name> <config-property-name>Password</config-property-name> <config-property-name>ConnectionURL</config-property-name> A resource adapter provider can extend this property set to include properties specific to the resource adapter and its underlying EIS.

Used in: config-property

Example:
<config-property-name>ServerName</config-property-name>

attributes
uses
content character data
occurrence

Element config-property-type
diagram element image
description The config-property-type element contains the fully qualified Java type of a configuration property as required by ManagedConnection- Factory instance. The following are the legal values of config-property-type: java.lang.Boolean, java.lang.String, java.lang.Integer, java.lang.Double, java.lang.Byte, java.lang.Short, java.lang.Long, java.lang.Float, java.lang.Character

Used in: config-property

Example:
<config-property-type>java.lang.String</config-property-type>

attributes
uses
content character data
occurrence

Element config-property-value
diagram element image
description The config-property-value element contains the value of a configuration entry.

Used in: config-property

Example:
<config-property-value>WombatServer</config-property-value>

attributes
uses
content character data
occurrence

Element security-info
diagram element image
description The security-info element specifies the username and password that the JRun server will pass to the resource adapter when getting a ManagedConnection to the EIS.

Used in: managedconnectionfactory-instance

attributes
uses description  username  password 
content a sequence of elements
occurrence required (default)

Element username
diagram element image
description The username element specifies the username that the JRun server will pass to the resource adapter.

Used in: security-info

attributes
uses
content character data
occurrence

Element password
diagram element image
description The password element specifies the username that the JRun server will pass to the resource adapter.

Used in: security-info

attributes
uses
content character data
occurrence

Element connection-pool
diagram element image
description The connection-pool element contains elements that define a resource adapter connection pool.

Used in: managedconnectionfactory-instance

attributes
uses description  name  minimumSize  maximumSize  connectionTimeout  userTimeout  skimmerFrequency  shrinkBy  debugging 
content a sequence of elements
occurrence required (default)

Element name
diagram element image
description The name element contains the name of a connection pool.

Used in: connection-pool

attributes
uses
content character data
occurrence

Element minimumSize
diagram element image
description The minimumSize element specifies the minimum size of a connection pool.

Used in: connection-pool

attributes
uses
content character data
occurrence

Element maximumSize
diagram element image
description The maximumSize element specifies the maximum size of a connection pool.

Used in: connection-pool

Used in: connection-pool

attributes
uses
content character data
occurrence

Element connectionTimeout
diagram element image
description The connectionTimeout element specifies the time interval, in seconds, after which a connection sitting in the pool should be timed out.

Used in: connection-pool

attributes
uses
content character data
occurrence

Element description
diagram element image
description The description element describes a resource adapter connection pool.

Used in:

attributes
uses
content character data
occurrence

Element userTimeout
diagram element image
description The userTimeout element specifies the time interval, in seconds, after which an active connection (whether being used or not) will be cleaned up and checked back into the pool. This helps cases where, due to security issues or other factors, a connection should not be valid after a particular interval of time.

Used in: connection-pool

attributes
uses
content character data
occurrence

Element skimmerFrequency
diagram element image
description The skimmerFrequency element defines how often, in seconds, you want timed-out objects cleaned up.

Used in: connection-pool

attributes
uses
content character data
occurrence

Element shrinkBy
diagram element image
description The shrinkBy element specifies the maximum number of connections to be removed from the pool when they time out. This eliminates a scenario where you have 20 connections timed out, cleaned up by the timeOut thread and in the next minute, you get a rush of new requests forcing you to create new connections. For example, in a given situation, the shrinkBy value is 5 and the number of timed-out connections sitting in the pool is 9. If the objectTimeout value is 60 seconds, after 60 seconds the connections in the pool will be shrunk by 5 to 4. This shrinking will happen again and again until the minimumSize is reached.

Used in: connection-pool

attributes
uses
content character data
occurrence

Element debugging
diagram element image
description The debugging element specifies whether informational (not production related) messages should be logged.

Used in: connection-pool

attributes
uses
content character data
occurrence