Distributed Tuning Interface Reference : PvGetMkdeCommStatEx()
 
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,
    PVCOMMSTATEX*        pCommStatEx);
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.
Data for open files retrieved by calling PvGetSQLConnectionsData()
See Also
PvStart()
PvConnectServer()
PvGetSQLConnectionsData()
PvGetMkdeUsage()
PvFreeSQLConnectionsData()
PvDisconnect()
PvStop()