В текущем разделе описываются команды управления сервисом MLPP (Multilevel Precedence and Preemption) на уровне системы

Для администратора системы команды выполняются на уровне сервиса MLPP в разделе /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.

Путь команды:

/mlpp/clean

Синтаксис:

clean [<FIELD>] [--force]

Параметры:

<DOMAIN> - имя виртуальной АТС, значения свойств которой необходимо установить по умолчанию. При указании символа "*" значения свойств всех виртуальных АТС устанавливаются по умолчанию;
<FIELD> - свойство, значение которого необходимо установить в значение по умолчанию. Если не указывать данный параметр, то значения по умолчанию будут восстановлены для всех свойств заданной виртуальной АТС.

--force - выполнить команду без запроса подтверждения.

Пример:

admin@[mycelium1@ecss1]:/$ mlpp/clean biysk.local mode 
Property mode values successfully restored

[exec at: 18.01.2019 12:48:25, exec time: 233ms, nodes: sip1@ecss1]

info

Данная команда позволяет посмотреть свойства подсистемы MLPP.

Путь команды:

/mlpp/info

Синтаксис:

info [<DOMAIN> [<FIELD>]]

Параметры:

<DOMAIN> - имя виртуальной АТС, значения свойств которой необходимо просмотреть. При указании символа "*" будет показана информация по всем виртуальным АТС системы;
<FIELD> - имя свойства, которое нужно просмотреть. Опциональный параметр. Если параметр не указывать, будут выведены все свойства. Описание свойств приведено в таблице 1.

Пример:

admin@[mycelium1@ecss1]:/$ mlpp/info                       
┌────────────────┬───────────┬──────────────────────────────┐
│    Property    │  Domain   │            Value             │
├────────────────┼───────────┼──────────────────────────────┤
│default_priority│           │4                             │
│enable          │           │true                          │
│mode            │           │wait                          │
│mode            │biysk.local│force                         │
│priority        │           │              testCall( 13): 5│
│queue_length    │           │2                             │
│queue_time      │           │40                            │
└────────────────┴───────────┴──────────────────────────────┘

[exec at: 18.01.2019 12:47:45, exec time: 58ms, nodes: sip1@ecss1]

set

Данной командой производится изменение свойств подсистемы MLPP в заданной виртуальной АТС или во всей системе.

Путь команды:

/mlpp/set

Синтаксис:

set <DOMAIN> <FIELD> <VALUE>

Параметры:

<DOMAIN> - имя виртуальной АТС, значения свойств которой необходимо установить. При указании символа "*" значение свойства устанавливается для всех виртуальных АТС системы;
<FIELD> - имя свойства, значение которого необходимо изменить. Описание свойств приведено в таблице 1.
<VALUE> - новое значение свойства, возможные значения приведены в таблице 1.

Настройка свойства "priority" выполняется следующим образом:

для добавления приоритета определенной категории используются команды:

set <DOMAIN> priority add <CATEGORY> <VALUE>

для удаления приоритета категории используются команды:

set <DOMAIN> 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]:/$ /mlpp/set * priority add testCall 5
Property "priority" successfully changed from: 

   to
              testCall( 13): 5.

[exec at: 18.01.2019 12:42:50, exec time: 268ms, nodes: sip1@ecss1]

admin@[mycelium1@ecss1]:/$ mlpp/set biysk.local mode force 
Property "mode" successfully changed from: 
wait
   to
force.

[exec at: 18.01.2019 12:45:55, exec time: 266ms, nodes: sip1@ecss1]