Siemens S7-1200 - Page 383

Extended instructions
8.7 Recipes and Data logs
S7-1200 Programmable controller
System Manual, 03/2014, A5E02486680-AG
383
Parameter and type
Data type
Description
NAME IN Variant Data log name: You provide the name. This variant only
supports a String data type and can only be located in
local, DB, or M memory. (Default value: ' ')
The string reference is also used as the name of the data
log file. The name characters must follow the Windows
file system naming restrictions. Characters \ / : * ? " < > |
and the space character are not allowed.
ID In/Out DWord Data log numeric identifier: You store this generated
value for use with other Data log instructions. The ID
parameter is only used as an output with the
DataLogCreate instruction. (Default value: 0)
Symbolic name access for this parameter is not allowed.
HEADER In/Out Variant Pointer to data log column header names for the top row
of the data matrix encoded in the CSV file. (Default
value: null).
HEADER data must be located in DB or M memory.
The characters must follow standard CSV format rules
with commas separating each column name. The data
type may be a string, byte array, or character array.
Character/byte arrays allow increased size, where
strings are limited to a maximum of 255 bytes.
The HEADER parameter is optional. If the HEADER is
not parameterized, then no header row is created in the
Data log file.
DATA In/Out Variant Pointer to the record data structure, user defined type
(UDT), or array. Record data must be located in DB or M
memory.
The DATA parameter specifies the individual data
elements (columns) of a data log record and their data
type. Structure data types are limited to a single nesting
level. The number of data elements declared should
correspond to the number of columns specified in the
header parameter. The maximum number of data
elements you can assign is 253 (with a timestamp) or
255 (without a timestamp). This restriction keeps your
record inside the 256 column limit of an Excel sheet.
DONE OUT Bool The DONE bit is TRUE for one scan, after the last
request was completed with no error. (Default value:
False)
BUSY OUT Bool
• 0 - No operation in progress
• 1 - Operation on progress
ERROR OUT Bool The ERROR bit is TRUE for one scan, after the last
request was terminated with an error. The error code
value at the STATUS parameter is valid only during the
single scan where ERROR = TRUE.
STATUS
OUT
Word
Execution condition code (Default value: 0)