REC.RETRIEVEDATA

Description

REC.RETRIEVEDATA retrieves a section of recorded data according to REC.RETRIEVESIZE from the received index; if no index is received, the drive retrieves the data from next section. An index is supplied to enable multiple retrieves and to give better control on the buffer in case of overflow. If no index or a negative value is present, then the index is ignored.

WorkBench uses this parameter to retrieve the data continuously for real time recoding.

The size of the data returned by this command depends on the number set by REC.RETRIEVESIZE.

Use REC.RETRIEVE for complete recording information view.

Notes:

If REC.RETRIEVESIZE is larger than the buffer size, then it simply returns the whole buffer (no error).

If the index is received, the data will be continuously returned starting from the given index (default starting index is 0).

If the index is out of the bounds of the buffer, then it will be ignored.

If recorder is active and REC.STOPTYPE==0, then this parameter returns an error.

If REC.STOPTYPE==1, then this parameter returns the next section of data in the buffer (even if it reached the end of the buffer, it will return to the beginning of the buffer and add the data from index 0.)

If REC.STOPTYPE==1 and the retrieve is too slow (gets overrun by the recorder), an overflow error message is returned instead of the retrieved data.

If REC.STOPTYPE==0 and no index is received, continuously send the sections of data until the end of the buffer is reached. Then, return to the beginning of buffer and continue.

A new REC.TRIG command automatically sets the index to 0.

Example

The following example retrieves data from index 100 in the size of 10 (hence places 100 to 109 in the buffer)

REC.NUMPOINTS 1000
REC.RETRIVESIZE 10
REC.TRIG
REC.RETRIEVEDATA 100

General Information

Type	R/W Parameter
Units	N/A
Range	N/A
Default Value	N/A
Data Type	N/A
See Also	REC.RETRIEVE, REC.RETRIEVEHDR, REC.RETRIEVESIZE
Start Version	M_01-00-00-000