LS_STAT Domain/OS LS_STAT
NAME
ls_stat - Display the status of the license server system
SYNOPSIS
ls_stat
ls_stat {-t | -i | -a | -u user_name } [[-n server ][ -v vendor ][ -p
product ] [ -r version | -z ]] | [ -h | -usage | -version ]
DESCRIPTION
The ls_stat command displays, in the transcript pad below the ls_stat
window, status information on licenses. Note that end users as well as
system administrators may find ls_stat useful for finding out the status
of licenses in an NetLS system.
ls_stat features both a command-line and graphic interface. If all
options are omitted, ls_stat invokes a graphic interface. Both
interfaces are described here.
In graphic interface mode, you can get help by placing the cursor on any
button and pressing SHIFT/HELP.
GRAPHIC INTERFACE MENUS AND BUTTONS
Exit Button
Select this button to exit from ls_stat.
License Information Menu
This menu contains three buttons: Users, Installed, and Usage (see
below). 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.
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.
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.
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.
COMMAND-LINE INTERFACE OPTIONS AND ARGUMENTS
-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 license users; all servers and all
products are listed by default.
-u user_name
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.
EXAMPLES
Display all licenses installed for all products on all servers:
ls_stat -i
Display licenses in use from the server //park:
ls_stat -a -n //park
Display licenses installed and currently in use for the product KwikDraw,
revision V2.1:
ls_stat -a -i -p Kwik-Draw -r V2.1
Display licenses installed on //park for the vendor Apollo.
ls_stat -i -v Apollo -n //park