The Yacht-L manual

Dear Yacht-L member,
In this manual you find information to ease the use of Yacht-L mail and archived log-files of previous mail messages, and to help you to adjust the way of obtaining that information according to your own preferences.

Some of the archived files of contributions of members of Yacht-L, such as the AR- and Capsize-files of Ivor Slater can, for the time being, only be accessed via email by sending a GET-command to Listserv@Listserv.SURFnet.NL, e.g.
GET AR-1 DOCUMENT Yacht-L
or
GET WEATHER3 FAXDATA Yacht-L.
To obtain a list of the available files send a message to Listserv@Listserv.SURFnet.NL with the command: INDEX Yacht-L.
I will gradually make the Y-L-files via WWW available. The WWW-version of the partly rewritten Yacht-L manual is available via the Y-L homepage and the Yacht-L filelist.

Yacht-L is a dynamic group, both in make-up and in the vigor and enthusiam of its participants. There is a solid core of enthusiasts who represent a rich resource of fact, opinion, yarns and lore. Whatever your particular interests in sailing, whether you are a novice or an old hand, the subscribers welcome your participation and offer you a forum for your inquiries, information and opinions.

With the explosive growth of the Internet, many Yacht-L subscribers haven't yet had occasion to learn the capabilities of the Listserv software that provides much of the operation of the list. Listserv is, in fact, rather powerful in the features it offers, and presents you with a number of options and capabilities to tailor the service to your needs and preferences. The most important are described here and can also be found in the Yacht-L file: Yacht-L MANUAL.

The first matter to understand is that there are two addresses for Yacht-L. One is for posting messages to the list, so they are delivered to all subscribers. The other is for submitting instructions to the Listserv software, which will then execute them for you. Messages "posted" to the Listserv address will not get to the subscribers to be seen, and will result in an error message from Listserv. Instructions directed to the posting address will be seen by all subscribers, but will not get to the Listserv command processor and will not be executed. They may well produce "error messages" from the subscribers who receive your posting.

The address for posting messages to the list for all subscribers to see is:
Yacht-L@Listserv.SURFnet.NL
(The old address: Yacht-L@NIC.SURFnet.NL will work also however.)
The address for submitting instructions/commands to Listserv is:
Listserv@Listserv.SURFnet.NL

When you do send instructions to Listserv, you should not include anything in the text of your message other than the instructions. If your signature is included, for example, Listserv will attempt to parse it as an instruction, fail, and generate an error message. While this is not a disaster, it is a waste of the SURFnet resources which is unwelcome. Suppress your signature and other extraneous matter in any instructions to the Listserv software.

The second matter of usage you should understand is that all messages posted to the list are logged and archived. The archives are readily available to all subscribers. You can obtain substantial amounts of information on many topics by searching or browsing the archives.

The following discussion is intended to inform you about such access to the archived information, as well as other matters of usage of Yacht-L and Listserv.

!!!!!!! CAUTIONARY NOTE !!!!!!!
Yacht-L is not moderated and postings are not peer reviewed. Any information you find posted represents the unedited views of one individual. Much of what you find posted will be useful information, but you should exercize your own good judgment before putting yourself, your vessel and possibly other people at risk on the basis of such information. Prudence dictates that you consider carefully any information or advice found in the list that may affect the safety of your vessel and its crew.

There are six methods to read messages being sent to the list.

The first method, of course, is the regular mail reception. It means that you receive each message sent to the list as soon as it is sent.

The second method is obtaining mail via DIGEST. When you use DIGEST, the listserver will send you one DIGEST-message a day in which all Yacht-L messages of that day are consecutively accumulated. The messages are preceded by a topic list, containing the subject lines of all messages included in the DIGEST-message.

The third method is obtaining mail via INDEX. When you use INDEX, the listserver will send you one INDEX-message a day in which of each Yacht-L message of that day on one line is given the Sender and the Subject of that message. The INDEX-message contains also a simple means to select the messages you actually want to read.

