home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 1 / crawlyvol1.bin / bbs / marsmail / marsmail.txt < prev    next >
Text File  |  1992-05-12  |  41KB  |  785 lines

  1.      ==========================================================================
  2.      =                                                                        =
  3.      =  MARS Productions presents...                                          =
  4.      =                                                                        =
  5.      =          ****   *       ***    ***  *  *  *   *   ***   *  *      *    =
  6.      =          *   *  *      *   *  *     * *   ** **  *   *  *  *      *    =
  7.      =          ****   *      *****  *     **    * * *  *****  *  *      *    =
  8.      =          *   *  *      *   *  *     * *   *   *  *   *  *  *           =
  9.      =          ****   *****  *   *   ***  *  *  *   *  *   *  *  *****  *    =
  10.      =                                                                        =
  11.      =     - MARSmail Install  v1.3              Release date: may 12,1992    =
  12.      =     - MARSmail Exporter v1.10/4D         (C) 1992  MARS Productions    =
  13.      =     - MARSmail Importer v1.10/4D                                       =
  14.      =                                                                        =
  15.      =     Written by: Mario van den Heuvel                                   =
  16.      =                 Newtonstraat 257                                       =
  17.      =                 2562 KH  Den Haag                                      =
  18.      =                 The Netherlands                                        =
  19.      =                 FidoNet point: 2:281/522.3                             =
  20.      =                 THANet   node: 70:3170/9.0                             =
  21.      =                 ()lympic node: 17:775/211.0                            =
  22.      =                                                                        =
  23.      ==========================================================================
  24.      Blackmail                                                         Page: 1
  25.  
  26.      Some notes:
  27.      -----------
  28.      This software is Public Domain. PD-Libraries are NOT allowed to spread
  29.      this program without _WRITTEN_ permission by the author.
  30.  
  31.      This program has been tested with LED. I suggest you use this program.
  32.      It's the BEST message-editor available for the Atari and you will have
  33.      no problems (I hope...).
  34.      
  35.      Use of the program is AT OWN RISK. I'm giving a special TTD Warranty!
  36.      ('Till the door) :-)
  37.      Please register yourself as user by sending me a card, lettre or even a
  38.      humble netmail-message will do. No payment is required but i would be in
  39.      the highest sky if you decide tp pay a few giulders for my trouble.
  40.  
  41.      Thanks for the attention.
  42.  
  43.      Automatic Greetz,
  44.      Mario van den Heuvel, Founder of MARS Productions.
  45.      Blackmail                                                         Page: 2
  46.  
  47.      The "thanks" bit:
  48.      -----------------
  49.      Thank you for your convidence in my programming. This little manual will
  50.      explain all the options of MARSmail installer, the only program that needs
  51.      explaination. The other programs don't need really a description. Just
  52.      start them and they will do their work.
  53.      Thanks to Vincent Partington (yes, the "Jekyll" man, the BEST protocol
  54.      available on the Atari) for some suggestions.
  55.  
  56.      The "what happened lately" bit:
  57.      -------------------------------
  58.      Here are some update notes about Blackmail. Please read the entire manual
  59.      at least ones, so that you know what to do. This manual has been complete-
  60.      ly re-written.
  61.  
  62.      As Blackmail developed more then expected, the coniguration files of the
  63.      betaversions are NOT readable anymore by the Installer, as well as the
  64.      Importer and Exporter. If you're in doubt about which version config file
  65.      you use, dubble-click on "MARSMAIL.CFG" and look at the first number.
  66.      If this number is higher then 2, the config is an from the beta-version.
  67.      If the number is lower, you can read the config into the installer and
  68.      adjust it.
  69.  
  70.      True followers of Blackmail will notice the difference as soon as they
  71.      start the installer... Yes guys, I've finally programmed the installer
  72.      like it should look like... ALL GEM!
  73.      An explaination about how it works follows later on.
  74.  
  75.      The previous versions of MARSmail Exporter always included the ^aINTL
  76.      lines in Netmails. It's safer, but it is NOT standard. This option is
  77.      now (default) off. To turn it on, include "-I" in your parameter field.
  78.  
  79.      The old Blackmail only supported FTS-0001 packets (stoneage). Now,
  80.      blackmail also supports the new FSC-0039 and FSC-0048 packettypes.
  81.      These types are widely in use today and are completely 4D, so there is
  82.      no need for fakenet anymore.
  83.  
  84.      Blackmail will also RECOGNIZE (NOT PROCESS) type 3 and 4 packet- and
  85.      message headers. As soon as there are good proposals available, they
  86.      MIGHT be included in the next version.
  87.  
  88.      Also the logfile and temporary folder(s) are no longer fixed. You can
  89.      specify there place (and the logfile's name too) yourself.
  90.  
  91.      The packing (removing deleted messages) can be skipped on user-defined
  92.      days per area. Again, read on...
  93.  
  94.      The STATUS.LOG (an overview of incomming messages) now adds percentage
  95.      per area (number of messages against the total number of messages).
  96.      Blackmail                                                         Page: 3
  97.  
  98.      The serious stuff:
  99.      ------------------
  100.      OK, it's time to install Blackmail. Please place the files in the right
  101.      folder (where you want to keep them) and start the installer.
  102.  
  103.      You will a dialog box with seven buttons:
  104.  
  105.           - Enter AKA,
  106.           - Settings,
  107.           - Moves/Arcs,
  108.           - Copyrights,
  109.           - Save Setup,
  110.           - MARS Interface,
  111.           - Exit.
  112.  
  113.      With these options you will install Blackmail. How? That's simple! Just
  114.      read on...
  115.  
  116.      Enter AKA:
  117.      ----------
  118.      Select this and a dialog box wil pop up looking like this:
  119.  
  120.      +-------------------------------------------+
  121.      | Page: 01                                  |
  122.      | Boss: ___:_____/_____                     |
  123.      | AKA.: ___:_____/_____._____               |
  124.      | Fake: _____                               |
  125.      | Password: ________                        |
  126.      | Domain..: _______________________________ |
  127.      |                                           |
  128.      | +-------------------+    +---+------+---+ |
  129.      | | Packet type: 3D__ |    | < | PAGE | > | |
  130.      | +-------------------+    +---+------+---+ |
  131.      |                                           |
  132.      | +===================+    +--------------+ |
  133.      | |        OK         |    |    CANCEL    | |
  134.      | +===================+    +--------------+ |
  135.      +-------------------------------------------+
  136.  
  137.      Now, behind the Boss you type in the Boss' address. First type in the
  138.      zone, press ":", then type in the netnumber, press "/" and type in the
  139.      nodenumber.
  140.      Move to the next row with cursor down, type in YOUR zone, press ":",
  141.      netnumber, press "/", nodenumber, press "." and pointnumber (if needed).
  142.      Move to the next row (again with cursor down) and enter the fakenet
  143.      (if used/desired).
  144.      Again, to the next row and type in your password. The password will
  145.      be converted to uppercase automaticly later on.
  146.      Again, to the next row and type in the domain for the network. You can
  147.      ask the domain names from your boss.
  148.      Now, you see that little window containing "Packet type: 3D"?
  149.      This means that the mail for that address will be send with stoneage
  150.      packettypes (FTS-0001/15). It's OK, but for point addresses, you need
  151.      fakenet then. However, if your boss supports 4D packet-types, you can
  152.      troggle the field and select 4D packets as well. Click on it and you
  153.      will see "4D-1". This means "4D packets according to the FSC-0039
  154.      fidonet document". This one is used by most mailtossers. Click on it
  155.      again and you will see "4D-2". This means "4D according to the FSC-0048
  156.      fidonet document". This type is supported by DBridge for example (but
  157.      Blackmail                                                         Page: 4
  158.  
  159.      DBridge also accepts "4D-1"). It's not so widely spread as the FSC-
  160.      0039. If you don't know which packet to choose, take "3D". ALL systems
  161.      recognize that one.
  162.      After filling out the page, you can chose "OK" to accept the AKA,
  163.      "CANCEL" to abort or select the left arrow/right arrow to enter the
  164.      next AKA (if you have more than one).
  165.      So, to enter a next AKA, click on the arrow right and in the lefthand
  166.      corner you will see "Page: 01" changing to "Page: 02" and fill out the
  167.      form like you just did.
  168.      There is a maximum of 10 AKA's for you to enter.
  169.      After you have entered ALL your AKA's, click on "OK" to accept ALL your
  170.      AKA's or "CANCEL" to abort ALL your AKA's.
  171.  
  172.      Settings:
  173.      ---------
  174.      Select this and a dialog box wil pop up looking like this:
  175.  
  176.      +-----------------------------------------------+
  177.      | SysOp...: ___________________________________ |
  178.      | Outbound: ___________________________________ |
  179.      | Inbound.: ___________________________________ |
  180.      | Netmail.: ___________________________________ |
  181.      | AREA.BBS: ___________________________________ |
  182.      | Bad area: ___________________________________ |
  183.      | Temp.Dir: ___________________________________ |
  184.      | Log file: ___________________________________ |
  185.      | Archiver: Extract: ________.___ __ ___ KBytes |
  186.      |           Packing: ________.___ __ ___ KBytes |
  187.      |                                               |
  188.      | +===========================================+ |
  189.      | |                      OK                   | |
  190.      | +===========================================+ |
  191.      +-----------------------------------------------+
  192.  
  193.      The cursor will be on the SysOp line. Enter your name EXACTLY as in
  194.      your BINKLEY.CFG, TB.CFG etc. Now, CLICK in the outbound line. An
  195.      itemselector will pop up. Move to your outbound folder, DO NOT select
  196.      ANY file in that folder and click on the "OK" button of the itemselector.
  197.      If you've done everything right, the path will be entered on the line.
  198.      Repeat the same for the Inbound folder.
  199.  
  200.      CLICK on the netmail line. An itemselector will pop up. Move to your
  201.      mail folder and select your netmail area (or type it in). Normally, these
  202.      areanames consist of a four-digit number ("0000"-"9999") and click on
  203.      the itemselector's "OK". You can find the name in the BINKLEY.CFG etc.
  204.  
  205.      CLICK on the "AREA.BBS" line and select your "AREAS.BBS" file. Again,
  206.      click on the itemselector's "OK".
  207.  
  208.      CLICK on the Bad area line and locate your BADAREA (also called TRASHAREA
  209.      or something simular) just like the netmail line. Again, the areaname
  210.      usually consist of 4-digit number. You should find the areaname in your
  211.      AREAS.BBS. If not, you should add the Trasharea to your AREAS.BBS file.
  212.      (<drive>:<path>:<areaname in 4-digit format>    <areaname> <def. address>
  213.       Example:
  214.       E:\BINKLEY\MAIL\9998          TRASHAREA     2:281/522)
  215.  
  216.      See The AREAS.BBS for detailed explaination about the Trasharea.
  217.      Blackmail                                                         Page: 5
  218.  
  219.      CLICK on the Temp.Dir line and select the ROOT-folder where Blackmail
  220.      may place his temporary folders (MARSTEMP folder, containing the
  221.      ROUTE and CRASH folder. For example: If you would select a folder called
  222.      "TEMPS" on drive E, the line will read "E:\TEMPS" and the folders created
  223.      by Blackmail will be:
  224.        E:\TEMPS\MARSTEMP\
  225.        E:\TEMPS\MARSTEMP\CRASH
  226.        E:\TEMPS\MARSTEMP\ROUTE
  227.  
  228.      KEEP THESE FOLDERS EMPTY!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  229.  
  230.      If you would leave the line empty, Blackmail will create his temporary
  231.      folders in the same folder as where MARSmail Exporter is located.
  232.  
  233.      CLICK on the logfile line and select the logfile Blackmail may use.
  234.      This could be a own logfile, or the logfile used by your mailer.
  235.      If you would keep this line empty the logfile will be named "MARSMAIL.LOG"
  236.      which can be found in the same folder as where Blackmail is.
  237.  
  238.      CLICK on the Extract line and locate the archiver to be used by MARSmail
  239.      Importer (the archiver you need to extract your mail with). Although
  240.      only the name of the archiver will be displayed, the full path will be
  241.      stated in your configuration.
  242.  
  243.      CLICK on the Packing line and locate the archiver to be used by MARSmail
  244.      Exporter (the archiver you want to use to pack your mail). Again, only
  245.      the name will be displayed but the full path will be included in your
  246.      configuration.
  247.  
  248.      Move your cursor to the "__" directly behind the name of the Extract
  249.      archiver and type in the extract command of the archiver (refer to it's
  250.      manual). I suggest you move to the field by clicking on it, but you can
  251.      use the cursor up/down as well.
  252.  
  253.      Do the same with the Packing archiver, entering the _add_ command.
  254.  
  255.      NOTE: Please make sure you use the correct command. Blackmail will look
  256.            at the return code of the packer and when it's 0, it assumes that
  257.            everything went well and delete the packet.
  258.  
  259.      Now, behind the Extract archive you will see an amount of KBytes.
  260.      This is the memory the Importer may use. Note that it is NOT for the
  261.      archiver itself... I suggest a minimum of 250 KBytes here (1 Megabyte
  262.      computers). It you can afford more USE IT!
  263.      Fill in this field like you've just filled in the extract- and add-
  264.      commands for your archiver.
  265.  
  266.      Behind the Packing archive you will also see an amount of KBytes.
  267.      This is the memory the Exporter may use. Again, it is NOT for the
  268.      archiver itself... As the Exporter reads the entire HDR file of your
  269.      areas, I suggest a minimum of 250 KBytes here (1 Mesgabyte computers).
  270.      Again, use more if you can use it.
  271.  
  272.      The memory you will have to enter is strongly influenced by the archiver
  273.      you use. Archivers like STZIP and Yoshi's LZH require a lot of memory.
  274.      The MORE memory the archivers use, the LESS memory you can reserve for
  275.      the Importer/Exporter. Archivers like Jonn Webb's LHARC 0.60B take up
  276.      far less of your important memory so that you can reserve a higher
  277.      amount.
  278.  
  279.      After entering all the necessary fields, click on "OK".
  280.      Blackmail                                                         Page: 6
  281.  
  282.      Moves/Arcs:
  283.      -----------
  284.      Select this and a dialog box wil pop up looking like this:
  285.  
  286.      +------------------------------------------------+
  287.      | Move-To:                       Arc-For:        |
  288.      | Zone ___ to: ___:_____/_____   ___:_____/_____ |
  289.      | Zone ___ to: ___:_____/_____   ___:_____/_____ |
  290.      | Zone ___ to: ___:_____/_____   ___:_____/_____ |
  291.      | Zone ___ to: ___:_____/_____   ___:_____/_____ |
  292.      | Zone ___ to: ___:_____/_____   ___:_____/_____ |
  293.      | Zone ___ to: ___:_____/_____   ___:_____/_____ |
  294.      | Zone ___ to: ___:_____/_____   ___:_____/_____ |
  295.      | Zone ___ to: ___:_____/_____   ___:_____/_____ |
  296.      | Zone ___ to: ___:_____/_____   ___:_____/_____ |
  297.      | Zone ___ to: ___:_____/_____   ___:_____/_____ |
  298.      |                                                |
  299.      | +--------------------------------------------+ |
  300.      | |                      OK                    | |
  301.      | +--------------------------------------------+ |
  302.      +------------------------------------------------+
  303.  
  304.      Now, Blackmail can put packets for other networks together in one
  305.      archive (different packets, of coarse) or redirect mail to an address
  306.      if the zonenumber is unknown.
  307.      It's very simple, but I will give you some examples...
  308.      Let's suppose that you have an fidonet address 2:281/522.3 (your boss
  309.      would be 2:281/522.0) and a THANet address 70:3170/9 (your boss would
  310.      be 70:3170/0). If you would export your mail, packets for both addresses
  311.      are created. These packets will be archived seperately and placed in
  312.      two different outbound folders (that's why you can't put an extension
  313.      behind your outbound folder). So, <outbound> will contain your packet
  314.      for fidonet and <outbound>.046 will contain your mail for THANet. Now,
  315.      you WILL need an mailer that can handle EMSI or you will have to call
  316.      two times OR your THANet mail will never leave your modem. If you would
  317.      enter a Move-To looking like "Zone 70 to: 2:281/522", your packet will
  318.      be added to the archive containing your fidonet packet. And see... No
  319.      more problems. This way, your mailer doesn't even have to be multi-
  320.      address-capable, as long as you are collecting all the networks on
  321.      one system (sysopm, boss, take a selection! :-)   )
  322.      The second function is this: Let's use the above address for fidonet.
  323.      Fidonet is divided into 6 zones. For example, zone 1 is the U.S.A.
  324.      If you would like to send a message to the states, Blackmail will look
  325.      for zone 1 in your AKA list (the reason why it does that is because
  326.      Blackmail is multi-zone/point). It will not find it, so it will look
  327.      thru your Move-To list. If there would be a line containing "Zone 1 to:
  328.      2:281/522" it will redirect that message to your boss on 2:281/522.
  329.      If the line would be "Zone 1 to: 70:3170/0" it will send the message
  330.      to the one you are getting THANet mail from. He will not like that,
  331.      nor will the one that will recieve the message...
  332.      Why put it in then? Well, Blackmail takes your FIRST AKA of the zone
  333.      is not in the Move-To list or when the Move-To option is switched off.
  334.      And NOBODY knows if your first AKA is fidonet or an other network...
  335.      This way, you will be sure that everything goes like it should.
  336.  
  337.      To fill a Move-To line, type in the zone to be moved, press "T", type
  338.      in the zone of the boss, press ":", type in the netnumber of the boss,
  339.      press "/" and type in the nodenumber of the boss. Needless to say that
  340.      the address MUST be in your AKA list. Make sure of that because there
  341.      is NO checking at this stage.
  342.      Blackmail                                                         Page: 7
  343.  
  344.      In the ARC-For list you can enter the addresses the Exporter MUST pack
  345.      for, regardless of what's in the Move-To list.
  346.      For example: If I would have a Move-To for zone 70, but I want that
  347.      messages for address 70:3170/100 are NOT moved to the boss behind the
  348.      Move-To because he's my second THANet boss, enter 70:3170/100 in the
  349.      ARC-For list and a seperate archive will be created for that address
  350.      containing your messages for that system.
  351.  
  352.      Crashmail is NEVER moved!
  353.      After entering all fields needed, click on "OK".
  354.  
  355.      Copyrights:
  356.      -----------
  357.      The copyright message of the Blackmail programs and docs. Read it and
  358.      stick to it.
  359.  
  360.      Save Setup:
  361.      -----------
  362.      If you are all done, select this to save your configuration and you are
  363.      almost ready to go (read the command line switches chapter!!!).
  364.  
  365.      MARS Interface:
  366.      ---------------
  367.      Select this and a dialog box wil pop up looking like this:
  368.  
  369.      +------------------------------------------+
  370.      |          For MARS-Shell v1.5 users.      |
  371.      |                                          |
  372.      | |X| ^aINTL always    | | Wait            |
  373.      |                                          |
  374.      | | | Move To          | | Arc-For         |
  375.      |                                          |
  376.      | | | Random origins   | | Domained random |
  377.      |                                          |
  378.      | | | Pack, NO export  | | No Packing      |
  379.      |                                          |
  380.      | |X| Write LED.NEW    |X| Status Log      |
  381.      |                                          |
  382.      | Loglevel: | | 1   |*| 2  | | 3           |
  383.      |                                          |
  384.      | +-----------+  +=======================+ |
  385.      | |   Export  |  |          Exit         | |
  386.      | +-----------+  +=======================+ |
  387.      +------------------------------------------+
  388.  
  389.      For detailed explaination about the switches, read the command line
  390.      switches chapter.
  391.  
  392.      As you can see, this option is for MARS-Shell v1.5 users only.
  393.      The new version, which is NOT available yet (I haven't even started
  394.      working on it), will be able to import the commands needed to start
  395.      the Importer and Exporter with the parameters you need. By selecting
  396.      the needed options (the X is on) and setting the loglevel, and clicking
  397.      on "Export", the installer will create 2 files, EXPORT.SCR and IMPORT.SCR,
  398.      containing the necessary data to import into the scripts editor of
  399.      MARS-Shell. This way you can install everything with the GREATEST ease.
  400.      Again, no use for it currently and only for MARS-Shell users. I plan to
  401.      use this "Interface" in future programs as well so I suggest you to get
  402.      hold on MARS-Shell (ALWAYS THE NEWEST requestable at Haasnet, 2:281/522,
  403.      THE support BBS for MARS Productions) and register for it (15 dutch
  404.      guilders, approx. £4.00, US$6,00)
  405.      Blackmail                                                         Page: 8
  406.  
  407.      Exit:
  408.      -----
  409.      All done? Well, just exit then and let's go! :-)
  410.  
  411.      The command line switches:
  412.      --------------------------
  413.      There are certain switches that can be used to affect the way Blackmail
  414.      handles mail and to make your live easier/more fun.
  415.  
  416.      The Exporter:
  417.  
  418.           -1   Loglevel 1 (least).
  419.           -2   Loglevel 2 (average).
  420.           -3   Loglevel 3 (most, default).
  421.           -I   Always include INTL lines in netmail messages. If you have
  422.                no reports of bad mail (VERY unlikely), USE IT!
  423.           -W   Wait for a key press at the end of the Export.
  424.           -M   Activate Move-To list. If you don't include this switch, data
  425.                in the Move-To list will be ignored.
  426.           -A   Activate Arc-For list. If you don't include this switch, data
  427.                in the Arc-For list will be ignored.
  428.           -R   Use random origins  (See: The MARSMAIL.RAN).
  429.           -D   Use domained random (See: The MARSMAIL.RAN).
  430.           -P   Pack (remove deleted messages) only, NO Export.
  431.           -N   Do NOT pack (remove deleted messages).
  432.           -H   Help text (looking like this).
  433.  
  434.      The Importer:
  435.  
  436.           -1   Loglevel 1 (least)
  437.           -2   Loglevel 2 (average)
  438.           -3   Loglevel 3 (most, default)
  439.           -W   Wait for key press at the end of the Import.
  440.           -L   Write LED.NEW (You use LED? Use this switch so you can
  441.                recognize which areas contain new messages).
  442.           -S   Status Log (an overview of incomming messages).
  443.  
  444.  
  445.      The MARSMAIL.RAN:
  446.      -----------------
  447.      MARSmail Exporter can add random origins to each message. This is fun,
  448.      faith helping you or put silly things underneath silly messages.
  449.      There are two kinds of random origins files, both are called MARSMAIL.RAN!
  450.      So, you can only use ONE of the two types.
  451.  
  452.      The global type:
  453.  
  454.           With this type, ALL the lines in the MARSMAIL.RAN file (create one
  455.           with a simple editor, WP mode OFF!) is a domain and will be placed
  456.           underneath the messages of ALL areas, so you can't select a group
  457.           of orgins to be used for area <x>, an other group to be used for
  458.           area <y> etc.
  459.           The commandline must contain "-R", the "-D" must be left out.
  460.      Blackmail                                                         Page: 9
  461.  
  462.      The domained type:
  463.           With this type you CAN select a group of origins to be used on
  464.           a specific area. Areas not found in the MARSMAIL.RAN will have the
  465.           origin specified in the AREAS.BBS file.
  466.           Again, create the MARSMAIL.RAN file with a simple editor (WP mode
  467.           off). But it gets tricky now... You must specify the areas...
  468.           Well, it's simple actually. Look:
  469.  
  470.           %ATARI.028
  471.           This is an ATARI.028
  472.           This is an other ATARI.028 origin
  473.           %MUSIC
  474.           This is an MUSIC origin
  475.           This is also an other MUSIC origin
  476.           etc.
  477.  
  478.           You see, FIRST you enter the areaname with a "%" in front of it,
  479.           followed by the origins to be used in that area.
  480.           You can do this for one, some or ALL areas you have (exept the
  481.           Trasharea of coarse). You can enter almost a much origins you'd
  482.           like. Keep in mind: the larger, the slower.
  483.  
  484.  
  485.      The AREAS.BBS:
  486.      --------------
  487.      The AREAS.BBS is a file containing your areanames, paths and origins.
  488.      The structure is simple. Follow these guidelines and everything will
  489.      be Okay.
  490.  
  491.      The first line is your default origin. You can specify your origin per
  492.      area, but you don't have to. Besides, some programs EXPECT to find
  493.      your global origin here. The format is simple:
  494.  
  495.           This is a default origin.
  496.  
  497.      NOTHING in front of it, nor behind it. It MUST be on the FIRST line.
  498.  
  499.      Following the global origin are your areas. With the exeption of the
  500.      netmail area, ALL your areas MUST be entered here. The format is:
  501.  
  502.           <drive>:<path>\<area>      <areaname>   <address>
  503.  
  504.      for example:
  505.  
  506.           E:\BINKLEY\MAIL\0001     ATARI.028      2:281/522
  507.  
  508.      NOTE: this is what every line must look like, the drive, path, name,
  509.            and above all, the address.
  510.  
  511.  
  512.      There is one special area... the Trasharea. All messages for which you
  513.      have NO arealine are placed here. The format of the line is the same,
  514.      so you MUST enter one of your Boss' addresses here. No worries as the
  515.      Importer will make sure that the addresses are correct (as far possible).
  516.      There is NO export from the Trasharea, so there is NO use of entering or
  517.      replying message there... they will NEVER be exported.
  518.      Blackmail                                                        Page: 10
  519.  
  520.      As told, there are some other lines that can be used in the AREAS.BBS.
  521.      One of them is the origin line. You can specify an origin per area.
  522.      The origin must be placed before the area you want to use it in and
  523.      AFTER the previous area. Example:
  524.  
  525.           E:\BINKLEY\MAIL\0002     MUSIC     2:281/522
  526.           -ORIGIN This is an ATARI.028 origin
  527.           E:\BINKLEY\MAIL\0001     ATARI.028 2:281/522
  528.           E:\BINKLEY\MAIL\0003     MSDOS.028 2:281/522
  529.  
  530.      The origin "This is an ATARI.028 origin" will ONLY be used in the
  531.      ATARI.028! The area MSDOS.028 will (according to this) have no specified
  532.      origin. The word "-ORIGIN" may be shortened to "-O".
  533.  
  534.  
  535.      And introducing a new AREAS.BBS command... PACK! The format of this
  536.      line is:
  537.  
  538.           -PACK <patterned value>
  539.  
  540.      The patterned value is a number range 0 to 127. With this command you
  541.      can specify the day that MARSmail Exporter may pack (remove deleted
  542.      messages) the areas. The value is build according to this system:
  543.      Every value is build up from bits. The first 7 bits (start counting
  544.      from the right) represent each day of the week. You don't have to be
  545.      a wizz-kid. Look at the table, add up the values and put this behind
  546.      the -PACK:
  547.  
  548.           Monday          1
  549.           Tuesday         2
  550.           Wednesday       4
  551.           Thursday        8
  552.           Friday         16
  553.           Saturday       32
  554.           Sunday         64
  555.  
  556.      If you want the area(s) to be packed on Monday, Thursday, Saturday and
  557.      Sunday, calculate the sum of: 1 (Mo) + 8 (Th) + 32 (Sa) + 64 (Su).
  558.      This is 105. Add the line "-PACK 105" and all areas following this
  559.      line will only be packed on Monday, Thursday, Saterday and Sunday.
  560.  
  561.      Note: ALL AREAS FOLLOWING THE LINE "-PACK" ARE AFFECTED!
  562.  
  563.      You may use as much -PACK lines as you want.
  564.      Until the first -PACK line is found, the default will be all days (so
  565.      that would be value 127).
  566.  
  567.      The switch "-P" overrides the -PACK lines.
  568.      Blackmail Appendix                                                Page: 1
  569.  
  570.      These (error) messages are produced by MARSmail:
  571.      ================================================
  572.  
  573.      The exporter:
  574.      -------------
  575.      - "MARSMAIL.CFG file not found!"
  576.        The exporter was unable to find it's configuration file. To create one,
  577.        run the installer supplied with the package.
  578.      - "Internal error! Unable te request DTA-Buffer!"
  579.        This is somewhat technical. All you need to know is that when this pops
  580.        up, things are WRONG! Reset the computer and try again.
  581.      - "Internal error! Unable te create MARSTEMP folder!"
  582.        The Exporter uses a folder called "MARSTEMP". However, when this message
  583.        pops up, the program was unable to create one. Export is halted...
  584.      - "No Move-To's in config. Option switched off."
  585.        You've used the Move-To switch, but there were NO Move-To's defined.
  586.        Exporting will continue however. Next time, switch the option off
  587.        or install MARSmail correctly.
  588.      - "No Arc-For's found! Option switched off."
  589.        You've used the ARC-For switch, but there were NO ARC-For's defined.
  590.        Exporting will continue however. Next time, switch the option off
  591.        or install MARSmail correctly.
  592.      - "No AKA's found in config! Please alter setup!"
  593.        The intention is that you have AT LEAST one AKA in your configuration.
  594.        Please state ALL your addresses in the configuration program.
  595.      - "AREAS.BBS file not found! Exitting..."
  596.        The Exporter could not find the AREAS.BBS file. This file is needed
  597.        for exporting your messages. Please create one.
  598.      - "Scanning random file for origins..."
  599.        The "MARSMAIL.RAN" file is scanned for the random origins.
  600.      - "MARSMAIL.RAN textfile empty."
  601.        The "MARSMAIL.RAN" textfile does NOT contain origins.... Please
  602.        put some in the file so that you can enjoy this feature. The option
  603.        has been turned off automaticly during the export session.
  604.      - "Scanning random file for origins with domains..."
  605.        The "MARSMAIL.RAN" file is scanned for the random origins.
  606.      - "MARSMAIL.RAN file incorrect. No domains defined!"
  607.        There are two types of ramdom origin files. One with origins ONLY or
  608.        with random origins divided per area. You choose to have origins per
  609.        area, but you've forgotten to state the domains.... Please do so or
  610.        don't use the "-D" switch.
  611.      - "MARSMAIL.RAN textfile not found."
  612.        You used the random origins switch but there is NO MARSMAIL.RAN file.
  613.        Please create one with a simple texteditor (WP mode OFF!!!!)
  614.      - "<areaname>: Incorrect header! Skipping compression!"
  615.        The messageheader "*.HDR" is incorrect. The compression will be skipped
  616.        for that area. This is a "save what you can save" errormessage. It's
  617.        quite serious. Fortunately there are some programs that allows you to
  618.        rescue your messages.
  619.      - "<areaname>: Nothing to delete"
  620.        Quite simple. Not ONE message was deleted so nothing has to be done.
  621.      - "<areaname>: <number1> messages found, <number2> remaining."
  622.        Just an overview.
  623.      - "<areaname>: Incorrect messagelength. Message #<n> not saved!
  624.        According to the header the message was LONGER then the message base.
  625.        This can't be right so the message will be skipped. Note that the
  626.        message is gone forever!
  627.      - "Compression aborted by user."
  628.        Why would you do that? :-)
  629.      Blackmail Appendix                                                Page: 2
  630.  
  631.      - "<areaname>: Incorrect messagelength. Message #<n> shrunk to 32767
  632.         Bytes."
  633.        The maximum length of a message during compression may not be more
  634.        then 32 KBytes. This message was longer and has been truncated.
  635.      - "Error during compression. Area <areaname> left in it's old state."
  636.        Well, something went wrong here... So I won't touch it and bring
  637.        back the situation as it was.
  638.      - "<areaname>: Area not found."
  639.        The area in the AREAS.BBS list was not found on the disc.
  640.      - "<areaname>: Area empty."
  641.        Nice and easy....
  642.      - "<areaname>: Incorrect header! Skipping area!"
  643.        The same as the errormessage during compression... (see above!)
  644.      - "Export aborted by user"
  645.        Now this is not the intention.... :-)
  646.      - "<areaname>: Incorrect messagelength. Skipping message #<n>"
  647.        This message is longer then the message base.... How did you do that?
  648.      - "<areaname>: Message too long! Message #<n> not send!"
  649.        The maximum length of a message during the export is 32000 Bytes.
  650.        This message is longer. It has NOT been truncated and NOT send so you
  651.        can alter it...
  652.      - "<areaname>: Unexpected end of message! Message #<n> truncated!"
  653.        There was a CHR$(0) in your message. This value (0x0) marks an "end of
  654.        message". The rest of the message will NOT be send!
  655.      - "Message for <zone>:<net>/<node> routed to: <dzone>:<dnet%>/<dnode>"
  656.        This is for your information. It means that a message will be routed via
  657.        the stated address. But it does NOT mean that the message will have the
  658.        network altered. You can move an mailpacket to an other address, even
  659.        when you HAVE an AKA for that address. In that case the only thing is
  660.        that the packet will be included in the mailbag for that address.
  661.        (See somewhere in the manual!!)
  662.      - "Incorrect Move-To line. Address: <zone>:<net>/<node> not in AKA list!
  663.         Message routed via primary address."
  664.        This means that you had entered a Move-To, but the destination address
  665.        (the address you want to move your packet to) was not found in your AKA
  666.        list.
  667.      - "No AKA and MOVE found for address <zone>:<net>/<node>
  668.         Message routed via primary address."
  669.        You wrote a message to an unknown zone-number. The zone was not found
  670.        in your AKA, nor in your Move-To list. It will be send via your primary
  671.        (first) address.
  672.      - "No AKA found for address <zone>:<net>/<node> 
  673.         Message routed via primary address."
  674.        You wrote a messahe to an unknown zone-number. The zone was not found
  675.        in your AKA list. It will be send via your primary address.
  676.      - "Netmail -> CRASHING message to: <name> (<zone>:<net>/<node>.<point>"
  677.        For your information. This message had his CRASH bit on, so the message
  678.        will be send DIRECTLY to the destination by your mailer.
  679.      - "Netmail -> Exporting message to: <name> (<zone>:<net>/<node>.<point>"
  680.        Just for your information. As you well know, Netmail is private mail,
  681.        so only the destination address can read it.
  682.      - "<areaname> -> Exporting message to: <name>"
  683.        Just for your information. This (echo) mail is exported from the area.
  684.      - "<areaname>: <number 1> messages found, <number 2> exported."
  685.        Just for your information. It tells how many messages were found and
  686.        exported from one area.
  687.      - "No filename in subject field for attach!"
  688.        A Netmail had a file attached, but the file was not found.
  689.      - "Attaching file: <filename>"
  690.        Just for your information. It confirms that the file is attached to
  691.        a netmail message.
  692.      Blackmail Appendix                                                Page: 3
  693.  
  694.      - "Filename already in the FLO-file."
  695.        Indicates that a filename, either generated by the exporter or a file-
  696.        name from fileattaches was already found in the FLO file.
  697.        BEWARE: If the file was a PKT file (mailpacket), the file will be
  698.                deleted. Every precaution has been taken to prevent this,
  699.                but there is NO garanty it will NEVER happen... But normally
  700.                it will not happen... (Some strange things must be done
  701.                before this could happen...)
  702.  
  703.  
  704.      The importer:
  705.      -------------
  706.      - "MARSMAIL.CFG not found!"
  707.        The importer was unable to find it's configuration file. To create one,
  708.        run the installer supplied with the package.
  709.      - "Internal error! Unable te request DTA-Buffer!"
  710.        This is somewhat technical. All you need to know is that when this pops
  711.        up, things are WRONG! Reset the computer and try again.
  712.      - "Import from unknown system."
  713.        This message will appear when you have recieved a ECHOMAIL from a system
  714.        not listed in your AKA. The messages will, however, still be imported.
  715.      - "<areaname>: <from name> -> <to name>"
  716.        For your information. Just to show you from whom the message came and
  717.        to whom it is addressed.
  718.      - "Writing new LED.NEW file."
  719.        MARSmail Importer can created a new LED.NEW file for you. This little
  720.        file holds the last-read message number per area and some flags.
  721.        The importer will put you into the FIRST new message and will set those
  722.        flags so you can easely recognize in which area new messages have been
  723.        added.
  724.      - "Writing Status Log."
  725.        MARSmail Importer can write a status log, containing the number of
  726.        messages per area in total, the number of messages (total) addressed
  727.        to you and the percent of the total number of messages.
  728.        This tabel will be updated every import session, so you can see which
  729.        area is the biggest.
  730.      - "AREAS.BBS file not found!"
  731.        The importer could not find the AREAS.BBS file. This file is needed
  732.        for importing your messages. Please create one.
  733.      - "No AKA's found in config!"
  734.        The intention is that you have AT LEAST one AKA in your configuration.
  735.        Please state ALL your addresses in the configuration program.
  736.      - "No areas found in AREAS.BBS!"
  737.        The importer could not find a single areaname in the AREAS.BBS file.
  738.        It should contain AT LEAST a line for the Trasharea. Please alter
  739.        your AREAS.BBS file and run the importer again.
  740.      - "Extracting mailbag: <filename>"
  741.        For your information. After this line the extracting archiver will
  742.        be called to unpack your mailbag.
  743.      - "Error during extraction! Renaming packet to <filename>"
  744.        During the extraction, an error has occured. For safety reasons, the
  745.        packet will be renamed. To identify the error, refer to the manual
  746.        of the used packer.
  747.      - "Packet found: <zone>:<net>/<node>.<point> -> <zone>:<net>/<node>
  748.         .<point>"
  749.        "Created on: <day> <month> <year> at: <hour>:<min>:<sec>"
  750.        For your information. Please note that the point values are NOT always
  751.        correct.
  752.      - "Import aborted by user."
  753.        He, the ^C also works... :-)
  754.      Blackmail Appendix                                                Page: 4
  755.  
  756.      - "Unexpected end of packet! Message saved but may be incomplete!"
  757.        If an message is longer than 32000 Bytes and there was NO packet- and
  758.        message-terminator found, this line will pop-up. Nothing serious (most
  759.        of the times), but bad enough to let you know.
  760.      - "Message larger then 32000 bytes found! Message truncated!"
  761.        If an message is longer than 32000 Bytes it will be cut at that length.
  762.        The rest of the message will disappear.
  763.      - "Unexpected end of packet. Last message non-existing."
  764.        An messageheader was found and was suddenly cut off. The "message" was
  765.        not appended, probably at the boss, and therefor not tossed.
  766.      - "Type <n> message-header encountered (NOT supported!). Message skipped.
  767.         PKT will be renamed to: <packetname>.UNK"
  768.        Blackmail only supports type 2 packet- and messageheaders. The found
  769.        messageheader was a type <n>, so it can't be handled.
  770.      - "Expected message not found. PKT will be renamed to: <packetname>.UNK
  771.         Scanning for next message..."
  772.        To be on the safe side... There were some extra bytes in the packet and
  773.        it's best to have a look at it. The search begins to find the next
  774.        message.
  775.      - "No more messages found."
  776.        After the previous error, if the Importer can't find any more messages
  777.        it will inform you.
  778.      - "Unexpected end of packet."
  779.        And suddenly (again?) the packet stopped. Don't HAVE to be serious.
  780.      - "Empty packet encountered. Removed from inbound."
  781.        You can't import something that is not there...
  782.      - "Unknown packet header! Renaming packet to <packet name>.UNK"
  783.        As told before, Blackmail can only handle type 2 message- and packet-
  784.        headers.
  785.