Table of Contents
Advertisement
8.2.3.22
DATa:RECord:OPEN?
Returns the number of bytes of memory in the open set of data.
Example: DAT:REC:OPEN?
Response: 1203
This command must be preceeded by the DATa:REC:OPEN command (see
Section 8.2.3.23) which is used to open a set of data using a date/time range.
The response to this command indicates the number of unread bytes in the
date/time range specified by the last DATa:RECord:OPEN command. If the re-
sponse is 0, there are no readings stored in memory over the specified date/time
range. Use the DATa:RECord:READ? command to read the data from memory.
8.2.3.23
DATa:RECord:OPEN [(<year>,<month>,<day>,<hour>,<min-
ute>,<second>)[,(<year>,<month>,<day>,<hour>,<minute>,<sec-
ond>)]]
Opens a set of data in memory over the specified date/time range for reading.
Example: DAT:REC:OPEN 2003,9,15,0,0,0,2003,9,15,23,59,59
The first set of <year>, <month>, <day>, <hour>, <minute>, and <second> pa-
rameters indicate the "from" date and time of the block to open. This set of pa-
rameters is optional, but if specified, all parameters are required. If not
specified, all data in memory is opened for reading. The second set of <year>,
<month>, <day>, <hour>, <minute>, and <second> parameters may only be
specified if the first set are specified, and indicate the "to" date and time of the
block to open. This set of parameters is optional, but if specified, all parameters
are required. If not specified, the "to" date and time default to the current date
and time. If not specified, the actual time/date range of the data will likely in-
clude more data than requested because fo the sizes of the data blocks in mem-
ory. Use this command in conjunction with the DATa:RECord:OPEN? and
DATa:RECord:READ? commands to extract data from memory.
8.2.3.24
DATa:RECord:READ? [<num>]
Reads a block of data from memory.
Example: DAT:REC:READ?
Response: <bytes>,#11<binary data>
The <num> parameter is optional and defines the group size (number of bytes)
to read from memory. If not specified, 256 bytes is used as the default group
size. The response to this command consists of the number of bytes of data in
this response (<bytes>), followed by a marker (#11), followed by a string of bi-
nary data (<binary data>). The number of bytes in the <binary data> portion of
the response may be anywhere between 1 and <num> bytes (256 if <num> is
not specified). Use the DATa:RECord:OPEN? command to determine the exact
number of bytes in the open set of data.
8 Digital Communications Interface
Commands
101
Advertisement
Table of Contents
