BEA Home | Events | Solutions | Partners | Products | Services | Download | Developer Center | WebSUPPORT
| WebLogic Server Doc Home | Console Online Help | Previous Topic | Next Topic | Contents | Index | View as PDF

BEA WebLogic J2EE Connector Architecture Attribute Descriptions

ra.xml Attributes

ra.xml Deployment Descriptor Editor Attributes

Attribute | Description | Range of Values | Default Value
--- | --- | --- | ---
Connector Description | This optional element specifies any resource adapter specific requirement for the support of security contract and authentication mechanism. | String | NULL
Connector Display Name | This element contains a short name that is intended to be displayed by tools. The display name need not be unique. | String | NULL
Small Icon | This element contains the name of a file containing a small (16 x 16) icon image. The file name is a relative path within the resource adapter's rar file. The image may be either in the JPEG or GIF format. | JPEG GIF |
Large Icon | This element contains the name of a file containing a large (32 x 32) icon image. The file name is a relative path within the resource adapter's rar file. The image may be either in the JPEG or GIF format. | JPEG GIF |
Connector Vendor Name | This element specifies the name of resource adapter provider vendor. | String | NULL
Connector Spec Version | This element specifies the version of the connector architecture specification that is supported by this resource adapter. This information enables deployer to configure the resource adapter to support deployment and runtime requirements of the corresponding connector architecture specification. | String | NULL
Connector Eis Type | This element contains information about the type of the EIS. For example, the type of an EIS can be product name of EIS independent of any version info. | String | NULL
Connector Version | This element specifies a string-based version of the resource adapter from the resource adapter provider. | String | NULL
License Description | This element is used to provide text describing the license element. This is an optional element. | String | NULL
License Required | This element specifies whether a license is required to deploy and use the resource adapter. | True False | NULL
Resourceadapter Managedconnectionfactory Class | This element specifies the fully qualified name of the Java class that implements the javax.resource.spi.Managed- ConnectionFactory interface. | String | NULL
Resourceadapter Connectionfactory Interface | This element specifies the fully-qualified name of the ConnectionFactory interface supported by the resource adapter. | String | NULL
Resourceadapter Connectionfactory Impl Class | This element specifies the fully-qualified name of the ConnectionFactory class that implements resource adapter specific ConnectionFactory interface. | String | NULL
Resourceadapter Connection Interface | This element specifies the fully-qualified name of the Connection interface supported by the resource adapter. | String | NULL
Resourceadapter Connection Impl Class | This element specifies the fully-qualified name of the Connection class that implements resource adapter specific Connection interface. | String | NULL
Transaction Support | This element specifies the level of transaction support provided by the resource adapter. | NoTransaction LocalTransaction XATransaction | NULL
Reauthentication Support | This element specifies whether the resource adapter implementation supports re-authentication of existing Managed-Connection instance. | True False | NULL

ra.xml Config Properties

Attribute | Description | Range of Values | Default Value
--- | --- | --- | ---
Description | This element is used to describe any bounds or well-defined values of properties. | String | NULL
Config Property Name | This element contains the name of a configuration property. The connector architecture defines a set of well-defined properties all of type java.lang.String. A resource adapter provider can extend this property set to include properties specific to the resource adapter and its underlying EIS. | ServerName PortNumber UserName Password ConnectionURL | NULL
Config Property Type | This element contains the fully qualified Java type of a configuration property as required by ManagedConnection-Factory instance. | 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 | NULL
Config Property Value | This element contains the value of a configuration entry. | Various | NULL

ra.xml Authentication Mechanisms

ra.xml Authentication Mechanisms

Attribute | Description | Range of Values | Default Value
--- | --- | --- | ---
Description | This element is used to provide text describing the authentication mechanism type. | String | NULL
Authentication Mechanism Type | This element specifies an authentication mechanism supported by the resource adapter. Note that this support is for the resource adapter and not for the underlying EIS instance. The optional description specifies any resource adapter specific requirement for the support of security contract and authentication mechanism. Note that BasicPassword mechanism type should support the javax.resource.spi.security.PasswordCredential interface. The Kerbv5 mechanism type should support the javax.resource.spi.security.GenericCredential interface. | String | NULL
Credential Interface | This element specifies the interface that the resource adapter implementation supports for the representation of the credentials. This element should be used by application server to find out the Credential interface it should use as part of the security contract. | String | NULL

ra.xml Security Permissions

Attribute | Description | Range of Values | Default Value
--- | --- | --- | ---
Description | This element is used to provide text describing the security permission. | String | NULL
Security Permission Spec | This element specifies a security permission based on the Security policy file syntax. | String | NULL

weblogic-ra.xml Attributes

weblogic-ra.xml Deployment Descriptor Editor Attributes

