beginIndividualRequestsLogging

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

The beginIndividualRequestsLogging method of the System class starts sampling individual requests or cache activities, or both, of all processes in each of the remote nodes in the sample definition group and invokes the NodeSampleIndividualRequestCallBack or the 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 beginSampleGroupDefinition method when sampling 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.

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

The Jade sampling libraries produce the following record types.

• Begin process record (type 6)

• BeginInterval record (type 11), containing your specified user number and text to the output file immediately, followed by one IndividualRequest record for each of the subsequent remote requests or one cache buffer activity record for each of the subsequent buffer cache activities, or both

• Individual local request records (record type 14)

• Individual remote request records (record type 10)

• Cache buffer activity records (record type 2)

For more details, see Chapter 4 of the Object Manager Guide.