UserMgrGroupGetNextUser (FUN) ¶ FUNCTION UserMgrGroupGetNextUser : RTS_IEC_RESULT Iteration interface to get next configured user of the user group. Must be started with UserMgrGroupGetFirstUser() InOut: Scope Name Type Comment Return UserMgrGroupGetNextUser RTS_IEC_RESULT Error code ERR_OK: Next user available ERR_NO_OBJECT: No next user available ERR_PARAMETER: Invalid iterator handle ERR_NO_ACCESS_RIGHTS: User not authorized Input hUser RTS_IEC_HANDLE Handle to authorized user hGroup RTS_IEC_HANDLE Group handle Inout phIterator RTS_IEC_HANDLE Iteration handle to use with next call to UserMgrGroupGetNextUser() pszUsername STRING(59) Buffer to store the name, 59 chars max

UserMgrGroupRemove (FUN) ¶ FUNCTION UserMgrGroupRemove : RTS_IEC_RESULT Remove a group from user group database InOut: Scope Name Type Comment Return UserMgrGroupRemove RTS_IEC_RESULT Error code ERR_OK: Group was successfully removed ERR_NO_OBJECT: Group name does not exist ERR_NO_ACCESS_RIGHTS: User not authorized Input hUser RTS_IEC_HANDLE Handle to authorized user Inout Const pszGroupName STRING Name of the group

UserMgrGroupRemoveUser (FUN) ¶ FUNCTION UserMgrGroupRemoveUser : RTS_IEC_RESULT Remove user from a group in the user group database InOut: Scope Name Type Comment Return UserMgrGroupRemoveUser RTS_IEC_RESULT Error code ERR_OK: User could be removed ERR_NO_OBJECT: Group or user name does not exist ERR_NO_ACCESS_RIGHTS: User not authorized Input hUser RTS_IEC_HANDLE Handle to authorized user Inout Const pszGroup STRING Group name pszUser STRING User name

Objecthandling ¶ UserMgrObjectAdd (Function) UserMgrObjectAddGroup (Function) UserMgrObjectClearRights (Function) UserMgrObjectGetFirstChild (Function) UserMgrObjectGetFirstGroup (Function) UserMgrObjectGetGroupRights (Function) UserMgrObjectGetHandle (Function) UserMgrObjectGetName (Function) UserMgrObjectGetNextChild (Function) UserMgrObjectGetNextGroup (Function) UserMgrObjectRemove (Function) UserMgrObjectRemoveGroup (Function) UserMgrObjectSetGroupDeniedRights (Function) UserMgrObjectSetGroupRights (Function) UserMgrObjectSetUsedRights (Function)

TRACE_RECORD_GRAPH_TYPES (GVL) ¶ Graph types. See TraceRecordConfiguration InOut: Scope Name Type Initial Constant TRACE_RECORD_GRAPHTYPE_NONE UDINT 0 TRACE_RECORD_GRAPHTYPE_LINE UDINT 1 TRACE_RECORD_GRAPHTYPE_CROSS UDINT 2 TRACE_RECORD_GRAPHTYPE_STEP UDINT 4 TRACE_RECORD_GRAPHTYPE_POINT UDINT 5 TRACE_RECORD_GRAPHTYPE_LINES_NO_POINTS UDINT 8 TRACE_RECORD_GRAPHTYPE_STEPS_NO_POINTS UDINT 9 TRACE_RECORD_GRAPHTYPE_LINES_POINTS UDINT 10 TRACE_RECORD_GRAPHTYPE_STEPS_POINTS UDINT 11

TRACE_TRIGGER_EDGE (GVL) ¶ Trigger edge InOut: Scope Name Type Initial Comment Constant TRIGGER_EDGE_NONE BYTE 0 No trigger edge specified TRIGGER_EDGE_RISING BYTE 1 Rising trigger edge TRIGGER_EDGE_TRAILING BYTE 2 Falling trigger edge TRIGGER_EDGE_BOTH BYTE 3 Both rising and falling trigger edge

TRACE_TRIGGER_FLAGS (GVL) ¶ Trigger flags InOut: Scope Name Type Initial Comment Constant TRACE_TRIGGER_FLAGS_UNDEFINED UDINT 16#0 Trigger undefined TRACE_TRIGGER_FLAGS_DEFINED UDINT 16#1 Trigger defined TRACE_TRIGGER_FLAGS_UPDATESAFTERTRIGGER UDINT 16#4 UpdatesAfterTrigger is used instead of TriggerPosition

