В текущем разделе описываются команды управления сервисом 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]