The Message Logger Transform accepts messages from the inport, data to log, and logs the data as controlled by the specified properties.



Controlled Recording: This property enables or disables the Recording port. When True, data is written to a file while the Recording port is high (True). When False, data is logged regardless of the value of the Recording port.

Do Write: When this property is True, messages are logged. If set to False, no action is taken.

Time Stamp Type

Two kinds of time stamps for recorded data are available: PC time (absolute time) and Scenario time (relative to the start of the Scenario). Both can be present together (in order: <PC time>< Scenario time >) or either one or neither.

Add PC Time: Add absolute (PC) time stamp in the format <yyyy-mm-dd> before every message written to the file and before the Scenario time stamp, if any.

Add Scenario Time: Add Scenario time stamp in nanoseconds before every message written to the file and after the PC time stamp, if any.

Time Stamp Placement

New Line Before Time Stamp: If True, the time stamp is placed at the beginning of a new line. Otherwise the time stamp is appended to the previously recorded data.

New Line After Time Stamp: If True, each portion of recorded data starts on a new line after the time stamp. Otherwise data is appended to the time stamp.

Output File

Single Output File: If false, then a new unique file with the name <TransformName><InternalScenarioTimeStamp in nanoseconds>.log is created in the Scenario output directory (.mxout) for each Recording port high or entire Scenario run depending on the value of Controlled Recording .
For example:

Message Logger20160926153913.log

If true, then all data is appended to a single file. Its name and location are controlled by the value of Single Output File Full Name property.

Single Output File Full Name: For the case when Single Output File property is true, this property must specify the path, name and extension of the output file or can be empty, in which case file “<TransformName>.log” in the project folder is used. All recorded data is appended to this file. If the file does not exist, it is created.

Use Time Stamp Delimiter: If true, then one space is added after each time stamp. If false, then each time stamp is enclosed within < and >.