TraceMgrRecordUpdate5 (FUN) ¶ FUNCTION TraceMgrRecordUpdate5 : RTS_IEC_RESULT Records the current value of the trace variable of a record. For all trace records in the context of an IEC or system task, we use one timestamp for all values [CDS-66118]. Note This function is called cyclically by CmpTraceMgr. It should not be called by the application. InOut: Scope Name Type Comment Return TraceMgrRecordUpdate5 RTS_IEC_RESULT Returns the runtime system error code (see CmpErrors.library): ERR_PARAMETER if hPacket or hPrevRecord is not a valid handle ERR_NOTINITIALIZED if the packet is not currently recording (not started, trigger reached, …) ERR_PENDING if no value is recorded for this cycle due to TracePacketConfiguration.ulEveryNCycles ERR_FAILED if reading the value of the trace variable failed Input hPacket RTS_IEC_HANDLE The trace packet handle hRecord RTS_IEC_HANDLE The trace record handle pstTimestamp POINTER TO SYSTIME The address of the timestamp of the variable values

File and Project Information ¶ Scope Name Type Content FileHeader creationDateTime date 20.04.2021, 15:57:46 companyName string 3S-Smart Software Solutions GmbH libraryFile CmpTraceMgr.library primaryProject True productName CODESYS productProfile CODESYS V3.5 SP16 Patch 3 contentFile CmpTraceMgr.clean.json version version 2.0.0.0 ProjectInformation LinkInSimulation bool True Released True LastModificationDateTime date 20.04.2021, 15:57:46 LibraryCategories library-category-list System|SysLibs Author string 3S - Smart Software Solutions GmbH Company System CompiledLibraryCompatibilityVersion CODESYS V3.5 SP15 Description See: Description DocFormat reStructuredText Placeholder CmpTraceMgr Project CmpTraceMgr Title CmpTraceMgr Version version 3.5.17.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) IecVarAccess3 Interfaces ¶ Library Identification ¶ Name: IecVarAccess3 Interfaces Version: newest Company: System Namespace: IecVarAccess_Interfaces Library Properties ¶ LinkAllContent: False Optional: False QualifiedOnly: False SystemLibrary: False Key: IecVarAccess3 Interfaces, * (System) SysTime ¶ Library Identification ¶ Placeholder: SysTime Default Resolution: SysTime, * (System) Namespace: SysTime Library Properties ¶ LinkAllContent: False Optional: False QualifiedOnly: False SystemLibrary: False Key: SysTime 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)

TraceMgrPacketDisable (FUN) ¶ FUNCTION TraceMgrPacketDisable : RTS_IEC_RESULT Disables a trace packet. Does nothing if the trace packet is disabled. InOut: Scope Name Type Comment Return TraceMgrPacketDisable RTS_IEC_RESULT Returns the runtime system error code (see CmpErrors.library): ERR_PARAMETER if hPacket is not a valid packet handle Input hPacket RTS_IEC_HANDLE The trace packet handle

TraceMgrPacketDisableTrigger (FUN) ¶ FUNCTION TraceMgrPacketDisableTrigger : RTS_IEC_RESULT Disables the trigger of a trace packet. InOut: Scope Name Type Comment Return TraceMgrPacketDisableTrigger RTS_IEC_RESULT Returns the runtime system error code (see CmpErrors.library): ERR_PARAMETER if hPacket is not a valid packet handle Input hPacket RTS_IEC_HANDLE The trace packet handle

TraceMgrPacketEnable (FUN) ¶ FUNCTION TraceMgrPacketEnable : RTS_IEC_RESULT Enables a trace packet. Does nothing if the trace packet is enabled. InOut: Scope Name Type Comment Return TraceMgrPacketEnable RTS_IEC_RESULT Returns the runtime system error code (see CmpErrors.library): ERR_PARAMETER if hPacket is not a valid packet handle Input hPacket RTS_IEC_HANDLE The trace packet handle

TraceMgrPacketEnableTrigger (FUN) ¶ FUNCTION TraceMgrPacketEnableTrigger : RTS_IEC_RESULT Enables the trigger of a trace packet. Note This function should be called if the trigger is currently disabled. If the trigger has already fired, call TraceMgrPacketResetTrigger to reset the trigger, instead. InOut: Scope Name Type Comment Return TraceMgrPacketEnableTrigger RTS_IEC_RESULT Returns the runtime system error code (see CmpErrors.library): ERR_PARAMETER if hPacket is not a valid packet handle Input hPacket RTS_IEC_HANDLE The trace packet handle

TraceMgrPacketGetAbsoluteStartTime (FUN) ¶ FUNCTION TraceMgrPacketGetAbsoluteStartTime : RTS_IEC_RESULT Returns the absolute start time of a trace packet or 0 if trace packet has not been started yet. Note The start time is the time when the packet was started for the first time. InOut: Scope Name Type Comment Return TraceMgrPacketGetAbsoluteStartTime RTS_IEC_RESULT Returns the runtime system error code (see CmpErrors.library): ERR_PARAMETER if hPacket is not a valid handle Input hPacket RTS_IEC_HANDLE The trace packet handle Inout pStartTime SYSTIME The start time (out)

TraceMgrPacketGetChangeTimestamp (FUN) ¶ FUNCTION TraceMgrPacketGetChangeTimestamp : RTS_IEC_RESULT Returns the timestamp of a trace packet’s last modification. InOut: Scope Name Type Comment Return TraceMgrPacketGetChangeTimestamp RTS_IEC_RESULT Returns the runtime system error code (see CmpErrors.library): ERR_PARAMETER if hPacket is not a valid packet handle Input hPacket RTS_IEC_HANDLE The trace packet handle Inout pdwTimestamp DWORD The modification timestamp (out)

TraceMgrPacketGetConfig (FUN) ¶ FUNCTION TraceMgrPacketGetConfig : RTS_IEC_RESULT Queries the configuration of a trace packet. InOut: Scope Name Type Comment Return TraceMgrPacketGetConfig RTS_IEC_RESULT Returns the runtime system error code (see CmpErrors.library): ERR_PARAMETER if hPacket is not a valid handle Input hPacket RTS_IEC_HANDLE The trace packet handle Inout pConfiguration TracePacketConfiguration The packet configuration (out)