Commands Reference, Volume 3

ls_stat Command

Purpose

Displays the status of the license server system.

Syntax

ls_stat { -t | -i | -a | -u UserName} [ [ -n Server ] [ -v Vendor ] [ -p Product [ -r Version ] ] [ -z ] ] | [ -h | -usage | -version ]

The ls_stat command provides status information on network licenses (that is, all license types except nodelocked). End users as well as system administrators may find ls_stat useful for finding out the status of licenses. This command description explains the command line interface of ls_stat. The graphic interface is explained separately in Related Information.

Flags

-t	Displays a table of total license usage compared to installed licenses; all servers and all products are listed by default.
-i	Displays installed licenses; all servers and all products are listed by default.
-a	Displays information about all concurrent-use license users; all servers and all products are listed by default.
-u UserName	Displays licenses being used by the specified user.

Note: One of the options listed above must be included in all ls_stat command lines.

-n Server	Displays licenses located at the specified server.
-v Vendor	Displays licenses of the specified vendor; if the vendor string contains spaces, it must be delimited by single or double quotes.
-p Product	Displays licenses for the specified product; if the product string contains spaces, it must be delimited by single or double quotes.
-r Version	Displays licenses for the specified revision of a product specified by -p; if the version string contains spaces, it must be delimited by single or double quotes.
-z	Debugging flag. (Prints RPC debugging information.)
-h	Displays command usage information. (Same as -usage)
-usage	Displays command usage information. (Same as -h)
-version	Displays command version information.

Information on Graphic Interface

The following describes the options on the graphical user interface version of ls_stat.

MENUS AND BUTTONS

Exit Button	Select this button to exit from ls_stat.
License Information Menu	This menu contains three buttons: Installed, Usage, All Users, and User. After you have selected a server and product from the Server and Product lists, select these buttons to display information about users, installed licenses, and usage of the selected server and product.
Installed Button	Displays information, listed by vendor, product and server, about product licenses installed at selected servers, including number of active licenses, their start and end dates, their type, the number of licenses currently in use, and the length of the queue of users waiting for licenses.
Usage Button	Displays information, listed by vendor, product and server, about the usage of products, including number of licenses in use, total number of licenses, and number of licenses available.
All Users Button	Displays information, listed by vendor, product and server, about current users of licensed products, including user ID, node name, group, number of licenses held, and start time.
User Button	Displays information, listed by vendor, product and server, about a specific user of licensed products, including user ID, node name, group, number of licenses held, and start time. After the User button is selected, a pop-up dialog is displayed in which you may enter a user ID.
Server List Box	This list box, directly to the right of the License Information menu, displays the server list. At the top of this box is the All Servers (Update) button (see below). At the left of the box is a scroll bar that you can use to scroll the list.
All Servers (Update) Button	Select this button to poll the network and update the server list. When you select this button, a check mark appears in the box at its left. A check mark in this box indicates that: All existing servers are displayed in the Server List box. The vendors and products listed in the Product List box are the vendors and products existing at the server currently selected in the Server List box. After updating the server list, select a server to display (in the Product List box) the products it administers. Next, select a product (or All) from the list of products; then select Users, Installed, or Usage.
Product List Box	This list box, directly to the right of the Server List box, displays the server list. At the top of this box is the All Products (Update) button (see below). At the left of the box is a scroll bar that you can use to scroll the list.
All Products (Update) Button	Select this button to poll the network and update the product list. When you select this button, a check mark appears in the box at its left. A check mark in this box indicates that: All existing vendors and products are displayed in the Product List box. The servers listed in the Server List box are the servers that hold licenses for the product currently selected in the Product List box. After updating the product list, select a product to display (in the Server List box) the servers holding licenses for the product. Select a server (or All) from the list of servers; then select Users, Installed, or Usage.
Status Message Field	This field, across the bottom of the window, describes the information currently displayed in the Server List box and the Product List box.

Examples

To display all licenses installed for all products on all servers:
```
ls_stat -i 
```
To display licenses in use from the server park:
```
ls_stat -a -n park 
```
To display licenses installed and currently in use for the product Kwik-Draw, Version 2.1:
```
ls_stat -a -i -p Kwik-Draw -r 2.1 
```
To display licenses installed on park for the vendor Apollo.
```
ls_stat -i -v Apollo -n park 
```