File and Project Information ¶ Scope Name Type Content FileHeader creationDateTime date 13.12.2023, 11:05:14 companyName string 3S-Smart Software Solutions GmbH libraryFile Trace Mgr Utils.library primaryProject True productName CODESYS productProfile CODESYS V3.5 SP16 Patch 3 contentFile Trace Mgr Utils.clean.json version version 2.0.0.0 ProjectInformation IECCodeConverter bool True Released True LastModificationDateTime date 13.12.2023, 11:05:12 LibraryCategories library-category-list Intern|Visu Author string CODESYS Development GmbH Company Intern CompiledLibraryCompatibilityVersion CODESYS V3.5 SP15 Patch 2 DefaultNamespace TraceMgr_Utils Description See: Description Placeholder TraceMgrUtils Project Trace Mgr Utils Title Trace Mgr Utils Version version 4.5.0.0

Library Reference ¶ This is a dictionary of all referenced libraries and their name spaces. Base Interfaces ¶ Library Identification ¶ Name: Base Interfaces Version: newest Company: System Namespace: IBaseLibrary Library Properties ¶ LinkAllContent: False Optional: False QualifiedOnly: False SystemLibrary: False Key: Base Interfaces, * (System) CAA FB Factory ¶ Library Identification ¶ Placeholder: CAA FB Factory Default Resolution: CAA FB Factory, * (CAA Technical Workgroup) Namespace: FBF Library Properties ¶ LinkAllContent: False Optional: False QualifiedOnly: True SystemLibrary: False Key: CAA FB Factory CAA Types Extern ¶ Library Identification ¶ Placeholder: CAA Types Default Resolution: CAA Types Extern, * (CAA Technical Workgroup) Namespace: CAA Library Properties ¶ LinkAllContent: False Optional: False QualifiedOnly: True SystemLibrary: False Key: CAA Types CDSV3ProtocolUtils ¶ Library Identification ¶ Placeholder: CDSV3ProtocolUtils Default Resolution: CDSV3ProtocolUtils, * (3S - Smart Software Solutions GmbH) Namespace: CDSV3Prot Library Properties ¶ LinkAllContent: False Optional: False QualifiedOnly: True SystemLibrary: False Key: CDSV3ProtocolUtils CmpApp ¶ Library Identification ¶ Placeholder: CmpApp Default Resolution: CmpApp, * (System) Namespace: CmpApp Library Properties ¶ LinkAllContent: False Optional: False QualifiedOnly: False SystemLibrary: False Key: CmpApp CmpBinTagUtilIec ¶ Library Identification ¶ Placeholder: CmpBinTagUtilIec Default Resolution: CmpBinTagUtilIec, * (System) Namespace: CmpBinTagUtilIec Library Properties ¶ LinkAllContent: False Optional: False QualifiedOnly: False SystemLibrary: False Key: CmpBinTagUtilIec CmpErrors2 Interfaces ¶ Library Identification ¶ Name: CmpErrors2 Interfaces Version: newest Company: System Namespace: CmpErrors Library Properties ¶ LinkAllContent: False Optional: False QualifiedOnly: False SystemLibrary: False Key: CmpErrors2 Interfaces, * (System) CmpEventMgr ¶ Library Identification ¶ Placeholder: CmpEventMgr Default Resolution: CmpEventMgr, * (System) Namespace: CmpEventMgr Library Properties ¶ LinkAllContent: False Optional: False QualifiedOnly: False SystemLibrary: False Key: CmpEventMgr CmpLog ¶ Library Identification ¶ Placeholder: CmpLog Default Resolution: CmpLog, * (System) Namespace: CmpLog Library Properties ¶ LinkAllContent: False Optional: False QualifiedOnly: False SystemLibrary: False Key: CmpLog CmpTraceMgr ¶ Library Identification ¶ Placeholder: CmpTraceMgr Default Resolution: CmpTraceMgr, * (System) Namespace: CmpTraceMgr Library Properties ¶ LinkAllContent: False Optional: False QualifiedOnly: False SystemLibrary: False Key: CmpTraceMgr Collections ¶ Library Identification ¶ Placeholder: Collections Default Resolution: Collections, * (System) Namespace: Collections Library Properties ¶ LinkAllContent: False Optional: False QualifiedOnly: False SystemLibrary: False Key: Collections Component Manager ¶ Library Identification ¶ Placeholder: Component Manager Default Resolution: Component Manager, * (System) Namespace: Component_Manager Library Properties ¶ LinkAllContent: False Optional: False QualifiedOnly: False SystemLibrary: False Key: Component Manager Datasources Interfaces ¶ Library Identification ¶ Name: Datasources Interfaces Version: newest Company: 3S - Smart Software Solutions GmbH Namespace: IDatasources Library Properties ¶ LinkAllContent: False Optional: False QualifiedOnly: True SystemLibrary: False Key: Datasources Interfaces, * (3S - Smart Software Solutions GmbH) Standard ¶ Library Identification ¶ Placeholder: Standard Default Resolution: Standard, * (System) Namespace: Standard Library Properties ¶ LinkAllContent: False Optional: False QualifiedOnly: False SystemLibrary: False Key: Standard StringUtils ¶ Library Identification ¶ Placeholder: StringUtils Default Resolution: StringUtils, * (System) Namespace: Stu Library Properties ¶ LinkAllContent: False Optional: False QualifiedOnly: False SystemLibrary: False Key: StringUtils SysMem ¶ Library Identification ¶ Placeholder: SysMem Default Resolution: SysMem, * (System) Namespace: SysMem Library Properties ¶ LinkAllContent: False Optional: False QualifiedOnly: False SystemLibrary: False Key: SysMem SysTimeCore ¶ Library Identification ¶ Placeholder: SysTimeCore Default Resolution: SysTimeCore, * (System) Namespace: SysTimeCore Library Properties ¶ LinkAllContent: False Optional: False PublishSymbolsInContainer: True QualifiedOnly: False SystemLibrary: False Key: SysTimeCore SysTimeRtc ¶ Library Identification ¶ Placeholder: SysTimeRtc Default Resolution: SysTimeRtc, * (System) Namespace: SysTimeRtc Library Properties ¶ LinkAllContent: False Optional: False PublishSymbolsInContainer: True QualifiedOnly: False SystemLibrary: False Key: SysTimeRtc SysTypes2 Interfaces ¶ Library Identification ¶ Name: SysTypes2 Interfaces Version: newest Company: System Namespace: SysTypes Library Properties ¶ LinkAllContent: False Optional: False QualifiedOnly: False SystemLibrary: False Key: SysTypes2 Interfaces, * (System) Trace Mgr2 Interfaces ¶ Library Identification ¶ Name: Trace Mgr2 Interfaces Version: newest Company: Intern Namespace: TraceMgr_Interfaces Library Properties ¶ LinkAllContent: False Optional: False QualifiedOnly: False SystemLibrary: False Key: Trace Mgr2 Interfaces, * (Intern)

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

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)