Configuring DSO by using the Server Information form

Specifies the AR System server for a DSO server to support when that AR System serveris different from the one installed with the DSO server.

Use this when setting up a DSO server outside a firewall to support an AR System server running behind the firewall. The corresponding AR System serverconfiguration file entry is DSO-Source-Server. For more information, see Configuring-DSO-for-firewalls.

Specifies the interval at which the DSO server queries the distributed pending queue for pending distributed items.

Enter any integer from 0 (no polling) to 3600 seconds (1 hour). The corresponding AR System serverconfiguration file entry is DSO-Main-Thread-Polling-Interval. When a polling interval is specified, the DSO server does not receive real-time signals from the workflow.

Specifies the interval (in seconds) at which the DSO server checks the distributed pending queue for pending distributed items.

This is used only as a backup in case an issue causes the DSO server to receive no signals from the workflow. Unless an issue occurs, the DSO server continues receiving real-time signals from workflow when this option is enabled. The server does not become a polling server. The value can be any integer between 15 and 7200. By default, the backup polling interval is disabled. The corresponding AR System serverconfiguration file entry is DSO-Polling-Interval.

Specifies the timeout (in seconds) that the DSO server applies during communication with the AR System server.

Enter an integer between 60 (1 minute) and 21600 (6 hours). If you enter a value out of range, the closest in-range value is used. If you do not enter a value, the system uses the default timeout (120 seconds). The corresponding AR System serverconfiguration file entry is DSO-Timeout-Normal. For more information, see Configuring-the-RPC-timeout-setting.

Specifies the number of seconds between occurrences of these operations:

• Checks by DSO for changes to the source and target forms
• Updates of cached DSO mapping information

By default, this option is set to 1800 seconds (30 minutes). The maximum value is 43200 seconds (12 hours). The corresponding AR System serverconfiguration file entry is DSO-Cache-Check-Interval. For more information, see, Setting-the-distributed-mapping-cache-refresh-interval.

Error Retry Option

Specifies how the DSO server responds to errors.

Valid values are:

• 0 (default)—Retry after standard connection and transmission errors.
• 1—Never retry after any error.
• 2—Retry after every error.
• 3—Retry after standard connection and transmission errors and after database errors.

The corresponding AR System serverconfiguration file entry is DSO-Error-Retry-Option.

Specifies the maximum number of records in the Distributed Pending form that DSO reads in a single database query.

Valid values are:

• Minimum number—1
• Maximum number—Unlimited

If no value is specified, the default is 1000. The corresponding AR System serverconfiguration file entry is DSO-Max-Pending-Records-Per-Query

Specifies whether to set the status of items in the DSO distributed pending queue to Retry after an attempt to perform the associated operation fails.

(The failure must be due to a recoverable error. Items that fail due to nonrecoverable errors are removed from the queue.) Valid values are

• T—(Default) Does not set the status to Retry. Instead, the status remains set to New. Depending on the number of pending items that the DSO server processes, this setting might improve the server's performance.
• F—Sets the status to Retry. Use this to differentiate items in the queue that have never been processed (status = New) from items that were processed but failed due to recoverable errors (status = Retry).

The corresponding AR System serverconfiguration file entry is DSO-Mark-Pending-Retry-Flag.

Regardless of this option's value, the pending item is still retried based on its retry configuration. For more information, see Monitoring-and-managing-pending-distributed-operations.

When selected, disables the DSO server that was installed on the same host as the AR System server. Use this when setting up a DSO server outside a firewall to support an AR System serverrunning behind a firewall. The corresponding AR System serverconfiguration file entry is DSO-Placeholder-Mode. For more information, see Configuring-DSO-for-firewalls.

Specifies whether to log failed pending distributed operations to the Distributed Pending Errors form.

The corresponding AR System serverconfiguration file entry is Log-DSO-Errors-To-Form. To learn how errors affect pending items, see Monitoring-and-managing-pending-distributed-operations.

Specifies whether to log AR System servererror 302 (entry does not exist in the database) in the arerror.log file when performing distributed delete operations.

• When this option is selected, ARERR 302 is never logged during distributed deletes.
• (Default) When this option is not selected, ARERR 302 is always logged during distributed deletes except when the Error Retry Option is set to 2 (retry after every error).

The corresponding AR System serverconfiguration file entry is DSO-Supress-No-Such-Entry-For-Delete. For more information, see Logging-the-ARERR-302-error-during-distributed-deletes.

When this option is selected, errors caused by valid problems might also be omitted from the log.