Specify how processes respond to a disconnect.
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.
DisconnectErr determines how InterSystems IRIS® data platform responds to a disconnect of the principal I/O device. When the parameter is enabled, the process receives a <DSCON> error when a disconnect is detected during an ObjectScript Write or Read command. When the parameter is not enabled, the process exits without reporting an error to the application when a disconnect is detected.
If DisconnectErr is enabled, a process continues to execute after its principal device has been disconnected. It is the responsibility of the application to detect the <DSCON> error and exit gracefully. Use care when enabling DisconnectErr.
DisconnectErr is only applicable to TCP devices and to terminal devices where a disconnect can be recognized. Examples are modem controlled terminals and Windows Telnet, and Windows local iristerm (TRM:) connections. DisconnectErr is only applicable to the principal device.
Changing This Parameter
On the Compatibility page of the Management Portal (System Administration > Configuration > Additional Settings > Compatibility), in the DisconnectErr row, click Edit. Select DisconnectErr to enable this setting.
Instead of using the Management Portal, you can change DisconnectErr 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 DisconnectErr()Opens in a new tab method of the %SYSTEM.ProcessOpens in a new tab class. See the class reference for details.