beginSampleGroupDefinition

beginSampleGroupDefinition(): Integer;

The beginSampleGroupDefinition method of the System class opens a new remote sampling context for a group of nodes. The nodes are included in the sampling context by using the System class enableRemoteSampling method.

The beginSampleGroupDefinition method returns the sampling handle number used to identify the sampling context that is opened. All subsequent methods use this sampling context handle as the first parameter, and they are initially executed by the server node and sent to each of the nodes in the definition group by means of internal notifications.

Any error condition at the individual node level is written to the JADE Object Manager message log file for that node.

The following example shows the use of the beginSampleGroupDefinition method.

testManualSamplingFullInterval();
vars
    cust           : Customer;
    samplingHandle : Integer;
begin
    samplingHandle := system.beginSampleGroupDefinition;
    system.beginSample("filesmpl", "c:\temp\fullInterval%p, txt");
    system.logObjectCaches(samplingHandle, true, true, false, false,
                           false, false, 111, "cachesSampling");
    system.beginIndividualRequestsLogging(samplingHandle, false, true, true,
                                          true, false, 557, "fullInterval");
    foreach cust in Customer.instances do
        write cust.name;
    endforeach;
    system.endIndividualRequestsLogging(samplingHandle, 557,
                                        "fullInterval");
    system.endSample(samplingHandle);
    system.endSampleGroupDefinition(samplingHandle);
end;

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