Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved


Chapter 1 Project Tasks : Working with External Library and Custom Function Paths

Working with External Library and Custom Function Paths
When you work with external libraries or custom functions in your project at design time, and when you run, test, or debug such projects in TIBCO BusinessEvents Studio, you must ensure that the engine can find all libraries (including dependencies on third-party libraries) and custom functions, if the project requires any.
If a project uses Rendezvous channels, for example, Java allows the user to set a property, java.library.path, to ensure that the environment path contains a reference to the directory containing Rendezvous DLLs (or on UNIX the SO files).
Similarly TIBCO BusinessEvents captures the native library path along with the build path information to pass to engines running inside TIBCO BusinessEvents Studio. You can enter this information as described below, or when you are configuring a run configuration or debug configuration.
Test Connection Feature  To make the Test Connection feature work for JMS Connection and JDBC Shared Connection shared resources, see Enabling the Test Connection Feature.
To Add an External Library or Custom Function Path
1.
2.
In BusinessEvents Studio Explorer, right-click the project and click Properties (or press Alt-Enter). You see the properties dialog for the project.
3.
In the left panel, select Build Path and then select one of the following:
The Custom Functions tab, to add custom functions paths
The Java Libraries tab, to add third-party libraries paths
4.
Click Add Library and browse to and select the JAR file.
5.
a.
b.
At the Native Library Folder Configuration dialog, select External Folder or Workspace as appropriate, and browse to and select the folder containing the native libraries.
c.
Click OK to dismiss this dialog.
6.
Click OK. One of the following occurs:
If a custom function depends on third-party Java archives and you did not do step 5, a dialog displays when you click OK. It lists the name of the class or classes that could not be loaded. To resolve the problem, do step 5.
7.
Deploytime Action Required  To make custom functions or external libraries available at runtime, do the following on all machines where TIBCO BusinessEvents is installed:
Either copy the JAR or JARs to the lib/ext/tpcl directory, or other directory in the classpath; or update the classpath in the TRA file to point to the location of the JAR or JARs.
If a JAR has dependencies on native libraries, edit BE_HOME/bin/be-engine.tra and as needed, update PATH LD_LIBRARY_PATH, SHLIB_PATH, and LIBPATH as needed, depending on the operating system.
To Remove an External Library or Custom Functions JAR Path
Follow the instructions in To Add an External Library or Custom Function Path, but instead of clicking Add Library, select the JAR file you want to remove and click Remove Library. The entry for any native libraries it depends on is also removed.

Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved