Table of Contents Previous Next Index

Section 6 Reports

Section 6 Reports
The Web Interface makes it possible for server administrators or for those list owners with multiple lists to obtain reports on their lists and search these lists for specific characteristics.
6.1 List Management Reports
To access, click on the List Management menu, select List Reports, and then select either List Reports, Subscriber Reports, or List Activity Reports.
6.1.1 List Reports
To create a report, select the list or lists to generate the report for. By default, you will see all of the lists you own. Next, select the columns you want to include in the report. Finally, click [Submit].
Note: Each column heading is a clickable link that will sort the column in ascending or descending order. A small arrow pointing up or down will appear indicating the order. Each list name in the report is a clickable link to the list configuration page for that particular list.
The List Report contains a “search” option. Use this to search for a specific list or group of lists.
6.1.2 Subscriber Reports
To create a report, select the list or lists to generate the report for. By default, you will see all of the lists you own. Next, select the columns you want to include in the report. Finally, click [Submit].
The report generated is not just a simple report. It also provides the means of manipulating the reported data. Once the list owner has generated a report, it is possible to change subscription settings or delete one or more subscribers. It is also possible to add subscribers to the list.
The Subscriber Report contains a “search” option. Use this to search for a specific subscriber.
The Subscriber Report also lets you add a subscriber to a list. To add a new subscriber to the list, type the user's email address followed by the full name. Then, choose whether or not to notify the user that he has been added and click on the [Add Subscriber] button.
The Subscriber Report also lets you change subscriber setters. Once the report has been generated, it becomes possible to change any subscriber's settings (except for the subscription date):
Select the subscriber by checking the box to the left of the subscriber name. Check the Invert box to select every subscriber EXCEPT those that you have checked off.
Make the change at the bottom of the column using the drop down boxes. All of the the selections for changing the current options will be listed. Highlight the new option by clicking it.
Click the [Submit] button to save your changes. If you would like your subscribers to receive an email notification that their options have been changed, check the Send email notification of changes box. Otherwise, no notification will be sent.
To view and make changes to the subscription options of individual subscribers, click on the subscriber name. If a name is not available, click on the No Name Available link. The Subscriber Management screen will open for the selected individual. Make any changes and then click [Update].
To delete subscribers, check the boxes to the left of the subscriber names you want to remove, and then click the [Delete Selected Subscribers] button.
Each column heading is a clickable link that will sort the column in ascending or descending order. A small arrow pointing up or down will appear indicating the order.
6.1.3 List Activity Reports
Two types of activity reports can be generated using this Interface. The first report is a history report. This report simply displays the changelog records that match the selection criteria, one record per line, similar to reading the changelog yourself. The second report is a statistics report, which allows you to reduce the changelog records to numbers, based on several different criteria. This is where you can determine (for instance) how many postings were made to a given list on a range of specified dates, how many times a particular LISTSERV command was issued, and so forth.
You should generally choose only one report column on which to report statistics (Event or Email Address or Details) as each value of the text field is counted independently and sorted in alphabetical order, and rows could then include unrelated values and cause some confusion.
Changelog reports are only available for lists where the Change-Log listheader keyword is set to Yes, and only for the time span it was enabled. Enabling Changelogs in the list header will not suddenly make it possible to view past list activity. If Changelogs are enabled, but set to rotate over time (for example, monthly changelogs), the reports are only available for the current report.
To generate a changelog report:
Select a list.
Define the Report Type to create a historical or statistical report or both. If you check both report fields, you will get two reports. The historical report shows the actual changelog entries. The statistical report shows counts and averages.
Define the Report Entries to determine which events to include in the report.
Define the Report Interval to set the date range for the report.
Optionally, you can also select the reporting interval for statistics reports. The default is to show totals for the entire reporting period.
Optionally select a report format. The default is a web-based table. You can also get the results in a "Comma-separated values" (CSV) format which can then be saved from your web browser to a file on your computer, allowing you to import the data into any reporting software that supports CSV files.
Click the [Submit] button.
6.2 Server Administration Reports
To access, click on the Server Administration menu, select Server Reports, and then select either Server Usage Reports, Anti-Virus, Spam Reports, or Server Activity Reports.
6.2.1 Server Usage Reports
The Server Usage Report produces reports on LISTSERV activities and resource usage. The type of information available is divided into Usage Statistics, Delivery Statistics, Bounce Statistics, Anti-Virus Statistics, and Anti-Spam Statistics, which can be accessed by clicking on the tabs. There are four main steps to creating a report:
Select the type of information sought by clicking on one of the tabs.
Select the Report Columns that you would like to include in your report. By default, all columns are checked.
Select the Report Interval to set the date range for the report. By default, the last six months are shown.
Click [Submit] to run and display the report.
6.2.2 Anti-Virus, Spam Reports
This report provides information based on the activities of LISTSERV's anti-virus and anti-spam protection.
LISTSERV's anti-virus protection is only available under the following conditions:
LISTSERV Classic or LISTSERV HPO (not LISTSERV Lite).
Maintenance is current, which can be determined by entering the Show License command in the LISTSERV Command Interface (see Section 3.7 Submitting LISTSERV Commands).
For operating systems other than Windows and Linux, an anti-virus station (AVS) must also be set up.
F-Secure must also be running on the LISTSERV or AVS server.
There are three main steps to creating a report:
Select the Report Columns that you would like to include in your report.
Select the Report Interval to set the date range for the report.
Click [Submit] to run and display the report.
Clicking [Submit] without making any changes displays the default report shows monthly anti-virus and anti-spam statistics for the period indicated (the last 6 full months plus partial results for the current month) in all three of the anti-virus and anti-spam report categories shown at the top of the page.
6.2.3 Server Activity Reports
Two types of activity reports can be generated using this Interface. The first report is a history report. This report simply displays the changelog records that match the selection criteria, one record per line, similar to reading the changelog yourself. The second report is a statistics report, which allows you to reduce the changelog records to numbers, based on several different criteria. This is where you can determine (for instance) how many postings were made to a given list on a range of specified dates, how many times a particular LISTSERV command was issued, and so forth.
You should generally choose only one report column on which to report statistics (Event or Email Address or Details) as each value of the text field is counted independently and sorted in alphabetical order, and rows could then include unrelated values and cause some confusion.
Changelog reports are only available for LISTSERV servers where the SYSTEM_CHANGELOG site configuration parameter is set to 1, and only for the time span during which it was enabled. Enabling Changelogs in the site configuration will not suddenly make it possible to view past list activity. If Changelogs are enabled, but set to rotate over time (for example, monthly changelogs), the reports are only available for the current report.
To generate a changelog report:
Define the Report Type to create a historical or statistical report or both. If you check both report fields, you will get two reports. The historical report shows the actual changelog entries. The statistical report shows counts and averages.
Define the Report Entries to determine which events to include in the report.
Define the Report Interval to set the date range for the report.
Optionally, you can also select the reporting interval for statistics reports. The default is to show totals for the entire reporting period.
Optionally select a report format. The default is a web-based table. You can also get the results in a "Comma-separated values" (CSV) format which can then be saved from your web browser to a file on your computer, allowing you to import the data into any reporting software that supports CSV files.
Click the [Submit] button.