Skip to main content
Previous sectionNext section

DisconnectErr

Specify how processes respond to a disconnect.

Synopsis

[Miscellaneous]    DisconnectErr=n

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

Description

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.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 DisconnectErr() method of the %SYSTEM.Process class. See the class reference for details.