Managing Ensemble Productions - InterSystems Documentation

Configuration Settings
Description
Enabled
Foreground
external side might mean that the business service now needs a different class of adapter to communicate with the
other enterprise. This would indicate a change to the Class field. The Name field allows continuity across this
change.
If you change the host class, the General Settings retain their values, but you must configure the Specific Settings,
as these may be entirely different for the new host class.
Comments that describe the business host class. This read-only field displays the first line of the class annotation
in the code. If there is no annotation in the code, the Description field contains the text N/A.
By default, the Enabled check box is selected for every business host. When you select Enabled, the business host
— identified by Name — is enabled. When a business host is enabled, it is registered with the production, and
instances of the business host accepts and processes messages whenever the production runs. You can clear the
Enabled check box, if needed.
For example, if there is a communications breakdown on the external side, an email server goes down, or something
similar happens, you can disable the associated business service until throughput is restored. When the Enabled
check box is clear, the business service is still present in the configuration, and its queue continues to accept
messages, but none of these messages are processed until the business service is enabled again.
By default, this check box is clear. Select it for debugging or diagnostic purposes only. Jobs in operational systems
almost never run in the foreground. When the Foreground check box is selected, any system jobs used by the
business service run in a Caché Terminal window at the front of the console display. This allows debugging or
trace messages to be displayed in the Terminal window. See the section “Testing and Debugging Productions”
in the “Creating a New Production” chapter of Developing Ensemble Productions.
Log Trace Events
Trace messages are informational text messages that Ensemble can deliver to the Terminal window and, optionally,
to the Ensemble event log. Trace messages are unrelated to Visual Trace, which provides a graphical view of
Ensemble message objects as they travel through a production.
By default, the Log Trace Events check box is clear. When selected, it enables logging of all trace messages issued
by this business host. Logging means that Ensemble will write the trace messages to the console Terminal window
(as usual) but it will also automatically store copies of these messages in the event log.
Inactivity Timeout
Pool Size
A business host has an Inactive status after it has not received any messages within the number of seconds specified
by the Inactivity Timeout field. The Ensemble Monitor Service periodically reviews the status of business services
and business operations within the production, and marks the item as Inactive if it has not done anything within
the Inactivity Timeout period. The business host status (OK, Error, Inactive) can be seen on the [Ensemble] > [Host
Monitor] page. The default value is 0 (zero). If a business host has an Inactivity Timeout setting of 0, it will never
be marked Inactive, no matter how long it stands idle.
Specifies how many system jobs to allocate to run this business host; the default is 1. Other values are appropriate
in specialized circumstances as described in the General Settings notes for the particular business host type.
For a full discussion of appropriate pool sizes for different types of production, see the Pool Size section in the
“Production Concepts” chapter of Developing Ensemble Productions.
Managing Ensemble Productions 57