






















                  AnDan Software Message Generator Version 1.40

                  Users Manual

                  Scandinavian Digital Systems
          AnDan Software Message Generator Version 1.40        Users Manual
          


          Table of contents

           1  Overview ...............................................    3
           2  Freeware ...............................................    3
              2.1  Contributions .....................................    3
           3  Support and new versions ...............................    3
           4  Included files .........................................    3
           5  Installation ...........................................    4
           6  Command line arguments .................................    4
           7  Execution examples .....................................    5
           8  Version history ........................................    7


          Copyright (c) 1991-2000 Scandinavian Digital Systems AB

          This product, including the manual and the software, is provided
          as is. Scandinavian Digital Systems AB and Anders Danielsson
          disclaims all warranties of any kind, whether expressed or
          implied, and are not liable to you or anyone else for any damages
          or costs due to the use or inability to use this product.

          Acknowledgments:

          AnDan Software is a trademark of Scandinavian Digital Systems AB.
          FidoNet is a trademark of Tom Jennings.































          
          Scandinavian Digital Systems                               Page 2
          AnDan Software Message Generator Version 1.40        Users Manual
          


          1  Overview

          AnDan Software Message Generator (ADMsg) is a program that
          generates FidoNet netmail messages (*.MSG files).

          It can generate messages in many different ways, including
          combining lists of destination addresses and list of subject
          lines (subject lines are used for file attach and request).

          ADMsg comes in both a 16-bit DOS version and in a 32-bit OS/2
          version.

          ADMsg was previously called Msggen.


          2  Freeware

          The files in this package may be copied and distributed if no fee
          is charged and if no changes are done.


          2.1  Contributions

          Free contributions may be sent to:

              Scandinavian Digital Systems AB
              Hjortronstigen 22
              S-664 32  Grums
              SWEDEN

          In such case, please send cash (bills, paper money) in a letter.

          Do not send checks, cheques or money orders. Only use paper
          money, not coins.


          3  Support and new versions

          If you have questions, comments or find bugs in the program,
          please send electronic mail to the author, Anders Danielsson on
          andan@digsys.se.

          The latest version can be downloaded from http://www.digsys.se.

          At http://www.digsys.se you find news, programs and support from
          AnDan Software.


          4  Included files

          You should have received the following files:





          
          Scandinavian Digital Systems                               Page 3
          AnDan Software Message Generator Version 1.40        Users Manual
          


          File name:    Description:

          ADMSG.TXT     This file
          ADMSG.EXE     The DOS version of ADMsg
          ADMSG.OS2     The OS/2 version of ADMsg
          FILE_ID.DIZ   File description


          5  Installation

          If you want to use the DOS version, just copy ADMSG.EXE to a
          directory included in your PATH.

          If you want to use the OS/2 version, copy ADMSG.OS2 to a
          directory included in your PATH, and rename it to ADMSG.EXE.

          If you want to use both the DOS and the OS/2 version, do as
          above, and keep the PATHs different in DOS and OS/2 sessions.

          For example, in OS/2's CONFIG.SYS you may have:

          SET PATH=C:\OS2BIN;C:\OS2;C:\OS2\MDOS;...

          And in AUTOEXEC.BAT you may have:

          PATH=C:\DOSBIN;C:\OS2;C:\OS2\MDOS;...

          The DOS version of ADMsg is stored in C:\DOSBIN and the OS/2
          version in C:\OS2BIN.


          6  Command line arguments

          ADMsg has a rather complex command line syntax. It is mainly
          executed from DOS .BAT files or from OS/2 .CMD files, to automate
          message generations for different purposes.

          To make ADMsg easier to use manually from the prompt, it will
          ask you for all arguments needed, if any arguments are missing,
          or if you run ADMsg without any arguments at all.

          If you run ADMsg with the option /? it will display the
          following help text (use "admsg /? | more" for more prompt):

          admsg netpath origin from dest to flags [subj] [message] [/c]
            [/N]

          netpath   Path to the netmail directory with *.MSG files.

          origin    Origin address, zone:net/node.point, and default
                    destination zone, net and node. If zone is not used,
                    the ^AINTL line will not be used.




          
          Scandinavian Digital Systems                               Page 4
          AnDan Software Message Generator Version 1.40        Users Manual
          


          from      From name, within " and " if space is used.

          dest      Destination address or @filename with each line
                    containing:

                      zone:net/node.point "Optional to name"

          to        Default to name, within " and " if space is used.

          flags     Message flags, one or more letters of:

                      P   Private
                      C   Crash
                      H   Hold
                      F   File
                      R   File request
                      U   Update request
                      K   Kill/sent
                      T   Trunc/sent (extended flag)
                      E   Delete/sent (extended flag)
                      D   Direct (extended flag)
                      I   Immediate mail (extended flag)
                      Z   No flags

          subj      Subject within " and " or @filename with each line
                    containing:

                      Subject (usually filename to request or send)

          message   Optional message text within " and " or @filename for a
                    text file.

          /c        Conditional, will generate a message only if no not
                    sent message with the same origin and destination net
                    and node, and from and to name exists.

          /N        N is a number. Moves N lines from the subject file, and
                    generate messages with those lines.

          ADMsg generates netmail messages (*.MSG files). The dest and
          subj files may have comment lines starting with ;. ADMsg will
          create a message for each subject to each destination. A ? may be
          used as any argument, in this case ADMsg will ask for that
          argument. Missing arguments will also be asked for.


          7  Execution examples

          admsg

              ADMsg will ask you for each argument needed.





          
          Scandinavian Digital Systems                               Page 5
          AnDan Software Message Generator Version 1.40        Users Manual
          


          ADMsg c:\msg 2:203/620 "Anders Danielsson" ? ? ? ? ?

              Mail will be sent from Anders Danielsson at 2:203/620. C:\MSG
              contains the netmail messages. What to send and to whom will
              be asked for by ADMsg. This example is suitable to use in a
              .BAT or .CMD file for sending messages manually with the same
              origin. If the question marks are omitted, Msgen will not ask
              for the subject and message text, because these are optional.


          admsg c:\fd\mail 2:203/620 "Anders Danielsson" 201/209 Sysop PKC
          Hello @letter.txt

              Send a crash mail from Anders Danielsson at 2:203/620 to
              Sysop at 2:201/209 with the subject "Hello" and the message
              text in the file LETTER.TXT.


          admsg c:\msg 2:203/620 "Anders Danielsson" .11 "Fredrik" PKF
          c:\a1f\andan.zip

              Send the file C:\A1F\ANDAN.ZIP to Fredrik at 2:203/620.11.


          admsg c:\msg 2:203/620 Sysop .11 Fredrik PKF ?

              ADMsg will ask for a file to send to Fredrik at
              2:203/620.11.


          admsg c:\msg 2:203/620 Sysop .11 Fredrik PKF ? ?

              ADMsg will ask for a file and message to send to Fredrik at
              2:203/620.11.


          admsg c:\msg 2:203/620.1 Sysop @nodes.lst Sysop PKFD
          c:\a3f\sds0901.zip @letter.txt

              Send directly a file and message to all nodes in NODES.LST.
              Example of NODES.LST:

              ;
              ; NODES.LST (lines begining with ; are comment lines)
              ;
              2:203/620.11 Fredrik Danielsson
              2:203/104    "Anders Ekman"         Comments...
              BBS          Lines begining with "BBS" are also ignored
              ;


          admsg c:\msg 2:203/620 Sysop 104 Sysop PKRC @req.lst




          
          Scandinavian Digital Systems                               Page 6
          AnDan Software Message Generator Version 1.40        Users Manual
          


              Make a file request from 2:203/104 with crash status of all
              files listed in REQ.LST. Example of REQ.LST:

              ADMSG130.ZIP
              ADF_144.ZIP


          admsg c:\msg 2:203/620 Sysop @nodes.lst Sysop PKF @send.lst
          @letter.txt

              Send all files listed in SEND.LST and the message in
              LETTER.TXT to all nodes in NODES.LST.


          admsg c:\msg 2:203/620 ADMsg 201/209 Sysop PKRD @201_209.req /c
          /4

              Make a file request from 2:201/209 with direct status of the
              4 first files listed in 201_209.REQ (if each line contains
              one file name), if there is no other message from ADMsg at
              203/620 and to Sysop at 201/209 in the netmail directory. The
              4 lines in 201_209.REQ are removed if the messages was
              generated. Use for example "if exist 201_209.req admsg ..."
              in the mailer .BAT or .CMD file after mail has been received
              for automatic request from system with request limits.


          8  Version history

          v1.00, September 25, 1991

          First release.


          v1.01, February 2, 1993

          Will use the ^AINTL line even if the zones are the same. To avoid
          the ^AINTL line, do not specify any zones.


          v1.02, July 20, 1994

          Added the ^AMSGID line. Changed date format in .MSG-header so
          always two digits are used for day of months (01 instead of 1).


          v1.10, November 24, 1995

          Program rewritten, OS/2 32-bit version included. Input of
          arguments from the keyboard. " and " may be used around to names
          in destination files.





          
          Scandinavian Digital Systems                               Page 7
          AnDan Software Message Generator Version 1.40        Users Manual
          


          v1.20, February 2, 1996

          The time limit of 30 days after installation has been removed.
          ADMsg will not stop executing after 30 days as before, it will
          run for ever, even if it is never registered.

          More individual MSGID. Date written and date arrived set to zero
          in message header to work with programs using these as zone and
          point addresses. Replaced tear line with ^APID line. Renamed from
          Msggen to ADMsg. Include terminating '\0' in written msg.


          v1.30 January 12, 1998

          Bugfix of DOS memory alloc error on large messages. AnDan
          Software is now on the WWW at http://www.digsys.se. reg@digsys.se
          has replaced reg@andan.edv.se as the registration e-mail address.
          The FidoNet address 2:203/620 is no longer valid, and has been
          removed from the programs and documentation. REGISTER.EXE v1.30
          needed to register.


          v1.40 January 19, 2000

          Changed from shareware to freeware. No registration needed
          anymore.






























          
          Scandinavian Digital Systems                               Page 8
