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.
To configure settings for a business host:
Click the business host.
Click the Settings tab.
Expand and collapse the groups as needed to see the settings. You can also search for a setting.
Edit values as needed.
Some configuration settings, take comma-separated lists to define their possible values. You can change these items either by editing the list directly or by selecting the check boxes of the desired values in the associated drop-down list. When you edit settings that use drop-down lists, be sure to click outside of the list to close it.
Some configuration settings have a magnifying glass icon next to them. You can click this to see more details of a selected value, or to open a new portal page for entering additional information. This depends on the type of setting you are editing.
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.
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:
|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:
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:
class definition — the value is specified in the class on which this item is based.
default setting — the value is a system default value. For details, see “Defining System Default Settings,” later in this book.
production definition — the value is specified in the production definition.
Default Default value for this setting. Default Source Source of the default value:
class definition — if you see this, there is no system default for this setting.
For each setting that you want to change, select the check box.
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.
Click Apply to save all your changes.