PreviousResponsibilities and Decisions

Chapter 2: Metering Administration Tasks

This chapter explains the tasks required for setting up and maintaining the metering process.

2.1 Overview of Tasks

Your tasks as administrator are:

The Metering Administration program enables you to do most of these tasks. You can restrict access to this program by setting a password for it. Use Options on the View menu and go to the Password tab. On Windows NT, you need to log in with administrator privileges to see the Password tab.

Details of exactly how to do these tasks and which buttons to click are in the help. You can usually click or in the top right corner of the window and click the item you want help on.

2.2 Enabling, Disabling and Distributing Usage Counters

As administrator, your tasks are to:

Use Usage Counters to display the information on the usage counters currently attached to your PC. You can then select the ones you want and click Enable or Disable as appropriate. Figure 2.1 shows a sample Usage Counter Status window.

Figure 2-1: Usage Counter Status Window

The sample Usage Counter Status window shows:

Note: If you or the users have problems with a usage counter not being recognized, you might need to reboot your PCs to re-enable the drivers. Look up usage counter in the index of the help for other suggestions on how to solve this.

2.3 Setting Up and Protecting the Metering Control File

A metering control file records the number of lines metered for each program. You can have as many metering control files as you want, but note that this can lead to problems, as already discussed in the chapter Introduction. As administrator, your tasks are to:

Use Security controls to limit write access to the metering control file. Figure 2-2 shows an example of default security controls.

Figure 2-2: Metering Security Controls Window

The example security controls mean:

For full details on the security controls, click in the top right corner of the window and click the setting you want help on.

2.4 Maintaining the Metering Control File

As administrator you are responsible for maintaining any metering control files you have decided to use, and for ensuring their integrity and validity.

Your tasks are to:

Figure 2.3 shows a sample metering control file. Some summary information on the file is shown at the top of the window, such as the name and location of the file, and the security controls on it, which in the case below show that the file is only readable and not updatable. The text explaining the security status of the metering control file varies according to the settings you apply, as explained above in Setting Up and Protecting the Metering Control File.

The list at the bottom of the window shows information on each metered file, including when each file was last metered and the serial number of the usage counter that was last used.

Figure 2-3: Metering Control File Window

2.5 Safeguarding the Usage Counters

As administrator you are responsible for the security of the usage counters.

Your tasks are to:

The metering control file cannot be updated without an enabled usage counter, so disconnecting or disabling all usage counters also protects the file.

2.6 Monitoring and Reporting on the Metering Activity

As administrator, you are responsible for monitoring the metering activity. You can display the metering transaction log and view the state of the usage counters. In addition, you can view the metering control files and produce reports on them in several formats.

2.6.1 Displaying the Transaction Log

Use Transaction log to display the metering transaction log.

The Transaction log is usually called factory.aud and its default directory is the same as the metering control file's directory. It contains a history of metering transactions. Whenever someone meters some code, a record is made of the number of lines of code in each file that were metered, when they were metered, and against which usage counter.

The transaction log can cover any range of activity you require, such as one transaction log for each metering control file, or one for each user.

The format of the transaction log is:

Metered file
Lines in file
Transaction Date (YYYYMMDD HH:MM:SS)
New lines
Usage counter

For example:

ORDER.CBL,509,EuroSmart,COBOL,19980902 11:43:17,ORDER.PRJ,MVG,509,56

2.6.2 Displaying the Usage Counter Window

Use Usage Counters to display the Usage Counter Window.

This displays information on all usage counters currently attached to your PC. From here you can monitor the status and the credit levels on the usage counters. Look up status in the index of the help for the meaning of each usage counter status.

2.6.3 Displaying the Metering Control File

You can direct Metering Administration to open and display the most recently used metering control file on startup by clicking on Open the most recent file when starting the software which is in the Options dialog on the View menu. Without this option, no metering information is displayed on startup and you have to open the metering control file for yourself. The metering control file is usually called factory.bdb.

The metering control file keeps a record of the total lines metered for each program file. Note that the lines metered might exceed the lines charged to the usage counter, since you can charge some lines to one counter and some to another.

2.6.4 Reporting on the Metering Control File

Use sshort descr Report to produce a metering report from the currently open metering control file.

The metering report can be produced in several formats. By default it is called where the file extension .xxx depends on the file type of the report you produce, and it is usually held in the same directory as the metering control file.

There are several report file types to choose from, depending on how you want to process the report:

You can choose the report type by keying the file name and extension directly, by selecting the appropriate extension or by choosing the report format. You can also elect to sort the report by clicking the appropriate button and choosing a field to sort on.

Copyright © 1998 Micro Focus Limited. All rights reserved.
This document and the proprietary marks and names used herein are protected by international law.
PreviousResponsibilities and Decisions