Campbell Scientific CR9000X Measurement and Control System - Manual (Page 389)

Section 9. Program Control Instructions
Parameter Enter TABLEFILE PARAMETERS
Device:FileName
Constant String
in quotes The FileName parameter is used to specify the Device and FileName for the file
written to or read from. The created file will have a suffix of X.dat, where X is a
number that will be incremented each time a new file is written. FileName must be a
constant and enclosed in quotes. It is entered in the format of "Device:FileName"
where Device is CPU or CRD (compact flash card).
Options
Variable Code
0
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15 File Type & Format
TOB1, Header, TimeStamp, Record#
TOB1, Header, TimeStamp
TOB1, Header, Record#
TOB1, Header
TOB1, TimeStamp, Record#
TOB1, TimeStamp
TOB1, Record#
TOB1
TOA5, Header, TimeStamp, Record#
TOA5, Header, TimeStamp
TOA5, Header, Record#
TOA5, Header
TOA5, TimeStamp, Record#
TOA5, TimeStamp
TOA5, Record#
TOA5.
MaxFiles
Variable Specifies the maximum number of files to retain on the storage device. When the
MaxFiles is reached, the oldest file will be deleted prior to writing the new one. If
MaxFiles is set to -1, then no limit will be set for the maximum number of files that
can be written, until the storage device is full. Once the device is full, the oldest file
will be deleted prior to writing the new one. If MaxFiles is set to -2, there is no limit
set for the maximum number of files that can be written, but once the storage device
is full, no new files will be written. Thus, -1 is analogous to an auto-allocated ring
memory mode, and -2 is analogous to an auto-allocated fill and stop mode.
NumRecords/
TimeintoInterval
Variable If Interval is set to 0, enter the number of records to include in each file. A new file
will not be written until enough records have been written to the datalogger's table to
satisfy the NumRec parameter. If Interval is a non-zero value, enter the time into the
interval (or offset) that a file should be written. For instance, if Interval is set to 60,
Units is set to minutes, and this parameter is set to 15, records will be written at 15
minutes past the hour, each hour.
Interval
Variable Determines whether the instruction will write files based on a specified number of
records or on a time interval. If Interval is set to 0, files will be written once a
specified number of records is available in the datalogger's data table. If Interval has
a non-zero value, files will be written based on a time interval (which is determined
by using three parameters: TimeIntoInterval, Interval, and Units).
Units
Variable Specifies the units on which the TimeIntoInterval and Interval parameters will be
based. The options are microseconds, milliseconds, seconds, minutes, hours, or days.
OutStat
Variable Variable that holds a value indicating whether or not a new file has been stored. If a
new file is written when the instruction is executed, a -1 will be stored. If a new file
is not written, a 0 will be stored. Set to 0 instead of a variable to ignore.
LastFileName
Variable Variable that contains the name of the last file written. It must be defined as a string
and sized large enough to accommodate the saved file name. If 0 is entered for this
parameter, it is ignored. This parameter can be used, along with OutStat, to transfer a
file under datalogger control.
9-59