Extended instructions
9.9 Recipes and Data logs
S7-1200 Programmable controller
System Manual, V4.2, 09/2016, A5E02486680-AK
511
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 DataLog-
Create 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 val-
ue: 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 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 ele-
ments (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 corre-
spond 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 re-
quest 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.
Execution condition code (Default value: 0)