DynamicTraceLoaderRemote.ArrayTooSmall (PROP) ¶ PROPERTY ArrayTooSmall : BOOL

DynamicTraceLoaderRemote.InitializeRemote (METH) ¶ METHOD InitializeRemote Method Initialize Initialize must be called before a call to method LoadFromFile can be executed. InOut: Scope Name Type Comment Input psApplication POINTER TO STRING Points to the name of the application, where the trace runs pArrItfTraceMgrVariables POINTER TO ARRAY [0..0] OF ITraceMgrVariable Points to an array, that will be used to store the record configuration pArrRecordConfiguration POINTER TO ARRAY [0..0] OF TraceRecordConfiguration Points to an array, that will be used to store the record configuration temporarily iMaxRecordCount INT Contains the maximum number of records, that can be stored in the array pArrRecordConfiguration itfDatasource IDatasources.IDatasource The datasource, where the trace recording will be done and the new configuration will by applied

DynamicTraceLoaderRemote.LoadFromFile (METH) ¶ METHOD LoadFromFile : RTS_IEC_RESULT Load a trace from a file. Before this method can be called the method InitializeLocal has to be called. Return codes: ERR_ENTRIES_REMAINING if an additional call to this method is required in order to process the loading. (only in the datasource case) ERR_NOT_SUPPORTED if the CmpTraceMgr library is too old. ERR_DS_INVALID_PATH if at least one variable of the trace packet configuration is unknown (also for the non-datasource case) ERR_OUT_OF_LIMITS if the array passed to the Initialize* method is not large enough to hold all the records from the file InOut: Scope Name Type Comment Return LoadFromFile RTS_IEC_RESULT Input psFilename POINTER TO STRING Points to the name of the file to load

DynamicTraceLoaderRemote.State (PROP) ¶ PROPERTY State : ETraceMgrPacketState Only used in case of a trace manager running on a remote application. Returns the current state of loading/creating the packet

DynamicTraceLoaderRemote.UnknownVariable (PROP) ¶ PROPERTY UnknownVariable : STRING This property returns only a non-empty string if the loaded trace configuration contains a variable, whose address info cannot be determined. We have the two cases: 1.) For a local application: The IAddressResolver instance was unable to resolve the address 2.) For a remote application accessed via datasource: The variable is missing in the datasource. If more than one variable is unknown this property returns the 1st unknown variable.

Function blocks ¶ Collections VisuFbRecordingRangeRingBuffer (FunctionBlock) ClearBefore (Method) Empty (Property) GetNext (Method) Increase (Method) LastStop (Property) SetLastStart (Method) SetLastStop (Method) StartIteration (Method) VisuStructRecordingRange (Struct) Logging LoggingHelp (GVL) VisuFbRecordConditionInfo (FunctionBlock) AddStart (Method) AddStop (Method) ClearBefore (Method) DumpRanges (Method) IsActive (Method)

Assert_ArrayOfWord_Equal (FUN) ¶ FUNCTION Assert_ArrayOfWord_Equal : BOOL Assertion function to check that two ARRAY OF WORD are equal. Two arrays are equal if all of the following conditions are met: * the two array have the same bounds * for each index the values of both arrays are equal InOut: Scope Name Type Initial Comment Return Assert_ArrayOfWord_Equal BOOL TRUE if the assertion passes succesfully, FALSE otherwise Input context IBaseIecUnitTest The instance of the test function block calling this function. This instance can be provided by using THIS^ . referenceArray POINTER TO WORD The reference array to check actualArray POINTER TO WORD The array to check wsErrorMsg WSTRING(Constants.WSTRING_LENGTH) “” A custom error message, that is added to the error message of the assertion itself. If this parameter is used, it is recommended to adapt the value of the library parameter Constants.WSTRING_LENGTH .

Assert_ArrayOfWord_NotEqual (FUN) ¶ FUNCTION Assert_ArrayOfWord_NotEqual : BOOL Assertion function to check that two ARRAY OF WORD are not equal. Two arrays are not equal if at least one of the following conditions is not met: * the two arrays have the same bounds * for each index the values of both arrays are equal InOut: Scope Name Type Initial Comment Return Assert_ArrayOfWord_NotEqual BOOL TRUE if the assertion passes succesfully, FALSE otherwise Input context IBaseIecUnitTest The instance of the test function block calling this function. This instance can be provided by using THIS^ . referenceArray POINTER TO WORD The reference array to check actualArray POINTER TO WORD The array to check wsErrorMsg WSTRING(Constants.WSTRING_LENGTH) “” A custom error message, that is added to the error message of the assertion itself. If this parameter is used, it is recommended to adapt the value of the library parameter Constants.WSTRING_LENGTH .

Assert_ArrayOfString_Contains (FUN) ¶ FUNCTION Assert_ArrayOfString_Contains : BOOL Assertion function to check that an ARRAY OF STRING contains a specific value InOut: Scope Name Type Initial Comment Return Assert_ArrayOfString_Contains BOOL TRUE if the assertion passes succesfully, FALSE otherwise Input context IBaseIecUnitTest The instance of the test function block calling this function. This instance can be provided by using THIS^ . referenceValue STRING The value that should be contained actualArray POINTER TO STRING The array to check wsErrorMsg WSTRING(Constants.WSTRING_LENGTH) “” A custom error message, that is added to the error message of the assertion itself. If this parameter is used, it is recommended to adapt the value of the library parameter Constants.WSTRING_LENGTH .

Assert_ArrayOfString_ContainsAllOf (FUN) ¶ FUNCTION Assert_ArrayOfString_ContainsAllOf : BOOL Assertion function to check that an ARRAY OF STRING contains all specified values. Important: only unique values are checked, the quantity of values is not considered. InOut: Scope Name Type Initial Comment Return Assert_ArrayOfString_ContainsAllOf BOOL TRUE if the assertion passes succesfully, FALSE otherwise Input context IBaseIecUnitTest The instance of the test function block calling this function. This instance can be provided by using THIS^ . referenceValues POINTER TO STRING An array with all values that should be contained. actualArray POINTER TO STRING The array to check wsErrorMsg WSTRING(Constants.WSTRING_LENGTH) “” A custom error message, that is added to the error message of the assertion itself. If this parameter is used, it is recommended to adapt the value of the library parameter Constants.WSTRING_LENGTH .