home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
OS/2 Shareware BBS: 2 BBS
/
02-BBS.zip
/
mm5.zip
/
mm.inf
(
.txt
)
< prev
next >
Wrap
OS/2 Help File
|
1996-05-09
|
314KB
|
585 lines
ΓòÉΓòÉΓòÉ 1. What is the MavEtJu PointMailer/2? ΓòÉΓòÉΓòÉ
As the name says, it's a pointmailer for the OS/2 Presentation Manager. It is
compatible with the following Fidonet Technical Specifications:
o fts-0001 rev 15 'A Basic FidoNet(r) Technical Standard' by Randy Bush
o fsc-0048 rev 2: 'A Proposed Type-2 Packet Extension' by Jan Vroonhof
o fsc-0056 rev 1: 'EMSI/IEMSI Protocol Definitions' by Joaquim H. Homrighausen
What do you need to run MavEtJu PointMailer?
o OS/2 Warp. I haven't tried it with version 2.1(1)
o The EMX runtime library version 09a or higher. It's available from the hobbes
archive
o Optional MultiMedia.
o Optional a Version 7 nodelist compiler. I prefer FastList by Alberto
Pasquale.
Is this all I need to join fidonet?
Nope. You still need the following programs:
o An echomail tosser/scanner. I currently use FMail/2 by Folkert J. Wijnstra.
o A mailreader. I'm developping one called the MavEtJu Mailer Reader for the
Hudson Messagebase, but it's currently not available. FleetStreet is a very
good one (at least they say).
Note
The attributes of the windows displayed in several of the pictures in this
document may not match your own attributes. For example the X button at the
upper-right top of a window is an enhancement of NPSWPS. It's used for quickly
closing windows. Other differences are the pushbuttons and scrollbars, they are
enhancements from NEWLOOK. Both the programs are distributed via FernWood and
available on the Internet at the URL ftp://hobbes.nmsu.edu/os2/wpsutil.
The size of the executable is reduced by with nearly 70% by using LxLite.
Related Topics:
o Credits
o Author
ΓòÉΓòÉΓòÉ 2. Installation ΓòÉΓòÉΓòÉ
The installation procedure is splitted in several parts
Disk installation
Dynamic Link Libraries
The nodelist
User dependant settings
Boss settings
Upgrade from version 4 to version 5
The following archives were distributed:
MM5.ZIP: The full version, with both the executables and the DLL's.
MM5RT.ZIP: Everything except the DLL's.
MM5LIB.ZIP: Only the DLL's.
MM4TO5.ZIP: Everything you need to upgrade from version 4 to version 5.
ΓòÉΓòÉΓòÉ 2.1. Disk installation ΓòÉΓòÉΓòÉ
Installation on is easy if you follow the following steps:
1. Create a new directory called MM and chdir to it.
md \mm
cd \mm
2. Create the correct directory structure
md nodelist
md netmail
md temp
md incoming
3. Copy the archive and unzip it
copy a:mm5.zip
unzip mm5.zip
You now have the following tree structure
ΓöÇΓöÇ MM ΓöÇΓöÇΓö¼ΓöÇ nodelist
Γö£ΓöÇ netmail
Γö£ΓöÇ temp
ΓööΓöÇ incoming
That was the disk installation. Now the installation of the DLL's.
Dynamic Link Libraries
ΓòÉΓòÉΓòÉ 2.2. Dynamic Link Libraries ΓòÉΓòÉΓòÉ
The following DLL's (Dynamic Link Libraries) are required:
EMX, EMXLIBCM, GIO2, VERS7, CMN32MP, CMN32MV and P.
The EMX*-dll's must have the following revisions:
EMX : revision = 35
EMXLIBCM : revision = 34
The revision numbers can be detected by using EMXREV.CMD.
The versionnumbers of the other libraries (VERS7, GIO2, CMN32Mx and P) can't be
determined that easy. I believe if you have a file called GIO2.DLL, you
probably have the right one. Checking the last op (P) can only be done by
checking the archive it came with. If it has a version number higher than 204
it will be fine (I think). VERS7.DLL, there is only one version of. CMN32MP and
CMN32MV are part of the Common Library.
You can keep the DLL's in the MM-directory, but you can also move them to a
directory in your LIBPATH.
The nodelist
ΓòÉΓòÉΓòÉ 2.3. The nodelist ΓòÉΓòÉΓòÉ
I had promised myself this program didn't need a nodelist. I kept this promise,
it doesn't require it. But it can be useful. If you don't know what a nodelist
is, click here. A nodelist compiler is only needed when you want to poll at
other nodes than your boss(es).
My favourite nodelistcompiler (FastList) has the following configuration:
V7BugFix
Dial
31-40- / 5 0
31- 0 60 0
- 00 300 0
End
Version7 c:com\mm\v7 NODEX sysop
SysOpLst
NodeList region28.???
NodeList pointeca.???
Nodelist fdpoints.lst
If the nodelist-compiler has been executed, you must have the following files:
nodex.dat, nodex.ndx and sysop.ndx. The MavEtJu PointMailer can't use the
nodelist if one of them is not available.
The next settings are the user dependant settings
ΓòÉΓòÉΓòÉ 2.3.1. What is a nodelist? ΓòÉΓòÉΓòÉ
The nodelist is the FidoNet phonebook. When a mailer needs to know the
phonenumber of an other node, it searches in there. If a user wants to send a
message (or request a file) at a node but doesn't know the nodenumber of that
person it can search for the node's name and grabs the nodenumber out of the
nodelist. The nodelist contains several keywords:
Zone Usually a large geographical area, such as North America, Europe,
Australia and New Zealand, etc. At the time of the release of this
package, the following FidoNet Zone numbers have been allocated:
1. North America (including Canada)
2. Europe
3. Australia, Tasmania, and New Zealand
4. Latin America
5. Africa
6. Asia
Region Usually a somewhat smaller geographical area, such as a country or
part of a (large) country. A collection of regions make up one zone.
Net Usually a collection of systems local to each other. Typically a city
and in some cases including its suburbs. A collection of nets make up
one region.
Node A single system within a net.
Point A single system belonging to a node.
It is constructed this way:
Zone
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇ Net
Γöé Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇ Node
Γöé Γöé Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇ Point
Γöé Γöé ΓööΓöÇΓöÇΓöÇΓöÇΓöÇ Point
Γöé ΓööΓöÇΓöÇΓöÇΓöÇΓöÇ Node
Γöé Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇ Point
Γöé ΓööΓöÇΓöÇΓöÇΓöÇΓöÇ Point
ΓööΓöÇΓöÇΓöÇΓöÇΓöÇ Net
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇ Node
Γöé Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇ Point
Γöé ΓööΓöÇΓöÇΓöÇΓöÇΓöÇ Point
ΓööΓöÇΓöÇΓöÇΓöÇΓöÇ Node
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇ Point
ΓööΓöÇΓöÇΓöÇΓöÇΓöÇ Point
Due to some administrativia, you have some extra layers.
Region A collection of nets, most of the time all belonging to one country.
Host A host is the one who adds and removes entries from the nodelist for
his net.
Hubs If there are too much nodes in a net and the host's systems would be
busy all night, he might add a few hubs to decrease the pressure on
his system.
This is the technical implementation.
Zone
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇ Region
Γöé Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇ Net
Γöé Γöé Host
Γöé Γöé Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇ Hub
Γöé Γöé Γöé Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇ Node
Γöé Γöé Γöé Γöé Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇ Point
Γöé Γöé Γöé Γöé ΓööΓöÇΓöÇΓöÇΓöÇΓöÇ Point
Γöé Γöé Γöé ΓööΓöÇΓöÇΓöÇΓöÇΓöÇ Node
Γöé Γöé Γöé Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇ Point
Γöé Γöé Γöé ΓööΓöÇΓöÇΓöÇΓöÇΓöÇ Point
Γöé Γöé ΓööΓöÇΓöÇΓöÇΓöÇΓöÇ Hub
Γöé ΓööΓöÇΓöÇΓöÇΓöÇΓöÇ Net
Γöé Host
ΓööΓöÇΓöÇΓöÇΓöÇ Region
ΓòÉΓòÉΓòÉ 2.4. User settings ΓòÉΓòÉΓòÉ
This is the time you're going to start the program. Go to the directory where
you've placed the MM.EXE-executable and start it. You will see a messagebox
saying that half of your settings isn't filled in, ignore it.
Select the menu Global and Setup, you'll then see the following notebook:
ΓòÉΓòÉΓòÉ 2.4.1. Modem setup ΓòÉΓòÉΓòÉ
Well, you don't see the field values.
Commport On which serial port is your modem connected?
Baudrate What is the speed of your modem (DCE to DTE of course). If you
have locked your modem or your Serial Communications Drivers,
use that value.
Initstrings What are the initialisation strings of your modem? For Hayes
compatible modems this should be ATZ. Check the manual of your
modem if you're not sure.
Dialprefix The command to let your modem dial. For Hayes compatible modems
this should be ATD or ATDT. Check the manual of your modem if
you're not sure.
Retry delay The delay between two calls.
Max tries After how many retries will be node be dropped from the
pollqueue.
Ok Return value for the ATZ command. For Hayes compatible modes
this should be OK. Check the manual of your modem if you're not
sure.
No carrier Return value if the modem couldn't get a connection. For Hayes
compatible modes this should be NO CARRIER. Check the manual of
your modem if you're not sure.
Busy Return value if the modem couldn't get a connection because the
remote was busy. For Hayes compatible modes this should be BUSY.
Check the manual of your modem if you're not sure.
No Dialtone Return value if the modem couldn't get a connection because it
didn't detect a dialtone on the line. For Hayes compatible modes
this should be NO DIAL. Check the manual of your modem if you're
not sure.
Connect Return value if the modem could connect to the remote. For Hayes
compatible modes this should be CONNECT. Check the manual of
your modem if you're not sure.
ΓòÉΓòÉΓòÉ 2.4.2. Node setup ΓòÉΓòÉΓòÉ
Site name Your computer/site name.
Your name No idea...
Location Geographical location of your system.
Phonenumber Your systems phonenumber or -Unpublished-
Netmail The directory where the netmail messages are stored.
The MavEtJu PointMailer searches in that directory
for outgoing mail.
Incoming The directory where the received files are stored.
Nodelist The directory where to V7 nodelists are stored.
Temp The directory where temporary files are stored. At
the startup of the MavEtJu PointMailer all files in
this directory are removed, so choose carefull!
Toss command This command starts a windowed OS/2- or dos-session.
Enter a filename and its arguments here just as you
do to toss your mail. Don't forget the
.EXE-extenties. .CMD can be started by entering
\OS2\CMD.EXE /c foo.cmd, .BAT can be started by
entering \OS2\MDOS\COMMAND.COM /c foo.bat
Display EMSI-values Mark this button if you want to see the information
the remote sent to you during the EMSI-handshake
session.
Check EMSI CRC value When using a highspeed modem, I often got a crc
mismatch while exchanging EMSI fields. This option
did hide this mismatch.
ΓòÉΓòÉΓòÉ 2.4.3. Optional options ΓòÉΓòÉΓòÉ
The poll queue
What must be the status of the pollqueue at startup?
Debugging
How much information must be written in the logfile?
Auto truncate of the logfile
Sometimes the logfile of the MavEtJu PointMailer can grow large. It can be
truncated automaticly when a certain size is reached or only the last n days.
ΓòÉΓòÉΓòÉ 2.4.4. Sound setup ΓòÉΓòÉΓòÉ
When a certain part of the MavEtJu PointMailer is finished (polling for
example), it can notify the user by playing a certain wav- or midi-file.
ΓòÉΓòÉΓòÉ 2.4.5. Boss installation ΓòÉΓòÉΓòÉ
This is the information you have to supply to the MavEtJu PointMailer for a
proper handshake-session and netmail-routing. Up to ten bosses can be defined.
His name A name or a description about the boss.
Phonenumber The phonenumber for the boss. If a boss has multiple
phonenumbers they can be seperated by a vertical bar
aka |.
Sessionpassword The password you're using in a handshakesession. The
MavEtJu PointMailer only sends it, it doesn't check
the password which is returned by the boss.
Packetpassword The password you're using in a mailpacket. These are
used in the .pkt files for filerequests, netmail
messages etc.
AreaManager password The password you're using to connect or disconnect
mail echo's.
FileManager password The password you're using to connect or disconnect
file echos.
Route-to The definition of which mail has to be send to this
node.
For example: I have two bosses, both in net 2:284,
with nodenumber 205 and 420. The 205 node is my major
uplink for Fidonet, the 420 node only for other areas
the 205 node doesn't carry.
The Route-To of the 205 node would be:
1:* 2:* 3:* 4:* 5:* !2:284/420.*
This says: Every message for zone 1 till 5 except
node 2:284/420.* must be routed via this boss.
The Route-To of the 420 node would be:
2:284/420.*
His address The address of the boss.
Your address The address you have at this boss.
Autopoll An option not yet implemented.
There are several important buttons on the screen:
Remove/Add Removes this boss / Adds a boss (at the end)
Change name Change the name of the current boss.
If you've filled in everything, close the notebook and restart the MavEtJu
PointMailer.
ΓòÉΓòÉΓòÉ 2.5. Upgrade from version 4 to version 5 ΓòÉΓòÉΓòÉ
Upgrade from version 4 to version 5 is easy: Execute the program 4to5.exe, the
complete configuration of the MavEtJu PointMailer which was stored in the file
OS2.INI is moved to the file MM.INI. Start the mailer and fill in the missing
fields (You can check mm.log for example which fields where missing).
ΓòÉΓòÉΓòÉ 3. The menus ΓòÉΓòÉΓòÉ
There are three main menus: Global, Mailer and Control
ΓòÉΓòÉΓòÉ 3.1. Global menu ΓòÉΓòÉΓòÉ
The global menu is splitted in 4 sections:
Setup
You already have seen these menus during the installation, for more information
look at them.
Rescan mailqueue
If you have added messages, select this option to rescan for outgoing mail.
Search in nodelist
Here you can search in the nodelist for the nodenumber of other people. Just
enter a (part of the) last name of the person you're looking for, click on the
Name button and the mailer will show all the people who's name starts with that
name. Click on the name you want to use and the correct address is placed into
the upperright window.
If you press on the Info button, you will get the information about this
person stated as in the nodelist.
About
Shows the about box.
Quit
Quits the mailer.
ΓòÉΓòÉΓòÉ 3.2. Mailer menu ΓòÉΓòÉΓòÉ
The mailer menu is seperated in three parts:
The first part let you control the poll queue by adding / clearing it.
In the left listbox you have all the nodes for which you have mail on hold. In
the right listbox you have all the nodes which are going to be called. The
buttons are not that difficult: Add one node to the pollqueue, add all nodes to
the pollqueue, remove one node from the pollqueue, remove all nodes from the
pollqueue, add all bosses to the pollqueue, add all bosses with mail to the
pollqueue, select a node to be added to the pollqueue and close the window,
these are the ones to be dialed.
The second part let you control the poll session.
The third part are shortcuts for the buttons on the option Change poll queue
ΓòÉΓòÉΓòÉ 3.3. Control ΓòÉΓòÉΓòÉ
The Control menus are menus which control the mailflow, like file transfer,
manager requests and the distribution of incoming mail.
ΓòÉΓòÉΓòÉ 3.3.1. File Transfer ΓòÉΓòÉΓòÉ
File Transfer is divided in two items:
File Transmits is sending files from you to anybody else.
You have to specify the address of the receiver and the files to transmit. The
files to transmit can be choosen by pressing the filedialog button which gives
an OS/2 filedialogbox. Wildcards are not allowed in here.
If you want to send the file direct mark the Send it direct button.
File Requests is requesting files from a node to you.
Here you also have to specify the node at which you want to request the files
and the names of the files (or the magic names). Wildcards are allowed.
ΓòÉΓòÉΓòÉ 3.3.2. Manager requests ΓòÉΓòÉΓòÉ
Manager requests are request from you to a file- or area manager. These
managers send files or echomail received by your boss to you. These managers
require a password, but you have already filled in that in the boss-settings.
Choose an uplink and enter the commands. Normally the following commands will
work: + (add an echo), - (remove an echo), %help (gives help), %rescan (rescan
the remote messagebase for old messages)
ΓòÉΓòÉΓòÉ 3.3.3. Distribution of incoming mail ΓòÉΓòÉΓòÉ
When you've received mail you have to toss it. Tossing means decompress the
incoming mailbundle and place all the messages in the proper messagebase.
ΓòÉΓòÉΓòÉ 4. Credits ΓòÉΓòÉΓòÉ
Credits to the following people:
Jyrki Salmi
for his X-, Y- and ZModem protocol library. It would take me more time if I had
to develop it myself. His solution of feedback to the program which calls the
library is in one word perfect!
He can be contacted via:
Internet: jytasa@jyu.fi
John Morris
for his GIO library. After being busy with my own library which was as updated
version of an old BinkleyTerms communication library I choose his. His GIO
worked with nearly no adjustments in the source.
He can be contacted via
Fidonet: 1:213/760 or 1:213/761
BBS: The Abandoned Land (702.359.1138 (V32) or 702.359.0629 (HST)).
1718 Woodhaven Ln.
Sparks, NV 89434-0731
702.359.1303
Michael Hohner
for his version 7 nodelist lookup library.
Version-7 nodelist lookup (VERS7.DLL) - Copyright 1995 Michael Hohner. All
rights reserved.
He can be contacted via
Fidonet: 2:2490/2520.17
CompuServe: Michael Hohner 100425,1754
Internet: 100425.1754@compuserve.com
Lawrence W. Salomon, Jr.
for his Common-library.
He can be contacted via
Internet: os2man@panix.com
Testers:
Reinout van Schouwen (2:281/545.25 or R.M.van.Schouwen@caiw.nl)
Christian Stuecke (Christian.Stuecke@stud.uni-hannover.de)
ΓòÉΓòÉΓòÉ 5. Author ΓòÉΓòÉΓòÉ
The author of this program is Edwin Groothuis
I can be contacted via:
Internet: edwin@mavetju.iaehv.nl
Fidonet: 2:284/205.1
BBS: ECA-BBS (+31-40-2550352 (V32bis))
Homepage: http://www.iaehv.nl/users/mansion/edwin.html
Snail-mail:
Johann Strausslaan 1
5583ZA Aalst-Waalre
The Netherlands
tel. +31-40-2215746 (18:00-22:00 GMT)
ΓòÉΓòÉΓòÉ 6. Requests ΓòÉΓòÉΓòÉ
The following requests will be implemented in version 6
o ZedZap filetransfer. For this I have to write my own ZModem
library and not long use P.DLL.
o Timed polling. I've already implemented some of this by the
option Autopoll.
o Online help (and reorganisation of this helpfile)
You know more things to be implemented? (Tell me)