/domain/<DOMAIN>/mlpp/ - команды управления многоадресной приоритезацией вызовов (MLPP)
В текущем разделе описываются команды управления сервисом MLPP (Multilevel Precedence and Preemption).
Для администратора виртуальной АТС команды выполняются на уровне виртуальной АТС в разделе domain/<DOMAIN>/mlpp/ и применяются только для определенной виртуальной АТС.
В таблице 1 приведено описание свойств сервиса MLPP.
Таблица 1. Описание свойств сервиса MLPP
Название свойства | Значения | Значение по умолчанию | Описание |
---|---|---|---|
default_priority | 0-15 | 4 | Приоритет, который используется, если не заданы категории вызова в свойстве "priority". |
enable | true, false | true | Определяет состояние сервиса MLPP: - true - сервис включен; - false - сервис выключен. |
mode | wait, force | wait | Режим работы сервиса: - wait - сервис ставит приоритетный вызов в очередь; - force - сервис завершает один из менее приоритетных вызовов и пропускает приоритетный вызов. |
priority | 0-15 | - | Приоритет вызова для определенной категории вызова. |
queue_length | 2, 3 | 2 | Длина очереди ожидания приоритетных вызовов, используется только в режиме "wait". |
queue_time | 0-40 секунд | 40 | Время ожидания приоритетных вызовов в очереди, используется только в режиме "wait". |
clean
Данной командой осуществляется установка значений по умолчанию свойств подсистемы MLPP. Значения по умолчанию приведены в таблице 1.
Путь команды:
/domain/<DOMAIN>/mlpp/clean
Синтаксис:
clean [--property] [<FIELD>] [<VALUE>] [--force]
Параметры:
- <DOMAIN> - имя виртуальной АТС, значения свойств которой необходимо установить по умолчанию;
- --property <FIELD> - свойство, значение которого необходимо установить в значение по умолчанию. Если не указывать данный параметр, то значения по умолчанию будут восстановлены для всех свойств заданной виртуальной АТС;
- <VALUE> - значение свойства(* - для всех значений);
- --force - выполнение команды без запроса подтверждения.
Пример:
admin@mycelium1@ecss1:/$ domain/biysk.local/mlpp/clean --property priority payphone Success: Property priority values successfully updated [exec at: 18.02.2021 13:44:23, exec time: 67ms, nodes: sip1@ecss1 v.3.14.7.589]
info
Данная команда позволяет посмотреть свойства подсистемы MLPP в заданной виртуальной АТС.
Путь команды:
/domain/<DOMAIN>/mlpp/info
Синтаксис:
info [--property] [<FIELD>]
Параметры:
<DOMAIN> - имя виртуальной АТС, значения свойств которой необходимо просмотреть.
--property <FIELD> - имя свойства, которое нужно просмотреть. Опциональный параметр. Если параметр не указывать, будут выведены все свойства. Описание свойств приведено в таблице 1.
Пример:
admin@mycelium1@ecss1:/$ domain/biysk.local/mlpp/info ┌────────────────┬───────────┬──────────────────────────────┐ │ Property │ Domain │ Value │ ├────────────────┼───────────┼──────────────────────────────┤ │default_priority│biysk.local│4 │ │enable │biysk.local│true │ │mode │biysk.local│wait │ │priority │biysk.local│ ordinarySubscriber( 10): 1│ │ │ │ payphone( 15): 5│ │queue_length │biysk.local│3 │ │queue_time │biysk.local│40 │ └────────────────┴───────────┴──────────────────────────────┘ [exec at: 18.02.2021 13:41:49, exec time: 21ms, nodes: sip1@ecss1 v.3.14.7.589]
set
Данной командой производится изменение свойств подсистемы MLPP в заданной виртуальной АТС.
Путь команды:
/domain/<DOMAIN>/mlpp/set
Синтаксис:
set <FIELD> <VALUE>
Параметры:
<DOMAIN> - имя виртуальной АТС, значения свойств которой необходимо установить.
<FIELD> - имя свойства, значение которого необходимо изменить. Описание свойств приведено в таблице 1.
<VALUE> - новое значение свойства, возможные значения приведены в таблице 1.
Настройка свойства "priority" выполняется следующим образом:
- для добавления приоритета определенной категории используются команды:
set priority add <CATEGORY> <VALUE>
- для удаления приоритета категории используются команды:
set priority remove <CATEGORY>
где
<CATEGORY> - категория вызова, принимает значения [0..255] или задается в виде имени: autoCallII; autoCallIII; autoCallIV; category0; dataCall; freeSubscriber; hotelsSubscriber; localSubscriber; localTaksofon; operatorEngish; operatorFrench; operatorGerman; operatorRussian; operatorSpanish; ordinarySubscriber; paidSubscriber; payphone; reserved; semiautoCallI; semiautoCallII; semiautoCallIII; semiautoCallIV; spare; subscriberWithPriority; testCall; unknownAtThisTime;
<VALUE> - приоритет категории, принимает значение [0..15], где 0 - самый высокий приоритет, 15 - самый низкий.
Пример:
admin@mycelium1@ecss1:/$ domain/biysk.local/mlpp/set priority add ordinarySubscriber 1 Value "ordinarySubscriber( 10): 1" successfully added to property "priority". [exec at: 18.02.2021 13:35:53, exec time: 70ms, nodes: sip1@ecss1 v.3.14.7.589]