Configuring Ensemble Productions
Configuring Settings
[Back] [Next]
Go to:

This chapter describes how to configure settings. It contains the following topics:

There are multiple ways to perform many tasks. This chapter describes only one procedure for any task.
Configuring Settings
To configure settings for a business host:
  1. Click the business host.
  2. Click the Settings tab.
  3. Expand and collapse the groups as needed to see the settings. You can also search for a setting.
  4. Edit values as needed.
    See the reference Settings in All Productions at the end of this book. Also see other Ensemble books for information on specific adapters and business hosts.
  5. Click Apply.
    If the apply command is successful, you receive a Settings applied message.
    Ensemble validates the values for settings. If you provide a string value for a setting that requires a numeric value, Ensemble does not apply that value.
Similarly, to configure settings for the production, first click Production Settings. This step returns the focus to the production and changes the options on the Actions tab. Then continue as described in the previous steps.
In both cases, the changes are immediately saved and take effect immediately.
Understanding the Color Coding for Settings
The setting names are color coded as follows:
Color Source
Black Setting value comes from the production definition — the value you enter and apply in the configuration page.
Green Setting value comes from the class definition; it is the default value for the property as defined in the class.
Blue Setting value comes from the default settings you enter in the Default Settings page for the namespace. See Defining System Default Settings,” later in this book.
Searching for a Setting
To find a setting more easily, use the Search option. Enter text to show all settings whose name, type, category, or value contains the search string. Click the X icon to clear the contents of the Search box.
Getting Help for Settings
This page provides context-sensitive help. Hover the cursor over any setting name to display its help text as it appears in the Class Reference for the associated class property or click the setting name to display the help text in a separate pop-up window.
The property name appears beneath the localized setting name in this window if the name is different.
Also see Settings in All Productions at the end of this book, as well as Ensemble books that discuss specific adapters and business hosts.
Restoring a Setting to Its Default Value
To restore a setting to its default value:
  1. Click the default setting icon on the Settings tab.
    Ensemble then displays a dialog box with a table that displays the following columns:
    Column Description
    Select check box Shown only if the current value is not the default.
    Setting Name of the setting as displayed in the Management Portal.
    Target Indicates if the setting applies to a host or to an adapter. This is blank for a production setting.
    Value Current value of the setting.
    Value Source Source of the current value:
    Default Default value for this setting.
    Default Source Source of the default value:See the notes for Value Source.
  2. For each setting that you want to change, select the check box.
  3. Click OK. The property label changes color depending on the Default Source. See Understanding the Color Coding for Settings,” earlier in this chapter.
    Or, if you make a mistake and want to return to the original values, click Cancel; the settings refresh to the previous values and the dialog box closes.
  4. Click Apply to save all your changes.