PvGetMkdeUsageEx()
Retrieves the resource usage information from the MicroKernel Engine database engine, including current, peak, and maximum settings for use count, session count, data in use, files, handles, transactions, clients, threads, and locks, and the duration, in seconds, that the database engine has been running (referred to as “engine uptime”).
Header File: monitor.h (See also
Header Files)
Function First Available In Library: w3dbav78.dll (Windows), libpsqldti.so (Linux), libpsqldti.dylib (macOS) (See also
Link Libraries)
Syntax
BTI_SINT PvGetMkdeUsageEx(
BTI_LONG hConnection,
Arguments
In | hConnection | Connection handle that identifies the server. Connection handles are obtained with the
PvConnectServer() function. |
Out | pMkdeUsage | Address of a
PVMKDEUSAGEEX structure to receive the MicroKernel Engine resource usage information. |
Return Values
P_OK | The operation was successful. |
P_E_INVALID_HANDLE | Invalid connection handle. |
P_E_NULL_PTR | Call with NULL pointer. |
P_E_FAIL | Failed for other reasons. |
Remarks
This function, PvGetMkdeUsageEx(), is similar to
PvGetMkdeUsage(); the only difference is in the structures. While supplying the same elements,
PVMKDEUSAGEEX supplies four-byte elements when
PVMKDEUSAGE supplies two-byte ones.
The following preconditions must be met:
•Connection established by
PvConnectServer() or if you are performing the operation on a local machine, P_LOCAL_DB_CONNECTION may be used as the connection handle.
See Also