MATLAB Function Reference

license

Display license number for MATLAB or list of licenses checked out

Syntax

• license
  license('inuse')
  result = license('inuse')
  result = license('test',feature)
  license('test',feature,toggle)
  

Description

license displays the license number for MATLAB, as a string. It returns demo for demonstration versions, student for student edition, and unknown if the license number cannot be determined.

license('inuse') displays the list of licenses checked out in the current MATLAB session.

result = license('inuse') returns a structure that contains the list of licenses checked out in the current MATLAB session and the username of the person who checked out the license.

When used with the MATLAB Runtime Server, the 'inuse' option displays nothing or returns an empty structure.

result = license('test',feature) tests if a license exists for the product identified by the text string feature. The license function returns 1 if the license exists and 0 if the license does not exist. You must specify the product name exactly as it appears in the INCREMENT lines in a License File (license.dat). The feature is case sensitive and must not exceed 27 characters in length. For example, 'Identification_Toolbox' is the feature name for the System Identification Toolbox.

Note    Testing for a license only confirms that the license exists. It does not confirm that the license can be checked out. If the license has expired or if a system administrator has excluded you from using the product in an options file, license will still return 1, if the license exists.

license('test',feature,toggle) enables or disables license testing for the specified product, feature, depending on the value of toggle. The parameter toggle can have either of two values:

'enable'	Tests for the specified license return either 1 (license exists) or 0 (license does not exist).
'disable'	Tests for the specified license always return 0 (license does not exist)

Note    Disabling a test for a particular product can impact all other tests for the existence of the license, not just tests performed using the license command.

length (serial)

light