TraceMgrPacketReadEnd (FUN) ¶ FUNCTION TraceMgrPacketReadEnd : RTS_IEC_RESULT End reading trace packet. See description of function TraceMgrPacketReadBegin . InOut: Scope Name Type Comment Return TraceMgrPacketReadEnd RTS_IEC_RESULT Returns the runtime system error code (see CmpErrors.library): ERR_PARAMETER if hPacket is not a valid packet handle ERR_NOTINITIALIZED if hPacket is not complete and started Input hPacket RTS_IEC_HANDLE The trace packet handle

TraceMgrPacketReadFirst (FUN) ¶ FUNCTION TraceMgrPacketReadFirst : RTS_IEC_HANDLE Reads the contents of the first record. Note if the result code is ERR_ENTRIES_REMAINING, data has been successfully copied to pTraceBuffer, but more data can be read by a subsequent call. (Either because the destination buffer was too small, or because new data has been recorded in the mean time.) Note You should call TraceMgrPacketReadBegin before calling this function, to make sure any outstanding trace values are written to the trace buffers. Note Data is always returned in little endian byte order even if the device has big endian byte order. InOut: Scope Name Type Comment Return TraceMgrPacketReadFirst RTS_IEC_HANDLE Returns the runtime system error code (see CmpErrors.library): ERR_PARAMETER if hPacket is not a valid packet handle ERR_NO_OBJECT if the packet does not have a single record ERR_NOTINITIALIZED if the packet is not complete ERR_TIMEOUT if reading took too long ERR_ENTRIES_REMAINING if more data can be read by a subsequent call (this is not an error) Input hPacket RTS_IEC_HANDLE The trace packet handle Inout pTraceBuffer TraceRecordEntry Pointer to the destination buffer pulReadBytes UDINT Size of the destination buffer in bytes (in), number of bytes copied (out) pResult RTS_IEC_RESULT The result code

TraceMgrPacketReadFirst2 (FUN) ¶ FUNCTION TraceMgrPacketReadFirst2 : RTS_IEC_HANDLE Reads the contents of the first record, starting at a given time stamp. Only entries with a time stamp greater than or equal to ulTimestamp are copied. If the time stamp is zero, the function behaves like TraceMgrPacketReadFirst . Note if the result code is ERR_ENTRIES_REMAINING, data has been successfully copied to pTraceBuffer, but more data can be read by a subsequent call. (Either because the destination buffer was too small, or because new data has been recorded in the mean time.) Note You should call TraceMgrPacketReadBegin before calling this function, to make sure any outstanding trace values are written to the trace buffers. Note Data is always returned in little endian byte order even if the device has big endian byte order. InOut: Scope Name Type Comment Return TraceMgrPacketReadFirst2 RTS_IEC_HANDLE Returns the runtime system error code (see CmpErrors.library): ERR_PARAMETER if hPacket is not a valid packet handle ERR_NO_OBJECT if the packet does not have a single record ERR_NOTINITIALIZED if the packet is not complete ERR_TIMEOUT if reading took too long ERR_ENTRIES_REMAINING if more data can be read by a subsequent call (this is not an error) Input hPacket RTS_IEC_HANDLE The trace packet handle ulTimestamp UDINT The time stamp (relative to the trace start time) from where to start copying Inout pTraceBuffer TraceRecordEntry Pointer to the destination buffer pulReadBytes UDINT Size of the destination buffer in bytes (in), number of bytes copied (out) pResult RTS_IEC_RESULT The result code

