Define EDMI Trace
Define trace conditions and optionally start the tracing of EDMinterface functions.
Arguments:
Trace file: |
Specify the name of the file that will hold the trace information. This argument is only effective when the [trace to file] option is set. The default file extension for <Trace file> is “.txt” |
Max file size: |
Specify an integer value that is the maximum number of bytes the specified <Trace file> can hold before the <Trace file> is closed, or rewound when the [ring file] option is set. Specifying the value 0 (zero) means no size limit for the <Trace File> is defined. This argument is only effective when the <Trace file> argument is specified and the [trace to file] option is set. |
Options:
accumulating command output: |
A global option that appends the command output to the EDMsupervisor output window. Otherwise the output window is refreshed and only the last command output is displayed. |
clear all options: |
Resets all Aux>TraceEDMI>Define options. |
EDMI calls: |
Specifies that the name of the EDMinterface function will be recorded at the time of entering the actual function. |
EDMI returns: |
Specifies that the name of the EDMinterface functions and the completion code from the actual function will be recorded at the time of leaving the actual function. |
EDMI parameters: |
Specifies that the name of the EDMinterface functions and the name and value of the function’s input arguments will be recorded. |
EDMI errors: |
When this option is set and the options [EDMI calls], [EDMI returns], and [EDMI parameters] are not set, then a full trace record for failing EDMinterface functions will be recorded, but no tracing of functions that is performed without an error condition. |
internal calls |
Specifies that EDMinterface calls performed within an EDMinterface macro function should be traced with the actual trace condition. An EDMinterface macro function is an EDMinterface function that calls other EDMinterface functions. Examples of EDMinterface macro functions are: edmiReadStepFile, edmiWriteStepFile, edmiCompileFile, edmiCompileExpresss_X, etc. |
trace to stdout: |
(Non Windows only) Specifies that the trace records should be written to the standard output device of the running Unix process. When this option is set and the [trace to file] option is set, the trace records will be written to the <Trace File> and to the standard output device of the running Unix process. |
ring file: |
Specifies that the <Trace file> is treated as a circular file, i.e., when the <Trace file> has grown to the size specified in the <Max file size> argument, the file is rewound and the trace records are written from the beginning of the file again. The effect of this option is that only the last trace records occupying maximum <Max file size> bytes can be read from the <Trace file> when the trace is terminated. |
trace to file: |
Specifies that the trace records should be written to the file specified in the <Trace file> argument. The content of the <Trace file> is in ordinary ASCII format that can be read by any text editor. This option is only effective when a valid file name is specified in the <Trace file> argument. |
start trace: |
Specifies that the EDMinterface trace should start immediately. |