V9 Update Guide

Additional SNAPSHOT Options

The FairCom DB SNAPSHOT feature now includes support for collecting disk read and write timings on a per-file basis when high-resolution timer support is activated.

Enable c-tree Disk Read/Write Times by File

Collection of disk I/O timings is disabled by default and is enabled with one of the following methods:

• Use the FairCom DB Monitor utility.
• Add the option DIAGNOSTICS SNAPSHOT_IOTIME to the FairCom DB configuration file, ctsrvr.cfg.
• Use the ctstat utility’s -iotime option.
• Use the ctSNAPSHOT() API function.

Programmatically Output c-tree Disk Read/Write Times by File

The ctSNAPSHOT() API function now supports a mode that writes snapshot statistics for all files open by FairCom DB to disk. Use the ctstat utility's -file option or call ctSNAPSHOT() using the ctPSScsvFile or ctPSStextFile mode as shown below to write snapshot statistics for all open files to the file SNAPFILE.FCS in comma-delimited or human-readable format.

Enable c-tree Function Call Times by File

Collection of function timings is disabled by default and can be enabled by any of the following methods:

• Add the option DIAGNOSTICS SNAPSHOT_WRKTIME to the FairCom DB configuration file, ctsrvr.cfg.
• Use the FairCom DB Monitor Utility.
• Use the ctstat utility’s -wrkstat option.
• Use the ctSNAPSHOT() API function.

Programmatically Output c-tree Function Call Times by File

The FairCom DB SNAPSHOT API supports a mode that writes function timings for all files open by FairCom DB to disk. Use the ctstat utility’s -funcfile option or call ctSNAPSHOT() using the ctPSScsvFunc or ctPSStextFunc mode as shown below to write function timings for all open files to the file SNAPFUNC.FCS in comma-delimited or human-readable format.