Managing Ensemble Productions - InterSystems Documentation

Configuration
Adapter SETTINGS
Below the Adapter Class, various other fields display. The exact fields vary depending on the adapter class.
Whatever is listed in the SETTINGS parameter for the business operation class or its associated adapter class
appears in the Specific Settings. When you hover the cursor over a field name, if there is a description of this field
in the class code, its description displays. Validation for the data you enter is performed using the data types in
the class code.
Reply Code Actions
Retry Interval
Comma-separated list of code-action pairs, specifying which action the business operation takes on receipt of
various reply status conditions.
See Reply Code Actions Setting for details.
Number of seconds to wait between attempts to connect with a destination outside Ensemble.
Alert Retry Grace Period
Business operations can be configured with an Alert Retry Grace Period during which errors relating to external
connections do not trigger alerts, even if Alert On Error is True. This grace period accommodates a business
operation that attempts an external connection with a configured Retry Interval and Failure Timeout. During its
retry sequence, the business operation may encounter connection failures that become unimportant after one of
its retry attempts succeeds. Thus, if a business operation first encounters an error, but later achieves success within
the time allotted by the Alert Retry Grace Period, no alert is triggered even though an error occurred.
Setting Alert Retry Grace Period to 0 disables this feature for the business operation.
Failure Timeout
Credentials
Total number of seconds to keep trying to connect with a destination outside Ensemble. After this number of
seconds has elapsed, the business operation discards the message data and returns an error code. To ensure that
no message is ever skipped, enter a Failure Timeout value of –1, which means “never time out.” Use a setting of
–1 when complete data delivery is critical, for example in health care applications.
Some outbound adapters make remote connections that require a username and password. Ensemble stores these
login credentials in a centralized table that can be viewed and edited only by users with access to the [Ensemble]
> [Maintenance] > [Credentials] page. Each entry in the Credentials table has an ID by which you can refer to it
when configuring adapters for the production.
If an outbound adapter requires credentials, the Specific Settings include a Credentials field. If this field is present,
it must contain an ID from the table on the [Ensemble] > [Maintenance] > [Credentials] page. If there is no current
Credentials entry for the remote system that this business operation needs to connect to, you must create it. After
creating the new entry in the [Ensemble] > [Maintenance] > [Credentials] page, go back to the configuration page
and enter the new ID in the Credentials field.
5.2.6 Reply Code Actions Setting
The Reply Code Actions setting allows you to supply a comma-separated list of code-action pairs, specifying which action
the business host takes on receipt of various reply status conditions. The format of the list is:
code=actions,(code,code)=actions, ... code=action
The following table lists the types of reply status condition identified by code.
62 Managing Ensemble Productions