Solstice AdminSuite 2.3 Administration Guide

How to Monitor Software Usage Using a Command-Line Interface

At the shell prompt, generate a usage report using one of the following swu_rpt command lines.

To create a software usage report entry specifying that the associated program has been installed, use the -i option.

$ swu_rpt -p product-name [-I identifier] [-s server] [-a attr1=val1, attr2=val2,...] \
-i

To create a software usage report entry specifying that the associated program has started, use the -b option.

$ swu_rpt -p product-name [-I identifier] [-s server] [-a attr1=val1, attr2=val2,...]\
 -b

To create a software usage report entry specifying that the associated program has ended, use the -e option.

$ swu_rpt -p product-name [-I identifier] [-s server] [-a attr1=val1, attr2=val2,...] -e

To create software usage report entries specifying a begin and an end entry for the associated program, use the -c option.

$ swu_rpt -p product-name [-I identifier] [-s server] [-a attr1=val1, attr2=val2,...]\ 
-c command

In these commands,

`-p` `product-name`	Indicates the name of the product that software usage is being recorded for; this option must be included.
`-I` `identifier`	Specifies a numerical identifier for usage records; `swu_rpt` will provide its own identifier if one is not specified.
`-s` `server`	Specifies the software usage monitoring server to which the usage records are to be sent. The default is the host aliased to `swusage_host`.
`-a` `attr1=val1, attr2=val2,...`	Allows the user to give the software usage entry unique or more descriptive information.
`-b`	Indicates that a begin entry will be recorded.
`-e`	Indicates that an end entry will be recorded.
`-i`	Indicates that an install entry will be recorded.
`-c` `command`	Indicates that the command or program listed after the `-c` option should be executed and that a begin and end entry should be recorded.

Example of Monitoring Software Usage Using a Command-Line Interface

The following example shows the software usage monitoring command as used from a command line, which starts the FrameMaker program using the command maker, and logs the application using the software usage monitoring swu_rpt command.

$ swu_rpt -p FrameMaker -I 29581 -s sherlock -c maker

In this example, two software usage report entries are created because the -c option was used (the -c option creates a begin and an end entry). The entries look like the following.

Report Entry 1		Report Entry 2
`Type`	`Admin/Usage`	`Type`	`Admin/Usage`
`Product`	`FrameMaker`	`Product`	`FrameMaker`
`SubType`	`Begin`	`SubType`	`End`
`Time`	`8444845890`	`Time`	`8444845957`
`UserID`	`30581`	`UserID`	`30581`
`User`	`jod`	`User`	`jod`
`Host`	`buck`	`Host`	`buck`
`Domain`	`forest.field.com`	`Domain`	`forest.field.com`
`HostID`	`1234567890`	`HostID`	`1234567890`
`Locale`	`C`	`Locale`	`C`
`Version`	`1`	`Version`	`1`
`Ussage Server`	`sherlock`	`Usage Server`	`sherlock`
`RecordID`	`29581`	`RecordID`	`29581`