Description
This function, called after the begin() routine,
is designed to work with an existing connection
to a history repository and gather all of
the necessary data from the remote entity based on the
criteria set in the RSP_parseBegin function. It is important
that this function be called soon after calling
begin() so that a remote server doesn't time out
any network connections that may have been opened.
Each time this function is called a new "line" is returned.
If no more data exists, or if there is an error, undef is
returned instead. Each line of data contains a time
and a piece of data as well as a graph type if graph
data is being returned. These members are retrieved with
getTime(), getData(), and getGraphType(). For example:
$pd->begin("plato", "CPUInfo", "idle", -1, -1, 0);
my $line;
while(defined($line = $pd->next())) {
print $line->getTime() . " " . $line->getData() . " " . $line->getGraphType() . "\n";
}
|
The time is measured in UNIX time, that is, seconds since
the Epoch (00:00:00, January 1, 1970).