MATLAB Installation Guide for PC

Viewing License Manager Status

To view the current status of the license manager, use the lmutil command in a DOS command prompt window or use the lmtools.exe graphical user interface.

Note    You must run these tools on the system on which the license manager is running.

Using the lmutil Command

The lmutil command performs many different license management functions. You invoke each function by specify lmutil command line flags.

To use the lmutil command to obtain a status report, open up a DOS command prompt window and enter this command:

• lmutil lmstat -a -c C:\matlab6p5\flexlm\license.dat
  

In this example, note the following:

• You specify the lmstat command line argument to obtain a status report. the lmutil command can perform many different license management functions. See Other lmutil License Management Functions for a complete list.
• You must use the -c flag to specify the location of your License File. You must specify this flag with every tool invoked through lmutil.exe.

The lmutil command displays the following status report:

• lmutil - Copywright (C) 1989-1999 Globetrotter Software, Inc.
  Flexible License Manager status on Friday 11/1/2000 15:17
  
  License server status: 27000@smithj
      License File(s) on smithj: C:\matlab6p1\flexlm\license.dat:
  
  smithj: license server UP (MASTER) v.6.1
  
  Vendor daemon status (on smithj):
      MLM: UP v6.1
  
  Feature usage info:
  
  Users of MATLAB: (Total of 1 licenses available)
    "MATLAB" v12, vendor: MLM
    floating license
    jsmith smithj smithj (v12)(smithj/27000 103),start Fri 11/15.07
  
  Users of SIMULINK: (Total of 1 licenses available)
  
  Users of Control_Toolbox: (Total of 1 licenses available)
  
  Users of Identification_Toolbox: (Total of 1 licenses available)
  

Other lmutil License Management Functions

To view a list of all the tools available through lmutil.exe, open a Command Prompt window, go to the $MATLAB\flexlm directory and type

• lmutil
  

The following table lists the names of the most useful tools available through lmutil.

Utility	Description
lmdiag	Diagnose license checkout problems
lmdown	Shut down all license daemons (both lmgrd and all vendor daemons) on the license server node.
lmhostid	Report the Host ID of a system
lmreread	Make the license manager daemon reread the License File and start any new vendor daemons
lmstat	Display the status of all network licensing activities
lmswitchr	Switch the report log file
lmver	Determine the FLEXlm version of a library or binary file

The lmutil.exe listing includes brief syntax descriptions for most of the tools. For more detailed information, see the FLEXlm End User Manual, included in PDF format in your MATLAB installation ($MATLAB\flexlm\enduser.pdf).

Using the lmtools.exe GUI

FLEXlm provides a graphical user interface (GUI) to its license management tools. To invoke this GUI, double-click on the lmtools.exe file in the $MATLAB\flexlm directory. The GUI uses buttons to provide access to the same set of tools as lmutil.exe and displays the results returned in an integrated display window.

Note    When using the lmtools GUI, you must specify the location of the License File in the Current License File field.

For example, to use the lmtools GUI to monitor the status of network license activity, click the Status button. lmtools prompts you to further qualify your status request to a particular daemon or feature. By default, lmtools displays the same information as if you had entered the command lmutil lmstat -a.

Performing Common License Management Tasks

Starting and Stopping the License Manager