Skip to main content
Previous section   Next section

DisconnectErr

Enable/disable a process to receive disconnect errors.

Synopsis

[Miscellaneous]    DisconnectErr=n

Description

This setting conditions how Caché responds to a disconnect of the principal I/O device. The value n may be 1 or 0:

  • When 1 (true) the process receives a <DSCON> error when a disconnect is detected during a Caché Write or Read command.

  • When 0 (false) the process exits without reporting an error to the application when a disconnect is detected.

You should be aware that if DisconnectErr is enabled, a process will continue to execute after its principal device has been disconnected. It is the responsibility of the application to detect the disconnect condition and exit gracefully. Use care when enabling DisconnectErr. The application must be prepared to recognize the <DSCON> error and handle it appropriately in error traps.

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 cterm (TRM:) connections. DisconnectErr is only applicable to the principal device.

Examples

DisconnectErr=0

Range of Values

0 or 1. The default is 0.

Management Portal

On the page System Administration > Configuration > Additional Settings > Compatibility, in the DisconnectErr row, select Edit. Choose true (selected) or false (cleared).