TraceMgrPacketReadNext (FUN) ¶ FUNCTION TraceMgrPacketReadNext : RTS_IEC_HANDLE Reads the contents of the next record. Note if the result code is ERR_ENTRIES_REMAINING, data has been successfully copied to pTraceBuffer, but more data can be read by a subsequent call. (Either because the destination buffer was too small, or because new data has been recorded in the mean time.) Note Data is always returned in little endian byte order even if the device has big endian byte order. InOut: Scope Name Type Comment Return TraceMgrPacketReadNext RTS_IEC_HANDLE Returns the runtime system error code (see CmpErrors.library): ERR_PARAMETER if hPacket is not a valid packet handle or if hPrevRecord is not a valid record handle ERR_NO_OBJECT if there is no next record ERR_NOTINITIALIZED if the packet is not complete ERR_TIMEOUT if reading took too long ERR_ENTRIES_REMAINING if more data can be read by a subsequent call (this is not an error) Input hPacket RTS_IEC_HANDLE The trace packet handle hPrevRecord RTS_IEC_HANDLE The trace record handle of the current record Inout pTraceBuffer TraceRecordEntry Pointer to the destination buffer pulReadBytes UDINT Size of the destination buffer in bytes (in), number of bytes copied (out) pResult RTS_IEC_RESULT The result code

TraceMgrPacketReadNext2 (FUN) ¶ FUNCTION TraceMgrPacketReadNext2 : RTS_IEC_HANDLE Reads the contents of the next record, starting at a given time stamp. Only entries with a time stamp greater than or equal to ulTimestamp are copied. If the time stamp is zero, the function behaves like TraceMgrPacketReadNext . Note if the result code is ERR_ENTRIES_REMAINING, data has been successfully copied to pTraceBuffer, but more data can be read by a subsequent call. (Either because the destination buffer was too small, or because new data has been recorded in the mean time.) Note Data is always returned in little endian byte order even if the device has big endian byte order. InOut: Scope Name Type Comment Return TraceMgrPacketReadNext2 RTS_IEC_HANDLE Returns the runtime system error code (see CmpErrors.library): ERR_PARAMETER if hPacket is not a valid packet handle or if hPrevRecord is not a valid record handle ERR_NO_OBJECT if there is no next record ERR_NOTINITIALIZED if the packet is not complete ERR_TIMEOUT if reading took too long ERR_ENTRIES_REMAINING if more data can be read by a subsequent call (this is not an error) Input hPacket RTS_IEC_HANDLE The trace packet handle hPrevRecord RTS_IEC_HANDLE The trace record handle of the current record ulTimestamp UDINT The time stamp (relative to the trace start time) from where to start copying Inout pTraceBuffer TraceRecordEntry Pointer to the destination buffer pulReadBytes UDINT Size of the destination buffer in bytes (in), number of bytes copied (out) pResult RTS_IEC_RESULT The result code

TraceMgrPacketResetTrigger (FUN) ¶ FUNCTION TraceMgrPacketResetTrigger : RTS_IEC_RESULT Resets the trigger of a trace packet. The start time and date of of the trigger is reset to 0 and the trigger is set to state enabled (if it is not disabled). InOut: Scope Name Type Comment Return TraceMgrPacketResetTrigger 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

ComponentId (GVL) ¶ InOut: Scope Name Type Initial Constant CMPID_CmpTraceMgr UDINT 16#70

EventParameter ¶ EVTPARAM_CmpTraceMgr_Packet (Struct) EVTPARAM_CmpTraceMgr_Record (Struct) EventIDs (GVL)

EVTPARAM_CmpTraceMgr_Packet (STRUCT) ¶ TYPE EVTPARAM_CmpTraceMgr_Packet : STRUCT Parameter type for trace manager packet events InOut: Name Type Comment hPacket RTS_IEC_HANDLE Handle to a trace packet

EVTPARAM_CmpTraceMgr_Record (STRUCT) ¶ TYPE EVTPARAM_CmpTraceMgr_Record : STRUCT Parameter type for trace manager record events InOut: Name Type Comment hPacket RTS_IEC_HANDLE Handle to a trace packet hRecord RTS_IEC_HANDLE Handle to a trace record pstTimestamp POINTER TO SYSTIME The address of the timestamp of the variable values