Tag

Value

M/O

Default

Description

#Size

Decimal

O

4

Maximum size of the log file in kB.

If the file size is exceeded, the oldest value in the log file is overwritten. (ring buffer)

#File

String

O

<definition>.log

<definition>.idx

Name of the log and index file (contains the actual position in File -> Ring buffer).

If this parameter isn't defined but the option Type=<type> type will be the name of log and index file.

<type>.log

<type>.idx

#Separator

O

<TAB>

Column separator, one character

#dt

Decimal

O

0

Time interval for log entry in [s], if > 0. Alternatively the data logging can also be initiated via the Control variable from the PLC.

#Header

String

O

Header in log file

#TimeFormat

<format>

O

%10lu

A special format can be defined for the time stamp in the first column.

#Control

Variable

O

Control variable of type DWORD.
If this variable is not defined, each value change is logged but at a maximum rate of one record per second.

The variable name may contain group placeholders. The are replaced by the parameters defined in the VarValue cell of DataLog object.

#TimeStamp

Variable

O

Variable for the time stamp (first column). Must be of type DWORD.
If this variable is not configured, the EPAM system time is logged.

The variable name may contain group placeholders. The are replaced by the parameters defined in the VarValue cell of DataLog object.

#BusyCursor

{on¦off}

O

off

The BusyCursor (hour glass) is displayed during an export/save operation.

#Export

<format>

O

Automatic export if <format> is defined. The same rules apply to <format> as to #variable for type DT. The entry for <format> with the actual time forms the name for the export file.
Each time a log entry is written, the name is generated using the actual time. If the resulting text or file name changes, the Datalog file is exported under the new name.

One export per day sample:
log1-%[yy-mm-dd]DT.csv ➞ log1-12-03-09.csv

Automatic exports my be defined for: hourly, 12-hourly, daily, weekly, monthly, yearly.
The file name can be given an absolute path. Otherwise the file is exported to PATH_DAT.

If the definition is used for multiple #Datalog objects, ( empty #File parameter) use the placeholder <type> to integrate the type name into the filename.

Sample:

<type>-%[yy-mm-dd]DT.csv ➞ log1-12-03-09.csv

#AutoExport

{on¦off}

O

off

Use to disable the automatic export (see #Export). Typically used if the export will be trigged by the PLC with Export-Bit in the Control-Variable.

#LogFileFormat

{ascii¦utf16¦binary}

O

ascii

File format:

Variable

VarType

Format

Comment

Variablename1

Data type

Variableformat

Comment

Variablename2

...

Bit

Value

Meaning

Description

0

16#0000001

Trigger

The PLC sets the Trigger Ctrl bit to cause EPAM to start logging the Datalog entries (#dt set or > 0) or to log only one Datalog entry (#dt not set or 0). In the latter case, the RTS resets the Trigger bit to confirm that the Datalog entry was logged.

1

16#0000002

Export

PLC sets the Export Ctrl bit to cause EPAM to export the Datalog to PATH_DAT.

The RTS resets the bit to confirm action.

2

16#0000004

Reset

PLC sets the Reset Ctrl bit to cause EPAM to delete the Datalog file in the EPAM log directory (PATH_LOG -> Ramdrive).

The RTS resets the bit to confirm action.

3

16#0000008

Save

PLC sets the Save Ctrl bit to cause EPAM to save the Datalog file in the EPAM log directory (PATH_DAT).

The RTS resets the bit to confirm action.

4

16#0000010

HMI-Reset

EPAM sets the HMI Reset Ctrl bit to notify the PLC that the Datalog file in the EPAM log directory (EPAM Ramdrive) was deleted with theDatalog:[<name>].delete button action. The resetting of the HMI Reset Ctrl bit must be carried out by the PLC.

5

16#0000020

HMI-Save

EPAM sets the HMI Save Ctrl bit to notify the PLC that the Datalog file was saved in the EPAM log directory (PATH_DAT) with the Datalog:[<name>].save button action. The resetting of the HMI Save Ctrl bit must be carried out by the PLC.

6

16#0000040

HMI-Export

EPAM sets the HMI Export Ctrl bit to notify the PLC that the Datalog file was exported to PATH_DAT with the Datalog:[<name>].export button action. The resetting of the HMI Export Ctrl bit must be carried out by the PLC.