Web module resource references [Settings]

For each reference, specify the JNDI name under which the resource is known in the runtime environment. Optionally, set authentication properties and extended data source custom properties, which affect how the resource is accessed at run time.

Binding a resource reference maps a resource dependency of the web application to an actual resource available in the server runtime environment. At a minimum, you can achieve this mapping by specifying the JNDI name under which the resource is known in the runtime environment. By default, the JNDI name is the resource ID that you specified in the web.xml file during development of the web application bundle (WAB).

The rows contain the JNDI names of resource mapping targets for your references only if you bound them together during application assembly. You can modify the mappings, as required, by entering the appropriate values in the JNDI Name column.

To view this panel in the administrative console, click one of the following paths:
  • Applications > Application Types > Business-level applications > application_name > [Deployed assets] Add > Add Asset > asset_name > Wizard step: Map web module resource references to resources
  • Applications > Application Types > Business-level applications > application_name > composition_unit_name > [Additional Properties] Web module resource references
Note: The Map web module resource references to resources wizard step and the Web module resource references property are visible only if the bundle includes a web application.

General Properties

Select
To modify the authentication method, or to set extended data source custom properties that apply to the database connection, select a single reference then click Modify Resource Authentication Method... or Extended Properties....
Composite bundle identifier
This identifier is displayed only if the EBA asset uses composite bundles. Each composite bundle is identified by a string in the following form: Composite bundle archive (CBA)'composite.bundle.symbolic.name_composite.bundle.version'. Bundles that are part of a composite bundle are listed beneath the composite bundle identifier.
Composite bundle symbolic name
The non-localizable name for this composite bundle.
Composite bundle version
The version of this composite bundle.

The symbolic name, together with the version, uniquely identifies a composite bundle.

Bundle symbolic name
The non-localizable name for this bundle.
Bundle version
The version of this bundle.

The bundle symbolic name, together with the bundle version, uniquely identifies a bundle.

Resource Reference
The name of a resource reference that is used in the application, if applicable, and is declared in the deployment descriptor of the WAB.
Resource Type
The type of the resource reference.
You can use this panel to specify bindings for any resource-ref (resource reference) resource, as defined in the Java™ specification JSR-250: Common Annotations for the Java Platform. For example:
  • Data source
  • Generic JMS connection factory
  • Mail session
  • J2C connection factory
  • JMS queue connection factory for the JMS provider of WebSphere® MQ
  • JMS topic connection factory for WebSphere MQ
  • Unified JMS connection factory for WebSphere MQ
  • URL configuration
Note: To specify bindings for a message-destination-ref (message destination reference) resource, or a resource-env-ref (resource environment reference) resource, use the Web module message destination references [Settings] panel.
JNDI name
The Java Naming and Directory Interface (JNDI) name of the resource that is the mapping target of the resource reference.
Login configuration
The authorization type and the authentication method for securing the resource. Container-managed authorization indicates that the product signs on to the resource rather than the enterprise bean code.

Buttons

Label Action

Browse

To specify the JNDI name mapping for a specific web module resource reference, use this option to select the resource reference from a list of available resources.

Modify Resource Authentication Method
You can select one of the following options:
None
Use default method (many-to-one mapping)
For information about the default mapping configuration, see J2EE connector security.
Select this option, then select an authentication alias from the list.
Use trusted connections (one-to-one mapping)
Use this option if your resource is a data source that has trusted context enabled.
Select this option, then select an authentication alias from the list that matches an alias that is already defined in the data source.
Use custom login configuration
For information about custom Java Authentication and Authorization Service (JAAS) login configurations, see J2EE connector security.
Select this option, then select a JAAS login configuration from the list.

Extended properties
If your resource is a data source, and the back-end database supports extended data source custom properties, you can use this option to add, modify, or delete these properties. These are custom properties, in the form of name/value pairs, that you can use to obtain a data source.
Note: If you use multiple values for an extended data source property, you must enclose those values in quotation marks.

Mapping properties

Define arbitrary name and value pairs for extended data source properties that apply to the resource authentication method. This button is visible only if you have selected Use trusted connections or Use custom login configuration for the resource authentication method.