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.


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.Miscellanous class (as described in the class reference) or by editing the CPF in a text editor (as described in the Editing the Active CPF section of the “Introduction to the Configuration Parameter File” chapter in this book).

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