MimerGetStatistics

Obtains server statistics information.

Statistics is returned in the form of counters. Counters may either be an absolute value representing the current status or a monotonically increasing value representing the number of occurred events since the server started. An example of the former is current number of users and an example of the latter is number of server page requests.

The available counter values are:

 

BSI_4K_PAGES

The number of 4 K pages available in the system.

BSI_32K_PAGES

The number of 32 K pages available in the system.

BSI_128K_PAGES

The number of 128 K pages available in the system.

BSI_PAGES_USED

The total number of pages in use.

BSI_4K_PAGES_USED

The number of 4 K pages in use.

BSI_32K_PAGES_USED

The number of 32 K pages in use.

BSI_128K_PAGES_USED

The number of 128 K pages in use.

Parameters

int32_t MimerGetStatistics (

            MimerSession sessionhandle,

            int32_t *counters,

            int16_t nr_of_counters)

sessionhandle

in

A session handle opened through a call to MimerBeginSession[C|8].

counters

inout

An array containing the counter values to retrieve.

On output, the array contains the corresponding counter values.

On return, a value of -2 indicates that the counter type was unknown, -1 indicate that the counter type was known but its value was not available.

nr_of_counters

in

Specifies the number of counters supplied in counters.

Returns

A negative value indicating an error, or zero if successful.

Return value

Description

MIMER_SUCCESS

Success.

MIMER_OUTOFMEMORY

If not enough memory could be allocated.

Other value < 0

Any of the server error codes listed in Return Codes.

Notes

This routine interacts with the database server.

Micro API compatible.