lmstat

The lmstat tool helps you monitor the status of all FLEXnet network licensing activities, including:

  • Daemons that are running

  • License files

  • Users of individual features

  • Users of features served by a specific vendor daemon

The lmstat tool prints information that it receives from the license server; therefore, it does not report on unserved licenses such as uncounted licenses. To report on an uncounted license, the license must be added to a served license file and the application must be directed to use the license server for that license file (via @host, port@host, or USE_SERVER). Queued users and licenses shared due to duplicate grouping are also not returned by lmstat.

Syntax and Options

lmstat [-a] [-c license_file_list] [-f [feature]] [-i [feature]] [-s [server]][-S [vendor]] [-t timeout_value]

-a

Displays all information.

-c license_file_list

Specifies the license files to use.

-f [feature]

Displays the users of feature. If feature is not specified, usage information for all features is displayed.

-i [feature]

Displays information from the FEATURE/INCREMENT line for the specified feature or for all features if feature is not specified.

-s [server]

Displays the status of all license files in $VENDOR_LICENSE_FILE or $LM_LICENSE_FILE on server or on all servers if server is not specified.

-S [vendor]

Lists all users of the specified vendor's features.

-t timeout_value

Sets the connection timeout to timeout_value. This limits the amount of time lmstat spends attempting to connect to server.

Note:

The lmstat -a command is a potentially expensive command. With many active users, this command generates a lot of network activity.

The lmremove tool requires the output of the lmstat -a command, as shown in the example below.

Example

The output for the command

flex_install_dir/os/code/bin/lmstat -a

looks similar to the following:

License server status: 27000@firestar
    License file(s) on firestar: flex_install_dir\win_b64\code\bin\simulialm.lic:
   firestar: license server UP (MASTER) v11.6
Vendor daemon status (on firestar):
 AbaqusLM: UP v11.6
Feature usage info:
Users of cae: (Total of 4 licenses issued; Total of 1 license
in use)
  "cae" v61.2, vendor: AbaqusLM
  floating license
    smith watt watt (v61.2) (firestar/27000 101), 
start Tue 3/1 9:29

where

smith user User name
watt user_host Host where user is running
watt display Display where user is running
v61.2 release Release of feature
firestar server_host Host where license server is running
27000 port Port on server_host where license server is running
101 handle License handle
start Tue 3/1 9:29 checkout_time Time that this license was checked out

Note:

The lmremove tool does not free licenses for use by other jobs (see lmremove, for more information).

To use the lmremove tool to free the license for a job run by user smith, you would use the command

abaqus licensing lmremove cae smith watt watt

where

cae feature Name of the feature checked out by the user
smith user Name of the user whose license you are removing, as reported by lmstat -a
watt user_host Name of the host the user is logged into, as reported by lmstat -a
watt display Name of the display where the user is working, as reported by lmstat -a
To use LMTOOLS (Windows platforms) to run lmstat -a:
  1. From the Start menu, select ProgramsAbaqus LicensingLicensing utilities.

  2. Verify that Configuration using Services is enabled on the Service/License File tabbed page, and select the Server Status tab.

  3. Verify that Display Everything is enabled, and click Perform Status Enquiry.