BRBeans properties file

Applications that use the Business Rule Beans (BRBeans) enterprise beans (this includes applications that trigger rules or use the rule management APIs) must specify the JNDI names for these enterprise beans so that the application can find them at run time. If the application is running in a J2EE client container, in a servlet, or on the application server itself (for example, as part of another enterprise bean), then these names probably have been specified by the person who configured the application. If the application is not running in a container, the names must be specified some other way. The BRBeans properties file provides a way to do this.

At run time, the BRBeans code looks for a special Java property that identifies the name of the properties file. This Java property can be specified on the command line as -DbrbPropertiesFile=<file_name>. The file specified is expected to contain the JNDI names used to find the BRBeans enterprise beans. The BRBeans framework uses these names when it needs to locate the enterprise beans.

When an application attempts to reference BRBeans enterprise beans, the code first looks for the brbPropertiesFile Java property. If this property is specified, the names listed in that file are used to find the enterprise beans and to override any EJB references that were specified in the container (if the application is running in a container). If the property is not specified, then BRBeans attempts to use the EJB references specified in the container.

The host name and port number used to access the name server also can be set in this file. If these are not specified, the BRBeans framework uses the name server used by the container in which the application is running. If the application is not running in a container, then localhost is used for the host name and 2809 is used for the port number.

The properties file must be in the following format (entries can be specified in any order):

host=<host-name-for-name-server>
port=<port-number-for-name-server>
RuleJndi=<JNDI-name-for-Rule-EJB>
RuleFolderJndi=<JNDI-name-for-RuleFolder-EJB>
RuleHelperJndi=<JNDI-name-for-RuleHelper-EJB>

Location

A default properties file is shipped as <WAS_HOME>\AppServer\bin\brbeansDefaultProperties.

There are a set of JAR files that conform to the BRBeans<database-type>.jar naming convention (depending on the type of database that you want to use). If the JAR files are used without changing the JNDI names, then you also can use the default properties file.

Usage note

The file name still must be specified even if you want to use the default file. There is no file that is used automatically if the brbPropertiesFile property is not set.

The tools shipped with BRBeans (the Rule Management Application, the rule importer, and the rule exporter) all run outside of any container. Hence, the JNDI names need to be specified when these tools are run. The scripts for these tools all require that you pass a properties file name as a command line parameter. This name then is specified as the value for the brbPropertiesFile property when the tool is run.


Related concepts
Overview of Business Rule Beans



Searchable topic ID:   rbrb_prop
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/brb/ref/rbrb_prop.html

Library | Support | Terms of Use | Feedback