Show TOC

Managing Resource AdaptersLocate this document in the navigation structure

Use

You can initially configure a resource adapter at deployment time with the parameters set in its deployment descriptors - the standard ra.xml and the additional connector-j2ee-engine.xml . Most of the settings cannot be edited at runtime.

Use this procedure to additionally customize resource adapters at runtime via the SAP NetWeaver Administrator. You can also create new resource adapters, using templates.

Note

Templates are resource adapters used for cloning purposes only. They can be neither instantiated, nor looked up via JNDI, that is, applications or message-driven beans (MDBs) cannot use template resource adapters for outbound communication.

By default, there are predefined templates on AS Java. To create your own template, you must specify the template element of the resource adapter additional descriptor before deployment.

For more information, see connector-j2ee-engine.xsd

Prerequisites

You are in the Start of the navigation path Configuration  Next navigation step Infrastructure Next navigation step Application Resources End of the navigation path function.

Procedure

Configuring Resource Adapters

  1. Choose Start of the navigation path Show Next navigation step Resource Adapters End of the navigation path.

  2. Select a resource adapter from the Resources List .

    Task

    Steps

    Add properties

    1. Choose the Properties tab.

    2. Choose the Add New Property pushbutton. If it is inactive, there are no new properties available for the particular resource adapter.

      • If the resource adapter is started, the SAP NetWeaver Administrator opens a dropdown list of the available properties.

        1. Choose the property you want to add from the dropdown list.

        2. Specify the Value and Description of the property.

      • If the resource adapter is stopped, choose Add , and then specify the Name , Type , Value , and Description of the new property.

    3. To save your changes, choose Save in the Resource Details area.

    Remove properties

    1. Choose the Properties tab.

    2. Select a property.

    3. Choose Remove Property .

    4. To save your changes, choose Save in the Resource Details area.

    Add loader references

    1. Choose the Loader References tab.

    2. Choose Add New Reference .

    3. Specify the relevant value in the Name field.

    4. To save your changes, choose Save in the Resource Details area.

    Remove loader references

    1. Choose the Loader References tab.

    2. Select a reference.

    3. Choose Remove Reference .

    4. To save your changes, choose Save in the Resource Details area.

    Add message listeners

    Add configuration properties

    1. Choose the Message Listeners tab.

    2. Choose Add New Message Listener .

    3. Specify the following values:

      • Name

      • Type

      • Activation Specification Class

    4. To add configuration properties, choose Add New Property , then specify a Caption and Description .

    5. To save your changes, choose Save in the Resource Details area.

    Remove message listeners

    Remove configuration properties

    1. Choose the Message Listeners tab.

    2. Select a message listener.

    3. Choose Remove Message Listener .

    4. To remove configuration properties, select a property, then choose Remove Property .

    5. To save your changes, choose Save in the Resource Details area.

Cloning Resource Adapters

  1. Choose Start of the navigation path Create New Resource Next navigation step New Resource Adapter End of the navigation path.

  2. Specify the Template to be used for the new resource adapter, as well as the Application that implements the new resource adapter.

  3. Choose Next .

  4. To configure the cloned resource adapter, choose Resource Adapter in the New Resource Adapter Creation area.

    For more information about resource adapter configuration, see the “Configuring Resource Adapters” section above.

  5. To configure the JCA resource, choose JCA Resource in the New Resource Adapter Creation area.

    For more information, see Managing JCA Connection Factories .

  6. To configure the JCA connection factories, choose JCA Connection Factory in the New Resource Adapter Creation area.

    For more information, see Managing JCA Connection Factories .