Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 

Modifying SRC VTA Accounts and Service Sessions (SRC CLI)

 

Use the request vta group vtaName update-accounts account-name account-name command to modify subscriber SRC VTA accounts and service sessions. By using this command, you can modify either all service sessions in an account or a specific subscriber’s service sessions in the account.

You can overwrite the status, description, last update time, or balance in a set of accounts. You can also change the existing account balance by a specific positive or negative amount.

  • To modify all service sessions in an account, execute the following command from operational mode:

  • To modify a specific subscriber’s service sessions in the account, execute the following command from operational mode:

    You can optionally add the account-status option if you only want to update accounts with a particular status.

Use one or more of the options described in Table 1 to modify the account.

Table 1: Arguments Used to Modify Accounts

ArgumentDescription

new-status newAccountStatus

Changes the status of the account or specified subscriber’s service sessions.

new-balance newAccountBalance

Sets the account balance to the amount specified by the newAccountBalance. For example, an account starts with a balance of 10. You set the newAccountBalance to 2. The account now has a balance of 2.

balance-change accountBalanceChangeAmount

Adds the amount specified for the accountBalanceChangeAmount to the existing account balance. For example, an account starts with a balance of 10. You set the accountBalanceChangeAmount to 2. The account now has a balance of 12.

balance-change-description description

(Optional) Add a description for the balance change. If you specify this option, a new balance change record is created in the database that contains the specified description, as well as the amount by which the account balance was changed. If the account balance was not changed, this amount will be zero.

terminate-sessions

(Optional) Trigger a callback:terminatesessions event for each specified subscriber. The SRC VTA ignores these events unless you configure an event-handler to process them.

When you execute either of these commands, the SRC VTA takes the following steps:

  • If you specify the terminate-sessions option, the SRC VTA generates a callback:terminatesessions event for every subscriber that owns a selected account.

  • The SRC VTA updates all service sessions in the account, or all service sessions for the specified subscriber as requested. This is purely a database operation.

  • For each account that is updated, the SRC VTA creates an account-update event. This event contains the relevant account’s old and new balances, and other information. The SRC VTA ignores these events unless you configure an event handler to process this event type.