The fourth method is to get the on a monthly or weekly basis logged messages from the archives of the listserver. All the Yacht-L messages of the month or week requested are sent to you in one (large) file.

The fifth method is obtaining mail with the aid of WWW.

The sixth method is to select messages by doing a database search through the monthly or weekly log files in the Yacht-L archives. You select only those messages of Yacht-L which contain the logical combination of words you used as the search criterium.

For the first three methods you have to be a member of the list (subscribed).


1 How to SUBSCRIBE or SIGNOFF Yacht-L to receive/stop mail

You can only subscribe or signoff by sending a message to Listserv@Listserv.SURFnet.NL. Be sure NOT to send the message to Yacht-L@Listserv.SURFnet.NL. The subject line is not important and will be ignored by the listserver. On the first message line you should type:

SUBscribe YACHT-L firstname lastname
e.g. SUB YACHT-L E.R. Kooi (the space between firstname and lastname is mandatory).

To signoff the list, type on the message line:
SIGNOFF YACHT-L (that is sufficient).
Therefor don't use SIGNON or UNSUBSCRIBE and the like, they won't work.

In case you want to temporarily discontinue the reception of Yacht-L messages, you can signoff and later (re)subscribe again.
Another method is to send a message to Listserv@Listserv.SURFnet.NL (NOT to Yacht-L) with on the first line of the message body: SET Yacht-L Nomail. Later you can receive messages again by sending a message to Listserv@Listserv.SURFnet.NL with on the first line of the message body: SET Yacht-L Mail . In both cases the subject is not important.
HOWEVER: the owners of Yacht-L prefer the signoff/subscribe procedure, because the list gradually gets cluttered by a lot of Nomail-subscribers who never reset to Mail. The use of Nomail requires some discipline of the subscriber concerned.

2 & 3 How to SET your mail to DIGEST (or INDEX)

To set your mail to DIGEST (or INDEX), send to Listserv@Listserv.SURFnet.NL (not to Yacht-L@Listserv.SURFnet.NL) on the first line of the message body (the subject line is not important):

Set Yacht-L DIGEST (or INDEX)
and to return to normal mail again later
Set Yacht-L Mail

When you select DIGEST (or INDEX), the listserver will send you one DIGEST (or INDEX) message a day in which of each Yacht-L message of that day one line with Sender and the Subject (or the whole message) is given.


4 How to GET monthly or weekly log files

Contributions sent to this list are automatically archived. You can get a list of the available log files by sending to Listserv@Listserv.SURFnet.NL (NOT to Yacht-L@Listserv.SURFnet.NL) the command:
INDex Yacht-L
You can then order these files by sending to Listserv@Listserv.SURFnet.NL the command:
GET Yacht-L LOGyymm(A,B,C,D or E)


5 How to BROWSE Yacht-L logs with WWW

If you have a World Wide Web browser, such as Netscape, IExplorer or the like, you can access the on a monthly or weekly basis archiveded logs of messages directly. I am referring to the logbook information collected and made available by the listserver: Listserv@Listserv.SURFnet.NL.
The URL of the WWW-service for the Yacht-L logs is: http://listserv.surfnet.nl/archives/yacht-l.html.
What you find when you get there is a list of the archive log files, arranged chronologically by author, topic or whatever else you selected at the top of that WWW-page. Click on one, and you get the log listing of the messages for the period you selected. By scrolling through the logs, you can find the messages which are of interest. Click on a message entry to see the full message.
You should try to bookmark the URL to you browser; like any large system, the SURFnet machine has a complex structure and addresses. If you don't get to the right place, there's probably a typo.
WWW access to the archives is not limited to subscribers, so you can share the URL for the archives with your friends who are not subscribers to the list. And tell them we would like to have them as subscribers and participants, too.


6 How to search for keywords in Yacht-L log files