Attribute | Description | Range of Values | Default Value
--- | --- | --- | ---
Description | This element is used to provide text describing the parent element. The description element should include any information that the deployer wants to describe about the deployed Connection Factory. This is an optional element. | String | NULL
Connection Factory Name | This element defines that logical name that will be associated with this specific deployment of the Resource Adapter and its corresponding Connection Factory. The value of connection-factory-name can be used in other deployed Resource Adapters via the ra-link-ref element. This will allow multiple deployed Connection Factories to utilize a common deployed Resource Adapter, as well as share configuration specifications. This is a required element. | String | NULL
Jndi Name | This element defines the name that will be used to bind the Connection Factory Object into the Weblogic JNDI Namespace. Client EJBs and Servlets will use this same JNDI in their defined Reference Desciptor elements of the weblogic specific deployment descriptors. This is a required element. | String | NULL
Initial Capacity | This element identifies the initial number of managed connections which the Weblogic Server will attempt to obtain during deployment. This is an optional element. Failure to specify this value will result in Weblogic using its defined default value. | Integer | 1
Max Capacity | This element identifies the maximum number of managed connections which the Weblogic Server will allow. Requests for newly allocated managed connections beyond this limit will result in a ResourceAllocationException being returned to the caller. This is an optional element. Failure to specify this value will result in Weblogic using its defined default value. | Integer | 10
Capacity Increment | This element identifies the number of additional managed connections which the Weblogic Server will attempt to obtain during resizing of the maintained connection pool. This is an optional element. Failure to specify this value will result in Weblogic using its defined default value. | Integer | 1
Shrinking Enabled | This element indicates whether or not the Connection Pool should have unused Managed Connections reclaimed as a means to control system resources. This is an optional element. Failure to specify this value will result in Weblogic using its defined default value. | True False | True
Shrink Period Minutes | This element identifies the amount of time the Connection Pool Management will wait between attempts to reclaim unused Managed Connections. This is an optional element. Failure to specify this value will result in Weblogic using its defined default value. | Integer | 1
Ra Link Ref | This element allows for the logical association of multiple deployed Connection Factories with a single deployed Resource Adapter. The specification of this element with a value identifying a separately deployed Connection Factory will result in this newly deployed Connection Factory sharing the Resource Adapter which had been deployed with the referenced Connection Factory. In addition, any values defined in the referred Connection Factories deployment will be inherited by this newly deployed Connection Factory unless specified. This is an optional element. | String | NULL
Native Lib Dir | This element identifies the directory location to be used for all native libraries present in this resource adapter deployment. As part of deployment processing, all encountered native libraries will be copied to the location specified. It is the responsibility of the Administrator to perform the necessary platform actions such that these libraries will be found during Weblogic Server runtime. This is a required element IF native libraries are present. | String | NULL
Logging Enabled | This element indicates whether or not the log writer is set for either the ManagedConnectionFactory or ManagedConnection. If this element is set to true, output generated from either the ManagedConnectionFactory or ManagedConnection will be sent to the file specified by the log-filename element. This is an optional element. Failure to specify this value will result in Weblogic using its defined default value. | True False | False
Log Filename | This element specifies the name of the log file which output generated from either the ManagedConnectionFactory or a ManagedConnection are sent. The full address of the filename is required. This is an optional element. | String | NULL

weblogic-ra.xml Config Properties

Attribute | Description | Range of Values | Default Value
--- | --- | --- | ---
Description | This element is used to provide text describing the config properties. | String | NULL
Config Property Name | This element identifies a name that corresponds to an ra.xml config-entry element with the corresponding config-property-name. | String | NULL
Config Property Type | This element identifies a type that corresponds to an ra.xml config-entry element with the corresponding config-property-name. | String | NULL
Config Property Value | This element identifies a value that corresponds to an ra.xml config-entry element with the corresponding config-property-name. |  | NULL

weblogic-ra.xml Security Principal Map Entries

Attribute | Description | Range of Values | Default Value
--- | --- | --- | ---
Initiating Principal | The security-principal-map element provides a mechanism to define appropriate resource-principal values for resource adapter and EIS authorization processing, based upon the known WebLogic run time initiating-principal. This map allows for the specification of a defined set of initiating principals and the corresponding resource principal's username and password that should be used when allocating managed connections and connection handles. | 0 or More |
Resource Username | This element specifies the username identified with the resource-principal. Used when allocating managed connections and connection handles. |  |
Resource Userpassword | This element specifies the password identified with the resource-principal. Used when allocating managed connections and connection handles. | String | NULL

Copyright © 2001 BEA Systems, Inc. All rights reserved. Required browser: Netscape 4.0 or higher, or Microsoft Internet Explorer 4.0 or higher.