Skip to main content


Allow processes to receive disconnect errors asynchronously.


[Miscellaneous]    AsyncDisconnectErr=n

n is either 1 (true) or 0 (false). The default value is 0.



This parameter has been retained for compatibility, but should not be used when building new applications.

AsyncDisconnectErr modifies the behavior of InterSystems IRIS® data platform when DisconnectErr is enabled. When AsyncDisconnectErr is enabled (n = 1), the process receives an asynchronous <DSCON> error at the time a disconnect occurs on the device. This error occurs at the next command executed, and interrupts hang commands

When this parameter is not enabled, the process receives a <DSCON> error at the next read or write command.

AsyncDisconnectErr is only applicable to Telnet connections on Windows. It has no effect on any other device type or operating system. If DisconnectErr is set to 0 (false), then AsyncDisconnectErr has no effect.

Changing This Parameter

On the Compatibility page of the Management Portal (System Administration > Configuration > Additional Settings > Compatibility), in the AsyncDisconnectErr row, click Edit. Select AsyncDisconnectErr to enable this setting.

Instead of using the Management Portal, you can change AsyncDisconnectErr in the Config.MiscellanousOpens in a new tab class (as described in the class reference) or by editing the CPF with a text editor.

To change this parameter for a single process only (as opposed to instance-wide), use the AsyncDisconnectErr()Opens in a new tab method of the %SYSTEM.ProcessOpens in a new tab class. See the class reference for details.

FeedbackOpens in a new tab