101BExtended instructions
8.7 Data logging
S7-1200 Programmable controller
300
System Manual, 11/2011, A5E02486680-05
8.7.2.5
DataLogNewFile
Table 8- 134 DataLogNewFile instruction
LAD / FBD
SCL
Description
"DataLogNewFile_DB"(
req:=_bool_in_,
records=:_udint_in_,
done=>_bool_out_,
busy=>_bool_out_,
error=>_bool_out_,
status=>_word_out_,
name=:_DataLog_out_,
ID:=_dword_inout_);
Allows your program to create a new data
log file based upon an existing data log file.
STEP 7 automatically creates the associated
instance DB when you insert the instruction.
2
In the SCL example, "DataLogNewFile_DB" is the name of the instance DB.
Table 8- 135 Data types for the parameters
Parameter and type
Data type
Description
REQ
IN
Bool
A low to high (positive edge) signal starts the operation. (Default value:
False)
RECORDS
IN
UDInt
The maximum number of data records the circular data log can contain
before overwriting the oldest entry. (Default value: 1)
The header record is not included. Sufficient available CPU load memory
must exist in order to successfully create the data log.
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
Numeric data log identifier(Default value: 0):
At execution, the ID input identifies a valid data log. The new data log
configuration is copied from this data log.
After execution, the ID parameter becomes an output that returns the ID
of the newly created data log file.
Note: Symbolic name access for this parameter is not allowed.
DONE
OUT
Bool
The DONE bit is TRUE for one scan, after the last request was completed
with no error.
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)
