@(#)jonas-connector_4_4.xsd 14/11/03 ... The instance documents may indicate the published version of the schema using the xsi:schemaLocation attribute for the Jonas namespace with the following location: http://www.objectweb.org/jonas/ns/jonas-connector_4_4.xsd ]]> This is the root element of the JOnAS specific Connector deployment descriptor. This group defines: - a jonas idGroup - a sequence of name/value pairs This group defines: - a optional element id - a optional element description - a mandatory jndi-name The id element defines an identifier for this element that matches the id field in the ra.xml The jndi-name element defines the name that will map to the ConnectionFactory object stored in JNDI. The jdbc-conn-params element is the root element for JDBC Connection specific values for this Resource Adapter. The jdbc-check-level element identifies the level of checking that will be done for a connection. The values are 0 for no checking, 1 to validate that the connection is not closed before returning it and greater than 1 to send the jdbc-test-statement. The jdbc-test-statement element identifies the test statement that will be sent on the connection if the jdbc-check-level is set accordingly. Each jonas-activationspec element specifies a different inbound activationspec configuration for the deployed resource adapter. This element contains the jndi-name and the required config property values. The defaultAS element defines if this activationSpec can be used as a default for the container to attach MDBs. A value of true will add this to a list of defaults wherein the first deployed will be used if the destination is not configured correctly. (Default value false) Each jonas-adminobject element specifies a different administered object configuration for the deployed resource adapter. This element contains the jndi-name and the required config property values. Each jonas-config-property element specifies a configuration property name and value that maps to an ra.xml config-entry element with the corresponding name. Each jonas-connection-definition element specifies a different outbound connection factory configuration for the deployed connection definition of the resource adapter. This element contains the jndi-name and different configuration information (logging parameters, pooling parameters, config property values) that will override the global defaults specified The log-enabled element defines if a log topic should be set for the ManagedConnectionFactory. A value true will enable the logging mechanism and a value false will disable it. (Default value false) The log-topic element defines the log topic that will be used to write log messages for this rar file. This will work in conjunction with log configuration facility that can define where the log will be written. (Default value: org.objectweb.jonas.jca) The pool-params element is the root element for Managed Connection Pool specific values for this Resource Adapter. The jdbc-conn-params is for JDBC Connection specific values for this Resource Adapter. The jonas-connectorType defines the root element of the JOnAS specific deployment descriptor for the deployed resource adapter. This element includes different configuration information - associated rar link, pooling parameters, config property values. The jndi-name element defines the name that will map to the ConnectionFactory object stored in JNDI. The rarlink element defines an association to a deployed Resource Adapter via the jndi-name. This will result in the config values from the name specified to be used as default values and then overridden by the pool and configuration values for the Resource Adapter being deployed. The native-lib element defines the path that will be used to write the native libraries included in the rar file. The log-enabled element defines if a log topic should be set for the ManagedConnectionFactory. A value true will enable the logging mechanism and a value false will disable it. (Default value false) The log-topic element defines the log topic that will be used to write log messages for this rar file. This will work in conjunction with log configuration facility that can define where the log will be written. (Default value: org.objectweb.jonas.jca) The pool-params element is the root element for Managed Connection Pool specific values for this Resource Adapter. The jdbc-conn-params is for JDBC Connection specific values for this Resource Adapter. The tm-params is for JOTM properties. The jonas-securitymappingType defines the JOnAS specific mapping from a JOnAS principal name to an EIS user and password. The pool-params element is the root element for Managed Connection Pool specific values for this Resource Adapter. The pool-init element identifies the initial number of managed connections to create during deployment. (Default value: 0) The pool-min element identifies the minimum number of managed connections to keep in the pool. (Default value: 0) The pool-max element identifies the maximun number of managed connections to keep in the pool. An Exception will be thrown to the caller if an attempt is made to create a managed connection above this limit. The pool-max-age element identifies the maximum number of seconds that the managed connection will be kept in the pool. The pool-max-age-minutes element identifies the maximum number of minutes that the managed connection will be kept in the pool. The pstmt-max element identifies the maximum number of preparedStatement objects to keep in the pool. A PreparedStatment will not be cached if an attempt is made to get a PrepardedStatement above this limit. Value of 0 is unlimited,-1 disables the cache. The pool-max-opentime element identifies the maximum number of minutes that the managed connection can be left busy. There must be care taken when specifying this value as a long running application can have the connection taken away from it if the time between the initial opening and a close call exceeds the value specified. Value of 0 is unlimited. The pool-max-waiters element identifies the maximum number of waiters for a managed connection. Default value is 0. The pool-max-waittime element identifies the maximum number of seconds that a waiter will wait for a managed connection. Default value is 0. The pool-sampling-period element identifies the number of seconds that will occur between statistics samplings of the pool. Default is 30 seconds. The security-entryType specifies a principalName that is mapped to the specified user and password. Each tm-config-property element specifies a transaction manager configuration property name and value. The tm-params element is the root element for Transaction Manager specific values for this Resource Adapter.