Show TOC

Procedure documentationManaging JMS Server Configuration Locate this document in the navigation structure

 

In the JMS Server Configuration: Overview screen of the SAP NetWeaver Administrator you can view and manage the JMS Provider configuration on the AS Java. You can create and remove JMS resources (connection factories and destinations) and virtual providers. You can configure their current state as well by setting their properties in the Details section.

Prerequisites

You have opened the   Configuration   Infrastructure   JMS Server Configuration   function of SAP NetWeaver Administrator.

Procedure

Managing JMS Virtual Providers

Select JMS Virtual Providers from the Show dropdown menu.

Creating and Removing JMS Virtual Providers
  1. To create a JMS virtual provider, choose Create. In the dialog box that appears, specify the name of the virtual provider and choose Save.

  2. To remove a virtual provider, select the virtual provider you want to delete and choose the Remove button.

    Caution Caution

    You have to be careful when you delete a virtual provider because this may cause some applications to stop running.

    End of the caution.
Configuring JMS Virtual Providers

Configuring the Global Default Properties of the JMS Provider Service

You can configure global properties of JMS virtual providers via the Config Tool.

  1. Start the Config Tool by double-clicking the configtool script file in <SAP_install_dir>/<system_name>/<instance_name>/j2ee/configtool directory and expand the nodes   cluster-data   template   services   jms_provider  .

  2. If necessary, choose   View   Expert Mode  .

  3. If you want to distribute all of the JMS virtual providers you have between the server nodes, set the value of hostMultipleVPs key to true. Otherwise you have only one virtual provider on a node and if the number of the virtual providers is larger than the nodes, some of the virtual providers are not started and some of your applications may stop running.

  4. To apply the changes, you have to restart the Application Server cluster.

Configuring JMS Virtual Providers Locally (per Provider)

  1. To manage the properties of a particular JMS virtual provider properties, select the provider, then choose Edit.

  2. In the Details area, choose the Details tab.

  3. Customize the settings, as necessary.

    You can also specify the local JMS virtual provider properties in the jms-resources.xml deployment descriptor. The following table shows the correspondence between the online-configurable properties and the jms-resources.xml elements:

    Property in SAP NetWeaver Administrator

    Property in jms-resources.xml

    DataSource Name

    dataSourceName

    Running Mode

    runningMode

    Clean Up Service Sleep Interval (milliseconds)

    cleanUpServiceSleepInterval

    Client Memory Size (bytes)

    clientMemorySize

    Client Consumer Buffer Size (bytes)

    clientConsumerBuffer

    Cache Size Limit (bytes)

    cacheSizeLimit

    For more information about the properties you want to configure, see Property Reference.

  4. To save your changes, choose Save.

Creating and Configuring JMS Resources
  1. To create and configure JMS resources, select JMS Resources from the Show dropdown menu. The following table describes the different tasks you can do and how to do them:

Task

Steps

Create a new topic or queue

  1. In the JMS Resource List area, choose   Create   JMS Topic (or JMS Queue)  .

  2. In the dialog box that appears, specify the name of the new topic or queue.

  3. Select a Virtual Provider and choose Save.

Edit the settings of a topic or a queue

  1. Select the topic or queue to be edited in the JMS Resource List.

  2. Choose Edit.

  3. In the Details area, choose the Details tab.

  4. Edit the properties you want to change. When ready, choose Save.

Create a new connection factory

  1. In the JMS Resource List area, choose  Create   JMS Connection Factory  .

  2. In the dialog box that appears, specify the Lookup Name of the new connection factory.

  3. Select the Type of the connection factory.

  4. Select a Virtual Provider, then choose Save.

Remove a resource

Select the resource to be removed in the JMS Resource List, then choose Remove.

More information about the details displayed for a resource: JMS Details Description

Monitoring the JMS Provider

You can monitor the JMS Provider using the SAP NetWeaver Administrator. To access the monitors you have to:

  1. Open the SAP NetWeaver Administrator and choose   Availability and Performance   Resource Monitoring   History Reports  .

  2. Choose the Monitor Browser tab.

  3. Using the Show dropdown list, specify whether you want to display the active or inactive monitors.

  4. To display the JMS provider monitors, enter /services/jms in the filter row of the Name column.

  5. To display the configuration details of a particular monitor, select the monitor.

    The Monitor Details area opens.

  6. To switch the selected monitor on or off, choose the Activate or Deactivate pushbutton, respectively.

  7. If necessary, change the values of certain properties of the monitor. You can also restore their server-default values. To apply the changed values, choose Save.

More Information

JMS