Table of Contents
Advertisement
hs_playback_sample
Parameters
Examples
Usage
80
step
specifies the sample to send to the client, relative to the sample sent in
the most recent
hs_playback_sample
session. Valid values are 0 or positive numbers.
The default is +1, which sends the next later sample. At the beginning,
a step of +1 returns the first sample. Zero resends the most recently sent
sample. A step of +2 sends the next later sample after the one that a step
of +1 would have sent, and so on. An attempt to display a sample later
than the last sample returns an error message.
The
hs_initiate_playback
default (+1) sends the first sample in the playback session.
The definition of what constitutes a sample is affected by the
summarization_interval and missing_data_option parameters to the
hs_create_playback_session
If the playback session was created with a summarization_interval
parameter of
actual
in the playback session contains a data item with a statistic type of
"Value for Session"
for step is +1, the default.
retry_count
specifies the number of times that the Historical Server will retry, at
one-second intervals, to read data from a historical data file of a
recording session that is still recording at the time of playback.
The default is zero, that is, no retries are attempted and an error is
returned when playback reaches an end-of-file condition while reading
a historical data file.
1
This example plays back the next sample:
hs_playback_sample
2
This example skips over one sample and plays the next sample. If
recording is ongoing, Historical Server retries up to 30 times to
retrieve another sample if the end-of-file is reached.
hs_playback_sample 2, 30
Format of returned data
The
hs_playback_sample
returns one table for each playback view. The tables are arranged in the
same order in which you submitted the
commands that created the views.
command for the current playback
command initializes playback so that the
command.
,
, or a user-specified interval, and if any view
entire
or
, then the only permissible value
"Rate for Session"
command returns data in the form of tables. It
hs_create_playback_view
Historical Server
Advertisement
Table of Contents
