STW TC1, Руководство пользователя

Страница: 197 / 374

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.