DataFlux Data Management Studio 2.5: User Guide

Set Up for JMS Nodes

• JMS Provider
• Minimum Options in app.cfg

JMS Provider

The JMS nodes communicate with a JMS messaging system, such as WebSphere MQ, ActiveMQ, JBoss, WebLogic, or Tibco. Obtain the following information about your JMS provider. You will need this information to set the minimum options in the app.cfg file.

• paths to all .jar files that contain the JMS API implementation for the provider
• fully-qualified class name of the JNDI provider context factory
• Server host/port information for JNDI connection
• JNDI name of the JMS connection factory

Minimum Options in app.cfg

You must set the following options in the app.cfg file for Data Management Studio, Data Management Server, or both, depending on which of these applications is used to execute jobs with JMS nodes. You can set additional options as described in Configuration Options for JMS Nodes.

Windows

The default Windows installation path for the app.cfg file for Data Management Studio and Data Management Server is as follows:

SASHome\<product_instance_name>\etc\app.cfg

Add the following options to the app.cfg file: 

#This option points to the .jar files that contain the JMS API implementation for the JMS provider
JAVA_PROXY/CLASSPATH=path_to_JMSprovider_jar1;path_to_JMSprovider_jar2...

# These are default global options for the JMS provider
JMS/CTXFACTORY=<Fully qualified class name of the JNDI provider context factory>
JMS/PROVIDERURL=<Server host/port information for JNDI connection>
JMS/FACTORY=<JNDI name of the JMS connection factory>

For more information about the JMS options, see Configuration Options for JMS Nodes.

UNIX

The default UNIX installation path for the app.cfg file for Data Management Server is as follows:

SASHome/<product_instance_name>\app.cfg

The options are the same as under Windows. One difference is that under UNIX, if you specify multiple paths, you must use the colon as a delimiter, not a semicolon.