Maps the res-ref-name in the corresponding Java EE deployment descriptor file resource-ref entry to the absolute jndi-name of a resource.
Connections acquired from JMS connection factories are not shareable in the current release of the Communications Server. The res-sharing-scope element in the ejb-jar.xml file resource-ref element is ignored for JMS connection factories.
When resource-ref specifies a JMS connection factory for the Sun GlassFish Message Queue, the default-resource-principal (name/password) must exist in the Message Queue user repository. Refer to the Security Management chapter in the Sun GlassFish Message Queue 4.4 Administration Guide for information on how to manage the Message Queue user repository.
sun-web-app (sun-web.xml), sun-sip-app (sun-sip.xml), ejb (sun-ejb-jar.xml), sun-application-client (sun-application-client.xml)
The following table describes subelements for the resource-ref element.
Table A–96 resource-ref Subelements
Element |
Required |
Description |
---|---|---|
only one |
Specifies the res-ref-name in the corresponding Java EE deployment descriptor file resource-ref entry. |
|
only one |
Specifies the absolute jndi-name of a resource. |
|
zero or one |
Specifies the default principal (user) for the resource. |
<resource-ref> <res-ref-name>jdbc/EmployeeDBName</res-ref-name> <jndi-name>jdbc/EmployeeDB</jndi-name> </resource-ref>