Overview of Custom Engine Properties

The ActiveMatrix BusinessWorks process engine is responsible for running instances of your process definitions. The default configuration settings of the engine are sufficient for most users. However, you can specify custom properties in the engine’s configuration files to configure the process engine to suit your needs. For example, custom properties are available for enabling or disabling and setting the level of tracing for the engine. Custom properties are also available for configuring the maximum and minimum number of connections for the HTTP server that handles incoming HTTP requests for ActiveMatrix BusinessWorks.

Properties are set by specifying their name and value in the configuration files. For example, the following line sets the property Trace.Role.error to false. This prevents any trace messages for the role named error from being written to the log file or console.

Trace.Role.error = false

Some properties can be set for specific process definitions or activities, and the property name can be variable. Properties that have variable portions can use the wildcard character (*) to indicate the property should be set to the specified value for all potential names. For example, Trace.Role.* is the property to control tracing for all roles.

Property names and values can be separated by either a space ( ), an equal sign (=), or a colon (:). If a property value contains a space, equal sign, or colon, you must escape these characters in the property value by using a \ (for example, \ , \=, or \:). You can place comments in the configuration files by placing a hash (#) as the first character in a comment line.

The following sections describe how to set custom engine properties and list the custom properties that you can set.