Skip to main content

Configuring Settings

This topic describes how to configure settings for productions and their business hosts.

For information on performing these tasks in the legacy UI, see Configuring Settings (Legacy UI).

Configuring Settings

To configure settings for a business host:

  1. Display the Production Configuration page and open the production.

  2. Click the business host.

  3. Expand the Settings pane on the right.

  4. Expand the Properties group.

  5. Within that group, expand and collapse the groups as needed to see the settings.

    Note that this user interface displays setting names differently, based on where the setting value comes from. Some are specified by the definitions of the classes, some are system defaults, and some are set specifically within this production.

  6. Change values as needed. If a gear icon is displayed to the right of the setting, you have two options for changing the value:

    • Type or select a new value and click Save. This option is always available.

    • Click the gear icon to the right of the setting and select Restore Class Reference. This restores the value of this setting to the value given in the definition of the class on which this business host is based.

    InterSystems IRIS® validates the values for settings. If you provide a string value for a setting that requires a numeric value, InterSystems IRIS does not apply that value.

Similarly, to configure settings for the production, first click the production name in the Productions list on the left. This step returns the focus to the production. Then continue as described in the previous steps.

In all cases, the changes are immediately saved and take effect immediately.

Saving a Setting as a System Default

If a gear icon is displayed to the right of a setting name, you can save the current setting value as the system default. To do so:

  1. Click the gear icon to the right of the setting.

  2. Select Create Configuration Default or Update as New Default.

    The system shows Update as New Default instead of Create Configuration Default, when there is already a default.

    This displays the Default Settings pane, which will open at the bottom of the page.

  3. Make edits as described in Defining System Default Settings and click Save.

    When you define a system default this way, the initial definition is completely specific to the item from which you started. In general, a system default is most useful if it applies to multiple business hosts or multiple productions. This means that you typically have to modify the initial definition to include wildcards so that it can apply to (for example) any business host using the same underlying class.

This change also updates the production so that now it is using the system default value for the setting. This changes how the setting is displayed.

Color Coding

The configuration page displays settings differently, based on how the setting values are specified:

How Setting Name Is Displayed Source of Setting Value
Black with no dots Setting value comes from the production definition—the value you enter and apply in the configuration page.
Green with three dots Setting value comes from the class definition; it is the default value for the property as defined in the class.
Blue with two dots Setting value comes from the system defaults table.

Getting Help for Settings

This page provides context-sensitive help. Click the setting name to display the help text in a separate pop-up window.

See Also

FeedbackOpens in a new tab