home *** CD-ROM | disk | FTP | other *** search
/ PC Online 1999 May / PC_ONLINE_5_99.ISO / filesbbs / dos / afx_512.exe / ALLFIX.DOC < prev    next >
Encoding:
Text File  |  1998-12-30  |  345.0 KB  |  9,152 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.                                          
  20.                                       ALLFIX
  21.  
  22.                                 fileecho processor
  23.  
  24.                                     user manual
  25.  
  26.  
  27.  
  28.                                 ALLFIX version 5.12
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.                  Copyright (C) 1992,98 Harms Software Engineering
  36.                                 All rights reserved
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.                        All information in this documentation
  44.                      is subject to change without prior notice
  45.  
  46.  
  47.                         Made with Pride in The Netherlands
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.         1    Introduction . . . . . . . . . . . . . . . . . . . . . .     5
  57.              1.1  ALLFIX help and support . . . . . . . . . . . . . .     5
  58.              1.2  What is ALLFIX? . . . . . . . . . . . . . . . . . .     5
  59.              1.3  What is new in this version . . . . . . . . . . . .     6
  60.              1.4  Features  . . . . . . . . . . . . . . . . . . . . .     8
  61.              1.5  System Hardware and Software Requirements . . . . .     9
  62.              1.6  License and Disclaimer  . . . . . . . . . . . . . .    10
  63.  
  64.         2    Registrations  . . . . . . . . . . . . . . . . . . . . .    11
  65.              3.1  Network structure . . . . . . . . . . . . . . . . .    11
  66.              3.2  Mail transfer and the FileFind system . . . . . . .    12
  67.  
  68.         4    Fileechos and Magic files  . . . . . . . . . . . . . . .    13
  69.              4.1  Fileechos explained . . . . . . . . . . . . . . . .    13
  70.                   4.1.1     TIC file verbs  . . . . . . . . . . . . .    14
  71.                   4.1.2     TIC archive packages  . . . . . . . . . .    16
  72.              4.2  Magic filenames explained . . . . . . . . . . . . .    16
  73.  
  74.         5    FCOMP  . . . . . . . . . . . . . . . . . . . . . . . . .    17
  75.              5.1  Command line options  . . . . . . . . . . . . . . .    17
  76.  
  77.         6    ASETUP . . . . . . . . . . . . . . . . . . . . . . . . .    19
  78.              6.1  Installation  . . . . . . . . . . . . . . . . . . .    19
  79.              6.2  Starting the Program  . . . . . . . . . . . . . . .    20
  80.                   6.2.1     Keys  . . . . . . . . . . . . . . . . . .    21
  81.                   6.2.2     Selecting entries from a list . . . . . .    21
  82.                   6.2.3     Online help . . . . . . . . . . . . . . .    21
  83.                   6.2.4     Selecting message areas . . . . . . . . .    22
  84.                   6.2.5     Selecting template files  . . . . . . . .    23
  85.                   6.2.6     Internal text editor  . . . . . . . . . .    24
  86.                   6.2.7     Editing system lists  . . . . . . . . . .    24
  87.                   6.2.8     The managers  . . . . . . . . . . . . . .    25
  88.                   6.2.9     Shell . . . . . . . . . . . . . . . . . .    26
  89.                   6.2.10    Command line options. . . . . . . . . . .    27
  90.                   6.2.11    Index files . . . . . . . . . . . . . . .    27
  91.              6.3  System data . . . . . . . . . . . . . . . . . . . .    27
  92.                   6.3.1     Address maintenance . . . . . . . . . . .    27
  93.                        6.3.1.1   Network addresses  . . . . . . . . .    27
  94.                        6.3.1.2   Site information . . . . . . . . . .    28
  95.                        6.3.1.3   AKA matching . . . . . . . . . . . .    29
  96.                        6.3.1.4   Domain names . . . . . . . . . . . .    29
  97.                   6.3.2     Pathnames . . . . . . . . . . . . . . . .    30
  98.                   6.3.3     Pathnames (part 2)  . . . . . . . . . . .    32
  99.                   6.3.4     Filenames . . . . . . . . . . . . . . . .    33
  100.                   6.3.5     Internet settings . . . . . . . . . . . .    37
  101.                   6.3.6     Origin lines  . . . . . . . . . . . . . .    41
  102.                   6.3.7     External programs . . . . . . . . . . . .    41
  103.                   6.3.8     External program options  . . . . . . . .    45
  104.                   6.3.9     Global options  . . . . . . . . . . . . .    47
  105.                   6.3.10    Miscellaneous . . . . . . . . . . . . . .    51
  106.                        6.3.10.1  Log options  . . . . . . . . . . . .    51
  107.                        6.3.10.2  AreaMgr options  . . . . . . . . . .    52
  108.                        6.3.10.3  Edit days  . . . . . . . . . . . . .    54
  109.                        6.3.10.4  Edit months  . . . . . . . . . . . .    54
  110.                        6.3.10.5  Exclude files  . . . . . . . . . . .    54
  111.                        6.3.10.6  ASETUP colors  . . . . . . . . . . .    54
  112.              6.4  FileFind areas  . . . . . . . . . . . . . . . . . .    54
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.              6.5  Fileecho system . . . . . . . . . . . . . . . . . .    56
  121.                   6.5.1     Fileecho manager  . . . . . . . . . . . .    56
  122.                        6.5.1.1   Advanced options . . . . . . . . . .    60
  123.                        6.5.1.2   Global editing . . . . . . . . . . .    63
  124.                        6.5.1.3   Fileecho options . . . . . . . . . .    63
  125.                        6.5.1.4   LongDesc options . . . . . . . . . .    67
  126.                   6.5.2     Hatch manager . . . . . . . . . . . . . .    68
  127.                   6.5.3     Magic filenames manager . . . . . . . . .    70
  128.                   6.5.4     Group manager . . . . . . . . . . . . . .    76
  129.                   6.5.5     Uplink manager  . . . . . . . . . . . . .    78
  130.                   6.5.6     Uplink options  . . . . . . . . . . . . .    80
  131.              6.6  New file reports  . . . . . . . . . . . . . . . . .    81
  132.              6.7  BBS new file dirs . . . . . . . . . . . . . . . . .    82
  133.              6.8  Allfiles lists  . . . . . . . . . . . . . . . . . .    83
  134.              6.9  Request Processor . . . . . . . . . . . . . . . . .    84
  135.              6.10 Node manager  . . . . . . . . . . . . . . . . . . .    89
  136.                   6.10.1    Internet options  . . . . . . . . . . . .    92
  137.                   6.10.2    Advanced options  . . . . . . . . . . . .    92
  138.                   6.10.3    Cost sharing  . . . . . . . . . . . . . .    93
  139.              6.11 Utilities . . . . . . . . . . . . . . . . . . . . .    94
  140.                   6.11.1    Template editor . . . . . . . . . . . . .    94
  141.                   6.11.2    Export data . . . . . . . . . . . . . . .    95
  142.                   6.11.3    Import data . . . . . . . . . . . . . . .    95
  143.                   6.11.4    Uplink requests . . . . . . . . . . . . .    97
  144.              6.12 Information . . . . . . . . . . . . . . . . . . . .    97
  145.              6.13 Exit program  . . . . . . . . . . . . . . . . . . .    97
  146.              6.14 Template files  . . . . . . . . . . . . . . . . . .    97
  147.                   6.14.1    Standard template files . . . . . . . . .    97
  148.                   6.14.2    Key words . . . . . . . . . . . . . . . .    99
  149.                   6.14.3    Blocks  . . . . . . . . . . . . . . . . .   110
  150.                   6.14.4    Functions . . . . . . . . . . . . . . . .   111
  151.  
  152.         7    ALLFIX . . . . . . . . . . . . . . . . . . . . . . . . .   115
  153.              7.1  Announce  . . . . . . . . . . . . . . . . . . . . .   116
  154.              7.2  Scan  . . . . . . . . . . . . . . . . . . . . . . .   117
  155.              7.3  File  . . . . . . . . . . . . . . . . . . . . . . .   117
  156.              7.4  Mgr . . . . . . . . . . . . . . . . . . . . . . . .   118
  157.              7.5  Notify  . . . . . . . . . . . . . . . . . . . . . .   119
  158.              7.6  Bill  . . . . . . . . . . . . . . . . . . . . . . .   120
  159.              7.7  FakeReq . . . . . . . . . . . . . . . . . . . . . .   120
  160.              7.8  Credit  . . . . . . . . . . . . . . . . . . . . . .   121
  161.              7.9  ReRequest . . . . . . . . . . . . . . . . . . . . .   121
  162.              7.10 ReLink  . . . . . . . . . . . . . . . . . . . . . .   121
  163.              7.11 Rp  . . . . . . . . . . . . . . . . . . . . . . . .   121
  164.              7.12 Log file  . . . . . . . . . . . . . . . . . . . . .   121
  165.              7.13 Errorlevels . . . . . . . . . . . . . . . . . . . .   121
  166.              7.14 ALLFIX semaphore file . . . . . . . . . . . . . . .   122
  167.  
  168.         8    Cookies  . . . . . . . . . . . . . . . . . . . . . . . .   122
  169.              8.1  BAKE  . . . . . . . . . . . . . . . . . . . . . . .   122
  170.              8.2  SCRAMBLE  . . . . . . . . . . . . . . . . . . . . .   123
  171.              8.3  COOKIE  . . . . . . . . . . . . . . . . . . . . . .   123
  172.  
  173.         9    FIXUTIL  . . . . . . . . . . . . . . . . . . . . . . . .   123
  174.              9.1  Allfiles  . . . . . . . . . . . . . . . . . . . . .   124
  175.              9.2  Pack  . . . . . . . . . . . . . . . . . . . . . . .   124
  176.              9.3  Describe  . . . . . . . . . . . . . . . . . . . . .   124
  177.              9.4  Stat  . . . . . . . . . . . . . . . . . . . . . . .   125
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.              9.5  UpdateCrc . . . . . . . . . . . . . . . . . . . . .   125
  186.              9.6  BuildDataBase . . . . . . . . . . . . . . . . . . .   126
  187.              9.7  Purge . . . . . . . . . . . . . . . . . . . . . . .   126
  188.              9.8  SortFILES.BBS . . . . . . . . . . . . . . . . . . .   126
  189.              9.9  CompileRequestIdx . . . . . . . . . . . . . . . . .   127
  190.              9.10 ProcessTemplate . . . . . . . . . . . . . . . . . .   127
  191.  
  192.         10   HATCH  . . . . . . . . . . . . . . . . . . . . . . . . .   127
  193.              10.1 Command line mode . . . . . . . . . . . . . . . . .   127
  194.              10.2 Interactive mode  . . . . . . . . . . . . . . . . .   129
  195.  
  196.         11   CRC32  . . . . . . . . . . . . . . . . . . . . . . . . .   130
  197.  
  198.         12   Hints  . . . . . . . . . . . . . . . . . . . . . . . . .   130
  199.              12.1 Sample template files . . . . . . . . . . . . . . .   130
  200.              12.2 EAC utilities . . . . . . . . . . . . . . . . . . .   131
  201.              12.3 Hatching files without moving them  . . . . . . . .   131
  202.              12.4 Errorlevels . . . . . . . . . . . . . . . . . . . .   131
  203.                   12.4.1    Common errorlevels  . . . . . . . . . . .   132
  204.              12.5 Common errors while importing files . . . . . . . .   133
  205.              12.6 Using ALLFIX without a compatible (or no) BBS . . .   135
  206.              12.7 Creating a FILEBONE.?? file . . . . . . . . . . . .   135
  207.              12.8 Frequently asked questions  . . . . . . . . . . . .   136
  208.  
  209.         13   Development  . . . . . . . . . . . . . . . . . . . . . .   142
  210.  
  211.         14   Credits  . . . . . . . . . . . . . . . . . . . . . . . .   143
  212.  
  213.         15   Technical Specs  . . . . . . . . . . . . . . . . . . . .   146
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.         1    Introduction
  223.  
  224.         1.1  ALLFIX help and support
  225.  
  226.         The  ALLFIX_HELP  echomail  area  is   available  on  most  fidonet
  227.         backbones. The area is read and  moderated by the author and it  is
  228.         the  ideal   place  to  ask   questions  concerning   ALLFIX.  Each
  229.         registration site also carries the area. 
  230.  
  231.         It is  also possible  to receive  support by  sending  mail to  the
  232.         following fidonet address:
  233.  
  234.              2:281/415
  235.  
  236.         or to the following Internet address:
  237.  
  238.              support@allfix.com
  239.  
  240.         You can also find us on the Internet, at:
  241.  
  242.              www.allfix.com
  243.  
  244.         or
  245.  
  246.              ftp.allfix.com
  247.  
  248.         All replies  to crash  netmails sent  to 2:281/415 will  be put  on
  249.         hold within 48 hours  for the sender to pick up. If the replies are
  250.         not picked  up within  7 days, the  reply will  be sent  via normal
  251.         netmail to the sender. Other replies will be  routed immediately to
  252.         the sender. 
  253.  
  254.         It is  also possible to send  questions and problem reports  to the
  255.         following postal address:
  256.  
  257.              Harms Software Engineering
  258.              PO Box 175
  259.              2600 AD Delft
  260.              The Netherlands
  261.  
  262.  
  263.         1.2  What is ALLFIX?
  264.  
  265.         ALLFIX  was born in  1991 when  it introduced the  FileFind concept
  266.         which allows BBS  users to search for  files via echomail. As  time
  267.         progressed it slowly  began to develop  into a fileecho  processor.
  268.         A fileecho  processor is a  utility that distributes  files between
  269.         BBS systems.  Files are  actually sent  and recieved  by a  fidonet
  270.         style  mailer.  ALLFIX  then places  the  received  files into  the
  271.         proper BBS directories and sends the  files to all of the downlinks
  272.         who have subscribed to those file areas.
  273.  
  274.         Today,  ALLFIX is  perhaps  the  most complete  fileecho  processor
  275.         available. It  can process  .TIC files,  hatch new  files, generate
  276.         new file  reports based  on newly  received files  and on  uploaded
  277.  
  278.                                          5
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.         files, process  file  requests, and,  of  course, process  FileFind
  287.         requests.
  288.  
  289.         ALLFIX  is  accompanied  by  a  very  user  friendly  configuration
  290.         program  that makes the  installation process a  pleasure. The user
  291.         interface is modelled  after TosScan and  Gecho, which many  people
  292.         have grown accustomed to.
  293.  
  294.         This manual is for the following types of ALLFIX:
  295.  
  296.         ALLFIX for DOS, 
  297.         ALLFIX! for WildCat,
  298.         ALLFIX/2 for OS/2 Warp,  and 
  299.         ALLFIX Universal
  300.  
  301.         There are  some important differences between these three different
  302.         versions. The  changes will  be pointed  out whenever necessary  by
  303.         refering to ALLFIX,  ALLFIX!, ALLFIX/2, and  ALLFIX/U for the  four
  304.         different types,  respectively. Menu  options that are  specific to
  305.         one or two  versions of ALLFIX  will contain those  versions within
  306.         parenthesis  after the  menu name.  In the  following  example, the
  307.         text  (ALLFIX/2)  indicates that  the  "New  task" option  is  only
  308.         available in the ALLFIX/2 for OS/2 version.
  309.  
  310.         New Task (ALLFIX/2)
  311.  
  312.  
  313.         1.3  What is new in this version
  314.  
  315.         This  chapter contains a  list of  the more important  new features
  316.         that are new in version 5.00.
  317.  
  318.            * Ability to use all  different types of ALLFIX with  one set of
  319.              configuration files.
  320.  
  321.              It is possible  to enter all  the different  types of keys  in
  322.              ASETUP, and
  323.              It  is  possible  to   configure  DOS  and  OS/2   compression
  324.              programs.
  325.  
  326.            * Only one type  of keyfile for  all different types  of ALLFIX.
  327.              This means that the OS/2 version of ALLFIX  no longer uses its
  328.              own special .S2S file.
  329.  
  330.            * Ability to send files and mail via the Internet.
  331.  
  332.              This option makes  it possible to send mail and files encoded.
  333.              or  not, via the Internet  using many different email clients.
  334.              ALLFIX  can be used  as a  gateway to  send mail and  files to
  335.              another  part of  the world via  the Internet. It  can also be
  336.              used to send mail and files to someone on the Internet.
  337.  
  338.              ALLFIX also has the ability  to process file requests via  the
  339.              Internet.  Simply send  a message  to ALLFIX  somewhere on the
  340.              Internet,  and   receive  your   files,  uuencoded,   via  the
  341.              Internet.
  342.  
  343.                                          6
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.              Among the email clients supported by ALLFIX are:
  352.  
  353.              Eudora, PMMail,  PostRoad Mailer,  UUCP, SOUP, Net  Tamer, and
  354.              more!
  355.  
  356.            * Extra features for the request processor:
  357.  
  358.              PKT passwords for Binkley style systems,
  359.              Ability to specify maximum online time per file request,
  360.              Ability to send CC of file request report to the SysOp,
  361.              Smarter recompiling of REQUEST.IDX file for CD-ROM changers,
  362.              Lots of extra macros for the file request reports, and
  363.              Extra magic  filename type, SendOnFreq,  which can be  used to
  364.              send files or templates along with file requests.
  365.  
  366.            * Support for RAID style  flags. This feature makes it  possible
  367.              for ALLFIX to  create FILEBONE.?? style files,  using a simple
  368.              template.
  369.  
  370.            * Support for the following BBS programs:
  371.  
  372.              ShotGun,
  373.              Terminate BbS,
  374.              Magic BBS, and
  375.              PowerBBS.
  376.  
  377.            * Better support for the following BBS programs:
  378.  
  379.              For  RemoteAccess,  Terminate  BBS,  Lora  BBS,  and  ShotGun,
  380.              ALLFIX now  uses the actual  BBS file  area number as  used by
  381.              the BBS.  This  means that  when adding  new  file areas,  the
  382.              FileFind file areas or  the BBS new file  dirs do not have  to
  383.              be re-configured.
  384.  
  385.              File points for Renegade BBS.
  386.  
  387.              FILEAREA.FIX file  will automatically  be updated when  ALLFIX
  388.              or ASETUP thinks that it may be out of date.
  389.  
  390.            * The ability to  select more  than one file  area per entry  in
  391.              the BBS new file dirs menu.
  392.  
  393.            * The  ability to  select  the  file  areas  to  scan  for  each
  394.              FileFind area.
  395.  
  396.            * Enhanced auto-add routines for fileechos.
  397.  
  398.              Automatically  determine   fileecho   descriptions  from   the
  399.              FILEBONE.?? files.
  400.  
  401.              The group selected for  the new fileecho can now also be based
  402.              on the system where the fileecho came from.
  403.  
  404.         ALLFIX 5.0 has  many more features.  Please consult the  UPDATE.LOG
  405.         file for more details.
  406.  
  407.  
  408.                                          7
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.         1.4  Features
  417.  
  418.         This chapter contains  a list of some  of the features that  ALLFIX
  419.         offers. 
  420.  
  421.            * ALLFIX has  full  support for  RemoteAccess  (1.xx and  2.xx),
  422.              SuperBBS, QuickBBS,  Ezycom, Maximus, ProBoard,  PCBoard 15.xx
  423.              and any  conventional  FILES.BBS  style  BBS.  There  is  also
  424.              limited  support for  SpitFire, Telegard,    Renegade, TriBBS,
  425.              TAG, TBBS,  LoraBBS,  Synchronet BBS,  Concord  BBS,  ShotGun,
  426.              Terminate BBS, Magic BBS, and PowerBBS.
  427.  
  428.            * ALLFIX! for  WildCat! has full  support for the  WildCat! 4.xx
  429.              file and message database.
  430.  
  431.            * Full support for Zones, and 4D points.
  432.  
  433.            * Support for domains (5D addressing)
  434.  
  435.            * Ability to disable sending a .TIC file. 
  436.  
  437.            * Ability  to   pack  all  .TIC   files  with  or   without  the
  438.              accompanying file into one "TIC" archive.
  439.  
  440.            * ALLFIX  supports  the  FrontDoor/RemoteAccess  Hudson  Message
  441.              Base sharing specifications.
  442.  
  443.            * ALLFIX has direct  support for  the Hudson  message base,  JAM
  444.              message  base, *.MSG  message base,  Squish message  base, the
  445.              Ezycom message base,  the PCBoard message  base, and the  .PKT
  446.              interface.
  447.  
  448.            * ALLFIX!  has full support  for the  WildCat! message  base and
  449.              for the .PKT interface.
  450.  
  451.            * ALLFIX  has  full  support   for  the  new  FrontDoor   Static
  452.              Transmission Queue database, also known as STQ.
  453.  
  454.            * Support for  multiple compression  formats, such as  ARC, ARJ,
  455.              PAK,  LZH, ZIP, SQZ,  and up  to 4 user  definable compression
  456.              programs.
  457.  
  458.            * User friendly 'TosScan alike'  setup program. ALLFIX does  not
  459.              require any configuration files used by any other program. 
  460.  
  461.            * Writes    FrontDoor,    D'Bridge,   RemoteAccess,    SuperBBS,
  462.              BinkleyTerm, and Portal of Power compatible log file.
  463.  
  464.            * Full support for BinkleyTerm and Portal of Power.
  465.  
  466.            * Full support  for D'Bridge queue files (D'Bridge versions 1.53
  467.              and higher).
  468.  
  469.            * Full support for T-Mail file boxes.
  470.  
  471.            * Very HIGH quality performance, very LOW registration fee.
  472.  
  473.                                          8
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.         1.5  System Hardware and Software Requirements
  483.  
  484.         ALLFIX  for  DOS  and  for   WildCat!  have  the  following  system
  485.         requirements:
  486.  
  487.            * IBM PC, XT, AT or 100% compatible, with hard drive.
  488.  
  489.            * Microsoft MS-DOS or IBM PC-DOS 3.0 or higher.
  490.  
  491.            * At least "FILES=20" in the CONFIG.SYS
  492.  
  493.              A lower value can cause an "Out of file handles" error.
  494.  
  495.              A disk  cache (especially  one  that can  buffer disk  writes,
  496.              such as  Norton Cache  or HyperDisk) can  improve performance,
  497.              but,  of course, it  is not required.  If a disk  cache is not
  498.              being used, then the  line "BUFFERS=30" (or higher)  should be
  499.              added to the CONFIG.SYS to improve performance.
  500.  
  501.            * At least 460  KB of RAM  available. It is  also preferable  to
  502.              have  at least 700KB of EMS available. ALLFIX uses EMS for two
  503.              purposes. First, the  overlay file can be loaded into EMS, and
  504.              secondly,  it   swaps  itself  into  EMS  when  calling  other
  505.              programs, such as PKZIP.
  506.  
  507.            * At least one of the supported BBS systems.
  508.  
  509.            * For ALLFIX!, WildCat! 4.xx.
  510.  
  511.            * At  least one  of the  following compression  utilities: PKZIP
  512.              1.10, LHA 2.13, PKPAK, ARC, PAK, ARJ 2.00, or SQZ 1.0.
  513.  
  514.         ALLFIX for OS/2 has the following system requirements:
  515.  
  516.            * IBM 386 or higher, or 100% compatible, with hard drive.
  517.  
  518.            * IBM OS/2 version 2.1 or higher.
  519.  
  520.            * At least one of the supported BBS systems.
  521.  
  522.            * At  least one  of the  following compression  utilities: PKZIP
  523.              1.10, LHA 2.13,  PKPAK, ARC, PAK,  ARJ 2.00, SQZ  1.0, or  any
  524.              OS/2 equivalents.
  525.  
  526.         ALLFIX Universal has the following system requirements:
  527.  
  528.            * IBM 386 or higher, or 100% compatible, with hard drive.
  529.  
  530.            * An operating system or memory manager which  supports the DPMI
  531.              0.9 standard, such as one of the following:
  532.  
  533.              Windows 3.1x, 
  534.              Windows 95,
  535.              Windows NT,
  536.              OS/2 Warp,
  537.  
  538.                                          9
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.              Qualitas 386MAX and
  547.              Quarterdeck QEMM-386
  548.  
  549.            * At least one of the supported BBS systems.
  550.  
  551.            * At  least one  of the  following compression  utilities: PKZIP
  552.              1.10, LHA 2.13,  PKPAK, ARC,  PAK, ARJ 2.00,  SQZ 1.0, or  any
  553.              OS/2 equivalents.
  554.  
  555.  
  556.         1.6  License and Disclaimer
  557.  
  558.         "ALLFIX"   refers  to   all   executables   and  documentation   as
  559.         distributed  in  the  compressed  file  in  which the  package  was
  560.         released and on the installation disk.
  561.  
  562.            * ALLFIX is copyrighted material by Harms  Software Engineering.
  563.              It  may only be used in agreement  with the conditions set out
  564.              in this license agreement.
  565.  
  566.            * ALLFIX is released as shareware.
  567.  
  568.            * The  following  applies  to  all  persons  who can  afford  to
  569.              register ALLFIX:  you may use ALLFIX for  an evaluation period
  570.              of  one month.  After  this period  you  MUST either  register
  571.              ALLFIX or stop using it.
  572.  
  573.            * You must  register ALLFIX  if  you wish  to  make use  of  the
  574.              registered  features  which  are  denoted  by  a  {+}  in  the
  575.              configuration program.
  576.  
  577.            * ALLFIX may  be  distributed freely  provided no  money or  any
  578.              other compensation  is asked or accepted without prior written
  579.              permission from the author.
  580.  
  581.            * Although care has been taken to write  and test a program that
  582.              does  what this  document  states, ALLFIX  is provided  as is,
  583.              without warranty  or guarantee  of any kind,  either expressed
  584.              or  implied, as  to the  fitness for  a particular  purpose or
  585.              quality  or performance  of this  program, except  that ALLFIX
  586.              will occupy disk space.
  587.  
  588.            * In no event  shall Harms Software Engineering be liable to you
  589.              or  anyone else for  any damages  or cost, including,  but not
  590.              limited  to,  any lost  profits, lost  savings or  lost income
  591.              which may a result from the use or inability to use ALLFIX.
  592.  
  593.            * In no way  is Harms Software  Engineering obligated to  you or
  594.              anyone  else to  provide future  versions of,  or support  for
  595.              ALLFIX.
  596.  
  597.            * Harms Software Engineering reserves  the right not to  release
  598.              future  shareware  versions  of   ALLFIX,  but  switch  to   a
  599.              commercial "buy before you try" marketing concept.
  600.  
  601.            * Your  use of ALLFIX constitutes your agreement to this license
  602.  
  603.                                         10
  604.  
  605.  
  606.  
  607.  
  608.  
  609.  
  610.  
  611.              and disclaimer and  your release of  the author from  any form
  612.              of liability or litigation.
  613.  
  614.            * If you are currently using  an unregistered version of ALLFIX,
  615.              then you are asked to  make a small advertisement for  ALLFIX,
  616.              in the login procedure for your BBS system.
  617.  
  618.  
  619.         2    Registrations
  620.  
  621.         The ALLFIX package  represents over 70,000 lines of source code and
  622.         countless hours of hard work. 
  623.  
  624.         ALLFIX is  released under  the shareware  concept. This  means that
  625.         you  are allowed to use  ALLFIX for a  trial period of  30 days. If
  626.         you want to continue  using ALLFIX after  the 30 day trial  period,
  627.         you are required to register the program. 
  628.  
  629.         A  number of  features in  ALLFIX only  become available  after you
  630.         have  registered the  program. These  features are  identified with
  631.         the  string "{+}"  after their  help descriptions  in  ASETUP. This
  632.         manual  will also mention  when an  option is only  available after
  633.         registering.
  634.  
  635.         To  register, file  request ALLFIX.REG  from the  registration site
  636.         nearest   you.  Fill  out  the  form   and  send  it  back  to  the
  637.         registration site  along  with  the  necessary  payment.  The  file
  638.         REGISTER.HOW  contains  more  information  about  the  registration
  639.         process and a list of all the registration sites. 
  640.  
  641.  
  642.         3    FidoNet Technology
  643.  
  644.         3.1  Network structure
  645.  
  646.         FidoNet  is  the  largest  amateur network  in  the  world.  It was
  647.         started in 1984 by Tom  Jennings. Currently more than 35,000  nodes
  648.         worldwide  are connected.  The network  has  a hierarchic  tree (or
  649.         star) topology:
  650.  
  651.                                                                 
  652.         +------------------------------+---------------------->
  653.                       |                              |
  654.                     zone 1                         zone 2
  655.                       |                              |
  656.              +--------+--------+            +--------+--------+
  657.              |        |        |            |        |        |
  658.            region   region   region       region   region   region
  659.              |        |        |            |        |        |
  660.           +--+--+     |     +--+--+     +---+---+    |     +--+--+
  661.           |     |     |     |     |     |   |   |    |     |     |
  662.          net   net   net   net   net   net net net  net   net   net
  663.                             |
  664.                       +-----+-----+
  665.                       |     |     |
  666.                     node  node  node
  667.  
  668.                                         11
  669.  
  670.  
  671.  
  672.  
  673.  
  674.  
  675.  
  676.                      |
  677.                  +---+---+
  678.                  |       |
  679.                point   point
  680.  
  681.         Zones are divided in Regions,  which are divided in Nets.  The Nets
  682.         consist of  Nodes, which are usually (but not necessarily) Bulletin
  683.         Board  Systems. Each node  has a  unique address which  consists of
  684.         four  parts: Zone, Net,  Node and Point, in  text form expressed as
  685.         "zone:net/node.point". Zone numbers  1 up  to and  including 6  are
  686.         used by FidoNet:
  687.  
  688.         1 = North America (United States of America and Canada)
  689.         2 = Europe and Commonwealth of Independent States
  690.         3 = Oceania (Australia and New Zealand)
  691.         4 = Latin America
  692.         5 = Africa
  693.         6 = Asia
  694.  
  695.         There  are several other  networks that use  FidoNet Technology and
  696.         which occupy higher zone numbers (such as SIGnet, zones 24-29). 
  697.  
  698.         Many  nodes have one  or more points.  A point  is a user  who gets
  699.         mail from  a node (its "boss")  in compressed files. That  way they
  700.         can  read and write  messages offline,  saving time and  money. The
  701.         point  address of the  boss is 0,  but the ".0"  is usually omitted
  702.         from the address.
  703.  
  704.  
  705.         3.2  Mail transfer and the FileFind system
  706.  
  707.         The FileFind system offers people  the ability to search for  files
  708.         via echomail by  writing messages addressed  to the name  "ALLFIX",
  709.         without  quotes.  The  files,  file  specifications,  and  keywords
  710.         (preceded by  a '/') are  placed on  the subject line.  The message
  711.         body may be left empty.
  712.  
  713.         ALLFIX will  scan  the configured  message  areas and  process  all
  714.         FileFind  requests. It  will scan  the BBS  file  areas and  if any
  715.         matches are found, it will write a reply in the appropriate area.
  716.  
  717.         Since the FileFind  requests are sent via echomail, one request may
  718.         receive multiple replies.  One problem with this system is that the
  719.         flow of mail  may easily get out  of hand. ALLFIX  has a number  of
  720.         features to  reduce the  amount of  mail. First,  no  more than  15
  721.         files will be included  in a reply. Second,  it has the ability  to
  722.         ignore any  local  FileFind  requests.    Third,  ALLFIX  will  not
  723.         process  FileFind requests  that contain  less than  4 non-wildcard
  724.         characters (ie. characters  other than the '?'  and '*' wildcards).
  725.         Lastly, ALLFIX  has the  ability to  ignore FileFind  requests that
  726.         are older than the configured number of days.
  727.  
  728.         To facilitate searching for  files, ALLFIX supports two  elementary
  729.         boolean operators; AND  and OR. These operators may be used between
  730.         filespecs and keywords. 
  731.  
  732.  
  733.                                         12
  734.  
  735.  
  736.  
  737.  
  738.  
  739.  
  740.  
  741.         Ex. /SOUND AND /32bit
  742.  
  743.         In  the previous example,  ALLFIX will  search for files  that have
  744.         both the keyword SOUND and the keyword 32bit in the description.
  745.  
  746.         Ex. /SOUND AND /32bit OR /SOUNDBLASTER
  747.  
  748.         In  the previous  example, ALLFIX  will search  for files  with the
  749.         keyword SOUND and the keyword 32bit in the  description, or for any
  750.         files with the keyword /SOUNDBLASTER in the description.
  751.  
  752.         Sometimes  a keyword may contain  the special character "/". ALLFIX
  753.         will normally  interpret  that as  a  special character  signalling
  754.         that the  rest  of the  text  entered is  a  keyword. In  order  to
  755.         prevent  ALLFIX from  doing that,  the keyword  can be  enclosed in
  756.         double quotes.  For example, when  searching for the  keyword OS/2,
  757.         it should  be specified  as "OS/2" and  not as  /OS/2 which may  be
  758.         interpreted incorrectly by ALLFIX.
  759.  
  760.  
  761.         4    Fileechos and Magic files
  762.  
  763.         4.1  Fileechos explained
  764.  
  765.         The files that  are received and  sent along the  network structure
  766.         are  organized  in  areas,  called  fileechos,  much  the  same  as
  767.         messages  are organized  in echomail  areas. Files  are received by
  768.         one system and "echoed" to other systems.
  769.  
  770.         Each fileecho  has a  name, referred  to as  the "tag". Locally,  a
  771.         fileecho also  has a  large number  of other  options, such  as the
  772.         directory where files belonging to this fileecho  are stored (think
  773.         of messages areas for echomail areas). 
  774.  
  775.         Each  file passed  along in  a fileecho  is accompanied  by a  .TIC
  776.         file. This is  a small ASCII text file containing information about
  777.         the associated file,  such as  the fileecho  tag, the  description,
  778.         and the address where the file came from.
  779.  
  780.         Following is a sample .TIC file:
  781.  
  782.         Area FNEWS
  783.         Origin 2:281/415
  784.         From 2:281/415
  785.         To 2:281/4
  786.         Replaces FNEWS*.*
  787.         File FNEWS931.ZIP
  788.         Desc Fidonet Newsletter
  789.         Crc FE5B85F3
  790.         Created by ALLFIX+ v4.30 Copyright (C) 1992,93,94 Harald Harms
  791.         Path 2:281/910 709582560 Thr May 5 21:00:00 1994 UTC+0100
  792.         Seenby 2:281/415
  793.         Seenby 2:281/1
  794.         Seenby 2:281/2
  795.         Seenby 2:281/3
  796.         Seenby 2:281/4
  797.  
  798.                                         13
  799.  
  800.  
  801.  
  802.  
  803.  
  804.  
  805.  
  806.         Seenby 2:281/5
  807.         Seenby 2:281/6
  808.         Seenby 2:281/7
  809.         Seenby 2:281/8
  810.         Seenby 2:281/9
  811.         Pw WOW
  812.  
  813.         The first word  on each line in  the .TIC file is called  the verb.
  814.         The meaning of the verbs will be explained in the next section.
  815.  
  816.  
  817.         4.1.1     TIC file verbs
  818.  
  819.         Following is a description of what each TIC verb means.
  820.  
  821.         Area
  822.  
  823.              The fileecho tag.
  824.  
  825.         Areadesc
  826.  
  827.              The description for this particular  fileecho. This particular
  828.              verb  is currently  only supported  by ALLFIX.  When fileechos
  829.              are  automatically  added,  ALLFIX  will  use the  description
  830.              following this verb for the new fileecho.
  831.  
  832.         Desc
  833.  
  834.              The description of  the file. Some other programs may add more
  835.              than one  description  line  to the  .TIC  file.  ALLFIX  will
  836.              append any extra description lines to the first one.
  837.  
  838.         Ldesc
  839.  
  840.              The long description  of the file. This  particular command is
  841.              currently  only  supported by  ALLFIX  and  FileMgr. The  long
  842.              description  is usually a more detailed  version of the normal
  843.              description and normally consists of several lines.
  844.  
  845.         Origin
  846.  
  847.              The network address of the system that hatched this file.
  848.  
  849.         From
  850.  
  851.              The system where this file was received from.
  852.  
  853.         To
  854.  
  855.              This field  indicates who the .TIC  file is for.  This verb is
  856.              currently  only   supported  by  ALLFIX.  This  verb  is  only
  857.              included in  the .TIC file when  the file is being  routed via
  858.              another  system. The  presence of  this verb  prevents another
  859.              ALLFIX from  processing  a .TIC  file if  it  is destined  for
  860.              another system.  Only if this  verb is not  present or if  the
  861.              address following it  belongs to the current system,  will the
  862.  
  863.                                         14
  864.  
  865.  
  866.  
  867.  
  868.  
  869.  
  870.  
  871.              .TIC file be processed.
  872.  
  873.         Crc
  874.  
  875.              The 32-Bit Crc of  the file. This field  is used to check  the
  876.              integrity of the file. ALLFIX,  by default, checks the Crc  of
  877.              all incoming  files.  The -NoCrc  switch can  be  used on  the
  878.              commandline to force ALLFIX to not check the Crc. 
  879.  
  880.         Replaces
  881.  
  882.              The  file specification that this  new file should replace. If
  883.              enabled, ALLFIX will  remove all the files that match the file
  884.              specification  before importing the current file. For example,
  885.              if the .TIC file contains the following line:
  886.  
  887.              Replaces NODEDIFF.A12
  888.  
  889.              then ALLFIX  will remove the  file NODEDIFF.A12 from  the file
  890.              database and delete  the actual file before importing  the new
  891.              file. This  feature is  handy for new  software updates.  Care
  892.              should be  taken  since  it  possible  to  include  wildcards.
  893.              ALLFIX will, by default, ignore  this verb, unless the  option
  894.              has been turned on in the fileecho configuration.
  895.  
  896.         Magic
  897.  
  898.              The  magic name  that should  be updated  in the  mailer alias
  899.              file.  ALLFIX will add  the current  file with the  magic name
  900.              following  this verb  to  the  alias file  to  allow for  file
  901.              requests.
  902.  
  903.         Created
  904.  
  905.              This command  is used to  add information about  which program
  906.              created this TIC file.
  907.  
  908.         Path
  909.  
  910.              This  extra line is  added by  each system that  has processed
  911.              this  file. This line  contains the  unix date, a  normal time
  912.              and date stamp, and the  address of the system that  processed
  913.              the  file. The path  lines can  be used  to determine  how the
  914.              file arrived its current destination.
  915.  
  916.         Seenby
  917.  
  918.              This line indicates that  the corresponding system has  'seen'
  919.              the associated  file.  A .TIC  file  usually contains  several
  920.              Seenby lines.  ALLFIX  will not  forward files  to any  system
  921.              already in  the seenby listing. ALLFIX will  display a warning
  922.              if  a system  in the  systems list  is already  in the  seenby
  923.              list, making it easier to detect loops in file nets.
  924.  
  925.         Pw
  926.  
  927.  
  928.                                         15
  929.  
  930.  
  931.  
  932.  
  933.  
  934.  
  935.  
  936.              The password  for this particular  system. If the  password is
  937.              missing  or incorrect, then  ALLFIX will refuse  to import the
  938.              file.
  939.  
  940.  
  941.         4.1.2     TIC archive packages
  942.  
  943.         Each time a file is forwarded in a fileecho, a new netmail  message
  944.         is  created with  the appropriate  file attach.  Large systems will
  945.         quickly have  problems with too  many netmail messages  slowing the
  946.         system down. 
  947.  
  948.         ALLFIX is  capable of  compressing all  the forwarded files  and/or
  949.         the .TIC files  for a system into  one archive. The advantages  are
  950.         that only one  file is sent to a  system which means that  only one
  951.         netmail with a file attach is required.
  952.  
  953.         Because  TIC archive packages  can grow  to be quite  large, ALLFIX
  954.         has  the ability to set the maximum  size of such a package. When a
  955.         TIC   archive   approaches   this   maximum   size,   ALLFIX   will
  956.         automatically create a new archive.
  957.  
  958.         The naming convention  that ALLFIX uses for TIC archive packages is
  959.         as follows:
  960.  
  961.         The first  eight  digits  of the  filename  are  used to  code  the
  962.         destination  system's  node number.  ALLFIX  can  calculate a  name
  963.         based  on the node number, but it  is not possible to determine the
  964.         system's node number based  on the filename of the TIC archive. The
  965.         extension of  the  TIC  archive filename  always  begins  with  the
  966.         letter  "C" and ends with two digits.  The two digits are follow up
  967.         numbers. In some situations, more than one TIC archive needs  to be
  968.         created  per  system.  In  that case,  the  follow  up  numbers are
  969.         incremented. The system  has an added benefit that if two identical
  970.         TIC  archives arrive  at  a system,  the  mailer may  automatically
  971.         increment the last character of  the filename, in order to  prevent
  972.         the original  file from being  over-written. In the  case of  a TIC
  973.         archive, following  the  ALLFIX naming  convention,  the follow  up
  974.         number is  incremented, which does not affect ALLFIX in any way. If
  975.         the filename was  based on the  older naming convention,  one would
  976.         end  up with  file  names that  were no  longer  recognized as  TIC
  977.         archives.
  978.  
  979.         ALLFIX will also automatically  unpack the file ALLTICS.xxx  (where
  980.         xxx is a number). This file contains .TIC files and  is used in the
  981.         Planet Connect file distribution network.
  982.  
  983.  
  984.         4.2  Magic filenames explained
  985.  
  986.         The  magic filename system is a powerful  tool that allows the user
  987.         to  perform  specific  tasks when  certain  files  are  received in
  988.         certain fileechos.  ALLFIX  has a  large  number of  pre-configured
  989.         tasks  and  one  of  them  allows  external  DOS  utilities  to  be
  990.         executed, making it possible to do almost anything.
  991.  
  992.  
  993.                                         16
  994.  
  995.  
  996.  
  997.  
  998.  
  999.  
  1000.  
  1001.         One example of  a possible use for magic filenames is automatically
  1002.         processing  new node editfiles or new nodelists. The magic filename
  1003.         system can be  configured to call  up batch  file that will  unpack
  1004.         the  files and  call  up the  nodelist processor  each time  one of
  1005.         those files is received.
  1006.  
  1007.         All the different features are  explained in the section about  the
  1008.         magic filename manager.
  1009.  
  1010.  
  1011.         5    FCOMP
  1012.  
  1013.         FCOMP is a  utility that compiles BBS file area configurations into
  1014.         a format that ALLFIX  can read. FCOMP is not necessary  for ALLFIX!
  1015.         for  WildCat, since this type only  supports one BBS. It was stated
  1016.         earlier that  ALLFIX does  not need  configuration  files from  any
  1017.         other program. ALLFIX  will function properly without  the BBS file
  1018.         area information, however, a  number of features are  not available
  1019.         unless FCOMP has been run. 
  1020.  
  1021.         The BBS file area information is used for three things:
  1022.  
  1023.            - FileFind replies require that the  BBS file areas are  scanned
  1024.              for files. 
  1025.  
  1026.            - New file reports  for new files  uploaded to your  BBS require
  1027.              that the BBS file areas are scanned for new files.
  1028.  
  1029.            - If the  BBS  system does  not use  a  FILES.BBS file  database
  1030.              system, then ALLFIX needs to  be able to determine which  file
  1031.              area needs to be updated when a file is being imported.
  1032.  
  1033.         The  advantage of using  an external  compiler is that  support for
  1034.         other BBS  programs  can sometimes  be added  by  simply making  an
  1035.         update of FCOMP as opposed to releasing a new version of ALLFIX.
  1036.  
  1037.         FCOMP  creates a file  called FILEAREA.FIX  which is stored  in the
  1038.         system directory. The information  stored in FILEAREA.FIX needs  to
  1039.         be updated  when changes are made to the file area configuration in
  1040.         the BBS. Running  FCOMP multiple times  will not affect  the ALLFIX
  1041.         configuration unless areas, needed by ALLFIX, are  removed from the
  1042.         BBS configuration.  Adding areas in the BBS  configuration will not
  1043.         require any maintenance in the ALLFIX configuration.
  1044.  
  1045.  
  1046.         5.1  Command line options
  1047.  
  1048.         FCOMP requires two command line options.
  1049.  
  1050.         The first  option  is the  number associated  with  the BBS  system
  1051.         used.
  1052.  
  1053.            0 RemoteAccess 1.11
  1054.            1 SuperBBS
  1055.            2 QuickBBS
  1056.            3 Maximus 2.0x
  1057.  
  1058.                                         17
  1059.  
  1060.  
  1061.  
  1062.  
  1063.  
  1064.  
  1065.  
  1066.            4 Ezycom
  1067.            5 ProBoard
  1068.            6 RemoteAccess 2.xx
  1069.            7 Renegade* 4.16
  1070.            8 PCBoard 15.xx
  1071.            9 SpitFire*
  1072.           10 Telegard* 2.17
  1073.           11 TriBBS*
  1074.           12 EzyCom 1.10
  1075.           13 Tag
  1076.           14 Renegade* v04-05
  1077.           15 RemoteAccess 2.5x/EleBBS
  1078.           16 SearchLight* (Not available in ALLFIX/2)
  1079.           17 TBBS*  (Specify path  and filename of file  area configuration
  1080.              file)
  1081.           18 LoraBBS 2.40*
  1082.           19 Telegard 3.0
  1083.           20 TriBBS 10.x*
  1084.           21 SynchroNet BBS 2.x*
  1085.           22 Maximus 3.0x
  1086.           23 Concord 0.01 gamma 3
  1087.           24 QuickBBS 2.76
  1088.           25 ShotGun Professional 1.38
  1089.           26 Terminate BBS
  1090.           27 Magic BBS
  1091.           28 PowerBBS
  1092.           29 AdeptXBBS 1.11+ (Only available in ALLFIX/2 and ALLFIX/U)
  1093.           30 BBBS* (FCOMP will process all filedirg.??? files)
  1094.           31 Tornado BBS
  1095.           32 Telegard BBS 3.10
  1096.  
  1097.           255 Scan fileechos
  1098.           
  1099.         The  second  option that  FCOMP  needs  is  the  path  to  the  BBS
  1100.         configuration files.  This second  parameter is not  necessary when
  1101.         you choose to scan the fileechos.
  1102.  
  1103.         Example: FCOMP 0 C:\RA
  1104.  
  1105.  
  1106.         
  1107.          * Note:     ALLFIX only has support for  the file systems for these BBS systems.
  1108.                      There is no support for the message base systems.
  1109.  
  1110.  
  1111.         Please consult the  section 12.6 for  information about how  to use
  1112.         ALLFIX with a BBS system that is not supported.
  1113.  
  1114.         It  should be  noted  that ALLFIX  can detect  file sizes  and file
  1115.         dates  in text  based  file  database  files.  For  example,  if  a
  1116.         particular  BBS uses standard  FILES.BBS files, then  the file size
  1117.         and  the file  date are  not included  in the  FILES.BBS  files. It
  1118.         could be  possible that the system  has a number of  CD-ROMs online
  1119.         for which  the FILES.BBS  files use  a different structure,  namely
  1120.         one where the  file size is  included in the  list. When reading  a
  1121.         description from the FILES.BBS files, the file size  would normally
  1122.         become part of  the description since  it was not  expected. ALLFIX
  1123.  
  1124.                                         18
  1125.  
  1126.  
  1127.  
  1128.  
  1129.  
  1130.  
  1131.  
  1132.         is capable of recognizing  this and will skip the file size and the
  1133.         file data fields if they are present.
  1134.  
  1135.         Special considerations for ProBoard:
  1136.  
  1137.         If  the  BBS system  used  is ProBoard,  ALLFIX  will automatically
  1138.         update the  UPLOAD.LOG file which  is maintained by  ProBoard. This
  1139.         file  is located in  the ProBoard  system directory and  contains a
  1140.         list of all of the uploaded files, who uploaded them, and when.
  1141.  
  1142.  
  1143.         6    ASETUP
  1144.  
  1145.         6.1  Installation
  1146.  
  1147.         ALLFIX should be  kept in a separate directory.  In this manual, we
  1148.         will assume that ALLFIX is located in C:\ALLFIX. 
  1149.  
  1150.         It  is recommended  that the  ALLFIX directory  be included  in the
  1151.         path statement.
  1152.  
  1153.         Example:  SET PATH=C:\FD;C:\GECHO;C:\RA;C:\ALLFIX
  1154.  
  1155.         Using  a  path  statement,  ensures  that  the  executables  can be
  1156.         started  up  from   anywhere  in  the  system.  In  order  for  the
  1157.         executables  to  be  able  to find  the  configuration  files,  the
  1158.         following  line should be  added to  the AUTOEXEC.BAT file,  or the
  1159.         CONFIG.SYS file for OS/2 systems:
  1160.  
  1161.              SET ALLFIX=C:\ALLFIX
  1162.  
  1163.         Copy  the  following  files   from  the  distribution  package   to
  1164.         C:\ALLFIX.
  1165.  
  1166.         ALLFIX.EXE, ALLFIX.OVR
  1167.  
  1168.              The main  program. It  is responsible for  processing FileFind
  1169.              requests, TIC  files, and  magic filenames. ALLFIX/2  for OS/2
  1170.              and ALLFIX Universal do not have any .OVR files.
  1171.  
  1172.         ASETUP.EXE, ASETUP.OVR
  1173.  
  1174.              This   is  the   program  used  to   create  and   update  the
  1175.              configuration files for ALLFIX.
  1176.  
  1177.         BAKE.EXE
  1178.  
  1179.              This is the program used to create new COOKIE  files which can
  1180.              be used in the new file report system which will be  explained
  1181.              later.
  1182.  
  1183.         COOKIE.EXE
  1184.  
  1185.              This is the program that  generated a random cookie, from  the
  1186.              COOKIE file.
  1187.  
  1188.  
  1189.                                         19
  1190.  
  1191.  
  1192.  
  1193.  
  1194.  
  1195.  
  1196.  
  1197.         HATCH.EXE
  1198.  
  1199.              This is the external utility to hatch files.
  1200.  
  1201.         SCRAMBLE.EXE
  1202.  
  1203.              This is the utility to select random COOKIE files.
  1204.  
  1205.         CRC32.EXE
  1206.  
  1207.              This is a utility that can  be used to calculate a 32 bit  CRC
  1208.              for a file.
  1209.  
  1210.         FCOMP.EXE
  1211.  
  1212.              This  is  the   utility  for  creating  the    BBS  file  area
  1213.              configuration file  to be  used with  ALLFIX. This utility  is
  1214.              only  included with  ALLFIX, ALLFIX/2,  and ALLFIX/U.  ALLFIX!
  1215.              does not need this utility.
  1216.  
  1217.         FIXUTIL.EXE
  1218.  
  1219.              This is the ALLFIX maintenance utility.
  1220.  
  1221.         UPDATE.EXE
  1222.  
  1223.              This is the update  utility that can  be used to update  older
  1224.              versions of ALLFIX to the current version.
  1225.  
  1226.         ????????.SCS
  1227.  
  1228.              The registered version of ALLFIX  needs a valid key file.  The
  1229.              keyfile   contains   information   about   every    officially
  1230.              registered user. 
  1231.         6.2  Starting the Program
  1232.  
  1233.         ALLFIX  needs to be configured using  ASETUP before it can be used.
  1234.         ASETUP will  look  for  the  configuration  files  in  the  current
  1235.         directory.  If the  files do  not exist  in the  current directory,
  1236.         then it will look  for those files in  the directory pointed to  by
  1237.         the environment variable. The first  time that ASETUP is run,  none
  1238.         of the configuration  files will be  found. ASETUP will  prompt the
  1239.         user  if the files  should be  created. If  the user  selects 'Yes'
  1240.         then  new  configuration  files  will  be  generated  with  default
  1241.         settings for some of the options.
  1242.  
  1243.         The  directory where SETUP.FIX  is found is  considered the "system
  1244.         directory" where the rest of  the configuration files will also  be
  1245.         stored.
  1246.  
  1247.         When  ALLFIX, ASETUP,  or HATCH  run they  create a  semaphore file
  1248.         called ALLFIX.BSY  which indicates that  one of the  three programs
  1249.         is busy.  ALLFIX/2 does  not make  a physical  file, but  creates a
  1250.         named  semaphore. Neither  of these  three programs  will run  if a
  1251.         semaphore exists.  If ALLFIX, ALLFIX!,  or ALLFIX/U crash  during a
  1252.         session,   it  is  possible  that  the  sempahore  remains  on  the
  1253.  
  1254.                                         20
  1255.  
  1256.  
  1257.  
  1258.  
  1259.  
  1260.  
  1261.  
  1262.         harddrive.  This means that  the program  will not start  up again,
  1263.         until that file has been  manually removed. ALLFIX/2 does not  have
  1264.         this  problem since  OS/2 will  automatically remove  the semaphore
  1265.         when the program ends.
  1266.  
  1267.  
  1268.         6.2.1     Keys
  1269.  
  1270.         ASETUP uses pop-up menus. The  cursor up and down keys can  be used
  1271.         to move the menu  bar up and down. Menu  items can be activated  by
  1272.         pressing the  Enter key.  The Esc  key  will always  return to  the
  1273.         previous  menu. In  some situations  ASETUP will  first ask  if the
  1274.         current changes  should be saved  before returning to  the previous
  1275.         menu.  In those  situations, the  F9 and  F10 function  keys can be
  1276.         used  to abort  the  changes  or  save the  changes,  respectively,
  1277.         without prompting the user.
  1278.  
  1279.         The last line on the screen will contain  useful help about the use
  1280.         of the selected function or help on keys that can be used. 
  1281.  
  1282.  
  1283.         6.2.2     Selecting entries from a list
  1284.  
  1285.         Many times a selection needs  to be made from a list,  for example,
  1286.         selecting a fileecho  from a list  of all the  configured fileechos
  1287.         or  selecting a template  from the  list of all  available template
  1288.         files. In these  situations, the Enter  key can be  used to make  a
  1289.         selection and  the Esc  key  can be  used  to abort  the  selection
  1290.         process. To  search for  an entry,  simply enter a  portion of  the
  1291.         text to  search for. After the  first key letter has  been entered,
  1292.         an edit  field will appear  at the bottom  of the screen  where the
  1293.         rest of the text to search for can be entered. Hitting return  will
  1294.         cause ASETUP to search for  the first entry containing the  entered
  1295.         text. Hitting  Ctrl-Return will instruct  ASETUP to search  for the
  1296.         first entry  beginning with the  entered text. The  search routines
  1297.         are not case sensitive.
  1298.  
  1299.  
  1300.         6.2.3     Online help
  1301.  
  1302.         ASETUP  contains   context  sensitive  online  help  which  can  be
  1303.         activated by pressing the F1 function key. 
  1304.  
  1305.         ALLFIX, ALLFIX!, and ALLFIX/U:
  1306.  
  1307.         ASETUP  makes use  of  the ALLFIX.DOC  documentation  file and  the
  1308.         AF_DOC.IDX  file  for the  online  help.  ASETUP  will display  the
  1309.         appropriate  section  of  the   documentation  when  the  help   is
  1310.         activated. If there  is no specific help for the currently selected
  1311.         option,   then   ASETUP  will   display   the   beginning  of   the
  1312.         documentation.
  1313.  
  1314.         Once  the help  has been  activated,  the 'F'  key can  be used  to
  1315.         search for  a string in the documentation,  and the F3 function key
  1316.         can be used to  repeat the search. These  keys are the same as  for
  1317.         the program LIST, which is a  well known program for viewing  ASCII
  1318.  
  1319.                                         21
  1320.  
  1321.  
  1322.  
  1323.  
  1324.  
  1325.  
  1326.  
  1327.         files.
  1328.  
  1329.         ALLFIX/2:
  1330.  
  1331.         ASETUP makes  use  of the  ALLFIX.INF  documentation file  for  the
  1332.         online  help. ASETUP will  display the  appropriate section  of the
  1333.         documentation when the help is  activated. If there is no  specific
  1334.         help for  the currently selected  option, then ASETUP  will display
  1335.         the table of contents.
  1336.  
  1337.  
  1338.         6.2.4     Selecting message areas
  1339.  
  1340.         Message  areas need  to  be  selected in  several  portions of  the
  1341.         configuration program. ALLFIX  supports several different types  of
  1342.         message  bases. The  type  of  message  base  can  be  selected  by
  1343.         pressing Enter on  the format field. Depending on the format, there
  1344.         will be either one or two other fields that need to be configured.
  1345.  
  1346.         For each message base:
  1347.  
  1348.         Hudson
  1349.  
  1350.              A board number between 1  and 200 needs to be entered  for the
  1351.              hudson message base.  A value of zero will disable the option.
  1352.              Not available in ALLFIX!.
  1353.  
  1354.         Pkt
  1355.  
  1356.              An echotag has  to be configured for the Pkt interface. ALLFIX
  1357.              will write the .PKT files  in the directory configured in  the
  1358.              pathnames (part  1)  menu (section  6.3.2).  An empty  echotag
  1359.              will disable the option.
  1360.  
  1361.         *.MSG
  1362.  
  1363.              A path needs to be defined for the *.MSG  message base. Please
  1364.              note  that  this refers  to  an  echomail area  and  NOT  to a
  1365.              netmail area!! The  last option, which can be selected in some
  1366.              of the  menus  is Netmail,  which does  refer  to the  netmail
  1367.              folder. Not Available in ALLFIX!.
  1368.  
  1369.         Ezycom
  1370.  
  1371.              A board number between 1 and 1024 needs  to be entered for the
  1372.              Ezycom message base.  A value of zero will disable the option.
  1373.              Not available in ALLFIX!.
  1374.  
  1375.         Squish
  1376.  
  1377.              A  name needs to  be configured  for the Squish  message base.
  1378.              The name  must include the path  and name of the  message base
  1379.              without the extension. An empty  name will disable the option.
  1380.              If an echotag is included  and the echotoss filename has  been
  1381.              configured  (see Filenames  menu, section  6.3.4) then  ALLFIX
  1382.              will  append an entry  to the  echotoss log when  messages are
  1383.  
  1384.                                         22
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.  
  1391.  
  1392.              written to this message base. Not available in ALLFIX!
  1393.  
  1394.         JAM
  1395.  
  1396.              A name needs to  be configured for  the JAM message base.  The
  1397.              name must  include the path and  the name of  the message base
  1398.              without the  extension. An empty name will disable the option.
  1399.              If an echotag is included  and the echotoss filename has  been
  1400.              configured  (see Filenames  menu, section  6.3.4)  then ALLFIX
  1401.              will  append an entry  to the  echotoss log when  messages are
  1402.              written to this message base. Not available in ALLFIX!.
  1403.  
  1404.         PCBoard
  1405.  
  1406.              A name needs  to be configured  for the PCBoard  message base.
  1407.              The  name must include  the path and  the name of  the message
  1408.              base without  the extension.  An empty  name will disable  the
  1409.              option. Not available in ALLFIX!
  1410.  
  1411.         Netmail
  1412.  
  1413.              No extra  options  need to  be configured  if  this option  is
  1414.              selected. Please note that this  option cannot be selected  in
  1415.              every menu.
  1416.  
  1417.         WildCat!
  1418.  
  1419.              A conference number between 1  and 64000 needs to be  entered.
  1420.              ALLFIX!  is not  capable of  writing  to conference  number 0.
  1421.              ALLFIX! considers  a 0  as an empty  field, which  effectively
  1422.              disables  the   option.  This  option  is  only  available  in
  1423.              ALLFIX!.
  1424.  
  1425.         Internet
  1426.  
  1427.              The  email address  to which  the messages  should be written.
  1428.              This feature is  most usefull when using it in conjuntion with
  1429.              a  list server  to  send,  for example,  new  file reports  to
  1430.              groups of people.
  1431.  
  1432.  
  1433.         6.2.5     Selecting template files
  1434.  
  1435.         The purpose of  template files will  be explained in  section 6.14.
  1436.         In  several  menus a  template  file can  or  must  be selected  by
  1437.         pressing  the Enter  key  on the  desired  template file.  Template
  1438.         files  can  be viewed  by  hitting  the 'V'  key  when the  desired
  1439.         template  is highlighted.  A template  file type  must  be selected
  1440.         before one can be viewed. Template files can be edited by  pressing
  1441.         the 'E' key. If an  external editor has been defined  (See External
  1442.         programs menu), ASETUP  will call up  the external editor.  You can
  1443.         still force ASETUP  to call up the internal editor  by hitting ALT-
  1444.         E. New template files can be added to the list by  pressing the Ins
  1445.         key and  then entering the name of  the new template file. Existing
  1446.         template files can be deleted by pressing the Del key.
  1447.  
  1448.  
  1449.                                         23
  1450.  
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456.  
  1457.         6.2.6     Internal text editor
  1458.  
  1459.         The  editor  is  a  simple ASCII  file  editor  that  supports most
  1460.         wordstar key  sequences.  The  Esc key  can  be  used to  exit  the
  1461.         editor. The  F2 key can be used to display  a list of commands that
  1462.         can  be used in the template file. The F3 key can be used to import
  1463.         another text file. The  F9 and F10  keys can be  used to abort  and
  1464.         save the changes, respectively.
  1465.  
  1466.         In some  of the fields  in ASETUP, a  filename can be  entered. For
  1467.         those  fields, it is possible to edit the filename, by pressin ALT-
  1468.         E. ASETUP will then, automatically, call up the editor.
  1469.  
  1470.  
  1471.         6.2.7     Editing system lists
  1472.  
  1473.         Downlink  systems need to  be selected  in several portions  of the
  1474.         configuration program. The Ins key  can be used to add a  system to
  1475.         the list  and the Del  key can be used  to remove one.  The menu to
  1476.         add  or edit a  system in the  systems list  contains the following
  1477.         fields:
  1478.  
  1479.         Node Address
  1480.  
  1481.              This field contains the network address of the system.
  1482.  
  1483.         SysOp
  1484.  
  1485.              This  field  contains  the  name of  the  SysOp  of  the above
  1486.              entered system.  This  option can  also be  used  to select  a
  1487.              system  from  the  list  of systems  configured  in  the  Node
  1488.              manager.
  1489.  
  1490.         The  following  five  fields are  only  available  in  the fileecho
  1491.         manager:
  1492.  
  1493.         Send files
  1494.  
  1495.              This field determines if this system should receive files.
  1496.  
  1497.         Inactive
  1498.  
  1499.              This field determines if  this system is temporarily  inactive
  1500.              or  not, ie.  whether or not  it receives  files if  the above
  1501.              option is set to Yes.
  1502.  
  1503.         Receive files
  1504.  
  1505.              This field determines  if this system is allowed to send files
  1506.              to the local system.
  1507.  
  1508.         PreRelease
  1509.  
  1510.              This   field  determines   if   this  system   should  receive
  1511.              prereleased  files   before  the  official  release   date  as
  1512.              specified in the external hatch manager.
  1513.  
  1514.                                         24
  1515.  
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522.         Mandatory
  1523.  
  1524.              This field determines  if this system is allowed to disconnect
  1525.              this  fileecho via the  AreaMgr. If  this field is  turned on,
  1526.              ALLFIX  will also  not  allow  a  node  to set  this  area  to
  1527.              inactive.
  1528.  
  1529.         The following field is available in every systems list:
  1530.  
  1531.         Msg status
  1532.  
  1533.              This  field  determines the  message  status  of all  outgoing
  1534.              files. If  the option  "Setup" is  selected, then the  message
  1535.              status,  as specified in  the Node  manager, is used.  All the
  1536.              other options override the settings in the Node manager.
  1537.  
  1538.         If  you enter  a system  address  that is  not listed  in the  Node
  1539.         manager, ASETUP will ask you  if you want to add that system to the
  1540.         node manager. By  selecting the Yes  option, you will  be presented
  1541.         with an edit  window, in which you can define  the settings for the
  1542.         new node. When you exit and save these  settings, this node will be
  1543.         added to the Node manager.
  1544.  
  1545.  
  1546.         6.2.8     The managers
  1547.  
  1548.         ASETUP contains a number  of "managers", for example,  the fileecho
  1549.         manager, where  the fileechos can  be defined. These  managers have
  1550.         two different  modes,  namely, view  mode and  edit  mode. In  view
  1551.         mode, you can scroll through  the different entries in the  manager
  1552.         and in edit mode, you can edit the current entry.
  1553.  
  1554.         The following keys are  available in view mode:
  1555.  
  1556.         ENTER
  1557.  
  1558.              Edit the current entry.
  1559.  
  1560.         ESC,F9,F10
  1561.  
  1562.              Done, return to the previous menu.
  1563.  
  1564.         F2
  1565.  
  1566.              Global edit menu that  allows multiple fileechos to  be edited
  1567.              at once.
  1568.  
  1569.         F3
  1570.  
  1571.              Display and allow editing of the advanced options.
  1572.  
  1573.         F4
  1574.  
  1575.              Find an entry.  For the fileecho manger, searching is based on
  1576.              the fileecho tag.
  1577.  
  1578.  
  1579.                                         25
  1580.  
  1581.  
  1582.  
  1583.  
  1584.  
  1585.  
  1586.  
  1587.         F5
  1588.  
  1589.              This  key can  be used  to active  the browse  mode. In Browse
  1590.              mode, all the  entries are  listed in  a list,  from which  an
  1591.              entry can be selected by pressing the enter key.
  1592.  
  1593.         F6
  1594.  
  1595.              Copy the current record and enter edit mode.
  1596.  
  1597.  
  1598.         The following keys are available in edit mode:
  1599.  
  1600.         The cursor up  and down keys can  be used in to  scroll through the
  1601.         menu items. The home and end keys can be  used to jump to the first
  1602.         and last item, respectively.
  1603.  
  1604.         ESC,F9,F10
  1605.  
  1606.              Done, return  to  the  previous  menu.  F9  closes  edit  mode
  1607.              without  saving,  F10 closes  edit  mode  saving  all  of  the
  1608.              changes,  and ESC  closes the  edit mode  presenting the  user
  1609.              with a dialog  box asking whether or not the changes should be
  1610.              saved.
  1611.  
  1612.         The  fileecho manager has  two extra  keys available in  edit mode,
  1613.         namely the following:
  1614.  
  1615.         F3
  1616.  
  1617.              Display and allow editing of the advanced options.
  1618.  
  1619.         F6
  1620.  
  1621.              Select  the destination  directory from  a list  of BBS  files
  1622.              areas.
  1623.  
  1624.  
  1625.         6.2.9     Shell
  1626.  
  1627.         ALLFIX and ALLFIX!:
  1628.  
  1629.         It is possible  to activate a  dos shell from  anywhere within  the
  1630.         configuration  program by  simultaneously hitting  the ALT  and the
  1631.         'Z' keys. ASETUP will alter  the prompt to signal that the  user is
  1632.         in a dos shell,  if there is enough  room left in the  environment.
  1633.         When  activating a  dos shell,  ASETUP will  swap a  portion of the
  1634.         memory in use  to either  XMS/EMS or  to disk,  thereby freeing  up
  1635.         more  memory for  the dos  shell. Type  "EXIT", without  quotes, to
  1636.         return to ASETUP.
  1637.  
  1638.         ALLFIX/2 and ALLFIX/U:
  1639.  
  1640.         It  is  possible  to  activate a  shell  from  anywhere  within the
  1641.         configuration  program by  simultaneously hitting  the ALT  and the
  1642.         'Z' keys. Type "EXIT", without quotes, to return to ASETUP.
  1643.  
  1644.                                         26
  1645.  
  1646.  
  1647.  
  1648.  
  1649.  
  1650.  
  1651.  
  1652.  
  1653.         6.2.10    Command line options.
  1654.  
  1655.         ASETUP has several command line options and switches.
  1656.  
  1657.         Commands
  1658.  
  1659.            Index  Rebuild index files
  1660.            Pack   Pack data files
  1661.  
  1662.         Switches
  1663.  
  1664.            -Mono  Force mono mode
  1665.            -Color Force color mode
  1666.            -SFI   Force speech friendly interface
  1667.  
  1668.  
  1669.         6.2.11    Index files
  1670.  
  1671.         ALLFIX  currently makes use of linear database files accompanied by
  1672.         linear,  sorted index  files. All  data is  stored in  files ending
  1673.         with  the extension  .FIX and  all index  information is  stored in
  1674.         files ending with the extension .IDX.
  1675.  
  1676.         The index files  conserve memory and enhance the performance of the
  1677.         program. 
  1678.  
  1679.         ASETUP  will  automatically remove  old  deleted  entries from  the
  1680.         database  files,   a  process  called  "packing".  However,  it  is
  1681.         sometimes necessary  to manually  "pack" the database  files, which
  1682.         can be done using the Pack command. 
  1683.  
  1684.         Example:       ASETUP Pack
  1685.  
  1686.         If the index files are  corrupt or have accidentally been  deleted,
  1687.         then ASETUP  will automatically  regenerate them. This  process can
  1688.         also be performed manually with the Index command. 
  1689.  
  1690.         Example:       ASETUP Index
  1691.  
  1692.         Repeated  packing  or  regenerating  of the  index  files  will not
  1693.         destroy any data. However, it is not necessary  to manually pack or
  1694.         regenerate the index files under normal conditions. 
  1695.  
  1696.  
  1697.         6.3  System data
  1698.  
  1699.         6.3.1     Address maintenance
  1700.  
  1701.         6.3.1.1   Network addresses
  1702.  
  1703.         Each system is designated by  a network address and sometimes  with
  1704.         a number of  alternate networks addresses (AKAs).  The main address
  1705.         should be  entered within this menu, along  with up to 40 alternate
  1706.         addresses.  To  prevent  confusion,  it  is  recommended  that  the
  1707.         addresses be entered  in the same order  as they are  configured in
  1708.  
  1709.                                         27
  1710.  
  1711.  
  1712.  
  1713.  
  1714.  
  1715.  
  1716.  
  1717.         other programs, such as the mailer and the echomail processor. 
  1718.  
  1719.         Another option that can be configured within  this menu is the fake
  1720.         point number.  The fake point number is used  when writing echomail
  1721.         messages to PKT files  that have to  be processed by your  echomail
  1722.         tosser. ALLFIX will use the  aka that you defined for  the FileFind
  1723.         or New  file report,  and replace  the point number  with the  Fake
  1724.         point.  This will ensure  that your  mail tosser processes  the PKT
  1725.         files, since most echomail  tossers would otherwise ignore  the PKT
  1726.         files,  since they would otherwise contain  an origin address equal
  1727.         to your address. You should use a point number  that has a very low
  1728.         chance of being used for something else, such as the number 9999.
  1729.  
  1730.  
  1731.         6.3.1.2   Site information
  1732.  
  1733.         This  menu contains information  that can  be used in  the template
  1734.         file  system.  The registered  version  of ALLFIX  also  contains a
  1735.         field to enter the registration key.
  1736.  
  1737.         BBS name
  1738.  
  1739.              The name of the BBS system.
  1740.  
  1741.         Phone 1
  1742.  
  1743.              The phone number of the BBS system.
  1744.  
  1745.         Phone 2
  1746.  
  1747.              The phone number of line 2 of the BBS system.
  1748.  
  1749.         Phone 3
  1750.  
  1751.              The phone number of line 3 of the BBS system.
  1752.  
  1753.         Location
  1754.  
  1755.              The city and country where the BBS system is located.
  1756.  
  1757.         SysOp
  1758.  
  1759.              The  name   of  the  system  operator.  This  name  should  be
  1760.              identical to the name for  which the registration key is  made
  1761.              out to.
  1762.  
  1763.         Max baud
  1764.  
  1765.              The maximum baud rate supported by the BBS system.
  1766.  
  1767.         Flags
  1768.  
  1769.              The  collection  of  nodelist   flags  defining  the  system's
  1770.              capabilities.  The  local  HOST   or  HUB  system  should   be
  1771.              contacted if this information is not known.
  1772.  
  1773.  
  1774.                                         28
  1775.  
  1776.  
  1777.  
  1778.  
  1779.  
  1780.  
  1781.  
  1782.         Reg key
  1783.  
  1784.              There are four  different registration key fields for the four
  1785.              different   types  of   ALLFIX.  Fill   your  key(s)   in  the
  1786.              appropriate field(s).
  1787.  
  1788.         6.3.1.3   AKA matching
  1789.  
  1790.         ALLFIX will  normally automatically determine which network address
  1791.         to use for a destination system. This process works by  matching up
  1792.         the zone numbers. Within  this menu it is possible  to force ALLFIX
  1793.         to  use a  different matching  procedure.  The AKA  to  use can  be
  1794.         entered for  up to 20 zone/net  combinations. If the net  number is
  1795.         zero, then ALLFIX will match  that particular AKA to all  addresses
  1796.         in that zone.  If the net number is not zero, then ALLFIX will only
  1797.         match  that AKA to  addresses in  that zone  and net. The  order in
  1798.         which  the entries are  made is  not important. ALLFIX  will select
  1799.         the "best" match. 
  1800.  
  1801.         Example:
  1802.  
  1803.              If the following two entries are made:
  1804.  
  1805.              2:0         2:281/1000
  1806.              2:281       2:281/1001
  1807.  
  1808.              When   selecting  which   AKA  to   use  (ie.   2:281/1000  or
  1809.              2:281/1001) for  the system 2:231/1000, ALLFIX will select the
  1810.              first address. If an AKA  needs to selected for the  following
  1811.              address:  2:281/2000,  then  ALLFIX  will  select  the  second
  1812.              address. Please notice that  ALLFIX selects the "best"  match,
  1813.              and  not  the  first  specification  that  matches  the  given
  1814.              address.
  1815.  
  1816.         If an address  cannot be matched up, then ALLFIX  will use the main
  1817.         address.
  1818.  
  1819.  
  1820.         6.3.1.4   Domain names
  1821.  
  1822.         A  domain is  a name that  is given to  a certain net  or a portion
  1823.         thereof.  Domain names cannot  be selected  freely. The ZC,  of the
  1824.         network in question,  should be consulted when there is doubt about
  1825.         the  domain name. Domain names  are often referred  to as the fifth
  1826.         dimension,  however, the  author doubts  whether domain  names have
  1827.         any functional value.
  1828.  
  1829.         Domain names are  put into any netmail or echomail messages. ALLFIX
  1830.         will put the domain  names in both  types of messages according  to
  1831.         the  FSC proposals. ALLFIX  will only  include the domain  names if
  1832.         they have been configured for a certain net. 
  1833.  
  1834.         BinkleyTerm users  can also use  domain names for  another purpose.
  1835.         It  is  possible  to  configure BinkleyTerm  so  that  it  will use
  1836.         directories,  other  than  the  standard  outbound  directory.  The
  1837.         domain name signifies  the name of  the directory for  a particular
  1838.  
  1839.                                         29
  1840.  
  1841.  
  1842.  
  1843.  
  1844.  
  1845.  
  1846.  
  1847.         net. ALLFIX will  use those directories  for those zones  that have
  1848.         an domain name. The zone  number will automatically be appended  to
  1849.         the directory  name, and  the standard outbound  directory will  be
  1850.         used for the zone corresponding to the main address.
  1851.  
  1852.         Example:
  1853.  
  1854.              standard outbound directory for zone 1:
  1855.  
  1856.              E:\BINK\OUTBOUND.001
  1857.  
  1858.              standard outbound directory for zone 2:
  1859.  
  1860.              E:\BINK\OUTBOUND.002
  1861.  
  1862.              standard  outbound  directory for  zone  3,  with domain  name
  1863.              "Fidonet" :
  1864.  
  1865.              E:\BINK\FIDONET.003
  1866.  
  1867.  
  1868.         
  1869.          * Note:     BinkleyTerm users: Please note that ALLFIX will use the domain named
  1870.                      directories for  all zones that have  a domain name defined.  If the
  1871.                      normal  naming procedure is required, the domain names should NOT be
  1872.                      configured.
  1873.  
  1874.         ALLFIX will not use the  domain naming convention for the  outbound
  1875.         directories  for those  people  using Portal  of Power,  which uses
  1876.         BinkleyTerm  style outbound  directories but  does not  support the
  1877.         domain naming convention.
  1878.  
  1879.  
  1880.         6.3.2     Pathnames (part 1)
  1881.  
  1882.         This menu contains the first part  of a large number of directories
  1883.         not  all of  which need  to be  configured in  order for  ALLFIX to
  1884.         perform correctly.
  1885.  
  1886.         MSG path (not in ALLFIX!)
  1887.  
  1888.              This is the  directory where the Ezycom or Hudson message base
  1889.              is stored. If neither of  those messages is needed, then  this
  1890.              option does not need to be configured.
  1891.  
  1892.         BBS path (ALLFIX!)
  1893.  
  1894.              This  is the  directory where  the WildCat!  BBS configuration
  1895.              files are located.
  1896.  
  1897.         Netmail
  1898.  
  1899.              This  is  the directory  where  all  incoming netmails  (*.MSG
  1900.              files) are stored.
  1901.  
  1902.         Netmail out
  1903.  
  1904.  
  1905.                                         30
  1906.  
  1907.  
  1908.  
  1909.  
  1910.  
  1911.  
  1912.  
  1913.              Some  mailers  support separate  inbound and  outbound netmail
  1914.              directories.  If necessary,  then this  is where  the outbound
  1915.              netmail  directory can  be configured.  The only  known mailer
  1916.              supporting this  particular option is D'Bridge. If this option
  1917.              is not needed, then it should be left blank.
  1918.  
  1919.         Inbound
  1920.  
  1921.              This is the directory  where the mailer receives  all incoming
  1922.              files. It is possible that the mailer supports a normal  and a
  1923.              secure  inbound directory.  In that  case,  this is  where the
  1924.              normal  inbound directory  should  be configured.  The  secure
  1925.              inbound directory can be configured in the next option.
  1926.  
  1927.         Sec Inbound
  1928.  
  1929.              If the  mailer has  support for  a separate inbound  directory
  1930.              for secure  sessions, then this directory should be configured
  1931.              here.  If  the  mailer  does  not  support  a  secure  inbound
  1932.              directory or that  option is not  being used, then  this field
  1933.              should be left blank.
  1934.  
  1935.         Outbound
  1936.              This field is  used for three  different things, depending  on
  1937.              the type  of  mailer that  you use.  If  you use  BinkleyTerm,
  1938.              Portal  of  Power,  or  McMail, then  this  field  is  used to
  1939.              configure the  outbound directory  that ALLFIX should  use. If
  1940.              you use  D'Bridge 1.53 or higher,  then this field  is used to
  1941.              configure where  the D'Bridge outbound queue should be stored.
  1942.              If you  use T-Mail, then  this field  is used to  define where
  1943.              the FileBox is stored. Lastly,  if you use the FrontDoor  STQ,
  1944.              then this field  is used to  define where the  STQ is  located
  1945.         (normally, the FrontDoor system directory).  
  1946.  
  1947.         PKT in
  1948.  
  1949.              ALLFIX has  the ability to  write .PKT files, but  it can also
  1950.              read  them for FileFind requests. ALLFIX will scan the netmail
  1951.              directory  for  all arcmail  packages  addressed  to the  fake
  1952.              address and stored  in this directory.  If the .PKT  system is
  1953.              not required, then this option should be left blank.
  1954.  
  1955.         PKT out
  1956.  
  1957.              Any  .PKT files that  ALLFIX creates  need to be  processed by
  1958.              the  echomail processor. If the .PKT  system is required, then
  1959.              this  is the  directory where  ALLFIX  should create  the .PKT
  1960.              files. Some  echomail processors, like Gecho, support a secure
  1961.              .PKT directory. Any .PKT  files processed from that  directory
  1962.              will not be checked  for appropriate addresses and  passwords.
  1963.              If the  echomail processor supports that option,  it is highly
  1964.              recommended that it is used because   it offers the ability to
  1965.              write messages  in  an echomail  area  without including  that
  1966.              system in the  export list for  that area. This is  very handy
  1967.              for echomail  areas  where  ALLFIX  writes  new  file  reports
  1968.              because otherwise, any messages  received in those areas  will
  1969.  
  1970.                                         31
  1971.  
  1972.  
  1973.  
  1974.  
  1975.  
  1976.  
  1977.  
  1978.              also be forwarded to ALLFIX, which is not necessary!
  1979.  
  1980.         Tic path
  1981.  
  1982.              This is  the  directory  where  ALLFIX  stores  outgoing  .TIC
  1983.              files.  This directory  must  be  configured  and it  MUST  be
  1984.              different  from  either of  the  inbound  directories and  the
  1985.              Queue directory explained below.
  1986.  
  1987.         Queue path
  1988.  
  1989.              This  directory is used when  pass through files are processed
  1990.              or when  the "send original" option  is being used for  one or
  1991.              more fileechos.  This directory  is also  used to  store files
  1992.              that  need to be  released on  a later date.  More information
  1993.              about these  options can  be found  in  related sections.  Any
  1994.              files  stored in this  directory that  have been sent  will be
  1995.              removed.  It  is VERY  VERY important  that this  directory is
  1996.              used only  by ALLFIX and  that it  does not contain  ANY other
  1997.              files, because they WILL be deleted!
  1998.  
  1999.  
  2000.         6.3.3     Pathnames (part 2)
  2001.  
  2002.         List path (not in ALLFIX!)
  2003.  
  2004.              The path where ALLFIX  can find alternate FILES.xxx  files for
  2005.              directories  found on  CD-Rom drives.  ALLFIX will  check this
  2006.              directory before  checking the official directory. The name of
  2007.              the file must end in 3 digits. For  example: the file for file
  2008.              area 1  would  be named:  FILES.001. This  option  is used  in
  2009.              conjunction  with the  FileFind system  for those  BBS systems
  2010.              that make use of standard FILES.BBS files.
  2011.  
  2012.         Rcvd path
  2013.  
  2014.              If a directory is configured  in this field, then ALLFIX  will
  2015.              move any  orphaned incoming  files from the  inbound directory
  2016.              to this directory. Orphaned files  are those that do not  have
  2017.              an  accompanying file  attach  message. Arcmail  packages  and
  2018.              routed .TIC files will not be moved.
  2019.  
  2020.         Bad tics
  2021.  
  2022.              If a directory is configured  in this field, then ALLFIX  will
  2023.              move any bad  .TIC files and  their associated files  from the
  2024.              inbound directory  to this directory.  If this  option is  not
  2025.              defined,  then ALLFIX  will change  the extension  of  all bad
  2026.              .TIC files to .BAD. 
  2027.  
  2028.         Dupe path
  2029.  
  2030.              If a directory is configured  in this field, then ALLFIX  will
  2031.              move  any  duplicate  files  and  their .TIC  files  from  the
  2032.              inbound  directory to  this  directory. If  this field  is not
  2033.              defined,  then ALLFIX will  move the  files to the  "Bad tics"
  2034.  
  2035.                                         32
  2036.  
  2037.  
  2038.  
  2039.  
  2040.  
  2041.  
  2042.  
  2043.              directory  or rename  them to  .BAD files,  if the  "Bad tics"
  2044.              field is not defined.
  2045.  
  2046.         Tag path
  2047.  
  2048.              Path  where   the  uplink  fileecho  area  listing  files  are
  2049.              located.  If this  directory is left  blank, then  ALLFIX will
  2050.              assume that  those files are  stored in the  system directory.
  2051.              An  update  fileecho area  listing  is  usually a  FILEBONE.??
  2052.              file, which contains a list of all of the fileechos  which are
  2053.              available on the backbone. A  listing may also contain only  a
  2054.              subset of the FILEBONE.?? file. 
  2055.  
  2056.         Tmp path
  2057.  
  2058.              This  is the  directory that ALLFIX  should use  when creating
  2059.              temporary  directories necessary for  archive conversion. If a
  2060.              ram  drive,  with adequate  space,  is available,  then  it is
  2061.              recommended that  it be used  for increased performance.  If a
  2062.              ram drive is used, then it is very important that it is  large
  2063.              enough to  handle large files because otherwise the conversion
  2064.              process will  fail and the  original archive will  be imported
  2065.              as opposed to the converted archive.
  2066.  
  2067.         Template
  2068.  
  2069.              This  is the  directory where  the template  files (*.APL) are
  2070.              located. This  field  must be  configured.  It is  recommended
  2071.              that  a  separate directory  is  used  to  store the  template
  2072.              files,  because it  is  possible  to have  a  large number  of
  2073.              templates  files  and keeping  them  in  a separate  directory
  2074.              makes finding them easier. 
  2075.  
  2076.         Billing
  2077.  
  2078.              This  is  the  directory  where  the  billing  information  is
  2079.              stored. ALLFIX stores a different datafile for each  node that
  2080.              participates in cost  sharing. These files are stored  in this
  2081.              directory.  The cost  sharing features,  explained in  section
  2082.              6.5, are only available in the registered version. 
  2083.  
  2084.         Old bills
  2085.  
  2086.              This is the  directory where old  bills are stored.  Each time
  2087.              that  ALLFIX makes a bill, it will  store a copy of it in this
  2088.              directory. Each bill has its  own invoice number. The name  of
  2089.              the   bills   stored  in   this   directory   will  be   named
  2090.              <invoice_nr>.TXT, for  example, 950001.TXT. The file  is plain
  2091.              ASCII text file. ALLFIX will  not store any old invoice  files
  2092.              if this field  is left empty.  For more information  about the
  2093.              cost sharing features, see section 6.5.
  2094.  
  2095.  
  2096.         6.3.4     Filenames
  2097.  
  2098.         There are a number of files that ALLFIX needs. 
  2099.  
  2100.                                         33
  2101.  
  2102.  
  2103.  
  2104.  
  2105.  
  2106.  
  2107.  
  2108.         Alias
  2109.  
  2110.              Most mailer  software packages have support for file requests.
  2111.              File  requests can be  made by  giving a specific  filename, a
  2112.              file specification,  or  by specifying  an  alias. The  mailer
  2113.              then consults  an "alias" file to determine  which file should
  2114.              be sent  when a  request is  done for a  particular alias.  It
  2115.              often  occurs   that  files,  which  are  available  for  file
  2116.              requesting,  are  periodically  updated which  means  that the
  2117.              alias file needs to be updated.
  2118.  
  2119.              ALLFIX is capable  of updating the  alias file. The  format of
  2120.              most alias files is:
  2121.  
  2122.              alias     [drive]:\path\filename.ext
  2123.  
  2124.              ALLFIX  will update  the  alias file  in  two situations.  The
  2125.              first situation is via the Magic  filename manager, which will
  2126.              be explained in more detail in section 6.5.3.  This particular
  2127.              method will scan  through the alias file and replace any files
  2128.              that  match the  specification entered  in the  magic filename
  2129.              manager. This method will ONLY  replace files that are in  the
  2130.              destination directory  for the  fileecho in question  and that
  2131.              do  NOT contain any  wildcards. The  second method  is easier.
  2132.              The "Magic" verb in the .TIC file  specifies an alias name. If
  2133.              that verb is present  in a .TIC file  then ALLFIX will add  or
  2134.              update  all references  to that  alias in  the alias  file. In
  2135.              this case it does not matter where or what the filename is.
  2136.  
  2137.              The  alias file may also  contain comments. Any text following
  2138.              a semicolon, ';',  will simply be skipped. ALLFIX will also do
  2139.              its  best to maintain  the format  of the current  alias file,
  2140.              when making any changes. 
  2141.  
  2142.              BinkleyTerm requires an  '@' symbol in front of the magic name
  2143.              and it also  requires that all aliases should be placed before
  2144.              any  reference to  external  alias files  denoted  with a  '*'
  2145.              character. ALLFIX  will use the BinkleyTerm requirements if it
  2146.              selected as the mailer in use (see Global Options menu).
  2147.  
  2148.              Portal of  Power  uses a  binary alias  datafile. ALLFIX  will
  2149.              update that file if it  is selected as the mailer in  use (see
  2150.              Global Options menu). Even though  the name of the alias  file
  2151.              for Portal of  Power is not configurable,  ALLFIX does require
  2152.              that it is specified in its entirety. 
  2153.  
  2154.              Example: C:\POP\PORTAL.OKF
  2155.  
  2156.         Log file
  2157.  
  2158.              The [drive]:\path\filename.ext of the  log file ALLFIX  should
  2159.              write to. ALLFIX  supports a number  of log file  styles which
  2160.              can selected in the Global Options menu. 
  2161.  
  2162.         Mgr log
  2163.  
  2164.  
  2165.                                         34
  2166.  
  2167.  
  2168.  
  2169.  
  2170.  
  2171.  
  2172.  
  2173.              The [drive]:\path\filename.ext of  the log file ALLFIX  should
  2174.              use for any AreaMgr activity.  ALLFIX will use the normal  log
  2175.              file if this  entry is left  blank. The log  style will be  in
  2176.              the same format as selected for the general log  in the Global
  2177.              Options menu.
  2178.  
  2179.         Rp log
  2180.  
  2181.              The  [drive]:\path\filename.ext  of  the  log  file  that  the
  2182.              request processor  in ALLIFX should  use. ALLFIX will  use the
  2183.              normal log  file if this  entry is left  blank. The log  style
  2184.              will be in the same format as selected  for the general log in
  2185.              the Global Options menu.
  2186.  
  2187.         Fix log
  2188.  
  2189.              The  [drive]:\path\filename.ext of the  log file  that FIXUTIL
  2190.              should  use.  The log  style will  be  in the  same  format as
  2191.              selected for the general log in the Global options menu.
  2192.  
  2193.         Bad log
  2194.  
  2195.              When  bad .TIC files  are received, ALLFIX  will either rename
  2196.              them to  .BAD or move them  to the Bad Tics  directory. ALLFIX
  2197.              will also create a  small log file which lists the  .TIC file,
  2198.              the associated archive, and the  reason the file was rejected.
  2199.              In this field, the path  and filename of that log file  can be
  2200.              defined. If this  field is left empty, then ALLFIX will create
  2201.              a file called "BADTICS.LOG" in the Bad Tics directory.
  2202.  
  2203.         Dupe log
  2204.  
  2205.              This field can be used to define the  path ane filename of the
  2206.              log file  that ALLFIX should  use for duplicate  files. Please
  2207.              see the description for the "Bad log" field for more details.
  2208.  
  2209.         Echotoss
  2210.  
  2211.              The squish echomail  processor reads in  an echotoss log  file
  2212.              which contains a  list of echomail tags for areas that contain
  2213.              new messages.  By  using this  log  file, squish  can  quickly
  2214.              determine which  areas have  new messages instead  of scanning
  2215.              all the message  bases which can  be very time  consuming. The
  2216.              path and  filename of  the log  file  can be  entered in  this
  2217.              field. The  default  name that  squish  uses is  ECHOTOSS.LOG.
  2218.              Entries will be appended to this  file only if the echotag for
  2219.              a particular message  area has been defined. For  more details
  2220.              please see the chapter on selecting message bases. 
  2221.  
  2222.              Many message base  tossers for JAM  also read an  echotoss log
  2223.              file. The name of this file is ECHOMAIL.JAM.  If you use a JAM
  2224.              message   base,  then   enter  the  path   and  name   of  the
  2225.              ECHOMAIL.JAM file in this field. 
  2226.  
  2227.         Unwanted
  2228.  
  2229.  
  2230.                                         35
  2231.  
  2232.  
  2233.  
  2234.  
  2235.  
  2236.  
  2237.  
  2238.              This field  can be used  to specify the  name of a  pure ASCII
  2239.              text   file  that   contains  a   list   of  files   and  file
  2240.              specifications that should be deleted from  incoming archives.
  2241.              Many systems  add a  little information  file to each  archive
  2242.              they process and  send to other systems. Entering the names of
  2243.              those files in  this file will instruct ALLFIX to delete those
  2244.              files from the incoming  archives. The unwanted file list  may
  2245.              contain wildcards  but  may not  contain  any pathnames.  This
  2246.              option is only available in the registered version.
  2247.  
  2248.         Wanted
  2249.  
  2250.              This field  can be used  to specify the  name of a  pure ASCII
  2251.              text  file   that   contains  a   list  of   files  and   file
  2252.              specifications that  should be added to incoming archives. All
  2253.              entries in  this file  should contain  the  complete path  and
  2254.              filename. This  option  is only  available  in the  registered
  2255.              version.
  2256.  
  2257.         Semaphore
  2258.  
  2259.              This field can be  used to define the name and location of the
  2260.              semaphore file that ALLFIX should  touch after it has  created
  2261.              outbound  mail.  Two semaphores  can  be  specified, one  that
  2262.              should be made  when netmail is  written, and one  that should
  2263.              be made when echomail is  written. The following list contains
  2264.              the names of  several mailer programs  and the semaphore  file
  2265.              that ALLFIX should create when netmail has been written:
  2266.  
  2267.              Mailer              Semaphore
  2268.                   
  2269.              FrontDoor           FDRESCAN.NOW
  2270.              InterMail           IMRESCAN.NOW
  2271.              D'Bridge            DBRIDGE.RSN
  2272.              Dutchie             NWMAIL00.FLG
  2273.              McMail              MCSCAN.ALL
  2274.  
  2275.  
  2276.         The normal log  file, the AreaMgr  log file, the  Rp log file,  and
  2277.         the semaphore file  may contain the name of an environment variable
  2278.         enclosed with  percent  characters, '%'.  ALLFIX  will replace  the
  2279.         name of the environment variable with its value,  if it is defined.
  2280.  
  2281.  
  2282.         
  2283.          Example:
  2284.  
  2285.                suppose that the following environment variable is set:
  2286.  
  2287.                      SET NODE=1
  2288.  
  2289.                If the string %NODE% is included in the name of the  log file, then ALLFIX
  2290.                would replace it with the string "1", without the quotes.
  2291.  
  2292.                      C:\LOGS\ALLFIX.%NODE% 
  2293.  
  2294.                would be expanded to: 
  2295.  
  2296.                                                 36
  2297.  
  2298.  
  2299.  
  2300.  
  2301.  
  2302.  
  2303.  
  2304.                   
  2305.                      C:\LOGS\ALLFIX.1
  2306.  
  2307.         This makes it  possible to use  separate log  files for each  node,
  2308.         the  names of  which  will depend  on  the value  of the  specified
  2309.         environment variable. 
  2310.  
  2311.         6.3.5     Internet settings
  2312.  
  2313.         Please  note  that  our  internet  site contains  a  more  detailed
  2314.         explanation  of how you  can use  ALLFIX to  send all  your Fidonet
  2315.         files   via   the  Internet.   You   can   find   our  website   at
  2316.         www.allfix.com.
  2317.  
  2318.         ALLFIX  has the ability  to send files  via the Internet  to all of
  2319.         your downlinks  throughout the world. Instead of  sending the files
  2320.         and the messages  via your FidoNet  mailer, ALLFIX creates  SMTP or
  2321.         UUCP style  email messages which can  be send to  your downlinks by
  2322.         your  email client software.  This means  that if you  use PostRoad
  2323.         mailer,  for example,  it  will  take  over  the  function  that  a
  2324.         FrontDoor would, in a normal situation.
  2325.  
  2326.         Instead of  making .MSG files  (FrontDoor style mailers)  or adding
  2327.         files to  .?LO  files  (BinkleyTerm  style  mailers),  ALLFIX  will
  2328.         create emails  in the outgoing  directory and  it will scan  all of
  2329.         the emails in the inbound directory. 
  2330.  
  2331.         Every  message and file  is encoded  using a technology  similar to
  2332.         UUENCODE. All messages  and files larger  than a certain  size (see
  2333.         below) will be split up into smaller parts and then each part  will
  2334.         be  sent to  your downlink.  The ALLFIX  running at  your downlink,
  2335.         will decode each  part of a message  or file, and  when all of  the
  2336.         parts  have been  received, it  will rebuild  the messages  and the
  2337.         files. 
  2338.  
  2339.         When a part is received by ALLFIX, it will acknowledge that it  has
  2340.         been  received  correctly. If  the part  contains an  error, ALLFIX
  2341.         will request  that it is  resent, by sending an  error message back
  2342.         to the sender.  The sending ALLFIX will automatically resend a part
  2343.         whenever it has  not been acknowledged within a specified number of
  2344.         days. 
  2345.  
  2346.         The system, therefore,  is very secure. Parts cannot be lost, since
  2347.         they  will be  automatically resent  if they  are not  received, or
  2348.         when something  has  gone  wrong  in  the  transmission.  Secondly,
  2349.         everything  is  encoded,  therefore, it  is  easy  to determine  if
  2350.         something went wrong in the transmission.
  2351.  
  2352.         The only thing that  you need to do to use this  feature is fill in
  2353.         the fields below and enter  an Internet address for your  downlinks
  2354.         in the Node manager.
  2355.  
  2356.         In  this particular menu,  the fields  that are necessary  for this
  2357.         feature in ALLFIX are explained: 
  2358.  
  2359.         Address
  2360.  
  2361.  
  2362.                                         37
  2363.  
  2364.  
  2365.  
  2366.  
  2367.  
  2368.  
  2369.  
  2370.              In  this  field,  the  Internet address  to  use  needs  to be
  2371.              defined.
  2372.  
  2373.         Email client
  2374.  
  2375.              In  this field  you can select  the type of  email client that
  2376.              you  use. The  selection  you make  will  determine the  other
  2377.              fields that  also need to be  filled in. Those fields  that do
  2378.              not need to be filled in will be  marked with the string "n/a"
  2379.              (Not  Applicable).  ALLFIX  currently  has  support   for  the
  2380.              following email programs: PostRoad  Mailer, Net-Tamer, PMMail,
  2381.              UUCP,  Soup/Yarn, Eudora,  KA9Q, MR/2  ICE, Pegasus  Mail, and
  2382.              Outlook express. 
  2383.  
  2384.         In queue
  2385.  
  2386.              In  this field,  the directory  where incoming  email messages
  2387.              are received needs  to be defnied. If you use Outlook Express,
  2388.              as your email client, please read the Note below.
  2389.  
  2390.         Out queue
  2391.  
  2392.              In  this field,  the directory  where outgoing  email messages
  2393.              are  stored needs  to be  defined. Some  email clients  do not
  2394.              have a seperate outgoing  email directory. In that case,  this
  2395.              field will be marked not applicable (n/a).
  2396.  
  2397.         Sent queue
  2398.  
  2399.              In this field,  the directory where ALLFIX will store all sent
  2400.              SMTP email  messages until  they have been  acknowledged needs
  2401.              to be defined. This directory  must be different from the  Out
  2402.              queue.
  2403.  
  2404.         In SMTP ext
  2405.  
  2406.              In this  field, the extension  of the incoming  email messages
  2407.              needs  to defined.  This is  normally  the string  POP. Please
  2408.              look at  the messages that your email client makes to find out
  2409.              what the correct extension is.
  2410.  
  2411.         Out SMTP ext
  2412.  
  2413.              In this  field, the extension  of the outgoing  email messages
  2414.              needs to be defined. 
  2415.  
  2416.         Resend retry
  2417.  
  2418.              In this field the number of times ALLFIX should try to  resend
  2419.              a message can be entered. The default value is 3 times.
  2420.  
  2421.         Resend delay
  2422.  
  2423.              In this field  the number of  days can be entered  that ALLFIX
  2424.              should wait before automatically resending a message.
  2425.  
  2426.  
  2427.                                         38
  2428.  
  2429.  
  2430.  
  2431.  
  2432.  
  2433.  
  2434.  
  2435.         Message size
  2436.  
  2437.              In  this  field the  maximum size  of a  message or  file part
  2438.              should  be defined.  The default  value and  maximum value  is
  2439.              16kb. The size  entered here must be equal  to or smaller than
  2440.              the  maximum size of  a package  that the  Internet connection
  2441.              can handle. Normally  this is 16kb.  If the size  entered here
  2442.              is larger than  the maximum possible value,  then the messages
  2443.              created  by ALLFIX will  be split  up by another  program into
  2444.              smaller parts.  If  this happens,  then  the ALLFIX  receiving
  2445.              those  parts will be  unable to  rebuild the messages  and the
  2446.              files attached to those messages.
  2447.  
  2448.         Age of Spool
  2449.  
  2450.              Since files and  messages are sent  in parts, these  parts may
  2451.              not  all be  received  at the  same  time. ALLFIX,  therefore,
  2452.              stores all received parts in a  special spool file. Sometimes,
  2453.              however,  somethings goes wrong and parts  remain in the spool
  2454.              file for a long time,  waiting for other parts that may  never
  2455.              come.  This field can  be used  to determine  how many  days a
  2456.              part may remain in the spool file before being removed.
  2457.  
  2458.         Scan netmail
  2459.  
  2460.              ALLFIX  has the  ability to  scan the  netmail folder  and re-
  2461.              route  all  netmail written  to  an Internet  address  via the
  2462.              Internet.  Toggling  this feature  to  yes,  will enable  this
  2463.              feature.
  2464.  
  2465.         Note:
  2466.  
  2467.              If  you are  using Outlook  Express, then  it is  necessary to
  2468.              also include the filename of the  file that is used to  stored
  2469.              the  incoming and outgoing  mail. In  the "In queue"  and "Out
  2470.              queue" fields, therefore, you need  to enter the path and  the
  2471.              filename of the respective files. However, you must  NOT enter
  2472.              the extension of the  file. If, for  example, the name of  the
  2473.              file is  MAIL_OUT.MBX (and MAIL_OUT.IDX), then you should, for
  2474.              example,  only enter  the path  and the  filename as  follows:
  2475.              C:\Program Files\Outlook Express\MAIL_OUT. 
  2476.  
  2477.         you should not only enter the path where the incoming  and outgoing
  2478.         messages  are  stored  in  the  In  queue  and  Out  queue  fields,
  2479.         respectively. 
  2480.  
  2481.         Gateway functionality:
  2482.  
  2483.         ALLFIX also has the  ability to function  as a gateway. This  means
  2484.         that ALLFIX  can re-route files on hold for a particular system via
  2485.         the Internet. ALLFIX  can either send  the messages to  an Internet
  2486.         address  or  it  can  send  the messages  in  a  coded  manner,  as
  2487.         described  above.   The  second  type  of  functionality  called  a
  2488.         gateway.  In  this  situation, ALLFIX  uses  the  Internet to  send
  2489.         messages  to  another  Fido  technology  node.  The  first  method,
  2490.         however,  is  also  very  useful. You  can,  by  using  this simple
  2491.  
  2492.                                         39
  2493.  
  2494.  
  2495.  
  2496.  
  2497.  
  2498.  
  2499.  
  2500.         feature, send Notify messages, for example, to a  person's Internet
  2501.         address, while the file itself is put on hold for that system. 
  2502.  
  2503.         These features  can be  configured for  each node individually,  in
  2504.         the Internet  submenu in the  Node manager.  Two of  the fields  in
  2505.         that menu will be discussed briefly in this section. 
  2506.  
  2507.         Send
  2508.  
  2509.              This option determines what ALLFIX will send via  the Internet
  2510.              for this node. It has five possible values:
  2511.  
  2512.              Nothing
  2513.              Mail
  2514.              Files 
  2515.              Mail and files
  2516.              Everything on Hold
  2517.  
  2518.              The first four options  are self-explanatory. The last  option
  2519.              "Everything on hold" tells  ALLFIX to re-route everything  for
  2520.              this particular node via the Internet.
  2521.  
  2522.              Two  sub options,  named  Crash  and  Hold,  can  be  used  to
  2523.              determine if  messages with those statuses should  also be re-
  2524.              routed by ALLFIX.
  2525.  
  2526.         Act as gateway
  2527.  
  2528.              This  option determins  how ALLFIX  will  send things  via the
  2529.              Internet. This option has four possible values:
  2530.  
  2531.              No
  2532.                   This  means  that  ALLFIX  will  not  act  as  a gateway,
  2533.                   meaning that ALLFIX will  not encode any mail, unless  it
  2534.                   concerns a file attach.
  2535.  
  2536.              Local mail only
  2537.  
  2538.                   This means  that ALLFIX  will encode all  local mail  for
  2539.                   this    node.   Once    encoded,    ALLFIX   will    send
  2540.                   acknowledgements, etc. as explained above.
  2541.  
  2542.              Re-routed mail only
  2543.  
  2544.                   This  means that  ALLFIX will  encode all  re-routed mail
  2545.                   for this node. 
  2546.  
  2547.              Local and re-routed mail
  2548.  
  2549.                   This  means that all  mail will be  encoded, meaning that
  2550.                   ALLFIX  will act as a gateway for  all mail which is sent
  2551.                   to this node.
  2552.  
  2553.         Encode FREQs
  2554.  
  2555.              Normally,  when someone file requests a file via the Internet,
  2556.  
  2557.                                         40
  2558.  
  2559.  
  2560.  
  2561.  
  2562.  
  2563.  
  2564.  
  2565.              it will be  uuencoded and attached  to an email.  However, you
  2566.              may select  to encode the  file, which  means that it  iwll be
  2567.              split up into parts, encoded, and sent  to the person who file
  2568.              requested  the file.  His  or  her ALLFIX  will  then have  to
  2569.              decode the parts and put  the file back together. This  option
  2570.              is usefull  since it can be  used to guarantee  that the files
  2571.              are being transferred correctly.
  2572.  
  2573.         6.3.6     Origin lines
  2574.  
  2575.         Origin lines  are strings of  up to 55  characters followed by  the
  2576.         address  of the  current system,  that are appended  to the  end of
  2577.         each echomail message. ALLFIX offers  the ability to specify up  to
  2578.         20 separate origin lines. A selection can be made form the list  in
  2579.         other sections  of the  configuration  program. There  is even  the
  2580.         possibility to tell ALLFIX to select random origin lines.
  2581.  
  2582.         6.3.7     External programs
  2583.  
  2584.         There  are two external  program menus. The  first one  is used for
  2585.         defining DOS external programs and  the later is used for  defining
  2586.         OS/2  external   programs.  ALLFIX/U  will  use  the  DOS  external
  2587.         programs when not running under OS/2.
  2588.  
  2589.         ALLFIX has  the ability  to convert  incoming  archives to  another
  2590.         format, to  add  banners to  archives, and  to  pack outgoing  .TIC
  2591.         files along with the associated files into one large TIC archive. 
  2592.  
  2593.         In  order  to  do  this, ALLFIX  must  have  information  about the
  2594.         available (de)compression programs. 
  2595.  
  2596.         A  total  of  ten  compression and  decompression  programs  can be
  2597.         defined. The  first 6  are defined  for  you, even  though you  can
  2598.         manually edit any  of the features.  The remaining four  are empty,
  2599.         which  you can  use  to define  any  compression and  decompression
  2600.         programs you like. Please  note that you need to be  registered, in
  2601.         order to use those four user definable types.
  2602.  
  2603.         The first three options are for the compression utility are:
  2604.  
  2605.         Program file
  2606.  
  2607.              The name of the compression program.
  2608.  
  2609.         Switches
  2610.  
  2611.              The commandline  options necessary initiate  compression which
  2612.              should not include any reference to any paths or filenames. 
  2613.  
  2614.         Banner
  2615.  
  2616.              The  commandline  options  necessary to  add  a  banner  to an
  2617.              archive.  The name of  the archive to be  updated can be coded
  2618.              with the meta command @1  and the path and name of  the banner
  2619.              file  can be  coded  with  the  @2  meta  command.  Both  meta
  2620.              commands will  be expanded with their respective values before
  2621.  
  2622.                                         41
  2623.  
  2624.  
  2625.  
  2626.  
  2627.  
  2628.  
  2629.  
  2630.              calling up the compression program.
  2631.  
  2632.         The   following  options  are   for  the  associated  decompression
  2633.         utility.
  2634.  
  2635.         Program file
  2636.  
  2637.              The name of the decompression program.
  2638.  
  2639.         Switches
  2640.  
  2641.              The  commandline options  necessary to  initiate decompression
  2642.              which  should  not  contain  any reference  to  any  paths  or
  2643.              filenames. 
  2644.  
  2645.         Tic arcs
  2646.  
  2647.              The  commandline options  necessary to  initiate decompression
  2648.              of  TIC archives.  Sometimes people  store pathnames  in their
  2649.              TIC  archives. If you normally want the compression program to
  2650.              retain  these  pathnames,  then  a  problem  will  occur  when
  2651.              unpacking TIC archives. For that  reason, a seperate field has
  2652.              been introduced. If this field  is not used, then ALLFIX  will
  2653.              automatically use the switches defined in the previous field.
  2654.  
  2655.         Signature
  2656.  
  2657.              The signature is a "finger  print" for this archive type.  The
  2658.              signature of  a  compression  program  can  be  found  in  the
  2659.              accompanying  documentation.   Up  to  10  characters  can  be
  2660.              defined  using  their  hexadecimal  representation.   Wildcard
  2661.              characters can be specified by entering two spaces. 
  2662.  
  2663.         Offset
  2664.  
  2665.              The offset in  the archive where the signature starts. This is
  2666.              usually  0,  however,  some  archives  store  their  signature
  2667.              further on in the archive headers.
  2668.  
  2669.         Extension
  2670.  
  2671.              This field  defines the extension of archives  of this format.
  2672.              ALLFIX needs this information  in order to create archives  of
  2673.              this format.
  2674.  
  2675.  
  2676.         
  2677.          Sample configuration for the compression program RAR:
  2678.  
  2679.                Program file RAR
  2680.                 ├─Switches  a -std -y -r
  2681.                 └─Banner    c @1 =@2
  2682.  
  2683.                Program file RAR
  2684.                 └─Switches  x -std -y
  2685.  
  2686.                Signature    52 61 72 21 1A 07 00
  2687.  
  2688.                                                 42
  2689.  
  2690.  
  2691.  
  2692.  
  2693.  
  2694.  
  2695.  
  2696.              
  2697.                Extension    RAR
  2698.  
  2699.         Scan:
  2700.  
  2701.         ALLFIX is also  capable of calling up an  antivirus program to scan
  2702.         incoming archives for viruses. The  seventh menu item is where  the
  2703.         antivirus program can  be configured. The  first field is  the name
  2704.         of  the executable and  the second  field is where  the commandline
  2705.         options  may  be  entered. ALLFIX  does  not  pass any  commandline
  2706.         options by  itself. All the  necessary commandline options  MUST be
  2707.         specified by the user. There is one meta command that may be  used:
  2708.         @1  is  expanded   to  the  complete  path  name  without  trailing
  2709.         backspace.  This  meta  command  may be  used  in  the  commandline
  2710.         options. For  example,  the following  commandline  options may  be
  2711.         used  with SCAN  (where  the @1  meta  command is  expanded to  the
  2712.         temporary directory where ALLFIX unpacked the files:
  2713.  
  2714.              @1\*.COM @1\*.EXE /NOMEM /NOBREAK /NOPAUSE /NOEXPIRE .
  2715.  
  2716.         
  2717.          * Note:     The  period, '.',  in the previous  line belongs to  the commandline
  2718.                      option and must be used, otherwise SCAN may not function correctly.)
  2719.  
  2720.         Another example,  the  following commandline  options  may be  used
  2721.         with OS2SCAN (the @1  meta command has the  same meaning as in  the
  2722.         above example):
  2723.  
  2724.              @1\*.* /ALL /SUB
  2725.  
  2726.         The  virus checking  feature is  only  available in  the registered
  2727.         version of ALLFIX. 
  2728.  
  2729.         EAC:
  2730.  
  2731.         The next item in this menu  is for configuring an external  archive
  2732.         conversion utility. The  conversion routines supported  directly in
  2733.         ALLFIX  are  very  simple  and  many   people  will  require  extra
  2734.         functions.  There   are  many  External  Archive  Conversion  (EAC)
  2735.         utilities available  on the  market, including: PalmScan,  MTA, and
  2736.         TranScan.  The first  field  is  the name  of  the executable.  The
  2737.         second field  is where the  commandline options may  be configured.
  2738.         ALLFIX  supports two meta  commands for the  commandline option: @1
  2739.         is expanded  to the  name+extension of  the file  that needs  to be
  2740.         converted, and @2  is expanded to  the temporary path  where ALLFIX
  2741.         placed the file that is currently being converted. 
  2742.  
  2743.         Gus:
  2744.  
  2745.         The  next menu item can be  used to configure a general unarchiving
  2746.         tool. A popular  unarchiving tool is GUS. ALLFIX  will call up this
  2747.         program when it  needs to unpack a file and  can not determine what
  2748.         the archive  format it.  There are  two meta commands  that can  be
  2749.         used for  the commandline  options: @1  is expanded  to the path  +
  2750.         filename, and @2  is expanded to the file specification that should
  2751.         be  unpacked  (Ex. *.*).  The correct  commandline options  for the
  2752.         program GUS are:
  2753.  
  2754.  
  2755.                                         43
  2756.  
  2757.  
  2758.  
  2759.  
  2760.  
  2761.  
  2762.  
  2763.              @1 @2 /Q /R
  2764.  
  2765.         Many  people find it  difficult to  understand how the  EAC utility
  2766.         should  be configured.  The author  has made  sure that  everything
  2767.         works very logically and it  should not present many problems.  The
  2768.         first thing that  ALLFIX does is create a temporary directory which
  2769.         is then made  the current  directory. Next, the  file is placed  in
  2770.         this temporary directory.  The EAC utility  is then called  up with
  2771.         the configured  commandline  options  and  any  meta  commands  are
  2772.         expanded with their  respective values. The only thing that the EAC
  2773.         utility has to do  is convert the archive,  which is now stored  in
  2774.         the  current  directory,   to  another  format.  If  no  error  was
  2775.         encountered  while calling  up the  EAC utility,  then ALLFIX  will
  2776.         search the  current  directory for  a filename  that resembles  the
  2777.         original  filename. There should  only be  one file in  the current
  2778.         directory,  and ALLFIX  will  continue  importing  that  particular
  2779.         file.  If an  error  was  encountered  while  calling  up  the  EAC
  2780.         utility,  or  nothing was  found in  the temporary  directory, then
  2781.         ALLFIX  will  continue  with  the  original  file,  which is  still
  2782.         located in the inbound directory. 
  2783.  
  2784.         It is easy  to see that  the external archive  conversion procedure
  2785.         should not cause  any problems. Most problems that do occur are the
  2786.         results of  configuration  mistakes in  the  EAC utilities.  Sample
  2787.         configuration  files  for  PalmScan and  MTA  are  included  in the
  2788.         SAMPLE.ZIP file.
  2789.  
  2790.         When  entering program  names it  is not  necessary to  include the
  2791.         extension.  If an  extension is  added (.EXE,  .COM, or  .CMD) then
  2792.         ALLFIX will scan for the full name in the PATH. If no extension  is
  2793.         included, then ALLFIX  will add each extension, in the order listed
  2794.         above,  and scan  for the  resulting program  name, until  it finds
  2795.         one, or until it has exhausted the possibilities. 
  2796.  
  2797.         If the program being called up is a batch file (.CMD), then  ALLFIX
  2798.         will  call  up  the  program  via   the  command  interpreter.  The
  2799.         disadvantage  of using batch  files is  that the errorlevel  of the
  2800.         program  being  called  up  is   not  passed  on  by  the   command
  2801.         interpreter  and,  hence,  it  is  very  difficult  for  ALLFIX  to
  2802.         determine  if something went  wrong when  calling up a  batch file.
  2803.         Therefore, it  is  recommended,  but  not  necessary,  that  normal
  2804.         executables are used, instead of batch files.
  2805.  
  2806.         If the redirection  symbol '<' is  used in the  commandline options
  2807.         for  adding  banners  to  archives  which  is  necessary  for  some
  2808.         compression programs, then  ALLFIX will  also call  up the  command
  2809.         interpreter,  since   that  is  the   only  way   to  execute   the
  2810.         redirection.
  2811.  
  2812.         Extra notes for ALLFIX/2 for OS/2 and ALLFIX Universal:
  2813.  
  2814.         ALLFIX/2 is capable  of executing both DOS and OS/2 programs. There
  2815.         are, however, a  few things that should be kept  in mind. Using the
  2816.         redirection symbols in conjunction with DOS  programs will not work
  2817.         properly. The  problem is that  the OS/2 shell  in which ALLFIX  is
  2818.         running will  process the redirection  symbol and  not the  virtual
  2819.  
  2820.                                         44
  2821.  
  2822.  
  2823.  
  2824.  
  2825.  
  2826.  
  2827.  
  2828.         DOS  window which  is started  for the DOS  program. The  result is
  2829.         that  the DOS  program will  not "see"  the redirection  symbol and
  2830.         hence the program will not function as intended.
  2831.  
  2832.         ALLFIX Universal will  switch between the DOS and the OS/2 external
  2833.         programs  depending on  which  operating  system  it is  being  run
  2834.         under. However, keep  in mind  that if you  define DOS programs  in
  2835.         the External  programs for  OS/2, then  ALLFIX Universal will  also
  2836.         behave exactly  like ALLFIX/2  described above (when  running under
  2837.         OS/2).
  2838.  
  2839.         Ed:
  2840.  
  2841.         ASETUP can use an external  editor instead of the default  internal
  2842.         editor. This editor  is used for  editing the template  files. This
  2843.         field can be used to define which editor ALLFIX should use.  Simply
  2844.         enter the complete path and filename of the editor. 
  2845.  
  2846.         When an external  editor has been defined, it is  still possible to
  2847.         call  up the  internal editor,  by pressing  ALT-ENTER to  edit the
  2848.         template in stead of pressing ENTER.
  2849.  
  2850.         6.3.8     External program options
  2851.  
  2852.         Within this menu  are several options  that have  an effect on  the
  2853.         way ALLFIX calls up external programs.
  2854.  
  2855.         Swapping method (ALLFIX and ALLFIX!)
  2856.  
  2857.              Whenever  ALLFIX calls up an  external program, referred to as
  2858.              a child process,  it needs to make enough memory available for
  2859.              that  program.  The  process  of  removing  memory used  by  a
  2860.              program to  make room for another program  is called swapping.
  2861.              ALLFIX  is capable  of swapping  almost all  of itself  out of
  2862.              conventional  memory, thereby, making as much memory available
  2863.              for the child process, as possible. 
  2864.  
  2865.              The way that  ALLFIX swaps can be configured with this option.
  2866.              Valid choices are:
  2867.  
  2868.              None
  2869.  
  2870.                   Do not swap at all
  2871.  
  2872.              Disk
  2873.  
  2874.                   Swap memory to disk
  2875.  
  2876.              XMS/EMS
  2877.  
  2878.                   Swap memory  to  XMS  or  EMS,  whichever  is  available.
  2879.                   Priority is given to XMS, because it is faster. 
  2880.  
  2881.              XMS/EMS/DISK
  2882.  
  2883.                   This  option is  the same  as  above, except  that ALLFIX
  2884.  
  2885.                                         45
  2886.  
  2887.  
  2888.  
  2889.  
  2890.  
  2891.  
  2892.  
  2893.                   will swap  to Disk  if there  is not  enough  XMS or  EMS
  2894.                   available.
  2895.  
  2896.              ALLFIX will  not swap to  XMS, EMS, or  Disk if there  is less
  2897.              than 128kb of  free memory available. ALLFIX will only swap as
  2898.              much of itself  out of conventional  memory as there  is space
  2899.              in the destination medium.
  2900.  
  2901.         Redirect output
  2902.  
  2903.              ALLFIX  is capable of redirecting output of child processes to
  2904.              NUL,  which makes  the execution  of ALLFIX  "look"  nicer, by
  2905.              "hiding"  the  execution  of   child  processes.  Only  output
  2906.              written to  standard  output can  be  redirected. Please  note
  2907.              that  this option  should  be  turned  off when  problems  are
  2908.              experienced   while  calling   up  child   processes,  because
  2909.              otherwise program errors will not  be displayed on the screen.
  2910.              It is  also important  to note  that only the  output of  OS/2
  2911.              programs can be  redirected. When a DOS program is executed, a
  2912.              virtual DOS windows  is opened. It  is not possible  to "hide"
  2913.              this window.
  2914.  
  2915.         No virus errorlevel
  2916.  
  2917.              The  antivirus  program  exits  with  a  number  of  different
  2918.              errorlevels  signalling  different  conditions  or   problems.
  2919.              Normally  the   first  few  errorlevels  are  used  to  signal
  2920.              execution  problems,  such as  not  enough  memory. The  first
  2921.              errorlevel  that signals  a virus  should  be entered  in this
  2922.              field.  If for example, errorlevel  1 means not enough memory,
  2923.              errorlevel 2 means invalid configuration file,  and errorlevel
  2924.              3 means one or more viruses found, then the value 3 should  be
  2925.              entered  in this field.  Please note  that the  virus checking
  2926.              option is only available in the registered version. 
  2927.                              
  2928.         Files to scan
  2929.  
  2930.              A number  of  files do  not  need to  be  scanned by  a  virus
  2931.              checker, for  example *.TXT  files. ALLFIX will  only call  up
  2932.              the virus checker if  there are one or more files matching the
  2933.              file  specification  selected  with   this  field  inside  the
  2934.              archive that needs to be scanned.
  2935.  
  2936.         (EAC) virus errorlevel
  2937.  
  2938.              The  EAC utilities  can  also  be used  to  check for  viruses
  2939.              during archive conversion. The minimum errorlevel returned  by
  2940.              an EAC utility if a virus has been  found should be entered in
  2941.              this field.
  2942.  
  2943.         (EAC) error errorlevel
  2944.  
  2945.              This is the minimum errorlevel  returned by an EAC utility  if
  2946.              a  error occurred  while converting  the archive.  ALLFIX will
  2947.              continue  processing  the  original archive  if  the  external
  2948.              conversion program reports an error.
  2949.  
  2950.                                         46
  2951.  
  2952.  
  2953.  
  2954.  
  2955.  
  2956.  
  2957.  
  2958.         
  2959.         6.3.9     Global options
  2960.  
  2961.         This menu contains  a large number  of very important  options that
  2962.         affect every process ALLFIX can perform.
  2963.  
  2964.         Log style 
  2965.  
  2966.              The style of the log file to be used.
  2967.  
  2968.              For  ALLFIX  and  ALLFIX/2,   the  possible  options  include:
  2969.              FrontDoor, D'Bridge, RemoteAccess, SuperBBS, BinkleyTerm,  and
  2970.              Portal of Power.
  2971.  
  2972.              For   ALLFIX!,  the   possible  options   include:  FrontDoor,
  2973.              D'Bridge, WildCat!, BinkleyTerm, and Portal of Power.
  2974.  
  2975.         Mailer mode
  2976.  
  2977.              The type of mailer used. Please see the  Outbound path, the DB
  2978.              queue, and the  FileBox options in the pathnames menu (section
  2979.              6.3.2),  if  BinkleyTerm,   D'Bridge,  or   T-Mail  is   used,
  2980.              respectively.
  2981.  
  2982.              There are  two "FrontDoor"  options in  the  list. The  normal
  2983.              "FrontDoor"  option  should  be  used  if  you  use  FrontDoor
  2984.              without  the the STQ  feature (as of  version 2.25) or  if you
  2985.              specifically  do  not  want  to  use  the  STQ   feature.  The
  2986.              "FrontDoor STQ"  option should be  used if  you use  FrontDoor
  2987.              2.25  or newer  and  you also  want to  use  the STQ  feature.
  2988.              Please   refer  to  the   FrontDoor  documentation   for  more
  2989.              information on what the STQ is.
  2990.  
  2991.              If  MainDoor is  selected,  ALLFIX has  the  added feature  of
  2992.              automatically  updating the  TODAY.MD file which  contains the
  2993.              file  request  statistics.  This  means  that  each  time  the
  2994.              request processor  in ALLFIX process  a file request,  it will
  2995.              update the total  number of kilobytes file requested  from the
  2996.              system. In  order  to  prevent the  necessity  of  adding  yet
  2997.              another path field  to the Pathnames menus,  this feature only
  2998.              works if the "MD" environment variable is set.
  2999.  
  3000.              If you  select BinkleyTerm, Portal  of Power, or  McMail, then
  3001.              please  make  sure  fill  in the  Outbound  directory  in  the
  3002.              Pathnames  menu.  Also, if  you use  T-Mail, then  please make
  3003.              sure to enter the FileBox  directory in the Outbound field  in
  3004.              the Pathnames menu.  If you use D'Bridge, you should enter the
  3005.              D'Bridge queue  directory in  the Outbound field,  and lastly,
  3006.              if  you  use the  FrontDoor  STQ,  then the  FrontDoor  system
  3007.              directory should be entered in the Outbound directory field. 
  3008.  
  3009.         Date format
  3010.  
  3011.              The date format that should be used. The choices are:
  3012.  
  3013.              dd-mm-yy  European style date
  3014.  
  3015.                                         47
  3016.  
  3017.  
  3018.  
  3019.  
  3020.  
  3021.  
  3022.  
  3023.              mm-dd-yy  American style date
  3024.  
  3025.              yy-mm-dd  Military style date
  3026.  
  3027.         MSG compatibility
  3028.  
  3029.              This  field is  used to define  the .MSG  compatibility. There
  3030.              are three options: The default  is Fido style .MSG files;  The
  3031.              second option  is  Opus style  .MSG files;  and  the third  is
  3032.              None. 
  3033.  
  3034.              In  the  .MSG  file  header, there  are  two  fields  that can
  3035.              contain  binary information.  In Fido  mode, these  two fields
  3036.              contain  the net  and  the  node number.  In  Opus mode,  they
  3037.              contain the  date of the  netmail, and in None  mode, they are
  3038.              left empty.
  3039.  
  3040.              Opus compatibility  should be  selected if FrontDoor  2.10 (or
  3041.              higher) or Opus is used. 
  3042.  
  3043.         Process local requests
  3044.  
  3045.              The mailflow in  FileFind message areas can quickly get out of
  3046.              hand. One way  to reduce unnecessary messages is to ignore any
  3047.              FileFind requests  that originate  from the current  system. A
  3048.              reply  to those  requests is  generally not  necessary because
  3049.              the files that  are being looked for are  obviously not on the
  3050.              current system,  otherwise  a  request  would  not  have  been
  3051.              placed.  This option should be turned on during testing phase,
  3052.              but turned off once it  has been confirmed that everything  is
  3053.              working properly.
  3054.  
  3055.         Replace extension
  3056.  
  3057.              Some  people add  extensions to  the file  specifications that
  3058.              are  being  searched for.  ALLFIX has  the ability  to replace
  3059.              those extensions  with  a  '*'  wildcard, if  this  option  is
  3060.              enabled.  For example,  a request  for AFIX430E.ZIP  is almost
  3061.              futile, since many  systems will convert  the file to  another
  3062.              format.  If the  file specification  ends with  a period  (ie.
  3063.              AFIX430E.) then ALLFIX will not  append the wildcard. This  is
  3064.              necessary because some  people want to  search for files  that
  3065.              do  not have an extension and it  is redundant to reply with a
  3066.              list of files that do.
  3067.  
  3068.         Max age of requests
  3069.  
  3070.              The  fact that the message flow  in FileFind areas can get out
  3071.              of hand really  fast has been touched on in previous sections.
  3072.              Another method for reducing  redundant replies is by  ignoring
  3073.              all  requests that are  older than  a certain number  of days.
  3074.              The  maximum  age  of  a  FileFind  request,  before  it  gets
  3075.              ignored, can be configured in this field. A  value of zero (0)
  3076.              will  disable the  age checking.  A value  of 4  or 5  days is
  3077.              recommended.
  3078.  
  3079.  
  3080.                                         48
  3081.  
  3082.  
  3083.  
  3084.  
  3085.  
  3086.  
  3087.  
  3088.         Auto clean up
  3089.  
  3090.              ALLFIX   automatically  scans  the   netmail  folder  and  the
  3091.              outbound directories to determine what  is still waiting to be
  3092.              sent. It may  happen that ALLFIX finds a  netmail to which one
  3093.              or more files are attached,  but where one (or more)  of those
  3094.              files is  missing.  In this  case,  ALLFIX will  automatically
  3095.              remove the  netmail. This feature  can be disabled  by setting
  3096.              this option to "Yes".
  3097.  
  3098.         ALLFIX priority (ALLFIX/2 and ALLFIX/U)
  3099.  
  3100.              The priority at  which an ALLFIX task should run. Valid values
  3101.              are -31  to  +31, where  -31  is the  lowest  and +31  is  the
  3102.              highest priority. If you are using ALLFIX/U, then the  session
  3103.              priority is only changed when you are running it under OS/2.
  3104.  
  3105.         RP priority (ALLFIX/2 and ALLFIX/U)
  3106.  
  3107.              The priority at  which the request processor in  ALLFIX should
  3108.              run. Valid values are -31 to +31, where  -31 is the lowest and
  3109.              +31 is the highest priority.  If you are using ALLFIX/U,  then
  3110.              the session priority is only  changed when you are running  it
  3111.              under OS/2.
  3112.  
  3113.         Last hard drive
  3114.  
  3115.              During   a   session,  ALLFIX   often   changes  the   current
  3116.              directories  on your  hard drives.  ALLFIX stores  the current
  3117.              directories on all  drives before it  begins and will  restore
  3118.              those directories  when it  finishes. This  way, you will  not
  3119.              notice that any of the  current directories has changed.  When
  3120.              storing  the  directories, ALLFIX  runs  through  all of  your
  3121.              drives,  from A  to Z.  It will store  the directory  for each
  3122.              "hard drive",  by attempting to  detect which ones  are floppy
  3123.              drives and which  ones are CD-ROM  drives. ALLFIX has  trouble
  3124.              recognizing  CD-ROM changers. This results in  each of the CD-
  3125.              ROM  drives on  the chagner  to be  accessed each  time ALLFIX
  3126.              starts up. This  is obviously very annoying. This field can be
  3127.              used to identify  the drive letter  of the last  harddrive. If
  3128.              you use a CD-ROM changer, then  you will probably want to fill
  3129.              in this field. This field  is currently not used for  anything
  3130.              else.
  3131.  
  3132.         Keep exported messages
  3133.  
  3134.              ALLFIX  can toggle the Kill/Sent flag on all generated netmail
  3135.              messages  if this  option  is  turned on.  The  effect of  the
  3136.              Kill/Sent  flag is that  all the  messages will be  deleted by
  3137.              the mailer after they have been sent out. 
  3138.                             
  3139.         Days to keep on hold
  3140.  
  3141.              This  is the  number  of  days that  ALLFIX  should keep  file
  3142.              attach messages  on  hold  for  downlinks. If  a  file  attach
  3143.              message is found that is older  than the value of this  field,
  3144.  
  3145.                                         49
  3146.  
  3147.  
  3148.  
  3149.  
  3150.  
  3151.  
  3152.  
  3153.              in number of days,  then it will be  deleted. A value of  zero
  3154.              disables  this  option.  This  option  is  not  available  for
  3155.              BinkleyTerm, Portal of Power, and D'Bridge mailer systems.
  3156.  
  3157.         Size of stat file
  3158.  
  3159.              ALLFIX also maintains  a statistics file  that can be  used by
  3160.              third party programs  to derive statistical information  about
  3161.              the flow of files.  ALLFIX stores information about  each file
  3162.              processed in this  database. This option  will set a  limit to
  3163.              the size of  the statistics file.  A statistics file  will not
  3164.              be maintained if a value  of zero is entered. The name  of the
  3165.              statistics file  is STATFILE.FIX and the associated index file
  3166.              is  STATFILE.IDX.  The statistics  file  can  be packed  using
  3167.              FIXUTIL.
  3168.  
  3169.         UTC offset
  3170.  
  3171.              This  field  specifies the  difference,  in  number of  hours,
  3172.              between  local  time and  Greenwich  mean  time (UTC).  Values
  3173.              between -12 and  +12 may be entered. Central European Time is,
  3174.              for example, +1 and Eastern Standard Time is -5.
  3175.  
  3176.              This particular  field is  necessary to calculate  the correct
  3177.              time stamp in  the .TIC files and to determine the appropriate
  3178.              release date for pre-released software (explained later).
  3179.  
  3180.              ALLFIX  can   also  use  the  TZUTC  environment  variable  to
  3181.              determine the  UTC  offset. If  this  environment variable  is
  3182.              set, ALLFIX  will use that instead, overwriting whatever value
  3183.              has been  defined in  ASETUP. The  format of this  environment
  3184.              variable can be seen in the following examples:
  3185.  
  3186.              SET TZUTC=+0100          1 hour ahead of UTC
  3187.              SET TZUTC=-0500          5 hours behind UTC.
  3188.  
  3189.              Lastly, if the  TZUTC environment  variable is  not set,  then
  3190.              ALLFIX will also check to  see if the TZ environment  variable
  3191.              is set. This variable can  also be used to specify  the number
  3192.              of  hours  before   or  ahead  of  UTC.  The  format  of  this
  3193.              environment variable (in simplified form)  can be seen in  the
  3194.              following examples:
  3195.  
  3196.              SET TZ=CET+1             Time  zone  CET, one  hour  ahead  of
  3197.              UTC.
  3198.              SET TZ=EST-6             Time zone EST, 6 hours before UTC.
  3199.  
  3200.         Max Msg size
  3201.  
  3202.              This  field can  be used  to define  the  maximum size  of any
  3203.              created messages.  Many mail  tossers can not  handle messages
  3204.              larger than  16kb. This field  accepts values  0 and 4  to 64.
  3205.              The values entered are kilobytes.  A 0 means that there is  no
  3206.              limit to the maximum size. All messages will be split  up into
  3207.              chunks that are approximately the size as specified here.
  3208.  
  3209.  
  3210.                                         50
  3211.  
  3212.  
  3213.  
  3214.  
  3215.  
  3216.  
  3217.  
  3218.         Next invoice number
  3219.  
  3220.              This field  represents  the next  invoice  number that  ALLFIX
  3221.              will use  in the next  bill. The invoice number  can be placed
  3222.              in a bill  using the @invoicenr macro (for more information on
  3223.              macro  commands, see  section 97).  ALLFIX will  automatically
  3224.              increment  the invoice  number  each  time  a  bill  has  been
  3225.              created.
  3226.  
  3227.         Speech friendly
  3228.  
  3229.              If this  option is  turned on (i.e.  set to Yes),  then ASETUP
  3230.              will  use BIOS  calls  to write  many of  the  things that  it
  3231.              writes  to the screen.  The affect is  that speech recognition
  3232.              software  can "see"  the  text  being  written by  ASETUP  and
  3233.              "speak" it. This  feature should be turned on for any visually
  3234.              impaired users who use a speech recognition system.
  3235.  
  3236.         Disable auto clean up
  3237.  
  3238.              Normally, ALLFIX  will automatically  delete a netmail  if the
  3239.              associated  file   attach  is  missing.  This  option  can  be
  3240.              disabled using this field.
  3241.  
  3242.         Add tear and origin (ALLFIX!)
  3243.  
  3244.              This  option  determins whether  or not  ALLFIX! should  add a
  3245.              tear line and an origin line to echomail messages.
  3246.  
  3247.  
  3248.         6.3.10    Miscellaneous
  3249.  
  3250.         6.3.10.1  Log options
  3251.  
  3252.         This menu contains  fields that control which  activities are added
  3253.         to the log file and which are not. 
  3254.  
  3255.         Inbound activity
  3256.  
  3257.              Inbound Fileecho and Magic filename activity.
  3258.  
  3259.         Outbound activity
  3260.  
  3261.              Outbound Fileecho and Magic filename activity.
  3262.  
  3263.         Maintenance activity
  3264.  
  3265.              Archive conversion and other maintenance activities.
  3266.  
  3267.         Security violations
  3268.  
  3269.              Security violations.
  3270.  
  3271.         AreaMgr activity
  3272.  
  3273.              AreaMgr activities.
  3274.  
  3275.                                         51
  3276.  
  3277.  
  3278.  
  3279.  
  3280.  
  3281.  
  3282.  
  3283.         Notify activity
  3284.  
  3285.              Notify activities.
  3286.  
  3287.         Move rcvd files
  3288.  
  3289.              Move rcvd file activities.
  3290.  
  3291.         Move bad TIC files
  3292.  
  3293.              Move bad TIC file activities.
  3294.  
  3295.         FileFind rejected
  3296.  
  3297.              Rejected FileFind messages.
  3298.  
  3299.         FileFind created
  3300.  
  3301.              Created FileFind replies.
  3302.  
  3303.         New file reports
  3304.  
  3305.              The creation of new file reports.
  3306.  
  3307.         External Hatch
  3308.  
  3309.              External Hatch activities.
  3310.  
  3311.         Path statements
  3312.  
  3313.              The path statements in the .TIC files.
  3314.  
  3315.         Debug
  3316.  
  3317.              All of the above.
  3318.  
  3319.  
  3320.         6.3.10.2  AreaMgr options
  3321.  
  3322.         This menu contains  a number of  options that control  the behavior
  3323.         of the AreaMgr.
  3324.  
  3325.         Allow %+ALL
  3326.  
  3327.              Should a system  be able to use  the %+ALL command  to connect
  3328.              all available areas.
  3329.  
  3330.         Allow %NOTIFY
  3331.  
  3332.              Should a system be able  to use the %NOTIFY command  to toggle
  3333.              the notify option.
  3334.  
  3335.         Allow %PASSWORD
  3336.  
  3337.              Should  a system  be  able  to use  the  %PASSWORD command  to
  3338.              change the areamgr password.
  3339.  
  3340.                                         52
  3341.  
  3342.  
  3343.  
  3344.  
  3345.  
  3346.  
  3347.  
  3348.         Allow %ECHOPASSWORD
  3349.  
  3350.              Should a system  be able to  use the %ECHOPASSWORD  command to
  3351.              change the fileecho password.
  3352.  
  3353.         Allow %MESSAGE
  3354.  
  3355.              Should a system be able to  use the %MESSAGE command to toggle
  3356.              the netmail announcement feature.
  3357.  
  3358.         Allow %COMPRESSION
  3359.  
  3360.              Should  a system be  able to  use the %COMPRESSION  command to
  3361.              change the archiver for the TicPack options.
  3362.  
  3363.         Allow %TICK
  3364.  
  3365.              Should a system  be able  to use the  %TICK command to  toggle
  3366.              the Tic file option.
  3367.  
  3368.         Allow %PAUSE
  3369.  
  3370.              Should  a  system  be  able  to  use  the  %PAUSE  command  to
  3371.              temporarily turn  off all the  areas. If  this is set  to 'No'
  3372.              then  ALLFIX  will  also prevent  the  system  from  using the
  3373.              %RESUME command.
  3374.  
  3375.         Allow %PACK
  3376.  
  3377.              Should a  system be able  to use  the %PACK command  to change
  3378.              the packing mode for his/her system.
  3379.  
  3380.         Keep requests
  3381.  
  3382.              Should  ALLFIX   keep  or   delete   AreaMgr  requests   after
  3383.              processing them.
  3384.  
  3385.         Keep receipts
  3386.  
  3387.              Should ALLFIX toggle the KILL flag for any AreaMgr receipts.
  3388.  
  3389.         Auto-add nodes
  3390.  
  3391.              If this  option is turned  on, then ALLFIX  will automatically
  3392.              add unknown systems  (who sent an AreaMgr request) to the node
  3393.              manager.  Automatically added  systems receive  access to  the
  3394.              public  groups defined below. This option is only available in
  3395.              the registered version.
  3396.  
  3397.         Public groups
  3398.  
  3399.              This is a list  of groups that ALL  nodes in the node  manager
  3400.              have access to!
  3401.  
  3402.         AreaMgr recognition string
  3403.  
  3404.  
  3405.                                         53
  3406.  
  3407.  
  3408.  
  3409.  
  3410.  
  3411.  
  3412.  
  3413.              These  five  fields  are  available for  defining  alternative
  3414.              names that the AreaMgr  will respond to. ALLFIX  automatically
  3415.              responds to  the  name "ALLFIX".  Other  possible names  could
  3416.              include "RAID" or "FILEMGR", without the quotes.
  3417.  
  3418.  
  3419.         6.3.10.3  Edit days
  3420.  
  3421.         This menu contains  fields where the  names of the  days of a  week
  3422.         can be entered in the local language.
  3423.  
  3424.  
  3425.         6.3.10.4  Edit months
  3426.  
  3427.         This menu contains  fields where  the names  of the  months of  the
  3428.         year can be entered in the local language.
  3429.  
  3430.  
  3431.         6.3.10.5  Exclude files
  3432.  
  3433.         Within  this  menu  it  is  possible  to  define  up  to   20  file
  3434.         specifications  that  should  not  be  included  in  any  new  file
  3435.         reports. 
  3436.  
  3437.         Any DOS  wildcard  is allowed,  as well  as  the following  special
  3438.         wildcards:
  3439.  
  3440.         @         Any  alphabetical  character,  including  extended  ASCII
  3441.                   characters.
  3442.  
  3443.         #         Any numerical character. 
  3444.  
  3445.         For example: Files  like NODEDIFF.A11 will be excluded from the new
  3446.         file reports  if the file specification NODEDIFF.A## is included in
  3447.         this list, but NODEDIFF.ARJ would, in this case, be included.
  3448.  
  3449.  
  3450.         6.3.10.6  ASETUP colors
  3451.  
  3452.         This  menu  contains  one  menu to  customize  the  colors  used in
  3453.         ASETUP,  four preselected schemes  that match up  with some popular
  3454.         programs, and  one  monochrome color  scheme.  The customized  menu
  3455.         also contains the ability to define the background character.
  3456.  
  3457.  
  3458.         6.4  FileFind areas
  3459.  
  3460.         This menu is  where the  message areas  that ALLFIX  is allowed  to
  3461.         scan for FileFind requests has to be configured. Up to 255  message
  3462.         areas may be defined. 
  3463.  
  3464.         The  message area  configuration is stored  in the  AREAS.FIX file.
  3465.         Index information is stored in AREAS.IDX.
  3466.  
  3467.         Following is a description of all the fields in this menu.
  3468.  
  3469.  
  3470.                                         54
  3471.  
  3472.  
  3473.  
  3474.  
  3475.  
  3476.  
  3477.  
  3478.         Comment
  3479.  
  3480.              This field offers the  user the ability to enter a  comment or
  3481.              description  of the  current area.  The comment  is completely
  3482.              ignored by  ALLFIX, except for  the fact  that it  is used  to
  3483.              sort the areas.
  3484.  
  3485.         Scan
  3486.  
  3487.              This field  designates  the message  area  that ALLFIX  should
  3488.              scan for FileFind requests. This entry must be filled in.
  3489.  
  3490.         Reply
  3491.  
  3492.              This field  designates  the message  area  that ALLFIX  should
  3493.              write the replies in. If this field is left empty then  ALLFIX
  3494.              will write the  replies in the same message area as configured
  3495.              in the previous field. The  netmail folder can be selected  as
  3496.              a destination message base.
  3497.  
  3498.         Fileareas
  3499.  
  3500.              Within this menu,  the file areas,  that ALLFIX is  allowed to
  3501.              scan for this FileFind message area, can be configured. 
  3502.  
  3503.              ALLFIX can handle  up to  64000 file  areas. The  up and  down
  3504.              arrow keys  can be used  to scroll  through the  list of  file
  3505.              areas. 
  3506.  
  3507.              The following other keys are available:
  3508.  
  3509.              ENTER, SPACE
  3510.  
  3511.                   The enter  key or the  space bar can  be used to  turn an
  3512.                   area on or off. 
  3513.  
  3514.              F2
  3515.  
  3516.                   Turn all the  areas on or  off. If one  area is on,  then
  3517.                   the rest  will be  turned on.  If all the  areas are  on,
  3518.                   then they will all be turned off. 
  3519.  
  3520.         Origin
  3521.  
  3522.              This  field  designates the  origin  line  that ALLFIX  should
  3523.              append to FileFind replies created in this area.
  3524.  
  3525.         Use Aka
  3526.  
  3527.              This field designates  the aka that ALLFIX should use for this
  3528.              echomail area.
  3529.  
  3530.         Template
  3531.  
  3532.              This  field designates  the template  file that  ALLFIX should
  3533.              use  when generating replies  in this  area. If this  field is
  3534.  
  3535.                                         55
  3536.  
  3537.  
  3538.  
  3539.  
  3540.  
  3541.  
  3542.  
  3543.              left  empty,  then ALLFIX will  automatically use the standard
  3544.              FILEFIND  template,  which is  delivered  with  ALLFIX in  the
  3545.              TEMPLATE.ZIP archive.
  3546.  
  3547.         Files
  3548.  
  3549.              This  field determines  how  many  files  are  allowed  to  be
  3550.              included in a reply message to  a FileFind request. A value of
  3551.              zero  means that  the  default  value of  15  files per  reply
  3552.              should be used. The maximum value that can be entered  in this
  3553.              field is 99.
  3554.  
  3555.         Inactive
  3556.  
  3557.              This field determines whether  ALLFIX will process this  area.
  3558.              A value of Yes will temporarily disable this FileFind area.
  3559.  
  3560.  
  3561.         6.5  Fileecho system
  3562.  
  3563.         6.5.1     Fileecho manager
  3564.  
  3565.         Within this menu up to 32000 fileecho areas can be defined.
  3566.  
  3567.         The  fileecho  area  configuration   is  stored  within  the   file
  3568.         FAREAS.FIX. The index information is stored in FAREAS.IDX.
  3569.  
  3570.         The following is a description of the fields in this menu.
  3571.  
  3572.         Tag
  3573.  
  3574.              This  field contains  fileecho  tag,  which may  be  up to  40
  3575.              characters  long.   Any  spaces  entered  in  this  field  are
  3576.              automatically converted to underscores.
  3577.  
  3578.         Desc
  3579.  
  3580.              This  field  contains the  description  of  the fileecho.  The
  3581.              description  is  used in  AreaMgr  replies  and  in  new  file
  3582.              reports.
  3583.  
  3584.         Dest
  3585.  
  3586.              This  field contains  the directory  where files  belonging to
  3587.              this fileecho  are  stored. It  is  recommended that  absolute
  3588.              pathnames  are used (ie. paths starting  with a drive letter).
  3589.              ALLFIX does  not  have  a  problem  with  relative  pathnames,
  3590.              however, if ALLFIX  is started up  from another drive,  then a
  3591.              large number of  problems can occur because ALLFIX will not be
  3592.              able to find those directories.
  3593.  
  3594.         Use FDB (not ALLFIX!)
  3595.  
  3596.              This  option  tells  ALLFIX  if  it   should  update  the  BBS
  3597.              specific, usually binary, file  database. This option is  only
  3598.              visible for  those BBS systems  where it  is necessary.  Those
  3599.  
  3600.                                         56
  3601.  
  3602.  
  3603.  
  3604.  
  3605.  
  3606.  
  3607.  
  3608.              system that use a FILES.BBS file will not see this feature.
  3609.  
  3610.         Use FBBS (not ALLFIX!)
  3611.  
  3612.              This option  determins if  ALLFIX should update  the FILES.BBS
  3613.              files. This option  is independant of  the Use FDB  option. If
  3614.              the Use FDB option  is also turned on, ALLFIX will update both
  3615.              types  of file  databases. Please  note that  this feature  is
  3616.              only visible if the "Use  FDB" option is visible, and that  it
  3617.              is limited to the registered version of ALLFIX.
  3618.  
  3619.         Group
  3620.  
  3621.              This field contains the group to which  this fileecho belongs.
  3622.              Groups  are  used to  categorize  fileechos  and to  designate
  3623.              which downlinks have access to which fileechos.
  3624.  
  3625.         Keep #
  3626.  
  3627.              This field contains  a value that  tells ALLFIX how  to import
  3628.              the files into the file database. 
  3629.  
  3630.              A value of -1  will tell ALLFIX to append the entry to the end
  3631.              of the file database. 
  3632.  
  3633.              A value of 0  will tell ALLFIX to  attempt to insert sort  the
  3634.              new file. 
  3635.  
  3636.              A value of  1-99 will tell ALLFIX to insert  sort the new file
  3637.              and to remove  all but that number of files  with similar file
  3638.              specifications. ALLFIX  will sort  all the files  matching the
  3639.              file  specification  and delete  the  oldest  files. The  file
  3640.              specification is determined by replacing  every alphanumerical
  3641.              character with the  '?' wildcard. For example, if a value of 5
  3642.              is  entered,  and the  NODEDIFF.A12  is  being imported,  then
  3643.              ALLFIX  will  make  sure  that  there  are  not  more  than  5
  3644.              NODEDIFF.A??  files   in  the  filearea  after  importing  the
  3645.              current file. 
  3646.  
  3647.              Insert sorting  means that  ALLFIX will  attempt to place  the
  3648.              file  in the file  database in lexicographical  order. This is
  3649.              accomplished  by comparing  filenames. If a  suitable position
  3650.              can not be found,  then ALLFIX will append an entry to the end
  3651.              of  the file  database. ALLFIX  will only  perform the  insert
  3652.              sort for BBS systems that use a text  file system for the file
  3653.              database. The new  file information  will be  appended to  the
  3654.              end of the file database for all other BBS systems. 
  3655.  
  3656.              If a file is  already in the  file database, then ALLFIX  will
  3657.              replace  that entry, regardless  of whether an  insert sort is
  3658.              being performed or not.
  3659.  
  3660.         Template
  3661.  
  3662.              This  field contains  the name  of the  template file  to send
  3663.              along  with all forwarded files in this fileecho. The template
  3664.  
  3665.                                         57
  3666.  
  3667.  
  3668.  
  3669.  
  3670.  
  3671.  
  3672.  
  3673.              file will be  included as text  in the associated  file attach
  3674.              message, if  appropriate, otherwise a new netmail message will
  3675.              be  created.  ALLFIX will  only  send the  template  files for
  3676.              those systems that have the  Template option turned on in  the
  3677.              Node manager (section 6.10).
  3678.  
  3679.         Banner
  3680.  
  3681.              This field contains the name of the template  file to use when
  3682.              adding banners to archives. 
  3683.  
  3684.         Use aka
  3685.  
  3686.              This field  contains  the aka  that should  be  used for  this
  3687.              area. It is recommended that aka matching be selected.
  3688.  
  3689.         LongDesc
  3690.  
  3691.              This field tells  ALLFIX what kind  of description to  use for
  3692.              files processed  in this  fileecho. There are  three different
  3693.              types of  interrelated  descriptions. The  first  type is  the
  3694.              normal  description  that is  stored  in  the .TIC  file.  The
  3695.              second type of description is  the long description stored  in
  3696.              the .TIC  files. The last type is  the FILE_ID.DIZ description
  3697.              file  that is  frequently included  within the  file archives.
  3698.              This option is  used to define  priority levels for  each type
  3699.              of description. If  the first one  is not available,  then the
  3700.              second one will be used. For example: if  FILE_ID.DIZ/LDESC is
  3701.              selected,  then  ALLFIX  will  first  attempt  to  import  the
  3702.              FILE_ID.DIZ  description file.  If  that  description  is  not
  3703.              available, then ALLFIX will  use long description included  in
  3704.              the .TIC file.  As a last  resort, ALLFIX will use  the normal
  3705.              description included in the .TIC file.
  3706.  
  3707.              When ALLFIX tries  to import the FILE_ID.DIZ file, and it does
  3708.              not exist, ALLFIX will create one and add it to the archive.
  3709.  
  3710.         Cost
  3711.  
  3712.              This menu  item  contains several  fields  that determine  the
  3713.              cost  of  files  processed  in  this  area.  Each  system,  if
  3714.              participating in the cost sharing,  has to share the cost  the
  3715.              file. The cost of  a file can be assigned to  a file using the
  3716.              options in this  menu. Incoming files may already have a cost,
  3717.              which is specified in the  .TIC file. The "Inc cost"  (include
  3718.              cost) option can be  used to determine if the cost in the .TIC
  3719.              file  should be added  to the  cost for the  downlinks. ALLFIX
  3720.              will  add  the  "Add  perc." percentage  to  the  cost  of the
  3721.              incoming file before  adding the "Unit cost".  The "Add perc."
  3722.              option can be used to compensate for  currency exchange rates.
  3723.              The unit cost  depends on the  "Unit size". Valid  options for
  3724.              the unit size are 100kb, 1024kb, or the entire file. 
  3725.  
  3726.              After the cost  of the file  has been calculated,  it will  be
  3727.              divided among  the downlinks depending  on the setting  of the
  3728.              "Div cost"  option. If  the "Div cost"  option is set  to "C/S
  3729.  
  3730.                                         58
  3731.  
  3732.  
  3733.  
  3734.  
  3735.  
  3736.  
  3737.  
  3738.              nodes" then the  cost will be divided  among all the  nodes in
  3739.              the  system list  that participate  in  the cost  sharing (ie.
  3740.              have their "Billing" option set  to "Yes"). If the "Div  cost"
  3741.              option is  set to "All  nodes" then the  cost will  be divided
  3742.              among all  the nodes in  the system  list. If  the "Div  cost"
  3743.              option is set to  "No" then the cost  will not be divided  and
  3744.              each node will  be charged the calculated cost. If the setting
  3745.              of the  "Div cost" option is  "C/S nodes" or "All  nodes" then
  3746.              ALLFIX will add one to  the number of systems by which  it has
  3747.              to divide the  cost unless the  file is being hatched  or this
  3748.              fileecho is  a pass through  fileecho. This  ensures that  the
  3749.              cost is also shared by the local system.
  3750.  
  3751.              ALLFIX  will also use  these cost variables  when processing a
  3752.              %RESEND AreaMgr command  (see section 7.4).  The cost that  is
  3753.              charged to the  system requesting a  resend is the  unit cost,
  3754.              again divided by the number of downlinks.
  3755.  
  3756.         RAID
  3757.  
  3758.              RAID, a program  that has AreaMgr  functionality which can  be
  3759.              used in conjunction  with TICK has  set a number  of standards
  3760.              concerning how  the FILEBONE.??  files are setup.  These files
  3761.              contain lists of  all of the  fileechos that are  available on
  3762.              the  backbone. The  settings in this  menu are  primarily used
  3763.              for  generating  FILEBONE.??  files.   How  to  do  this,   is
  3764.              explained  later on  in this  manual. Two  of the  settings in
  3765.              this  menu "Hatching"  and  "Return channel"  are used  by the
  3766.              AreaMgr  to determine the  access level  to assign to  the new
  3767.              node.  If "Hatching"  is set  to "Anyone  may hatch"  then the
  3768.              Receive from  status is  turned on  for the  node, and  if the
  3769.              "Return channel"  option  is set  to "No",  then  the Sent  to
  3770.              status  is turned  on  for  the  node.  For  a  more  complete
  3771.              explanation of these settings,  please see the chapter on  how
  3772.              to generate FILEBONE.?? files.
  3773.  
  3774.         Max days
  3775.  
  3776.              The maximum  number of  days a file  is allowed  to reside  in
  3777.              this fileecho.
  3778.  
  3779.         Max size
  3780.  
  3781.              The maximum number  of kilobytes that are allowed to reside in
  3782.              this fileecho.
  3783.  
  3784.         Max file
  3785.  
  3786.              The  maximum number  of files  that are  allowed to  reside in
  3787.              this fileecho.
  3788.  
  3789.         Systems
  3790.  
  3791.              Within this  menu it is possible to  define up to 255 downlink
  3792.              systems from which files are received. 
  3793.  
  3794.  
  3795.                                         59
  3796.  
  3797.  
  3798.  
  3799.  
  3800.  
  3801.  
  3802.  
  3803.         6.5.1.1   Advanced options
  3804.  
  3805.         The following options can be found within the Advanced sub-menu:
  3806.  
  3807.         Convert
  3808.  
  3809.              This  field is used  to select  an archive format  that ALLFIX
  3810.              should convert incoming archives to.  If this feature is being
  3811.              used, then ALLFIX  will attempt to  create the new  archive in
  3812.              the  destination directory,  so that  it does  not have  to be
  3813.              copied afterwards, which will enhance the performance.
  3814.  
  3815.         Convert all
  3816.  
  3817.              This  field is used  to tell  ALLFIX to convert  archives that
  3818.              are  already of  the  same  type as  in  the above  configured
  3819.              field.  For example: If  ZIP is  selected as Convert  type and
  3820.              this field is set  to "No", then ALLFIX will not convert *.ZIP
  3821.              files.  However, if this  field is  set to "Yes",  then ALLFIX
  3822.              will also convert *.ZIP files. 
  3823.  
  3824.         Convert inc
  3825.  
  3826.              This field  is used to tell  ALLFIX if it should  also convert
  3827.              archives within archives.  If this field is set to Yes, ALLFIX
  3828.              will convert  archive  within  an  archive  to  the  specified
  3829.              compression format.
  3830.  
  3831.         Comp unknown
  3832.  
  3833.              This field tells  ALLFIX if it should  compress unknown files.
  3834.              If  this field is  set to  Yes, it  will compress  any unknown
  3835.              archives  to the specified  format. For  example, if  the file
  3836.              EXAMPLE.TXT is  received, ALLFIX would  compress it in  a file
  3837.              called EXAMPLE.ZIP.  This  feature is  only  available in  the
  3838.              registered version of ALLFIX.
  3839.  
  3840.         Pass through
  3841.  
  3842.              This field  is used  to tell  ALLFIX NOT to  import the  file.
  3843.              This field is  necessary for fileechos  that are passed  on to
  3844.              others, but are  not desired for  the local system.  All files
  3845.              received  in  this  fileecho  will  be  copied  to  the  queue
  3846.              directory from  where they will  be forwarded to  the downlink
  3847.              systems. The files  will be deleted  from the queue  directory
  3848.              after each downlink system has received the file.
  3849.  
  3850.              When  you turn  a Passthru  fileecho off,  and  no destination
  3851.              directory has  been  defined for  this  fileecho, ASETUP  will
  3852.              automatically calculate a  destination directory  for you.  It
  3853.              will determine  the destination  directory based on  the group
  3854.              and the settings for that group.
  3855.  
  3856.         Allow replace
  3857.  
  3858.              This field tells ALLFIX if  it should honor the Replaces  verb
  3859.  
  3860.                                         60
  3861.  
  3862.  
  3863.  
  3864.  
  3865.  
  3866.  
  3867.  
  3868.              (section 4.1.1) in the .TIC files for this fileecho. 
  3869.  
  3870.         Announce
  3871.  
  3872.              This field tells  ALLFIX if files received in this area should
  3873.              be appended to  the new file  report database. Files  added to
  3874.              this database can  later be announced in echomail areas or via
  3875.              netmail with the "Announce" command.
  3876.  
  3877.         Add FILE_ID
  3878.  
  3879.              This field tells  ALLFIX if it  should add a  FILE_ID.DIZ file
  3880.              to an archive that does not  contain one. This option can also
  3881.              be set to  "Always", in which case, ALLFIX will always replace
  3882.              (or  add)   a  FILE_ID.DIZ  file  to  the   archive.  In  both
  3883.              situations, the  description is taken  from the .TIC  file. If
  3884.              the .TIC file  has a long  description (see Ldesc  verb), then
  3885.              that will be used.  If it does not,  then the normal one  line
  3886.              description will be used.
  3887.  
  3888.         Virus scan
  3889.  
  3890.              This  field tells ALLFIX  if incoming files  should be scanned
  3891.              for viruses. If  the Convert option is being used, then ALLFIX
  3892.              will scan the files during archive conversion. 
  3893.  
  3894.         Dupe check
  3895.  
  3896.              This  field tells ALLFIX  if files processed  in this fileecho
  3897.              should be checked for duplicates.
  3898.  
  3899.         Visible
  3900.  
  3901.              Normally,  only fileechos  that  a system  has  access to  are
  3902.              included  in AreaMgr  replies (section  7.4). Sometimes  it is
  3903.              desirable to include  a number of  areas that the  person does
  3904.              not have  access  to, a  sort of  advertisement,  so that  the
  3905.              system  knows what other areas are available. This field tells
  3906.              ALLFIX  that  this fileecho  may  be included  in  the AreaMgr
  3907.              replies. The actual  purpose of this  field is a  bit outdated
  3908.              with the  new macro  language. Please  consult the  chapter on
  3909.              the macro language for more details.
  3910.  
  3911.         Tiny SB
  3912.  
  3913.              This  field tells  ALLFIX  to strip  everyone from  the seenby
  3914.              listing that  is  not  connected  to  the  local  system.  The
  3915.              purpose of this  option is to  strip away unnecessary  systems
  3916.              from the  seenby listings.  This option  is not necessary  for
  3917.              most situations.
  3918.  
  3919.         No Touch
  3920.  
  3921.              This field tells  ALLFIX if it should update the file database
  3922.              for this particular  fileecho. If this  field is set  to "No",
  3923.              then ALLFIX WILL update the file  database (ie. No No Touch  =
  3924.  
  3925.                                         61
  3926.  
  3927.  
  3928.  
  3929.  
  3930.  
  3931.  
  3932.  
  3933.              Yes Touch). If  this field is set  to "Yes", then  ALLFIX WILL
  3934.              NOT  update the file  database for  this fileecho (ie.  Yes No
  3935.              Touch = No Touch).
  3936.  
  3937.         Security
  3938.  
  3939.              This field tells ALLFIX is  it should check incoming files  to
  3940.              make sure  that they come  from a  system in the  systems list
  3941.              with  the  appropriate  status.  ALLFIX  will  ALWAYS  require
  3942.              systems, from whom  files are received to be configured in the
  3943.              Node  manager. If this option is set to "Yes" then ALLFIX will
  3944.              also  require that the  system is  listed in the  Systems list
  3945.              with the correct status.
  3946.  
  3947.         Send original
  3948.  
  3949.              This  field tells  ALLFIX  that each  file  processed in  this
  3950.              fileecho should be copied  to the queue directory,  from which
  3951.              it will  be forwarded  to the  downlinks. A  copy of the  file
  3952.              will be imported  in the configured directory. If  the Convert
  3953.              option is being  used, then the  original file will  be copied
  3954.              to the queue directory and  the converted file will be  placed
  3955.              in the  destination directory.  With this option,  changes can
  3956.              be made  to imported  files  after ALLFIX  has processed  them
  3957.              without jeopardizing the outbound files.
  3958.  
  3959.         Add pic specs
  3960.  
  3961.              This  field tells  ALLFIX  to  append  the  GIF  or  JPG  file
  3962.              specifications to  the  beginning of  the  description of  any
  3963.              incoming .GIF or .JPG files.  The format of the specifications
  3964.              is as follows:
  3965.  
  3966.              ("width"x"height"x"number of colors")
  3967.  
  3968.              The  picture specifications  will ONLY  be appended  if ALLFIX
  3969.              does not  detect  any specifications  already  present in  the
  3970.              description. In other  words, the description will be  left in
  3971.              its original form if it already contains the specifications.
  3972.  
  3973.         Update magic
  3974.  
  3975.              This  field tells ALLFIX  if it  should update the  alias file
  3976.              for  this fileecho  when it  encounters .TIC  files containing
  3977.              the Magic verb (section 4.1.1). 
  3978.  
  3979.         Touch AV
  3980.  
  3981.              If this  field  is set  to  Yes, ALLFIX  will  not convert  or
  3982.              update AV protected archive files.
  3983.  
  3984.         No Hold dir
  3985.  
  3986.              In  the Node  manager,  it  is possible  to  assign a  holding
  3987.              directory  to a  particular  node. This  means that  all files
  3988.              will  be copied to  that directory  instead of being  sent via
  3989.  
  3990.                                         62
  3991.  
  3992.  
  3993.  
  3994.  
  3995.  
  3996.  
  3997.  
  3998.              the  normal method (being  a netmail  file attach, or  via the
  3999.              Internet). With  this option,  this particular feature  can be
  4000.              disabled  for  a particular  fileecho.  That means  that  if a
  4001.              system  has  a  holding  directory,  the  files  received  and
  4002.              forwarded in  this  particular fileecho,  will  not be  copied
  4003.              into  that holding  directory,  but  sent  via a  normal  file
  4004.              attach.
  4005.  
  4006.  
  4007.         6.5.1.2   Global editing
  4008.  
  4009.         Using the global  edit functions, you can make changes to more than
  4010.         one fileecho  at the same time.  Using the global edit  function is
  4011.         very  intuitive. By  pressing  F2  you are  presented  with a  menu
  4012.         containing important fileecho options.  Select the option that  you
  4013.         wish to  change, enter the  change, and  then press  ESC. You  will
  4014.         then  be presented  with  a  list of  groups.  After selecting  the
  4015.         groups  that need  to be  changed, you  will be  able to  select or
  4016.         remove other  individual fileechos.  Press ESC after  selecting the
  4017.         fileechos to  change  and ASETUP  will make  the  changes to  those
  4018.         fileechos.
  4019.  
  4020.         You  can use  the global  edit routines to  add, remove,  or change
  4021.         systems in  the system  lists. You  can change  the address or  the
  4022.         status of  a system.  There are two  ways to  set the  status of  a
  4023.         system  when changing  the  status or  adding a  new system  to the
  4024.         system lists. When adding a system or changing the status, you  can
  4025.         set the status fields to  the desired value. All fields  are blank,
  4026.         by  default. Blanks  means  "leave  this field  as  is", which  is,
  4027.         obviously, only  applicable when  changing the status  because when
  4028.         adding  a new  system, all  fields are  set to  No. If  all  of the
  4029.         status  fields  are  left  blank, then  ASETUP  will  use  the RAID
  4030.         settings for each respective fileecho to determine what the  status
  4031.         settings  should  be.  If  you  make  extensive  use  of  the  RAID
  4032.         settings, then this is the preferred feature to use. If you do  not
  4033.         use the RAID settings, then you should  select the status fields as
  4034.         desired.
  4035.  
  4036.  
  4037.         6.5.1.3   Fileecho options
  4038.  
  4039.         This menu  contains a  number of  options that  are related  to the
  4040.         fileecho system.
  4041.  
  4042.         Keep original file date
  4043.  
  4044.              When ALLFIX imports files  in the BBS, it will reset  the file
  4045.              date and time.  BBS systems that do not store this information
  4046.              in  the file  database,  such as  any  system using  FILES.BBS
  4047.              files, determine if  a file is new (for a  user) by looking at
  4048.              the  file date. In  such situations  it is almost  a necessity
  4049.              that  the  date  and  time  of a  file  be  reset  when  it is
  4050.              imported. Other  BBS  systems store  this  information in  the
  4051.              file database. These  systems do not  require that the  actual
  4052.              file date be altered.  This option should be set  to "Yes" for
  4053.              systems in the later category.
  4054.  
  4055.                                         63
  4056.  
  4057.  
  4058.  
  4059.  
  4060.  
  4061.  
  4062.  
  4063.         Download counters
  4064.  
  4065.              The download counters  that ALLFIX should append before a file
  4066.              description  when  importing  the file.  Leaving  this  option
  4067.              blank disables this feature.
  4068.  
  4069.         Update DESCRIPT.ION
  4070.  
  4071.              4DOS has the ability to store descriptions of  files in a file
  4072.              called  DESCRIPT.ION,  which  is  stored  in  each  directory.
  4073.              ALLFIX can  update that particular file, when importing files,
  4074.              if this option is turned on.
  4075.  
  4076.         Number of systems
  4077.  
  4078.              This option can  be used to set the  maximum number of systems
  4079.              that can entered in the  system list in the fileecho  manager.
  4080.              The  maximum  is,  by  default,  set to  255  systems.  ASETUP
  4081.              reserves space in each fileecho record for that  many systems.
  4082.              Changing this  limit to something  less than  255 will  reduce
  4083.              the size of  the fileecho records. This will effectively speed
  4084.              up ALLFIX and free up more space on your harddisk.
  4085.  
  4086.         Inv. .?LO file ext.
  4087.  
  4088.              This feature,  only available  when using a  BinkleyTerm style
  4089.              mailer, identifies  the extension of an invalidated flow file,
  4090.              for example "N?O".
  4091.  
  4092.         Dupe checking
  4093.  
  4094.              Duplicate   file  checking   may  be   necessary  in   certain
  4095.              situations. ALLFIX  is capable of storing information about an
  4096.              almost unlimited  number of files for duplicate file checking,
  4097.              without compromising performance. This  option can be used  to
  4098.              specify  what  ALLFIX should  check, when  it is  checking for
  4099.              duplicate files. 
  4100.  
  4101.         Min HD space to import
  4102.  
  4103.              When  importing  a  file,  ALLFIX  will  check the  amount  of
  4104.              available  space  on the  destination  drive.  If this  amount
  4105.              minus the size of  the current file is  less than the in  this
  4106.              field configured value, then ALLFIX  will not import the file.
  4107.              If the value zero is entered,  then ALLFIX will only check  to
  4108.              see if there is enough  space available to import the  current
  4109.              file. The value  entered in this field represents  the minimum
  4110.              number of kilobytes  that must be available on the destination
  4111.              drive. The  value  must be  either  0 or  be  between 100  and
  4112.              65535.
  4113.  
  4114.         Max TIC archive size
  4115.  
  4116.              This option sets  a limit to  the size of  a TIC archive.  TIC
  4117.              archives contain  .TIC  files  and/or  files  destined  for  a
  4118.              particular system.  Files  that are  larger  than the  maximum
  4119.  
  4120.                                         64
  4121.  
  4122.  
  4123.  
  4124.  
  4125.  
  4126.  
  4127.  
  4128.              size will not be  added to a TIC archive. ALLFIX will create a
  4129.              new TIC archive with a  different name each time the  addition
  4130.              of a file,  whose size is  less than  the maximum size,  would
  4131.              result in a TIC archive whose size is larger  than the maximum
  4132.              size entered  in this field.  Each time  ALLFIX has  to add  a
  4133.              file  to a  TIC archive,  it will  search  for the  first one,
  4134.              destined  to that system,  that has  enough room left  for the
  4135.              current file.
  4136.  
  4137.              If a value of  zero is entered in this field, then there is no
  4138.              limit on the maximum size of a TIC archive.
  4139.  
  4140.              A  unique name  is calculated  for each  system, based  on the
  4141.              network address.  The extension  of the archive  is determined
  4142.              by the number of TIC archives waiting to  be picked up by that
  4143.              system  and  the  archive type.  For  example,  the  first TIC
  4144.              archive for a system has  the extension .C00, the second  one,
  4145.              .C01. 
  4146.  
  4147.         Max sizes to pack
  4148.  
  4149.              This option  sets a limit  to the size  of the files  that are
  4150.              included in the TIC archives. If the size of a file is  larger
  4151.              than the  value entered  in this  field, then  it will not  be
  4152.              added  to the  TIC archive  and a  normal file  attach message
  4153.              will  be  created  instead.  A value  of  zero  disables  this
  4154.              feature.
  4155.  
  4156.         Sort by groups
  4157.  
  4158.              This feature tells  ALLFIX to sort the fileechos by the groups
  4159.              and then by the name  instead of simply sorting the  fileechos
  4160.              by  the   name.  When   changing  this  option,   ASETUP  will
  4161.              automatically re-index the fileechos.
  4162.  
  4163.         TIC archive specs
  4164.  
  4165.              This field can be used to define file specs that identify  TIC
  4166.              archives.  Some  fileecho  processors  use   different  naming
  4167.              conventions  for TIC  archives  than ALLFIX.  If  you have  an
  4168.              uplink who uses such a tool, it may be necessary to enter  the
  4169.              filespec here,  so that  ALLFIX  will automatically  recognize
  4170.              and unpack  the TIC archive. You can enter multiple filespecs,
  4171.              seperating them with commas.
  4172.  
  4173.  
  4174.         Filter ANSI (not ALLFIX!)
  4175.  
  4176.              This  option   will  remove  any   ANSI  codes  from   a  long
  4177.              description.
  4178.  
  4179.         Filter LongDesc (not ALLFIX!)
  4180.  
  4181.              This option has  three different functions.  First, it can  be
  4182.              used  to strip  all the  higher ASCII  characters from  a long
  4183.              description. Second, it  can be used to strip the higher ASCII
  4184.  
  4185.                                         65
  4186.  
  4187.  
  4188.  
  4189.  
  4190.  
  4191.  
  4192.  
  4193.              characters  and the  carriage  returns, and  third, it  can be
  4194.              used  to  just   strip  the  carriage  returns  from   a  long
  4195.              description. 
  4196.  
  4197.              Long descriptions  frequently contain  high ASCII  characters.
  4198.              If  new  file reports  are  generated, then  those  high ASCII
  4199.              characters   must  be  stripped  from  the  description.  This
  4200.              particular  function will  be performed  when this  option has
  4201.              been  turned  on.  ALLFIX will,  in  the  process, attempt  to
  4202.              format  the  resulting  description  by  converting   any  TAB
  4203.              characters to  a single space  and removing  any extra  spaces
  4204.              between text and borders  created with high ASCII  characters.
  4205.              The ability to strip the  carriage returns will further ensure
  4206.              that  the description  is formatted correctly  after stripping
  4207.              the higher ascii characters.
  4208.  
  4209.  
  4210.         Add tag to desc
  4211.  
  4212.              ALLFIX  can place the  fileecho tag  before or after  the file
  4213.              description.   The   fileecho  tag   is   added  as   follows:
  4214.              (AREA:{fileecho  tag}).   You  the  options   "Before+CR"  and
  4215.              "CR+After" will  add  a carriage  return after  or before  the
  4216.              tag, respectively,  there by  placing  the tag  on a  seperate
  4217.              line.
  4218.  
  4219.         Set uploader to
  4220.  
  4221.              This feature is only  available to people who use a BBS system
  4222.              that has  a specific field for  the uploader name in  the file
  4223.              database  files. The  valid options  are setting  the uploader
  4224.              name to the name "ALLFIX", the name of the SysOp, or the  name
  4225.              of the current fileecho.
  4226.  
  4227.         Filter strings
  4228.  
  4229.              There are three  fields available  where the  user can  define
  4230.              special  strings   that  should  be  stripped  from  the  long
  4231.              descriptions.  These  strings can  contain  special characters
  4232.              such as wildcards or  sets in to order to build specific masks
  4233.              which can  be  used to  remove BBS  specific  color codes  and
  4234.              other information from a long description. 
  4235.  
  4236.              The wildcard '*' means  one or more and the  wildcat '?' means
  4237.              exactly  one.  A  wildcard  can  be  used  as  many  times  as
  4238.              necessary in specifying a mask.  The wildcard '*' can also  be
  4239.              used  to  indicate  one  or  more  occurances  of  the  symbol
  4240.              preceeding it.
  4241.  
  4242.              A  set is defined  by enclosing  the characters to  search for
  4243.              within square brackets. For  example, matching any letter  'A'
  4244.              to 'Z' can  be specified as:  [A..Z]. Matching the  letters A,
  4245.              C, and E can be specified as: [A,C,E].
  4246.  
  4247.              A  '^' character  can be  used to  indicate that  a particular
  4248.              string  should not be  in a  mask. For example,  the following
  4249.  
  4250.                                         66
  4251.  
  4252.  
  4253.  
  4254.  
  4255.  
  4256.  
  4257.  
  4258.              mask  could be  used  to  match anything  that  begins with  a
  4259.              capital letter 'A': 
  4260.  
  4261.              ^A[A..Z]* 
  4262.  
  4263.              The following example removes  all occurances of strings  that
  4264.              begin with and  end with a '@' character and contain uppercase
  4265.              letters between the two '@' characters:
  4266.  
  4267.              @[A..Z]*@
  4268.  
  4269.              The above example  can be read as  a string starting  with the
  4270.              character  '@' followed by  one or  more letters in  the range
  4271.              'A' to 'Z' and terminated with a '@' character.
  4272.  
  4273.         6.5.1.4   LongDesc options
  4274.  
  4275.         This  menu  contains  the  options  that  affect  the  way  a  Long
  4276.         Description is imported  into a  text based  file database  system.
  4277.         The last menu  item in this menu, with the  name "Show example" can
  4278.         be used to preview  the way that ALLFIX would import a  file with a
  4279.         long  description into the BBS system that you use (as defined with
  4280.         FCOMP).
  4281.  
  4282.         LongDesc character (not ALLFIX!)
  4283.  
  4284.              This field  defines the  character ALLFIX should  place before
  4285.              multiline  descriptions  to  signal   to  the  BBS  that   the
  4286.              following text  belongs  to the  description  of the  previous
  4287.              file. This particular  field is only necessary for BBS systems
  4288.              that store the  file directory information in  text files (for
  4289.              example, SuperBBS, PCBoard, Spitfire etc). 
  4290.  
  4291.              Below  is a  list  of  BBS  types  and  the  correct  LongDesc
  4292.              character:
  4293.  
  4294.              PCBoard             |
  4295.  
  4296.              RemoteAccess 1.xx   +
  4297.  
  4298.              SpitFire             
  4299.  
  4300.              SuperBBS            >
  4301.  
  4302.              TBBS                !
  4303.  
  4304.              PowerBBS            [space]
  4305.  
  4306.              The description  will be placed immediately after the LongDesc
  4307.              character,  except  for PCBoard  systems,  in  which case  the
  4308.              LongDesc character will  be followed by  ONE space which  will
  4309.              then be followed by the description itself.
  4310.  
  4311.         Before (not ALLFIX!)
  4312.  
  4313.              This  option specifies the number of spaces that ALLFIX should
  4314.  
  4315.                                         67
  4316.  
  4317.  
  4318.  
  4319.  
  4320.  
  4321.  
  4322.  
  4323.              place before the  LongDesc character.  Normally, the  LongDesc
  4324.              character  should start on the second column, which means that
  4325.              there  should be one space  placed before the character. Below
  4326.              are the settings for some BBS programs: 
  4327.  
  4328.              PCBoard        31 
  4329.              SpitFire       0
  4330.              TBBS           0
  4331.              PowerBBS       32
  4332.  
  4333.         After (not ALLFIX!)
  4334.  
  4335.              This option specifies the number  of spaces that ALLFIX should
  4336.              place after the LongDesc character.  This value should be  set
  4337.              to 0 for  most BBS programs.  PCBoard systems should  set this
  4338.              value to 1.
  4339.  
  4340.         LongDesc width (not ALLFIX!)
  4341.  
  4342.              This  option  can   be  used  to  define  the  length  of  the
  4343.              description in the  file database. Please note that this field
  4344.              is  only necessary for  BBS systems  that use text  based file
  4345.              database files (such as .DIR  files for PCBoard and  FILES.BBS
  4346.              files  for RemoteAccess). If  a value  of 0 is  inserted here,
  4347.              ALLFIX will use the default value of 45.
  4348.  
  4349.         One line LongDesc (not ALLFIX!)
  4350.  
  4351.              ALLFIX will place  the entire long description on one line, if
  4352.              this option  is turned on.  Due to  a limitation in  the Turbo
  4353.              Pascal programming language,  the length of a line of text can
  4354.              not  be  longer  than   255  characters.  Therefore,  if   the
  4355.              description is longer  than 255 characters,  the rest will  be
  4356.              removed.  Only  text  based  filebase  systems  (such  as  the
  4357.              FILES.BBS system) are affected by this limitation.
  4358.  
  4359.         Max length of LongDesc
  4360.  
  4361.              Long descriptions  do  not have  a maximum  to  the number  of
  4362.              lines  they may  contain. This  particular field  controls the
  4363.              number of lines  that ALLFIX will process. Any more lines will
  4364.              be  ignored. A value  of zero ignores  the length  of the long
  4365.              description  and  it  will   therefore  be  imported  in   its
  4366.              entirety.  RemoteAccess 2.xx  is known  to have  problems with
  4367.              descriptions that are too  long. Therefore, it is  recommended
  4368.              that no  more than 10 lines  be processed, if that  BBS system
  4369.              is used.
  4370.  
  4371.         6.5.2     Hatch manager
  4372.  
  4373.         According to  the Webster's New World Dictionary,  the term "hatch"
  4374.         means  to  bring  into  existence.  Hatching,  in  the  context  of
  4375.         fileechos,  means  introducing files  into  a  fileecho, much  like
  4376.         writing a new message in a message echo.
  4377.  
  4378.         The  Hatch manager  is used  to tell ALLFIX  which files  should be
  4379.  
  4380.                                         68
  4381.  
  4382.  
  4383.  
  4384.  
  4385.  
  4386.  
  4387.  
  4388.         hatched on a  regular basis.  File specifications  can be  entered.
  4389.         Each  time files matching  the file specification  exist, they will
  4390.         automatically be hatched into the fileecho.
  4391.  
  4392.         The  hatch  manager  configuration  is stored  in  the  file called
  4393.         HATCH.FIX. Index information is stored in HATCH.IDX.
  4394.  
  4395.         The following is a description of the fields in this menu:
  4396.  
  4397.         Area
  4398.  
  4399.              This field contains the name of  the fileecho in which the  to
  4400.              be configured file specification should be hatched.
  4401.  
  4402.         Spec
  4403.  
  4404.              This field  contains  the file  specification  that should  be
  4405.              hatched. This field should  contain the complete path  and any
  4406.              necessary  DOS   wildcards.  Please  see   the  Hints  chapter
  4407.              (section 12.3) about hatching  files that are already  located
  4408.              in the destination directory of the fileecho.
  4409.  
  4410.         Desc
  4411.  
  4412.              This  field contains  the description of  the file.  There are
  4413.              several  meta  commands that  can  be  used to  customize  the
  4414.              description for each file hatched.
  4415.  
  4416.              /GET
  4417.  
  4418.                   Get the description from the file database.
  4419.  
  4420.              /REMOVE
  4421.  
  4422.                   Remove the description from the file database.
  4423.  
  4424.              %xx
  4425.  
  4426.                   Echo  the character at position  xx. This meta command is
  4427.                   useful  to  echo  version  numbers  and  dates  into  the
  4428.                   description. For example: The  combination %11%12 for the
  4429.                   file NODEDIFF.A12  would be converted to the string "12".
  4430.                   Values for %xx must be between 1 and 12.
  4431.  
  4432.              Please note that these macros  will not work for the  external
  4433.              HATCH program (HATCH.EXE).
  4434.  
  4435.         Days
  4436.  
  4437.              This field  is used to configure  the days on  which this file
  4438.              should be hatched. 
  4439.  
  4440.         Repl
  4441.  
  4442.              This field  contains  the file  specification  that the  newly
  4443.              hatched  file should  replace. The file  specification entered
  4444.  
  4445.                                         69
  4446.  
  4447.  
  4448.  
  4449.  
  4450.  
  4451.  
  4452.  
  4453.              in this field  will be removed from the file database. It will
  4454.              also be included in the .TIC file and it will be deleted  from
  4455.              the file  databases of  the downlink systems.  This particular
  4456.              option is  useful to  replace old  programs versions with  new
  4457.              ones. 
  4458.  
  4459.              If  the file  specification  entered in  this  field does  not
  4460.              contain wildcards, then  ALLFIX will  automatically enter  the
  4461.              name  of the current  file being  hatched in this  field. That
  4462.              means that the next time a file is hatched, the  replace field
  4463.              will contain the name of the previously hatched file. 
  4464.  
  4465.         Mgic
  4466.  
  4467.              This  field contains the  magic name  that should be  added to
  4468.              the alias file.  The string entered here will also be included
  4469.              in the .TIC file  and it will be added to  the alias files for
  4470.              all the downlink  systems, if the  option is enabled  at those
  4471.              systems.
  4472.  
  4473.         Always
  4474.  
  4475.              Sometimes  it   is   necessary  to   hatch   a  certain   file
  4476.              periodically.  If  the file  has  the same  name,  ALLFIX will
  4477.              reject it the second time  as a duplicate. In this  situation,
  4478.              this  field can  be  set to  Yes,  which will  tell ALLFIX  to
  4479.              process the file  regardless of whether  it is a  duplicate or
  4480.              not.
  4481.  
  4482.  
  4483.         Copy
  4484.              This  option tells  ALLFIX to  copy the  file to  the Fileecho
  4485.              destination  directory instead  of moving  it, as  it normally
  4486.              does. When  using this feature,  ALLFIX will turn  off archive
  4487.              file  attribute so  that it  knows that  the file  has already
  4488.              been hatched.
  4489.  
  4490.  
  4491.         6.5.3     Magic filenames manager
  4492.  
  4493.         The  Magic filename manager  offers the ability  to perform certain
  4494.         functions when special files are received in a certain fileecho.
  4495.  
  4496.         Up to 255 entries may be made.
  4497.  
  4498.         The  magic  file  configuration  is  stored  in  the   file  called
  4499.         MGICFILE.FIX. Index information is stored in MGICFILE.IDX.
  4500.  
  4501.         There are  fourteen  different functions  that  the Magic  filename
  4502.         manager can perform. Each function  requires different information,
  4503.         therefore  the   menu  will  change  depending  upon  the  selected
  4504.         function, here after referred to as the type of magic filename.
  4505.  
  4506.         More than one  entry can be made for the same filemask and the same
  4507.         fileecho.  Each  magic  filename configuration  will  be  executed.
  4508.         However, ALLFIX does  not always execute the magic filenames in the
  4509.  
  4510.                                         70
  4511.  
  4512.  
  4513.  
  4514.  
  4515.  
  4516.  
  4517.  
  4518.         same  order as  they  are  configured  in  this  menu.  Some  magic
  4519.         filename types  are executed  before ALLFIX begins  processing .TIC
  4520.         files.  Others are  executed before  processing a  particular file,
  4521.         and the rest are  processed after the file has been imported. It is
  4522.         not  important to know  which types are  executed when, as  long as
  4523.         none of  the configured types are  dependant on the  order in which
  4524.         they are executed.
  4525.  
  4526.         Each different Magic filename type has  different options that need
  4527.         to be configured. The following two options are the same  for every
  4528.         type, except for the PickUpFile and the ServiceReq option:
  4529.  
  4530.         File mask
  4531.  
  4532.              This field contains the  file specification that will  trigger
  4533.              this function.
  4534.  
  4535.         From area
  4536.  
  4537.              This  field contains the fileecho where ALLFIX should look for
  4538.              the above configured file mask.
  4539.  
  4540.  
  4541.         The following is a list of the different types  and the rest of the
  4542.         options that need to be defined.
  4543.  
  4544.         AdoptFile
  4545.  
  4546.              This  function can  be  used  to  copy  a  file  into  another
  4547.              fileecho. The effect  is such that  the file will  be imported
  4548.              into  the  appropriate  fileecho  and then  it  will  also  be
  4549.              imported into the new fileecho, specified with this function.
  4550.  
  4551.              To area
  4552.  
  4553.                   This  field  contains  the  fileecho  into  which  ALLFIX
  4554.                   should copy the above configured file mask.
  4555.  
  4556.         CopyFile
  4557.  
  4558.              This  function can  be  used  to  copy  a  file  into  another
  4559.              directory.
  4560.  
  4561.              Directory
  4562.  
  4563.                   This field  contains  the directory  to  which the  above
  4564.                   configured file mask should be copied.
  4565.  
  4566.         DeleteFile
  4567.  
  4568.              This  function can be  used to  delete an incoming  file mask,
  4569.              which means that  it will not  be forwarded nor  imported into
  4570.              the file database. This type does not have any other options.
  4571.  
  4572.         ExecCommand
  4573.  
  4574.  
  4575.                                         71
  4576.  
  4577.  
  4578.  
  4579.  
  4580.  
  4581.  
  4582.  
  4583.              This  function  can  be  used  to  execute  a  number  of  DOS
  4584.              commands. 
  4585.  
  4586.              Command
  4587.  
  4588.                   This field  contains  the  DOS  command  that  should  be
  4589.                   executed.  Multiple dos commands should be separated with
  4590.                   a semicolon,  ';'.  The following  meta  commands may  be
  4591.                   used in this field.
  4592.  
  4593.                   %F   The  complete  path  and filename  of  the  imported
  4594.                        file.
  4595.  
  4596.                   %P   The complete  path without  the trailing  backslash,
  4597.                        '\'.
  4598.  
  4599.                   %N   The  complete name  of the  file, not  including the
  4600.                        extension.
  4601.  
  4602.                   %E   The complete  extension of  the file,  not including
  4603.                        the dot, '.'
  4604.  
  4605.                   %D   The day number, 1-365.
  4606.  
  4607.                   %A   The fileecho tag.
  4608.  
  4609.              New task (ALLFIX/2)
  4610.  
  4611.                   This field  determines if ALLFIX  should start  up a  new
  4612.                   process  for executing  these commands.  If the  value of
  4613.                   this field  is set  to Foreground  or Background, then  a
  4614.                   new process will be started  and ALLFIX will continue  as
  4615.                   either a foreground or background  process, respectively.
  4616.                   If this field  is set to  None, then ALLFIX  will execute
  4617.                   the  commands and  wait until  they are  finished, before
  4618.                   continuing.
  4619.  
  4620.  
  4621.         ForwardTo
  4622.  
  4623.              This function  can be used  to forward  an incoming file  to a
  4624.              number of systems that are not listed in  the systems list for
  4625.              the respective fileecho.
  4626.  
  4627.              Export
  4628.  
  4629.                   This field contains  a list of systems to which the above
  4630.                   configured file mask  should be sent,  along with a  .TIC
  4631.                   file.
  4632.  
  4633.         HatchNew
  4634.  
  4635.              This  function can  be  used  to  hatch  new  files  from  the
  4636.              destination directory  of the configured  fileecho. Each  time
  4637.              any new  files exist in  the destination directory,  they will
  4638.              automatically be  hatched. The file descriptions will be taken
  4639.  
  4640.                                         72
  4641.  
  4642.  
  4643.  
  4644.  
  4645.  
  4646.  
  4647.  
  4648.              from the file database.
  4649.  
  4650.              Days
  4651.  
  4652.                   This  field  contains the  days  on  which ALLFIX  should
  4653.                   check the  destination directory of this fileecho for new
  4654.                   files.
  4655.  
  4656.         KeepNum
  4657.  
  4658.              This function  can  used to  change  the  Keep #  value  of  a
  4659.              particular file mask. The Keep  # feature is explained in  the
  4660.              previous chapter on the fileecho manager (section 6.5.1).
  4661.  
  4662.              Keep #
  4663.  
  4664.                   This field contains the new value for the Keep # field.
  4665.  
  4666.         MoveToArea
  4667.  
  4668.              This function can  be used to  move a file  from one  fileecho
  4669.              into another  one. Any file  coming in the  specified fileecho
  4670.              will be moved  into the new fileecho. Please note that it will
  4671.              NOT be processed in its original fileecho.
  4672.  
  4673.              To area
  4674.  
  4675.                   This  field  contains  the  fileecho  into  which  ALLFIX
  4676.                   should move the above configured file mask.
  4677.  
  4678.         NoForward
  4679.  
  4680.              This function can  be used to prevent ALLFIX from forwarding a
  4681.              particular  file  mask.  This type  does  not  have  any other
  4682.              options.
  4683.  
  4684.         OtherPath
  4685.  
  4686.              This function can be used  to import a file into  a directory,
  4687.              other  than   the  normal  destination   directory  for   that
  4688.              particular fileecho.
  4689.  
  4690.              Directory
  4691.  
  4692.                   This  field  contains  the  alternative  directory  where
  4693.                   ALLFIX  should import  this file  to. ALLFIX  will update
  4694.                   the  appropriate file  database that  belongs to  the new
  4695.                   directory.
  4696.  
  4697.         PassThruFile
  4698.  
  4699.              This  function can be  used to  process certain file  masks as
  4700.              pass  through  files,  which  means  that  they  will  not  be
  4701.              imported into the file database.  This type does not have  any
  4702.              other options.
  4703.  
  4704.  
  4705.                                         73
  4706.  
  4707.  
  4708.  
  4709.  
  4710.  
  4711.  
  4712.  
  4713.         PickUpFile
  4714.  
  4715.              This  function can  be used  to automatically  forward  a file
  4716.              mask  to  a  list  of  systems  without  hatching  it  into  a
  4717.              fileecho.  This means that  a .TIC  file will not  be included
  4718.              with the forwarded files.
  4719.  
  4720.              Directory
  4721.  
  4722.                   This field  contains  the directory  where ALLFIX  should
  4723.                   look for the above file mask.
  4724.  
  4725.              Export
  4726.  
  4727.                   This field contains  a list of systems to which this file
  4728.                   mask should be forwarded.
  4729.  
  4730.         SendOnFreq
  4731.  
  4732.              This function  can  be used  to  automatically send  files  or
  4733.              messages with a  file request. You can enter the filemask that
  4734.              ALLFIX should match. 
  4735.  
  4736.              Template
  4737.  
  4738.                   The template to send with  the file request. The template
  4739.                   is expanded before sending it to the requesting system.
  4740.  
  4741.              File
  4742.  
  4743.                   The file(s) to  send with the file  requets. Please enter
  4744.                   the complete name and filename or file specification.
  4745.  
  4746.              Example,  if you  enter NODEDIFF.*  and someone  file requests
  4747.              NODEDIFF.A12, then  ALLFIX would  send the file(s)  and/or the
  4748.              template configured here.
  4749.  
  4750.         ServiceReq
  4751.  
  4752.              This feature is only available in registered mode.
  4753.  
  4754.              This function can be used  to execute a specific program  when
  4755.              a  magic filename  is requested. This  feature could  be used,
  4756.              for example, to  allow a registration  site to file  request a
  4757.              new key for  a new user.  A service request  is given a  magic
  4758.              name, which can  be defined in this menu. Each service request
  4759.              has a password,  which the user must also provide. The program
  4760.              that has  to be executed  can also be defined.  It is possible
  4761.              that the program  needs a number of command line options which
  4762.              may need to be provided by  the user. This can be using an  at
  4763.              symbol, '@'.  For each  '@' character, that  ALLFIX encounters
  4764.              in the command line, ALLFIX  will use the next string  entered
  4765.              by  the user. For  example, let  us assume that  the following
  4766.              has been entered as the command to execute:
  4767.  
  4768.              D:\REG\KEYGEN %s %a @ @
  4769.  
  4770.                                         74
  4771.  
  4772.  
  4773.  
  4774.  
  4775.  
  4776.  
  4777.  
  4778.              In the above example, the  two '@' characters are expanded  to
  4779.              the two strings  which were file  requested by the  system. In
  4780.              order to execute  this service request, the user would have to
  4781.              "file request"  the service  request name, password,  and also
  4782.              two other "magic  names" which are  password on to  the KEYGEN
  4783.              program by ALLFIX. 
  4784.  
  4785.              For example:
  4786.  
  4787.                   FREQ:     KEYGEN !PASSWORD Harald Harms
  4788.  
  4789.              In  the   above  example,  the  service  request  "KEYGEN"  is
  4790.              executed. Since  the command line  for the program  to execute
  4791.              contains two '@' characters, the next two  "magic names" which
  4792.              are "requested" are  passed to the  KEYGEN program as  command
  4793.              line options.
  4794.  
  4795.              Below is a list of the options in this menu:
  4796.  
  4797.              Alias
  4798.  
  4799.                   The name of  this service request. In  the example above,
  4800.                   the Alias is "KEYGEN".
  4801.  
  4802.              Password
  4803.  
  4804.                   The password  required to  execute this  service request.
  4805.                   In the example above, the password is "PASSWORD".
  4806.  
  4807.              Command
  4808.  
  4809.                   The command to execute for  this service request. In  the
  4810.                   example above, the command is "D:\REG\KEYGEN %s %a @  @".
  4811.                   The  %s and  %a  macros are  expanded  to the  requesting
  4812.                   sysop name and aka, respectively.
  4813.  
  4814.              Directory
  4815.  
  4816.                   After  the command  has been  executed, ALLFIX  will scan
  4817.                   this directory for any  files. ALLFIX will send  whatever
  4818.                   is contained  in this directory to the requesting system.
  4819.                   The  files will be  deleted after  they are sent!  In the
  4820.                   above  example, the  program KEYGEN may  place a  new key
  4821.                   file in  this  directory. This  means  that when  someone
  4822.                   request a key, they automatically get a new keyfile.
  4823.  
  4824.  
  4825.         UnpackFile
  4826.  
  4827.              This  function can  be  used to  unpack  a  file mask  into  a
  4828.              special directory.
  4829.  
  4830.              Directory
  4831.  
  4832.                   This field  contains  the directory  to  which the  files
  4833.                   matching the file mask should be unpacked.
  4834.  
  4835.                                         75
  4836.  
  4837.  
  4838.  
  4839.  
  4840.  
  4841.  
  4842.  
  4843.         UpdateAlias
  4844.  
  4845.              This function can  be used to update  the alias file with  the
  4846.              currently  imported file.  ALLFIX will  search the  alias file
  4847.              for any  files  with the  same  directory as  the  destination
  4848.              directory of  the currently  selected fileecho and  a filename
  4849.              that matches  the in the  next field configured  filemask. Any
  4850.              files that meet  both requirements will be  updated. This type
  4851.              does not have any other options.
  4852.  
  4853.  
  4854.         6.5.4     Group manager
  4855.  
  4856.         Each time that a  new fileecho is automatically added by  ALLFIX or
  4857.         a new entry  is made  in the  fileecho manager,  ALLFIX and  ASETUP
  4858.         have the ability  to use default settings which  can be defined per
  4859.         group within this menu. 
  4860.  
  4861.         Whenever a new  fileecho is received,  ALLFIX will select  a group,
  4862.         based  on the fileecho  tag, and use  the settings  defined in that
  4863.         group for the new fileecho.
  4864.  
  4865.         Whenever a new entry is made  in the fileecho manager, ASETUP  will
  4866.         prompt the user for a group. When a  group is selected, the default
  4867.         options belonging to that group will be  used for the new fileecho.
  4868.         The  default settings,  defined in  the fileecho  manager, will  be
  4869.         used if no group is selected.
  4870.  
  4871.         The group manager looks  a lot like the fileecho manager. There are
  4872.         three options  specific to the group,  the rest of the  options are
  4873.         default fileecho settings.
  4874.  
  4875.         The following is a  explanation of the six options  for the groups.
  4876.         An  explanation for the  rest of  the options  can be found  in the
  4877.         chapter discussing the fileecho manager (section 6.5.1).
  4878.  
  4879.         Group
  4880.  
  4881.              This field designates  the group. An  undefined group must  be
  4882.              selected from the list of possible groups (0-255).
  4883.  
  4884.         Name
  4885.  
  4886.              This field  contains the name  of the group.  An example of  a
  4887.              group name might be "WINNET file distribution". 
  4888.  
  4889.         Mask
  4890.  
  4891.              This  field  contains  a  mask, which  is  similar  to  a file
  4892.              specification used to  determine which group an  automatically
  4893.              added fileecho  should belong  to.  The mask  may contain  the
  4894.              wildcards '*' and '?'. ALLFIX  will try select the group  with
  4895.              the best match. 
  4896.  
  4897.              For example:  Consider  the following  two  masks: "TIC*"  and
  4898.              "TIC*ST".  ALLFIX will select  the group with  the second mask
  4899.  
  4900.                                         76
  4901.  
  4902.  
  4903.  
  4904.  
  4905.  
  4906.  
  4907.  
  4908.              if  a  new  fileecho  is  automatically  added  with the  name
  4909.              "TICTEST".
  4910.  
  4911.              It is possible to enter more than one mask,  by seperating the
  4912.              values  with a  semi-colon or  a comma.  For example,  for the
  4913.              mask "WIN*,OS2", ALLFIX will  add all fileechos starting  with
  4914.              the string "WIN" or the string "OS2" to that group.
  4915.  
  4916.         Uplink
  4917.  
  4918.              This  field defines  which uplink  files  should come  from in
  4919.              order  to auto-add  them  to  this group.  It  is possible  to
  4920.              select  "Anyone" or to  select one  of the uplinks  defined in
  4921.              the uplink systems menu (see below).
  4922.  
  4923.         Unique
  4924.  
  4925.              This  field determines  if a  new directory  is made  for each
  4926.              fileecho  auto-added to this  group. If  this field is  set to
  4927.              Yes,   then  ALLFIX  will  make  a  new  directory  under  the
  4928.              destination directory  entered for  this group. If  this field
  4929.              is  set to No,  then the  destination directory for  all auto-
  4930.              added fileechos will be the same as  the destination directory
  4931.              for this group.
  4932.  
  4933.         Add BBS
  4934.  
  4935.              This  determins if ALLFIX should automatically  add a new file
  4936.              area  to the BBS  whenever it  auto-adds a new  fileecho. This
  4937.              particular feature  is currently  available for the  following
  4938.              BBS types:
  4939.  
  4940.              RemoteAccess,
  4941.              Maximus,
  4942.              Concord,
  4943.              PCBoard,
  4944.              Renegade,
  4945.              ProBoard,
  4946.              TriBBS,
  4947.              SpitFire,
  4948.              TAG,
  4949.              ShotGun,
  4950.              QuickBBS, and
  4951.              SearchLight
  4952.  
  4953.              Please  note  that  this  feature  is  only  available in  the
  4954.              registered version of ALLFIX.
  4955.  
  4956.         BBS Mask
  4957.  
  4958.              If  the "Add BBS" option turned on,  ALLFIX uses this field to
  4959.              determine which BBS  file area it  should use for  the default
  4960.              values  of the new  file area. All of  the options that ALLFIX
  4961.              does not know,  will be copied from this particular file area.
  4962.              Please note that the  number of the file area  must be entered
  4963.              in  this field.  ALLFIX will  read through  the BBS  file area
  4964.  
  4965.                                         77
  4966.  
  4967.  
  4968.  
  4969.  
  4970.  
  4971.  
  4972.  
  4973.              configuration and it will  only add a new area if an area does
  4974.              not already exist pointing  the the destination directory  for
  4975.              the new fileecho.
  4976.  
  4977.              If a value of 0  is entered in this field, ALLFIX will not use
  4978.              another BBS area as the template for the new area.
  4979.  
  4980.              For those  people who use  TAG, please  enter a value  that is
  4981.              one  larger than the  actual file  area number, as  defined in
  4982.              the BBS. This  is necessary  because TAG  starts counting  the
  4983.              file  areas at 0. ALLFIX assumes that 0 means that this option
  4984.              is disabled.  Therefore, file  area 0 should  be entered  into
  4985.              this  field as file  area one.  All other area  numbers should
  4986.              also be incremented with 1.
  4987.  
  4988.         It  should be mentioned  that the "Systems"  field, can be  used to
  4989.         specify  the people  that should  automatically be  connected to  a
  4990.         fileecho when auto-adding  a fileecho which  has been selected  for
  4991.         this group. The "Systems"  list in, in this context, is not used as
  4992.         a list where the possible uplinks are defined.
  4993.  
  4994.         6.5.5     Uplink manager
  4995.  
  4996.         New fileechos can be requested with the help  of the AreaMgr. If an
  4997.         unknown area  is requested,  ALLFIX can automatically  request that
  4998.         area  from one  of  the available  uplink systems  (ie. one  of the
  4999.         systems where files  are received from).  Those uplink systems  can
  5000.         be configured within this menu. 
  5001.  
  5002.         The uplink system  is very  easy to use.  When an  unknown area  is
  5003.         requested,  ALLFIX  will select  a  system  defined in  the  uplink
  5004.         manager  to request the  new area  from. ALLFIX  will only  send an
  5005.         uplink  request for  a  new area  if  the requesting  node  has the
  5006.         "forward requests" option set to "Yes".  If that option is not  set
  5007.         to yes, then ALLFIX  will tell the node  that the area is  unknown.
  5008.         Whenever an  area  is  successfully  requested,  then  ALLFIX  will
  5009.         inform the  user that the  area has been requested  from the uplink
  5010.         system.
  5011.  
  5012.         The  selection process is a bit complex.  A fileecho areas list can
  5013.         be defined for each uplink  system. ALLFIX will scan through  those
  5014.         lists until it  finds the requested area. The person requesting the
  5015.         new area  must have access  to at least  one of the  groups defined
  5016.         for  the uplink  system,  otherwise ALLFIX  will  skip that  uplink
  5017.         system. If  the requested  area is  found in  one  of the  fileecho
  5018.         areas listings,  then the area  will be  requested. If the  area is
  5019.         not found, then ALLFIX will request the  new fileecho area from the
  5020.         first uplink system that has  the unconditional flag turned on  and
  5021.         at least one group to which the requesting system has access.
  5022.  
  5023.         Information  about  the requesting  system  will be  stored  in the
  5024.         ALLFIX.DAT file.  When  the first  files are  received  in the  new
  5025.         fileecho area, ALLFIX will automatically  add the new fileecho area
  5026.         to the configuration and  add the requesting system(s)  (since more
  5027.         than one  system may request  the new area  before the first  files
  5028.         have been received)  to the systems list. ALLFIX will determine the
  5029.  
  5030.                                         78
  5031.  
  5032.  
  5033.  
  5034.  
  5035.  
  5036.  
  5037.  
  5038.         group and the default fileecho  settings by selecting a group  from
  5039.         the  group manager. More  details about  the group manager  and how
  5040.         groups are  chosen  can be  found in  section  6.5.4. The  fileecho
  5041.         description used in the new  fileecho is selected in the  following
  5042.         order:
  5043.  
  5044.         1    From the .TIC file if the "areadesc" verb is available.
  5045.  
  5046.         2    From  the fileecho area  listing if the area  was found in one
  5047.              of the listings and a description was included. 
  5048.  
  5049.         3    From  the  group  defaults,  if  a  group  was  selected  (see
  5050.              previous chapter for more details).
  5051.  
  5052.         There  are two formats  supported for  the fileecho  areas listing.
  5053.         The  first  format   consists  of  a  list  of  fileechos  and  the
  5054.         corresponding descriptions. 
  5055.  
  5056.         Example:  [fileecho] [description]
  5057.  
  5058.         The second format is the format used by the FILEBONE.NA file:
  5059.  
  5060.         Example:  Area [fileecho]   [priv level]   [locks]   [description]
  5061.  
  5062.  
  5063.         Following is a description of all the fields.
  5064.  
  5065.         Uplink system
  5066.  
  5067.              The network address of the uplink system.
  5068.  
  5069.         AreaFix program
  5070.  
  5071.              The name that ALLFIX should  write the uplink request to.  For
  5072.              example,  the  string  "ALLFIX",  without  quotes,  should  be
  5073.              entered for uplink systems using ALLFIX.
  5074.  
  5075.         Password
  5076.  
  5077.              The  password that ALLFIX  should put  on the subject  line of
  5078.              the uplink request.
  5079.  
  5080.         Add '+' prefix
  5081.  
  5082.              Should  ALLFIX add  a  '+'  in front  of  fileecho tags.  Most
  5083.              modern AreaMgr  programs do not  require a '+',  but including
  5084.              it should not cause any problems.
  5085.  
  5086.         Authorized groups
  5087.  
  5088.              The requesting node must  have access to at least one of these
  5089.              groups.
  5090.  
  5091.         Unconditional
  5092.  
  5093.              Forward  all  requests   to  this  uplink,  as  long   as  the
  5094.  
  5095.                                         79
  5096.  
  5097.  
  5098.  
  5099.  
  5100.  
  5101.  
  5102.  
  5103.              requesting  system has  access  to one  of the  groups. ALLFIX
  5104.              will first  look in the Areas  file (see next option).  If the
  5105.              area  is listed  in  that  file,  then  ALLFIX  will  use  the
  5106.              description  from that  area as  the description  for the  new
  5107.              fileecho  (please  see  the  priorities  concerning  the   new
  5108.              description, explained  above). This option is  only available
  5109.              in the registered version.
  5110.  
  5111.         Areas filename
  5112.  
  5113.              File   containing  a  list  of  the  fileecho  tags  that  are
  5114.              available from this system.
  5115.  
  5116.         File format
  5117.  
  5118.              This is  the  type of  fileecho areas  listing  that is  being
  5119.              used.  Please  see  the  paragraph  above  for  the  supported
  5120.              formats.  The  fileecho areas  listing must  be stored  in the
  5121.              directory  configured  in the  Pathnames  (part  2) menu  (see
  5122.              section 6.3.3).
  5123.  
  5124.         Origin address
  5125.  
  5126.              The aka  to use for any  uplink requests. ALLFIX can  not rely
  5127.              on AKA matching  because fileechos from more than one zone may
  5128.              be received from  one system and the AreaMgr requests may need
  5129.              to originate from different AKAs  in order to signal the  zone
  5130.              for the requested area.
  5131.  
  5132.         Direct
  5133.  
  5134.              Use the direct flag for uplink request messages.
  5135.  
  5136.         6.5.6     Uplink options
  5137.  
  5138.         When the AreaMgr requests new fileechos  from your uplink(s), these
  5139.         requests  are stored in  the ALLFIX.DAT  file. They will  remain in
  5140.         that file until the first  files for those fileechos are  received.
  5141.         Sometimes  it  happens  that  the uplink  also  does  not  have the
  5142.         fileecho. In this menu there  are two options that determine  after
  5143.         how many days ALLFIX  should automatically re-request the  fileecho
  5144.         and how many times a  fileecho should be re-requested before  being
  5145.         removed from the ALLFIX.DAT database. These two options are:
  5146.  
  5147.         Re-request rate
  5148.  
  5149.              The number  of days to  wait before  re-requesting a  fileecho
  5150.              that has not been received yet.
  5151.  
  5152.         Re-request times
  5153.  
  5154.              The number  of times to re-request a fileecho, before deleting
  5155.              the request.
  5156.  
  5157.         This menu also contains the following options:
  5158.  
  5159.  
  5160.                                         80
  5161.  
  5162.  
  5163.  
  5164.  
  5165.  
  5166.  
  5167.  
  5168.         Auto remove passthru echos
  5169.  
  5170.              When  a system  removes him/herself  from a  passthru fileecho
  5171.              using the AreaMgr,  and this system  was the last  system that
  5172.              received   files  from   this   fileecho,  then   ALLFIX   can
  5173.              automatically disconnect this fileecho.  This is usefull since
  5174.              no one receives these  files anymore, not even yourself  since
  5175.              it  concerns   passthru  fileechos.  ALLFIX   disconnects  the
  5176.              fileecho by sending  an AreaMgr request to your uplink, and by
  5177.              deleting the fileecho in your configuration.
  5178.  
  5179.         Auto-add delay
  5180.  
  5181.              This  feature has  to  do  with the  previous  option. When  a
  5182.              fileecho has  been automatically  removed since the  last node
  5183.              disconnected him/herself,  it is possible that there are still
  5184.              some files  "in the pipeline"  which your system  will receive
  5185.              before your  uplink has disconnected this  fileecho. Normally,
  5186.              ALLFIX would  then automatically auto-add  the fileecho, which
  5187.              is obviously not desired. This  field can be used to  indicate
  5188.              how  long  ALLFIX should  wait  before  it  may  auto-add  the
  5189.              automatically deleted fileechos. If  for example, you set  the
  5190.              delay to  7  days, then  ALLFIX will  not  auto-add a  deleted
  5191.              fileecho, until  7 days have passed. ALLFIX will automatically
  5192.              re-request  the fileecho  when a  different node  requests the
  5193.              fileecho. When files  are received as a result of the request,
  5194.              ALLFIX will  automatically add the fileecho, regardless of the
  5195.              delay entered in this field.
  5196.  
  5197.  
  5198.         6.6  New file reports
  5199.  
  5200.         New file  reports are  message that  contain  a list  of new  files
  5201.         processed by a  system. The Announce feature was encountered in the
  5202.         fileecho manager  (section 6.5.1)  and again  in the group  manager
  5203.         (section  6.5.4). This  option determined  whether files  should be
  5204.         included the new file reports defined in this menu. 
  5205.  
  5206.         New  file reports  are defined by  selecting one or  more groups of
  5207.         fileechos that  should be  included in  the report. Up  to 255  new
  5208.         file reports may be defined. 
  5209.  
  5210.         The information concerning the files  that need to be announced  is
  5211.         stored in  the TOBEREP.FIX and  TOBEREP.IDX files. The  database is
  5212.         capable of storing up to 8000 files, no new files  will be added to
  5213.         the database  once it is full.  When the Announce command  is given
  5214.         (see  chapter concerning  the  ALLFIX commandline  options (section
  5215.         7), ALLFIX will announce  all the new files  according to the   new
  5216.         file reports configured  here. After the new file reports have been
  5217.         written,  the database is  emptied. Files belonging  to groups that
  5218.         are not defined  in a  new file report,  will be  removed from  the
  5219.         database. This  means  that  the  configuration  should  be  double
  5220.         checked, because otherwise valuable information may be lost. 
  5221.  
  5222.         The new  file  reports  configuration  is stored  within  the  file
  5223.         called REPORTS.FIX. Index information is stored in REPORTS.IDX.
  5224.  
  5225.                                         81
  5226.  
  5227.  
  5228.  
  5229.  
  5230.  
  5231.  
  5232.  
  5233.         The following is a description of the fields in this menu:
  5234.  
  5235.         Groups
  5236.  
  5237.              This  field contains  a  list  of the  groups  that should  be
  5238.              included in this new file report.
  5239.  
  5240.         Msg area
  5241.  
  5242.              This field contains  the message area  in which this  new file
  5243.              report  should be written.  The message area  may be disabled.
  5244.              If it is, then ALLFIX  will only send the new file  reports to
  5245.              the nodes included in the systems list.
  5246.  
  5247.         Use Aka
  5248.  
  5249.              This field contains the aka that should be used.
  5250.  
  5251.         Origin
  5252.  
  5253.              This field contains the origin line that should be used.
  5254.  
  5255.         Template
  5256.  
  5257.              This field contains the template file that should be used.
  5258.  
  5259.         From
  5260.  
  5261.              This field contains  the name that this new file report should
  5262.              be "from".
  5263.  
  5264.         To
  5265.  
  5266.              This field contains  the name that this new file report should
  5267.              be addressed to.
  5268.  
  5269.         Subject
  5270.  
  5271.              This field contains the subject of this new file report.
  5272.  
  5273.         Inactive
  5274.  
  5275.              This field can  be used to  temporarily disable this  new file
  5276.              report.  If the value of  this field is  Yes, then ALLFIX will
  5277.              not process this new file report.
  5278.  
  5279.         Systems
  5280.  
  5281.              This  field contains  a list  of systems  that should  receive
  5282.              netmail  copies of  this new  file report.  This field  may be
  5283.              left empty.
  5284.  
  5285.  
  5286.         6.7  BBS new file dirs
  5287.  
  5288.         Besides  being able to announce files received in fileechos, ALLFIX
  5289.  
  5290.                                         82
  5291.  
  5292.  
  5293.  
  5294.  
  5295.  
  5296.  
  5297.  
  5298.         is also capable  of announcing new files  that are uploaded  to the
  5299.         BBS. ALLFIX stores  information, in each filearea, about  the files
  5300.         contained  in that  directory. All  new files,  for the  file areas
  5301.         defined  in this menu, are added  to the new file reports database.
  5302.         Then, when  running  ALLFIX with  the Announce  command, these  new
  5303.         files will also be reported in the new file reports.
  5304.  
  5305.         Up to 1024 entries can be made within this menu.
  5306.  
  5307.         The BBS  new file dirs configurations is  stored in the file called
  5308.         NEWFILES.FIX. Index information is stored in NEWFILES.IDX.
  5309.  
  5310.         The following is a description of the fields in this menu.
  5311.  
  5312.         Group
  5313.  
  5314.              This field contains the group that this entry belongs to.
  5315.  
  5316.         Comment
  5317.  
  5318.              This field contains a comment for this entry.
  5319.  
  5320.         File areas
  5321.  
  5322.              This field contains the file areas that belong to this entry.
  5323.  
  5324.  
  5325.         6.8  Allfiles lists
  5326.  
  5327.         FIXUTIL is  capable  of generating  Allfiles  listings or  Newfiles
  5328.         listings.  An Allfiles list  is a complete  or partial  list of the
  5329.         files  on the BBS.  A Newfiles listing  is the same  as an Allfiles
  5330.         listing, except that only the files of the  last xxx number of days
  5331.         are included in the list, where xxx is a value between 1 and 365. 
  5332.  
  5333.         An  Allfiles  list has  a  Tag,  which identies  the  entry in  the
  5334.         database.  FIXUTIL can be  called up  with the  name of the  Tag to
  5335.         generate the Allfiles or Newfiles listing. 
  5336.  
  5337.         Up to 1024 entries can be made within this menu.
  5338.  
  5339.         The  Allfiles   configurations  is   stored  in  the   file  called
  5340.         ALLFILES.FIX. Index information is stored in ALLFILES.IDX.
  5341.  
  5342.         The following is a description of the fields in this menu.
  5343.  
  5344.         Tag
  5345.  
  5346.              This field contains  the Tag which identifies the entry in the
  5347.              database. A tag can contain  any type of string, for  example,
  5348.              "ALLFILES", or "ALLPICTURES".  The Tag is  used later to  tell
  5349.              FIXUTIL which allfiles listing to generate.
  5350.  
  5351.         File name
  5352.  
  5353.              This  field contains  the  name  of the  file  that should  be
  5354.  
  5355.                                         83
  5356.  
  5357.  
  5358.  
  5359.  
  5360.  
  5361.  
  5362.  
  5363.              created  by FIXUTIL.  The path  of to  the filename  to create
  5364.              should be  included. For example, the following filename could
  5365.              be entered: C:\FILES\TEXT\ALLFILES.TXT.
  5366.  
  5367.         Template
  5368.  
  5369.              This field  contains the  name of  the  template that  FIXUTIL
  5370.              should  use  to generate  the  Allfiles  or Newfiles  listing.
  5371.              Please see the sample  ALLFILES.APL and NEWFILES.APL  included
  5372.              in the TEMPLATE.ZIP archive for an example.
  5373.  
  5374.         Age
  5375.  
  5376.              This  field  determines  whether  an  Allfiles  listing  or  a
  5377.              Newfiles  listing will be  created. Enter  a value of  0 means
  5378.              that an Allfiles listing will be made, in other words, all  of
  5379.              the files  will  be included  in the  list.  Entering a  value
  5380.              between  1 and 365 means that only  those files that are newer
  5381.              than  the value entered  will be  included. For example,  if a
  5382.              list of all of the files received in the 30 days is  required,
  5383.              then the value 30 should be entered.
  5384.  
  5385.         File areas
  5386.  
  5387.              This submenu can be used to select  which file areas should be
  5388.              included  in  the Allfiles  or  Newfiles  listing. This  field
  5389.              makes it possible to make  listings of certain subsets of  the
  5390.              file areas available in the BBS. 
  5391.              ALLFIX can  handle up  to 64000  file areas. The  up and  down
  5392.              arrow keys  can be  used to  scroll through  the list of  file
  5393.              areas. 
  5394.  
  5395.              The following other keys are available:
  5396.  
  5397.              ENTER, SPACE
  5398.  
  5399.                   The enter  key or the  space bar can  be used to  turn an
  5400.                   area on or off. 
  5401.  
  5402.              F2
  5403.  
  5404.                   Turn all the  areas on or  off. If one  area is on,  then
  5405.                   the  rest will be  turned on.  If all  the areas  are on,
  5406.                   then they will all be turned off. 
  5407.  
  5408.  
  5409.         6.9  Request Processor
  5410.  
  5411.         ALLFIX  contains a  fully functional  request processor.  A request
  5412.         processor  is a program  that handles  file requests for  a mailer.
  5413.         Normally, a  mailer is capable of handling  file requests, however,
  5414.         external utilities often offer more features.
  5415.  
  5416.         The request processor  in ALLFIX is fully integrated with the other
  5417.         features in ALLFIX.  This means that  when someone file  requests a
  5418.         file from your  system, ALLFIX will send the person  a .TIC file if
  5419.  
  5420.                                         84
  5421.  
  5422.  
  5423.  
  5424.  
  5425.  
  5426.  
  5427.  
  5428.         the system is listed  in the Node manager, and ALLFIX will send the
  5429.         file description  of the  file regardless  of the  type of BBS  you
  5430.         use, as long as it is supported by ALLFIX.
  5431.  
  5432.         Please note  that the request  processor only  works if  you are  a
  5433.         registered ALLFIX user.
  5434.  
  5435.         In this particular menu, there are  a number of fields that control
  5436.         how ALLFIX works. 
  5437.  
  5438.         Active
  5439.  
  5440.              This field determines whether or  not the request processor is
  5441.              active.  If  you want  to be  able to  use the  ALLFIX request
  5442.              processor, then this field must be set to "Yes". 
  5443.  
  5444.         Report
  5445.  
  5446.              This field  can be used  to define  the template that  is used
  5447.              sent to a system after  processing a file request. Please  see
  5448.              the sample RPREPORT template for more details. 
  5449.  
  5450.              * note:   The standard  RPREPORT template  reports why a  file
  5451.                        request  failed. For example,  it will indicate that
  5452.                        the file  was  missing  or  that  the  password  was
  5453.                        wrong. For  security reasons, you may wish to change
  5454.                        the template  to only  indicate that  something went
  5455.                        wrong, without specifying what.
  5456.  
  5457.         Flag mode
  5458.  
  5459.              This  field determins the  types of  flags ALLFIX will  use in
  5460.              the  response  file  which  is  returned  to  the  mailer. The
  5461.              options are Default, Cantaloup, InterMail, or BBBS.
  5462.  
  5463.         CC sysop
  5464.  
  5465.              This field determins  if ALLFIX should send a carbon copy (CC)
  5466.              of all file request reports  to the SysOp. The CC, which  is a
  5467.              netmail, will  be  written to  a .PKT  file  which the  mailer
  5468.              tosser will toss to the  netmail folder. ALLFIX does not  make
  5469.              a  netmail  message  directly,  since  it  is  not  officially
  5470.              allowed, according to the specifications  for external request
  5471.              processors. This  field has  three different options,  namely,
  5472.              No, Always, and  On error. When "On error" is selected, ALLFIX
  5473.              will only send CC  of the file request  report if one or  more
  5474.              of the files requested was not matched.
  5475.  
  5476.         There are  three different  groups that  contain the same  options.
  5477.         These  groups are unlisted,  unsecure, and secure.  These are three
  5478.         different types  of mail  sessions  that could  occur. An  unlisted
  5479.         session  is one  when  the requesting  node is  not  listed in  the
  5480.         nodelist.  An unsecure session  is one  where there is  no password
  5481.         setup for the requesting node. A secure session is one  where there
  5482.         is a password  setup for the requesting system. Everyone has access
  5483.         to the settings  for unlisted sessions.  If a session  is unsecure,
  5484.  
  5485.                                         85
  5486.  
  5487.  
  5488.  
  5489.  
  5490.  
  5491.  
  5492.  
  5493.         then  it also  has access  to  those settings.  When  a session  is
  5494.         secure, the  settings for secure  sessions is  also available.  The
  5495.         options for each of the sessions are:
  5496.  
  5497.         Alias
  5498.  
  5499.              This  field defines the alias file that  is used for this type
  5500.              of session. This  alias file must have the following format if
  5501.              you want to use the request processor in ALLFIX:
  5502.  
  5503.              [magicname]    [file 1] [file 2] ... [file n] [/password]
  5504.  
  5505.              For example:
  5506.  
  5507.              ALLFIX    D:\AREA1\AFIX440.ZIP  D:\AREA1\ALLFIX.REG
  5508.              BETA      D:\AREA2\AFB_B004.ZIP /PASSWORD
  5509.  
  5510.              In the above  example, when someone  file requests magic  name
  5511.              ALLFIX  they  will receive  the  AFIX440.ZIP  archive and  the
  5512.              ALLFIX.REG  form. In order  to file request  the latest ALLFIX
  5513.              beta  they have  to  file  request magic  name  BETA with  the
  5514.              password "PASSWORD". 
  5515.  
  5516.              Please  note that  ALLFIX will  use the  above format  for the
  5517.              alias  file  if  the request  processor  has  been  active, by
  5518.              setting the active field in this menu to "Yes".
  5519.  
  5520.  
  5521.         Groups
  5522.  
  5523.              This field defines  the groups that are available in this type
  5524.              of session. 
  5525.  
  5526.         List
  5527.  
  5528.              This field defines  the directories that  are available in  an
  5529.              unsecure  mailer session.  The  format of  this  file is  very
  5530.              simple. It  must be a  plain text  file. Comments,  designated
  5531.              with a semi-colon,  ';', are allowed.  It is also  possible to
  5532.              define passwords  per directory by placing the password behind
  5533.              a directory, preceeded with a front slash, '/'. For example:
  5534.  
  5535.              D:\AREA1
  5536.              D:\AREA2  /PASSWORD
  5537.  
  5538.              In the above example, people  can file request files from  the
  5539.              directory  D:\BBS\FILES\AREA2 if  they  use the  correct  file
  5540.              request password.
  5541.  
  5542.         Max files
  5543.  
  5544.              This field can  be used to define the maximum  number of files
  5545.              to send per session.
  5546.  
  5547.         Max size
  5548.  
  5549.  
  5550.                                         86
  5551.  
  5552.  
  5553.  
  5554.  
  5555.  
  5556.  
  5557.  
  5558.              This  field  can  be  used to  define  the  maximum  number of
  5559.              kilobytes te send per session.
  5560.  
  5561.         Max time
  5562.  
  5563.              This  field  can  be  used to  define  the  maximum  number of
  5564.              minutes a file request session may last.
  5565.  
  5566.  
  5567.         The  ALLFIX request  processor  is  very easy  to  install in  your
  5568.         mailer.  ALLFIX expects the following command line options, in this
  5569.         order:
  5570.  
  5571.         Aka
  5572.  
  5573.              Requesting system's aka.
  5574.  
  5575.         Sysop
  5576.  
  5577.              Requesting systems sysop name.
  5578.  
  5579.         Type of session
  5580.  
  5581.              The  string  "SECURE"  for  secure  sessions,  "UNSECURE"  for
  5582.              unsecure sessions.  If anothe string  is received, then  it is
  5583.              assumed that the system is unlisted.
  5584.  
  5585.         Response file name
  5586.  
  5587.              The  name of the  response file  which is returned  the mailer
  5588.              after  processing a  file request.  The name  of this  file is
  5589.              provided by the mailer.
  5590.  
  5591.         List of requested files
  5592.  
  5593.              The name of the file  containing the file requests. This  file
  5594.              is provided by the mailer.
  5595.  
  5596.         ALLFIX should be installed as follows in FrontDoor and MainDoor:
  5597.  
  5598.         D:\ALLFIX\ALLFIX.EXE Rp =A =O =B =X =T =R
  5599.  
  5600.         ALLFIX should be installed as follows for InterMail:
  5601.  
  5602.         D:\ALLFIX\ALLFIX.EXE RP %A %O %B %X %F
  5603.  
  5604.         Please  note that for InterMail, the response filename is identical
  5605.         to the request file name.  Therefore, only the request filename  is
  5606.         specified on the commandline.
  5607.  
  5608.         ALLFIX is also capable  of working with SRIF files. These files are
  5609.         created  by  some  of  mailers  and  effectively  contain  all  the
  5610.         information that ALLFIX may need.  When using ALLFIX with a  mailer
  5611.         that supports SRIF files, you  must specify the -SRIF command  line
  5612.         option and the name of the SRIF file on the commandline. Example:
  5613.  
  5614.  
  5615.                                         87
  5616.  
  5617.  
  5618.  
  5619.  
  5620.  
  5621.  
  5622.  
  5623.         D:\ALLFIX\ALLFIX.EXE Rp -SRIF [name of SRIF file]
  5624.  
  5625.         Most mailers should have a  macro which will expand to the  name of
  5626.         the  SRIF  file.  Some  mailers  do  not  have  a macro,  and  will
  5627.         automatically append the name  of the SRIF file  to the end of  the
  5628.         command  line. In that  case, simply  specifying "Rp -SRIF"  on the
  5629.         command line is enough.
  5630.  
  5631.         The commandline to use for Argus mailer is:
  5632.  
  5633.         D:\ALLFIX\ALLFIX.EXE Rp -SRIF %SRIF%
  5634.  
  5635.         An example commandline to use for T-Mail is:
  5636.  
  5637.         Process FREQ Allfix Rp -SRIF C:\Files\Flags\Busy%TASKNO%.T-M
  5638.  
  5639.         In  the  above   example,  the  path  is  the  T-Mail  Flag_dir  as
  5640.         configured in the  T-MAIL.CTL file.  The name of  the SRIF file  is
  5641.         the Flag_Session as defined in that same file.
  5642.  
  5643.         The commandline to use for SGMail is:
  5644.  
  5645.         \ALLFIX\ALLFIX.EXE Rp -SRIF %1
  5646.  
  5647.         where  %1 will be  filled in  by SGMail with  the name  of the SRIF
  5648.         file.
  5649.  
  5650.         It is  possible to file  request "AreaMgr" services.  The following
  5651.         services are available for file requesting:
  5652.  
  5653.         %LIST,
  5654.         %QUERY,
  5655.         %STATUS, and 
  5656.         %UNLISTED,
  5657.         %HELP.
  5658.  
  5659.         As  mentioned before,  ALLFIX  is also  capable of  processing file
  5660.         requests via the Internet. For the Internet, the Max files and  the
  5661.         Max  size can  also  be  defined. In  addition,  a seperate  report
  5662.         template can also be  defined. ALLFIX will try to determine who the
  5663.         requesting  system is, by  comparing email addresses  with those in
  5664.         the Node  manager.  Based on  this, ALLFIX  will  determine if  the
  5665.         system is  unlisted or not.  Based on the  whether it can  find the
  5666.         system or not, it will use the appropriate access criteria.
  5667.  
  5668.         To file  request a file  via the  Internet, the email  message must
  5669.         contain  the  word "FREQ"  in  the  subject line  and  in the  body
  5670.         contain one  or more lines  containing the files or  magic names to
  5671.         be file requested, preceeded with the text "FREQ:". For example:
  5672.  
  5673.              From: Harald Harms <harald@allfix.com>
  5674.              To: John Doe <john@allfix.com>
  5675.              Subject: FREQ
  5676.  
  5677.              FREQ:ALLFIX
  5678.              FREQ:ALLFILES
  5679.  
  5680.                                         88
  5681.  
  5682.  
  5683.  
  5684.  
  5685.  
  5686.  
  5687.  
  5688.         Please note that requesting the  AreaMgr services can also be  done
  5689.         via  the Internet!  For example,  add  "FREQ:%LIST" to  the example
  5690.         above,  and  ALLFIX will  also  send a  %LIST report  back  via the
  5691.         Internet!
  5692.  
  5693.         6.10 Node manager
  5694.  
  5695.         Each system, from which files are  received, must be defined in the
  5696.         node manager for  security reasons. The  node manager is  also used
  5697.         to configure special options for each downlink system.  Please note
  5698.         that not every downlink  has to be configured in  the node manager.
  5699.         ALLFIX will use  the default settings, which can also be configured
  5700.         in this menu, for those systems that are not configured here.
  5701.  
  5702.         Up to 2048 systems can be configured in this menu.
  5703.  
  5704.         The  node  manager  configuration  is stored  in  the  file  called
  5705.         NODEFILE.FIX. Index information is stored in NODEFILE.IDX.
  5706.  
  5707.         It is possible to add  the current system (being viewed or  edited)
  5708.         to fileechos from within the Node manager, by pressing the  F7 key.
  5709.         After  pressing this key, you will be  presented with a list of the
  5710.         fileechos. Each fileecho  that the system  is connected to  will be
  5711.         marked  with a  check-mark.  You can  edit the  way  the system  is
  5712.         connected up to a  fileecho, by simply pressing the Enter  key. You
  5713.         can disconnect a system by simply pressing the Delete key.
  5714.  
  5715.  
  5716.         The following is a description of the fields in this menu.
  5717.  
  5718.         System
  5719.  
  5720.              This field contains the address of the system.
  5721.  
  5722.         Sysop
  5723.  
  5724.              This  field contains  the  name  of the  SysOp  for the  above
  5725.              configured system.
  5726.  
  5727.         Holding directory
  5728.  
  5729.              This  field contains the  name of  the directory  where ALLFIX
  5730.              should  place  files  for  this  system.  If  this  option  is
  5731.              defined, then ALLFIX will NOT  write any netmail file attaches
  5732.              nor  update any  .?LO  or  queue files.  The  purpose of  this
  5733.              option is to  make it possible to send files  via medium other
  5734.              than a mailer. An excellent  example is sending the files  via
  5735.              a tape. ALLFIX  will place all  the outgoing files,  including
  5736.              .TIC files, in this  directory. It is up to the user to delete
  5737.              the files at the appropriate time.
  5738.  
  5739.         Route via
  5740.  
  5741.              This field contains  the address of  the system through  which
  5742.              all files and  messages for system  this should be  routed. If
  5743.              this field  is used,  then the TIC  file mode  MUST be set  to
  5744.  
  5745.                                         89
  5746.  
  5747.  
  5748.  
  5749.  
  5750.  
  5751.  
  5752.  
  5753.              "Advanced TIC file".  ALLFIX will add  one extra field  to the
  5754.              .TIC file, so that the nodes  through which any files for this
  5755.              system  are routed  know  that  the files  are  not for  them.
  5756.              Furthermore,  ALLFIX   will  send  the  files  to  the  system
  5757.              specified in this  field. That system  will have to  make sure
  5758.              that  the files  are  then  sent  to the  correct  destination
  5759.              system. 
  5760.  
  5761.         Authorized groups
  5762.  
  5763.              This  field contains  a list  of groups  that this  system has
  5764.              access to.  This  system will  be able  to  add any  fileechos
  5765.              belonging these  groups with  the use  of the AreaMgr.  Please
  5766.              note  that the  system also  has access  to the  public groups
  5767.              defined in the AreaMgr options menu!
  5768.  
  5769.         Fileecho password
  5770.  
  5771.              This  field contains  the  password that  will be  included in
  5772.              each .TIC file. This system  must define the same password  in
  5773.              their node manager.
  5774.  
  5775.         AreaMgr password
  5776.  
  5777.              This  field  contains  the password  used  for  to  access the
  5778.              AreaMgr. The node  is required to  use this password  in order
  5779.              to make use of the AreaMgr features.
  5780.  
  5781.         PKT password
  5782.  
  5783.              This  field contains the  password that  will be used  in .PKT
  5784.              files. This  was primarily added for BinkleyTerm mailers where
  5785.              PKT passwords  are  almost  always  required,  even  for  file
  5786.              request  reports. If  you do  not think  you need  this field,
  5787.              then it is best not to use it.
  5788.  
  5789.         Use aka
  5790.  
  5791.              This field contains the aka  that should be used when  sending
  5792.              messages  or  files to  this  system.  The options  "Setup/Aka
  5793.              matching" means that  ALLFIX will use  the aka defined  in the
  5794.              fileecho manager, or  use aka matching  if no specific  aka is
  5795.              forced in the fileecho configuration.
  5796.  
  5797.         File attach status
  5798.  
  5799.              This field  determines  the status  of  file attach  messages,
  5800.              .?LO files for  BinkleyTerm and Portal of Power, and the queue
  5801.              files for D'Bridge created for this system.
  5802.  
  5803.         Other mail status
  5804.  
  5805.              This  field  determines  the  status  of  all  other  messages
  5806.              created for this system.  "Other mail" includes such  items as
  5807.              Notify    messages,   new    file   reports,    new   fileecho
  5808.              announcements, and netmail FileFind requests.
  5809.  
  5810.                                         90
  5811.  
  5812.  
  5813.  
  5814.  
  5815.  
  5816.  
  5817.  
  5818.         TIC file mode
  5819.  
  5820.              This field determines what type  of .TIC file, if any,  should
  5821.              be sent to this system. The available options are:
  5822.  
  5823.              None
  5824.  
  5825.                   Do not include a .TIC file.
  5826.  
  5827.              Normal TIC file
  5828.  
  5829.                   Include a normal .TIC file.
  5830.  
  5831.              Advanced TIC file
  5832.  
  5833.                   Include an  advanced .TIC  file. The advanced  .TIC files
  5834.                   contain the  "AreaDesc" verb,  the "To" verb,  the "Cost"
  5835.                   verb (not yet  used by ALLFIX), and the "Ldesc" verb. The
  5836.                   "To" verb  is  necessary  for  routing  files  via  other
  5837.                   systems. 
  5838.  
  5839.         Packing mode
  5840.  
  5841.              This  field  determines if  forwarded  files  for this  system
  5842.              should  be  compressed  into  a  TIC  archive.  The  available
  5843.              options are:
  5844.  
  5845.              No packing
  5846.  
  5847.                   Do not pack any files. 
  5848.  
  5849.              Pack TIC files
  5850.  
  5851.                   Pack all the .TIC files into a TIC archive.
  5852.  
  5853.              Pack ALL files
  5854.  
  5855.                   Pack  all the  forwarded files  including the  .TIC files
  5856.                   into a TIC archive.
  5857.  
  5858.              Pack TIC+file
  5859.  
  5860.                   This option,  also referred to as the "Mini tic archive",
  5861.                   will  pack  ONE  .TIC  file  along  with  its  associated
  5862.                   archive  into one  TIC archive.  This means  that one TIC
  5863.                   archive is created for each TIC - file pair. 
  5864.  
  5865.              TIC archives, with  the exception of the TIC+file tic archive,
  5866.              are compressed at the  end of a  session. This means that  all
  5867.              files to  be compressed are stored in a "list" file. After all
  5868.              files have been  processed, ALLFIX will  run through all  list
  5869.              files  and create  all  of  the TIC  archives.  The mini  tick
  5870.              archives are created  on the fly, for technical reasons. It is
  5871.              also important to  note that incase  something goes wrong  and
  5872.              ALLFIX  crashes during a  session, before  it has a  change to
  5873.              create all of  the TIC archives, it will simply continue where
  5874.  
  5875.                                         91
  5876.  
  5877.  
  5878.  
  5879.  
  5880.  
  5881.  
  5882.  
  5883.              it left off the next time it is started up. 
  5884.  
  5885.              The  packing  options,  unfortunately,  do  not  yet  work  in
  5886.              conjunction with the Holding directory option (see above).
  5887.  
  5888.         Compression type
  5889.  
  5890.              This field  determines which  compression type should  be used
  5891.              when creating TIC archives for this system.
  5892.  
  5893.         6.10.1    Internet options
  5894.  
  5895.         This menu  contains  the  Internet  settings  for  this  particular
  5896.         system.  Please consult section  6.3.5 for an  explanation of these
  5897.         options.
  5898.  
  5899.  
  5900.         6.10.2    Advanced options
  5901.  
  5902.         This menu contains the following advanced options:
  5903.  
  5904.         Inactive
  5905.  
  5906.              This field determines  if this system is inactive or not. This
  5907.              field  can  be  controlled  by the  node  via  the  %PAUSE and
  5908.              %RESUME AreaMgr commands.  If this field  is set to  Yes, then
  5909.              this node will  not receive any files nor  will it receive any
  5910.              notify messages.
  5911.  
  5912.         Copy other files
  5913.  
  5914.              When a holding  directory is used (see above), this option can
  5915.              be used to tell ALLFIX to move other  files for this system to
  5916.              the holding directory  as well. If turned on, ALLFIX will move
  5917.              all other files  that are on  hold for this  particular system
  5918.              including  the  netmail  messages  to the  holding  directory.
  5919.              Netmail messages  will be stored  in the form of  a .PKT file,
  5920.              which the destination  system can unpack. If the  "delete when
  5921.              sent" option is toggled for  a particular netmail with a  file
  5922.              attach, then ALLFIX will move  the actual file to the  holding
  5923.              directory.  In other situations,  it will only  copy the file.
  5924.              If  the   "truncate  when  sent"  option  is   toggled  for  a
  5925.              particular netmail with a  file attach, then ALLFIX will  copy
  5926.              the file  to the holding  directory and truncate  the original
  5927.              to 0 bytes.
  5928.  
  5929.         Include template file
  5930.  
  5931.              This  field determines  whether or  not ALLFIX  should send  a
  5932.              netmail announcement to this  system with each forwarded  file
  5933.              in those fileechos for which a template was defined.
  5934.  
  5935.         Send notify list
  5936.  
  5937.              This  field determines if this system  should receive a notify
  5938.              message when  the generic notify  command is  given. For  more
  5939.  
  5940.                                         92
  5941.  
  5942.  
  5943.  
  5944.  
  5945.  
  5946.  
  5947.  
  5948.              details,  please  consult the  chapter  concerning  the Notify
  5949.              function (section 7.5).
  5950.  
  5951.         Notify new fileechos
  5952.  
  5953.              This  field   determins  if   this  sytem  should   receive  a
  5954.              notification whenever a new  fileecho has been auto-added  and
  5955.              to which he was automatically connected.
  5956.  
  5957.         Forward requests
  5958.  
  5959.              This  field determines  whether or  not ALLFIX  should forward
  5960.              requests  for  unknown areas,  made  by  this system  via  the
  5961.              AreaMgr, to an uplink.
  5962.  
  5963.         Allow Auto-add
  5964.  
  5965.              This   option  determines   whether  or   not  ALLFIX   should
  5966.              automatically add  new fileechos coming from this system. This
  5967.              option is only available in the registered version.
  5968.  
  5969.         Remote maintenance
  5970.  
  5971.              This option  determines whether or not this  system is allowed
  5972.              to perform  remote maintenance for another system by using the
  5973.              %FROM AreaMgr  command. This option  is only available  in the
  5974.              registered version.
  5975.  
  5976.         Send .TIC with FREQ
  5977.  
  5978.              This  option determins  whether or  not ALLFIX  should send  a
  5979.              .TIC file  with  the files  that are  file  requested by  this
  5980.              system. Please note  that this feature is only relevant if the
  5981.              request processor is active.
  5982.  
  5983.  
  5984.         6.10.3    Cost sharing
  5985.  
  5986.         Billing
  5987.  
  5988.              This field determines if this node should  participate in cost
  5989.              sharing.  Valid  options are  "No",  "Yes", and  "Membership".
  5990.              Nodes for  which the "Membership"  style billing is  turned on
  5991.              are  not considered  cost sharing  nodes when  calculating the
  5992.              cost  of files  tossed in  fileechos. These  nodes are charged
  5993.              the "Membership fee"  on a  periodic basis  determined by  the
  5994.              "Send day" and "Send Bill" options.
  5995.  
  5996.         Bill groups
  5997.  
  5998.              This  field contains the  list of  groups for which  this node
  5999.              should participate in the cost sharing.
  6000.  
  6001.         Credit
  6002.  
  6003.              This field contains this node's credit level. 
  6004.  
  6005.                                         93
  6006.  
  6007.  
  6008.  
  6009.  
  6010.  
  6011.  
  6012.  
  6013.         Warn level
  6014.  
  6015.              This field contains  the credit level  at which ALLFIX  should
  6016.              send the node a warning that the credit level  is getting low.
  6017.              ALLFIX will only send the  warning when this level is  passed.
  6018.              ALLFIX will use the WARNING template file for the warnings.
  6019.  
  6020.         Stop level
  6021.  
  6022.              This field  contains the credit  level at which  ALLFIX should
  6023.              stop sending files to  this node. ALLFIX will send  the node a
  6024.              message announcing  the  status of  the  credit level.  ALLFIX
  6025.              will use the STOP template for these announcements.
  6026.  
  6027.         Send on
  6028.  
  6029.              This field determines  the day that a bill (or invoice) should
  6030.              be sent.  Values 0  to 28  can be entered.  The entered  value
  6031.              represents the day of  the month or week to send the file (see
  6032.              next  option). If the  "Send Bill"  feature is set  to Yearly,
  6033.              then  this value represents  the month  when the bill  will be
  6034.              sent.
  6035.  
  6036.         Send bill
  6037.  
  6038.              This  field determines  when  a bill  (or  invoice) should  be
  6039.              sent. Possible  options are: Direct, after each event; Weekly,
  6040.              once  a week on the day of  the week specified in the previous
  6041.              field (1 -  Sunday; 7  - Saturday); Monthly,  once a month  on
  6042.              the day  of  the month  specified in  the  previous field;  or
  6043.              Yearly,  on  the  first  day of  the  month  specified  in the
  6044.              previous field.
  6045.  
  6046.         Add %
  6047.  
  6048.              This field defines  the extra percentage  to add to  the total
  6049.              price of the bill.  This field can be used to define the extra
  6050.              VAT taxes, for example.
  6051.  
  6052.         Membership fee
  6053.  
  6054.              This field  determines the membership fee for membership style
  6055.              billing.  A node's credit  level is  reduced by this  fee each
  6056.              time a bill is generated.
  6057.  
  6058.         6.11 Utilities
  6059.  
  6060.         6.11.1    Template editor
  6061.  
  6062.         This  menu offers  the ability  to view,  edit, create,  and delete
  6063.         template files.
  6064.  
  6065.         Pressing the  ENTER  key will  call up  the editor.  If a  external
  6066.         editor has been  defined in the "External programs" menu, then this
  6067.         program  will be called up. Pressing  ALT-ENTER will over-ride that
  6068.         setting and call up the internal editor.
  6069.  
  6070.                                         94
  6071.  
  6072.  
  6073.  
  6074.  
  6075.  
  6076.  
  6077.  
  6078.  
  6079.         6.11.2    Export data
  6080.  
  6081.         This  menu contains  a number  of menu  items that  can be  used to
  6082.         export portions of the configuration to plain ASCII files.
  6083.  
  6084.         Export everything
  6085.         Export main configuration
  6086.         Export FileFind areas
  6087.         Export new file reports
  6088.         Export fileecho areas
  6089.         Export hatch configuration
  6090.         Export magic filenames
  6091.         Export group configuration
  6092.         Export BBS file areas
  6093.         Export ALLFILES
  6094.         Export Request processor
  6095.         Export node configuration
  6096.  
  6097.              The above  configurations are exported using INIUTIL. The text
  6098.              files can  be edited  manually and imported  back into  ASETUP
  6099.              via the corresponding option in the Import data menu.
  6100.  
  6101.         Create fileecho list
  6102.  
  6103.              Generate  a  list of  fileechos  and  their descriptions.  The
  6104.              format of the ASCII file is:
  6105.  
  6106.              <area> <description>
  6107.  
  6108.         Create tag list
  6109.  
  6110.              Generate  a list  of the  fileechos. The  format of  the ASCII
  6111.              file is:
  6112.  
  6113.              <area>
  6114.  
  6115.         Cross check FILEBONE.xx
  6116.  
  6117.              Generate a list of  all the fileechos that  are not listed  in
  6118.              any of the known FILEBONE.xx  and TAG files. ASETUP will  scan
  6119.              all of  the  FILEBONE.xx and  TAG files  which  are linked  to
  6120.              Uplink systems, and  generate a list  of all of  the fileechos
  6121.              that are not listed in those lists.
  6122.  
  6123.         Nodes ═  Echos breakdown
  6124.  
  6125.              Generate  a list of  the systems  defined in the  node manager
  6126.              and all the fileechos that those systems are connected to.
  6127.  
  6128.         Export fileecho dest dirs
  6129.  
  6130.              Generate a list of the destination directories.
  6131.  
  6132.  
  6133.         6.11.3    Import data
  6134.  
  6135.                                         95
  6136.  
  6137.  
  6138.  
  6139.  
  6140.  
  6141.  
  6142.  
  6143.         This menu has a number of functions that can be used  to import the
  6144.         fileecho   and  node   configuration  from   other   programs  when
  6145.         converting  to ALLFIX. Only new  unknown fileechos and systems will
  6146.         be added.
  6147.  
  6148.         Import main configuration
  6149.         Import FileFind areas
  6150.         Import new file reports
  6151.         Import fileecho areas
  6152.         Import hatch configuration
  6153.         Import magic filenames
  6154.         Import group configuration
  6155.         Import BBS file areas
  6156.         Import ALLFILES
  6157.         Import Request processor
  6158.         Import node configuration
  6159.  
  6160.  
  6161.              For the above options, ASETUP  will use INIUTIL to import  the
  6162.              text configuration  files. These  text files can  be generated
  6163.              using the associated option in the Export data menu.
  6164.  
  6165.         TICK configuration
  6166.  
  6167.              Import  the  fileecho and  system  information  from the  TICK
  6168.              configuration file, TIC.CFG.
  6169.  
  6170.         FILEBONE.NA/NO
  6171.  
  6172.              Import  the fileechos  from  the  FILEBONE.NA  or  FILEBONE.NO
  6173.              files. Since  these files  only contain  the fileecho tag  and
  6174.              their  descriptions, ALLFIX  will use  the "Masks"  defined in
  6175.              the Group manager  to determine all  the settings for  the new
  6176.              fileechos. If a matching group  can not be found, ALLFIX  will
  6177.              use the default fileecho settings.
  6178.  
  6179.         FileMgr fileechos
  6180.  
  6181.              Import the fileecho configuration  from the FileMgr 0.70  beta
  6182.              AREAFILE.FM file. 
  6183.  
  6184.         FileMgr systems
  6185.  
  6186.              Import  the system  configuration from  the FileMgr  0.70 beta
  6187.              NODEFILE.FM file.
  6188.  
  6189.         James fileechos
  6190.  
  6191.              Import  the  fileecho   configuration  from  the   James  2.21
  6192.              JAMES.ARE file.
  6193.  
  6194.         James systems
  6195.  
  6196.              Import  the   systems  configuration  from   the  James   2.21
  6197.              JAMES.NDE file.
  6198.  
  6199.  
  6200.                                         96
  6201.  
  6202.  
  6203.  
  6204.  
  6205.  
  6206.  
  6207.  
  6208.         6.11.4    Uplink requests
  6209.  
  6210.         When  people use  the AreaMgr  to request  a fileecho  which is not
  6211.         known on  your  system,  ALLFIX  will  automatically  request  that
  6212.         fileecho  from your  uplink.  In  doing  so,  it  will  store  some
  6213.         information  about the request  in the  ALLFIX.DAT file.  This menu
  6214.         will present you  with a  list of of  the requested fileechos,  who
  6215.         requested them,  from which uplink  ALLFIX requested the  echo, and
  6216.         the date that the request  was done. It is also possible  to delete
  6217.         entries in the list.
  6218.  
  6219.         6.12 Information
  6220.  
  6221.         This menu contains some information concerning ALLFIX and ASETUP.
  6222.  
  6223.  
  6224.         6.13 Exit program
  6225.  
  6226.         This menu item  is used to  exit the configuration  program. ASETUP
  6227.         will prompt the user if any changes have been made.
  6228.  
  6229.  
  6230.         6.14 Template files
  6231.  
  6232.         ALLFIX contains an  easy to use  and dynamic macro  language called
  6233.         APL  (ALLFIX template  Programming  Language). Template  files  end
  6234.         with  the extension .APL.  All template files  can make use  of the
  6235.         macro  language, however, not  all the  different key words  can be
  6236.         used in every template file.
  6237.  
  6238.         Template  files are  plain ASCII  text files  that contain  special
  6239.         keywords  that will be  replaced with their  respective values. All
  6240.         keywords must be preceded  by a '@' character, however,  the use of
  6241.         an  '@'  character does  not  mean that  the  following  word is  a
  6242.         keyword. Strings containing an '@'  character will only be expanded
  6243.         if it is a keyword or function.
  6244.  
  6245.         Template languages  can  contain a  number  of different  types  of
  6246.         loops  each ending with a  special @end keyword. Sometimes mistakes
  6247.         in the  definition of these loops can cause  ALLFIX to end up in an
  6248.         endless  loop. In order  to help protect  against these situations,
  6249.         ALLFIX will perform a simple syntax check of  the template. At this
  6250.         point,  it simply checks  to see  if the  loops are  properly ended
  6251.         with the  @end keywords.  If there  is  an error,  ALLFIX will  not
  6252.         process the macro file.
  6253.  
  6254.         There are four types of template files:
  6255.  
  6256.            1 Notify/AreaMgr templates
  6257.            2 Netmail announcement templates
  6258.            3 Report/FileFind/Bill/Request templates
  6259.            4 Archive banner templates
  6260.            5 Request report specific macros
  6261.  
  6262.  
  6263.         6.14.1    Standard template files
  6264.  
  6265.                                         97
  6266.  
  6267.  
  6268.  
  6269.  
  6270.  
  6271.  
  6272.  
  6273.         There  are a number  of standard  template files that  ALLFIX uses.
  6274.         The names of these template files can not be changed.
  6275.  
  6276.         ALLFILES
  6277.  
  6278.              This template can be used for generating allfiles or  newfiles
  6279.              listings.  This template  was developed  by Felix  Mueller. It
  6280.              has been  included in the  release package in  the un-modified
  6281.              form.
  6282.  
  6283.         AREAMGR
  6284.  
  6285.              This template is used for the %HELP AreaMgr command.
  6286.  
  6287.         BILL
  6288.  
  6289.              This template is used for the billing system.
  6290.  
  6291.         FILEFIND
  6292.  
  6293.              This template is  used for the  FileFind replies. The  name of
  6294.              this  template   can  be  configured  in  the  FileFind  menu,
  6295.              however, if no  other name is  specified, then this  file will
  6296.              be used.
  6297.  
  6298.         LIST
  6299.  
  6300.              This template is used for the %LIST AreaMgr command.
  6301.  
  6302.         NOTIFY
  6303.  
  6304.              This template is used to send Notify messages.
  6305.  
  6306.         PAUSE
  6307.  
  6308.              This template is used for the %PAUSE AreaMgr command.
  6309.  
  6310.         QUERY
  6311.  
  6312.              This template is used for the %QUERY AreaMgr command.
  6313.  
  6314.         RESUME
  6315.  
  6316.              This template is used for the %RESUME AreaMgr command.
  6317.  
  6318.         STATUS
  6319.  
  6320.              This template is used for the %STATUS AreaMgr command.
  6321.  
  6322.         STOP
  6323.  
  6324.              This template is used  to notify a node that he will no longer
  6325.              receive any files because his credit level is to low.
  6326.  
  6327.         UNLINKED
  6328.  
  6329.  
  6330.                                         98
  6331.  
  6332.  
  6333.  
  6334.  
  6335.  
  6336.  
  6337.  
  6338.              This template is used for the %UNLINKED AreaMgr command.
  6339.  
  6340.         WARNING
  6341.  
  6342.              This template is  used to notify a node  that his credit level
  6343.              is approaching the stop level.
  6344.  
  6345.  
  6346.         6.14.2    Key words
  6347.  
  6348.         The  following is  a list of  keywords, the  type of  templates for
  6349.         which they can be used, and a short description:
  6350.  
  6351.  
  6352.         @msgto
  6353.  
  6354.              type: 1,2,3
  6355.  
  6356.              To whom this message is addressed.
  6357.  
  6358.         @msgtoaka
  6359.  
  6360.              type: 1,2,3
  6361.  
  6362.              Address to which this message is addressed.
  6363.  
  6364.         @msgfrom
  6365.  
  6366.              type: 1,2,3
  6367.  
  6368.              From whom this message is sent.
  6369.  
  6370.         @msgsubject
  6371.  
  6372.              type: 1,2,3
  6373.  
  6374.              Subject of this message.
  6375.  
  6376.         @akatouse
  6377.  
  6378.              type: <all>
  6379.  
  6380.              Aka to use for this report.
  6381.  
  6382.         @systemname
  6383.  
  6384.              type: <all>
  6385.  
  6386.              System name.
  6387.  
  6388.         @sysopname
  6389.  
  6390.              type: <all>
  6391.  
  6392.              Sysop name.
  6393.  
  6394.  
  6395.                                         99
  6396.  
  6397.  
  6398.  
  6399.  
  6400.  
  6401.  
  6402.  
  6403.         @phoneline1,
  6404.         @phoneline2,
  6405.         @phoneline3
  6406.  
  6407.              type: <all>
  6408.  
  6409.              Phone numbers, as defined in Site information menu.
  6410.  
  6411.         @location
  6412.  
  6413.              type: <all>
  6414.  
  6415.              Location.
  6416.  
  6417.         @flags
  6418.  
  6419.              type: <all>
  6420.  
  6421.              Flags.
  6422.  
  6423.         @baud
  6424.  
  6425.              type: <all>
  6426.  
  6427.              Baud.
  6428.  
  6429.         @prgname
  6430.  
  6431.              type: <all>
  6432.  
  6433.              The  name of  the ALLFIX  program (i.e.  ALLFIX, ALLFIX/2,  or
  6434.         ALLFIX!).
  6435.  
  6436.         @prgversion
  6437.  
  6438.              type: <all>
  6439.  
  6440.              ALLFIX program version. (Ex. 4.30)
  6441.  
  6442.         @daynr,
  6443.         @day,
  6444.         @dayofyear,
  6445.         @monthnr,
  6446.         @month,
  6447.         @year
  6448.  
  6449.              type: <all>
  6450.  
  6451.              Various date values.
  6452.  
  6453.         @hour
  6454.         @min
  6455.  
  6456.              type: <all>
  6457.  
  6458.              Various time values.
  6459.  
  6460.                                         100
  6461.  
  6462.  
  6463.  
  6464.  
  6465.  
  6466.  
  6467.  
  6468.         @cookie
  6469.  
  6470.              type: <all>
  6471.  
  6472.              Fortune  cookie.  This  option   only  works  if  a   compiled
  6473.              COOKIE.DAT file is stored in the system directory.
  6474.  
  6475.         @filename
  6476.  
  6477.              type: 2,3,4
  6478.  
  6479.              File name.
  6480.  
  6481.         @filedesc
  6482.  
  6483.              type: 2,3,4
  6484.  
  6485.              File description.
  6486.  
  6487.         @filesize
  6488.  
  6489.              type: 2,3,4
  6490.  
  6491.              File size.
  6492.  
  6493.         @filesizekb
  6494.  
  6495.              type: 2,3,4
  6496.  
  6497.              File size in kilobytes.
  6498.  
  6499.         @filecost
  6500.  
  6501.              type: 2,3,4
  6502.  
  6503.              File cost.
  6504.  
  6505.         @filedate,
  6506.         @fileyear,
  6507.         @filemonth,
  6508.         @fileday
  6509.  
  6510.              type: 2,3,4
  6511.  
  6512.              Various date statistics of the file.
  6513.  
  6514.         @filetime,
  6515.         @filehour,
  6516.         @filemin
  6517.  
  6518.              type: 2,3,4
  6519.  
  6520.              Various time statistics of the file.
  6521.  
  6522.         @fileage
  6523.  
  6524.  
  6525.                                         101
  6526.  
  6527.  
  6528.  
  6529.  
  6530.  
  6531.  
  6532.  
  6533.              type: 2,3,4
  6534.  
  6535.              The age of a file, in number of days.
  6536.  
  6537.         @fileorigin
  6538.  
  6539.              type: 2,3,4
  6540.  
  6541.              Origin of this file.
  6542.  
  6543.         @filefrom
  6544.  
  6545.              type: 2,3,4
  6546.  
  6547.              Where this file was received from.
  6548.  
  6549.         @filecrc
  6550.  
  6551.              type: 3,4
  6552.  
  6553.              Crc of the file.
  6554.  
  6555.         @filereplace
  6556.  
  6557.              type: 2,3,4
  6558.  
  6559.              File(spec) this file replaces.
  6560.  
  6561.         @filemagic
  6562.  
  6563.              type: 2,3,4
  6564.  
  6565.              Magic name for this file.
  6566.  
  6567.         @fileecho
  6568.  
  6569.              type: <all>
  6570.  
  6571.              Fileecho tag or BBS file area name.
  6572.  
  6573.         @destdir
  6574.  
  6575.              type: 1
  6576.  
  6577.              Fileecho destination directory.
  6578.  
  6579.         @areanr
  6580.  
  6581.              type: 3 (only FileFind replies)
  6582.  
  6583.              The BBS file area number.
  6584.  
  6585.         @raidlevel
  6586.  
  6587.              type: 1
  6588.  
  6589.  
  6590.                                         102
  6591.  
  6592.  
  6593.  
  6594.  
  6595.  
  6596.  
  6597.  
  6598.              Level, as defined in the RAID menu (fileecho manager).
  6599.  
  6600.         @raidflags
  6601.  
  6602.              type: 1
  6603.  
  6604.              Flags (as in  FILEBONE.NA file) based  on the settings  in the
  6605.              RAID menu (fileecho manager).
  6606.  
  6607.         @passthru
  6608.  
  6609.              type: 1
  6610.  
  6611.              This macro  returns  "Yes" if  the fileecho  is pass  through.
  6612.              Otherwise, it will return the value "No".
  6613.  
  6614.         @group
  6615.              type: <all>
  6616.  
  6617.              Group this fileecho or BBS file area belongs to.
  6618.  
  6619.         @groupname
  6620.  
  6621.              type: <all>
  6622.  
  6623.              Name of the group this fileecho or BBS file area belongs to.
  6624.  
  6625.         @echodesc
  6626.  
  6627.              type: <all>
  6628.  
  6629.              Fileecho or file area description.
  6630.  
  6631.         @systems
  6632.  
  6633.              type: 1
  6634.  
  6635.              Return a list  of all of the systems that  a connected to this
  6636.              fileecho. The list has the following format:
  6637.  
  6638.              2:281/415, 2:281/416, 2:281/417, ...
  6639.  
  6640.         @unitcost
  6641.  
  6642.              type: <all>
  6643.  
  6644.              Unit cost of files forwarded in this fileecho.
  6645.  
  6646.         @unitsize
  6647.  
  6648.              type: <all>
  6649.  
  6650.              Size of one unit, in this fileecho.
  6651.  
  6652.         @invoicenr
  6653.  
  6654.  
  6655.                                         103
  6656.  
  6657.  
  6658.  
  6659.  
  6660.  
  6661.  
  6662.  
  6663.              type: 3
  6664.  
  6665.              Invoice number for current bill. 
  6666.  
  6667.         @blockbytes
  6668.  
  6669.              type: 3
  6670.  
  6671.              Total number of bytes in current block.
  6672.  
  6673.         @blockkb
  6674.  
  6675.              type: 3
  6676.  
  6677.              Total number of Kb's in current block.
  6678.  
  6679.         @blockfiles
  6680.  
  6681.              type: 3
  6682.  
  6683.              Total number of files in current block.
  6684.  
  6685.         @totalbytes
  6686.  
  6687.              type: 3
  6688.  
  6689.              Total number of bytes in current report.
  6690.  
  6691.         @totalkb
  6692.  
  6693.              type: 3
  6694.  
  6695.              Total number of Kb's in current report.
  6696.  
  6697.         @totalfiles
  6698.  
  6699.              type: 3
  6700.  
  6701.              Total number of files in current report.
  6702.  
  6703.         @billsubtotal
  6704.  
  6705.              type: 3
  6706.  
  6707.              Total cost exc. percentage to add to bill.
  6708.  
  6709.         @billaddperc
  6710.  
  6711.              type: 3
  6712.  
  6713.              Percentage add to bill.
  6714.  
  6715.         @billtotal
  6716.  
  6717.              type: 3
  6718.  
  6719.  
  6720.                                         104
  6721.  
  6722.  
  6723.  
  6724.  
  6725.  
  6726.  
  6727.  
  6728.              Total cost inc. percentage to add to bill.
  6729.  
  6730.         @echostat
  6731.  
  6732.              type: 1
  6733.  
  6734.              A  character designating the  type of  access a system  has to
  6735.              the current fileecho.
  6736.  
  6737.              +
  6738.  
  6739.                   The system is  connected to the current fileecho and only
  6740.                   receives files.
  6741.  
  6742.              *
  6743.  
  6744.                   The  system  is connected  to  the  current fileecho  and
  6745.                   sends files.
  6746.  
  6747.              &
  6748.  
  6749.                   The system is connected to  the current fileecho and both
  6750.                   sends and receives files.
  6751.  
  6752.              -
  6753.  
  6754.                   The  system  is  does  not  have access  to  the  current
  6755.                   fileecho.
  6756.  
  6757.  
  6758.              [space]
  6759.  
  6760.                   The system is not connected to the current fileecho.
  6761.  
  6762.  
  6763.         @avgfiles
  6764.  
  6765.              type: 1
  6766.  
  6767.              Average number of files in this fileecho per month.
  6768.  
  6769.         @avgkb
  6770.  
  6771.              type: 1
  6772.  
  6773.              Average number of kb in this fileecho per month.
  6774.  
  6775.         @echopassword
  6776.  
  6777.              type: 1
  6778.  
  6779.              Fileecho password for this system.
  6780.  
  6781.         @mgrpassword
  6782.  
  6783.              type: 1
  6784.  
  6785.                                         105
  6786.  
  6787.  
  6788.  
  6789.  
  6790.  
  6791.  
  6792.  
  6793.              AreaMgr password for this system.
  6794.  
  6795.         @availgroups
  6796.  
  6797.              type: 1
  6798.  
  6799.              Groups this system has access to.
  6800.  
  6801.         @filestat
  6802.  
  6803.              type: 1
  6804.  
  6805.              Message  status to use  for all  file attach messages  to this
  6806.              system.
  6807.  
  6808.         @mailstat
  6809.  
  6810.              type: 1
  6811.  
  6812.              Message  status  for  all   non-fileattach  messages  to  this
  6813.              system.
  6814.  
  6815.         @ticmode
  6816.  
  6817.              type: 1
  6818.  
  6819.              TIC file mode for this system.
  6820.  
  6821.         @packmode
  6822.  
  6823.              type: 1
  6824.  
  6825.              Packing mode for this system. 
  6826.  
  6827.         @systemstatus
  6828.  
  6829.              type: 1
  6830.  
  6831.              Returns "inactive"  if the  inactive option is  turned on  for
  6832.              this node. Otherwise, it will return the value "active".
  6833.  
  6834.         @template
  6835.  
  6836.              type: 1
  6837.  
  6838.              Include template files for this system.
  6839.  
  6840.         @notify
  6841.  
  6842.              type: 1
  6843.  
  6844.              Send notify messages to this system.
  6845.  
  6846.         @forward
  6847.  
  6848.              type: 1
  6849.  
  6850.                                         106
  6851.  
  6852.  
  6853.  
  6854.  
  6855.  
  6856.  
  6857.  
  6858.              Forward requests to uplink.
  6859.  
  6860.         @autoadd
  6861.  
  6862.              type: 1
  6863.  
  6864.              Allow auto add for this system.
  6865.  
  6866.         @remote
  6867.  
  6868.              type: 1
  6869.  
  6870.              Allow remote maintenance.
  6871.  
  6872.         @compression
  6873.  
  6874.              type: 1
  6875.  
  6876.              Compression type for this system.
  6877.  
  6878.         @billing
  6879.  
  6880.              type: 1
  6881.  
  6882.              Billing status for this system.
  6883.  
  6884.         @billgroups
  6885.  
  6886.              type: 1
  6887.  
  6888.              Groups for which this system should be billed.
  6889.  
  6890.         @credit
  6891.  
  6892.              type: 1
  6893.  
  6894.              Credit this system has left.
  6895.  
  6896.         @warnlevel
  6897.  
  6898.              type: 1
  6899.  
  6900.              Credit  level at which  a credit  low warning message  will be
  6901.              sent to the system.
  6902.  
  6903.         @stoplevel
  6904.  
  6905.              type: 1
  6906.  
  6907.              Credit level at which the system will stop receiving files.
  6908.  
  6909.         @addpercentage
  6910.  
  6911.              type: 1
  6912.  
  6913.              Percentage to add to the node's bill.
  6914.  
  6915.                                         107
  6916.  
  6917.  
  6918.  
  6919.  
  6920.  
  6921.  
  6922.  
  6923.         @membership
  6924.  
  6925.              type: 1
  6926.  
  6927.              The membership fee that this person should pay.
  6928.  
  6929.         @pfileecho
  6930.  
  6931.              type: 1
  6932.  
  6933.              The name of  the pending (i.e.  requested from uplink  by this
  6934.              system) fileecho. 
  6935.  
  6936.         @pdesc
  6937.  
  6938.              type: 1
  6939.  
  6940.              The description of the pending fileecho.
  6941.  
  6942.         @pdate
  6943.  
  6944.              type: 1
  6945.  
  6946.              The  date that this  pending fileecho  was requested  from the
  6947.              uplink.
  6948.  
  6949.         @requestname
  6950.  
  6951.              type: 5
  6952.  
  6953.              The  magic name  that  was  file requested  but  could not  be
  6954.              found.
  6955.  
  6956.         @requesterr
  6957.  
  6958.              type: 3
  6959.  
  6960.              The  reason why the  magic name  could not be  found. Possible
  6961.              reasons  are  "Password  error", "File  exceeds  size  limit",
  6962.              "File exceeds number of files limit", and "File not found".
  6963.  
  6964.         @remotemailer,
  6965.         @remoteserial,
  6966.         @remoteversion
  6967.  
  6968.              type: 5
  6969.  
  6970.              The remote mailer  name, serial number, and version number for
  6971.              this file request, respectively.
  6972.  
  6973.         @sessiontype
  6974.  
  6975.              type: 5
  6976.  
  6977.              The type of file request session (unlisted/unsecure/secure).
  6978.  
  6979.  
  6980.                                         108
  6981.  
  6982.  
  6983.  
  6984.  
  6985.  
  6986.  
  6987.  
  6988.         @connectspeed
  6989.  
  6990.              type: 5
  6991.  
  6992.              The connect speed of this file request.
  6993.  
  6994.         @freqfrom,
  6995.         @freqfromaka
  6996.  
  6997.              type: 5
  6998.  
  6999.              The name of  the sysop performing the file request and the aka
  7000.              of his or her system, respectively.
  7001.  
  7002.         @rpflimit,
  7003.         @rpslimit,
  7004.         @rptlimit
  7005.  
  7006.              type: 5
  7007.  
  7008.              The   maximum  number   of  files,   size,  and   time  limit,
  7009.              respectively, for this file request session.
  7010.  
  7011.         @downtime
  7012.  
  7013.              type: 3
  7014.  
  7015.              This function predicts the download  time for a file based  on
  7016.              the  connection  speed  of  the  system  performing  the  file
  7017.              request.
  7018.  
  7019.         @requestbegin
  7020.  
  7021.              type: 5
  7022.  
  7023.              Begin a request block,  used for displaying the  filenames and
  7024.              magic file names that were not found.
  7025.  
  7026.         @groupbegin
  7027.  
  7028.              type: 1,3
  7029.  
  7030.              Begin a group block. 
  7031.  
  7032.         @filebegin
  7033.  
  7034.              type: 3
  7035.  
  7036.              Begin a file block. 
  7037.  
  7038.         @areabegin
  7039.  
  7040.              type: 1,3
  7041.  
  7042.              Begin a fileecho block.
  7043.  
  7044.  
  7045.                                         109
  7046.  
  7047.  
  7048.  
  7049.  
  7050.  
  7051.  
  7052.  
  7053.         @billbegin
  7054.  
  7055.              type: 3
  7056.  
  7057.              Begin a bill block.
  7058.  
  7059.         @pendingbegin
  7060.  
  7061.              type: 1
  7062.  
  7063.              Begin a pending fileecho block.
  7064.  
  7065.         @end
  7066.  
  7067.              type: 1,3
  7068.  
  7069.              End the  last block that has been opened with a begin command.
  7070.              The block commands will be explained in the next section.
  7071.  
  7072.         @allowbreak
  7073.  
  7074.              type: 1,2,3
  7075.  
  7076.              Signal that a page break may occur here,  if the length of the
  7077.              current page is almost at the maximum size.
  7078.  
  7079.         @forcebreak
  7080.  
  7081.              type: 1,2,3
  7082.  
  7083.              Force a page break to occur at this point.
  7084.  
  7085.  
  7086.         6.14.3    Blocks
  7087.  
  7088.         It is possible  to define a  loop using  the block commands.  Every
  7089.         block must be  terminated with  a @end  command and  blocks may  be
  7090.         nested within each other, however a block may not contain a  nested
  7091.         block of the same type.
  7092.  
  7093.         Everything that is contained within a  block will be output as many
  7094.         times as the block is repeated.
  7095.  
  7096.         The  best way to explain  how a block works is  to give an example.
  7097.         The following template outputs a list of all the fileechos:
  7098.  
  7099.         @areabegin
  7100.         @fileecho
  7101.         @end
  7102.  
  7103.         The  block is started with the values  for the first fileecho. Each
  7104.         time the  end of the block  is reached, the macro  interpreter will
  7105.         jump back to the beginning, with the values  for the next fileecho,
  7106.         until there are no more fileechos left. 
  7107.  
  7108.         The other blocks  works exactly the  same as the  previous example,
  7109.  
  7110.                                         110
  7111.  
  7112.  
  7113.  
  7114.  
  7115.  
  7116.  
  7117.  
  7118.         except that they act on different variables. 
  7119.  
  7120.  
  7121.         6.14.4    Functions
  7122.  
  7123.         The macro language  also contains a  variety of functions  that can
  7124.         be used to manipulate the values returned by the keywords.
  7125.  
  7126.         In the following statement: 2 + 3, the  function plus (denoted by a
  7127.         '+' character) returns the  value of 2 added to 3. The values 2 and
  7128.         3 are the input  variables and the value  5 is the result  returned
  7129.         by the function plus.
  7130.  
  7131.         A function such as  the plus in the  previous example is called  an
  7132.         infix  function because  the  function  is  between the  two  input
  7133.         values.  Another  possibility is  postfix,  where  the function  is
  7134.         listed behind  the input  values. The  last possibility is  prefix,
  7135.         where the function is listed before the input values. 
  7136.  
  7137.         The  postfix format of  the previous example is:  (2,3)+ . Here the
  7138.         function is clearly listed after both inputs have been defined. 
  7139.  
  7140.         The  prefix format  of the  previous example  is: +(2,3).  Here the
  7141.         function is listed before both inputs. 
  7142.  
  7143.         APL  uses the  prefix  format for  all the  functions. Some  of the
  7144.         functions  need variables  and others  do not.  It is  important to
  7145.         point out that  keywords are  in principle  also functions  without
  7146.         any  variables since  they return  a constant  value that  does not
  7147.         depend  on  any input  variables.  This is  very  important because
  7148.         keywords and  functions can be  used interchangeably as  inputs for
  7149.         functions.  There are a  number of  exceptions to this  rule, which
  7150.         will be explained later.
  7151.  
  7152.         Before  listing  and  explaining  each   function  in  APL,  it  is
  7153.         necessary to introduce a few notation rules. 
  7154.  
  7155.         1. [X|Y]
  7156.  
  7157.              Means either X or  Y. The separator |  means 'or'. Any  number
  7158.              of options may be listed  between the square brackets and  any
  7159.              one  of them may  be selected, but no  more than one. Whenever
  7160.              such  a selection  is  possible, each  character  will have  a
  7161.              certain meaning. For example: [L|R]  might mean left or right.
  7162.  
  7163.  
  7164.         2. "string"
  7165.  
  7166.              A  string is  any sequence  of characters  enclosed by  double
  7167.              quotes. An empty string is denoted by two double quotes: "". 
  7168.  
  7169.         3. [,option]
  7170.  
  7171.              Any  option enclosed  by two  brackets and  containing a comma
  7172.              within the brackets denotes an optional parameter that  may be
  7173.              left  out.  Some  functions   have  more  than  one   optional
  7174.  
  7175.                                         111
  7176.  
  7177.  
  7178.  
  7179.  
  7180.  
  7181.  
  7182.  
  7183.              parameter.  Optional parameters may be left  out, but they may
  7184.              not be  skipped  ie.  if  the  second  optional  parameter  is
  7185.              necessary  then the first  one must  also be specified,  but a
  7186.              third one may be left out.
  7187.  
  7188.         4. =
  7189.  
  7190.              This character symbol means equal to. 
  7191.  
  7192.         5. <>
  7193.  
  7194.              This character symbol means not equal to.
  7195.  
  7196.         6. @id
  7197.  
  7198.              This  character symbol  stands for  the term  identifier which
  7199.              refers to keywords, functions,  or variables (to be  explained
  7200.              later). Any one  of the previous three identifiers may be used
  7201.              in place of the @id character symbol.
  7202.  
  7203.         7. @const
  7204.  
  7205.              This  character  symbol stands  for  the  term constant  which
  7206.              refers  to a  numerical constant  or a  string, which  must be
  7207.              enclosed with quotes.
  7208.  
  7209.         8. @var
  7210.  
  7211.              This character symbol  stands for the term variable  which can
  7212.              be assigned values and used as any other identifier.
  7213.  
  7214.  
  7215.         The following is a list of list of all the functions:
  7216.  
  7217.         @just(@id, [L|R], Size [,PadChar] [,R])
  7218.  
  7219.              This function justifies  the value  of an  identifier left  or
  7220.              right in a field  of length designated  by size and filled  up
  7221.              with  characters  designated by  padchar.  If the  R,  for Raw
  7222.              mode,  is used  then the string  will be  cut off if  it is to
  7223.              long, otherwise APL will attempt to  trim off the last word by
  7224.              searching  for the first  space at the end  of the string. The
  7225.              default value of the padchar is a space.
  7226.  
  7227.  
  7228.         @center(@id,Size [,PadChar] [,R])
  7229.  
  7230.              This function centers  the value of  an identifier in  a field
  7231.              of  length  designated   by  size  and  filled   up  with  the
  7232.              characters designated by padchar. If  the R, for Raw mode,  is
  7233.              used  then  the string  will  be cut  off  if it  is  to long,
  7234.              otherwise  APL will  attempt  to  trim off  the  last word  by
  7235.              searching  for the first  space at the end  of the string. The
  7236.              default value of the padchar is a space.
  7237.  
  7238.  
  7239.  
  7240.                                         112
  7241.  
  7242.  
  7243.  
  7244.  
  7245.  
  7246.  
  7247.  
  7248.         @copy(@id, begin [,num] [,R])
  7249.  
  7250.              This function is used to  copy a portion from the value  of an
  7251.              identifier. The  position to  start copying is  specified with
  7252.              the begin  option and  the number  of characters  is specified
  7253.              with the num option. If the R, for Raw mode,  is used then the
  7254.              string  will be  cut off where  specified, otherwise  APL will
  7255.              attempt to copy until the  last word that would otherwise  get
  7256.              cut off.
  7257.  
  7258.  
  7259.         @overflow
  7260.  
  7261.              This function  repeats the  previous @just, @center,  or @copy
  7262.              command with the rest  of the string that  did not fit in  the
  7263.              field  or was  not copied  from the  value of  the identifier.
  7264.              This  command will  be  repeated as  many  times as  necessary
  7265.              until the entire result has been output.
  7266.  
  7267.         @clearoverflow
  7268.  
  7269.              When there is "overflow", this  text will not be removed  from
  7270.              the  buffer  until the  next  function  that causes  overflow.
  7271.              Sometimes, it is necessary to empty the overflow buffer.  This
  7272.              function can be used for that purpose.
  7273.  
  7274.         @setoflimit(Size)
  7275.  
  7276.              This function  can be  used to set  a limit  to the number  of
  7277.              times an  overflow  function  is  repeated  for  a  particular
  7278.              field. If the value of  Size is 5, for example, no more than 5
  7279.              overflow  lines will be  written, even if  the overflow buffer
  7280.              is  not yet empty.  This function  can, therefore, be  used to
  7281.              reduce  the size  of  a  new  file  report,  for  example,  by
  7282.              limiting the length of a long description to.
  7283.  
  7284.         @test(@id,[=|<>],[@id|@const])
  7285.           {block}
  7286.         @else
  7287.           {block}
  7288.         @end
  7289.  
  7290.              This  function  compares  the  value  of  an  identifier  with
  7291.              another identifier  or  constant. If  the  test returns  true,
  7292.              then the block  following the @test will be executed, till the
  7293.              @end or @else keyword. If the  @else command is used, then the
  7294.              block  following that  keyword will  be  executed if  the test
  7295.              returns  false.  The   @else  keyword  does  not  have  to  be
  7296.              specified. The @else  was not included in the list of keywords
  7297.              because it only  has one function  and that is  in conjunction
  7298.              with the @test function.
  7299.  
  7300.  
  7301.         @assign(@var,[@id|@const])
  7302.  
  7303.              This function assigns  the value of an identifier  or constant
  7304.  
  7305.                                         113
  7306.  
  7307.  
  7308.  
  7309.  
  7310.  
  7311.  
  7312.  
  7313.              to a variable  name. Up to 20  distinct variable names  may be
  7314.              defined.
  7315.  
  7316.  
  7317.         @add(@var,[@id|@const])
  7318.  
  7319.              This function adds the value  of an identifier or constant  to
  7320.              the  value of  the variable.  If one  of the  two values  is a
  7321.              string, then both  values will be  treated as strings  and the
  7322.              new  value  of   the  variable   will  be   the  two   strings
  7323.              concatenated together.  If both  values are numbers,  then the
  7324.              value of the  variable will be the two numbers added together.
  7325.  
  7326.  
  7327.  
  7328.         @sub(@var,[@id|@const])
  7329.  
  7330.              This  function   subtracts  the  value  of  an  identifier  or
  7331.              constant  from the  value  of a  variable. This  function only
  7332.              works when both values are numbers.
  7333.  
  7334.  
  7335.         @include([d:]\path\filename.ext)
  7336.  
  7337.              This  function  will  import a  standard  text  file  into the
  7338.              output. APL does not scan the text for any macro commands. 
  7339.  
  7340.              Example:
  7341.  
  7342.              @test(@daynr,=,24)
  7343.              @test(@monthnr,=,12)
  7344.              @include(c:\christmas.txt)
  7345.              @end
  7346.              @end
  7347.  
  7348.         @includeapl([d:]\path\template.apl)
  7349.  
  7350.              This function  will import a  template file  into the  current
  7351.              template. APL will  process all of  the macros that  this file
  7352.              contains.
  7353.  
  7354.              Example:
  7355.  
  7356.              @test(@daynr,=,24)
  7357.              @test(@monthnr,=,12)
  7358.              @includeapl(c:\christmas.apl)
  7359.              @end
  7360.              @end
  7361.  
  7362.         @filterdesc
  7363.  
  7364.              This  function will  filter any  ASCII characters  outside the
  7365.              range [32..127]  from the file description. This function must
  7366.              be included inside the file block.
  7367.  
  7368.         @filtercr
  7369.  
  7370.                                         114
  7371.  
  7372.  
  7373.  
  7374.  
  7375.  
  7376.  
  7377.  
  7378.              This  function will filter any carriage  returns from the file
  7379.              description. This  function must  be included within  the file
  7380.              block.
  7381.  
  7382.         @filteransi
  7383.  
  7384.              This  function will  filter any ANSI  sequence codes  from the
  7385.              file description.  This function  must be included  within the
  7386.              file block.
  7387.  
  7388.         @pos(@id,[@id|"string"])
  7389.  
  7390.              This function returns  the position of the value of the second
  7391.              identifier  in the value  of the first  identifier. The result
  7392.              of this function  is the logical  position minus 1  (ie. first
  7393.              position  is 0 etc) or the value  NIL if the second value does
  7394.              not  occur in  the  first  value. This  function  is not  case
  7395.              sensitive.
  7396.  
  7397.         @len(@id)
  7398.  
  7399.              This  function  returns   the  length  of  the   value  of  an
  7400.              identifier.
  7401.  
  7402.         @uppercase(@id)
  7403.         @lowercase(@id)
  7404.         @capitalize(@id)
  7405.  
  7406.              These three functions  turn the value  of @id into  upper case
  7407.              characters,  lower   case  characters,   or  all  lower   case
  7408.              characters    with   the   first   character   in   uppercase,
  7409.              respectively.
  7410.  
  7411.         @nomsgoutput
  7412.  
  7413.              This  function  will  abort message  output.  If  it is  used,
  7414.              anywhere  within   the  template  file,  no  message  will  be
  7415.              generated.  This  function  is   not  available  for  type   4
  7416.              templates.
  7417.  
  7418.         @openoutput([@id|@const],[rewrite|append])
  7419.  
  7420.              This  function   will  attempt  to  open  a  file  for  output
  7421.              designated  by the  value of  an identifier  or constant.  The
  7422.              rewrite  directive  will  create   a  new  file.  The   append
  7423.              directive will attempt to append the  output to the file if it
  7424.              exists, otherwise a new file will be created.
  7425.  
  7426.         @closeoutput
  7427.  
  7428.              This function will  close the file  opened by the  @openoutput
  7429.              function. 
  7430.  
  7431.  
  7432.         7    ALLFIX
  7433.  
  7434.  
  7435.                                         115
  7436.  
  7437.  
  7438.  
  7439.  
  7440.  
  7441.  
  7442.  
  7443.         ALLFIX  is the actual  fileecho utility.  If ALLFIX is  run without
  7444.         any  commandline   options,  then  the  following  help  screen  is
  7445.         displayed:
  7446.  
  7447.         -------------------------------------------------------------
  7448.         Usage: ALLFIX <commands> [switches]
  7449.  
  7450.         Commands:
  7451.  
  7452.            Announce         Generate new file reports
  7453.            Scan             Scan   message   base   for   file  information
  7454.                             requests
  7455.            File             Process inbound TIC files and create new file
  7456.                             announcements
  7457.            Mgr              Process AreaMgr requests
  7458.            Notify           Send notify lists to all your up and downlinks
  7459.            Bill             Send out all pending bills
  7460.            FakeReq          Process a fake AreaMgr request
  7461.            Credit           Increase or decrease a node's credit
  7462.            ReRequest        Re-send uplink request messages
  7463.            ReLink           Re-link all fileechos from uplinks
  7464.            Rp               External request processor
  7465.  
  7466.         Switches
  7467.  
  7468.            -Crash,-Hold     Set crash or hold bit on all netmail
  7469.            -NoCrc           Do not  perform  a CRC  check  on all  incoming
  7470.                             files
  7471.            -NoSize          Do  not perform  a Size  check on  all incoming
  7472.                             files
  7473.            -NoNew           Do not scan the BBS file areas for new files
  7474.            -NoDupe          Skip  dupe  checking  when   importing/hatching
  7475.                             files
  7476.            -NoKill          Do not delete any old .TIC and queue files
  7477.            -TossBad         Process files in bad tic directory
  7478.            -File            Used  to  specify an  alternative  template for
  7479.                             the Notify command
  7480.            -Groups          Used to  specify  the groups  to  include in  a
  7481.                             Notify message
  7482.            -NoSpaceChk      Do not check for sufficient disk space
  7483.            -NoMagic         Do not process any Magic filename entries
  7484.            -SRIF            Used  with the  Rp command  to signal  that the
  7485.                             next  option  passed on  the commandline  is an
  7486.                             SRIF file.
  7487.  
  7488.         -------------------------------------------------------------
  7489.  
  7490.         The commands and switches can be in any  order. The first letter of
  7491.         the command may also be used instead of the command. 
  7492.  
  7493.         Example:  ALLFIX F A 
  7494.  
  7495.         instead of:    ALLFIX File Announce
  7496.  
  7497.  
  7498.         7.1  Announce
  7499.  
  7500.                                         116
  7501.  
  7502.  
  7503.  
  7504.  
  7505.  
  7506.  
  7507.  
  7508.         The new file  reports database is  stored in the  files TOBEREP.FIX
  7509.         and TOBEREP.IDX. If  there are any files in the  database that have
  7510.         not  yet been  reported,  then  this command  will  tell ALLFIX  to
  7511.         generate the necessary new file reports.
  7512.  
  7513.         ALLFIX  can store  up  to  8000  files  in  the  new  file  reports
  7514.         database.  ALLFIX will announce  all of  the files in  the database
  7515.         each time that  the Announce command  is given. The  database files
  7516.         will be truncated to 0  bytes when ALLFIX has announced all  of the
  7517.         files.
  7518.  
  7519.  
  7520.         7.2  Scan
  7521.  
  7522.         This  command tells ALLFIX  to scan  the message base  for FileFind
  7523.         requests.  ALLFIX will  scan  the  BBS  file  areas  for  any  file
  7524.         specifications and/or  keywords  requested. If  any matching  files
  7525.         are found, then appropriate replies will be generated.
  7526.  
  7527.         7.3  File
  7528.  
  7529.         This command tells  ALLFIX to process incoming  .TIC files, process
  7530.         magic filenames,  process AreaMgr  requests and  scan the  BBS file
  7531.         areas for new files. 
  7532.  
  7533.         The following switches can be used with this command:
  7534.  
  7535.         -Crash,-Hold        Force the  crash or  hold bit on  all generated
  7536.                             outbound mail.
  7537.  
  7538.         -NoCrc         Force  ALLFIX   to  skip  the  CRC  check  for  each
  7539.                        incoming file. 
  7540.  
  7541.         -NoSize        Force ALLFIX  to skip the  File size check  for each
  7542.                        incoming  file.  ALLFIX  checks  the  file  size  by
  7543.                        comparing it with the  size listed in the  .TIC file
  7544.                        (if  one is  listed). T-Mail  marks files  that have
  7545.                        not  been  transferred  completely  by  making  them
  7546.                        Hidden.  If you  use T-Mail,  then ALLFIX  will also
  7547.                        check  the status  of the  Hidden flag.  This switch
  7548.                        will disable that check as well.
  7549.  
  7550.         -NoNew         Force  ALLFIX to  skip the search  for new  files in
  7551.                        the BBS file areas.
  7552.                           
  7553.         -NoDupe        Force  ALLFIX to  skip the  duplicate file  checking
  7554.                        for  those  fileechos  where  that  option  has been
  7555.                        enabled. ALLFIX  will  write a  warning  to the  log
  7556.                        file when processing duplicate files.
  7557.  
  7558.         -NoKill        Force ALLFIX to  not delete any  old .TIC and  queue
  7559.                        files. Normally  ALLFIX will delete all the .TIC and
  7560.                        queue files that have been  sent. This switch can be
  7561.                        used to disable that feature.
  7562.  
  7563.         -TossBad       Force  ALLFIX to process  files in the  bad tics and
  7564.  
  7565.                                         117
  7566.  
  7567.  
  7568.  
  7569.  
  7570.  
  7571.  
  7572.  
  7573.                        duplicate files  directories.  When processing  .TIC
  7574.                        files  in those  two directories,  ALLFIX  will also
  7575.                        look in  the inbound directories and in the received
  7576.                        file  directory for  the associated  files. This  is
  7577.                        necessary when  the .TIC files  are received  before
  7578.                        the actual  files. The  actual files can  then still
  7579.                        be located  in the  inbound directories or  they may
  7580.                        have been moved to the received files directory.
  7581.  
  7582.         ALLFIX uses intelligent searching techniques to make sure  that the
  7583.         correct files are  processed. It often happens that a file transfer
  7584.         session is aborted,  due to a bad  connection. When the  session is
  7585.         restarted,  the mailer  sometimes does  not realize  that the  file
  7586.         being  received  was  aborted.  Therefore,  it  will  automatically
  7587.         rename the incoming  file. Usually the last letter of the extension
  7588.         of the  file is changed to a number, ranging  from 1 to 9. In order
  7589.         to make  sure that ALLFIX proesses  the correct file,  it will look
  7590.         for these renamed  archives. The  last one it  finds should be  the
  7591.         correct  one, and  it will  then process  that file.  The following
  7592.         example will help clarify this:
  7593.  
  7594.              Let's  assume  that  a  file  is  being  sent  with  the  name
  7595.              FILE.ZIP. During  the transmission,  something goes wrong  and
  7596.              the session  is aborted. Your system re-asserts the connection
  7597.              and  your mailer  starts receiving the  same file  again. Your
  7598.              mailer will rename  the file to FILE.ZI1. When you run ALLFIX,
  7599.              it will look  for FILE.ZIP, since that is  the filename in the
  7600.              .TIC file. However,  ALLFIX is now  smart enough to  also find
  7601.              FILE.ZI1. 
  7602.  
  7603.         When  ALLFIX has found  an alternative  file (i.e. FILE.ZI1  in the
  7604.         above example) then it  will swap the file  names. In terms of  our
  7605.         example above,  FILE.ZIP  will become  FILE.ZI1  and FILE.ZI1  will
  7606.         become FILE.ZIP. 
  7607.  
  7608.  
  7609.         7.4  Mgr
  7610.  
  7611.         This command tells ALLFIX to process AreaMgr requests. 
  7612.  
  7613.         The  AreaMgr allows  systems to  connect and  disconnect themselves
  7614.         from fileechos to which they have access.
  7615.  
  7616.         ALLFIX will also  process AreaMgr requests when the File command is
  7617.         used.
  7618.  
  7619.         ALLFIX processes messages to 'ALLFIX'  or any of the file  'AreaMgr
  7620.         recognition strings'  defined in the AreaMgr options menu. Messages
  7621.         should originate from an address  in the Node manager. The  AreaMgr
  7622.         password  should be placed  on the  Subject line, and  should match
  7623.         the AreaMgr  password  in the  Node manager.  The  body of  message
  7624.         should contain at least one of the following commands.
  7625.  
  7626.         +<areaname>    To connect to an area
  7627.         -<areaname>    To disconnect from an area
  7628.         %H[ELP]        To request the help screen
  7629.  
  7630.                                         118
  7631.  
  7632.  
  7633.  
  7634.  
  7635.  
  7636.  
  7637.  
  7638.         %L[IST]        To request a list of areas available to you
  7639.         %Q[UERY]       To request  a  list  of  areas  for  which  you  are
  7640.                        connected
  7641.         %U[NLINKED]    To  request a  list of  areas available  to you,  to
  7642.                        which you are not already connected.
  7643.         %P[ASSWORD]    To change your AreaMgr password
  7644.         %-[ALL]        To disconnect from all areas
  7645.         %+[ALL]        To connect to all areas
  7646.         %+[GROUP] To connect to a group of fileechos
  7647.         %-[GROUP]      To disconnect a group of fileechos
  7648.         %C[OMPRESSION]=
  7649.                        Choose  the  compression type  (ARC,ARJ,LZH,PAK,ZIP,
  7650.                        and SQZ)
  7651.         %NOTIFY=[On/Off]
  7652.                        To turn the notify function on/off for your system
  7653.         %MESSAGE=[On/Off]
  7654.                        To turn the message function on/off for your system
  7655.         %TICK=[On/Off] To turn the TICK file option on/off for your system
  7656.         %STATUS        To request a status report (notify, message etc)
  7657.         %RESEND [fileecho]:[filename]
  7658.                        To request that  ALLFIX resend a  certain file in  a
  7659.                        specific fileecho. Wildcards may be used.
  7660.         %PAUSE         To  temporarily  turn off  all  areas  that are  not
  7661.                        mandatory.
  7662.         %RESUME        To turn any inactive areas back on
  7663.         %FROM [address]     Remote maintenance.
  7664.         [---]               Everything below the tear line is ignored
  7665.  
  7666.         Systems  can  only   add  areas  in  groups  for  which  they  have
  7667.         authorization  as  defined  in  the  Node  manager.  The  following
  7668.         commands may be used  on the same line, but AFTER the password: -Q,
  7669.         -L,  -H, or -U,  which stand  for %QUERY, %LIST,  %HELP, %UNLINKED,
  7670.         respectively.
  7671.  
  7672.         Example:
  7673.  
  7674.         By: Harald Harms
  7675.         To: ALLFIX, 2:281/415
  7676.         Re: <password>
  7677.         St: Pvt Local Kill
  7678.         -------------------------------------------------
  7679.         +SYSOPS
  7680.         -GENERAL
  7681.         %QUERY
  7682.         %LIST
  7683.         %PASSWORD MYPWORD
  7684.  
  7685.  
  7686.         7.5  Notify
  7687.  
  7688.         The Notify command is  used to send notification messages to one or
  7689.         more systems. The accepted format is:
  7690.  
  7691.              ALLFIX Notify <address> <-File [template]> <-Groups [groups]>
  7692.  
  7693.         If no address  is given, then ALLFIX  will send the  notify message
  7694.  
  7695.                                         119
  7696.  
  7697.  
  7698.  
  7699.  
  7700.  
  7701.  
  7702.  
  7703.         to all the systems  in the Node manager that have the Notify option
  7704.         enabled.  If an  address  is  specified, then  ALLFIX  will send  a
  7705.         notify message to that  system, assuming it is defined in  the Node
  7706.         manager,  regardless of  the Notify  setting for  that system.  The
  7707.         address  may   also   contain  the   wildcard   '*'.  The   address
  7708.         specification  2:* means everything  in zone  2. 2:*/2  means every
  7709.         node 2  in zone  2. It  is possible  to  send a  notify message  to
  7710.         someone  who  is  not  listed  in the  Node  manager,  but  may  be
  7711.         connected to one or more fileechos.
  7712.  
  7713.         The -File option is optional.  It tells ALLFIX which template  file
  7714.         should be  used in  the notification message.  The NOTIFY  template
  7715.         file  is used  when no  other is  specified. The  extension of  the
  7716.         template file should not be included.
  7717.  
  7718.         The -Groups option can  be used to  specify the groups that  should
  7719.         be  included  in  the  notify   message.  Multiple  groups  can  be
  7720.         specified  using  commas to  seperate the  groups and  two periods,
  7721.         "..", to indicate a range. 
  7722.  
  7723.         Example:
  7724.  
  7725.         ALLFIX Notify 2:281/415 -File MYNOTIFY -Groups 2,5,36..58
  7726.  
  7727.         The address specification, the  -File, and the -Groups options  are
  7728.         only available in the registered version of ALLFIX.
  7729.  
  7730.  
  7731.         7.6  Bill
  7732.  
  7733.         The Bill  command can  be  used to  force ALLFIX  to  send out  all
  7734.         pending  bills. The command  works in  the same  way as  the Notify
  7735.         command explained in section 7.5.
  7736.  
  7737.  
  7738.         7.7  FakeReq
  7739.  
  7740.         The  FakeReq command  can be  used to  simulate an  AreaMgr request
  7741.         from the command line.  This command can be  used to add people  to
  7742.         fileechos,  request   that  certain   files  are  resent,   or  for
  7743.         performing  any other  AreaMgr function.  This command  requires an
  7744.         address and at least one AreaMgr command:
  7745.  
  7746.              ALLFIX FakeReq <address> <AreaMgr cmd, AreaMgr cmd, ...>
  7747.  
  7748.              Example:  ALLFIX FakeReq 2:281/415 +ALLFIX %LIST
  7749.  
  7750.              The  above example has  the same  affect as if  node 2:281/415
  7751.              would  send an  AreaMgr request  in which  he requested  to be
  7752.              added to the  fileecho "ALLFIX" and  also requested a  list of
  7753.              the connected fileechos.
  7754.  
  7755.         * note:   People who use 4DOS or 4OS2 need to  use two % characters
  7756.                   whenever one  would normally  be used. This  is necessary
  7757.                   because 4DOS and 4OS2 use  the % character for a  special
  7758.                   purpose.  Using  two signals  to  4DOS  or  4OS2 that  it
  7759.  
  7760.                                         120
  7761.  
  7762.  
  7763.  
  7764.  
  7765.  
  7766.  
  7767.  
  7768.                   should not interpret the second % as a  special character
  7769.                   and  leave it in  the command  line. When using  4DOS and
  7770.                   4OS2, the above example should read:
  7771.  
  7772.                   ALLFIX FakeReq 2:281/415 +ALLFIX %%LIST
  7773.  
  7774.  
  7775.         7.8  Credit
  7776.  
  7777.         The Credit command  can be used  to increase or  decrease a  node's
  7778.         credit  from the  command line.  This  command requires  an address
  7779.         specification and  the number  of units (dollars,  guilders, marks,
  7780.         etc) to add or subtract, from the node's current credit. 
  7781.  
  7782.              ALLFIX Credit <address_spec> <value>
  7783.  
  7784.         Example:  ALLFIX Credit 2:281/415 +25
  7785.  
  7786.                   ALLFIX Credit 2:* -10
  7787.  
  7788.  
  7789.         7.9  ReRequest
  7790.  
  7791.         This command tells  ALLFIX to re-request all of the requested areas
  7792.         from the uplink. Unknown areas  that are requested from the  uplink
  7793.         are  put  into   a  special  database.  After  30  days,  they  are
  7794.         automatically  removed.  This command  can  be  used to  re-request
  7795.         those areas  if they have not  been received yet.  Please note, the
  7796.         date will be  reset, so that the areas will  remain in the database
  7797.         for another 30 days after invoking this command.
  7798.  
  7799.  
  7800.         7.10 ReLink
  7801.  
  7802.         This command tells ALLFIX to re-link  all of the fileechos with the
  7803.         uplinks. When  invoked, ALLFIX  will write uplink  request messages
  7804.         for all of the fileechos to which any of  the uplinks in the Uplink
  7805.         menu are connected.  This option is usefull when  the configuration
  7806.         is lost due to a system crash, for example.
  7807.  
  7808.  
  7809.         7.11 Rp
  7810.  
  7811.         For  an  explanation of  the  Request  Processor, please  refer  to
  7812.         section 6.9.
  7813.  
  7814.  
  7815.         7.12 Log file
  7816.  
  7817.         ALLFIX will log its activity if a log file has been specified.  The
  7818.         log  file   contains  information  about  what  ALLFIX   did  in  a
  7819.         particular session.  The style of  the log  file can be  changed in
  7820.         the global options menu.
  7821.  
  7822.  
  7823.         7.13 Errorlevels
  7824.  
  7825.                                         121
  7826.  
  7827.  
  7828.  
  7829.  
  7830.  
  7831.  
  7832.  
  7833.         ALLFIX will  exit with one  of the following  errorlevels depending
  7834.         on the type of activity that was performed.
  7835.  
  7836.         254            An unrecoverable error occurred.
  7837.  
  7838.         11             Netmail was generated.
  7839.  
  7840.         10             Netmail and echomail was generated.
  7841.  
  7842.         9              Echomail was generated.
  7843.  
  7844.         8              Files were imported.
  7845.  
  7846.         7              Files  were  hatched,   but  no  other   files  were
  7847.                        processed.
  7848.  
  7849.         0              There was nothing to do.
  7850.  
  7851.  
  7852.         7.14 ALLFIX semaphore file
  7853.  
  7854.         ALLFIX,  ASETUP, and  HATCH use  the ALLFIX.BSY  semaphore file  to
  7855.         make sure that only  one of the previous tasks is active at any one
  7856.         time. 
  7857.  
  7858.         A semaphore file is  nothing more than a  method to send a  message
  7859.         to  another  process. One  of the  three above  mentioned processes
  7860.         will  open the  semaphore  file when  it  starts.  If the  file  is
  7861.         already open, then the process  will abort because that means  that
  7862.         there is already another process using the configuration files. 
  7863.  
  7864.         The  reason this protection  routine has  been built is  to prevent
  7865.         file  sharing conflicts  which frequently  affect the  integrity of
  7866.         the configuration files.
  7867.  
  7868.  
  7869.         8    Cookies
  7870.  
  7871.         ALLFIX supports  the concept  of cookies, introduced  by a  program
  7872.         called  FileFix. The  name cookie  comes from  the idea  of fortune
  7873.         cookies.  Today  a  cookie  can  be  any  small  text  usually  not
  7874.         consisting  of more than  a few lines. Cookies,  as they are called
  7875.         in  this documentation,  can  be  included  in  messages  with  the
  7876.         appropriate template  keyword. The  cookies are selected  at random
  7877.         from the collection of cookies stored in the COOKIE.DAT file.
  7878.  
  7879.  
  7880.         8.1  BAKE
  7881.  
  7882.         Bake is a  utility that converts a standard ASCII  text file into a
  7883.         cookie data file that can be used by ALLFIX. 
  7884.  
  7885.         Usage: BAKE [d:]path\input.ext [d:]path\output.ext
  7886.  
  7887.         The input file must be a pure ASCII  text file. Each cookie must be
  7888.         separated with one or more  blank lines. Please note: cookies  that
  7889.  
  7890.                                         122
  7891.  
  7892.  
  7893.  
  7894.  
  7895.  
  7896.  
  7897.  
  7898.         have  blank  line  within  them  will  be  interpreted as  multiple
  7899.         cookies.
  7900.  
  7901.         The output file is a cookie data file.
  7902.  
  7903.         Included in  the  distribution archive  is a  example  of a  cookie
  7904.         file.  The name of the file is  COOKIE.TXT. This text file needs to
  7905.         be baked into  a COOKIE.DAT file,  stored in the  system directory,
  7906.         before ALLFIX can use the cookie database.
  7907.  
  7908.  
  7909.         8.2  SCRAMBLE
  7910.  
  7911.         Scramble is a  utility to randomly  select a different  cookie data
  7912.         file. It  randomly  selects on  of the  COOKIExx.DAT  files in  the
  7913.         current directory  where  "xx" is  a  number, from  00  to 99,  and
  7914.         copies that file over the COOKIE.DAT file.
  7915.  
  7916.  
  7917.         8.3  COOKIE
  7918.  
  7919.         Cookie is  a utility that  will randomly select  a cookie from  the
  7920.         COOKIE.DAT file and display it to the standard output. 
  7921.  
  7922.  
  7923.         9    FIXUTIL
  7924.  
  7925.         FIXUTIL is a general maintenance utility to be used with ALLFIX. 
  7926.  
  7927.         Usage:
  7928.  
  7929.            FIXUTIL <commands> [parameters]
  7930.  
  7931.         Commands:
  7932.  
  7933.         Allfiles
  7934.              Create an ALLFILES listings. 
  7935.  
  7936.         Pack
  7937.  
  7938.              Pack history or statistics file.
  7939.  
  7940.         Describe
  7941.  
  7942.              Import fileecho descriptions from FILEBONE.RA.
  7943.  
  7944.         Stat
  7945.  
  7946.              Display fileecho statistics.
  7947.  
  7948.         UpdateCrc
  7949.  
  7950.              Update the CRCs in the .TIC files.
  7951.  
  7952.         BuildDataBase
  7953.  
  7954.  
  7955.                                         123
  7956.  
  7957.  
  7958.  
  7959.  
  7960.  
  7961.  
  7962.  
  7963.              Build files database for new file report scanning.
  7964.  
  7965.         Purge
  7966.  
  7967.              Purge fileechos.
  7968.  
  7969.         SortFILES.BBS (not ALLFIX!)
  7970.  
  7971.              Sort FILES.BBS files for all BBS file areas.
  7972.  
  7973.         CompileRequestIdx
  7974.  
  7975.              Compile  a list  of  all  of  the  files  available  for  file
  7976.              requesting into one data file called REQUEST.IDX.
  7977.  
  7978.         ProcessTemplate
  7979.  
  7980.              Process a template file and write output to a text file.
  7981.  
  7982.  
  7983.         9.1  Allfiles
  7984.  
  7985.         The Allfiles  command  has one  paramter,  namely, the  name,  also
  7986.         referred to as the "tag", of the allfiles definition in ASETUP.
  7987.  
  7988.              Example:
  7989.  
  7990.                   FIXUTIL Allfiles ALLFILES
  7991.  
  7992.              Where the tag  "ALLFILES" is the name of an  Allfiles entry in
  7993.              ASETUP.
  7994.         It is also possible to generate all allfiles defined in  ASETUP, at
  7995.         once.  In order  to do  that, simply do  not include  a tag  on the
  7996.         command  line. For  example, simply  calling up  "FIXUTIL Allfiles"
  7997.         will generate all of the allfiles listings.
  7998.  
  7999.  
  8000.         9.2  Pack
  8001.  
  8002.         The Pack command has one parameter. 
  8003.  
  8004.         -StatFile
  8005.  
  8006.              Packing  the statistics  file trims  the file  to the  maximum
  8007.              size, as specified in the Global  options menu. The statistics
  8008.              information is  stored  in the  file  called STATFILE.FIX  and
  8009.              STATFILE.IDX.
  8010.  
  8011.  
  8012.         9.3  Describe
  8013.  
  8014.         The  Describe   command  can  be   used  to  update   the  fileecho
  8015.         descriptions  with the  standard descriptions  as specified  in the
  8016.         FILEBONE.NA   file.   FIXUTIL   can   also   import   the  fileecho
  8017.         descriptions from  the  echolist  file  that can  be  created  with
  8018.         ASETUP.
  8019.  
  8020.                                         124
  8021.  
  8022.  
  8023.  
  8024.  
  8025.  
  8026.  
  8027.  
  8028.         The format of the FILEBONE.NA file is as follows:
  8029.  
  8030.              Area [fileecho]   [priv level]   [locks]   [description]
  8031.  
  8032.         Example of FILEBONE.NA file:
  8033.  
  8034.              Area BACKBONE  0      !     National:  Area  Lists  of FidoNet
  8035.                             BackBone
  8036.              Area SERVICES  0   !    FDN: File Distribution Networks  Joint
  8037.                             Letter
  8038.  
  8039.         The privilege levels and locks are not used  by ALLFIX, and will be
  8040.         ignored by FIXUTIL.
  8041.  
  8042.         The format of the echolist file is as follows:
  8043.  
  8044.              [fileecho] [description]
  8045.  
  8046.         Example of an echolist file:
  8047.  
  8048.              BACKBONE  National: Area Lists of FidoNet BackBone
  8049.              SERVICES  FDN: File Distribution Networks Joint Letter
  8050.  
  8051.         FIXUTIL, by  default,  expects a  FILEBONE.NA  file. The  -EchoList
  8052.         switch must be  used on the  commandline when  an echolist file  is
  8053.         being used.  FIXUTIL  supports two  other  commandline switches:  -
  8054.         RemoveGroup;  The  fileecho  descriptions  in  a  FILEBONE.NA  file
  8055.         contain the  name of the group to which that fileecho belongs. This
  8056.         switch  tells FIXUTIL to remove the groupname from the description;
  8057.         -NotOverWrite; This switch tells  FIXUTIL to only update  fileechos
  8058.         that do not have a  description. Normally, FIXUTIL will update  all
  8059.         the descriptions, replacing those that are already defined.
  8060.  
  8061.  
  8062.         9.4  Stat
  8063.  
  8064.         The  Stat   command  tells   FIXUTIL  to  generate   some  fileecho
  8065.         statistics.  The   statistics   information  is   read   from   the
  8066.         STATFILE.FIX and STATFILE.IDX files.
  8067.  
  8068.         FIXUTIL can  create .ANS and .ASC  files if a filename  is supplied
  8069.         on  the commandline. The  filename may  contain paths, but  can not
  8070.         contain any extensions as those will added automatically.
  8071.  
  8072.         Example:  FIXUTIL Stat C:\RA\TEXT\AFIXSTAT
  8073.  
  8074.         The  above  example  will   create  two  files,  AFIXSTAT.ANS   and
  8075.         AFIXSTAT.ASC in the directory C:\RA\TEXT.
  8076.  
  8077.  
  8078.         9.5  UpdateCrc
  8079.  
  8080.         The  UpdateCrc command  will  recalculate the  CRCs  for the  files
  8081.         still waiting  to be  sent  out. This  option only  works for  .TIC
  8082.         files that have not been compressed into TIC archives.
  8083.  
  8084.  
  8085.                                         125
  8086.  
  8087.  
  8088.  
  8089.  
  8090.  
  8091.  
  8092.  
  8093.         9.6  BuildDataBase
  8094.  
  8095.         The BuildDataBase command tells  FIXUTIL to generate the  FILES.FIX
  8096.         database files in each  of the BBS file areas configured in the BBS
  8097.         new  file dirs  menu and  in any  of the  directories in  which the
  8098.         HatchNew magic filename function is being used.
  8099.  
  8100.         The FILES.FIX files  are bayer tree files  that contain information
  8101.         about each file in  the directory. When a  new file is uploaded  or
  8102.         placed  in the directory by the SysOp,  ALLFIX will be able to tell
  8103.         that it is new by checking to see if it is in the database. 
  8104.  
  8105.         Bayer trees are extremely fast  database structures and this method
  8106.         is  only  a little  bit  slower than  scanning the  file  dates, as
  8107.         previous versions of ALLFIX did, but it is a lot more reliable.
  8108.  
  8109.         Sometimes it  is  not desirable  to rebuild  all  of the  FILES.FIX
  8110.         files. For large  systems, this process could take quite some time.
  8111.         In those situations,  the -CreateMissing switch can be used to only
  8112.         build those FILES.FIX files that are missing. 
  8113.  
  8114.  
  8115.         9.7  Purge
  8116.  
  8117.         The Purge command  can be used to maintain the fileecho destination
  8118.         directories. In the fileecho manager,  there are three options that
  8119.         can be used  to determine the maximum number  of files, the maximum
  8120.         number of  kilobytes, and the maximum age of files in a destination
  8121.         directory. Running  FIXUTIL  Purge will  remove  all the  necessary
  8122.         files  from   the  destination   directories  so  that   the  above
  8123.         requirements are met. For example,  if the maximum number of  files
  8124.         in a  destination directory is set to  500, and there are currently
  8125.         510, running the Purge command will delete the 10 oldest files.
  8126.  
  8127.  
  8128.         9.8  SortFILES.BBS
  8129.  
  8130.         The  SortFILES.BBS  command tells  FIXUTIL  to  sort the  FILES.BBS
  8131.         files in  each  of  the BBS  filearea  directories.  FIXUTIL  takes
  8132.         extended descriptions and comments into consideration when  sorting
  8133.         the files. Each list of files  separated by empty lines or comments
  8134.         is treated as  a block and  sorted independent of  the rest of  the
  8135.         file.  This  sort routine  also  takes  extended descriptions  into
  8136.         consideration when sorting the files.
  8137.  
  8138.         This  command  supports  one  switch,  namely  the  -UpdateCounters
  8139.         switch which tells FIXUTIL to  format the download counters in  the
  8140.         FILES.BBS  files according  to the  download counter  configured in
  8141.         ASETUP.  Download  counters which  are  smaller  (ie. contain  less
  8142.         digits)  than the  one in defined  in ASETUP will  be expanded, and
  8143.         those that are  larger (ie. contain more digits) will be shortened.
  8144.         All download counters will begin  on column 14 and the  description
  8145.         will  begin one  space  after the  download  counter. New  download
  8146.         counters are added to any files that do not yet have one.
  8147.  
  8148.         FIXUTIL  will ONLY  update the  download counters  if one  has been
  8149.  
  8150.                                         126
  8151.  
  8152.  
  8153.  
  8154.  
  8155.  
  8156.  
  8157.  
  8158.         defined in ASETUP. This means  that the download counters will  NOT
  8159.         be removed if  one has not been defined in ASETUP. This is a safety
  8160.         feature to prevent unnecessary problems.
  8161.  
  8162.         9.9  CompileRequestIdx
  8163.  
  8164.         The CompileRequestIdx command tells  FIXUTIL to compile all of  the
  8165.         files that are available for  file requests into one datafile  with
  8166.         the  REQUEST.IDX. This  file is  used by  the rqeuest  processor to
  8167.         find  the files  faster.  If  a REQUEST.IDX  file  is present,  the
  8168.         request  processor will use  the file instead  of actually scanning
  8169.         all of the  file areas or the  list directories. Because  this file
  8170.         is  not automatically updated  when new  files are received,  it is
  8171.         very  important  that  the  REQUEST.IDX be  updated  on  a periodic
  8172.         basis, for example, once a day, in order to remain up to date.
  8173.  
  8174.         If  the request processor  has problems  finding files that  are on
  8175.         the BBS  and in  the correct  areas, the  first thing to  do is  to
  8176.         delete the  REQUEST.IDX file. Without  that file, ALLFIX  will scan
  8177.         each  directory at the  moment it is processing  a file request. If
  8178.         it finds  the files, then that means  that the REQUEST.IDX file was
  8179.         not  up to date.  Running FIXUTIL  with this command  should update
  8180.         the file  and  the request  processor should  work  fine from  that
  8181.         point on.
  8182.  
  8183.  
  8184.         9.10 ProcessTemplate
  8185.  
  8186.         The ProcessTemplate command can be  used to process a template  and
  8187.         store the output  in a text file. The command  uses two parameters,
  8188.         namely  the name of the  template and the name of  the text file to
  8189.         create.
  8190.  
  8191.         All  AreaMgr  and  Notify  type  of  templates  can  be  used.  The
  8192.         templates  can, obviously, not  contain any  of Node (those  in the
  8193.         Node  manager) specific  macros. The  templates can  also not (yet)
  8194.         contain macros that pertain to individual files in the fileechos.
  8195.  
  8196.              Example:
  8197.  
  8198.                   FIXUTIL FILEBONE FILEBONE.NA
  8199.  
  8200.              Where FILEBONE is the name  of a template, and FILEBONE.NA  is
  8201.              the name of the text file to create.
  8202.  
  8203.  
  8204.         10   HATCH
  8205.  
  8206.         HATCH  is an  external hatching  utility. HATCH  does not  actually
  8207.         "hatch"  files,  rather,  it  creates a  fake  .TIC  file,  in your
  8208.         inbound directory that tells ALLFIX which files it should hatch.
  8209.  
  8210.         HATCH has two modes: commandline mode and interactive mode.
  8211.  
  8212.  
  8213.         10.1 Command line mode
  8214.  
  8215.                                         127
  8216.  
  8217.  
  8218.  
  8219.  
  8220.  
  8221.  
  8222.  
  8223.         The command line mode offers the  ability hatch files from the  dos
  8224.         prompt or in batch files. 
  8225.  
  8226.         Usage:    HATCH   Area   [areaname]   File   [filename.ext]    Desc
  8227.                   [description]  Replace [filename.ext] Magic  [magic name]
  8228.                   [Copy]
  8229.  
  8230.         Commands: 
  8231.  
  8232.         Area
  8233.  
  8234.              [areaname] must  be a  valid fileecho tag.  This command  must
  8235.              always be used.
  8236.  
  8237.         Desc
  8238.  
  8239.              [description] is  the description of  the file to  be hatched.
  8240.              Enclose the description  in quotes if it is contains more than
  8241.              one  word.  If  this  command is  not  used,  then  HATCH will
  8242.              attempt  to take the  description from the  file database. The
  8243.              Fdb command must be used  if the BBS system does not  make use
  8244.              of the standard FILES.BBS files.
  8245.  
  8246.         File
  8247.  
  8248.              [filename.ext]  must  be  a  filename  or  file specification.
  8249.              Paths may be included. This command must always be used. If  a
  8250.              file specification  is used, then  HATCH will attempt  to take
  8251.              the description from  the file database. The Fdb  command must
  8252.              be used if the  BBS system does not  make use of the  standard
  8253.              FILES.BBS files.
  8254.  
  8255.         Replace
  8256.  
  8257.              [filename.ext] is  the file  specification that this  new file
  8258.              should replace.
  8259.  
  8260.         Magic
  8261.  
  8262.              [magic  name] is the  magic name  ALLFIX should update  in the
  8263.              alias file.
  8264.  
  8265.         Release
  8266.  
  8267.              [dd-mm-yy]  is the date  on which  a file should  be released.
  8268.              All  systems, that  have  the prerelease  switch turned  on in
  8269.              this fileecho  will receive the file immediately. Systems that
  8270.              do not  have that switch  turned on, will receive  the file on
  8271.              the date entered in this field.
  8272.  
  8273.         [Copy]
  8274.  
  8275.              this  optional command tells  ALLFIX to  copy the file  to the
  8276.              destination directory instead of moving it.
  8277.  
  8278.         Example:
  8279.  
  8280.                                         128
  8281.  
  8282.  
  8283.  
  8284.  
  8285.  
  8286.  
  8287.  
  8288.              HATCH  Area ALLFIX File AFIX_430.ZIP Desc  "This is the latest
  8289.              release of ALLFIX"
  8290.  
  8291.              HATCH Area PDNPASCAL File \PASCAL\TP*.* Release 01-02-1996
  8292.  
  8293.  
  8294.         10.2 Interactive mode
  8295.  
  8296.         The interactive  mode  presents the  user with  a  menu from  which
  8297.         files can be hatched. 
  8298.  
  8299.         The following keys are available in interactive mode:
  8300.  
  8301.         ESC,F10
  8302.  
  8303.              Exit and hatch the file.
  8304.  
  8305.         F9
  8306.  
  8307.              Abort the hatching the file.
  8308.  
  8309.         The following is a description of the fields.
  8310.  
  8311.         Area
  8312.  
  8313.              The fileecho that this file needs to be hatched into.
  8314.  
  8315.         File
  8316.  
  8317.              The file that needs to be hatched.
  8318.  
  8319.         Copy
  8320.  
  8321.              This  optional command tells  ALLFIX to  copy the file  to the
  8322.              destination directory instead of moving it.
  8323.  
  8324.         Desc
  8325.  
  8326.              The description of  this file. HATCH will automatically try to
  8327.              read the file  description from the file database, when a file
  8328.              name  is entered in  the File field.  The imported description
  8329.              can be edited or replaced.
  8330.  
  8331.         Magic
  8332.  
  8333.              The  magic name  for this  file, which  will be  added to  the
  8334.              alias file.
  8335.  
  8336.         Replace
  8337.  
  8338.              The filespec that this file should replace. 
  8339.  
  8340.         Release
  8341.  
  8342.              The date the file should  be released. All systems, that  have
  8343.              the  prerelease switch turned on in this fileecho will receive
  8344.  
  8345.                                         129
  8346.  
  8347.  
  8348.  
  8349.  
  8350.  
  8351.  
  8352.  
  8353.              the file immediately.  Systems that  do not  have that  switch
  8354.              turned on, will  receive the file on the date  entered in this
  8355.              field.
  8356.  
  8357.         There is an added  ability to fill some  of the fields with  values
  8358.         from  the command  line. This option  is very handy  for people who
  8359.         use FEBBS or  similar programs.  FEBBS can call  up HATCH and  pass
  8360.         along  the  filename and  description.  Those  two fields  will  be
  8361.         filled in  and all the user needs to fill  in is the Area field and
  8362.         possibly a  few other fields. In order  to use this feature, simply
  8363.         add the commandline  options, explained in the previous  section to
  8364.         the  commandline. If  the  "Area"  command is  used  the file  will
  8365.         automatically  be  hatched if  the  "File"  command is  also  used.
  8366.         Therefore, use all  of the commands  except the "Area"  command, or
  8367.         use all of the commands except the 'File'.
  8368.  
  8369.         Example:  HATCH File  TEST.ZIP  Desc "Testing  the  external  Hatch
  8370.                   program"
  8371.  
  8372.         In  this example,  HATCH will  jump to  interactive mode,  with the
  8373.         file and description fields already filled in.
  8374.  
  8375.  
  8376.         11   CRC32
  8377.  
  8378.         CRC32 is  small utility that  is designed to  calculate the  32 bit
  8379.         CRC for a  file. A Cyclic Redundancy  Check, or CRC, is  a easy and
  8380.         very fast  method to  check  whether a  file  has been  damaged  or
  8381.         changed.  A CRC is a unique signature,  belonging to only one file.
  8382.         Many programs  check the CRC with  the calculated CRC to  make sure
  8383.         that the file has not been damaged or tampered with. 
  8384.  
  8385.         CRC32 is very easy to  use. Simply type CRC32 followed by  the name
  8386.         of the file.  The CRC value returned,  as it is stored in  the .TIC
  8387.         files, in hexadecimal format.
  8388.  
  8389.  
  8390.         12   Hints
  8391.  
  8392.         12.1 Sample template files
  8393.  
  8394.         The TEMPLATE.ZIP file contains  several sample template files.  The
  8395.         purpose of most of the files has already been explained  in section
  8396.         6.14.  The  following  list  explains  the  purpose  of  the  other
  8397.         template files:
  8398.  
  8399.         BANNER
  8400.  
  8401.              This  is a  Banner  template  used  to  create  a  banner  for
  8402.              archives.
  8403.  
  8404.         MESSAGE
  8405.  
  8406.              This  is   a  netmail  announcement  template  used  to  write
  8407.              messages to accompany forwarded files.
  8408.  
  8409.  
  8410.                                         130
  8411.  
  8412.  
  8413.  
  8414.  
  8415.  
  8416.  
  8417.  
  8418.         REPORTS
  8419.  
  8420.              This is a New  file report template used to generate  new file
  8421.              reports.
  8422.  
  8423.  
  8424.         12.2 EAC utilities
  8425.  
  8426.         The   SAMPLE.ZIP  file   contains  a   sample   configuration  file
  8427.         (PALMSCAN.CFG) for PalmScan.
  8428.  
  8429.  
  8430.         12.3 Hatching files without moving them
  8431.  
  8432.         When  files are  hatched, they  are normally  moved from  an origin
  8433.         directory to  a destination  directory. ALLFIX  will  hatch a  file
  8434.         each  time the  file  specification entered  in  the Hatch  manager
  8435.         exists in the configured origin directory. 
  8436.  
  8437.         Sometimes  it is necessary  to hatch files that  are already in the
  8438.         destination directory. 
  8439.  
  8440.         When this occurs, ALLFIX will turn off the archive bit in order  to
  8441.         signal  that  the file  has  been hatched.  Otherwise,  ALLFIX will
  8442.         hatch the files over and over again. 
  8443.  
  8444.         It is extremely important that  no other program turns the  archive
  8445.         bit back on, unless the file has to be hatched again.
  8446.  
  8447.         It is known that this system is not  entirely fool proof. There are
  8448.         many other programs, namely backup  software, that make use of  the
  8449.         archive bit. However,  at the moment  it is the most  efficient way
  8450.         to  handle  this   problem.  Even  though   it  has  a   number  of
  8451.         disadvantages,  it does  offer  the ability  to  easily re-hatch  a
  8452.         file, by simply turning the archive bit back on.
  8453.  
  8454.         The magic filename manager offers  another way to hatch files  with
  8455.         the  Hatchnew option. The  Hatchnew option is  more dependable and,
  8456.         therefore, recommended above this particular method.
  8457.  
  8458.  
  8459.         12.4 Errorlevels
  8460.  
  8461.         ALLFIX  reports   the  errorlevels  of  child  processes  with  the
  8462.         statement  errorlevel  [xx]  from  <program>  The  meaning  of  the
  8463.         errorlevel depends on  the process  and is  totally independent  of
  8464.         ALLFIX. 
  8465.  
  8466.         The following is a  list of error  levels for PKZIP/UNZIP and  ARJ.
  8467.         For a list  of the errorlevels  for other programs,  please consult
  8468.         the accompanying documentation. 
  8469.  
  8470.         Errorlevels for PKZIP and PKUNZIP:
  8471.  
  8472.         PKZIP:
  8473.                   0    No error.
  8474.  
  8475.                                         131
  8476.  
  8477.  
  8478.  
  8479.  
  8480.  
  8481.  
  8482.  
  8483.                   1    Bad file name or file specification.
  8484.                   2,3  Error in ZIP file.
  8485.                   4-11 Insufficient Memory.
  8486.                   12   No files  were found to  add to the ZIP  file, or no
  8487.                        files were specified for deletion.
  8488.                   13   File not  found.   The  specified ZIP  file or  list
  8489.                        file was not found.
  8490.                   14   Disk full.
  8491.                   15   ZIP file is read-only and can not be modified.
  8492.                   16   Bad or illegal parameters specified.
  8493.                   17   Too many files.
  8494.                   18   Could not open file
  8495.                   19-23,
  8496.                   29   Insufficient Memory
  8497.                   26   DOS 3.2 or later needed to span disks
  8498.                   28   Destination for  .ZIP is  same as temporary  file or
  8499.                        Source and destination is the same
  8500.                   255  User pressed control-c or control-break
  8501.  
  8502.         PKUNZIP:
  8503.                   0    No error.
  8504.                   1    Warning error (such as failed CRC check).
  8505.                   2,3  Error in ZIP file.
  8506.                   4-8  Insufficient Memory.
  8507.                   9    File not found.  No ZIP files found.
  8508.                   10   Bad or illegal parameters specified.
  8509.                   11   No files found to extract/view etc.
  8510.                   50   Disk Full.
  8511.                   51   Unexpected EOF in ZIP file.
  8512.  
  8513.         Errorlevels for ARJ:
  8514.  
  8515.                   0    No error.
  8516.                   1    warning  (specified  file  to  add  to  archive  not
  8517.                        found,  specified file  to list, extract,  etc., not
  8518.                        found, or  answering negatively to "OK to proceed to
  8519.                        next volume..." prompt)
  8520.                   2    fatal error
  8521.                   3    CRC error (header or file CRC error)
  8522.                   4    ARJ-SECURITY  error or  attempt  to update  an  ARJ-
  8523.                        SECURED archive
  8524.                   5    disk full or write error
  8525.                   6    can't open archive or file
  8526.                   7    simple user error (bad parameters)
  8527.                   8    not enough memory
  8528.  
  8529.  
  8530.         12.4.1    Common errorlevels
  8531.  
  8532.         The  most  common  errorlevels  are ones  dealing  with  not enough
  8533.         memory. For PKZIP that means  levels 4-11, for PKUNZIP levels  4-8,
  8534.         and for  ARJ level  8. ALLFIX  is capable  of swapping the  program
  8535.         memory to XMS,  EMS, or Disk, and it is  recommended that option is
  8536.         used when memory problems occur.
  8537.  
  8538.         Another  common errorlevel occurs when ALLFIX attempts to extract a
  8539.  
  8540.                                         132
  8541.  
  8542.  
  8543.  
  8544.  
  8545.  
  8546.  
  8547.  
  8548.         FILE_ID.DIZ file from  an archive. ALLFIX is not capable of looking
  8549.         inside an archive to determine  if it contains a FILE_ID.DIZ  file.
  8550.         Therefore, it simply  attempts to unpack  it from the  archive. The
  8551.         decompression program  will exit with  an error if  the FILE_ID.DIZ
  8552.         file is not contained  in the archive. This  error  is very  normal
  8553.         and should not cause any alarm.
  8554.  
  8555.         First  consult  the  appropriate   documentation  about  errorlevel
  8556.         before approaching the author.
  8557.  
  8558.  
  8559.         12.5 Common errors while importing files
  8560.  
  8561.         Following  is a  list of  common errors  that occur  when importing
  8562.         files:
  8563.  
  8564.         Invalid destination drive: '<drive>'
  8565.  
  8566.              This  error occurs  when  the drive  on which  the destination
  8567.              directory, for this  fileecho, is located does not  exist. The
  8568.              files  for this  fileecho  will  be  moved  to  the  bad  tics
  8569.              directory. After the  problem has been corrected,  they can be
  8570.              reprocessed using the -Tossbad switch.
  8571.  
  8572.         Invalid destination directory: '<directory>'
  8573.  
  8574.              This  error   occurs  when  the  destination  directory  of  a
  8575.              fileecho does not exist. The  files for this fileecho will  be
  8576.              moved to the  bad tics directory.  After the problem  has been
  8577.              corrected, they can be reprocessed using the -Tossbad switch.
  8578.  
  8579.         Insufficient disk space on the destination drive: '<drive>'
  8580.  
  8581.              This error means  that the file being imported does not fit on
  8582.              the  destination  drive   or  that  the  space   left  on  the
  8583.              destination drive  after  importing this  file  would be  less
  8584.              than  the minimum space required, as  configured in the Global
  8585.              Options menu.
  8586.  
  8587.         Duplicate file: '<filename>'
  8588.  
  8589.              This  error means that  the file  being processed  has already
  8590.              been processed. The criteria used to determine if a file  is a
  8591.              duplicate can be  configured in the Global  Options menu. Less
  8592.              stringent  criteria  should  be used  if  there  are too  many
  8593.              problems  with duplicate files  or based  on the needs  of the
  8594.              system.
  8595.  
  8596.         CRC check failed: '<filename>'
  8597.  
  8598.              This error means  that the file being processed has failed the
  8599.              integrity  check. There are  several possible explanations for
  8600.              this problem.  The most  likely explanation  is that the  file
  8601.              was  damaged during  transmission. Another  likely possibility
  8602.              is  that the CRC stored in the .TIC file was calculated wrong.
  8603.              Do not use the  -Crc switch in order  to process files with  a
  8604.  
  8605.                                         133
  8606.  
  8607.  
  8608.  
  8609.  
  8610.  
  8611.  
  8612.  
  8613.              CRC error.
  8614.  
  8615.         Invalid password '<password>' from <node>
  8616.  
  8617.              This error means  that this node  is using the  wrong password
  8618.              when sending  files to  this system. Change  the configuration
  8619.              for this node  in the  Node manager or  contact this node  and
  8620.              correct the problem.
  8621.  
  8622.         Node is not allowed to send files in this fileecho: <node>
  8623.  
  8624.              This error means that this node  is not allowed to send  files
  8625.              to  this  system.  The  configuration for  this  node  in  the
  8626.              systems list, for this fileecho,  specifies that no files  are
  8627.              to  be received from  this node.  Update the  configuration or
  8628.              contact  this node  to determine  why it  is sending  files to
  8629.              this system.
  8630.  
  8631.         File missing: '<filename>'
  8632.  
  8633.              This error means  that the file  referred to in the  .TIC file
  8634.              does not exist.
  8635.  
  8636.         Undefined area: '<fileecho tag>'
  8637.  
  8638.              This  error means that  the fileecho  referred to in  the .TIC
  8639.              file   does   not   exist.  ALLFIX,   when   configured,   can
  8640.              automatically add  new  fileechos, in  which  case this  error
  8641.              will not occur.
  8642.  
  8643.         Undefined node: <node>
  8644.  
  8645.              This  error means  that this node  is not  listed in  the Node
  8646.              manager. ALLFIX  requires  that  each  node,  that  files  are
  8647.              received from, must be configured in the Node manager.
  8648.  
  8649.         No Queue directory defined for pass through areas
  8650.  
  8651.              This  error  means that  the  queue directory,  used  to store
  8652.              files for pass through areas,  is not defined. The consequence
  8653.              is that ALLFIX is not able  to process the pass through files.
  8654.              They will be moved to the bad tics directory.
  8655.  
  8656.         Can  not auto-add  new fileecho:  No matching  Mask found  in group
  8657.         manager
  8658.  
  8659.              This error is  reported when ALLFIX  can not  find a group  in
  8660.              the group  manager with a  mask that matches the  name of this
  8661.              fileecho.  ALLFIX  uses the  masks  in  the group  manager  to
  8662.              determine which  group  defaults should  be used  for the  new
  8663.              fileechos. Please see section [xx] for more details.
  8664.  
  8665.         Unable to update file database!
  8666.  
  8667.              This particular error is reported  when ALLFIX is not able  to
  8668.              open the  BBS specific file  database files.  This problem  is
  8669.  
  8670.                                         134
  8671.  
  8672.  
  8673.  
  8674.  
  8675.  
  8676.  
  8677.  
  8678.              often encountered when  changes have been made to the BBS file
  8679.              area configuration  without running FCOMP afterwards to signal
  8680.              the  changes to ALLFIX.  If running  FCOMP does not  solve the
  8681.              problem, then make sure that  the destination directory of the
  8682.              fileecho is  defined exactly  the same  way as  the associated
  8683.              file area directory in the BBS configuration. ALLFIX uses  the
  8684.              directory names to find out which filearea it should use.
  8685.  
  8686.         Skipping <filename.TIC> not for us (node)
  8687.  
  8688.              This  error means that the .TIC file contains a To verb, which
  8689.              is used to  specify the destination system for that particular
  8690.              file. If the  destination address following the To verb is not
  8691.              one of the  AKAs of this  system, then  ALLFIX will give  this
  8692.              particular  error. It is possible that  the To verb is left in
  8693.              the .TIC file by another  type of fileecho processor. In  this
  8694.              case,  simply remove  that  line  in  the  .TIC  file  with  a
  8695.              standard ASCII  text  editor  and  execute  the  File  command
  8696.              again.
  8697.  
  8698.         Skipping <filname.TIC> file (<filename.ext>) is not complete
  8699.  
  8700.              This  error means that  the file  transfer is not  complete. A
  8701.              possible cause  is  that  the  mail  session  was  prematurely
  8702.              aborted.  Another cause is  that the  file size listed  in the
  8703.              .TIC file  is not correct.  It is possible to  force ALLFIX to
  8704.              process this file,  by using the  -NoSize switch, which  turns
  8705.              of the file size check.
  8706.  
  8707.  
  8708.         12.6 Using ALLFIX without a compatible (or no) BBS
  8709.  
  8710.         This  section does not  pertain to  those people using  ALLFIX! for
  8711.         WildCat!  since it  is not  possible  to use  that  type of  ALLFIX
  8712.         without a BBS system.
  8713.  
  8714.         Most of the features  in ALLFIX can be  used without having a  BBS.
  8715.         However,  of the  features, such  as the  FileFind feature  and the
  8716.         Allfiles listings (FIXUTIL) can only be used when you have a BBS. 
  8717.  
  8718.         In order to  make it possible for those  people not using a  BBS to
  8719.         also make use of these types of features,  FCOMP has the ability to
  8720.         scan the  fileechos  instead of  the  fileareas. Everywhere,  where
  8721.         people running a  BBS would see their BBS file  areas, you will see
  8722.         your fileechos. Simply run FCOMP with the parameter 255. 
  8723.  
  8724.         ALLFIX  will, by  default, create  FILES.BBS files  in each  of the
  8725.         fileecho destination directories. If  this is not required,  simply
  8726.         toggle  the No  Touch switch  in  each of  the fileechos  and those
  8727.         files will not be created.
  8728.  
  8729.  
  8730.         12.7 Creating a FILEBONE.?? file
  8731.  
  8732.         FIXUTIL  can be used to generate a FILEBONE.NA style file. A sample
  8733.         template  has been included with ALLFIX. This template, however, is
  8734.  
  8735.                                         135
  8736.  
  8737.  
  8738.  
  8739.  
  8740.  
  8741.  
  8742.  
  8743.         not the  only thing  one will need  to generate a  real FILEBONE.NA
  8744.         file.
  8745.  
  8746.         The  template,  FILEBONE.APL, will  generate  a  list of  fileechos
  8747.         conform the standard of the FILEBONE.NA file. 
  8748.  
  8749.         A real FILEBONE.NA file  has a textual description of each group of
  8750.         fileechos  in the list.  In order  to include descriptions  of each
  8751.         group in the generated FILEBONE.NA file,  comment out the following
  8752.         lines in the FILEBONE.APL file:
  8753.  
  8754.         @assign(@tmp,'C:\ALLFIX\TEMPLATES\GROUP.')
  8755.         @add(@tmp,@group)
  8756.         @include(@tmp)
  8757.  
  8758.         This  section in the  template is used  to include text  files into
  8759.         the template output.  The name of  the include files  are GROUP.XXX
  8760.         where XXX is the  number of the group. If you make  such a file for
  8761.         each group,  in the  Group manager,  then you  can generate a  real
  8762.         FILEBONE.NA file using this template.
  8763.  
  8764.         If  you require  headers  and  footers in  the  output, simply  add
  8765.         @include() macros to the beginning and end of the template.
  8766.  
  8767.  
  8768.         12.8 Frequently asked questions
  8769.  
  8770.         This  section contains a number of  frequenly asked questions. Some
  8771.         of these questions  and answers have been put together by dedicated
  8772.         beta team members.
  8773.  
  8774.  
  8775.         Question
  8776.                   ALLFIX/2 aborts with  a runtime error when I use the File
  8777.                   command. 
  8778.  
  8779.         Answer 
  8780.                   ALLFIX/2  may   abort  with   a  runtime  error   if  the
  8781.                   FILEDUPE.FIX file  or the  ALLFIX.DAT files  are corrupt.
  8782.                   Therefore,   move  the   FILEDUPE.FIX  file   to  another
  8783.                   directory, to  see if  that solves  the problem.  If that
  8784.                   does not  solve  the problem,  then  move the  ALLFIX.DAT
  8785.                   file.  If this  does not solve  the problem  either, then
  8786.                   please contact the author. 
  8787.  
  8788.         Question
  8789.                   My  BBS software is  not supported  by ALLFIX, what  I do
  8790.                   about it? 
  8791.  
  8792.         Answer 
  8793.                   Section  12.3 in  the documentation  explains how  to use
  8794.                   ALLFIX with  a  non-supported BBS.  However,  due to  the
  8795.                   rapid development in ALLFIX, there  is a good chance that
  8796.                   ALLFIX will support your BBS within the near future. 
  8797.  
  8798.         Question
  8799.  
  8800.                                         136
  8801.  
  8802.  
  8803.  
  8804.  
  8805.  
  8806.  
  8807.  
  8808.                   Some  of  my downlinks  are  complaining  about the  file
  8809.                   transfer rate when  they receive lots of new files. It is
  8810.                   way below  the normal performance. Is there anything that
  8811.                   I can do about this? 
  8812.  
  8813.         Answer 
  8814.                   Yes there  is. The reduction  in transfer rate  is caused
  8815.                   by the numerous .TIC files.  These files are generally to
  8816.                   small  to accomplish  a good  transfer rate  when sending
  8817.                   them  via a  modem.  In  the node  manager,  there is  an
  8818.                   option called "Packing mode".  By setting this option  to
  8819.                   "Pack .TIC files"  or to "Pack  ALL files", the  transfer
  8820.                   rate will  increase  since only  larger  files are  being
  8821.                   sent. 
  8822.  
  8823.         Question
  8824.                   I have  a downlink who  is interested in  receiving files
  8825.                   from one  or  more  of  the  file  distribution  networks
  8826.                   available on my system, but  he does not want to  receive
  8827.                   the acompanying .TIC files. Is this possible? 
  8828.  
  8829.         Answer 
  8830.                   Sure, just set  up your downlink  as you would  setup any
  8831.                   normal downlink in  the Node manager. If you set the "Tic
  8832.                   file  mode"  option for  this  downlink  to "None",  then
  8833.                   ALLFIX will not send this node any .TIC files. 
  8834.  
  8835.         Question
  8836.                   Some of my  downlinks take part of a cost sharing system.
  8837.                   I have  dfined the  fileechos as Cost  sharing echos  (by
  8838.                   setting  the Div  costs  option to  C/S  nodes), still  I
  8839.                   can't seem to  force ALLFIX to  send them any  bills. How
  8840.                   come? 
  8841.  
  8842.         Answer 
  8843.                   You  probably  failed   to  define   your  downlinks   as
  8844.                   participating in the cost sharing system. Go to  the Node
  8845.                   manager  in   ASETUP  and  for  every  node  that  should
  8846.                   participate in the cost  sharing, set the Billing  option
  8847.                   to Yes. 
  8848.  
  8849.         Question
  8850.                   ALLFIX does not seem to be passing the costs of  files on
  8851.                   to my downlinks. Why is this happening? 
  8852.  
  8853.         Answer 
  8854.                   The Cost verb, used in the .TIC  files to define the cost
  8855.                   of  the file, is  only used  in Advanced .TIC  files. You
  8856.                   should setup all your cost  sharing nodes to use Advanced
  8857.                   .TIC files.  The  option to  toggle is  called "Tic  file
  8858.                   mode". 
  8859.  
  8860.         Question
  8861.                   What is the  difference between "Add  %" in the  fileecho
  8862.                   manager and "Add %" in the node manager? 
  8863.  
  8864.  
  8865.                                         137
  8866.  
  8867.  
  8868.  
  8869.  
  8870.  
  8871.  
  8872.  
  8873.         Answer 
  8874.                   The  "Add  %"  found  in  the  fileecho  manager  is  the
  8875.                   percentage  value that  you can  add to  the cost  of all
  8876.                   incoming files. This value can  be used to compensate for
  8877.                   currency exchange rates. The "Add %" in  the node manager
  8878.                   is  the percentage value  that you  can add to  the total
  8879.                   bill for a node.  This value can be used to add the local
  8880.                   VAT to the bill, for example. 
  8881.  
  8882.         Question
  8883.                   I have a  downlink that is interested in  some particular
  8884.                   files in a  fileecho, but not in  the rest of  the files.
  8885.                   Is there a  way to only send those files  to that system.
  8886.                   For example, only send the  NODEDIFF.* files and not  the
  8887.                   NODELIST.* files? 
  8888.  
  8889.         Answer 
  8890.                   Yes, this  is  possible. You  need to  make  a new  Magic
  8891.                   filename entry in the  Magic filename manager. Select  as
  8892.                   type  "ForwardTo".  In the  From  Area  field select  the
  8893.                   fileecho in question.  In the Spec field, select the file
  8894.                   specification, such as  NODEDIFF.*. In  the systems  list
  8895.                   you  can enter the  node numbers  of all the  people that
  8896.                   should receive this file. 
  8897.  
  8898.         Question
  8899.                   How can I quickly create an "UNWANTED" file? 
  8900.  
  8901.         Answer 
  8902.                   If  you use  TranScan, you  can simply  use  your TS5.DEL
  8903.                   file. 
  8904.  
  8905.         Question
  8906.                   What good  is the "Update DESCRIPT.ION" file option, if I
  8907.                   do not use 4DOS? 
  8908.  
  8909.         Answer 
  8910.                   The DESCRIPT.ION file is  a FILES.BBS file that  contains
  8911.                   the filename  and the associated description. Such a file
  8912.                   can be very usefull  to find out what  each file is in  a
  8913.                   directory. So even  if you do not use 4DOS,  you may find
  8914.                   this feature usefull. 
  8915.  
  8916.         Question
  8917.                   ALLFIX is not reporting  newly uploaded files on  my BBS.
  8918.                   What am I doing wrong? 
  8919.  
  8920.         Answer 
  8921.                   There are two  things that can  be wrong. First,  you may
  8922.                   need  to  run  FIXUTIL  -BuildDataBase,  to  rebuild  the
  8923.                   FILES.FIX in  each of the BBS new  file dirs directories.
  8924.                   All new  files uploaded, after FIXUTIL has been run, will
  8925.                   be  reported. The  second source  of the  problem may  be
  8926.                   that you need  to run FCOMP  again. If you have  made any
  8927.                   changes to  your  BBS  file  areas, then  run  FCOMP  and
  8928.                   double check your BBS new file dirs configuration. 
  8929.  
  8930.                                         138
  8931.  
  8932.  
  8933.  
  8934.  
  8935.  
  8936.  
  8937.  
  8938.         Question
  8939.                   Why is  ALLFIX not writing to  my file database as  it is
  8940.                   supposed to do? 
  8941.  
  8942.         Answer 
  8943.                   In  order to write  to your  specific BBS  file database,
  8944.                   you must turn the "Use  FDB" option on for each  fileecho
  8945.                   associated with a  BBS file area. You must also make sure
  8946.                   to run  FCOMP periodically,  especially after making  any
  8947.                   changes to your BBS file areas. 
  8948.  
  8949.         Question
  8950.                   Why is ALLFIX is not  responding to any FileFind requests
  8951.                   I enter on my own system? 
  8952.  
  8953.         Answer 
  8954.                   In the  "Global options"  menu, there  is an option  that
  8955.                   tells  ALLFIX  whether or  not  is  should process  local
  8956.                   requests. If  this  option  is  turned  on,  ALLFIX  will
  8957.                   respond  to local requests. If this option is turned off,
  8958.                   which  is the  default value,  it will  not. The  name of
  8959.                   this option is "Process local requests". 
  8960.  
  8961.         Question
  8962.                   I  am running  Xenia as  my mailer.  What type  of mailer
  8963.                   should I select in ALLFIX? 
  8964.  
  8965.         Answer 
  8966.                   If you  have the  statement "NODOMHOLD" active  in Xenia,
  8967.                   then use "Portal of  Power" or "BinkleyTerm" without  any
  8968.                   domain names defined  in ALLFIX. If  you do not  hae that
  8969.                   statement active  in Xenia, then use "BinkleyTerm" and in
  8970.                   that case you are able to use domain names in ALLFIX. 
  8971.  
  8972.         Question
  8973.                   How should I setup the file descriptions for ProBoard? 
  8974.  
  8975.         Answer 
  8976.                   LongDesc character  + One line LongDesc No LongDesc width
  8977.                   0 Max len of LongDesc 0 Spaces to indent 1 
  8978.  
  8979.         Question
  8980.                   How should I setup the file descriptions for Maximus? 
  8981.  
  8982.         Answer 
  8983.                   LongDesc character  One line LongDesc No LongDesc width 0
  8984.                   Max  len  of LongDesc  0 Spaces  to indent  31 (if  no DL
  8985.                   counter is used) 36 (if a 2 digit DL counter is used) 
  8986.  
  8987.         Question
  8988.                   I am trying  to add an  area to the  "BBS new file  dirs"
  8989.                   menu, but ASETUP complains  that the area is a  duplicate
  8990.                   area, even though I am certain that it is not. 
  8991.  
  8992.         Answer 
  8993.                   Running ASETUP  Pack will solve the problem. This problem
  8994.  
  8995.                                         139
  8996.  
  8997.  
  8998.  
  8999.  
  9000.  
  9001.  
  9002.  
  9003.                   occurs periodically and is caused by changes in  your BBS
  9004.                   file area  configuration. In  order to make  ALLFIX aware
  9005.                   of those changes, you need to run ASETUP Pack. 
  9006.  
  9007.         Question
  9008.                   How do I setup various virus scanners in ALLFIX? 
  9009.  
  9010.         Answer 
  9011.                   F-Prot    :    SCAN  F-PROT.EXE  @1\*.*  /COMMAN   /NOMEM
  9012.                                  /NOBOOT AVP 
  9013.                   (lite)    :    SCAN AVPLITE @1\*.* /M /P /B 
  9014.                   McAfee (OS2):  SCAN OS2SCAN @1\*.* /ALL /SUB 
  9015.  
  9016.  
  9017.         Question
  9018.                   ALLFIX only shows  4 lines of  a file description  in new
  9019.                   file report or in a FileFind report. 
  9020.  
  9021.         Answer 
  9022.                   Check  the  announcement  or FileFind  template  for  the
  9023.                   statement  "setoflimit(x)", where x is a number. Increase
  9024.                   the number x to the desired value. 
  9025.  
  9026.         Question
  9027.                   Where can  I find information about the structures of the
  9028.                   ALLFIX configuration  files, so that  I can write  my own
  9029.                   utilities for ALLFIX? 
  9030.  
  9031.         Answer 
  9032.                   The structures are contained  in the DEVELOP.ZIP  archive
  9033.                   which is included with each release of ALLFIX. 
  9034.  
  9035.         Question
  9036.                   ALLFIX is  not  placing  new  files  for  new  auto-added
  9037.                   fileechos  in the  auto-add  directory. Earlier  versions
  9038.                   did do that. 
  9039.  
  9040.         Answer 
  9041.                   As of ALLFIX  4.32, new fileechos  are added to  specific
  9042.                   groups which can be defined  in the group manager. ALLFIX
  9043.                   will select a  group that has the best matching "mask". A
  9044.                   mask is nothing  more than a  specification such as  WIN*
  9045.                   or just  the string  *. A  destination  directory can  be
  9046.                   defined  for each  group.  It is  also  possible to  have
  9047.                   ALLFIX  automatically  create  unique  directories within
  9048.                   that directory  for  each  new  fileecho  added  to  that
  9049.                   group. 
  9050.  
  9051.         Question
  9052.                   Sometimes when I enter ASETUP, the menu  is flashing. The
  9053.                   only way I  have been  able to solve  that problem is  by
  9054.                   rebooting. 
  9055.  
  9056.         Answer 
  9057.                   One  possible solution to this problem  is to exit ASETUP
  9058.                   and then type MODE CO80 on the command line. 
  9059.  
  9060.                                         140
  9061.  
  9062.  
  9063.  
  9064.  
  9065.  
  9066.  
  9067.  
  9068.         Question
  9069.                   How do  I set up the  request processor in ALLFIX  for my
  9070.                   mailer? 
  9071.  
  9072.         Answer 
  9073.                   Below is a list of  the command line parameters that  you
  9074.                   need to use for the following mailers: 
  9075.  
  9076.                   FrontDoor : Rp =A =O =X =T =R 
  9077.                   InterMail : Rp %a %n %x %f 
  9078.                   MainDoor  : Rp =A =O =X =T =R 
  9079.                   Xenia     : Rp -SRIF 
  9080.                   McMail    : Rp -SRIF 
  9081.  
  9082.         Question
  9083.                   When  converting   files  from   the  .RAR  format,   RAR
  9084.                   sometimes asks  for a password  and waits until  the user
  9085.                   has entered one. This  affectively stops my system  until
  9086.                   I notice  this and enter a  fake password, to get  RAR to
  9087.                   continue. Is there a work-around for this problem? 
  9088.  
  9089.         Answer 
  9090.                   The  way to  solve  this  problem  is  to  pass  a  bogus
  9091.                   parameter to  RAR. In the External program  menu, add the
  9092.                   following  parameter to  the  decompression command  line
  9093.                   options  for RAR: -pp  The -p  switch tells RAR  that the
  9094.                   password is, in  this case, the letter p. RAR will ignore
  9095.                   this switch  when a password  is not necessary.  When one
  9096.                   is necessary, it  will use the given password  (letter p)
  9097.                   and most likely  exit with an  error, since the  password
  9098.                   is  wrong. But this  is not  a problem, since  ALLFIX can
  9099.                   continue. 
  9100.  
  9101.  
  9102.         Question
  9103.                   Is ALLFIX forwarding  files but they  are not turning  up
  9104.                   in  your netmail folder attached to  netmails (or in your
  9105.                   Binkley style outbound directory) ? 
  9106.  
  9107.         Answer 
  9108.                   The  problem   might  be  that  you  have  the  "Holding"
  9109.                   directory  option  turned  on  for  your  downlinks.  The
  9110.                   Holding  directory specifies  a  special directory  where
  9111.                   all outbound  files for  a particular system  are stored.
  9112.                   If you use  the Holding directory,  ALLFIX will NOT  send
  9113.                   the files via  the mailer.  In other  words, ALLFIX  will
  9114.                   not make  any netmail file  attaches or  update any  .?LO
  9115.                   files (for Binkley style mailers). 
  9116.  
  9117.         Question
  9118.                   RAR files  sometimes contain passwords. When ALLFIX tries
  9119.                   to convert  such a RAR file,  RAR will wait for  the user
  9120.                   to enter the password. How can this be prevented? 
  9121.  
  9122.         Answer 
  9123.                   The -pp  parameter  can  be  used  for  RAR,  which  will
  9124.  
  9125.                                         141
  9126.  
  9127.  
  9128.  
  9129.  
  9130.  
  9131.  
  9132.  
  9133.                   instruct RAR to try the password  "p" for a file. If  the
  9134.                   file contains  a password, this password will most likely
  9135.                   not be correct, which causes  RAR to report an error  and
  9136.                   it will then  exist. The end  result is that  ALLFIX will
  9137.                   not convert the file. 
  9138.  
  9139.         Question
  9140.                   I use QEMM and I  have the problem that ALLFIX  Universal
  9141.                   does not run. Instead of  starting up it either hangs  my
  9142.                   system or crashes in the active DESQview window. 
  9143.  
  9144.         Answer 
  9145.                   The  problem may be  related to  the Stacks verb  in your
  9146.                   CONFIG.SYS  file. The  following settings have  proven to
  9147.                   help with this problem: stacks=9,256 
  9148.  
  9149.         Question
  9150.                   ALLFIX often  reports  "You are  using  an illegal  key",
  9151.                   even though I am a registered user. Why? 
  9152.  
  9153.         Answer 
  9154.                   There are  two error  messages that ALLFIX  can generate,
  9155.                   one is  that you  are using an  invalid key and  one that
  9156.                   says  you are using  an illegal  key. ALLFIX  will report
  9157.                   that you are  using an invalid  key if  the key does  not
  9158.                   match the sysop  name in ASETUP. ALLFIX  will report that
  9159.                   you are using an  illegal key if your  key is not in  the
  9160.                   keyfile. The problem is,  therefore, that the keyfile  is
  9161.                   either  out of date, corrupt, or missing. The solution is
  9162.                   to pickup a new keyfile from your registration site. 
  9163.  
  9164.         Question
  9165.                   How should I setup the file descriptions for BBBS.
  9166.  
  9167.         Answer
  9168.                   The only thing  that you need  to do  to use ALLFIX  with
  9169.                   BBBS is  run FCOMP with  the correct parameters  and turn
  9170.                   the  "One   line  LongDesc"  option  on.  Lastly,  it  is
  9171.                   important  that the  "Use FDB"  option is  turned  on for
  9172.                   each fileecho. 
  9173.  
  9174.  
  9175.         13   Development
  9176.  
  9177.         Harms Software Engineering has NO plans  to stop developing ALLFIX.
  9178.         Future versions will see more options, better performance,  and who
  9179.         knows what else!
  9180.  
  9181.         Registered users have the privilege  of applying for a position  on
  9182.         the official  beta team. The beta  team is managed  by Harald Harms
  9183.         and Jim Smoot. Anyone interested  in applying for the team,  should
  9184.         fill  out the  AFIXBETA.FRM  included in  the  package and  contact
  9185.         Harald Harms at 2:281/415 or Jim Smoot at 1:395/602.
  9186.  
  9187.         All registered users  may use special Gamma versions of ALLFIX. The
  9188.         Gamma  versions  are  pre-release  version  designed  to  test  new
  9189.  
  9190.                                         142
  9191.  
  9192.  
  9193.  
  9194.  
  9195.  
  9196.  
  9197.  
  9198.         features. Anyone  interested  in using  the  Gamma versions  should
  9199.         contact their registration site.
  9200.  
  9201.  
  9202.         14   Credits
  9203.  
  9204.         Many thanks to the  registered users and beta testers in all of the
  9205.         following countries:
  9206.  
  9207.         Argentina,  Austria, Australia,  Belgium,  Canada, Czech  republic,
  9208.         Denmark, France, Finland, Germany,  Great Britain, Greece, Holland,
  9209.         Hong  Kong,  Israel,  Italy,  Japan,  Philippines,  Poland, Russia,
  9210.         Singapore, South  Africa, Spain,  Sweden, Switzerland,  Taiwan, and
  9211.         the United States of America.
  9212.  
  9213.         Thank  you for  your  registrations and  for  testing the  program,
  9214.         helping me with new suggestions,  and holding in there when  things
  9215.         got rough. I would like  to specially thank all the members  of the
  9216.         registration team and  the dedicated people  on the beta  team. The
  9217.         beta team currently consists of  +/- 100 people who test new  betas
  9218.         of ALLFIX  on  a  weekly basis.  Without  these  dedicated  people,
  9219.         ALLFIX would not be what it is today!
  9220.  
  9221.         All  brand  and  product   names  are  Copyrighted  (C)   material,
  9222.         Trademarks (tm)  or Registered  (R) Trademarks of  their respective
  9223.         holders: 
  9224.  
  9225.         Fido, FidoNet
  9226.  
  9227.              Tom Jennings and Fido Software
  9228.  
  9229.         FrontDoor, TosScan
  9230.  
  9231.              Joaquim Homrighausen, Definite Solutions
  9232.  
  9233.         RemoteAccess
  9234.  
  9235.              Bruce Morse
  9236.  
  9237.         Gecho
  9238.  
  9239.              Gerard J. van der Land
  9240.  
  9241.         PKZIP
  9242.  
  9243.              PKWARE, Inc.
  9244.  
  9245.         LHA
  9246.  
  9247.              Haruyasu Yoshizaki
  9248.  
  9249.         PAK
  9250.  
  9251.              NoGate Consulting
  9252.         ARJ
  9253.              Robert K. Jung
  9254.  
  9255.                                         143
  9256.  
  9257.  
  9258.  
  9259.  
  9260.  
  9261.  
  9262.  
  9263.         ARC, ARCmail
  9264.  
  9265.              Systems Enhancements Associates
  9266.  
  9267.         SQZ
  9268.              J. I. Hammarberg
  9269.  
  9270.         Ezycom
  9271.  
  9272.              Peter Davies
  9273.  
  9274.         SuperBBS
  9275.  
  9276.              Risto Virkkala and Aki Antman
  9277.  
  9278.         QuickBBS
  9279.  
  9280.              Benjamin Schollnick / Matrix Technologies
  9281.  
  9282.         QEMM, DESQview
  9283.  
  9284.              Quarterdeck Office Systems, Inc.
  9285.  
  9286.         Microsoft, MS-DOS,Windows
  9287.  
  9288.              Microsoft Corporation
  9289.  
  9290.         IBM, PC-DOS, OS/2
  9291.  
  9292.              International Business Machines Corp.
  9293.  
  9294.         FEBBS, Browse
  9295.  
  9296.              Fenris Ulven Data & Patrik Sjöberg
  9297.  
  9298.         BinkleyTerm
  9299.  
  9300.              Bit Bucket Software
  9301.  
  9302.         D'Bridge
  9303.  
  9304.              Mosaic Press
  9305.  
  9306.         Portal of Power
  9307.  
  9308.              The Portal Team
  9309.  
  9310.         FileMgr
  9311.  
  9312.              Ron Huiskes
  9313.  
  9314.         PalmScan
  9315.  
  9316.              Steven Hendriks
  9317.  
  9318.         MTA
  9319.  
  9320.                                         144
  9321.  
  9322.  
  9323.  
  9324.  
  9325.  
  9326.  
  9327.  
  9328.              Robert van Hoeven
  9329.  
  9330.         List
  9331.  
  9332.              Vernon D. Beurg
  9333.  
  9334.         Renegade
  9335.  
  9336.              Cott Lang
  9337.  
  9338.         FidoBill
  9339.  
  9340.              Craig Steiner
  9341.  
  9342.         JAM(mbp) 
  9343.  
  9344.              Joaquim Homrighausen, Andrew Milner, Mats Birch, Mats Wallin.
  9345.  
  9346.         MainDoor
  9347.  
  9348.              Francisco Sedano Crippa
  9349.  
  9350.         Concord BBS
  9351.  
  9352.              Pasi Talliniemi
  9353.  
  9354.         AdeptXBBS
  9355.  
  9356.              Nitin Chandra
  9357.  
  9358.         Maximus BBS
  9359.  
  9360.              Scott Dudley
  9361.  
  9362.         ProBoard
  9363.  
  9364.              Philippe Leybaert
  9365.  
  9366.         PCBoard
  9367.  
  9368.              Clark Development
  9369.  
  9370.         Telegard
  9371.  
  9372.              Tim Strike
  9373.  
  9374.         TriBBS
  9375.  
  9376.              Freejack's Software
  9377.  
  9378.         TBBS
  9379.  
  9380.              eSoft
  9381.  
  9382.         LoraBBS
  9383.  
  9384.  
  9385.                                         145
  9386.  
  9387.  
  9388.  
  9389.  
  9390.  
  9391.  
  9392.  
  9393.              Marco Maccaferri
  9394.  
  9395.         SynchroNet
  9396.  
  9397.              Digital Dynamics
  9398.  
  9399.         ShotGun
  9400.  
  9401.              Brent Shellenberg
  9402.  
  9403.  
  9404.         15   Technical Specs
  9405.  
  9406.            * ALLFIX is fully zone and point aware.
  9407.  
  9408.            * The main  packets created  by ALLFIX  are  fully FTS-0001  and
  9409.              FSC-0039  compatible,   using  the  Type  2+  header  and  the
  9410.              Capability Word.
  9411.  
  9412.            * The product code for ALLFIX is 0xEB.
  9413.  
  9414.            * To  detect duplicates, ALLFIX stores  the 32 bit  CRC of up to
  9415.              1000 files  in  the  FILEDUPE.FIX  file.  ALLFIX  checks  each
  9416.              inbound  file against  the  list  to  determine  if  it  is  a
  9417.              duplicate or not.
  9418.  
  9419.            * ALLFIX can touch  the mailer semaphore  files for each  of the
  9420.              supported mailer programs whenever any netmail is created.
  9421.  
  9422.            * ALLFIX  supports  semaphore  files for  FrontDoor,  InterMail,
  9423.              D'Bridge, and Dutchie.
  9424.  
  9425.            * ALLFIX  supports  the  RemoteAccess/FrontDoor  Hudson  Message
  9426.              Base filesharing specification.
  9427.  
  9428.            * ALLFIX  for  DOS was  developed  using  Turbo Pascal,  version
  9429.              7.00.
  9430.  
  9431.            * ALLFIX/2 for  OS/2 was developed using Virtual Pascal, version
  9432.              1.10.
  9433.  
  9434.            * ALLFIX Universal was  developed using Virtual  Pascal, version
  9435.              1.10 and LSxPower.
  9436.  
  9437.  
  9438.  
  9439.  
  9440.  
  9441.  
  9442.  
  9443.  
  9444.  
  9445.  
  9446.  
  9447.  
  9448.  
  9449.  
  9450.                                         146
  9451.