Report:  User Log
Option:  -u
Option Parameters:
-
us  Show the current user log
-ua  Archive log/restart (Network License Only)
-ur  Remove user from current log (Network License Only)
Compatible Options:  None
Usage:

RSM logs its operation into a log file called rsm.log.  This file is located at the license file location.  The user log is accessed each time RSM is run to monitor the compliance to the license agreement.  The following options allow for the maintenance of the user log.

-us  The User Log Show option shows the contents of the user log.  The user log is objective evidence for who and how the tool was run.  This can be useful when assessing the tool usage and license commitment.  Once the rsm.log file is archived, the rsm.log file is named rsmlog.mm.dd.yyyy where mm is the month, dd is the day and yyyy is the year.  You can concatonate several log files together and have RSM report the user summary.

The tool administrator archives the rsm.log file each month.  The administrator would like the tool usage for the first quarter.  The user will save the current log file, concatonate the rsmlog files to form a aggregate rsm.log file the use the -us option to show the contents of the aggregate log file.  The original log file will then be restored.

Windows Example:
  cd \rsm
  copy rsm.log rsm.bak
  copy rsmlog.01301999+rsmlog.02281999+rsmlog.03311999 rsm.log
  rsm -us > rsm1stQ.txt
  copy rsm.bak rsm.log

UNIX Example
  cd /usr/local/rsm
  cp rsm.log rsm.bak
  cat rsmlog.01301999 rsmlog.02281999 rsmlog.03311999 > rsm.log
  rsm -us > rsm1stQ.txt
  cp rsm.bak rsm.log

-ur  When the number of rsm users exceeds the number of licensed users, rsm emits a user warning of this fact.  The tool administrator will have to remove a user from the user log.  The -ur option will allow Network users to remove users from the user log.  The user will be prompted to enter the License Number.  After the license number is validated, the user will be prompted for a temporal key.  This key is a random number which the user must retype into the program.  The purpose of the temporal key is to not allow this option to be run via a script.

-ua  The user log will grow over time.  As the user log get bigger the access time for the user log will increase.  The tool administrator may desire to archive the user log and restart logging.  The -ua option allows for the archival of the user log with a time stamp for the file extension.

 rsm -us 
Resource Standard Metrics - User Log
C:\rsm\rsm.log
------------------------------------------------------------------------
stuart Thu Jul 08 14:07:24 1999 -us
stuart Thu Jul 08 14:07:41 1999 -foc c:\src\cpp\classtest.cpp
------------------------------------------------------------------------
Number of Log Entries: 2
Number of RSM Users  : 1
 rsm -ur
User Log Administration - Remove User

Enter The License No: WN1381

Session Temporal Key: 26220
Enter Temporal Key  : 26220
Enter User Log Name : stuart

Removed User stuart from RSM User Log
 rsm -ua
User Log Administration - Archive User Log

Enter The License No: WN1381

Session Temporal Key: 26883
Enter Temporal Key  : 26883

RSM User Log Archived to: C:\rsm\rsmlog.07081999