[Version 5.0.2 and later]Creating or changing a resource reference

Why and when to perform this task

A resource reference supports application provider access to a resource (such as a data source, URL, or mail provider) using a logical name rather than the actual name in the run time environment. This ability insulates the application provider from the run time configuration, and simplifies the process of changing the run time configuration.

Resource references are declared in the deployment descriptor by the application provider. At some point in the application deployment process, you must bind the resource reference to the actual name of the resource in the run time environment.

Steps for this task

  1. Start the Assembly Toolkit.
  2. Import the enterprise application (EAR file) you want to change.
  3. Display the resource references for the type of application component:
    • If an enterprise bean uses the resource reference:
      • Expand the name of the EAR file
      • Expand EJB Modules
      • Expand the EJB module wanted
      • Expand the section for the appropriate type of enterprise bean (Session Beans or Entity Beans)
      • Expand the enterprise bean
    • If a servlet uses the resource reference:
      • Expand the name of the EAR file
      • Expand Web Modules
      • Expand the Web module wanted
    • If an application client uses the resource reference:
      • Expand the name of the EAR file
      • Expand Application Clients
      • Expand the application client module wanted
  4. Right-click the module whose resource references you want to change and click Open With > Deployment Descriptor Editor.
  5. For servlets and application clients, click Add. For EJB modules, select the particular bean and click Add.
  6. Select the resource reference option and click Next.
  7. Specify the settings and click Finish.
  8. Select the References tab and, under WebSphere Extensions, select an isolation level.
  9. Under WebSphere Bindings, specify a JNDI name.
  10. Close the deployment descriptor editor and save your changes.
  11. Generate the code.

Related concepts
Data sources
Related reference
Data access : Resources for learning



Searchable topic ID:   tatk_crtresref
Last updated: Jun 21, 2007 8:07:48 PM CDT    WebSphere Business Integration Server Foundation, Version 5.0.2
http://publib.boulder.ibm.com/infocenter/wasinfo/index.jsp?topic=/com.ibm.wasee.doc/info/ee/ae/tatk_crtresref.html

Library | Support | Terms of Use | Feedback