Product Documentation

c-treeACE V11.0 Release Notes

Previous Topic

Next Topic

Optional c-treeACE READ_ERR Diagnostic Logging

Rare, but unexpected READ_ERR (36) messages have been reported. When the operating system denies a read request from the file system, normally, a system error code is reported such as "permissions denied" or otherwise. However, rare and sporadic cases have been reported where this additional error return was zero (0). Good practice dictates we should determine why the OS file system is denying a read operation for any reason. A diagnostic option is now available to generate additional context information, along with a server stack trace when this condition occurs.

DIAGNOSTICS READ_ERR

This option enables additional diagnostic logging of read errors. When this option is in effect and an unexpected read error occurs (for example, a READ_ERR with a 0 sysiocod value), FairCom Server logs the following message to CTSTATUS.FCS and creates a process stack dump of the FairCom Server process (on systems that support that ability):

Mon Sep 14 12:23:19 2015

- User# 00020 READ_ERR: loc 5 file <FILENAME> offset <OFFSET> iosize <READ_SIZE_IN_BYTES> syserr <SYSTEM_ERROR_CODE> [physical file size <FILE_SIZE_ON_DISK>]

Mon Sep 14 12:23:21 2015

- User# 00020 Dumped stack for server process 20788, log=1, loc=0, rc=0

DIAGNOSTICS READ_ERR can be enabled and disabled at runtime by calling ctSETCFG() or using ctadmn (menu option 10, Change Server Settings, then option 9, Change a DIAGNOSTICS option).

TOCIndex