Those who can use a Web-browser can use the search-facility of the Y-L-webserver (see par. 5 above). When you want to get many messages sent to you it can be more efficient to send a message to Listserv@Listserv.SURFnet.NL with the following commands, starting on the very first line of the message body (The subject of the message to Listserv is not important):

// JOB Echo=No
Database Search DD=Rules
//Rules DD *
Select * in Yacht-L.1234-6789
Print 2345 3456 4567
/*
// EOJ

(1234-6789 limits the range of messages where the to be "printed" messages are to be found. 2345, 3456 and 4567 are the messages to be send (not printed) to you. All numbers are arbitrary examples. In the print-command you can also indicate a range by typing: PRINT 2345-3456. When needed, more lines with print-commands can be typed. )

For those who have to use email the following is applicable. The following commands perform a search in all monthly or weekly LOGyymm(A,B,C,D or E) files of Yacht-L.
Send a message to Listserv@Listserv.SURFnet.NL (not to Yacht-L) with the following commands, starting on the very first line of the message body (The subject of the message to Listserv is not important):

Database Search DD=Rules
//Rules DD *
Search XXX YYY or ZZZ in Yacht-L -
FROM yy-mm-dd TO yy-mm-dd
Index
/*
// EOJ

XXX, YYY and ZZZ are the keywords. The "or" is a logical or and the spaces between keywords are interpreted as a logical and. Thus "xxx yyy or zzz" is interpreted as "xxx AND yyy OR zzz". A " - " at the end of a command is interpreted as a continuation mark, therefor the next line is considered to be part of the command. The time limitation has as its main purpose to limit the search time, because the CPU-time of the listserver is limited to 60 seconds. Of course, you may also use a simple "Search XXXX in Yacht-L". Index gives you a list of all the messages containing in the message body the combination of keywords asked for. Each message is identified by a number.
An example is:

// JOB Echo=No
Database Search DD=Rules
//Rules DD *
Search ferro-cement or ferrocement or ferro cement in Yacht-L -
SINCE yy-mm-dd
Index
/*
// EOJ

Actually "Search ferro cement in Yacht-L -" would have been sufficient. The implied AND would have found all three cases, but also for instance "cemented ferro-oxide".
After you have received a reply from Listserv, you may send a new message to Listserv@Listserv.SURFnet.NL with the following lines in the message body:

// JOB Echo=No
Database Search DD=Rules
//Rules DD *
Select * in Yacht-L.1234-6789
Print 2345 3456 4567
/*
// EOJ

(1234-6789 limits the range of messages where the to be "printed" messages are to be found. 2345, 3456 and 4567 are the messages to be send (not printed) to you. All numbers are arbitrary examples. In the print-command you can also indicate a range by typing: PRINT 2345-3456. When needed, more lines with print-commands can be typed.)

You may also combine the searching and printing jobs in one message in case you know beforehand that the number of hits are limited. An example of such a message follows below:

// JOB Echo=No
Database Search DD=Rules
//Rules DD *
Search 'bottom paint' in Yacht-L SINCE 95
Index
Print
/*
// EOJ

("bottom paint" is interpreted as one keyword, whereas bottom paint is interpreted as bottom AND paint)

Nota bene: The listserver has very powerful database search facilities, of which here only a fraction is shown. The examples are however sufficient in practically all cases.

More information on LISTSERV commands can be found in the LISTSERV reference card, which you can retrieve by sending an "INFO REFCARD" command to Listserv@Listserv.SURFnet.NL.

Greetings from Eppo R. Kooi (E.R.Kooi@XS4all.NL), Jim Bradley (FNA104@URIACC.URI.EDU), the co-owners of Yacht-L, and James Waldron (JWaldron@Anmark.com) who contributed also to this manual.

Editor: Eppo R. Kooi; email: E.R.Kooi@XS4all.NL
Created: 960210. Last updated: 010716
Back to the top of this page or the homepage of Yacht-L

Counted since 000416