Filemark(tablename) – Campbell Scientific CR9000X Measurement and Control System User Manual

Page 336

Advertising
background image

Section 9. Program Control Instructions

FileMark(TableName)

Parameter
& Data Type

Enter

FILEMARK PARAMETERS

TableName

name

The name of the data table in which to insert the filemark..


FileMark is used to insert a file mark into a data file.

Syntax

If (condition) then FileMark

(TableName)

Remarks
After the FileMark instruction is encountered, a file mark will be added to the
next record written to the specified Table. The file mark can, optionally, be
used by the Card Convert utility to indicate that a new file should be started at
the mark. The marked record will be the last record of a file. The
following record in the DataTable will be the first record of the new file.
Therefore, the program logic should ensure that the FileMark instruction
is encountered immediately prior to writing the record desired to be the
last record of a file.

This capability to create multiple files from a single data table only exists in
the binary to ASCII converter (Card Convert Utility) and only with the raw
TOB3 data file. To make use of the file marks, files must be stored to a
PCMCIA card and retrieved through the Logger Files window, or by
removing the card and transferring the file directly to the computer.

File Marks can only be written to Data Tables stored on a
PCMCIA card. They can only be processed using the raw T0B3
binary file format. If the file is converted to a different format,
the file marks are lost.

NOTE

The following is a data file, generated by the following Example Program, that
has been converted to ASCII without processing the FileMarks. The records
that have FileMarks are highlighted red and have text added to the side for
illustrative purposes. The FileMarks cannot actually be viewed in the data
files.

File = TempConv.dat
"1999-04-15 10:52:57.5",90.5
"1999-04-15 10:52:58",90.6
"1999-04-15 10:52:58.5",89.3
"1999-04-15 10:52:59",88

"1999-04-15 10:52:59.5",87.5

'Record containing the FileMark

"1999-04-15 10:53:13.5",90.5
"1999-04-15 10:53:14",90.5
"1999-04-15 10:53:14.5",89.6
"1999-04-15 10:53:15",88.5

"1999-04-15 10:53:15.5",87.7

'Record containing the FileMark

"1999-04-15 10:53:28",90
"1999-04-15 10:53:28.5",90
"1999-04-15 10:53:29",88.9
"1999-04-15 10:53:29.5",88.1

"1999-04-15 10:53:30",87.6

'Record containing the FileMark

9-6

Advertising