Use this page to specify settings for a connection factory.
Specifies the scope of the resource adapter that connects applications to an enterprise information system (EIS) through this connection factory. Only applications that are installed within this scope can use this connection factory.
Specifies the resource adapter that WebSphere Application Server uses for this connection factory.
Provider is displayed in this location only when you create a new connection factory. The list shows all of the existing resource adapters that are defined at the relevant scope. Select one from the list if you want to use an existing resource adapter as Provider.
Provides the option of configuring a new resource adapter for the new connection factory.
Create New Provider is displayed only when you create, rather than edit, a connection factory.
Clicking Create New Provider triggers the console to display the resource adapter configuration page, where you create a new adapter. After you click OK to save your settings, you see the connection factory collection page. Click New to define a new connection factory for use with the new resource adapter; the console now displays a configuration page that lists the resource adapter as the new connection factory Provider.
Specifies the name of this connection factory.
This is a required property.
Data type | String |
Specifies the JNDI name of this connection factory.
For example, the name could be eis/myECIConnection.
After you set this value, save it and restart the server. You can see this string when you run the dumpNameSpace tool. This is a required property. If you do not specify a JNDI name, it is filled in by default using the Name field.
Data type | String |
Default | eis/display name |
Specifies a text description of this connection factory.
Data type | String |
Specifies the fully qualified name of the Connection Factory Interfaces supported by the resource adapter.
This is a required property. For new objects, the list of available classes is provided by the resource adapter in a drop-down list. After you create the connection factory, the field is a read only text field.
Data type | Drop-down list or text |
Specifies a string that you can use to classify or group this connection factory.
Data type | String |
Specifies authentication data for component-managed signon to the resource.
Select an alias from the list.
Data type | List |
However, if clients such as servlets or enterprise beans run in WebSphere Application Server processes within the same cell, and can look up a resource in the JNDI namespace, these clients can obtain connections without explicitly providing authentication data on the getConnection() call. In this case, if the component's res-auth setting is Application, authentication is taken from the component-managed authentication alias defined on the connection factory. With res-auth set to Container, authentication is taken from the login configuration defined on the component's resource-reference. It is important to note that J2C authentication alias is per cell. An enterprise bean or servlet in one application server cannot look up a resource in another server process which is in a different cell, because the alias would not be resolved.
This optional field is used to specify the authentication alias that should be used during XA recovery processing.
If the resource adapter does not support XA transactions, then this field will not be displayed. The default value will come from the selected alias for application authentication (if specified).
Data type | Radio button |
Data type | Radio button |
Specifies authentication data (a string path converted to userid and password) for container-managed signon to the resource.
Select an alias from the list.
Data type | Pick-list |
Specifies the authentication mechanisms defined for this connection factory.
This setting specifies which of the authentication mechanisms defined for the corresponding resource adapter applies to this connection factory. Common values, depending on the capabilities of the resource adapter, are: KERBEROS, BASIC_PASSWORD, and None.
Data type | Pick-list |
Default | BASIC_PASSWORD |
Specifies the authentication alias for the Java Authentication and Authorization Service (JAAS) mapping configuration that is used by this connection factory.
Click Security > Secure administration, applications, and infrastructure > Java Authentication and Authorization Service > Application logins and select an alias from the table.
The DefaultPrincipalMapping JAAS configuration maps the authentication alias to the userid and password. You may define and use other mapping configurations.
Data type | Pick-list |