beginIndividualRequestsLogging

beginIndividualRequestsLogging(samplingHandle:              Integer;
                               localRequests:               Boolean;
                               remoteRequests:              Boolean;
                               persistentCacheBuffers:      Boolean;
                               transientCacheBuffers:       Boolean;
                               remoteTransientCacheBuffers: Boolean;
                               userNumber:                  Integer;
                               userText:                    String);

The beginIndividualRequestsLogging method of the Node class starts sampling the individual requests or cache activities, or both, of all processes in the local node and invokes the NodeSampleIndividualRequestCallBack or NodeSampleObjectBufferCallBack entry point, or both of these entry points, in the user library specified in the libraryName parameter of the beginSample method.

The NodeSampleIntervalCallBack entry point is invoked once only before these entry points, with the eventType parameter in the entry point set to 1.

The beginIndividualRequestsLogging method parameters are listed in the following table.

Parameter Description
samplingHandle Identifies the sampling context returned by the beginSample method when sampling for the node started
localRequests Logs individual requests to the database of the node
remoteRequests Logs individual requests to remote nodes
persistentCacheBuffers Logs activities in the persistent object cache
transientCacheBuffers Logs activities in the transient object cache
remoteTransientCacheBuffers Logs activities in the remote transient object cache
userNumber Identifies the sample in the corresponding user library invocations
userText In conjunction with the userNumber parameter, identifies the sample

To enable the sampling of the statistics that you require, set the appropriate Boolean parameters to true. The following code fragment shows an example of the beginIndividualRequestsLogging method and its parameters.

node.beginIndividualRequestsLogging(samplingHandle, false, true, false,                  false, false, 4, "Start logging of remote requests");

The JADE sampling libraries produce the following record types.

For more details about the individual remote requests that are sampled in record types 2, 6, 7, 10, 11, and 14, see Chapter 4 of the JADE Object Manager Guide.