TRACE_TRIGGER_STATE (GVL) ¶ Trigger state InOut: Scope Name Type Initial Comment Constant TRACE_TRIGGER_STATE_DISABLED UDINT 16#0 Trigger disabled TRACE_TRIGGER_STATE_ENABLED UDINT 16#1 Trigger enabled TRACE_TRIGGER_STATE_WAIT_FOR_TRIGGER UDINT 16#2 Waiting for the trigger to fire TRACE_TRIGGER_STATE_TRIGGER_REACHED UDINT 16#3 The trigger has fired

TRACE_VAR_ADDRESS_FLAGS (GVL) ¶ Trace variable address flags. Usage: The flags mus be used in combination. Here are some typical combinations: TRACE_VAR_ADDRESS_FLAGS_IEC | TRACE_VAR_ADDRESS_FLAGS_AREA_OFFSET TRACE_VAR_ADDRESS_FLAGS_IEC | TRACE_VAR_ADDRESS_FLAGS_PROPERTY TRACE_VAR_ADDRESS_FLAGS_IEC | TRACE_VAR_ADDRESS_FLAGS_POINTER TRACE_VAR_ADDRESS_FLAGS_IEC | TRACE_VAR_ADDRESS_FLAGS_MONITORING TRACE_VAR_ADDRESS_FLAGS_IOCONFIG TRACE_VAR_ADDRESS_FLAGS_SYSTEM TRACE_VAR_ADDRESS_FLAGS_IEC | TRACE_VAR_ADDRESS_FLAGS_SYMBOLIC InOut: Scope Name Type Initial Comment Constant TRACE_VAR_ADDRESS_FLAGS_IEC UDINT 16#1 IEC variable (automatic update) TRACE_VAR_ADDRESS_FLAGS_IOCONFIG UDINT 16#2 IO-Config variable (automatic update) TRACE_VAR_ADDRESS_FLAGS_SYSTEM UDINT 16#4 System variable (update done by runtime system component or IEC program) TRACE_VAR_ADDRESS_FLAGS_POINTER UDINT 16#10 Address specified by a pointer TRACE_VAR_ADDRESS_FLAGS_AREA_OFFSET UDINT 16#20 Address specified by area/offset (IEC) TRACE_VAR_ADDRESS_FLAGS_PROPERTY UDINT 16#40 Address is a property variable (IEC) TRACE_VAR_ADDRESS_FLAGS_MONITORING UDINT 16#80 Address is an embedded monitoring expression (IEC) TRACE_VAR_ADDRESS_FLAGS_SYMBOLIC UDINT 16#100 The variable will be accessed using the symbol configuration based on its name TRACE_VAR_ADDRESS_FLAGS_MONITORING2 UDINT 16#200 Address is an item with a monitoring request for CmpMonitor2 (IEC)

TraceMgrGetConfigFromFile (FUN) ¶ FUNCTION TraceMgrGetConfigFromFile : RTS_IEC_RESULT Loads a given trace file and returns the configuration it contains. After this function call a call to function TraceMgrGetConfigFromFileRelease is necessary to free the dynamically allocated memory. InOut: Scope Name Type Comment Return TraceMgrGetConfigFromFile RTS_IEC_RESULT Returns the runtime system error code (see CmpErrors.library): ERR_PARAMETER if pszFileName is not a valid file path ERR_NOMEMORY if the memory is not sufficient for opening the file ERR_NOT_SUPPORTED if reading from files is not supported by the runtime system or if an addressing mode is not supported (e.g. symbolic access) ERR_NO_OBJECT if opening the file failed ERR_FAILED if opening the file failed ERR_END_OF_OBJECT if either the packet configuration or the record configuration is incomplete ERR_NO_CHANGE if a NULL pointer was passed to parameter ERR_OUT_OF_LIMITS if the parameters pRecordConfiguration and iMaxRecordCount do not have enough memory to hold all the records from the file Input pszFileName POINTER TO STRING The file path (in) pPacketConfiguration POINTER TO TracePacketConfiguration Points to a TracePacketConfiguration variable, where the packet configuration will be returned (out) pRecordConfiguration POINTER TO TraceRecordConfiguration Points to a TraceRecordConfiguration variable (or an array of TraceRecordConfiguration variables), where the trace record configuration will be returned. (out) If a NULL pointer is passed this function only determines the number of records in the file. iMaxRecordCount DINT Contains the maximum number of records, that can be stored in the array pRecordConfiguration (in) Inout piEffectiveRecordCount DINT Returns the effective number of records read (out). In case of return code ERR_NO_CHANGE this variable contains the number of records in the file.