ls_rpt(1M)

NAME

ls_rpt - Report on license server events

SYNOPSIS

ls_rpt [[ -n node_name ][ -c ][ -z ]
[ event_type_list ][ information_filter_list ] |
[ -h | -usage | -version ]]

DESCRIPTION

The ls_rpt command generates reports on license server events. There is no graphic interface for this command.

OPTIONS AND ARGUMENTS

Default options are indicated by (D).

-n Specifies the server node about which the report is to be generated. If you do not specify a node, ls_rpt reports on the current server node.

-c Lists data in 80-column format.

-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.

event_type_list

You may specify any combination of the following event types. Specify -a to specify all event types.

-a Lists all log messages.

-l (D)
Lists license-related events (product received license, product released license to server, user entered license queue, user exited queue).

-e Lists error events.

-s Lists server start/stop events.

-m Lists messages that were logged by software product or license server.

-f Lists fatal error events.

-d Lists license database modification messages.

information_filter_list

You may choose any combination of the following information filters. If no filters are specified the default is all dates, all vendors, all products, all users.

-byy/mm/dd
Lists events that occurred beginning at the specified date.

-tyy/mm/dd
Lists events that occurred up to the specified date.

-v vendor_name
Lists events related to the specified vendor(s).

-p product_name
Lists events related to the specified product(s).

-u user_name
List events related to the specified user(s).

-r 1 Lists for the specified product the number of requests for licenses, the number of licenses granted, and the percent of rejected requests.

-r 2 Lists the same information as -r 1, but also includes user names and number of licenses installed.

-xyy/mm/dd
Deletes log file entries written on and before the specified date.

EXAMPLES

List license events on the local server node:

ls_rpt

List errors and fatal errors occurring between August 31 and September 30 1990 on the server node //pluto:

ls_rpt -n //pluto -e -f -b 87/08/31 -t 87/09/30

List all messages logged at //mars by the vendor XYZ:

ls_rpt -n //mars -m -v xyz

List all messages logged at diskless node $00dab4 by vendor A. You must delimit a node specification containing a $ character with single quotes, or else the $ is interpreted as an environment variable.

ls_rpt -n ’//diskless_$00dab4’ -v A