Table of Contents Previous Next Index

Section 5 Using the Web Interface

Section 5 Using the Web Interface
Sending email messages to LISTSERV containing commands and sending email to the list to post messages is sometimes confusing for people new to mailing lists. Because LISTSERV is such a powerful and feature-rich program, there are many different keywords and keyword values that can be set for mailing lists. To simplify this process, L-Soft has created a Web interface for list owners and subscribers, providing a centralized location for interaction with LISTSERV. The Web interface allows list owners to manage their lists, post to their lists, review archives, and run reports on list activity. The Web interface allows subscribers to manage their subscriptions, post to lists, and review archives.
LISTSERV 15.0 has a completely revamped Web Administration Interface, making LISTSERV administration significantly easier. It is now possible to change many LISTSERV site configuration settings "on the fly", although some changes may still require a restart of the server before they are recognized.
Most sites will be able to upgrade to LISTSERV 15.0 without losing local web customizations, although this is not optimal and will not generally expose new features to your users.
The LISTSERV 15.0 Web Interface requires JavaScript to be enabled by default. However, those who prefer not to use JavaScript can set their Navigation Style user preference to "Non-Script Navigation" in the Preferences menu.
Virtually all list management operations can be accomplished via this interface, which is tied into LISTSERV's own password manager for security.
Note: This interface cannot be used to manage lists that are coded Validate= Yes,Confirm,NoPW or Validate= All,Confirm,NoPW because passwords are not accepted for validation in those cases.
5.1 The Default LISTSERV Home Page
To enter the Web Interface you need a browser. L-Soft recommends Microsoft® Internet Explorer version 5.0 or greater or Netscape® 6.0 or greater for the best results.
The default home page for LISTSERV typically is reached by using the URL:
On unix: http://yourhost.domain/cgi-bin/wa
On VMS: http://yourhost.domain/htbin/wa
On Windows: http://yourhost.domain/scripts/wa.exe or
http://yourhost.domain/cgi-bin/wa.exe
Of course this is not standardized; the location of the 'wa' script is determined by the value of WWW_ARCHIVE_CGI in LISTSERV's site configuration file. In any case, invoking 'wa' without any parameters returns the default home page.
5.2 Logging In
You can log into the list administration interface from any list's main web archive index page (assuming that this link has not been removed by the list owner; it exists in the WWW_INDEX mail template by default). The interface may also be reached by a link from the default LISTSERV home page mentioned in Section 5.1 The Default LISTSERV Home Page.
To access the list administration interface without a link, you point your web browser to the "wa" script. Typically the interface is accessed as follows:
On Windows: http://yourhost.domain/scripts/wa.exe or
http://yourhost.domain/cgi-bin/wa.exe
and by default, users are directed to the main archives page for the server.
Figure 5-1 LISTSERV Archives Screen
To get to the administrative pages, you will have to log in. If you already have a personal LISTSERV password, then you will simply log in with your existing userid and password.
If you login with the "save my password in a cookie" method, LISTSERV will issue you a cookie that allows you to bypass this login screen (and incidentally to stay logged into the interface for longer than 15 minutes without having to log in again when your session expires). This option is, however, only recommended for people who have physically secure machines (for instance, on your machine at home or in your office) or who are able to otherwise keep unauthorized users from logging in since LISTSERV cannot tell who is using the cookie. Specifically, if your browser does not support separate configurations or bookmark files for different users, you should not use the cookie method in a workplace environment.
Notes: There is a known bug in Netscape prior to version 4.0 that allows you to see the userid and password typed into the text boxes if you back up to the login page using the "Back" arrow. The userid you use here must be associated with the personal password you have from LISTSERV. If you have registered a password as joe@unix.host.com and try to log in here as joe@host.com with that password, LISTSERV will reject your login.
Figure 5-2 Login Screen
5.3 Setting a LISTSERV Password
If you do not already have a personal LISTSERV password (set with the PW ADD command or via the Web Interface) or cannot remember your password, you need to define one now. If you choose to do this via the Web Interface, simply click the Get a New LISTSERV Password link. The Register LISTSERV Password screen opens.
Figure 5-3 Registering a LISTSERV Password
Enter your email and password. Confirm the password by entering it again, and then click the [Register password] button. When your password registration is accepted, a confirmation email will be sent to you. You will have to activate your password by responding to the email (or clicking the link it contains).
5.4 Logging In and Setting Preferences
When you log in for the first time, you will be returned to the main list archives page, but with a difference: the top toolbar will have a lot more options.
Figure 5-4 Web Interface Toolbar
The interface tells you who you are logged in as, and what functions your logged-in address is entitled to perform. It also tells you what mode you're set to (the Basic Mode by default; there are two other modes, "Expert" and "Tutorial"). If you are entitled to edit the page, you can go straight to the page editing wizard by clicking Edit Page.
Clicking the LISTSERV logo icon at the left takes you to L-Soft's home page. Clicking "LISTSERV 15.0" takes you to your default start page.
Help pages are accessed by clicking the Help icon at the right hand side of the toolbar.
The first thing you may want to do is click Preferences.
Figure 5-5 Preference Screen
One of the things you can set is the default start page. Site administrators will probably want to start at the server administration dashboard, while list owners will probably want to start at the list owner dashboard. Or they may be perfectly happy to start at the list archives page. In any case, clicking on Preferences brings up the following page:
More information can be found by clicking the Help icons associated with each preference.
The Server Administration menu gives you access to the Server Dashboard, site configuration functions, mailing list creation and deletion, server reports, server customization (mail and web templates), and the ad-hoc LISTSERV command entry page.
The List Management menu gives list owners access to the List Dashboard, list configuration, customization, and subscriber management.
List Moderation centralizes the moderation function, and it will show all messages needing moderation from the userid@host under which you are logged in.
Email Lists takes you back to the main list archives page.
5.5 The List Management Dashboard
The List Management Dashboard is one of the screens that may appear when you log in. (This is determined by your preference settings.)
The List Management Dashboard is divided into two sections, providing information and reports about your technical support and lists. Each section uses icons to indicate its status and available actions:
Green Shield with a Checkmark – This icon means that you are current. Note that in the Moderation section this icon mean that there are no messages pending moderation.
Orange Diamond with an Exclamation Mark – This icon means that something requires attention. Note that for the Moderation section, this icon means that there are messages pending moderation.
Life Buoy – This icon is used if the Server Administrator has enabled technical support, making it easy and convenient to send requests to the Server Administrator. Once you click on this icon, an email message opens. Enter any information describing your problem. Please be as detailed as possible.
The Technical Support section shows whether or not the Server Administrator has enabled technical support. If it is enabled, then the Life Buoy icon is shown, making it easy and convenient to send requests to the Server Administrator. Once you click on this icon, an email message opens. Enter any information describing your problem. Please be as detailed as possible.
The Moderation section lists any messages that are awaiting moderation. The messages displayed here are those that belong to a list for which you are listed as a moderator.
Note: This section is only displayed if you are a moderator on one or more lists. In addition, only two icons are used in this section. The green icon indicates that there are no messages pending moderation; the orange icon indicates that there are messages pending moderation.
The reports table at the bottom of the screen shows list configuration and list activity (changelog) data, which is a combination of the List Report and the List Activity reports. (Note that the list activity data is only visible if a list has changelogs enabled.) By default, the changelog data is not automatically calculated because of the time it takes to process the log files, especially if you have many lists or if they have large log files. To calculate the data, just click on one of the plus signs, [+]. If you would like the changelog numbers to be loaded automatically every time you access the page, you can change the Owner Dashboard Changelogs setting in the Preferences section.
Figure 5-6 List Management Dashboard
To add or remove columns from the table, click the Edit Table option. This option is a great way to customize the information shown in the table, making sure only the information you want to see is visible. If you customize the table, then your changes will be saved in your preferences and will be automatically loaded every time you log in.
The Lists Per Page parameter controls how many lists will be displayed on a single page. The default is 10. If you want to break the list into 20 lists (for example), then simply enter "20" in the box and click [Update].
The Changelog Period parameter lets you select the date range for the changelog columns in the report. The default is 1 day. If you want to change this period, simply choose a different option from the drop-down menu, such as 14 days, and then click [Update].
5.6 List Configuration
Lists can be configured using a wizard, which guides you step-by-step through the configuration process, or manually.
To open the List Configuration Wizard, click on the List Management menu, select List Configuration, and then select List Configuration Wizard.
To configure a list manually, click on the List Management menu, select List Configuration, and then select Manual List Configuration.
Figure 5-7 The List Management Menu
For those of you who want to configure the list manually, you can edit the list header in its "raw" state. This is only recommended for people who are very comfortable with the format of the LISTSERV list header and know the keywords and their parameters very well.
The list header appears in a multi-line text box that can be scrolled up and down. You simply type in the changes or added lines just as if you were using a regular text editor. When you are finished, click the [Submit] button to submit the changes. If you want to start over, you can click the [Reload] button to reload the header information from the server.
When you submit your changes with the [Submit] button, you will get the same kind of feedback from LISTSERV as you would if you sent a PUT operation by mail. The next screen will either say that the header of the list has been successfully updated, or it will indicate that it has found errors and that the header has not been stored. The feedback page also has a text box containing the header information you've just stored (or tried to store) so if you need to make further corrections to the header, you don't have to back up and start over.
The list header keywords and their parameters are documented in the List Keyword Reference document, in the online help, or (when using the configuration wizard) by clicking the Help icon for each keyword.
Email Command: To get descriptions of all the keywords sent to you in a plain text email, send the following command: INFO KEYWORDS
5.6.1 Hiding Parts of the Header
Parts of the header can be hidden from the public through the Web Interface or by updating the header over email. To hide parts of the header, enter the “hide header” directive:
.HH ON
on a line by itself before the first header line you want hidden, and turn it off with the directive:
.HH OFF
on a line by itself after the last line you want hidden. You may have as many hidden and non-hidden blocks in the header as you wish.
5.7 The Administrator Task Wizard
The Administrator Task Wizard allows you to review and modify which email addresses handle each aspect of administering your list. There can be any number of people involved in running a list. You might have the same person taking on all administrative roles alone, or you may assign several different people to each role.
To open the Administrator Task Wizard, click on the List Management menu, select List Configuration, and then select List Configuration Tasks.
Make desired changes to each of the keywords on any of the tabs, and then press the [Submit] button. Alternatively, you can click on each keyword to follow the links to the Wizard pages for each keyword – these include lengthy explanations about the keywords.
5.7.1 Understanding Administrator Roles
5.7.1.1 What is an Owner?
Owners are the primary administrators of the list. Email addresses with "owner" privileges may change the configuration and templates of the list, add and delete subscriptions, and change the settings on subscriptions.
Owners also receive email sent to the official list owner address. Unless otherwise specified, they receive notifications of subscriptions, signoffs, and error messages related to the operation of the list.
Some owner addresses may be designated as "quiet" owners. These addresses have all the owner privileges but do not receive any of the owner messages. Each list must have at least one non-quiet owner.
If you are replacing an owner, start by adding the new owner address. Next, make sure that the new address is able to function as an owner before removing the old address from the list of owners. If you make a mistake by first removing the old working address and then discovering the new address does not work, you may have to get the site administrator to fix your list for you.
5.7.1.2 What is an Editor?
On lists set to Send=Editor, editors are those addresses that are allowed to post directly to the list without moderation (that is, approval from a moderator).
On moderated lists where the Moderator keyword is not defined, the first editor listed in the Editor keyword acts as sole moderator.
On all lists, regardless of the value of the Send keyword, editors are not subject to limitations on the number of daily posts to the list, as set by the Daily-Threshold keyword.
The first editor listed in the Editor keyword must be an email address pointing to an individual. Other editors can point to lists on the same server including the current list; in that case, all the subscribers on the list have "editor" privileges. To enter the name of a list, you must enclose just the list name (not the list address) in parentheses.
If you do not specify the Editor keyword, the primary editor is the first listed Owner address.
5.7.1.3 What is a Moderator?
When a list is fully or partially moderated, all messages from "moderated" addresses are sent to the moderator(s) for approval. You can set up your list so that incoming messages go to each moderator in turn in a "round-robin" fashion, or so that all incoming messages go to all moderators.
If you do not specify the Moderator keyword, moderated messages get sent to the primary Editor address.
Messages are moderated in the following circumstances:
5.7.1.4 What is an Error?
Occasionally, problems occur on a list, and LISTSERV needs to know where to send error notifications. If you do not specify the Errors-to keyword, error messages will be sent to all non-quiet owners.
Listed below are a some of the most common circumstances where error notifications might be sent to the address specified by Errors-to (or its default value):
If the list is set to Auto-Delete=Yes, and there have been any delivery errors ("bounces") within the set time period, a "Daily Monitoring Report" is sent every morning.
If the list is set to Auto-Delete=No, then all bounces are forwarded.
If an email is received for the list containing mail headers pointing to the list (this may be an indication of a condition that would cause a mailing loop if the post were allowed to be delivered to the list).
5.7.1.5 What is a Notification?
Whenever someone subscribes or is added to the list, or someone signs off or is removed from the list, a notification is sent to the non-quiet owners (if Notify=Yes) or to the address(es) specified in the Notify keyword.
To turn off notification of subscription activities, set Notify=No.
5.8 List Maintenance via the Web Interface
Important: The LISTSERV 15 Web Interface cannot be used to manage lists that are coded Validate= Yes,Confirm,NoPW or Validate= All,Confirm,NoPW because passwords are not accepted for validation in those cases.
The Subscriber Management screen lets list owners examine, delete, and add subscribers to a specific list. To access this screen, select Subscriber Management from the List Management menu. From this screen, select the list you want to work with, and then select either the Single Subscriber or Bulk Operations tab. The Single Subscriber tab lets the list owner examine or delete a subscription and add a new subscriber to the list. To add or delete many subscriptions at a time, use the Bulk Operations tab.
Note: To examine, modify, or delete multiple subscriptions at once, you can also use the Subscriber Reports screen.
5.8.1 Examining or Deleting a Subscription
This works very much like the "SCAN" command. Simply enter your criteria in the text box and click the [Search in List] button.
Figure 5-8 Examining or Deleting a Subscription
If there is no match for your entry, then you will get back the same page but with a Scan: No match message at the top. If, on the other hand, your search is successful, one of two things will happen.
If there are multiple matches for your criteria, a screen will be displayed with a scrollable list box containing all of the matches
Figure 5-9 Select Subscriber to Examine or Delete
Next, simply choose the user you want to examine or delete and click on the appropriate button. If you did not find what you were looking for, you can press the [New Search] button to get a new search screen.
If there was only a single match to your query, then the preceding screen will be bypassed and you will go directly to the next screen, which is the Subscriber Management screen for the subscription. It displays the values of all the settings for that subscription, including the subscription date and name. From the account management screen, you can delete the subscription or change the name, the email address, or the subscription options associated with the subscription. A sample of the screen is shown below.
Figure 5-10 Subscriber Management Screen
5.8.2 Adding a New Subscriber to the List
To add a new subscriber, select the list you want to add the subscriber to. Then, in the Add New Subscriber section, enter the email address and name of the new subscriber, select whether or not to send an email notification to this subscriber, and click the [Add to List] button.
Note: The full name of the subscriber is optional. If omitted, then the user will be added anonymously to the list.
Figure 5-11 Adding a New Subscriber
5.8.3 Bulk Operations
The Bulk Operations tab allows a list owner to upload an input file containing email addresses and (optionally) names, one address per line, and either add all the email addresses in the file to the list (optionally replacing the current subscribers) or remove them from the list.
The input file is created on your own machine with an ASCII text editor. After clicking the [Import] button you will see a command response similar to the following:
If the Add the imported address to “List”; do not remove any subscribers option is selected:
ADD: no error, 202 recipients added, no entry changed, no duplicate, none forwarded.
If the Remove all subscribers from “List”, and add the imported address option is selected:
DELETE: 14 subscribers removed.
ADD: no error, 38 recipients added, no entry changed, no duplicate, none forwarded.
(If this option is selected, but no input file is specified, then you will only get the DELETE message.)
If the Remove the imported addresses from “List”; do not add any subscribers option is selected:
DELETE: 93 subscribers removed.
If the Remove the imported addresses from all lists option is selected:
DELETE: 243 subscribers removed.
DELETE: 109 subscribers removed.
Global deletion process complete, 352 entries removed.
If you do not supply an upload file where required, or if your browser does not support the RFC1867 file upload extension, you get the following message:
Your browser did not upload any file during the transfer. Assuming you did fill in the file input box, the most likely cause is that your browser does not support the file upload extension (RFC1867).
Figure 5-12 The Bulk Operations Tab
Notes: Bulk operations are not enabled by default. The site manager must enable this functionality explicitly. If you get an error 2 when you click on the [Import] button, this means that the "upload" directory has not been created. If you get an error 13 when you click on the [Import] button, this means that the "upload" directory has been created but the CGI program user does not have write permission in that directory. In addition, the input file must be a plain text file (not a word processor document or spreadsheet) and must contain one address per line, optionally followed with a space (or TAB) and the subscriber's name. In addition, the subscribers being added or deleted will not be notified.
5.8.4 Moderating a List
The List Moderation Interface allows list moderators to moderate a list through the Web Interface, rather than using email. To start moderating a list, click on List Moderation from the Toolbar. The List Moderation screen has a list selection area at the top. Click the drop-down menu to select the list you want to work with. Unlike the other list selection areas that show the lists for which the logged-in user is the owner, this one only shows the lists for which the user may act as moderator.
If you are moderator to more than one list, select the list you want to moderate. If there are no messages for you to moderate, the only action possible is to “refresh" using the [Refresh] button, which looks for messages to moderate in the selected list.
If there are messages to moderate, a table, like the one below, is displayed and contains all the messages that were sent to the logged-in email address for moderation.
Figure 5-13 Moderated List Table
The first column contains check boxes, one per message. The second column shows the Subject of the message. The third column shows the From email address that sent the message. The fourth column shows the Date in the message (not necessarily when the message was received). When All Moderators is checked, two extra columns are displayed showing whether your account received the moderation request or other accounts did; if the Moderator= keyword is set to "All" with multiple moderators, both columns will be checked for all messages.
5.8.4.1 Accepting or Rejecting the Message
If you can tell at a glance which messages to approve or reject, simply check all the boxes corresponding to the messages you want to act upon. Next, go to the Action drop-down menu, select the action you want to perform – Approve or Reject. (The default action is Refresh, which simply refreshes the display without accepting or rejecting any messages). Click the [Submit] button to record your actions.
5.8.4.2 Viewing the Message
Sometimes, you cannot immediately tell whether a message should be accepted or rejected without reading the contents of the message. To open the message contents, click on the subject of the message to display a new view that shows only one message.
Figure 5-14 Message View
If the message is multi-part (the example includes an HTML part), the part displayed is determined by your preferences. The main mail headers of the message are also displayed. If you wish to approve or reject the message, select the appropriate action and then press the [Submit] button.
5.8.4.3 Subscriber Settings
If the logged-in email address is an owner of the list, and if the "From" address of the message is a subscriber to the list, then the email address in the main moderation view is a link and the Change Subscriber Settings link is shown on the message view. Both of these links lead to the interface for viewing and changing the subscriptions settings.
These links are convenient for lists that have Default-Options=REVIEW, with a policy of changing the subscription to "NOREVIEW" after the first on-topic posting to the list. The moderator/owner may look at the message, decide that the subscriber may be removed from moderation, change the subscription settings to "NOREVIEW", and then approve the message. Be sure to change the settings first because the message will no longer be displayed after it has been approved or rejected.
Similarly, if a subscriber has sent inappropriate material to the list, the moderator/owner may want to delete the subscription.
Note: After using the subscriber settings, always use the Back link at the bottom to return to the List Moderation Interface and not the "Back" feature of the browser. The "Back" feature of the browser may cause past approve/reject commands to be repeated, and errors will be displayed, complaining that the "cookies" do not correspond to any existing messages awaiting moderation (true, since these were already approved or rejected). This does not do any harm at all to your list, but may still be disconcerting.
5.9 Digesting and Indexing
The List Configuration Task Wizard guides you through providing digest and index versions of the list, in addition to the usual individual postings. To access this wizard, click on the List Management menu, select List Configuration, and then select List Configuration Tasks. Click on the Digest tab to setup digest or index versions of the list.
Normally, LISTSERV sends messages out to subscribers as soon as it receives them, so that the subscribers receive the mailing list messages throughout the day. Some may prefer to get all of the messages at the same time, combined into a single piece of email. Such a collection of messages is called a digest.
Another option, similar to the digest, is for LISTSERV to send the subscriber a list of what messages have been distributed to the mailing list recently, along with information about when the message was posted, how big it is, and who sent it. This is referred to as an index.
5.9.1 What is a Digest?
Normally, LISTSERV sends mailing list messages out to subscribers as soon as it receives them, so that the subscribers get messages throughout the day.
Some may prefer to get all of the messages at the same time, combined into a single piece of email. Such a collection of messages is called a digest.
Depending on the volume of messages that go out over a mailing list, it may make sense to have the digest go out once a day, once a week, or once a month.
LISTSERV allows subscribers to get digests in three formats: HTML, MIME, and NOMIME NOHTML. Subscribers can individually choose the format that works best in their email clients. Each email client is different, so subscribers should experiment with the different digest styles to find the one they prefer.
5.9.2 What is an Index?
An index, similar to the digest, is another option for receiving one message that summarizes a collection of messages from LISTSERV. LISTSERV sends the subscriber a list of what messages have been distributed to the mailing list recently, along with information about when the message was posted, how big it is, and who sent it.
Indexes are only available for archived mailing lists that have digests enabled. Indexes are sent out at the same time as the digests.
Indexes are available in HTML and NOHTML formats. If HTML is used, the index includes a link to each message in the Web archive interface. If NOHTML is used, the index includes instructions on how to retrieve the messages the subscriber wants.
5.9.3 What is a Plain Text Digest?
Plain text is the simplest form of digest. All email programs should be able to read plain text digests without any difficulty. The basic form of this type of digest is given in RFC 1153.
At the beginning of a plain text digest there is a list of the subjects of the messages in the digest:
1. Request for comments
2. Another subject, another ruler (3)
3. Project deadline on Thursday
Note: If the mailing list is used for discussions, typically there will be multiple messages for each subject.
After the topics list, the contents of the DIGEST-H template (if any) will be displayed:
This mailing list is sponsored by XYZ Industries. If you would prefer to receive this mailing list as individual messages instead of as a digest, send a "SET MYLIST MAIL NODIGEST" to listserv@lists.example.com.
After the contents of the DIGEST-H template (if any), the messages will appear in the order LISTSERV received them, separated by lines consisting of 30 hyphens.
Since the digest is plain text, any HTML messages will appear uninterpreted (the raw HTML code will appear) and any attachments will appear in their encoded form. Additionally, any special characters (smart quotes or accented letters, for example) may not display correctly in plain text digests.
5.9.4 What is an HTML Digest?
Recipients of an HTML digest who have email programs that are programmed to handle such digests will see an index of the day's messages followed by the contents of the DIGEST-H template (if any).
For example:
Clicking on a subject in the table of contents takes you down to the relevant message or messages in the index. Clicking on any of the messages will then take you to the message in question.
HTML digests include information about the content of each message (through MIME); therefore, each message should display normally.
A special note: Since the digest includes all of the messages as MIME attachments, all of the links in the HTML digest index are of the form: "cid: content-id" (see RFC 2111 for more information about this type of URL). Unfortunately, some email clients, even some that otherwise support HTML, do not handle such references correctly. For this reason, some subscribers may not be able to use HTML digests.
5.9.5 What is a MIME Digest?
A MIME digest is midway in complexity between a plain text digest and an HTML digest. It contains a table of contents of the topics discussed in the digest:
There are 4 messages totalling 86 lines in this issue.
Topics of the day:
1. Request for comments (3)
2. Another subject, another ruler
Each message in the digest is then included as a MIME attachment. The subscribers access the messages as they would any other type of attachment. And, since MIME standards require that the type of content of each attachment is identified, all messages should appear normally, without the sort of display problems that plain text digests can have.
5.10 Reports
The Web Administration 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.
To access, click on the List Management menu, select List Reports, and then select either List Reports, Subscriber Reports, or List Activity Reports.
5.10.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.
5.10.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.
5.10.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. This table 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 list header 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:
Define 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 Report Entries to determine which events to include in the report.
Define 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.
5.11 Sending Interactive Commands via the Web
The LISTSERV Command Interface is used for submitting LISTSERV commands that are not otherwise facilitated by the Web interface. See the List Owner’s Manual for LISTSERV for a listing of all commands.
For some commands, the response is automatically displayed by the Web interface. For others, a special command parameter must be used in order to display the response in the browser, otherwise the response is sent by email. In addition, other commands are only able to respond by email.
To access the LISTSERV Command Interface, click on the List Management menu, and then select LISTSERV Command.
The Command Interface can only be used for single line commands. In particular, the PUT command will not work through the Web interface. Multi-line commands must be sent by email.
A selection of frequently used commands is available at the bottom of the screen.
5.12 Mail-Merge
Advanced mail-merge features are available and can be accessed either by sending specially-formatted DISTRIBUTE jobs to LISTSERV or by using the web administration interface. The web interface is not a "wizard" but simply an interface that allows you to "cut and paste" a mail merge message and select different standardized groups of list subscribers to whom the message is to be sent.
Notes: LISTSERV's mail-merge functionality REQUIRES the use of LISTSERV’s Embedded Mail Merge feature. For more information, see the EMM keyword in the Site Configuration Keyword Reference document. Mail-merge functions are documented fully in the Advanced Topics Guide for LISTSERV.