STW TC1 - Page 197

7 Teleservice Application Framework
User Manual 197/374
7.3.6.2.3 ylogd_set_variable_change_cmd
Function Description
sint32 ylogd_set_variable_change_cmd (const T_DBUS_Util * const opt_DBusInstance,
const charn * const opcn_LogJobName,
const charn * const opcn_DatapoolName,
const charn * const opcn_ListName,
const charn * const opcn_VariableName,
const charn * const opcn_Command)
The function adds a new variable event command to expected log job opcn_LogJobName.
If a command for that variable already exists, it will be replaced.
When the given variable logging due to reaching its hysteresis threshold, the given command will be executed.
If the command contains the string defined by FORMATTER_OLDVALUE or FORMATTER_NEWVALUE, then
those portions of the command will be replaced by the previously logged value and the currently logged value,
respectively.
Information Flow
Input Information
Parameter
Range
Description
opt_DBusInstance
T_DBUS_Util
holds all D-Bus information
opcn_LogJobName
maximum
MAX_DL_NAME_LENGTH
pointer to log job name
opcn_DatapoolName
maximum
MAX_DP_NAME_LENGTH
pointer to the data pool name
opcn_ListName
maximum
MAX_DP_NAME_LENGTH
pointer to the list name
opcn_VariableName
maximum
MAX_DP_NAME_LENGTH
pointer to the variable name for logging
opcn_Command
uint32, maximum size of
MAX_DL_COMMAND_LENGTH
pointer to command string to execute
NOTE:
This command should only be used when a hysteresis > 0 is used, and when the frequency of the
change is expected to be low. Otherwise, the log job may not be able to maintain the sample rate.