MULTI server.

MULTI.EXE, server for FBB-BBS.
(By LA6CU, Per)

This server is used to send personal copies of special messages.  The 
original is addressed to a special "call", and then there is automatically
made personal copies to everyone that shall have one.

MULTI may work in 2 ways.  You may use one of them, or both.  I use both at
the same time.

New in version 3.00:
The server may use different languages.  There is a new file MULTI.TXT (reside
in SYSTEM-directory) that holds all languages.  There is one "module" for
each language.  See the text in MULTI.TXT for more info.


1:  WITH DAT-FILES:
-------------------

Installation:

MULTI.EXE is put in the same directory as SERV.EXE.   MULTI will read from
INIT.SRV...

In INIT.SRV, MULTI is included together with REQFIL, REQDIR etc.  Example:
#
------
#
REQFIL  REQFIL
REQDIR  REQDIR
CLUB    MULTI
TEST    MULTI
#

In this example all messages sent to
SP CLUB
will be copied to all callsigns in the file CLUB.DAT, while messages sent to
SP TEST
will be copied to all callsigns in the file TEST.DAT.

CLUB.DAT and TEST.DAT (in this example) must stay in the FBB-directory.
You must make one such .DAT-file for every to-field you define in INIT.SRV.

The .DAT-files must consist of callsigns (@BBS and H-addresses allowed) for 
all those that shall have a copy.

There are 4 different copy-types.
A (action)      :  This is the callsign that will receive the message, or
                   perform the action described in the message.
C (copy)        :  This callsign receives a copy of the message.
I (information) :  This callsign receives a copy for information.
H (hidden)      :  This callsign receives a copy, but his callsign will not
                   appear in the footnotes of the message, telling who has
                   received a copy.
                   
There may be more than one callsign on each line (starting with A, I, C or H)
separated by a comma.  There may be maximum 100 callsigns altogether.  
Comment-lines are extras, they MUST start with a #

From version 3.00 there will also be a separate line with a letter 
corresponding to the language the server will use.  What letter corresponds
to what language, is explained in MULTI.TXT.

Example of CLUB.DAT:

E                           <-----  Use ENGLISH language for CLUB-server
A LA6CU, LA1B, LA2D         <-----  Copies to the people doing the job
A LA6GDA                    <-----    "     "   "   "    "     "     "
                                    May be several lines if there is not 
                                    enough room in one line. 
I LA5RBA                    <-----  LA5RBA is informed on the matter
C LA6IM @ LA6IM             <-----  LA6IM receives a copy for updating his
                                    node-lists
H LA2GIA                    <-----  LA2GIA receives a copy, but will not appear
                                    in the list of callsigns at the end of
                                    each message.

Beware:  The .DAT-files shall consist of callsigns and comments, nothing 
         else !  No /EX, no * and no *** end of file.

MULTI will NOT send a copy back to the originator, even if he also is in
the .DAT-file.  This to avoid "looping" of messages.
MULTI will send an acknowledge-message back to the originator, telling 
him that the copying was successful, and show him a list of all callsigns
that will receive such a copy.

R:lines on incoming messages are removed, until there has arrived 2 lines
without R:  After that. R:lines are accepted again.  This is done to make it
possible also to forward messages back the same route, and at the same time
make it possible to include R:lines in the message itself.

R:lines are NOT checked to prevent forward to BBSs that are already in
these R:lines, because a message to a MULTI-server only will be processed
at the end-BBS anyway.

MULTI needs very little memory (I have not checked how much..), but I have
been told that it needs less than 35k.  MULTI does not write to screen.

MULTI.EXE must be in the same directory as SERV.EXE.
From version 3.00 the .DAT-files must be in the SYSTEM-directory.
MULTI.TXT must also be in SYSTEM-directory.

MULTI makes a temporary file MULTI.TMP on disk, and delete it afterwards.
Everything else is done in memory, and the result is placed in MAIL.IN, as
all servers do.


2:  WITH ALL CALLSIGNS DIRECTLY IN THE ORIGINAL-MESSAGE.
--------------------------------------------------------

MULTI still works exactly as before, with the same installation.  But after
a request from F6ABJ and F6FBB I have made a modification so that users
themselves can decide what callsigns will receive a copy.  This is done
by including the callsigns in the message itself.

In INIT.SRV, MULTI is still included like before (see further up).  But
in addition, you now must have 1 extra line, like this:

#
------
#
REQFIL  REQFIL
REQDIR  REQDIR
CLUB    MULTI
TEST    MULTI
MULTI   MULTI               <----  This line is new.
#

From version 3.00 SP MULTI uses the default language (see MULTI.TXT).
Other languages may be configured.  For example you may have:
MULTI   MULTI   (for default language)
MULTIE  MULTI   (for english language)
MULTIF  MULTI   (for french language)
MULTIH  MULTI   (for netherlands language)
MULTIN  MULTI   (for norwegian language)
So, you may send the same message SP MULTI, SP MULTIE, SP MULTIF, SP MULTIH,
SP MULTIN etc.  The first 5 letters must always be MULTI, when used without
DAT-file.  Default language will typically be english (SP MULTI), but the
users will have the possibility to use others, as configured.

Users will now be able to send messages to MULTI, like this:
SP MULTI     The program will now collect the info on who will receive a 
copy, from the message itself, and not from a seperat .DAT-file like 
SP CLUB or SP TEST still will do.

There are 4 different copy-types.
A (action)      :  This is the callsign that will receive the message, or
                   perform the action described in the message.
C (copy)        :  This callsign receives a copy of the message.
I (information) :  This callsign receives a copy for information.
H (hidden)      :  This callsign receives a copy, but his callsign will not
                   appear in the footnotes of the message, telling who has
                   received a copy.
(In addition one may use CC: instead of only C for Copy.  Special request..)

There may be more than one callsign on each line (starting with A, I, C or H)
separated by a comma.  There may be maximum 100 callsigns altogether.  
Comment-lines are extras, they MUST start with a #

Example:
SP MULTI
Digipeater upgrade          <-----  Title of message
A LA6CU, LA1B, LA2D         <-----  Copies to the people doing the job
A LA6GDA                    <-----    "     "   "   "    "     "     "
I LA5RBA                    <-----  LA5RBA is informed on the matter
C LA6IM @ LA6IM             <-----  LA6IM receives a copy for updating his
                                    node-lists
H LA2GIA                    <-----  LA2GIA receives a copy, but will not appear
                                    in the list of callsigns at the end of
                                    each message.
---------                   <-----  After the last callsign, there must be a
                                    string of at least 5 '-' before the
                                    actual message.
                                    
Then follows the contents of the message, and end with Ctrl-Z or /EX.

As usual, the sender will receive a message saying that the copies were
made.  The messages to all the other callsigns will be identical, and look
like this:

Message via LA6CU MULTI-server (v3.00) :

Contents of message

============================================================================
For action       : LA6GDA, LA6CU, LA1B, LA2D.
For copy         : LA6IM.
For information  : LA5RBA.
============================================================================

All copies are identical, but A, C and I determines in which line in the
footnotes the callsigns will appear.  A callsign after an H will not 
appear in the footnotes.

73 de Per, LA6CU.






This page was last updated 17-Apr-99