Data Acquisition Toolbox
  Function/Property:
    Search    Help Desk 

Logging Information to Disk

The information logged to a file can be thought of as a stream of data and events as shown below.


The properties related to logging analog input information to disk are given below.

Table 4-12: Logging Properties
Property
 Values
 Description
LogFileName

 string

 Output log file name
Logging

 On|{Off}

 Determines if data is being logged or not
LoggingMode

 Disk|{Memory}|Disk&Memory

 Specifies where data is logged
LogToDiskMode

 {Overwrite}|Index

 Controls how disk file writes are performed

You can log data, events, hardware information, and engine information to a disk file by specifying a name for the LogFileName property and setting LoggingMode to Disk or Disk&Memory.

You can choose whether an output file is overwritten or if multiple log files will be created with the LogToDiskMode property. Setting LogToDiskMode to Overwrite causes the output file to be overwritten. Setting LogToDiskMode to Index causes new data files to be created, each with an indexed name based on the value of LogFileName. A new file is created for each start command issued and each analog input device object must be logged to a separate file.

Disk writes are performed as soon as possible after the current data block is filled.

Specifying an Output File Name

The output file naming scheme follows these rules:

Additionally, if LogToDiskMode is set to Index, then the output filename also follows these rules:

If a runtime error occurs during data logging, the engine will return an error message and stop data logging. Possible errors include the disk filling up, or if LogToDiskMode is set to Index and the output file specified by LogFileName already exists.


[ Previous | Help Desk | Next ]