logObjectCaches
logObjectCaches(samplingHandle: Integer;
persistentCacheStats: Boolean;
persistentCacheBuffers: Boolean;
transientCacheStats: Boolean;
transientCacheBuffers: Boolean;
remoteTransientCacheStats: Boolean;
remoteTransientCacheBuffers: Boolean;
userNumber: Integer;
userText: String);
The logObjectCaches method of the System class specifies the object cache statistics that are logged by invoking the NodeSampleCacheInfoCallBack or the NodeSampleObjectBuffer entry point, or both of these entry points, in the user library for each of the nodes in the sample definition group.
The JADE-supplied library logs the statistics to the file specified in the initializationParameter parameter of the System class beginSample method and writes the following statistics to your output file on each node in the group.
-
Cache header record (type 1) for cache statistics
-
Cache buffer records (type 2) for individual object buffers
The logObjectCaches method parameters are listed in the following table.
| Parameter | Description |
|---|---|
| samplingHandle | Identifies the sampling context returned by the beginSampleGroupDefinition method when sampling started |
| persistentCacheStats | Logs statistics of the persistent objects cache |
| persistentCacheBuffers | Logs statistics of the persistent object cache buffers |
| transientCacheStats | Logs statistics of the transient objects cache |
| transientCacheBuffers | Logs statistics of the transient object cache buffers |
| remoteTransientCacheStats | Logs statistics of the remote transient objects cache |
| remoteTransientCacheBuffers | Logs activities in the remote transient object cache buffers |
| userNumber | Identifies the sample in the corresponding user library invocations |
| userText | In conjunction with the userNumber parameter, identifies the sample |
To enable the logging of the cache statistics that you require, set the appropriate Boolean cache parameters to true. The following code fragment shows an example of the logObjectCaches method and its parameters.
system.logObjectCaches(samplingHandle, true, true, false, false, false, false, 50, "After the load data operation");
All buffers containing non-shared transient objects are listed when node sampling snapshots are requested. For details, see "
