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
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.