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 Enterprise 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.
sun-web-app (sun-web.xml), ejb (sun-ejb-jar.xml)
The following table describes subelements for the resource-ref element.
Table A–73 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>