Managing Ensemble Productions - InterSystems Documentation
Managing Ensemble Productions - InterSystems Documentation
Managing Ensemble Productions - InterSystems Documentation
You also want an ePaper? Increase the reach of your titles
YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.
Configuration<br />
Adapter Class<br />
The class name for the inbound adapter associated with this business service, or if there is no associated<br />
adapter class. This field has a gray background because it is read-only. Its value is determined by the business<br />
service class definition in the source code.<br />
Adapter SETTINGS<br />
Below the Adapter Class, various other fields display. The exact fields vary depending on the adapter class.<br />
Whatever is listed in the SETTINGS parameter for the business service class or its associated adapter class appears<br />
in the Specific Settings. When you hover the cursor over a field name, if there is a description of this field in the<br />
class code, its description displays. Validation for the data you enter is performed using the data types in the class<br />
code.<br />
Alert Grace Period<br />
Call Interval<br />
Credentials<br />
Business services can be configured with an Alert Grace Period during which errors relating to external connections<br />
do not trigger alerts, even if Alert On Error is True. The Alert Grace Period is allowed to elapse, giving the business<br />
service and the external source time to reestablish their connection. If the error condition still exists after the Alert<br />
Grace Period, the business service triggers an alert; otherwise no alert is triggered.<br />
Setting Alert Grace Period to 0 disables this feature for the business service.<br />
Many inbound adapters have a configurable setting called Call Interval. This integer determines how frequently<br />
the business service invokes the associated inbound adapter to obtain new input. Call Interval has a minimum of<br />
0.1 seconds. The default is 5 seconds.<br />
Some inbound adapters make remote connections that require a username and password. <strong>Ensemble</strong> stores these<br />
login credentials in a centralized table that can be viewed and edited only by users with access to the [<strong>Ensemble</strong>]<br />
> [Maintenance] > [Credentials] page. Each entry in the Credentials table has an ID by which you can refer to it<br />
when configuring adapters for the production.<br />
If an inbound adapter requires credentials, the Specific Settings include a Credentials field. If this field is present,<br />
it must contain an ID from the table on the [<strong>Ensemble</strong>] > [Maintenance] > [Credentials] page. If there is no current<br />
Credentials entry for the remote system that this business service needs to connect to, you must create it. After<br />
creating the new entry in the [<strong>Ensemble</strong>] > [Maintenance] > [Credentials] page, go back to the configuration page<br />
and enter the new ID in the Credentials field.<br />
5.2.4 Business Process Settings<br />
When you select a business process in the configuration diagram on the [<strong>Ensemble</strong>] > [<strong>Productions</strong>] > [Configuration] page,<br />
the runtime settings for this business process display in the lower portion of the page. For the most part, these settings<br />
describe how the process communicates with other items within <strong>Ensemble</strong>.<br />
General Settings<br />
The configuration page permits you to view or edit the General Settings described in the previous section with the following<br />
additional notes that apply specifically to business processes:<br />
• Enabled — When you clear this check box, the Ens.Actor queue continues to accept messages addressed to it, but none<br />
of these messages are processed until you enable the business process again.<br />
• Pool Size — This number could be larger to allow higher throughput in some circumstances. If this number is 0, the<br />
business process has no private pool of jobs, and uses jobs from the public actor pool for the production.<br />
60 <strong>Managing</strong> <strong>Ensemble</strong> <strong>Productions</strong>