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
- Log in to the WebSphere Administrative Console
- Navigate the tree on the left-hand side of the page to
Resources->Resource Environment->Resource Environment entries
- 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>.
- Click on NEW
- Fill in the required field Name with
StringProvider, then click on Ok.
- Click on the entry we have just created : StringProvider.
- Click on Referenceables, which is located on the
right-hand side of the screen, in the Additional Properties
section.
- Click on New to create a new Referenceable
- Fill in the Factory class name and the Class
Name fields as follows, then click on Ok :
- Factory class name :
com.ibm.rpm.factory.StringFactory
- Class name : java.lang.String
- Save the configuration in the same manner we have done previously
- 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.
- Click on the Resource environment entries link on the
right-hand side of the screen.
- Click on New to continue.
- Fill the following fields as specified, then click on Ok :
- Name : webServicesUseSessionTimeout
- JNDI name : com/ibm/rpm/webServicesUseSessionTimeout
- Referenceables : com.ibm.rpm.factory.StringFactory
- Save the configuration in the same manner we have done previously
- Once you have saved the WebSphere configuration file, click on the entry
we have just created :
- 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.
- Click on New to assign a value to our variable.
- Fill in the following fields, then click on Ok :
- Name : webServicesUseSessionTimeout
- Value : false
- Save the configuration in the same manner we have done previously
- Restart Websphere or the Web Services Application for the new parameters
to be taken into account