Commands for Running the Trace
General Information on Running Traces
If PC processor-consuming tasks are executed in EcoStruxure Machine Expert or on the PC running EcoStruxure Machine Expert while a trace is running, it may happen that variable values are not captured by the trace.
|
NOTICE |
|
LOSS OF DATA |
|
Avoid executing actions and/or PC applications that lead to a high processor load while running a trace. |
|
Failure to follow these instructions can result in equipment damage. |
The Add variable to trace command is available in the contextual menu that opens upon right-clicking a variable in a logic editor or in the declaration part or in the Variables tab of the Software Catalog. It allows you to add the selected variable to one of the already available traces or to a new trace.
Additionally the Add variable to trace command is available as a contextual menu in Watch List views, parameter editor, I/O module mapping editor, or from a function block instance editor.
The table describes how to create a new trace:
|
Step |
Action |
|---|---|
|
1 |
In the contextual menu, select the Add variable to trace command and <New trace>. Result: The Create new trace dialog opens: 
|
|
2 |
Enter a Trace name and click OK. The OK button is only enabled when the Trace name is valid. |
If you want the variable name to be displayed in the contextual menu, hold down the Ctrl key while opening the contextual menu.
For more information, refer also to Creating a Trace Object in the EcoStruxure Machine Expert online help.
The Add variable to trace contextual menu is not displayed for the following not traceable expressions:
oVariables in function blocks in offline mode
oStructures that combine variables as a parent
oStrings
oPointer
oDate
oTime
oArrays
oUser defined
oNot traceable parameters
NOTE: You may add a variable that may not be traceable once you download the trace to the controller. In this case, the message The variable is not traceable. appears. You have to remove the variable in order to use the trace.
The Add Variable command is available in the Trace menu (that is only visible if you are working in the trace editor). It opens the Trace Configuration > Variable Settings dialog box that allows you to add a new variable.
The Download Trace command is available in the Trace menu (that is only visible if you are working in the trace editor). It will download the trace configuration in order to get the tracing activated on the device runtime system. This is necessary for the first tracing and possibly later after changes in the trace configuration or the application program. For further information, refer to chapter Trace Editor in Online Mode.
The Start/Stop Trace command is available in the Trace menu (that is only visible if you are working in the trace editor). It toggles between start and stop tracing.
If tracing is stopped, the 
symbol is shown. Executing the command restarts the tracing. Thus, the data capturing starts on the run time system again and the current values are shown in the trace editor.
If tracing is running, the 
symbol is shown. Executing the command stops the tracing on the run time system and the last captured values are shown in the trace editor.
The Reset Trigger command is available in the Trace menu (that is only visible if you are working in the trace editor). It will reset the trigger, thus the trace is restarted after the trigger has fired.
The Configuration command is available in the Trace menu (that is only visible if you are working in the trace editor). It opens the Trace Configuration > Record Settings dialog box.
