home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / FDM_100G.ZIP / FDMGR.DOC < prev    next >
Text File  |  1995-05-01  |  42KB  |  1,449 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.       FrontDoor Manager 1.00.SW Gamma-1
  30.  
  31.       User documentation
  32.  
  33.       Shareware version
  34.  
  35.  
  36.  
  37.       Table of contents
  38.  
  39.       1 LICENCE AND DISCLAIMER  . . . . . . . . . . . . . . . . . . . . . . . 1
  40.  
  41.       2 Introduction  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
  42.           2.1 Software requirements . . . . . . . . . . . . . . . . . . . . . 2
  43.           2.2 Hardware requirements . . . . . . . . . . . . . . . . . . . . . 2
  44.           2.3 Additional software . . . . . . . . . . . . . . . . . . . . . . 2
  45.           2.4 BBS Software  . . . . . . . . . . . . . . . . . . . . . . . . . 2
  46.  
  47.       3 Installation  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
  48.           3.1 FrontDoor . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
  49.               3.1.1 FrontDoor 2.20 or above . . . . . . . . . . . . . . . . . 3
  50.               3.1.2 FrontDoor 2.11.SW or above  . . . . . . . . . . . . . . . 3
  51.           3.2 RemoteAccess 2.0x . . . . . . . . . . . . . . . . . . . . . . . 3
  52.           3.3 Concord 0.01  . . . . . . . . . . . . . . . . . . . . . . . . . 3
  53.           3.4 PCBoard 15.x  . . . . . . . . . . . . . . . . . . . . . . . . . 3
  54.           3.5 AUTOEXEC.BAT  . . . . . . . . . . . . . . . . . . . . . . . . . 4
  55.           3.6 CONFIG.SYS  . . . . . . . . . . . . . . . . . . . . . . . . . . 4
  56.           3.7 Directories . . . . . . . . . . . . . . . . . . . . . . . . . . 4
  57.  
  58.       4 Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
  59.           4.1 Environment variables . . . . . . . . . . . . . . . . . . . . . 5
  60.           4.2 System variables  . . . . . . . . . . . . . . . . . . . . . . . 5
  61.           4.3 FDMSETUP  . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
  62.               4.3.1 Command line parameters . . . . . . . . . . . . . . . . . 5
  63.               4.3.2 Compile . . . . . . . . . . . . . . . . . . . . . . . . . 6
  64.               4.3.2 System data . . . . . . . . . . . . . . . . . . . . . . . 7
  65.               4.3.3 Miscellaneous . . . . . . . . . . . . . . . . . . . . . . 12
  66.               4.3.4 Event manager . . . . . . . . . . . . . . . . . . . . . . 13
  67.               4.3.5 Export data . . . . . . . . . . . . . . . . . . . . . . . 14
  68.               4.3.6 Information . . . . . . . . . . . . . . . . . . . . . . . 14
  69.               4.3.7 Exit to DOS . . . . . . . . . . . . . . . . . . . . . . . 14
  70.  
  71.       5 Nodelist  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
  72.           5.1 FDMNODE . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
  73.  
  74.       6 Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
  75.           6.1 Menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
  76.           6.2 Command line parameters . . . . . . . . . . . . . . . . . . . . 18
  77.           6.3 Errorlevels . . . . . . . . . . . . . . . . . . . . . . . . . . 18
  78.  
  79.       8 Scripts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
  80.  
  81.       7 Shareware registration  . . . . . . . . . . . . . . . . . . . . . . . 20
  82.  
  83.       8 Commercial inquiries  . . . . . . . . . . . . . . . . . . . . . . . . 21
  84.  
  85.       9 Credits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
  86.  
  87.  
  88.  
  89.       1 LICENCE AND DISCLAIMER
  90.  
  91.       FrontDoor Manager here after FDMGR is copyrighted material of Thomas
  92.       Raehalme, FINCOMM SYSTEMS protected by the laws of Finland.
  93.  
  94.       THIS IS THE SHAREWARE VERSION OF FRONTDOOR MANAGER. THE SHAREWARE
  95.       VERSION IS AVAILABLE ONLY FOR NON-COMMERCIAL USERS. ALL COMMERCIAL USERS
  96.       MUST PURCHASE A COMMERCIAL COPY OF FRONTDOOR MANAGER FROM ONE OF THE
  97.       AUTHORIZED DEALERS. IF YOU ARE A NON-COMMERCIAL USER YOU ARE ALLOWED TO
  98.       TEST THIS SOFTWARE FOR A PERIOD OF TWENTY-ONE (21) DAYS. AFTER THE
  99.       EVALUATION PERIOD YOU MUST DECIDE IF YOU WANT TO USE THE SOFTWARE IN THE
  100.       FUTURE AND REGISTER IT.
  101.  
  102.       Although this software has been tested in different environments no
  103.       guarantee or warranty of anykind is given by the author, Thomas Raehalme
  104.       or FINCOMM SYSTEMS. The author is not responsible for damage of anykind
  105.       including but not limited to financial lost of any kind caused by FDMGR.
  106.  
  107.       The Shareware version of FrontDoor Manager can be distributed freely as
  108.       long as the following terms are agreed.
  109.  
  110.           FDMGR must be distributed in the original unmodified archive. No
  111.           files may not be deleted and files may not be added. All the files
  112.           must be distributed in an unmodified original format and no profit
  113.           of any kind is made of the product.
  114.  
  115.       For CD-ROM distribution please contact the author, Thomas Raehalme.
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.                                           1
  148.  
  149.  
  150.  
  151.       2 Introduction
  152.  
  153.       FrontDoor Manager is an off-line product. It has been developed to allow
  154.       electric bulletin board systems stay on-line 24 hours a day. FDMGR does
  155.       nearly everything which takes expensive on-line time from the users
  156.       without taking the BBS off-line.
  157.  
  158.       FDMGR takes care of external events, mail processing, nodelist updating,
  159.       file echo processing, and more. Do not take your BBS off-line while
  160.       packing messages, let FDMGR do the job for you!
  161.  
  162.           2.1 Software requirements
  163.  
  164.               o   MS or PC DOS 3.10 or 99% compatible operating system.
  165.  
  166.               o   FrontDoor 2.11.SW, 2.20 or above.
  167.  
  168.               o   RemoteAccess 2.0x, Concord 0.01 or PCBoard 15.x.
  169.  
  170.           2.2 Hardware requirements
  171.  
  172.               o   An IBM PC, AT, i386, i486, Pentium(tm), PS/2 or 100%
  173.                   BIOS compatible.
  174.  
  175.               o   A hard disk with at least 300 KB of available disk space.
  176.  
  177.               o   A monochrome or color monitor.
  178.  
  179.               o   234 KB of free system memory.
  180.  
  181.           2.3 Additional software
  182.  
  183.               o   Mail tosser/manager such as GEcho.
  184.  
  185.               o   File echo processor such as Allfix.
  186.  
  187.               o   Full screen mail reader such GoldEd.
  188.  
  189.               o   Full screen file editor such as QEdit or GEdit.
  190.  
  191.           2.4 BBS Software
  192.  
  193.           FrontDoor Manager supports RemoteAccess, Concord and PCBoard.
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.                                           2
  210.  
  211.  
  212.  
  213.       3 Installation
  214.  
  215.       FrontDoor Manager can be very easily set up with a setup maintenance
  216.       provided with the software. FDMSETUP which is the setup maintenance
  217.       utility gives a possibility to alter nearly every option available.
  218.  
  219.           3.1 FrontDoor
  220.  
  221.           If you're running FrontDoor multiLine setting up FDMGR does not
  222.           require many changes to be done in the FD configuration. Running
  223.           under the Shareware version gives you just a little bit work but
  224.           is not impossible.
  225.  
  226.               3.1.1 FrontDoor 2.20 or above
  227.  
  228.               Disable exiting back to the OS after a mail session from
  229.               Mailer.Miscellaneous and from Manager.Events.Behaviour.
  230.               FrontDoor should only exit when passing a human caller to the
  231.               BBS or when pressing <Alt-Q>.
  232.  
  233.               Edit the Global.Filenames.MailExit to point to the filename
  234.               which FDMGR will recognize when new mail or files have been
  235.               received and they need to be processed. Make FD to create the
  236.               MailExit semaphore every time either files or mail packets have
  237.               been received. This filename must be exactly the same as in
  238.               FDMSETUP (System data.Semaphores.Received).
  239.  
  240.               3.1.2 FrontDoor 2.11.SW or above
  241.  
  242.               As the Shareware version doesn't support the MailExit semaphore
  243.               only the batch files need to be changed. After a mail session
  244.               FD usually exists back to the OS and tosses the mail, etc.
  245.               depending of the configuration. Replace everything which is done
  246.               when FD exists to OS after a mail session with a command line
  247.               which will create the MailExit semaphore manually.
  248.  
  249.               Semaphores can be created either with SEMAFORE.EXE provided with
  250.               FDMGR or with a plain DOS command REM: REM>filename.ext eg.
  251.               REM>C:\FD\FDRESCAN.NOW.
  252.  
  253.               FDMGR semaphore directory must point to the FD System directory
  254.               where the Shareware version stores its semaphores.
  255.  
  256.           3.2 RemoteAccess 2.0x
  257.  
  258.           FrontDoor Manager can be used with both Shareware and Professional
  259.           versions of RemoteAccess. The path defined in RA environment
  260.           variable will be used as common path and FDMGR will search
  261.           USERON.BBS from that directory. RemoteAccess will also create RABUSY
  262.           semaphores which should be defined in Semaphores.Task specific.
  263.  
  264.           3.3 Concord 0.01
  265.  
  266.           As Concord has a seperate node directory where it stores its node
  267.           files and on-line messages it has to be defined in FDMSETUP. When
  268.           using Concord it is not required to use the user on-line semaphore.
  269.  
  270.           3.4 PCBoard 15.x
  271.  
  272.                                           3
  273.  
  274.  
  275.  
  276.           As the path to the USERNET.XXX file is user defined must the file be
  277.           defined in FDMSETUP also. USERNET.XXX is the file which holds
  278.           information about each node (who's on-line, etc). It is also
  279.           possible to use PCBoard as a stand-alone software with FDMGR.
  280.  
  281.           3.5 AUTOEXEC.BAT
  282.  
  283.           Add SET FDMGR=C:\FDMGR to the AUTOEXEC.BAT so that FDMGR can easily
  284.           find it's main configuration files. When the environment variable
  285.           FDMGR has been set correctly it is possible to execute FDMGR in
  286.           another directory than the one where the executables are stored.
  287.  
  288.           3.6 CONFIG.SYS
  289.  
  290.           Please make sure that the FILES setting is at least 50.
  291.  
  292.           3.7 Directories
  293.  
  294.           First create the system directory where all the system files are
  295.           stored. FrontDoor Manager doesn't require any other directories but
  296.           it might be a good idea to store all the batch and script files in a
  297.           separate directory to keep the system directory clean.
  298.  
  299.           Example:
  300.  
  301.              C:\FDMGR
  302.                 ├─BATCH
  303.                 └─SCRIPT
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.                                           4
  333.  
  334.  
  335.  
  336.       4 Setup
  337.  
  338.       The setup maintenance of FrontDoor Manager, FDMSETUP, is used to
  339.       configure FDMGR. It gives you the possibility to change nearly every
  340.       available feature. FDMGR also supports environment variables and special
  341.       system variables to get access to the system information.
  342.  
  343.           4.1 Environment variables
  344.  
  345.           It is possible to import environment variables to the FDMGR
  346.           settings. When starting FrontDoor Manager it will scan all path and
  347.           file names for possible environment variables. The environment
  348.           variable can be anything within two $ (ASCII 36) characters.
  349.  
  350.           Please be aware that there are two internal variables which might
  351.           get messed up with the environment variables. These variables are
  352.           $TASK$ which indicates the current task number (node number minus
  353.           one) and $NODE$ which indicates the current node number.
  354.  
  355.           $FD$ would import the data stored in the environment variable FD
  356.           used by FrontDoor and $RA$ would import the data stored in the
  357.           environment variable RA used by RemoteAccess for example C:\FD and
  358.           C:\RA.
  359.  
  360.           4.2 System variables
  361.  
  362.           FrontDoor Manager has a few system variables which are used in
  363.           different situations. $TASK$ and $NODE$ described in the chapter
  364.           Environment variables can be used to indicate the node and task
  365.           number. When setting up status strings can some system variables be
  366.           used to indicate node/task information.
  367.  
  368.               %USER%         Name of the user on-line
  369.               %LOCATION%     Location of the user on-line
  370.               %BPS%          Connection speed of the user on-line
  371.               %STATUS%       Node status (Browsing, File xfer, Messages, etc)
  372.               %LASTCALLER%   Name of the last caller (any node)
  373.               %REMOTE%       The node address of the remote system
  374.  
  375.           The following variables can be used with the user definable reply
  376.           file which is used when replying a message from another node.
  377.  
  378.               %USER%         Name of the original writer
  379.               %FIRST%        First name of the original writer
  380.               %LAST%         Last name of the original writer
  381.               %QUOTE%        Quote the text written by the original writer
  382.               %VERSION%      FrontDoor Manager version
  383.               %COOKIE%       Pick a random cookie from COOKIE.MGR
  384.  
  385.           4.3 FDMSETUP
  386.  
  387.               4.3.1 Command line parameters
  388.  
  389.               The following parameters must be given as stated. Do not use a
  390.               forward slash (/) or a dash (-) in the front of the command.
  391.  
  392.               PACK
  393.  
  394.  
  395.                                           5
  396.  
  397.  
  398.  
  399.               Pack all the database files. This option will remove all deleted
  400.               entries.
  401.  
  402.               IMPORT
  403.  
  404.               Import configuration from other software. FDMSETUP will
  405.               automatically detect which software has been installed and
  406.               import the configuration from the setup files.
  407.  
  408.               COMPILE
  409.  
  410.               Compile a configuration from an ASCII file to a BINARY format.
  411.               Please note that before starting the compilation FDMSETUP will
  412.               reset all the values and everything has to be defined in the
  413.               input file.
  414.  
  415.               KEYS
  416.  
  417.               Enter the personal registration information. This parameter is
  418.               available only in the registered version.
  419.  
  420.               The following command line parameters require the usage of a
  421.               forward slash (/) or a dash (-) as the first character.
  422.  
  423.               CONFIG:<file>
  424.  
  425.               Forces FDMSETUP to use <file> as a configuration. The <file>
  426.               must include a full path to the SETUP.MGR eg. C:\FDM\SETUP.MGR.
  427.  
  428.               NOSHADOW
  429.  
  430.               Disables box shadows.
  431.  
  432.               MONO
  433.  
  434.               Forces the usage of monochrome display (video segment B000h).
  435.  
  436.               NOCLOCK
  437.  
  438.               Disable the system clock from the right corner. If your system
  439.               hangs when starting FDMSETUP better try this parameter.
  440.  
  441.               4.3.2 Compile
  442.  
  443.               If you like more ASCII configuration files than using a setup
  444.               maintenance utility you can use FDMGR.INI an ASCII file instead
  445.               of the setup maintenance. Every time FDMGR.INI has been changed
  446.               it has to be compiled with FDMSETUP using the command line
  447.               parameter 'Compile'.
  448.  
  449.               FDMGR.INI consists of three different categories just as in
  450.               FDMSETUP.
  451.  
  452.                   [System data]
  453.                   [Miscellaneous]
  454.                   [Event manager]
  455.  
  456.  
  457.                                           6
  458.  
  459.  
  460.  
  461.               In each category there are several commands included which are
  462.               named just as in FDMSETUP with the only difference that all
  463.               spaces are replaced with an underscore (ASCII 95). Commands and
  464.               passwords are not case sensitive.
  465.  
  466.               A few examples:
  467.  
  468.                   [System data]
  469.  
  470.                   SYSTEM_USERS.1.NAME Thomas Raehalme
  471.                   SYSTEM_USERS.1.PASSWORD Password
  472.                   SYSTEM_USERS.1.STATUS Remote
  473.  
  474.                   SYSTEM_USERS.2.NAME Toni Raehalme
  475.                   SYSTEM_USERS.2.PASSWORD Secret
  476.                   SYSTEM_USERS.2.STATUS Supervisor
  477.  
  478.                   PATHNAMES.SYSTEM E:\FDMGR
  479.  
  480.                   FILENAMES.LOG_FILE E:\LOG\FDMGR.LOG
  481.  
  482.                   [Miscellaneous]
  483.  
  484.                   GLOBAL_OPTIONS.BBS_SOFTWARE RemoteAccess
  485.                   GLOBAL_OPTIONS.SCREEN_SAVER 30
  486.  
  487.               Configuring Event manager is not yet supported in 1.00.SW.
  488.  
  489.               4.3.2 System data
  490.  
  491.               Site information
  492.  
  493.               Defines miscellaneous information about your system.
  494.  
  495.               System users
  496.  
  497.               It is possible to define up to 10 system users. Each user can
  498.               have a password defined. Each password has to be different. Two
  499.               users cannot use the same passwords as passwords are used to
  500.               identify the person.
  501.  
  502.               FDMGR supports three different access levels: Normal, Supervisor
  503.               and Remote. Users with the normal access level aren't allowed to
  504.               use FDMSETUP but they're allowed to use FDMGR freely. Users with
  505.               the remote status are allowed to alter settings remotely but not
  506.               locally with FDMSETUP. Users with the status supervisor don't
  507.               have any restrictions.
  508.  
  509.               Pathnames
  510.  
  511.                   System
  512.  
  513.                   Path to the directory where all the system files are stored.
  514.  
  515.                   Netmail
  516.  
  517.                   Path to the netmail directory as defined in FrontDoor. This
  518.  
  519.                                           7
  520.  
  521.  
  522.  
  523.                   is the directory where all the netmail messages are stored.
  524.  
  525.                   Nodelist
  526.  
  527.                   Path to the nodelist directory. This is the directory where
  528.                   FDMGR searches the nodelist files.
  529.  
  530.                   Inbound
  531.  
  532.                   Path to the directory where all incoming file and mail
  533.                   packets are stored. This directory is important as this
  534.                   directory is checked for incoming file and mail packets
  535.                   before starting the external echomail/fileecho processor.
  536.  
  537.                   SecInbound
  538.  
  539.                   All the received files from secured sessions are stored in
  540.                   this directory.
  541.  
  542.                   Packets
  543.  
  544.                   Path to the directory where FrontDoor stores its temporary
  545.                   mail packets.
  546.  
  547.                   Common
  548.  
  549.                   If your BBS software uses a specific directory as a common
  550.                   directory for all the lines the directory must be defined
  551.                   here. By leaving this entry empty FDMGR will use the
  552.                   directory defined in the BBS environment variable.
  553.  
  554.                   Temporary
  555.  
  556.                   Full path to the directory where all the temporary files are
  557.                   stored.
  558.  
  559.                   Swapping
  560.  
  561.                   If swapping to disk has been enabled this directory will be
  562.                   used to store the temporary swap file.
  563.  
  564.                   Semaphore
  565.  
  566.                   This is one of the most important directories used by FDMGR.
  567.                   FDMGR will store all the semaphore file in this directory
  568.                   and if no directory for a file defined in Semaphores is
  569.                   specified FDMGR will search the file from this directory.
  570.  
  571.               Filenames
  572.  
  573.                   Editor
  574.  
  575.                   Full path to the full screen mail reader such as FM.
  576.  
  577.                   MsgEditor
  578.  
  579.                   Full path to the message/file editor such as QEdit or GEdit.
  580.  
  581.                                           8
  582.  
  583.  
  584.  
  585.                   Nodelist
  586.  
  587.                   Full path to the nodelist compiler/manager such as FDNC.
  588.  
  589.                   Reply msg
  590.  
  591.                   Full path to the template file which will be used when
  592.                   replying to an on-line message. To use the default reply
  593.                   leave this entry empty. The template file can contain
  594.                   certain system variables.
  595.  
  596.                       %USER%       User name
  597.                       %FIRST%      User's first name
  598.                       %LAST%       User's last name
  599.                       %QUOTE%      Quote the original text
  600.                       %VERSION%    FrontDoor Manager version number
  601.                       %COOKIE%     Pick a random cookie from COOKIE.MGR
  602.  
  603.                   Usernet
  604.  
  605.                   If you're using PCBoard 15.x you must define the full path
  606.                   to the USERNET.XXX file eg. C:\PCBOARD\MAIN\USERNET.XXX.
  607.  
  608.                   Log file
  609.  
  610.                   Full path to the FDMGR log file. Please see Log options to
  611.                   control logging.
  612.  
  613.               Semaphores
  614.  
  615.                   Task status
  616.  
  617.                   Each task can have seperate status strings and semaphore
  618.                   definitions. It is possible to use $TASK$ and $NODE$
  619.                   variables which will be replaced with the current task/node
  620.                   number.
  621.  
  622.                       Mailer alive
  623.  
  624.                       Full path to the file which indicates that mailer is
  625.                       alive and running. Usually this file is FDALIVE.$TASK$.
  626.  
  627.                       Mailer frozen
  628.  
  629.                       When this semaphore exists mailer is frozen. Usually
  630.                       this semaphore is FDFROZEN.$TASK$.
  631.  
  632.                       Mail session
  633.  
  634.                       The existence of this file indicates that the mailer is
  635.                       having a mail session. Usually FDINSESS.$TASK$ is used.
  636.  
  637.                       User on-line
  638.  
  639.                       This semaphore was required with RemoteAccess as it
  640.                       creates RABUSY.$NODE$ when user is in the BBS. But if
  641.  
  642.                                           9
  643.  
  644.  
  645.  
  646.                       you're running PCBoard or Concord this file won't be
  647.                       created and therefore not required.
  648.  
  649.                       Strings
  650.  
  651.                       These are the strings which are displayed at the node
  652.                       status if that has been enabled. It is possible to use
  653.                       certain variables which indicate different information
  654.                       about the node.
  655.  
  656.                           %NAME%         User name
  657.                           %LOCATION%     User location
  658.                           %BPS%          Connect speed
  659.                           %STATUS%       What is the user doing currently
  660.                           %REMOTE%       The address of the remote system
  661.                           %LASTCALLER%   The name of the last caller
  662.  
  663.                       Logging in
  664.  
  665.                       String which will be displayed when a user is logging in
  666.                       to the BBS.
  667.  
  668.                       Task inactive
  669.  
  670.                       String which will be displayed when the task is
  671.                       inactive.
  672.  
  673.                       User on-line
  674.  
  675.                       String which will be displayed when the task is having a
  676.                       user on-line in the BBS. There're certain variables
  677.                       which can be used with this string.
  678.  
  679.                           %NAME%       User name
  680.                           %LOCATION%   User location
  681.                           %BPS%        Connect speed
  682.                           %STATUS%     What is the user doing currently
  683.  
  684.                       The default value
  685.  
  686.                           User: %NAME% from %LOCATION%, %BPS% (%STATUS%)
  687.  
  688.                       could be displayed at
  689.  
  690.                           User: Thomas Raehalme from FCS, 14400 BPS (Browsing)
  691.  
  692.                       If you're using PCBoard 15.x FDMGR cannot display the
  693.                       speed of the connection as the speed cannot be found
  694.                       from USERNET.XXX. If %BPS% is still being used it is
  695.                       only removed and not replaced with anything.
  696.  
  697.                       Waiting call
  698.  
  699.                       This string is used when the mailer is waiting for a
  700.                       call or next event. It is also possible to display the
  701.                       name of the last caller with the variable %LASTCALLER%.
  702.                       Because the name of the last caller is always from any
  703.  
  704.                                           10
  705.  
  706.  
  707.  
  708.                       node it is reasonable to use %LASTCALLER% only with one
  709.                       node. Otherwise every node would display the same name
  710.                       as a last caller.
  711.  
  712.                       Task frozen
  713.  
  714.                       String which will be displayed if the task is frozen.
  715.  
  716.                       Session
  717.  
  718.                       String which will be displayed if the task is having a
  719.                       mail session. It is possible to use %REMOTE% variable to
  720.                       indicate the remote's node address.
  721.  
  722.                       The default value
  723.  
  724.                           Mail session with %REMOTE%
  725.  
  726.                       could be displayed at
  727.  
  728.                           Mail session with 2:220/412
  729.  
  730.                       FDTerminal
  731.  
  732.                       String which will be displayed when the FDTerminal has
  733.                       been loaded.
  734.  
  735.               External utilities
  736.  
  737.                   Toss
  738.  
  739.                   Full path to the filename which will be executed when new
  740.                   mail has to be processed. This could be the batch file
  741.                   TOSSMAIL.BAT which was provided with FDMGR.
  742.  
  743.                   Scan
  744.  
  745.                   Full path to the filename which will be executed when new
  746.                   local/net/echomail has been entered to the message base.
  747.                   FDMGR provides a batch file called SCANMAIL.BAT to do
  748.                   message base scanning with GEcho.
  749.  
  750.                   Files
  751.  
  752.                   Full path to the filename which will be executed when new
  753.                   files have been received and all the .TIC files have to be
  754.                   processed. TOSSFILE.BAT will handle the file echo processing
  755.                   with Allfix.
  756.  
  757.                   Import
  758.  
  759.                   Full path to the filename which will be executed when
  760.                   netmail has to be imported from the netmail directory.
  761.  
  762.                   Nodelist
  763.  
  764.                   Full path to the filename which will be executed when one of
  765.  
  766.                                           11
  767.  
  768.  
  769.  
  770.                   the nodelists needs to be updated.
  771.  
  772.                   Editor
  773.  
  774.                   Full path to the external file editor used with FDMSETUP.
  775.                   The external file editor can be called by pressing either F3
  776.                   or Alt-E.
  777.  
  778.               4.3.3 Miscellaneous
  779.  
  780.               Global options
  781.  
  782.                   Mailer type
  783.  
  784.                   Only FrontDoor supported for obvious reasons.
  785.  
  786.                   BBS software
  787.  
  788.                   Type of the BBS software. This release of FDMGR supports
  789.                   RemoteAccess 2.0x, Concord 0.01 and PCBoard 15.x. If your
  790.                   BBS software is not one of the above you can use USERON.EXE
  791.                   and SEMAFORE.EXE to create files and use FDMGR. Then FDMGR
  792.                   will have the minimum support for your BBS software.
  793.  
  794.                   Active nodes
  795.  
  796.                   Number of nodes.
  797.  
  798.                   Display info
  799.  
  800.                   Display information about the active nodes (which node is
  801.                   doing what).
  802.  
  803.                   Install on node
  804.  
  805.                   FDMGR can be installed as a user to one of the nodes in the
  806.                   BBS. Then users are allowed to write on-line messages to
  807.                   FDMGR and FDMGR will reply to the messages if possible. This
  808.                   also enables the on-line Remote Maintenance option.
  809.  
  810.                   Screen saver
  811.  
  812.                   How many seconds to activate the internal screen saver. To
  813.                   enable the internal screen saver the value must be greater
  814.                   or equal to 5.
  815.  
  816.                   Multitasker
  817.  
  818.                   FDMGR currently supports only DESQview and OS/2. If FDMGR
  819.                   cannot detect the multitasker automatically it is possible
  820.                   to force FDMGR think it's running under one of the supported
  821.                   multitasker.
  822.  
  823.                   Find destination
  824.  
  825.                   If you're using the variable %REMOTE% with System
  826.                   data.Semaphores.Task status.Session you must indicate how to
  827.  
  828.                                           12
  829.  
  830.  
  831.  
  832.                   search for the remote address. FDMGR can search the address
  833.                   either from PASSWORD.FD or it can use it's own index file
  834.                   NODELIST.MGX. If you have only secured mail sessions it is
  835.                   wise to use PASSWORD.FD as then you don't have to compile
  836.                   the whole nodelist. But if you want to cover all the
  837.                   addresses in the nodelist you must use NODELIST.MGX which
  838.                   can be created with FDMNODE.
  839.  
  840.               Multitasker options
  841.  
  842.               Function keys
  843.  
  844.                   In this menu you can define all the function keys used with
  845.                   FDMGR. It is possible to load an external utility or to
  846.                   login locally to the BBS. If $TASK$ or $NODE$ has been used
  847.                   with the function keys FDMGR will ask the current node
  848.                   number before executing any external utility.
  849.  
  850.               Audio control
  851.  
  852.               Log options
  853.  
  854.               FDMSETUP colors
  855.  
  856.               4.3.4 Event manager
  857.  
  858.               Tag
  859.  
  860.               FDMGR has three types of events: eXternal, Execute and Script.
  861.               When an external event has to be executed FDMGR will exit back
  862.               to the operating system with an errorlevel defined in the
  863.               current event. It is also possible to execute external utilities
  864.               (.EXE, .COM, .BAT, .BTM) in an event. The internal script
  865.               language is not supported in this release.
  866.  
  867.               The @ event may not be deleted. It is active all the time when
  868.               there is no other events.
  869.  
  870.               Days
  871.  
  872.               Days when the event will be displayed.
  873.  
  874.               Start time
  875.  
  876.               Defines the start time of an event. The start time must be in
  877.               24-hour format.
  878.  
  879.               Length time
  880.  
  881.               Defines the length of the event in 24-hour format.
  882.  
  883.               Errorlevel
  884.  
  885.               Defines the errorlevel used with eXternal events. The value may
  886.               be between 31 and 255.
  887.  
  888.               Filename
  889.  
  890.                                           13
  891.  
  892.  
  893.  
  894.               Full path to the filename which will be executed with Execute
  895.               and Script events.
  896.  
  897.               4.3.5 Export data
  898.  
  899.               Export various data to any device.
  900.  
  901.               4.3.6 Information
  902.  
  903.               Information about FDMSETUP.
  904.  
  905.               4.3.7 Exit to DOS
  906.  
  907.               Return back to the operating system. If changes have been made
  908.               you'll be prompted whether or not you want to save the changes.
  909.               When starting FDMSETUP for the first time changes will be saved
  910.               automatically.
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.  
  930.  
  931.  
  932.  
  933.  
  934.  
  935.  
  936.  
  937.  
  938.  
  939.  
  940.  
  941.  
  942.  
  943.  
  944.  
  945.  
  946.  
  947.  
  948.  
  949.  
  950.                                           14
  951.  
  952.  
  953.  
  954.       5 Nodelist
  955.  
  956.       As you have probably used FrontDoor for some time I see no reason why to
  957.       explain the structure of the nodelists used by FrontDoor. FrontDoor
  958.       Manager cannot share the FD nodelist index files because the files have
  959.       been created with the help of Turbo Database Toolkit which FDMGR doesn't
  960.       include.
  961.  
  962.       FrontDoor Manager doesn't require the existence of the nodelist. It can
  963.       be set up to use the nodelists as a source when searching for the
  964.       destination address but then it will only use it's internal nodelist
  965.       database index file which is created with the nodelist.
  966.  
  967.           5.1 FDMNODE
  968.  
  969.           FDMNODE is a nodelist compiler which compiles all the nodelists
  970.           defined in FDNODE.CTL to a single index file. Each node will take
  971.           approx. 3 bytes. About 40000 nodes will then occupy disk space only
  972.           a little more than 100 kilobytes.
  973.  
  974.           FDMNODE needs no special configuration. It uses SETUP.MGR to find
  975.           out the nodelist directory and FDNODE.CTL to incorporate nodelists.
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997.  
  998.  
  999.  
  1000.  
  1001.  
  1002.  
  1003.  
  1004.  
  1005.  
  1006.  
  1007.  
  1008.  
  1009.  
  1010.  
  1011.  
  1012.                                           15
  1013.  
  1014.  
  1015.  
  1016.       6 Manager
  1017.  
  1018.       FrontDoor Manager is the brains of the product. It will control the BBS,
  1019.       start the external utilities at an appropriate time, handle events and
  1020.       much more. All the other software provided with the product are just
  1021.       utilities made for FDMGR.
  1022.  
  1023.           6.1 Menus
  1024.  
  1025.           Programs                <Alt-P>
  1026.  
  1027.               Message editor      <Alt-E>
  1028.  
  1029.               Load the user defined mail editor/reader.
  1030.  
  1031.               Configure           <Alt-C>
  1032.  
  1033.               Start the setup maintenance (FDMSETUP).
  1034.  
  1035.               Nodelist            <Alt-N>
  1036.  
  1037.               Start the nodelist compiler/manager.
  1038.  
  1039.               User keys           <Alt-K>
  1040.  
  1041.               Display function keys.
  1042.  
  1043.               DOS shell           <Alt-Z>
  1044.  
  1045.               Temporary shell to the operating system. Type "EXIT" to return
  1046.               back to FrontDoor Manager.
  1047.  
  1048.               Quit                <Alt-Q>
  1049.  
  1050.               Return back to the operating system.
  1051.  
  1052.           Utilities               <Alt-U>
  1053.  
  1054.               Recent activity     <Alt-R>
  1055.  
  1056.               Shows you the last two days of general activity, failed sessions,
  1057.               file requests, number of files/bytes sent and received, etc.
  1058.  
  1059.               Inbound activity    <Alt-I>
  1060.  
  1061.               Invokes the inbound call (mail) history management function.
  1062.  
  1063.               Send a message      <Alt-O>
  1064.  
  1065.               Send an on-line message to one of the users on-line.
  1066.  
  1067.               Lock keyboard       <Alt-L>
  1068.  
  1069.               Allows you to lock the keyboard against unauthorized use. FDMGR
  1070.               will still perform its duties. To unlock the computer just enter
  1071.               the correct password. The keyboard lock password is not case
  1072.               sensitive.
  1073.  
  1074.  
  1075.                                           16
  1076.  
  1077.  
  1078.  
  1079.               Restart event       <Alt-F7>
  1080.  
  1081.               Force rescan on all tasks.
  1082.  
  1083.           Mail                    <Alt-M>
  1084.  
  1085.               Mail queue          <Alt-B>
  1086.  
  1087.               Allows you to manipulate the current FD mail queue.
  1088.  
  1089.               Undialable          <Alt-V>
  1090.  
  1091.               Allows you to manipulate systems marked as undialable.
  1092.  
  1093.               Forced poll         <Alt-F>
  1094.  
  1095.               Creates a priority entry in the mail queue for the specified
  1096.               system. If an entry for the specified system already exists in
  1097.               the queue, its status is set to priority.
  1098.  
  1099.               Request files       <Alt-G>
  1100.  
  1101.               Allows you to create a temporary file request to the specified
  1102.               system.
  1103.  
  1104.               Transmit files      <Alt-T>
  1105.  
  1106.               Allows you to transmit files to the specified system.
  1107.  
  1108.           System                  <Alt-G>
  1109.  
  1110.               Answer
  1111.  
  1112.               Temporary disable/enable Manual answer.
  1113.  
  1114.               Printer
  1115.  
  1116.               Toggle printout of incoming messages.
  1117.  
  1118.               Human callers
  1119.  
  1120.               Temporarily prevent human callers passing through.
  1121.  
  1122.               Scan messages
  1123.  
  1124.               Temporarily prevent scanning the message base.
  1125.  
  1126.               Toss mail
  1127.  
  1128.               Toggle processing of incoming mail.
  1129.  
  1130.               Process files
  1131.  
  1132.               Toggle processing of incoming files.
  1133.  
  1134.               Update nodelists
  1135.  
  1136.  
  1137.                                           17
  1138.  
  1139.  
  1140.  
  1141.               Toggle processing of new nodelists and nodelist updates.
  1142.  
  1143.           6.2 Command line parameters
  1144.  
  1145.           All of the following parameters must be preceded by either a forward
  1146.           slash (/) or a dash (-). Command line parameters are not case
  1147.           sensitive which means it doesn't matter whether or not you write the
  1148.           letters in capitals.
  1149.  
  1150.           LOCK:<pwd>
  1151.  
  1152.           Locks the keyboard with the specified password just like in
  1153.           FrontDoor. The keyboard can be locked from FrontDoor by pressing
  1154.           <Alt-L> or by choosing Lock keyboard from Utilities in FDMGR.
  1155.  
  1156.           NOSHADOW
  1157.  
  1158.           Disables box shadows.
  1159.  
  1160.           CONFIG:<file>
  1161.  
  1162.           Forces FDMGR to use <file> as a configuration. The <file> must
  1163.           include a full path to the SETUP.MGR eg. C:\FDM\SETUP.MGR.
  1164.  
  1165.           6.3 Errorlevels
  1166.  
  1167.           FrontDoor Manager can return one of the following errorlevels.
  1168.  
  1169.               1       Internal error
  1170.               2       External error (file or path missing, etc)
  1171.               3       Insufficient disk space (less than 32 kB)
  1172.               8       FDMGR already loaded, enter EXIT to return
  1173.               10      User break
  1174.               31-255  User definable errorlevels
  1175.  
  1176.  
  1177.  
  1178.  
  1179.  
  1180.  
  1181.  
  1182.  
  1183.  
  1184.  
  1185.  
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.  
  1193.  
  1194.  
  1195.  
  1196.  
  1197.  
  1198.                                           18
  1199.  
  1200.  
  1201.  
  1202.       8 Scripts
  1203.  
  1204.       This version of FrontDoor Manager doesn't support the internal
  1205.       programming language. This feature will probably be seen in FDMGR in the
  1206.       next version. No promises given, no promises broken.
  1207.  
  1208.  
  1209.  
  1210.  
  1211.  
  1212.  
  1213.  
  1214.  
  1215.  
  1216.  
  1217.  
  1218.  
  1219.  
  1220.  
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.  
  1241.  
  1242.  
  1243.  
  1244.  
  1245.  
  1246.  
  1247.  
  1248.  
  1249.  
  1250.  
  1251.  
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.  
  1259.  
  1260.                                           19
  1261.  
  1262.  
  1263.  
  1264.       7 Shareware registration
  1265.  
  1266.       FrontDoor Manager has several registration sites all around the world.
  1267.       Please contact your local registration site if available. If one is not
  1268.       available please contact the worldwide registration site in Finland. The
  1269.       full list of the registration sites can be found from REGSITES.LST.
  1270.  
  1271.       The Evaluation version of FrontDoor Manager does not include all the
  1272.       features available in the Registered version. The Evaluation version
  1273.       also has some limitations.
  1274.  
  1275.           o   Support available only for one node. The Registered version
  1276.               supports up-to 250 nodes and is capable of displaying node
  1277.               information of the first 10 nodes.
  1278.  
  1279.           o   Installing FDMGR to a one node in the BBS has been disabled in
  1280.               the Evaluation version. This option can be toggled in the
  1281.               Registered version.
  1282.  
  1283.           o   SessStart and SessEnd has been disabled. These features are
  1284.               available in the Registered version and be defined to be
  1285.               executed in the beginning and in the end of a mail session.
  1286.  
  1287.           o   Automatical importing of netmail messages has been disabled. If
  1288.               system has received new mail but not new mail packets the
  1289.               Registered version will start a mail importer instead.
  1290.  
  1291.  
  1292.  
  1293.  
  1294.  
  1295.  
  1296.  
  1297.  
  1298.  
  1299.  
  1300.  
  1301.  
  1302.  
  1303.  
  1304.  
  1305.  
  1306.  
  1307.  
  1308.  
  1309.  
  1310.  
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317.  
  1318.  
  1319.  
  1320.  
  1321.  
  1322.                                           20
  1323.  
  1324.  
  1325.  
  1326.       8 Commercial inquiries
  1327.  
  1328.       There are two different versions available of FDMGR. One of them is the
  1329.       commercial version which is developed for commercial users. Commercial
  1330.       users are not allowed to use the Shareware version of FrontDoor Manager.
  1331.  
  1332.       Commercial inquiries should be sent to the following company:
  1333.  
  1334.       FINCOMM SYSTEMS                           Telephone: +358 40 545 0605
  1335.       Attn. Thomas Raehalme                         Modem: +358 14 724 293
  1336.       P.O. Box 110
  1337.       FIN-11101 RIIHIMÄKI                             2:220/412@fidonet.org
  1338.       Finland                                              255:3358/1@fdnet
  1339.  
  1340.  
  1341.  
  1342.  
  1343.  
  1344.  
  1345.  
  1346.  
  1347.  
  1348.  
  1349.  
  1350.  
  1351.  
  1352.  
  1353.  
  1354.  
  1355.  
  1356.  
  1357.  
  1358.  
  1359.  
  1360.  
  1361.  
  1362.  
  1363.  
  1364.  
  1365.  
  1366.  
  1367.  
  1368.  
  1369.  
  1370.  
  1371.  
  1372.  
  1373.  
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382.  
  1383.  
  1384.                                           21
  1385.  
  1386.  
  1387.  
  1388.       9 Credits
  1389.  
  1390.       FrontDoor Manager was written by Thomas Raehalme, FINCOMM SYSTEMS.
  1391.       This documentation was written using DOCUMENT 1.00 by Thomas Raehalme.
  1392.  
  1393.       I, the author, would like to thank following persons:
  1394.  
  1395.       ... the beta crew, Joaquim Homrighausen, Richard Hansen, Andrew Milner,
  1396.       Christian Homrighausen, Pasi Talliniemi, Jörg Haberstroh, Bo Bendtsen,
  1397.       Roland van der Put, Toni Raehalme and Jani Lillberg.
  1398.  
  1399.       The following trademarks and brand names are property of their
  1400.       respective owners.
  1401.  
  1402.           Allfix             Harald Harms
  1403.           Concord            Pasi Talliniemi, Softatalli Oy
  1404.           DESQview           Quarterdeck Office Systems
  1405.           FrontDoor          Joaquim Homrighausen, Absolute Solutions
  1406.           FrontDoor Manager  Thomas Raehalme, FINCOMM SYSTEMS
  1407.           GEcho              Gerard van der Land
  1408.           GEdit              The Developers Network Inc.
  1409.           GoldEd             Odinn Sorensen
  1410.           MS-DOS             Microsoft Corp.
  1411.           Nodelist Updater   Roland van der Put
  1412.           OS/2 WARP          International Business Machines
  1413.           PCBoard            Clark Development Company, Inc.
  1414.           QEdit              SemWare Corp.
  1415.           RemoteAccess       Andrew Milner, Wantree Development
  1416.           Turbo Pascal       Borland International Inc.
  1417.  
  1418.  
  1419.  
  1420.  
  1421.  
  1422.  
  1423.  
  1424.  
  1425.  
  1426.  
  1427.  
  1428.  
  1429.  
  1430.  
  1431.  
  1432.  
  1433.  
  1434.  
  1435.  
  1436.  
  1437.  
  1438.  
  1439.  
  1440.  
  1441.  
  1442.  
  1443.  
  1444.  
  1445.  
  1446.  
  1447.                                           22
  1448.  
  1449.