getRpcServerStatistics

getRpcServerStatistics(jdo:      JadeDynamicObject input;
                       detailed: Boolean);

The getRpcServerStatistics method of the Process class retrieves Remote Procedure Call (RPC) statistics relating to requests and replies sent to and from the database server node and the process specified by receiver object. The method receiver can be any current process, including the requesting process itself or a process executing on another node.

The values returned represent information about the connection between client node and database server node, and requests and replies between the nodes for the specified process. The values are returned as Integer64 properties in the dynamic object specified by the jdo parameter.

The calling process is responsible for creating and deleting the JadeDynamicObject instance.

The detailed parameter specifies whether the values include individual totals for each request type.

For details about the attributes returned in the dynamic object, see "Process::getRpcServerStatistics Method", in Chapter 4 of the JADE Object Manager Guide.

The calling process is responsible for creating and deleting the JadeDynamicObject instance. Properties are added to the object when the method is first called. The object can then be used in subsequent calls.

If the dynamic object passed to the method already contains properties that do not match properties to be returned, existing dynamic object properties are removed and replaced with appropriate properties. This method is most efficient when properties match those to be returned.

The cumulative values are held as 64-bit unsigned integer values, and are copied to the dynamic object as Integer64 values. The maximum value before they wrap around to negative values is therefore 2^63 - 1 (approximately 8 Exabytes).

The following example shows the use of the getRpcServerStatistics method.

showRpcProcessStats();
vars
   jdo : JadeDynamicObject;
begin
   create jdo transient;
   process.getRpcServerStatistics(jdo, false);
   write jdo.display;
epilog
   delete jdo;
end;

The output from the getRpcServerStatistics method shown in the previous example is as follows.

---RPCServerStatistics(106)---
timeStarted = 27 April 2007, 12:32:07
connectionType = 1
lastInboundRequest = 27 April 2007, 14:43:25
requestsFromClients = 706
repliesToClients = 705
requestPacketsFromClients = 706
replyPacketsToClients = 705
requestBytesFromClients = 111258
replyBytesToClients = 164806
requestsToClients = 0
repliesFromClients = 0
requestPacketsToClients = 0
replyPacketsFromClients = 0
requestBytesToClients = 0
replyBytesFromClients = 0
notificationPacketsToClients = 0
notificationBytesToClients = 0