FairCom ISAM for C

IOPERFORMANCEX

Monitor Input/Output of data/index caching and count Low-Level file reads and writes (Extended version).

Short Name

IOPERFORMANCEX()

Type

Low-Level function

Declaration

LONG IOPERFORMANCEX(pVOID bufptr)

Description

IOPERFORMANCEX() is the extended version of IOPERFORMANCE(). In addition to the eight (8) values reported in IOPERFORMANCE(), IOPERFORMANCEX() reports the following eleven (11) additional values:

IOPERFORMANCE() Values:

DataBufferRequests	Data buffer requests.
DataBufferHits	Data buffer hits.
IndexBufferRequests	Index buffer requests.
IndexBufferHits	Index buffer hits.
NbrReadOperations	Number of read operations.
NbrBytesRead	Bytes read.
NbrWriteOperations	Number of write operations.
NbrBytesWritten	Bytes written.

IOPERFORMANCEX() Values:

NbrCommReadOperations	Number communication read operations.
NbrCommBytesRead	Communication bytes read.
NbrCommWriteOperations	Number of communication write operations.
NbrCommBytesWritten	Communication bytes written.
NbrTranSavepoint	Number of transaction save points.
NbrTranRestores	Number of transaction restore points.
NbrTranBegins	Number of transaction begin operations.
NbrTranEnds	Number of transaction end operations.
NbrTranAborts	Number of transaction abort operations.
NbrCheckPoints	Number of system checkpoints (snap shots taken by the system of the transaction processing information).
SystemTimeValue	The current system time in seconds from an arbitrary starting point.

The communication statistics ignore the traffic for the logon/logoff operations. In order to ensure proper statistics on multiple-processor hardware, add the following to the FairCom Server configuration file:

COMPATIBILITY MULTI_PROCESSOR

IOPERFORMANCEX() accepts an array of ULONG (Unsigned Longs) in which to place the performance data. ctIXPLMT is the size of the array for IOPERFORMANCEX(). ctIOPLMT is the array size for the non-extended version, IOPERFORMANCE(). This array dimension size should be used when working with this function in case the array is increased with a future release.

Return

IOPERFORMANCEX() always returns a 0 (zero) value indicating NO_ERROR. See c-tree Error Codes in the c-tree Programmer’s Reference Guide for a complete listing of valid c-tree error values.

Example

ULONG iopx[ctIXPLMT];

IOPERFORMANCEX(iopx);

printf("\n# check points = %ld time in seconds = %ld\n",

iopx[NbrCheckPoints], iopx[SystemTimeValue]);