Reference: General properties

The basic configuration of nJAMS Client for ADADB takes place in config file This configuration file resides in <TIBCO_ADADB_HOME>/plugins/conf. Use an editor of your choice and edit according to your needs.


Any change in this configuration file requires a re-start of the TIBCO Adapter for Database Service instances.


The following properties deal with the communication between nJAMS Client and nJAMS Server, respectively nJAMS Cloud.


Select type of communication with nJAMS Server, respectively nJAMS Cloud:

JMS nJAMS Client for ADADB communicates with nJAMS Server instance via TIBCO EMS. This settings is used for using nJAMS Server on premise, respectively private cloud.

CLOUD nJAMS Client for ADADB communicates with a nJAMS Cloud Instance. This setting is used, if you are using nJAMS Cloud service.

In case you are using JMS:

 Sets the connection factory, for example “ConnectionFactory”.
 Use a valid JMS server user that has the required privileges to send and receive messages on the destinations defined in njams.sdk.communication.jms.destination.
 The JMS user’s password.
 The JMS destination name prefix. The prefix will be extended with .event”`` for event messages send by nJAMS Client for ADADB and .commands”`` for messages send from the server to the nJAMS Client for ADADB. Default is njams.
 Name of the JMS destination that is used to send commands from nJAMS Server to nJAMS Client for ADADB. This setting is optional and only used, if you want to use a dedicated topic commands.
 Sets the JNDI context factory.
 Set JNDI user name.
 Set JNDI user’s password.
 The JNDI server connection url. Fault-tolerant or load-balanced URLs are supported.

Sample configuration of a JMS Data Provider using TIBCO EMS:

## SDK configuration
# Communication settings

# JMS settings

# JNDI settings

Sample configuration of a JMS Data Provider using ActiveMQ:

## SDK configuration
# Communication settings

# JMS settings

# JNDI settings\://localhost\:61616

In case you are using nJAMS Cloud:

The following properties have to be configured to allow nJAMS Client for ADADB to create a secure connection via https to a designated nJAMS Cloud Instance. You can find the configuration of the Cloud Data Provider within the Instance Setup of your Integration Matters account. A subscription of nJAMS Cloud is required.
 Refers to absolute path of API key file.
 Endpoint of Integration Matters client hub. Default is and does not need to be changed.
 Refers to absolute path of client certificate file.
 Unique id of your nJAMS Cloud Instance.
 Refers to absolute path of private key file.

Sample configuration of a Cloud Data Provider:

## SDK configuration
# Communication settings

# Cloud Data Provider:

Additional properties

The following properties are not required to be changed in most cases. Please only change these values, if you are fully aware of the effects.

 Specifies domain name as fallback. In case nJAMS Client for ADADB could not determine the domain name, the specified value is . Default is Domain.
 Specifies deployment name as fallback. In case nJAMS Client for ADADB could not determin the deployment name, the specified value is taken. Default is Deployment.
 Specifies engine name as fallback. In case nJAMS Client for ADADB could not determin the engine name, the specified value is taken. Default is Engine.

Sample configuration of nJAMS Client for ADADB taxonomy:

# Taxonomy:

Specifies configuration provider, respectively the location where nJAMS Client for ADADB stores the application based configuration.

file stores configuration on storage device (default).

memory stores configuration in memory. Should be used, when no storage device is available (Cloud). That means the configuration is lost after restart of TIBCO Adapter for Database.


Discards messages from memory, when maxQueueLength is exceeded.

none blocks the adapter service until queue size is below threshold (default).

discard will discard of the message.

OnConnectionLoss only discards event messages, if there is no connection available to JMS or Cloud provider. Otherwise the engine is slowed down until all log messages are sent, respectively queue size is below threshold.


Period of time for collecting events. Enter integer value in seconds. Default is 30.


Maximum internal message size. If size of internal message is reached, an instant push is triggered. Enter any integer value > 0 in Byte. Default is 5242880.

Use encrypted passwords

In njams configuration files passwords are usually entered in plain text, such as njams.sdk.communication.jms.password=foo. In case you do not want to use uncoded passwords, you can use encrypted passwords as follows:

Assume, the password of your JMS account is foo:

  1. Call java -jar njams-sdk-4.x.x.jar foo will output encrypted password: ??0190029006d0048004c0055000c0017002d00090005006a004d007100b500bd
  2. Place encrypted password into at njams.sdk.communication.jms.password=??0190029006d0048004c0055000c0017002d00090005006a004d007100b500bd
  3. Restart AppNode to make change effective