license

Получите статус лицензии, протестируйте существование лицензии на продукты или проверьте лицензию комплекта

Описание

Используйте функцию лицензии, чтобы возвратить номер лицензии в использовании, перечислить лицензии, проверенные на текущем сеансе, лицензии списка, проверенные пользователем, определить, проверяется ли конкретный продукт на лицензии, и проверьте определенный продукт на лицензию. Чтобы выполнить задачи управления лицензиями, включая то, как возобновить или деактивировать лицензию, видят, Управляют Вашими Лицензиями.

license возвращает номер лицензии для этого продукта MATLAB®. Возвращаемое значение может также быть неномером, например, 'demo' для демонстрационной версии MATLAB или 'student', для студенческой версии MATLAB.

пример

license('inuse') отображает список лицензий, проверенных в текущем сеансе работы с MATLAB. Список продуктов является алфавитным именем функции лицензии. Эти имена совпадают с допустимыми значениями для feature входной параметр.

пример

S = license('inuse') возвращает массив структур, указывающих на проверенные лицензии и имя пользователя каждого человека, которому проверили лицензию.

пример

S = license('inuse',feature) проверки, если продукт задан feature проверяется в текущем сеансе работы с MATLAB. Если продукт проверяется, то license возвращает название продукта и имя пользователя человека, которому проверили его. В противном случае, поля S пусты.

пример

status = license('test',feature) тесты, если лицензия существует для продукта, заданного feature.

license('test',feature,toggle) включает или отключает тестирование продукта, заданного feature, В зависимости от значения toggle.

пример

[status,errmsg] = license('checkout',feature) проверяет лицензию на заданный продукт. Если вы задаете дополнительный второй выходной аргумент, errmsgто license возвращает текст любого сообщения об ошибке, с которым сталкиваются, если контроль неудачен.

Примеры

свернуть все

Отобразите список лицензий, в настоящее время используясь. license отображает список продуктов в алфавитном порядке именем функции лицензии для вашей настройки.

license('inuse')
image_toolbox
map_toolbox
matlab

Получите список лицензий в использовании с информацией о каждом пользователе. license возвращает массив структур.

S = license('inuse');

Просмотрите первый элемент S.

S(1)
ans = 

    feature: 'image_toolbox'
       user: 'juser'

Определите, используется ли лицензия на MATLAB. Если лицензия используется, то S массив структур с непустыми полями.

S = license('inuse','MATLAB')
S = 

    feature: 'matlab'
       user: 'jsmith'

Определите, существует ли лицензия для Mapping Toolbox™. Если лицензия существует, то license возвращает 1.

status = license('test','MAP_Toolbox')
status =

    1

Проверьте лицензию на Control System Toolbox™. status выходом является 1 и errmsg выход пуст, если контроль успешен.

[status,errmsg] = license('checkout','Control_Toolbox')
status =

     1


errmsg =

     ''

Входные параметры

свернуть все

Имя функции лицензии в виде вектора символов. Значения feature не являются чувствительными к регистру. INCREMENT линии в файле лицензии указывают на допустимые функции. Чтобы определить местоположение вашего файла лицензии, смотрите, Где файлы лицензии для MATLAB расположены?

Способность протестировать существование лицензии на продукты в виде любого 'enable' или 'disable'.

  • Если toggle 'enable', затем синтаксис, license('test',feature) возвращает 1 когда лицензия на продукты существует и 0 когда лицензия на продукты не существует.

  • Если toggle 'disable', затем синтаксис, license('test',feature) всегда возвращает 0 (лицензия на продукты не существует) для заданного продукта.

Примечание

Отключение теста для конкретного продукта может влиять на другие тесты для существования лицензии, не только тестирует выполняемый license команда.

Выходные аргументы

свернуть все

Проверенные продукты, возвращенные как массив структур, где каждая структура представляет проверенную лицензию. Структуры содержат два поля:

  • feature — имя функции лицензии

  • user — имя пользователя человека, которому проверили лицензию

Если поля пусты, то продукт в настоящее время не проверяется.

Тест или состояние контроля, возвращенное как 1 или 0.

  • При тестировании на существование лицензии, 1 указывает, что лицензия существует, и 0 указывает, что лицензия не существует.

    Существование лицензии не обязательно означает, что лицензия может быть проверена или что продукт установлен. Если все ключи продукта будут использоваться, то тест все еще возвратится 1, но действительный контроль перестанет работать.

  • При проверке лицензии, 1 указывает, что контроль успешен, и 0 указывает что license функция не могла проверить лицензию.

Сообщение об ошибке для неудачного контроля лицензии, возвращенного как вектор символов. Если контроль успешен, то errmsg isempty.

Сообщения об ошибке обычно указывают, как можно решить вопрос. Например:

License checkout failed.
License Manager Error -5
Cannot find a license for FEATURENAME.

Troubleshoot this issue by visiting:
https://www.mathworks.com/support/lme/R2021b/5

Ошибка контроля лицензии, которую вы получаете, может зависеть от того, какую лицензию вы имеете.

Советы

  • Регистрируйтесь к своему Счету MathWorks® на детали обо всех лицензиях, соединенных с вашей учетной записью, таких как тип лицензии, использование продукта и информация об истечении.

  • Чтобы выполнить задачи управления лицензиями, включая то, как возобновить или деактивировать лицензию, видят, Управляют Вашими Лицензиями.

Смотрите также

| |

Представлено до R2006a