7 - Configure the Web Services Runtime Options

This section will guide you through the steps required to configure the optional parameters used by the Rpm Web Services Api at runtime. At a conceptual level, we are mapping a WS API class to a list of variables which are used to control its behavior. All these parameters have default working values.

For a list of all the runtime parameters available, as well as their default values, please see this list

  1. Log in to the WebSphere Administrative Console
  2. Navigate the tree on the left-hand side of the page to Resources->Resource Environment->Resource Environment entries
    Web Services Resource environment entries
  3. On the right hand-side portion of the screen, from the scope drop-down list, select the server-level entry which looks like Node=<nodename>, Server=<servername>.
  4. Click on NEW
  5. Fill in the required field Name with StringProvider, then click on Ok.
    Web Services Resource - naming the
  environment provider
  6. Click on the entry we have just created : StringProvider.
    Web Services Resource - naming the
  environment provider
  7. Click on Referenceables, which is located on the right-hand side of the screen, in the Additional Properties section.
    Web Services Resource - Additional
  Properties
  8. Click on New to create a new Referenceable
    Web Services Resource - Create Referenceable
  9. Fill in the Factory class name and the Class Name fields as follows, then click on Ok :
    Web Services Resource - Create Referenceable
  10. Save the configuration in the same manner we have done previously
  11. At the top of your screen, click on the blue link StringProvider. You may repeat the following steps in order to override any of the available options, which are listed at the beginning of this section. We will be overriding the webServicesUseSessionTimeout variable, as an example. Note that you will be required to restart the Web Services application after updating one of its options.
    Web Services Resource - StringProvider screen
  12. Click on the Resource environment entries link on the right-hand side of the screen.
    Web Services Resource - Resource Environment
  Entries screen
  13. Click on New to continue.
    Web Services Resource - Resource Environment
  Entries screen
  14. Fill the following fields as specified, then click on Ok :
    Web Services Resource - Resource Environment
  Entries screen
  15. Save the configuration in the same manner we have done previously
  16. Once you have saved the WebSphere configuration file, click on the entry we have just created :
    Web Services Resource - Resource Environment
  Entries
  17. Click on the Custom properties link located on the right-hand side of the screen, in order to assign a value to the Web Services variable we have just created.
    Web Services Resource - Resource Environment
  Entries
  18. Click on New to assign a value to our variable.
    Web Services Resource - Resource Environment
  Entries Confirmation screen
  19. Fill in the following fields, then click on Ok :
    Web Services Resource - Resource Environment
  Entries Confirmation screen
  20. Save the configuration in the same manner we have done previously
  21. Restart Websphere or the Web Services Application for the new parameters to be taken into account