Product Information > JADE Object Manager Guide > Chapter 4 - JADE System Instrumentation and Diagnosis > DbFilegetStatistics Method

DbFile::getStatistics Method

 getStatistics(jdo: JadeDynamicObject input);

The DbFile class getStatistics method returns statistics relating to read and write operations on the persistent database file represented by the DbFile instance used as the method receiver. The values are returned as Integer64 properties in the dynamic object specified by the jdo parameter.

The calling process is responsible for creating and deleting the JadeDynamicObject instance.

The properties returned in the JadeDynamicObject are listed in the following table.

Property Description
logicalReads The total number of read requests
logicalWrites The total number of write requests
logicalReadBytes The total accumulated size for all read requests
logicalWriteBytes The total accumulated size for all write requests
physicalReads The actual number of file read operations
physicalWrites The actual number of file write operations
physicalReadBytes The actual accumulated size for all file read operations
physicalWriteBytes The actual accumulated size for all file write operations

The logical counts record the number and size of requests that can be serviced in cache, whereas the physical counts record actual disk activity.

The returned values include cumulative counters, which are not reset during the lifetime of the database server node. To work out the differences, you must compare values from one execution of the getStatistics method with the previous values.

Properties are added to the object when the method is first called. The object can then be used in subsequent calls.

If the dynamic object passed to the method already contains properties that do not match the properties to be returned, the existing dynamic object properties are removed and replaced with the appropriate properties. This method is most efficient when the properties match those to be returned.

For examples of the use of and output from this method, see the DbFile class getStatistics method in Volume 1 of the JADE Encyclopaedia of Classes.