PvGetMkdeCommStatEx()
Retrieves all the MicroKernel Engine communication statistics data.
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 PvGetMkdeCommStatEx(
BTI_LONG hConnection,
Arguments
In | hConnection | Connection handle that identifies the server. Connection handles are obtained with the
PvConnectServer() function. |
Out | pCommStatEx | Address of a
PVCOMMSTATEX structure to receive the MicroKernel Engine communication statistics. |
Return Values
P_OK | The operation was successful. |
P_E_INVALID_HANDLE | Invalid connection handle. |
P_E_COMPONENT_NOT_LOADED | Component is not loaded |
P_E_NULL_PTR | Call with NULL pointer. |
P_E_FAIL | Failed to disconnect to the named server. |
Remarks
This function returns the same data as PvGetMkdeCommStat but uses a new structure PVCOMMSTATEX that contains two additional elements. The added elements (totalTimeouts and totalRecoveries) are related to the PSQL Auto Reconnect (PARC) feature. See Advanced Operations Guide for more information on PARC.
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