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 Node class specifies the local node object cache statistics that are logged by invoking the NodeSampleCacheInfoCallBack or NodeSampleObjectBuffer entry point, or both of these entry points, in the user library.

The JADE-supplied library logs the statistics to the file specified in the initializationParameter parameter of the beginSample method and writes the following statistics to your output file.

The logObjectCaches 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
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.

node.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 more details, see "Statistics File Format", in Chapter 4 of the JADE Object Manager Guide.