Solstice AdminSuite 2.3 Administration Guide

How to Add Software Usage Monitoring to a Shell Script Program Executable Command Line

  1. Using the editor of your choice, open the shell script to which you wish to add the software usage monitoring commands.

  2. Locate the command line in the script that calls the program.

  3. Add the following arguments to the program executable command line.


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

    In this command,

    -p product-name

    Indicates the name of the product that software usage is being recorded for; this option must always be included. 

    -I identifier

    Specifies a unique, numerical identifier for usage records; swu_rpt will provide its own identifier if one is not specified.

    -s server

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

    -c command

    Specifies the program executable command. 

  4. Exit the script, saving your changes. Verify that it is executable.

Example of Adding Software Usage Monitoring to a Shell Script Program Executable Command Line

The following example shows the software usage monitoring command added to a program executable command line that executes FrameMaker.


swu_rpt -p Frame -I 295836 -s sherlock -a "Command=maker,Version=4.0" -c maker

In this example, the software usage report entry looks like this:

Report Entry 1 

 

Report Entry 2 

 

Type

Admin/Usage

Type

Admin/Usage

Product

Frame

Product

Frame

SubType

Begin

SubType

End

Time

814824487

Time

8148244920

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

Usage Server

sherlock

Usage Server

sherlock

RecordID

295836

RecordID

295836

C_Command

maker

C_Command

maker

C_Version

4.0

C_Version

4.0