Assert_ArrayOfWString_ContainsOneOf (FUN) ¶ FUNCTION Assert_ArrayOfWString_ContainsOneOf : BOOL Assertion function to check that an ARRAY OF WSTRING contains at least one of the specified values. InOut: Scope Name Type Initial Comment Return Assert_ArrayOfWString_ContainsOneOf 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 WSTRING An array with values that should be contained. actualArray POINTER TO WSTRING 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_ArrayOfWString_ContainsSequence (FUN) ¶ FUNCTION Assert_ArrayOfWString_ContainsSequence : BOOL Assertion function to check that an ARRAY OF WSTRING contains a specific sequence of values InOut: Scope Name Type Initial Comment Return Assert_ArrayOfWString_ContainsSequence 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 WSTRING The array with the sequence that should be contained actualArray POINTER TO WSTRING 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_ArrayOfWString_Equal (FUN) ¶ FUNCTION Assert_ArrayOfWString_Equal : BOOL Assertion function to check that two ARRAY OF WSTRING 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_ArrayOfWString_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 WSTRING The reference array to check actualArray POINTER TO WSTRING 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_ArrayOfWString_NotEqual (FUN) ¶ FUNCTION Assert_ArrayOfWString_NotEqual : BOOL Assertion function to check that two ARRAY OF WSTRING 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_ArrayOfWString_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 WSTRING The reference array to check actualArray POINTER TO WSTRING 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 .

DynamicTraceLoader.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.

DynamicTraceLoaderRemote (FB) ¶ FUNCTION_BLOCK DynamicTraceLoaderRemote EXTENDS DynamicTraceLoader This function block is an enhancement of the DynamicTraceLoader function block to load a trace configuration from the local application and to create the packet on the remote PLC. Properties: ArrayTooSmall State UnknownVariable Methods: InitializeRemote LoadFromFile Initialize , inherited from DynamicTraceLoader Structure: ArrayTooSmall (Property) InitializeRemote (Method) LoadFromFile (Method) State (Property) UnknownVariable (Property)

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