Action Fields for the Database Engine Processor

In VTA Configuration Manager, you can edit the following fields in the Quota VTA Actions screen.

Processor

  • Processor for which you are configuring the action.
  • Value—DBengine
  • Default—No value

Function

  • Function calls that the database engine processor invokes. These functions are variables that you can use to update database accounts.
  • Value
    • CalculateInterim—Calculates the interim interval in the service-tracking event by using the interim interval configured for the service. It has no parameters. It adds the following attribute to the event after the function is executed:
      • interimInterval—Interim interval of the service
    • CalculateUsage—Calculates usage in the service-tracking event by using the the usage metric configured for the service. It has no parameters. It adds the following attributes to the event after the function is executed:
      • currentUsage—Usage since the previous usage report
      • sessionSinceLastReport—Session length since the previous usage report
    • GetAccounts—Gets account data for the corresponding subscriber for the event. Subsequent event handlers of the event can use the retrieved data. It has no parameters. It adds the following attributes to the event after the function is executed:
      • balance_<accountName>—Balance for the account.
      • lastUpdateTime_<accountName>—Last update time in milliseconds since January 1, 1970 UTC for the account.
      • status_<accountName>—Status of the account.
    • TerminateSession—Closes active VTA sessions that have a status of Start or Interim. It does not stop the corresponding services in the SAE. You can use this function to stop a service at the end of a billing period. Usage data collected after the VTA session is stopped is stored in new VTA session records.
    • UpdateAccounts—Runs an account update script that changes the account balances of the corresponding subscriber for the event. It adds the following attributes to the event after the function is executed:
      • balance_<accountName>—Balance for the account after it is updated.
      • lastUpdateTime_<accountName>—Last update time in milliseconds since January 1, 1970 UTC for the account after it is updated.
      • status_<accountName>—Status of the account after it is updated.
  • Default—No value

Parameter Name

  • Parameters to pass to the function.
  • Value
    • Event attribute name; the event attribute name is replaced by the attribute’s value wherever it appears.
    • For the UpdateAccounts function, you can configure the following parameter:
      • scriptName—Name of the account update script defined in the database engine processor
  • Example—ScriptName

Parameter Content

  • Values for the parameters.
  • Value
    • For the scriptName parameter—Name of the account update script defined in the database engine processor
  • Example—DebitQuotaUsage

Abort On Error

  • Disables or enables and sets the processing in response to an error.
  • Value
    • Break—Stop processing the current event.
    • Continue—Continue with the next action, if any, in the same event handler.
    • Next Event Handler—Continue with the next event handler (if any).
  • Default—No value