Caché ObjectScript Reference - InterSystems Documentation

System and Other Functionsprincipal I/O device. Error on disconnect behavior depends on the settings of both$ZUTIL(69,15) and $ZUTIL(69,60):• If $ZUTIL(69,15,0) and $ZUTIL(69,60,0) the process exits without reporting an errorto the application when a disconnect is detected. The default for both functions is 0.• If $ZUTIL(69,15,1) and $ZUTIL(69,60,0) the process receives a error whena disconnect is detected during a Caché ObjectScript READ or WRITE command tothe device.• If $ZUTIL(69,15,1) and $ZUTIL(69,60,1) the process receives a errorimmediately when the terminal is disconnected.You should be aware that when error on disconnect is enabled, a process continues to executeafter its principal device has been disconnected. It is the responsibility of the application todetect the disconnect condition and exit gracefully. Use care when enabling error on disconnect.The application must be prepared to recognize the error and handle it appropriatelyin error traps.Error on disconnect is only applicable to TCP devices and to terminal devices where a disconnectcan be recognized. Examples are modem controlled terminals and Windows Telnet,Windows LAT, and Windows local cterm (TRM:) connections. Error on disconnect is onlyapplicable to the principal device.This error on disconnect option can be set for the current process by calling $ZUTIL(68,15).ParametersnThe switch that controls whether Caché detects I/O device disconnection. 0 = Disables systemwidedisconnect detection. 1 = Enables system-wide disconnect detection.System-wide, disconnect detection is disabled by default. $ZUTIL(69,15) returns the currentsystem-wide setting without changing it. $ZUTIL(69,15,n) sets this option.This system-wide default can be configured. Go to the System Management Portal, selectConfiguration, then select Advanced Settings. On the pull-down Category list select Terminal.View and edit the current setting of ErrorOnDisconnect. When 1 (true), Caché issues a error when a disconnect is detected during a Caché ObjectScript READ or WRITEcommand to the device (equivalent to $ZUTIL(69,15,1) / $ZUTIL(69,60,0)). If 0 (false),no error is issued when a disconnect is detected. The default is 0.Setting $ZUTIL(69,15) changes the system configuration setting shown in the SystemManagement Portal; this change persists across a Caché shutdown and restart.652 Caché ObjectScript Reference