home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 2 BBS / 02-BBS.zip / nef238.zip / nef.INF (.txt) < prev    next >
OS/2 Help File  |  1996-12-09  |  168KB  |  6,225 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Readme First ΓòÉΓòÉΓòÉ
  3.  
  4.  
  5. NEF Readme First
  6.  
  7.  
  8. ΓòÉΓòÉΓòÉ 1.1. Files in the archive ΓòÉΓòÉΓòÉ
  9.  
  10.  
  11. Files in the original archive:
  12.  
  13. File_Id.Diz   The standard archive description
  14. Nef.Exe     The executable
  15. Nef.Ico     An Icon for NEF
  16. Nef1.Ico    Another Icon for NEF
  17. Nef.Inf     The Inf hypertextual Manual
  18. Readme.1st   This file
  19. Whatsnew.Txt  Changes and additions
  20. Nef_Ful.Cfg   The full example configuration file
  21. Nef_Pnt.Cfg   The minimal example cfg for points
  22. Ticarea.Cfg   The example area configuration
  23. Compress.Cfg  The example archiver-definition
  24. Prefix.Nef   The example announcement prefix
  25. Suffix.Nef   The example announcement suffix
  26. NefHelp.Txt   The example Link Robot help file
  27. Nef.Doc     The user's manual
  28. License.Doc   The license for using this software
  29. Register.Doc  Info on Registration
  30. Register.For  The registration form
  31. BmtMicro.For  The BMT Micro registration form
  32. PsL.Crd     The PsL Credit Card registration form supplement
  33.  
  34.               OS/2 Only
  35.  
  36. PmHatch.Exe   The PM hatch executable
  37. PmHatch.Ico   An Icon to be associated to "Nef Send"
  38.  
  39. feature\
  40.  Feature.Dll   An example Feature Dll
  41.  Feature.C    Its source
  42.  NeFeat.H    The necessary Include file
  43.  
  44.  
  45.               Dos Only
  46.  
  47. Dos4Gw.Exe   Dos Extender (major releases only)
  48.         If you have a maintenance release of the program,
  49.         the dos extender will not be included, to avoid
  50.         unnecessary distribution costs.
  51.  
  52.  
  53. Note: The Icons are kindly made available by Andrea Vavassori of
  54.    2:331/219.
  55.  
  56. The OS/2 Inf manual is provided with other versions too,
  57. since there are INF viewers under Dos. For example, the very
  58. nice viewer by Damir Ujcic: VIEW01.ZIP, available for F/R from
  59. 2:332/504@fidonet: it contains a text mode viewer in both OS/2
  60. and Dos versions.
  61.  
  62.  
  63. ΓòÉΓòÉΓòÉ 1.2. Whatsnew ΓòÉΓòÉΓòÉ
  64.  
  65.               Whatsnew
  66.  
  67. If you are using an older version of the program, please read
  68. WhatsNew.Txt before using this version.
  69.  
  70.  
  71. ΓòÉΓòÉΓòÉ 1.3. How to contact the author ΓòÉΓòÉΓòÉ
  72.  
  73.  
  74.           How to contact the author
  75.  
  76. If you have suggestions, bug reports, observations about the
  77. docs, please feel free to contact me at the following
  78. addresses:
  79.  
  80. Alberto Pasquale of 2:332/504@fidonet
  81.  
  82. alberto.pasquale@interbusiness.it
  83.  
  84. 2:332/504@fidonet +39-59-246112 V120 V34+ VFC V32T H16
  85. 2:332/524@fidonet +39-59-246113 X75 FAX-G3
  86.  
  87. Alberto Pasquale, Viale Verdi 106, 41100 Modena, Italy
  88.  
  89. IMPORTANT: if you call crash and require an answer, please state
  90. whether you want it routed (might not be reliable) or ON HOLD
  91. (in which case an answer should be available in 48h maximum,
  92. apart from the holiday periods).
  93.  
  94.  
  95. ΓòÉΓòÉΓòÉ 1.4. Support ECHO ΓòÉΓòÉΓòÉ
  96.  
  97.  
  98.              Support ECHO
  99.  
  100. I am originating an international support echo for all my
  101. programs. If you are interested, please ask your echo feeder to
  102. find a suitable link for the APWORKS area. In addition, I
  103. regularly read the international OS2BBS echo.
  104.  
  105.  
  106. ΓòÉΓòÉΓòÉ 1.5. TIC distribution ΓòÉΓòÉΓòÉ
  107.  
  108.  
  109.             TIC distribution
  110.  
  111. All my BBS related programs are distributed via a TIC file area.
  112. If you want to join, please ask your file feeder to find a
  113. suitable link for the APBBS (OS/2), APBBSDOS (Dos),
  114. APBBSWIN (WIN/NT) areas.
  115.  
  116. Public Beta versions are distributed without restrictions in
  117. APBBSBETA.
  118.  
  119. There are also APTOOLS for 3rd party tools related to APWORKS
  120. programs and APWORKSG for German documentation by Roland
  121. Schiradin.
  122.  
  123.  
  124. ΓòÉΓòÉΓòÉ 1.6. APWorks Programs and Support Areas ΓòÉΓòÉΓòÉ
  125.  
  126.  
  127.             Where to look for
  128.         APWorks Programs and Support Areas
  129.  
  130. In North America the APWORKS support echo should be easily
  131. available, since it is on the Zone 1 backbone.
  132.  
  133.  
  134. The following systems carry the ApWorks echo and file areas:
  135.  
  136.  
  137.               Author's
  138. APWORKS
  139.   Alberto Pasquale, Modena, Italy
  140.   alberto.pasquale@interbusiness.it
  141.   2:332/504@fidonet +39-59-246112 V120 V34+ VFC V32T H16
  142.   2:332/524@fidonet +39-59-246113 X75 FAX-G3
  143.   File requests could be declined between 23:00 and 06:00 GMT.
  144.   Request APFILES for a (short) list of APWORKS files only.
  145.  
  146.  
  147.                Europe
  148.  
  149. ApWorks_Germany
  150.   Roland Schiradin, Eltville, Germany
  151.   schiradi@tap.de
  152.   2:2454/169@fidonet
  153.  
  154. Cyberia/2
  155.   Harald Kamm, Bamberg, Germany
  156.   2:2490/3045@fidonet
  157.  
  158. The Ham Spirit
  159.   Karsten Jyhne, Malling, Denmark
  160.   2:238/87@fidonet
  161.  
  162. MufNet HQ
  163.   Paul Bergquist, Hollviken, Sweden
  164.   2:200/146@fidonet
  165.   paul.bergquist@moderat.se
  166.   paulb@sbbs.se
  167.  
  168. The BackRoom/2 BBS
  169.   Martin Davies, Cardiff, Wales, United Kingdom
  170.   gbear@backroom.baynet.co.uk
  171.   2:442/617@fidonet
  172.  
  173. Air Applewood
  174.   Vince Coen, Roydon, Harlow, Essex, United Kingdom
  175.   2:257/609@fidonet
  176.  
  177. PULSAR BBS
  178.   Branko Radojevic, Dubrovnik, Croatia
  179.   branko@pfdu.hr
  180.   sysop@pulsar.fido.hr
  181.   2:381/124@fidonet
  182.  
  183.  
  184.              North America
  185.  
  186. COMM Port OS/2
  187.   Bob Juge, Sugar Land, TX, USA
  188.   bob@juge.com
  189.   1:106/2000@fidonet
  190.  
  191. Common Sense
  192.   Mike Burgett, Newark, CA, USA
  193.   burgett@cmnsens.zoom.com
  194.   1:215/705@fidonet
  195.  
  196. Eclectic Lab 1
  197.   Mary-Anne Wise, New Westminster, BC, Canada
  198.   1:153/831@fidonet
  199.  
  200. Filebone:  MaxFDN
  201.   Available via Planet Connect, PageSat, Filebone,
  202.   paonline ftphub and the Filegate Project.
  203.  
  204.  
  205.               Australia
  206.  
  207. Tardis BBS
  208.   Malcolm Miles, North Balwyn, VIC, Australia
  209.   3:633/260@fidonet
  210.  
  211.  
  212. ΓòÉΓòÉΓòÉ 1.6.1. File Areas on the Internet ΓòÉΓòÉΓòÉ
  213.  
  214.           File Areas on the Internet
  215.  
  216.  
  217.                 UK
  218.  
  219. ftp.enterprise.net
  220.   /apworks
  221.  
  222. ftp.baynet.co.uk
  223.   /pub/apworks/os2
  224.   /pub/apworks/dos
  225.   /pub/apworks/beta
  226.  
  227.  
  228.                USA
  229.  
  230. ftp.juge.com
  231.  
  232. cmnsens.zoom.com
  233.   /pub/apworks/bbs
  234.   /pub/apworks/bbsdos
  235.   /pub/apworks/beta
  236.   /pub/apworks/dosbeta
  237.  
  238. ftp.oeonline.com
  239.   /pub/Maximus
  240.  
  241. ftp.bmtmicro.com
  242.   /bmtmicro
  243.   Only the public release versions of programs that can be
  244.   registered via Bmt Micro.
  245.  
  246.  
  247. ΓòÉΓòÉΓòÉ 1.7. Latest Versions ΓòÉΓòÉΓòÉ
  248.  
  249.  
  250.             How to Request the
  251.         Latest Version of APWORKS Programs
  252.  
  253.  
  254. The following magics are honoured by APWORKS and some of the
  255. support sites:
  256.  
  257. Magic   Name     Description
  258.  
  259. APFILES  ApFiles.Lst    List of Programs by Alberto Pasquale
  260.  
  261. FASTLST  FLST???.RAR  OS/2 The ultimate v7 Nodelist processor.
  262.               Fully automated processing and
  263.               maintenance, no need for clumsy batch
  264.               files. Can report to Squish or *.MSG
  265.               areas, multitasking friendly, many
  266.               options.
  267.  
  268. FASTLSTD FLSTD???.RAR DOS
  269.  
  270. FASTLSTW FLSTW???.RAR NT
  271.  
  272. FASTLSTG          German Docs by Roland Schiradin
  273.               Available on 2:2454/169
  274.  
  275. NEF    NEF???.RAR  OS/2 TIC file distribution and
  276.               announcement for Binkley-style
  277.               outbound and *.MSG or Squish message
  278.               base, file-Areafix included with
  279.               FileBone support, full multitasking
  280.               aware (BSY, file sharing etc.),
  281.               exceptionally flexible Multi-Aka
  282.               support.
  283.  
  284. NEFD   NEFD???.RAR  DOS  32 bit only, w DOS4GW extender.
  285.  
  286. NEFW   NEFW???.RAR  NT
  287.  
  288. NEFG            German Docs by Roland Schiradin
  289.               Available on 2:2454/169
  290.  
  291. FLM    FLM???.RAR  OS/2 File List Manager for Maximus,
  292.               very flexible way of compiling
  293.               many different lists at a time.
  294.               Internal file base support
  295.               (no need for FBP).
  296.  
  297. FLMD   FLMD???.RAR  DOS  32 bit only, w DOS4GW extender.
  298.  
  299. FLMW   FLMW???.RAR  NT
  300.  
  301. NMFW   NMFW???.RAR  OS/2 Multi-Robot: netmail forward to
  302.               Sysop's point, Maximus user and file
  303.               management via netmail messages,
  304.               areafix for squish, point routing to
  305.               their boss if no phone number for
  306.               them in the nodelist, etc.
  307.  
  308. NMFWD   NMFWD???.RAR DOS  32 bit only, w DOS4GW extender.
  309.  
  310. NMFWW   NMFWW???.RAR NT
  311.  
  312. QFB    QFB???.RAR  OS/2 Substitute for FBP.EXE
  313.               Generates a separate file-request
  314.               index with no duplicates.
  315.  
  316. QFBD   QFBD???.RAR  DOS  32 bit only, w DOS4GW extender
  317.  
  318. QFBW   QFBW???.RAR  NT
  319.  
  320. QFBG            German Docs by Roland Schiradin
  321.               Available on 2:2454/169
  322.  
  323. SQPRV   SQPV???.RAR  OS/2 Local area (private/public) forward
  324.               to points for Squish. The (Co)SysOp
  325.               points can receive the whole area.
  326.  
  327. SQPRVD  SQPVD???.RAR DOS
  328.  
  329. -----   SQFM110.RAR  OS/2 Allows to change the "from address"
  330.               of PKTs before they are compressed.
  331.               To be used with Squish.
  332.               For example, it is useful to Hub
  333.               coordinators who want to continue
  334.               processing mail with their primary
  335.               address for current links while
  336.               processing with the administrative
  337.               address for their uplink BackBone.
  338.               FreeWare.
  339.  
  340. -----   SQFMW110.RAR NT
  341.  
  342. -----   HBRT110.RAR  OS/2 Useful to coordinators (above HCs)
  343.               that use Squish. Automatically
  344.               updates the Hub definitions in
  345.               ROUTE.CFG taking the data from a V7
  346.               nodelist.
  347.  
  348. -----   HBRTD110.RAR DOS
  349.  
  350. -----   HBRTW110.RAR NT
  351.  
  352. -----   SqSetAll.Rar OS/2 Sets renum limits in all Squish Areas
  353.               taking the parameters from
  354.               Squish.Cfg.
  355.  
  356. -----   SqSetDos.Rar DOS  Dos version.
  357.  
  358. -----   AdjFDate.Rar OS/2 Changes by +-N days the File Date.
  359.               Can choose between Creation and
  360.               Modification dates on HPFS.
  361.               Show and Touch options.
  362.  
  363. -----   AdjF_Dos.Rar DOS  Changes by +-N days the File Date.
  364.  
  365.  
  366. Current versions (Dec 09th 1996): NEF 2.38, FastLst 1.36,
  367. FLM 1.40, NMFWD 2.05, QFB 1.10, SQPrv 1.04.
  368.  
  369.  
  370. ΓòÉΓòÉΓòÉ 1.8. Bug Reports ΓòÉΓòÉΓòÉ
  371.  
  372.  
  373.              Bug Reports
  374.  
  375. If you find out a real bug, I will do my best to fix it and make
  376. the new version available in a few days. To do that, I need your
  377. cooperation: when you find a strange behaviour, double check
  378. your configuration and the manual to be really sure it's not
  379. your fault, then study the conditions in which the bug appears
  380. and, in the end, send me your detailed report about the bug
  381. together with your config file and all the stuff necessary to
  382. replicate the problem. I can fix a bug only if I am enabled to
  383. reproduce it !
  384.  
  385.  
  386. ΓòÉΓòÉΓòÉ 1.9. Wish List ΓòÉΓòÉΓòÉ
  387.  
  388.             Wish List
  389.  
  390.  
  391. To help me provide a better and better program, please let
  392. me know your problems and your wishes about future versions.
  393.  
  394. Please let me know your opinion:
  395.  
  396. Alberto Pasquale 2:332/504@fidonet
  397. alberto.pasquale@interbusiness.it
  398.  
  399. BBS:   +39-59-246112 V120 V34+ VFC V32T H16
  400. BBS/FAX: +39-59-246113 X75 FAX-G3
  401.  
  402. Viale Verdi 106
  403. 41100 Modena
  404. Italy
  405.  
  406.  
  407. ΓòÉΓòÉΓòÉ 2. Whatsnew ΓòÉΓòÉΓòÉ
  408.  
  409.  
  410.                NEF
  411.  
  412.            Changes and Additions
  413.  
  414.  
  415. ΓòÉΓòÉΓòÉ 2.1. 2.38 ΓòÉΓòÉΓòÉ
  416.  
  417.  
  418. 2.38  Public Release, Dec 09 1996
  419.  
  420.    - Fixed bug that may cause SYS3175 during "areafix" (with
  421.     totally empty message body).
  422.  
  423.    - NEF had problems in deleting old FILE_ID.DIZ files with
  424.     Hidden, System or Read-Only attributes when extracting a
  425.     new one; fixed.
  426.  
  427.    - Please note new email address, support/registration sites
  428.     etc.
  429.  
  430.  
  431. ΓòÉΓòÉΓòÉ 2.2. 2.37 ΓòÉΓòÉΓòÉ
  432.  
  433.  
  434. 2.37  Public Release, Aug 13 1996
  435.  
  436.    - Additional <acc> argument for FileBone statement, in
  437.     order to allow the specification of a privilege required
  438.     to have access to the areas listed in the FileBone file.
  439.  
  440.    - New "@<address>" option for the FileArea and NewAreasFrom
  441.     statements, in order to specify a default primary address
  442.     instead of an overriding one (as with "#<address>").
  443.  
  444.     Please see the doc for further details.
  445.  
  446.    - New "GetDizDesc <WTAG> ..." statement to specify the
  447.     areas where NEF must take the description for FILES.BBS
  448.     from the File_Id.Diz contained in the tossed archives.
  449.  
  450.    - Files.Bbs handling routines now take as comments the
  451.     lines that start with high-ascii characters (>127).
  452.     This may be important when updating the filebase.
  453.  
  454.    - The short description for hatch functions can now be
  455.     taken from Files.bbs, File_Id.Diz or a specified file,
  456.     just as with the long description (@BBS, @DIZ, @<file>
  457.     command line parameters).
  458.  
  459.    - New support for multiple "Replaces" files.
  460.     On command line hatch, the names must be separated by '/'.
  461.     On interactive hatch they must be separated by ' '.
  462.     For developers of Feature DLLs: please note that the
  463.     replaces field of the _TICDATA structure may contain
  464.     multiple filenames separated by a space.
  465.  
  466.    - New support for extended <WTAG> specifications: you can
  467.     now use level and keys to enhance the selectivity of all
  468.     the statements that use <WTAG>.
  469.  
  470.     [<WTAG>][:[<level>][/<keys>]]
  471.  
  472.     - If <WTAG> is omitted, '*' is assumed.
  473.     - if ':' is not used, any area matching <WTAG> is
  474.      included.
  475.     - if ":/<keys>" is used, <level> is assumed 65535.
  476.  
  477.  
  478.     Examples:
  479.  
  480.     Announce OS2*       ; All OS2* areas
  481.  
  482.     Announce OS2*:100/fg   ; OS2* areas that can be
  483.                 ; accessed with privilege level
  484.                 ; 100 and keys fg
  485.  
  486.     Announce :100/fg     ; All areas that can be accessed
  487.                 ; with level 100 and keys fg
  488.  
  489.     Announce *:100      ; All areas that can be accessed
  490.                 ; with level 100
  491.  
  492.     Announce :/g       ; All areas that can be accessed
  493.                 ; with key g (and level 65535).
  494.  
  495.  
  496.    - NewAreasFrom now accepts an indication about the
  497.     "direction" of the created areas.
  498.     The default remains 'O'.
  499.  
  500.    - New options for FileArea and NewAreasFrom statements:
  501.     -p<level>[/<keys>] and -P<level>[/<keys>]
  502.  
  503.     The first one protects the Area from access, together
  504.     with ProtArea and FileBone.
  505.  
  506.     The second one is a protection override (the area
  507.     protection does not depend on other statements).
  508.  
  509.     The I|O|*, @|#<adr>, -<flag> flags can now be mixed in any order.
  510.  
  511.    - New "NoOverWrite" statement.
  512.     When an incoming file is already present in the
  513.     destination directory and no explicit replace field is
  514.     used in the inbound TIC, this statement will trigger an
  515.     error and the TIC will be renamed to BAD.
  516.  
  517.    - OS/2: New arrangement for the "FilesBbs",
  518.     "ArcDiz" and "File" push-buttons in the PmHatch dialog.
  519.     If the focus is on "Long Desc", they load the long
  520.     description, otherwise the short description is loaded
  521.     with newlines changed to spaces.
  522.  
  523.    - OS/2: Now there is only one "Browse"
  524.     pushbutton, which affects the "File" or "Repl" field
  525.     depending on which one has the focus.
  526.  
  527.  
  528. ΓòÉΓòÉΓòÉ 2.3. 2.35 ΓòÉΓòÉΓòÉ
  529.  
  530.  
  531. 2.35  Public Release, June 14 1996
  532.  
  533.    - OS/2:
  534.     Hatch: Added support for extracting File_Id.Diz from SFX
  535.     .EXE archives. There is no custom support for any archive
  536.     format: NEF supports all the archivers defined in
  537.     Compress.Cfg with an ID string of at least 2 bytes. This
  538.     method is not very accurate, but it's quite general and
  539.     it usually works.
  540.  
  541.    - New "AnnExclude <filespec> ..." statement, to exclude
  542.     specified files from the announcements.
  543.  
  544.     This statement can be used both in the global
  545.     announcement section and inside each "AreaTag/AreaPath"
  546.     block.
  547.  
  548.    - The "FileBone Availability" message now respects the
  549.     FileLink message flags.
  550.  
  551.    - FileFix commands are now accepted from command line:
  552.     NEF FileFix <adr> <cmd> ...
  553.     where <cmd>s are the same commands that can be used in
  554.     messages addressed to the AutoLink robot.
  555.  
  556.    - Special commands for the filefix robot can now be
  557.     preceded indifferently by '?' or '%'. This is useful when
  558.     using the robot via command line with 4OS2, which
  559.     interprets the strings starting with '%' as environment
  560.     variables. If you still want to use '%', then you might
  561.     need to precede it with an escape character.
  562.  
  563.     E.g. Nef FileFix 2:332/504.2 ?QUERY
  564.       Nef FileFix 2:332/504.2 ^%QUERY
  565.  
  566.    - New FileLink flag 'Y' to specify links to be notified
  567.     when "NEF Notify" is executed with no address list.
  568.  
  569.  
  570. ΓòÉΓòÉΓòÉ 2.4. 2.34 ΓòÉΓòÉΓòÉ
  571.  
  572.  
  573. 2.34  Public Release, May 20 1996
  574.  
  575.    - Extension of the PassThru concept.
  576.  
  577.     If you specify the "-0" flag in a FileArea definition,
  578.     when you do "Nef Clean", the files not currently
  579.     referenced in outbound attaches are deleted.
  580.  
  581.     If you specify "-0<days>", the files in that area will
  582.     not be deleted until they become older than <days> _AND_
  583.     there is no file attach pointing to them.
  584.  
  585.     Example:
  586.  
  587.     FileArea Area1 \file\area1\ O -030 2:345/678 I123/4
  588.  
  589.     Files in \file\area1 will be deleted when older than 30
  590.     days _and_ not referenced by any file attach.
  591.  
  592.    - OS/2: New "KillDate Write|Creation" statement.
  593.     To specify the date to be used for evaluating the file
  594.     age that triggers the file deletion in passthru areas.
  595.  
  596.     This statement is useful for HPFS, ignored on FAT.
  597.  
  598.     If none specified, "Creation" is assumed.
  599.  
  600.     Example:
  601.  
  602.     KillDate Write
  603.  
  604.    - New extended "-0<days>" switch for the "NewAreasFrom"
  605.     statement.
  606.  
  607.    - OS/2: New parameters "Creation" and "Write" for the Touch
  608.     keyword. You can configure the type of "touch" you need.
  609.     Examples:
  610.  
  611.     Touch    ; default: touch the Creation (upload) date
  612.     Touch Creation        ; same as default
  613.     Touch Write         ; touch the Last Write date
  614.     Touch Creation Write     ; touch both dates
  615.  
  616.    - Fixed bug introduced in 2.32 which caused an access
  617.     violation in the "query" type commands if AreaDescWrap
  618.     was not used in the config file.
  619.  
  620.    - Added check to prevent access violation when interactive
  621.     hatch is used with @diz and CompressCfg is NOT defined.
  622.     Now an error is reported.
  623.  
  624.    - Added check to prevent that NEF reports "Empty command"
  625.     when no MaxAreaCompile statement is used.
  626.  
  627.    - Enhanced INF Documentation.
  628.  
  629.  
  630. ΓòÉΓòÉΓòÉ 2.5. 2.33 ΓòÉΓòÉΓòÉ
  631.  
  632.  
  633. 2.33  Public Release, Mar 13 1996
  634.  
  635.    - A bug in the squish.cfg parsing routines has been found:
  636.     if an area is defined with NOTHING after the path, this
  637.     area cannot be opened. The problem usually happens when
  638.     AreaTag specifies a *.MSG netmail with NO flags in
  639.     Squish.Cfg.
  640.  
  641.  
  642. ΓòÉΓòÉΓòÉ 2.6. 2.32 ΓòÉΓòÉΓòÉ
  643.  
  644.  
  645. 2.32  Public Release, Mar 13 1996
  646.  
  647.    - New registration options: BMT Micro, NC, USA and Vince
  648.     Coen, UK.
  649.  
  650.    - If the file description contains high ascii codes
  651.     (>127), the announcements will now contain remapped
  652.     plain-ASCII characters.
  653.  
  654.    - You can allow High Ascii characters in some (or even
  655.     all) areas by the use of the "HighAsciiOk" statement in
  656.     the global or local-override announcement sections.
  657.  
  658.    - New (global) statement: UniqueDmpLine.
  659.     Makes NEF generate FILES.DMP filebase files with
  660.     descriptions on one line only (multiple lines are
  661.     concatenated).
  662.  
  663.     By default, NEF outputs multi-line descriptions without
  664.     changes to FILES.DMP: when using L)ocate and N)ewfiles
  665.     commands, Maximus will respect the original formatting,
  666.     but the continuation lines will be aligned to the left.
  667.  
  668.     When this statement is used, the original formatting of
  669.     descriptions is lost (in the filebase) but Maximus will
  670.     be able to word-wrap and align when executing L)ocate or
  671.     N)ewfiles commands.
  672.  
  673.    - Added check to prevent misconfiguration of the "AreaTag"
  674.     statement: it's ILLEGAL to use "AreaTag MyTag -$".
  675.     You must either use "AreaTag MyTag" (if SquishCfg is
  676.     used) or "AreaTag MyTag c:\bbs\mail\mytag -$".
  677.     In other words: when you let NEF lookup the TAG in
  678.     Squish.cfg, it is smart enough to find out the area type
  679.     on its own !
  680.  
  681.    - When hatching from command line, it is now legal to specify
  682.     @diz without specifying a short description: it will be
  683.     considered empty. I still strongly recommend to always
  684.     specify a "short" description besides the optional "long"
  685.     one.
  686.  
  687.     Example
  688.  
  689.     Nef Hatch c:\file\filename.ext TAG @diz
  690.  
  691.     is now equivalent to:
  692.  
  693.     Nef Hatch c:\file\filename.ext TAG "" @diz
  694.  
  695.    - Changed a typedef in NEFEAT.H, so that it does not
  696.     create problems with IBM compilers (thanks to Michael
  697.     Hohner).
  698.  
  699.    - OS/2: New mnemonic characters for PmHatch PushButtons.
  700.  
  701.  
  702. ΓòÉΓòÉΓòÉ 2.7. 2.31 ΓòÉΓòÉΓòÉ
  703.  
  704.  
  705. 2.31  Private Beta, Mar 3 1996
  706.  
  707.    - Fixed problem with UNC filenames that start with a double
  708.     backslash (on LANs).
  709.  
  710.  
  711. ΓòÉΓòÉΓòÉ 2.8. 2.30 ΓòÉΓòÉΓòÉ
  712.  
  713.  
  714. 2.30  Public Release, Feb 19 1996
  715.  
  716.    - Check added to prevent NEF from issuing a forward request
  717.     to multiple uplinks for the same area, when a TAG is
  718.     contained in more than one Filebone file.
  719.  
  720.    - New cfg statement: "ForwardWildReq".
  721.     Starting with ver 2.30, by default, TicFix requests with
  722.     wildcards are NOT forwarded to the filebones; this verb
  723.     enables even this type of request forward.
  724.  
  725.    - Additional check in PmHatch: if no "short" description is
  726.     specified, the user is prompted about whether he really
  727.     means to hatch with no (short) description.
  728.  
  729.    - Updated Docs.
  730.  
  731.  
  732. ΓòÉΓòÉΓòÉ 2.9. 2.26 ΓòÉΓòÉΓòÉ
  733.  
  734.  
  735. 2.26  Public Beta, Jan 22 1996
  736.  
  737.  
  738.    - COMPATIBILITY WARNING:
  739.  
  740.     New override priority sequence for "from AKA".
  741.  
  742.     The highest priority is that of the "Area AKA": if you
  743.     have defined an area aka (#<address> in FileArea
  744.     definition), it will always be the "from address" for
  745.     TICs from this area.
  746.  
  747.     Then there is the aka override of "FileLink" definitions.
  748.     If a node has a "from aka" specified in it's FileLink
  749.     definition, it will be used for all TICs addressed to
  750.     this node, unless there is an overriding "Area AKA".
  751.  
  752.     If no override is applicable from FileArea and FileLink
  753.     definitions, then an aka match is attempted: if the
  754.     "to-address" has a zone that matches an address defined
  755.     in NEF.CFG, then the first match is used.
  756.  
  757.     If none of the previous cases applies, the primary
  758.     address is used (the first address defined in nef.cfg).
  759.  
  760.  
  761.    - New command line options for hatch commands.
  762.  
  763.     "@bbs" can be used in the place of the normal
  764.     description: NEF will take (if existent) from the
  765.     files.bbs.
  766.  
  767.     "@diz" can be used as a further optional parameter (after
  768.     the "short" description) to make NEF take the "long"
  769.     description from the file_id.diz contained in the
  770.     archive.
  771.  
  772.     Examples:
  773.  
  774.     nef hatch d:\apbbs\nef999.rar APBBS "Nef 9.99"
  775.     nef hatch d:\apbbs\nef999.rar APBBS @bbs
  776.     nef hatch d:\apbbs\nef999.rar APBBS "Nef 9.99" @diz
  777.     nef hatch d:\apbbs\nef999.rar APBBS @bbs @diz
  778.  
  779.  
  780.    - New "Single Hatch" option.
  781.     If you Hatch/Catch/Match/Send a file with the -d<adr>
  782.     command line switch, it is sent to <adr> only.
  783.  
  784.     <adr> can be any 4D address: in the case it is defined as
  785.     a link in the matching "FileArea" or even only as a
  786.     "FileLink", the specified akas, password and switches are
  787.     applied.
  788.  
  789.     If, on the contrary, <adr> is a unknown address,
  790.     the Hold flavour is used, no password is put in
  791.     the TIC and the "from" aka is derived from an aka-match
  792.     on the zone.
  793.  
  794.     Example: Nef -d2:332/504.2 hatch
  795.  
  796.  
  797.    - Now NEF is able to add new (created) areas to the Maximus
  798.     filearea.ctl or equivalent.
  799.     There are two new configuration statements:
  800.  
  801.     MaxAreaAdd <fileareactl> <lev[/keys]> <acs> [<division>]
  802.     MaxAreaCompile <command>
  803.  
  804.     <fileareactl> is the fully qualified name of the Maximus
  805.     file-area definition file.
  806.  
  807.     <lev[/keys]> protects areas of higher privilege from
  808.     being automatically added to the Maximus configuration.
  809.     The level and keys are to be compared to those of
  810.     ProtArea statements and FileBone files.
  811.  
  812.     <acs> is the Maximus access string to be used in
  813.     <fileareactl> for the new area.
  814.  
  815.     <division> is the optional specification of a division
  816.     where you want to put new areas. If not specified or not
  817.     found, the new areas will be appended at the end of
  818.     <fileareactl>.
  819.  
  820.     <command> is an external command to be executed before
  821.     NEF ends, from the Maximus system directory.
  822.     It should be used to compile the new Maximus
  823.     configuration via SILT/SILTP.
  824.  
  825.     The area name is taken equal to the area TAG, with dots
  826.     changed to underscores.
  827.  
  828.     The area description is taken from the FileBone files if
  829.     available, otherwise it is taken equal to the area TAG.
  830.  
  831.     Example:
  832.  
  833.     MaxAreaAdd d:\max\filearea.ctl 0 Transient Tic.New
  834.     MaxAreaCompile siltp max -a -2a
  835.  
  836.     The new areas, will be inserted at the end of division
  837.     "Tic.New" in the file "d:\max\filearea.ctl", with an
  838.     access string of "Transient". Areas with protection level
  839.     above 0 or any protection key will NOT be added to
  840.     maximus configuration.
  841.  
  842.     Before terminating, NEF will invoke the SILTP compiler to
  843.     update the area configuration. The command will be
  844.     executed after changing the current directory to the
  845.     Maximus system one (probably d:\max\).
  846.  
  847.  
  848.    - The filebone-style files now accept the specification of
  849.     keys after level.
  850.  
  851.     Example:
  852.  
  853.     Area NODEDIFF 0/f ! FidoNet: Weekly NodeList Updates
  854.  
  855.  
  856.    - The default message size is of 12KB.
  857.     The new cfg statement "MsgSize <bytes>" allows to specify
  858.     a different size (minimum 8KB).
  859.  
  860.     Usually a larger message size is useful to avoid too many
  861.     messages in reports of filebone availability. Anyway,
  862.     please be careful not to use a size larger than your
  863.     downlinks can handle.
  864.  
  865.     Example:
  866.  
  867.     MsgSize 90000
  868.  
  869.  
  870.    - Fast Netmail Scan in Squish area.
  871.     The pointer to the last scanned message is stored
  872.     in <netarea>.NEF.
  873.  
  874.  
  875.    - New cfg statement "NoRaidBeforeHatch" to avoid the
  876.     scanning of netmail before the execution of hatch
  877.     commands. This could be useful to avoid delays with huge
  878.     *.MSG netmail areas.
  879.  
  880.  
  881.    - The tear line now reports the OS version (OS/2 or DOS)
  882.     and a '+' after the version number in the case of a
  883.     registered copy ("Evaluation" for unregistered copies, as
  884.     before).
  885.  
  886.  
  887.    - Errorlevels for Lock and Close error on message areas
  888.     have been dropped: if a Lock error happens, NEF will exit
  889.     with the Open area errorlevel; in the case of a Close
  890.     error, NEF will continue after issuing an error message.
  891.  
  892.  
  893.    - TICs received with no password in "NoSecure" mode are
  894.     accepted anyway.
  895.  
  896.  
  897.    - Area aka overrides are reported by the nef filefix robot
  898.     when answering to query type commands.
  899.  
  900.  
  901.   OS/2 Only:
  902.  
  903.    - Added support for Feature DLLs:
  904.  
  905.     Two new configuration statements are supported:
  906.  
  907.     FeatureLoad <DllName>
  908.     Feature <cfgline>
  909.  
  910.     "FeatureLoad" allows to load a "Feature" DLL.
  911.     <DllName> can be a simple filename without extension
  912.     (".DLL" implied) if the DLL is in the LibPath, otherwise
  913.     a fully qualified filename can be specified.
  914.  
  915.     "Feature" allows to specify configuration statements that
  916.     are to be parsed by the DLL.
  917.  
  918.     Multiple FeatureLoad statements are allowed, in which
  919.     case the Feature statements refer to the last loaded DLL.
  920.  
  921.     An Example DLL, named "Feature.Dll" is provided, with
  922.     source.
  923.  
  924.     Example (works with the example DLL):
  925.  
  926.     FeatureLoad Feature
  927.     Feature OutPrefix "New File Received: "
  928.  
  929.  
  930. ΓòÉΓòÉΓòÉ 2.10. 2.21 ΓòÉΓòÉΓòÉ
  931.  
  932.  
  933. 2.21  Public Beta, Jan 1 1996
  934.  
  935.    - This should be the last beta before a new "final" release.
  936.  
  937.    - COMPATIBILITY WARNING:
  938.  
  939.     The old "AreaList" configuration statement has been dropped.
  940.     In some cases you could use the new "HelpFile" statement
  941.     to point to the file you used with "AreaList".
  942.  
  943.    - New "HelpFile <file>" configuration statement.
  944.     The specified <file> will be sent (via netmail) by the
  945.     FileFix robot when help is requested.
  946.  
  947.    - New switches can be used on the subject of messages
  948.     addressed to the FileFix robot:
  949.  
  950.     -h  to ask for help.
  951.     -q  remains "query": list of all areas.
  952.     -l  now means "linked": list of linked areas only.
  953.     -u  to get a list of unlinked areas only.
  954.  
  955.     Only the first letter is checked, so you could use
  956.     "-query" instead of the simple abbreviation "-q".
  957.  
  958.    - New commands are now available in the body of the
  959.     messages addressed to the FileFix robot.
  960.     Besides add/delete commands for areas, you can use:
  961.  
  962.     %Help     same as -h
  963.     %Query    same as -q
  964.     %List     same as -q
  965.     %Linked    same as -l
  966.     %Unlinked   same as -u
  967.  
  968.    - New "FileBone" support.
  969.  
  970.     NEF is now able to use information distributed via the
  971.     FileBone.Na and FileBone.No files.
  972.  
  973.     Many useful functions are allowed by the use of these
  974.     files, so, even if you do not receive them from your
  975.     uplink, you could evaluate the possibility of creating
  976.     "filebone" style files on your own, just to store some
  977.     information that can be retrieved by NEF.
  978.  
  979.  
  980.    - The format for the filebone style is:
  981.  
  982.     Area <Tag> <lev> <flags> <desc>
  983.  
  984.     <Tag> is the TIC area Tag. The original filebone format
  985.        allows 8 character maximum but NEF is not that
  986.        limited.
  987.  
  988.     <lev> is the protection level of the area, for "filefix"
  989.        (raid) functions.
  990.        The original format allows the range 0-4095 while
  991.        NEF allows 0-65535.
  992.  
  993.     <flags> is a combinaton of !.*& and possibly other
  994.         characters.
  995.  
  996.        ! : Can be found at any Filebone Hub.
  997.        . : Only on some Filebone Hubs.
  998.        * : Any node can hatch into.
  999.        & : Do not send to downlinks.
  1000.  
  1001.     Others : Private distribution.
  1002.  
  1003.     Examples:
  1004.  
  1005.        ! : normal area from the uplink to its downlinks,
  1006.          available on all Filebone Hubs.
  1007.  
  1008.       !*& : return channel from the downlinks to their
  1009.          uplink, available on all Filebone Hubs.
  1010.  
  1011.       .* : bidirectional area (any node can hatch into),
  1012.          available on some Filebone hubs only.
  1013.  
  1014.  
  1015.     <desc> is the description for the area.
  1016.  
  1017.  
  1018.     Example:
  1019.  
  1020.     Area APBBS   0 P ApWorks OS/2 BBS programs
  1021.     Area NODEDIFF 0 ! FidoNet: Weekly NodeList Updates
  1022.  
  1023.    - New configuration verb:
  1024.  
  1025.     FileBone <file> [<fm> <to> <toadr> <acc> [<pre>]]
  1026.  
  1027.     Multiple FileBone statements are possible.
  1028.  
  1029.     <file> is the filename of the filebone-style file.
  1030.  
  1031.     If you want to enable the forward of requests for new
  1032.     areas from your downlinks to your uplink(s), you must
  1033.     specify the following fields (to be enclosed between
  1034.     quotes when containing space) so that they can be used to
  1035.     write netmail messages to your uplink's Raid:
  1036.  
  1037.     <fm> is the "from" name.
  1038.  
  1039.     <to> is the "to" name.
  1040.  
  1041.     <toadr> is the "to" 4D address.
  1042.  
  1043.     <acc> is a <level>[/keys] specification, to limit the
  1044.        access of downlinks to request forwards addressed
  1045.        to <toadr> for the areas described in <file>.
  1046.  
  1047.     <pre> is an optional string to be prefixed to the area
  1048.        Tags that are being requested.
  1049.  
  1050.     Examples:
  1051.  
  1052.     FileBone \bbs\FileBone.Na "Alberto Pasquale" SysOp 2:332/1 0
  1053.  
  1054.     The "\bbs\FileBone.Na" file is used by NEF, also for
  1055.     request forwards.
  1056.  
  1057.     When a downlink requests an area that is not currently
  1058.     defined in the NEF configuration (usually TicArea.Cfg)
  1059.     but is described in FileBone.Na, a netmail message is
  1060.     written by NEF from "Alberto Pasquale" to "SysOp" of
  1061.     2:332/1 using the appropriate "from address" aka and
  1062.     "subject" (password) as per the "FileLink" definition of
  1063.     2:332/1. The body contains a list of the requested area
  1064.     Tags, one per line.
  1065.  
  1066.     No (<acc> = "0") protection is specified (any downlink
  1067.     has access to request forwards).
  1068.  
  1069.  
  1070.     FileBone \bbs\FB.SP "Alberto Pasquale" SysOp 2:332/1 30/a +
  1071.  
  1072.     Only downlinks with level equal or above 30 and with the
  1073.     'A' key have access to request forwards. The requested
  1074.     tags will be preceded by "+".
  1075.  
  1076.     If you need a space between the '+' and the tag, then you
  1077.     must specify a <pre> that contains a space, so you have
  1078.     to enclose it in quotes:
  1079.  
  1080.     FileBone \bbs\FB.SP "Alberto Pasquale" SysOp 2:332/1 0 "+ "
  1081.  
  1082.    - The forwarded requests are stored in a file named after
  1083.     the configuration one, changing the extension to ".Fwd".
  1084.     Usually the configuration file is "Nef.Cfg", so the
  1085.     forwarded requests will be stored in "Nef.Fwd".
  1086.  
  1087.     The format is: <Tag> <Addr>, i.e. every line contains a
  1088.     Tag followed by the 4D Address of the downlink that made
  1089.     the request.
  1090.  
  1091.     When a new area is created, NEF looks into this file in
  1092.     order to find nodes to be added to the new "FileArea"
  1093.     definition.
  1094.  
  1095.    - A node is entitled to add an area only if it has level
  1096.     and keys that match the requirements from BOTH the
  1097.     "ProtArea" statements in Nef.Cfg and the <lev>
  1098.     specification in a FileBone file (if available).
  1099.  
  1100.    - The various area-listing commands will list the
  1101.     descriptions contained in the FileBone files.
  1102.  
  1103.    - When the FileFix robot is requested a list of areas that
  1104.     are not linked, it will list also those available to the
  1105.     requesting node from the filebone.
  1106.  
  1107.    - New cfg statement:
  1108.  
  1109.     AreaDescWrap <indent> <right>
  1110.  
  1111.     suggested:
  1112.  
  1113.     AreaDescWrap 25 79
  1114.  
  1115.     The descriptions returned by the filefix functions will
  1116.     be word-wrapped so that continuation lines start with
  1117.     <indent> spaces and do not exceed column <right>.
  1118.  
  1119.    - New extended syntax for the Netmail statement:
  1120.  
  1121.     NetMail <path> [-$] [-p<adr>]
  1122.  
  1123.     The new -p<adr> switch allows to specify a primary
  1124.     address for the netmail area. NEF will use this address
  1125.     to write the messages to the FileBone's FileFix to the
  1126.     correct netmail area.
  1127.  
  1128.     If you have multiple netmails, please add the primary
  1129.     address specification in all but the "default" netmail
  1130.     areas.
  1131.  
  1132.    - New command line command:
  1133.  
  1134.     NEF NOTIFY [ALL | <adr> ...]
  1135.  
  1136.     The Notify command sends a list of linked areas to the
  1137.     specified links.
  1138.  
  1139.     Examples:
  1140.  
  1141.     NEF Notify
  1142.     NEF Notify All
  1143.  
  1144.     Sends notification to all links.
  1145.  
  1146.     NEF Notify 2:332/504 81:449/9108
  1147.  
  1148.     Sends notifications to the 2 specified addresses.
  1149.  
  1150.  
  1151. ΓòÉΓòÉΓòÉ 2.11. 2.20 ΓòÉΓòÉΓòÉ
  1152.  
  1153.  
  1154. 2.20  Public Beta, Dec 03 1995
  1155.  
  1156.    - New type of hatch with copy:
  1157.  
  1158.     If you use "NEF CATCH", the specified file is copied to
  1159.     the destination area and hatched.
  1160.  
  1161.    - Multi-Line files.bbs descriptions are now supported.
  1162.     To enable this feature the way you like, please use the
  1163.     "MultiLineDesc <nnn> [<c>]" statement, specifying the
  1164.     continuation column and character.
  1165.  
  1166.     For example, to have the 2nd and following description
  1167.     lines in files.bbs start at column 31, use:
  1168.  
  1169.     MultiLineDesc 31
  1170.  
  1171.     To have the continuation lines preceded by a '|'
  1172.     character, use:
  1173.  
  1174.     MultiLineDesc 29 |
  1175.  
  1176.    - Modified routines for PassThru clean-up.
  1177.  
  1178.     Previously passthru areas HAD to be defined using a
  1179.     separate path for each area. Now NEF works correctly even
  1180.     if you define many areas with the same path.
  1181.  
  1182.     Anyway this is not a recommended practice, since slightly
  1183.     different files with the same name could arrive from
  1184.     different areas causing a CRC mismatch.
  1185.  
  1186.   OS/2 Only:
  1187.  
  1188.    - New Pm Hatch.
  1189.     To invoke the PM hatch program you must type "NEF send".
  1190.     The PmHatch program is very simple and intuitive to use:
  1191.     see the following description.
  1192.  
  1193.     You can select the destination Area Tag via a drop-down
  1194.     list: just click with the mouse on the button at the
  1195.     right of the entry field.
  1196.  
  1197.     You have three radio buttons to select the "type" of
  1198.     hatch (normal, with Copy, with Move), just as you use
  1199.     Hatch/Catch/Match from the command line.
  1200.  
  1201.     You can choose the file to be hatched via a file dialog
  1202.     box: just click on the "Browse" push button on the right
  1203.     of the field.
  1204.  
  1205.     You can also specify a "Replace" file via a file-dialog
  1206.     by clicking on the "Browse" push-button on the right of
  1207.     the "Repl" field.
  1208.  
  1209.     When doing Copy or Move, the files.bbs of the destination
  1210.     area is updated and the "replace" file (if specified) is
  1211.     deleted, just as if the file were tossed from the
  1212.     inbound.
  1213.  
  1214.     You can mark the "No Local Kill" checkbox to prevent NEF
  1215.     from deleting the "replace" file in the local area.
  1216.  
  1217.     You can load a "short description" (Desc) from the
  1218.     files.bbs, by clicking on the "FilesBbs" push-button.
  1219.  
  1220.     You can load a multi-line "long description" (Long Desc)
  1221.     from the File_Id.Diz inside the archive, from the
  1222.     Files.Bbs or from a specified file (Arc Diz, FilesBbs,
  1223.     File push-buttons respectively).
  1224.  
  1225.     If you do not have the "CompressCfg <filename>" statement
  1226.     in Nef.Cfg, the "Arc Diz" push-button will be disabled.
  1227.  
  1228.     Of course you can always fill-in or modify any field
  1229.     manually.
  1230.  
  1231.     Now look at the five push-buttons at the bottom of the
  1232.     hatch dialog:
  1233.  
  1234.     <OK>: to exit the dialog and hatch all the entered files.
  1235.  
  1236.     <Prev>: to visualize the previous hatch entry.
  1237.  
  1238.     <Next>: to create a new (empty) entry in order to hatch
  1239.         another file.
  1240.  
  1241.     <Copy>: to copy the visualized entry to the first free
  1242.         position, in order to hatch another file by
  1243.         modifying the current entry.
  1244.  
  1245.     <Cancel> or ESC: to cancel the current entry.
  1246.  
  1247.     ALT-F4 or "Close", to abort (cancell all the hatch
  1248.        entries).
  1249.  
  1250.    - Please note that the PmHatch.Exe file must be in the path
  1251.     when you invoke "Nef Send". In the case the PmHatch
  1252.     program terminates abnormally, the NEF program will
  1253.     wait for it indefinitely: you can stop it using CTRL-C or
  1254.     CTRL-Break.
  1255.  
  1256.    - To allow the extraction of File_Id.Diz while using the Pm
  1257.     Hatch, use the "CompressCfg <filename>" statement to
  1258.     specify the location and name of a "Squish style"
  1259.     compress.cfg:
  1260.  
  1261.     CompressCfg c:\squish\compress.cfg
  1262.  
  1263.  
  1264. ΓòÉΓòÉΓòÉ 2.12. 2.19 ΓòÉΓòÉΓòÉ
  1265.  
  1266.  
  1267. 2.19  Public Beta, Oct 04 1995
  1268.  
  1269.    - Please note:
  1270.  
  1271.     APWORKS has changed phone number:
  1272.  
  1273.     2:332/504@fidonet +39-59-246112 ISDNC/V34/VFC/V32T/H16
  1274.     2:332/524@fidonet +39-59-246113 ISDNC/V34/VFC/V32T/H16/FAX
  1275.  
  1276.     A new registration site is available:
  1277.  
  1278.     Jens Holm of 2:238/888@fidonet
  1279.     Skanderupgade 9, D2
  1280.     8660 Skanderborg
  1281.     Denmark
  1282.  
  1283.     Price: 125.- DKR.
  1284.  
  1285.     Can be paid cash, check or postal order.
  1286.  
  1287.    - ATTENTION: this version is for use with Maximus 3.00;
  1288.     support for Maximus 2.0x has been dropped. If you still
  1289.     use Max 2.0x you have to disable filebase support or
  1290.     continue using version 2.18.
  1291.     If you do not use Maximus, you can obviously use whatever
  1292.     version of NEF you like.
  1293.  
  1294.    - New mutual exclusive semaphore flag "FileBase.Bsy" used
  1295.     to avoid concurrent access and modification of the
  1296.     filebase by other ApWorks programs.
  1297.     There is no need to delete this flag if it is not deleted
  1298.     after a power failure or abnormal termination (ApWorks
  1299.     programs are smart enough to realize whether the flag is
  1300.     really in use or not).
  1301.  
  1302.    - New errorlevel 17 for FileBase Busy Timeout.
  1303.  
  1304.    - Support for the "MAXIMUS" environment variable: the
  1305.     "MaxPrm" cfg statement is now only an override.
  1306.     Please note that if the "MAXIMUS" variable is not
  1307.     defined, you must use the "MaxPrm" statement BEFORE
  1308.     "FileBaseUpdate".
  1309.  
  1310.    - When the files are touched in HPFS, the creation date is
  1311.     modified, not the modification one, in order to make the
  1312.     files recognized as new by Maximus and FLM without
  1313.     changing the date that is normally shown and transferred:
  1314.     you "see" and transfer to your downlinks the original
  1315.     date of the file while Maximus and FLM are able to
  1316.     realize that the file is new.
  1317.  
  1318.    - WildTags are now interpreted following the "OS/2 style"
  1319.     for file wildcards: "*LOC*" specifies all tags that
  1320.     contain "LOC"; "FW???" specifies all tags that have up
  1321.     to three characters after "FW", etc.
  1322.  
  1323.  
  1324. ΓòÉΓòÉΓòÉ 2.13. 2.18 ΓòÉΓòÉΓòÉ
  1325.  
  1326.  
  1327. 2.18  Public Beta, Aug 28 1995
  1328.  
  1329.    - KeepSeenBy statement dropped: SeenBys are now already
  1330.     kept.
  1331.  
  1332.    - SeenBys are now always fully processed as they should.
  1333.  
  1334.    - Points are not included in the SeenBys of TICs addressed
  1335.     to other links, to avoid unnecessarily huge lists of
  1336.     SeenBys.
  1337.  
  1338.    - Fixed bug of Dos 2.17 version that prevented NEF from
  1339.     moving files between different logical drives.
  1340.  
  1341.    - Description is now formatted between columns 4 and 79, to
  1342.     make descriptions with empty lines look better.
  1343.  
  1344.    - The outbound functions (Out, OutView, Clean) can now
  1345.     handle 2000 files instead of 1000 (?UT, ?LO).
  1346.  
  1347.    - PassThru areas implemented: new "-0" option in "FileArea"
  1348.     statement.
  1349.  
  1350.     FileArea <TAG> <path> I|O|* [#<adr>] [-0] [[<flags>[link]...]
  1351.  
  1352.     When the "-0" is specified, the area is "PassThru", that
  1353.     is its files will be deleted when already sent to all the
  1354.     downlinks.
  1355.  
  1356.     Please note that ANY file (apart from FILES.*) present in
  1357.     <path> and not attached to any system will be deleted.
  1358.  
  1359.    - Since it might be not efficient to always scan the entire
  1360.     outbound to check for passthru files to be deleted, NEF
  1361.     must be instructed to do so.
  1362.     There are two ways to make NEF delete old passthru files:
  1363.     - Use -p command line switch.
  1364.     - Use CLEAN command line command.
  1365.  
  1366.     Examples:
  1367.  
  1368.  
  1369.     NEF -p
  1370.  
  1371.      Makes NEF operate as usual, but it will clean the
  1372.      PassThru areas before terminating.
  1373.  
  1374.  
  1375.     NEF -p OUT
  1376.  
  1377.     Makes NEF clean the PassThru areas and report the status
  1378.     of Outbound. This is the most efficient use, since NEF
  1379.     must scan the outbound once to make two different things
  1380.     ("clean passthru" and "outbound report").
  1381.  
  1382.  
  1383.     NEF CLEAN
  1384.  
  1385.     Makes NEF clean the PassThru.
  1386.  
  1387.  
  1388.    - The OUT and OUTVIEW commands are now equivalent for
  1389.     message output. When using file output ("NEF OUT Out.Txt"
  1390.     or "NEF OUTVIEW Out.Txt") OUT generates a concise
  1391.     Outbound analysis (no specification of each and every
  1392.     attached file), while OUTVIEW generates a full report.
  1393.  
  1394.    - The <OUT> special tag in "Announce" statements now makes
  1395.     NEF write a concise outbound report.
  1396.  
  1397.    - The new <OUTVIEW> special tag provides for a detailed
  1398.     outbound analysis.
  1399.  
  1400.    - New special tag <THRU> represents all passthru areas.
  1401.     If you want to keep NEF from announcing files received
  1402.     in PassThru areas, just use "NoAnnounce <THRU>".
  1403.  
  1404.    - New extensions in "NewAreasFrom" statement:
  1405.  
  1406.     NewAreasFrom <adr> [#<aka>] [-0] [<path>]
  1407.  
  1408.     The "-0" switch allows to create PassThru areas when a
  1409.     unknown TAG is encountered.
  1410.  
  1411.     The <path> is an override for the global "NewAreasPath"
  1412.     statement.
  1413.  
  1414.  
  1415. ΓòÉΓòÉΓòÉ 2.14. 2.17 ΓòÉΓòÉΓòÉ
  1416.  
  1417.  
  1418. 2.17  Public Beta, Aug 10 1995
  1419.  
  1420.    - 16 bit versions dropped.
  1421.  
  1422.    - (OS/2) EAs are now copied together with the file, when it
  1423.     must be moved from inbound to the destination area.
  1424.  
  1425.    - Fixed bug that caused newly created areas to be added
  1426.     multiple times to ticarea.cfg if 2 or more areas were
  1427.     created at the same time.
  1428.  
  1429.    - When "MATCHing" a file that is already in its destination
  1430.     directory, it was deleted. Fixed.
  1431.  
  1432.    - Multiple "Desc" keywords in the inbound TICs are now
  1433.     recognized properly. Previously only multiple "LDesc"
  1434.     keywords were allowed; "Desc" had to be unique.
  1435.  
  1436.    - The description for FILES.BBS is now always taken from
  1437.     the "Desc" keyword(s) in the inbound TICs. Previously the
  1438.     "LDesc" description was used if longer. Reason: many
  1439.     "LDesc" descriptions contain boxes and look ugly when
  1440.     reformatted. The Files.BBS description does not allow to
  1441.     keep formatting (must be on a single line, the BBS
  1442.     program will reformat according to its configuration).
  1443.  
  1444.    - The description for announcement messages is the longest
  1445.     one between "Desc" and "LDesc". Its formatting is now
  1446.     preserved.
  1447.  
  1448.    - Now the '*' wildcard used alone does not include special
  1449.     tags (beginning by '<'). People using "Announce *" will
  1450.     not be disappointed any further by the announcing of
  1451.     <BAD> in the same area.
  1452.  
  1453.    - The Path statement in outgoing TICs contained the ASCII
  1454.     local (instead of GMT) time specification followed by
  1455.     "GMT". Now this has been fixed and the "GMT" changed to
  1456.     "UTC". Please note that you must have the environment
  1457.     variable "TZ" correctly set in config.sys (OS/2) or
  1458.     autoexec.bat (DOS) to have a correct specification of
  1459.     UTC.
  1460.  
  1461.     E.g. for Central European Time (CET)
  1462.     SET TZ=CET-01  (winter, normal time)
  1463.     SET TZ=CET-02  (summer, daylight saving time)
  1464.  
  1465.     E.g. for USA East Coast:
  1466.     SET TZ=EST5EDT
  1467.     Eastern time is 5h less than UTC and Daylight saving
  1468.     applies with the "standard rule" from the first sunday of
  1469.     April to the last sunday of October.
  1470.  
  1471.     More complicate expressions could be used to specify
  1472.     automatic change to and back from daylight saving, if a
  1473.     fix rule is available.
  1474.  
  1475.     E.g. for Italy: daylight is 1h ahead from last sunday of
  1476.     March to last sunday of September.
  1477.  
  1478.     SET TZ=CET-01CDT,M3.5.0,M9.5.0
  1479.  
  1480.     (See a C manual for more details).
  1481.  
  1482.  
  1483.    - New "NoSecure" (global) cfg statement to disable the
  1484.     Secure mode. When "NoSecure" is used, NEF will toss
  1485.     incoming files ignoring errors due to password mismatch
  1486.     and missing from-authorization (sender not linked, sender
  1487.     receive only). Anyway the error will be noted in the logs
  1488.     and <BAD> message report.
  1489.  
  1490.    - New "-t" command line switch to toggle "Secure" mode.
  1491.  
  1492.    - New (global) cfg statement "SquishCfg <filename>". It is
  1493.     used to find the path of a message area from its TAG.
  1494.     Required to use the new "AreaTag" statement in "short"
  1495.     form.
  1496.  
  1497.    - New "AreaTag <Tag> [<path> [-$]]" statement, to be used
  1498.     in the place of "AreaPath <path> [-$]". You can now
  1499.     specify an announcement area by using its TAG, as
  1500.     specified in Squish.Cfg.
  1501.  
  1502.     e.g.
  1503.     AreaTag LOCAL_ANNOUNCES
  1504.  
  1505.     The "long form", with both <Tag> and <path>
  1506.     specifications is useful in the case you do not use
  1507.     Squish and still want to tell NEF the TAG for an echo
  1508.     area, so that it can log it to EchoTossLog.
  1509.  
  1510.    - New "EchoTossLog <filename>" (global) cfg statement. NEF
  1511.     will log to the specified file the tags of the echoareas
  1512.     where it has written announcements. If you use the
  1513.     "MaxPrm" statement, you can omit "EchoTossLog", since NEF
  1514.     will take the default from the MaxPrm.
  1515.  
  1516.    - New "MaxPrm <filename>" (global) cfg statement. It is
  1517.     used to take the default for EchoTossLog and to get the
  1518.     name and location of the files necessary for filebase
  1519.     updating. This is required when using "FileBaseUpdate".
  1520.  
  1521.    - New "FileBaseUpdate" (global) cfg statement.
  1522.     Requires "MaxPrm".
  1523.     NEF will automatically update the filebase for all the
  1524.     areas changed when tossing/hatching new files. No more
  1525.     need for external FB.
  1526.  
  1527.    - New "NoReplace <WTAG> ..." (global) cfg statement.
  1528.     Multiple statements can be used. The specified <WTAG>s
  1529.     indicate in which areas you do not want NEF to delete
  1530.     files specified by the "Replaces" keyword in inbound
  1531.     TICs.
  1532.  
  1533.     E.g.: to avoid Replace in all areas:
  1534.  
  1535.     NoReplace *
  1536.  
  1537.  
  1538. ΓòÉΓòÉΓòÉ 2.15. 2.16 ΓòÉΓòÉΓòÉ
  1539.  
  1540.  
  1541. 2.16  Restricted Beta
  1542.  
  1543.    - The special tags (e.g. <BAD>, <DEF>) can now be
  1544.     excluded from announcement via the "NoAnnounce"
  1545.     statement, just like all the normal tags.
  1546.     This is useful for people who like announcing all
  1547.     the areas together ("Announce *") and that were
  1548.     annoyed by the inclusion of the special tags
  1549.     also.
  1550.  
  1551.  
  1552. ΓòÉΓòÉΓòÉ 2.16. 2.15 ΓòÉΓòÉΓòÉ
  1553.  
  1554.  
  1555. 2.15  Public Beta, Nov 11 1994
  1556.  
  1557.    - Be aware that all DOCS refer to version 2.00:
  1558.     updated documentation will be included in next
  1559.     version. For now, please read this file to know
  1560.     new features and changes.
  1561.  
  1562.    - The former support BBS (Videl, 2:332/504 511 524)
  1563.     will close in a few days. A new support BBS
  1564.     (ApWorks) is available with the same old address
  1565.     2:332/504; V34/VFC +39-59-243882.
  1566.     New Magics available for NEF beta: NEFBETA (OS/2)
  1567.     and NEFDBETA (Dos).
  1568.  
  1569.    - OS/2 versions are now compressed with InfoZip.
  1570.  
  1571.    - Fixed a problem that occurred when "short
  1572.     descriptions" (in "Desc" lines) were longer than
  1573.     255 characters. Nef considered the remaining of
  1574.     the description as an "unknown" line and put it
  1575.     in the outbound TICs. Now the remainder of a too
  1576.     long inbound-TIC line is discarded.
  1577.  
  1578.    - The "short description" limit has been raised to
  1579.     2KB (the same as for the "long description").
  1580.  
  1581.    - When both the "short" (Desc) and "long" (LDESC)
  1582.     descriptions are available, NEF uses the longer
  1583.     one for announcements and FILES.BBS. Up to
  1584.     v.2.14, NEF always used the "long" description
  1585.     if available.
  1586.  
  1587.  
  1588. ΓòÉΓòÉΓòÉ 2.17. 2.14 ΓòÉΓòÉΓòÉ
  1589.  
  1590.  
  1591. 2.14  Public Beta
  1592.  
  1593.    - Support for Long Tags
  1594.     Now the area TAGs are not limited to 8 chars and
  1595.     can contain any character.
  1596.     Anyway you should be careful because other
  1597.     TIC processing programs could not be capable of
  1598.     handling such long tags.
  1599.     For sake of completeness, they can even contain
  1600.     blank spaces: where they could be misinterpreted
  1601.     as field separating characters, you must include
  1602.     the whole Tag in quotes: "Long Tag".
  1603.     See the DOC for more details.
  1604.  
  1605.    - Hatch/Match (batch mode):
  1606.     the character for separating the name and the
  1607.     replace fields has been changed from ',' to '/'.
  1608.  
  1609.    - The "BefDesc" statement has been substituted by
  1610.     the "DescStart" one.
  1611.     Here is a comparison of old and new syntax:
  1612.     BefDesc <WTAG> [<WTAG> ...] "<string>"
  1613.     DescStart "<string>" <WTAG> [<WTAG> ...]
  1614.  
  1615.    - Now there are 4 different EXEs.
  1616.     NEF.EXE:   32 bit OS/2
  1617.     NEF16.EXE:  16 bit OS/2
  1618.     NEFD.EXE:  32 bit DOS, requires DOS4GW.EXE
  1619.     NEFD16.EXE: 16 bit DOS
  1620.  
  1621.    - The "areafix" robot ignored messages marked as
  1622.     sent. Now they are processed, to avoid problems
  1623.     with netmail packers that mark all messages as
  1624.     sent, even if they are sent nowhere, being
  1625.     already arrived at destination.
  1626.  
  1627.    - New command line switch to override the
  1628.     "StatusLog" filename: "-l<logname>".
  1629.  
  1630.    - The maximum length of messages created by robots
  1631.     before splitting has been elevated to 12KB.
  1632.  
  1633.  
  1634. ΓòÉΓòÉΓòÉ 2.18. 2.12 ΓòÉΓòÉΓòÉ
  1635.  
  1636.  
  1637. 2.12  Beta
  1638.  
  1639.    - Fixed bug that caused access violations when
  1640.     doing "NEF Out".
  1641.  
  1642.  
  1643. ΓòÉΓòÉΓòÉ 2.19. 2.11 ΓòÉΓòÉΓòÉ
  1644.  
  1645.  
  1646. 2.11  Beta
  1647.  
  1648.    - Messages generated by NEF in multiple parts now
  1649.     have a time stamp that increases one second for
  1650.     each message part, thus avoiding false duplicate
  1651.     detection by the buggy dupe check of Squish 1.10.
  1652.  
  1653.  
  1654. ΓòÉΓòÉΓòÉ 2.20. 2.10 ΓòÉΓòÉΓòÉ
  1655.  
  1656.  
  1657. 2.10  Beta
  1658.  
  1659.    - New function: "Outbound Analysis".
  1660.     Syntax: NEF OutView [<file>] (verbose)
  1661.         NEF Out [<file>] (tiny)
  1662.  
  1663.     If <file> is not specified, the report goes to
  1664.     message areas. To define a message area for
  1665.     report, use the "<OUT>" keyword as a TAG. In this
  1666.     case, the Subj, Prefix and Suffix will be
  1667.     ignored.
  1668.  
  1669.  
  1670. ΓòÉΓòÉΓòÉ 2.21. 2.00 ΓòÉΓòÉΓòÉ
  1671.  
  1672.  
  1673. 2.00 - First public release for the completely new NEF (OS/2 and
  1674.     DOS).
  1675.  
  1676.    - Added the <DEF> and <BAD> special tags for
  1677.     announcements.
  1678.  
  1679.    - Documented the NoAnnounce statement (already present in
  1680.     NEF v1.00).
  1681.  
  1682.    - Added the Tic processing and Link Robot sections.
  1683.  
  1684.  
  1685. ΓòÉΓòÉΓòÉ 2.22. 1.00 ΓòÉΓòÉΓòÉ
  1686.  
  1687.  
  1688. 1.00 - First public release (DOS only).
  1689.  
  1690.  
  1691. ΓòÉΓòÉΓòÉ 3. Copyright ΓòÉΓòÉΓòÉ
  1692.  
  1693. **************************************************************
  1694. *                               *
  1695. *                               *
  1696. *          **  ** ******* *******          *
  1697. *          ***  **  **  *  **  *          *
  1698. *          **** **  ** *   ** *           *
  1699. *          ** ****  ****   ****           *
  1700. *          **  ***  ** *   ** *           *
  1701. *          **  **  **  *  **            *
  1702. *          **  ** ******* ****           *
  1703. *                               *
  1704. *                               *
  1705. *             Version 2.38             *
  1706. *                               *
  1707. *    File Distribution for "BinkleyTerm Style" Systems   *
  1708. *                               *
  1709. *                               *
  1710. **************************************************************
  1711. *                               *
  1712. *    (C) Copyright 1991-1996  by  Alberto Pasquale     *
  1713. *                               *
  1714. *      A L L  R I G H T S  R E S E R V E D       *
  1715. *                               *
  1716. **************************************************************
  1717.  
  1718.  
  1719.   "BinkleyTerm" is trademark of Bit Bucket Software, Co.
  1720.  
  1721.  
  1722.  
  1723.     NEF 2.38 User's Manual, by Alberto Pasquale
  1724.  
  1725.  
  1726. ΓòÉΓòÉΓòÉ 4. Introduction ΓòÉΓòÉΓòÉ
  1727.  
  1728.              INTRODUCTION
  1729.  
  1730.  
  1731. -> For licensing information, please see License.Doc.
  1732.  
  1733. Thanks for evaluating NEF: a "New Echo Files" distribution
  1734. system.
  1735.  
  1736.  
  1737. ΓòÉΓòÉΓòÉ 4.1. Main Features ΓòÉΓòÉΓòÉ
  1738.  
  1739.              Main Features
  1740.  
  1741.  
  1742. - It works on systems with a Binkley Style outbound and
  1743.  *.MSG or Squish message base.
  1744.  
  1745. - File Import/Forward/Hatch via the standard .TIC system,
  1746.  initially implemented by Tick.
  1747.  
  1748. - File "Areafix", to automatically link/unlink file areas via
  1749.  netmail messages. Wildcards can be used to make multiple
  1750.  link/unlink requests easier.
  1751.  
  1752. - The traditional privilege specification (<level>[/<keys>])
  1753.  is used extensively (see <WSEL>) and is useful to create
  1754.  "groups" of areas for selective operations (e.g. Announce).
  1755.  
  1756.  However, it is recommended that file-network coordinators
  1757.  organize their area TAGS in a hierarchical way:
  1758.  NewNet.OS2.COMMS
  1759.  NewNet.OS2.GAMES
  1760.  NewNet.WIN.COMMS
  1761.  NewNet.WIN.MISC
  1762.  
  1763. - Support for "FileBone.Na style" files.
  1764.  
  1765. - Automatic forwarding of requests for missing areas to the
  1766.  uplinks.
  1767.  
  1768. - Fast Squish netmail scan.
  1769.  
  1770. - Flexible file announcements via echo or netmail messages.
  1771.  Wildcards in file area tags allow easy configuration of
  1772.  multiple announcement areas for different groups of file
  1773.  areas.
  1774.  
  1775. - Full multitasking support. File sharing problems are handled
  1776.  wherever necessary.
  1777.  
  1778. - Full 4D operation; no direct support for ancient pointnet
  1779.  addressing method. However points addressed via pointnet can
  1780.  obviously be seen with their pointnet adress.
  1781.  
  1782. - Different outbounds for different domains are supported the
  1783.  same way as in Squish, via zone mapping.
  1784.  
  1785. - Very flexible MultiAka support. You can use different
  1786.  addresses in different areas, different addresses for
  1787.  different downlinks in the same area, etc.
  1788.  
  1789. - Outbound analysis and report to message areas and/or file.
  1790.  
  1791. - "Passthru" Area support, with optional deletion-age parameter.
  1792.  
  1793. - Long Description ("LDESC" keyword) support.
  1794.  
  1795. - Multiple "Desc" support.
  1796.  
  1797. - Multi-line description support for Files.Bbs.
  1798.  
  1799. - EchoToss.Log support.
  1800.  
  1801. - Automatic creation of new areas from authorized uplinks.
  1802.  
  1803. - Automatic linking of specified downlinks to selected new
  1804.  areas when they are automatically created.
  1805.  
  1806. - Check on imported description strings, to avoid trojan horses
  1807.  using certain control characters.
  1808.  
  1809. - Clean and compact link configuration file.
  1810.  
  1811. - Easy addition (on area TAG basis) of text strings at the head
  1812.  of imported descriptions, to allow inclusion of flags and
  1813.  download counters in selected areas.
  1814.  
  1815. - Easy partial/total area split/merge: you can forward
  1816.  certain files to a new area TAG.
  1817.  
  1818. - Support for Maximus 3.xx FileBase: when the file areas
  1819.  are modified the filebase is internally updated (no need for
  1820.  external FB/FBP).  The additional UniFiles.Idx (with no
  1821.  duplicates) created by QFB (my FB/FBP substitute) is also
  1822.  maintained.
  1823.  
  1824. - Automatic addition of new areas to the Maximus 3.xx
  1825.  configuration.
  1826.  
  1827. - Support for Squish configuration file, to get the
  1828.  information about path, type and primary address of message
  1829.  areas directly from it.
  1830.  
  1831. - (OS/2) Support for "Feature DLLs": developers can find the
  1832.  necessary Header file and an example C source included in
  1833.  the NEF package (Nefeat.H, Feature.C, Feature.Dll).
  1834.  Currently available (on 2:332/504):
  1835.   NefDsc13.zip by Michael Hohner (stores descriptions in EAs).
  1836.  
  1837.  
  1838. ΓòÉΓòÉΓòÉ 4.2. Credits ΓòÉΓòÉΓòÉ
  1839.  
  1840.               CREDITS
  1841.  
  1842. "BinkleyTerm" is a trademark of Bit Bucket Software Co.
  1843.  
  1844. This program uses the Squish "MsgAPI" code, Copyright 1991-1994
  1845. by Lanius Corporation. "Squish" and "Maximus" are trademarks of
  1846. Lanius Corporation.
  1847.  
  1848. "Tick" is Copyright by Barry Geller
  1849.  
  1850. The archivers referred-to throughout this documentation are
  1851. Copyright and/or trademarks of the respective owners.
  1852.  
  1853.  
  1854. ΓòÉΓòÉΓòÉ 4.3. Overall Operation ΓòÉΓòÉΓòÉ
  1855.  
  1856.             OVERALL OPERATION
  1857.  
  1858.  
  1859. When invoked, first of all NEF looks into the netmail area(s)
  1860. for netmail messages to the Link Robot (Areafix like) and
  1861. executes the commands required; then it looks for new .TIC files
  1862. in the netfile area(s) and forwards them.
  1863.  
  1864. The ingoing files are moved to their destination directory and
  1865. the description is appended to the files.bbs.
  1866.  
  1867. A careful check is operated on the text of the description, to
  1868. avoid trojan horses that use special control characters.
  1869.  
  1870. Existing old descriptions for the ingoing files are deleted.
  1871.  
  1872. If the Replaces keywords are present in the ingoing .TIC (and
  1873. the function is not disabled in NEF.CFG), the pertinent files
  1874. are erased and their description removed from the files.bbs.
  1875.  
  1876. The forwarded TICs will have a new Path line with UTC time of
  1877. forward and updated SeenBys; Points are not included in the
  1878. SeenBys of TICs addressed to other links, to avoid unnecessarily
  1879. huge lists of SeenBys.
  1880.  
  1881. The .BSY support avoids conflicts in the outbound, while
  1882. possible conflicts in the access to files.bbs are minimized by
  1883. waiting several seconds before giving up.
  1884.  
  1885. Finally, NEF writes the announcements of the received files;
  1886. each message is limited (before splitting) to the maximum size
  1887. specified with the "MsgSize" statement (default is 12KB to avoid
  1888. problems with old mail processors).
  1889.  
  1890. Conflicts on the message base are handled by the Squish MsgAPI.
  1891.  
  1892. When the Maximus FileBase support is enabled, a mutual exclusive
  1893. semaphore flag "FileBase.Bsy" is used to avoid concurrent access
  1894. and modification of the filebase by other ApWorks programs.
  1895. There is no need to delete this flag if it remains after a power
  1896. failure or abnormal termination (ApWorks programs are smart
  1897. enough to realize whether the flag is really in use or not).
  1898.  
  1899.  
  1900. ΓòÉΓòÉΓòÉ 4.3.1. From Address Selection ΓòÉΓòÉΓòÉ
  1901.  
  1902.            From Address Selection
  1903.  
  1904. The algorythm to choose the "From" address for the TIC files is:
  1905.  
  1906. If an aka ovverride (#<adr>) is used in "FileArea"
  1907.   then use FileArea aka override
  1908. else if an aka override is present in the "FileLink" definition
  1909.   then use FileLink aka override
  1910. else if the destination zone matches an "Address" statement
  1911.   then use the zone-matching address
  1912. else if an aka default (@<adr>) is used in "FileArea"
  1913.   then use FileArea aka default
  1914. else
  1915.   use the primary (first) "Address" statement.
  1916.  
  1917.  
  1918. ΓòÉΓòÉΓòÉ 4.3.2. Description Handling ΓòÉΓòÉΓòÉ
  1919.  
  1920.            Description Handling
  1921.  
  1922. The TIC files can contain "Desc" and "LDesc" lines. Usually the
  1923. description contained in "Desc" line(s) is short and
  1924. unformatted, while that carried by the "LDesc" lines is long,
  1925. multi-line and formatted.
  1926.  
  1927. For the announcements, the longest one is selected.
  1928.  
  1929. For the Files.Bbs: if MultiLineDesc support is enabled, the
  1930. longest description is used, otherwise the "Desc" one.
  1931.  
  1932.  
  1933.  
  1934.  
  1935. ΓòÉΓòÉΓòÉ 5. Installation ΓòÉΓòÉΓòÉ
  1936.  
  1937.  
  1938.              INSTALLATION
  1939.  
  1940.  
  1941. 1) There are 3 versions of NEF: OS/2, NT and DOS/32, distributed
  1942.   in different archives. The main program is always named
  1943.   NEF.EXE: please make sure you have the correct version.
  1944.  
  1945. 2) Edit your Nef.Cfg.
  1946.   You can find useful examples in the NEF_*.Cfg files and
  1947.   detailed information in the "CFG REFERENCE" section of this
  1948.   documentation.
  1949.  
  1950. 3) Edit your batch file in order to call NEF whenever you would
  1951.   like to test for the presence of .TIC files in your inbounds
  1952.   and process them. If you do not pass a different pathname as
  1953.   a command line parameter, Nef.Cfg must reside in the current
  1954.   directory.
  1955.  
  1956. 4) (OS/2): Make sure you have the MSGAPI32.DLL in a directory
  1957.    contained in your LIBPATH and the PmHatch.Exe program in
  1958.    your PATH. MSGAPI32.DLL can be found in the Squish 1.11
  1959.    archive (SQSHP111.LZH).
  1960.  
  1961.   (NT): Make sure you have the MSGAPINT.DLL in a directory
  1962.    contained in your PATH. MSGAPINT.DLL can be found in the
  1963.    Max 3.01 for Windows archive (MAX301N.ZIP).
  1964.  
  1965.   (DOS): Make sure you have the DOS4GW.EXE Dos extender (from
  1966.    Rational System Inc.) in your path.
  1967.  
  1968.    The DOS4GW extender requires an XMS or DPMI memory driver
  1969.    installed in your config.sys: e.g. HIMEM.SYS, QEMM (by
  1970.    QuarterDeck Office Systems Inc.).
  1971.  
  1972. 5) In order to have a correct UTC time specification in your
  1973.   outgoing TICs, please note that you must have the environment
  1974.   variable "TZ" correctly set in config.sys (OS/2) or
  1975.   autoexec.bat (DOS).
  1976.  
  1977.   E.g. for Central European Time (CET):
  1978.  
  1979.    SET TZ=CET-01 (winter, "normal" solar time)
  1980.    SET TZ=CET-02 (summer, daylight saving time).
  1981.  
  1982.   E.g. for USA East Coast:
  1983.  
  1984.    SET TZ=EST5EDT
  1985.  
  1986.    Eastern time is 5h less than UTC and Daylight saving
  1987.    applies with the "standard rule" from the first sunday o
  1988.    april to the last sunday of october.
  1989.  
  1990.   More complicate expressions might be used to specify
  1991.   automatic change to and back from daylight saving, if a fixed
  1992.   rule is available.
  1993.  
  1994.   E.g. for Central Europe: daylight saving is 1h ahead from the
  1995.   last sunday of march to the last sunday of october.
  1996.  
  1997.    SET TZ=CET-01CDT,M3.5.0,M10.5.0
  1998.  
  1999.   (See a C manual for further details).
  2000.  
  2001.  
  2002. ΓòÉΓòÉΓòÉ 6. The Command Line ΓòÉΓòÉΓòÉ
  2003.  
  2004.  
  2005.         Command Line OPTIONS and SWITCHES
  2006.  
  2007.  
  2008. To get help about the command line syntax, use the "-h" or "-?"
  2009. command line switch: type "NEF -h" or "NEF -?".
  2010.  
  2011. The following forms are available:
  2012.  
  2013.  NEF [<sw>]
  2014.  NEF [<sw>] NOTIFY [<adr> ...]
  2015.  NEF [<sw>] FILEFIX <adr> <cmd> ...
  2016.  NEF [<sw>] OUT|OUTVIEW [<file>]
  2017.  NEF [<sw>] CLEAN
  2018.  NEF [<sw>] HATCH|MATCH|CATCH|SEND
  2019.  NEF [<sw>] HATCH|MATCH|CATCH <name>[/<repl>] <TAG> [<desc> [<ldesc>]]
  2020.  
  2021. where:
  2022.  
  2023.  <sw> is one or more of:
  2024.  
  2025.   -c<cfg>
  2026.        Use <cfg> as configuration file instead of the
  2027.        default "Nef.Cfg".
  2028.  
  2029.        Example: "Nef -ce:\cfg\nef2.cfg"
  2030.  
  2031.  
  2032.   -d<adr>
  2033.        Hatch to <adr> only.
  2034.  
  2035.        If you Hatch/Catch/Match/Send a file with the
  2036.        -d<adr> command line switch, it is sent to <adr>
  2037.        only.
  2038.  
  2039.        <adr> can be any 4D address: in the case it is
  2040.        defined as a link in the matching "FileArea" or
  2041.        even only as a "FileLink", the specified akas,
  2042.        password and switches are applied.
  2043.  
  2044.        If, on the contrary, <adr> is a unknown address,
  2045.        the Hold flavour is used, no password is put in
  2046.        the TIC and the "from" aka is derived from an
  2047.        aka-match on the zone.
  2048.  
  2049.        Example: "Nef -d2:332/589 hatch"
  2050.  
  2051.  
  2052.   -h or -?
  2053.        Help.
  2054.  
  2055.  
  2056.   -k
  2057.        Keep local files (do not Replace,
  2058.        for Match/Catch).
  2059.  
  2060.  
  2061.   -l<log>
  2062.        Use <log> as logfile instead of the one specified
  2063.        via the "StatusLog <log>" configuration statement.
  2064.  
  2065.        Example: "Nef -le:\cfg\nef.log"
  2066.  
  2067.  
  2068.   -p
  2069.        Clean passthru areas before terminating, see also
  2070.        the "CLEAN" option.
  2071.  
  2072.        Examples:
  2073.  
  2074.         NEF -p
  2075.         NEF -p OUT
  2076.  
  2077.  
  2078.   -t
  2079.        Toggle Secure mode (see also the NoSecure cfg
  2080.        statement).
  2081.  
  2082.  
  2083.  A description of options follows:
  2084.  
  2085.   NOTIFY
  2086.        Notify linked areas to the specified address list,
  2087.        where <adr> is a 4D address.
  2088.  
  2089.        If no address is given, NEF will notify only the
  2090.        nodes flagged with the 'Y' flag in their FileLink
  2091.        statement.
  2092.  
  2093.        If "ALL" is specified, all defined links will be
  2094.        notified.
  2095.  
  2096.   FILEFIX
  2097.        Execute <cmd>s as if they were received via netmail
  2098.        from <adr> addressed to the AutoLink robot.
  2099.  
  2100.        Please note that there might be some problem using
  2101.        the '%' character in front of filefix commands:
  2102.        4OS2 will substitute the corresponding environment
  2103.        variable. You can use the '?' character in the
  2104.        place of '%' or precede '%' with an escape character.
  2105.  
  2106.   OUT
  2107.        Outbound analysis (message output), optional
  2108.        concise output to <file> (no specification of each
  2109.        and every attached file). See the <OUT> and
  2110.        <OUTVIEW> "special tags" in the "Announce"
  2111.        section.
  2112.  
  2113.   OUTVIEW
  2114.        Same as OUT, but optional output to <file> is
  2115.        verbose.
  2116.  
  2117.   CLEAN
  2118.        Clean passthru areas.
  2119.  
  2120.        Since it might be not efficient to always scan the
  2121.        entire outbound to check for passthru files to be
  2122.        deleted, NEF must be explicitly instructed to do
  2123.        so (see also the "-p" command line switch).
  2124.  
  2125.        Example: "Nef Clean"
  2126.  
  2127.   HATCH
  2128.        Traditional hatch.
  2129.   MATCH
  2130.        Move file to destination area then hatch.
  2131.   CATCH
  2132.        Copy file to destination area then hatch.
  2133.   SEND
  2134.        (OS/2) Hatch via PM Dialog.
  2135.  
  2136.        If you use one of these hatch options, NEF will
  2137.        not process inbound .TICs; instead it will send
  2138.        the specified files to your links.
  2139.  
  2140.        Examples:
  2141.             "Nef Hatch"
  2142.             "Nef Match"
  2143.             "Nef Catch"
  2144.             "Nef Send" (OS/2 Only)
  2145.  
  2146.        When no parameters are specified after the hatch
  2147.        option, your interaction is required: you will be
  2148.        requested the filename specification (Dos or OS/2
  2149.        wildcards allowed) and, for each matching file,
  2150.        the optional "replace" names (separated by space),
  2151.        the area TAG, the description and the optional
  2152.        "Long Description".
  2153.  
  2154.        On the other hand, if you specify the hatch
  2155.        parameters on the command line, you cannot give a
  2156.        multi-line "Long Description" apart from that
  2157.        taken from the File_Id.Diz, Files.Bbs or specified
  2158.        file.
  2159.  
  2160.        HATCH sends the specified files; they are not
  2161.        moved and their local description is NOT modified.
  2162.  
  2163.        MATCH moves the specified files to the directory
  2164.        that corresponds to the specified <TAG>, updates
  2165.        their descriptions (see "Description Handling" in
  2166.        Overall operation) and sends them as per normal
  2167.        hatch. If <replace> files are specified, they are
  2168.        deleted with their associated description.
  2169.  
  2170.        CATCH is just like Match, but the files are copied
  2171.        instead of moved.
  2172.  
  2173.        Note that MATCH/CATCH can be used even when the
  2174.        files already reside in their destination
  2175.        directory, in order to change the local
  2176.        description and possibly apply the specified
  2177.        replaces.
  2178.  
  2179.     (OS/2)
  2180.        SEND allows to specify all the hatch parameters
  2181.        via a user friendly PM Dialog. Please make sure
  2182.        the PmHatch.Exe file is in the PATH. In the case
  2183.        the PmHatch program terminates abnormally, the NEF
  2184.        program will wait for it indefinitely: you can
  2185.        terminate it using CTRL-C or CTRL-Break.
  2186.  
  2187.        See the "PmHatch" section below for further
  2188.        information.
  2189.  
  2190.  
  2191.  Parameters for Hatch/Match/Catch:
  2192.  
  2193.   <name>
  2194.        This is the full pathname of the files you want to
  2195.        H/M/Catch. You need to specify the full path even
  2196.        if you are hatching files that reside in the
  2197.        directory corresponding to <TAG>. O.S. wildcards
  2198.        are allowed.
  2199.  
  2200.   <repl>
  2201.        This is the optional list of names of the files to
  2202.        be replaced (separated by '/'): if the receiving
  2203.        system has this feature enabled, the indicated
  2204.        files in the <TAG> area will be deleted while
  2205.        importing the new file.
  2206.  
  2207.   <TAG>
  2208.        This is the tag used for distributing an echo-file
  2209.        area.
  2210.  
  2211.   <desc>
  2212.   <ldesc>
  2213.        These are the "short" one-line file description
  2214.        and the "long" multi-line one.
  2215.  
  2216.        They can be specified between quotes (one line
  2217.        even for <ldesc>) or by means of:
  2218.  
  2219.        @BBS   to load from Files.Bbs
  2220.        @DIZ   to load from the contained File_Id.Diz
  2221.        @<file>  to load from <file>
  2222.  
  2223.        In the case you need to include the '"' character
  2224.        in the description when using the "quoted string"
  2225.        method, just precede it with a backslash escape
  2226.        character: '\"'.
  2227.     Note:
  2228.        Please realize that the "short" and "long"
  2229.        descriptions are two separate and independent
  2230.        items.
  2231.  
  2232.        Short description: single line, "Desc" keyword in
  2233.        TIC files.
  2234.  
  2235.        Lond description: multiple lines, "Ldesc" keywords
  2236.        in TIC files.
  2237.  
  2238.  
  2239. ΓòÉΓòÉΓòÉ 6.1. Examples ΓòÉΓòÉΓòÉ
  2240.  
  2241.  
  2242. Examples:
  2243.  
  2244.   NEF Hatch d:\p\prg12.rar/prg11.rar COMMS "New comm prg"
  2245.  
  2246.     d:\p\prg12.rar is hatched (NOT moved) into the COMMS
  2247.     area; prg11.rar will be deleted on receiving systems.
  2248.  
  2249.   NEF Catch d:\p\prg12.rar/prg11.rar COMMS "New comm prg"
  2250.  
  2251.     d:\p\prg12.rar is copied to the directory corresponding
  2252.     to the COMMS file area and is hatched to the COMMS area.
  2253.     prg11.rar is deleted locally and will be deleted on
  2254.     receiving systems.
  2255.  
  2256.   NEF Match d:\p\prg12.rar COMMS "New comm prg"
  2257.  
  2258.     d:\p\prg12.rar is moved to the directory corresponding
  2259.     to the COMMS file area, it is hatched to the COMMS area,
  2260.     no replace information is put in the outgoing TICs.
  2261.  
  2262.   NEF Send
  2263.  
  2264.     (OS/2) Invokes the PM dialog window.
  2265.  
  2266.   NEF Hatch d:\apbbs\nef999.rar APBBS @bbs
  2267.  
  2268.     d:\apbbs\nef999.rar is hatched into the APBBS area,
  2269.     taking the description from the files.bbs.
  2270.  
  2271.   NEF Hatch d:\apbbs\nef999.rar APBBS "Nef 9.99" @diz
  2272.  
  2273.     d:\apbbs\nef999.rar is hatched into the APBBS area,
  2274.     taking "Nef 9.99" as the "short" description and the
  2275.     File_Id.Diz (if present in the archive) as the "long"
  2276.     description.
  2277.  
  2278.   NEF Hatch d:\apbbs\nef999.rar APBBS @bbs @diz
  2279.  
  2280.     d:\apbbs\nef999.rar is hatched into the APBBS area,
  2281.     taking the "short" description from the files.bbs and
  2282.     the "long" description from the File_Id.Diz (if it is
  2283.     contained in the archive).
  2284.  
  2285.   NEF -d2:332/504.2 Hatch d:\apbbs\nef999.rar APBBS @bbs @diz
  2286.  
  2287.     Same as above, but the file is hatched to 2:332/504.2
  2288.     only.
  2289.  
  2290.   NEF OUT
  2291.  
  2292.     An outbound analysis is performed, the results are
  2293.     reported via messages in the area(s) configured in
  2294.     Nef.Cfg (see the Announce statement).
  2295.  
  2296.   NEF OUT Out.Txt
  2297.  
  2298.     Same as above, but the output is also written to
  2299.     "Out.Txt" in "concise mode".
  2300.  
  2301.   NEF OUTVIEW Out.Txt
  2302.  
  2303.     Same as above but the file output is verbose.
  2304.  
  2305.   NEF -p OUT
  2306.  
  2307.     NEF will report the status of the outbound and clean the
  2308.     passthru areas.
  2309.  
  2310.     If you need to maintain passthru areas, this is the most
  2311.     efficient use, since NEF must scan the outbound once to
  2312.     make two different things ("clean passthru" and
  2313.     "outbound report").
  2314.  
  2315.   NEF Notify
  2316.     A notification message (specifying the linked areas)
  2317.     is sent to the nodes that have the 'Y' flag in their
  2318.     FileLink statement.
  2319.  
  2320.   NEF Notify All
  2321.  
  2322.     A notification message is sent to all the defined links,
  2323.     specifying the linked areas.
  2324.  
  2325.   NEF Notify 2:332/589 1:234/567
  2326.  
  2327.     A notification message is sent to the specified links.
  2328.  
  2329.   NEF FileFix 2:332/567 APBBS -APBBSDOS
  2330.  
  2331.     Node 2:332/567 is linked to the APBBS area and unlinked
  2332.     from the APBBSDOS one.
  2333.  
  2334.   NEF FileFix 2:332/678 ?QUERY
  2335.  
  2336.     Node 2:332/678 is sent a filefix answer to the QUERY
  2337.     command.
  2338.  
  2339.  
  2340. ΓòÉΓòÉΓòÉ 6.2. PmHatch ΓòÉΓòÉΓòÉ
  2341.  
  2342.               PmHatch
  2343.  
  2344.   OS/2 Only:
  2345.  
  2346.     To invoke the PM hatch program you must type "NEF send".
  2347.     The PmHatch program is very simple and intuitive to use:
  2348.     see the following description.
  2349.  
  2350.     To move between fields, use the mouse or the TAB key.
  2351.  
  2352.     You can select the destination Area Tag via a drop-down
  2353.     list: just click with the mouse on the button at the
  2354.     right of the entry field or press ALT-down_arrow.
  2355.  
  2356.     You have three radio buttons to select the "type" of
  2357.     hatch (normal, with Copy, with Move), just as you use
  2358.     Hatch/Catch/Match from the command line. You can use the
  2359.     arrows and the space bar to select.
  2360.  
  2361.     You can choose the file to be hatched via a file dialog
  2362.     box: just click on the "Browse" push button on the right
  2363.     of the field or press ALT-W. The file dialog starts from
  2364.     the directory corresponding to the selected Tag, but you
  2365.     can move to any drive or directory.
  2366.  
  2367.     You can also specify one or more "Replace" files via a
  2368.     file-dialog by clicking on the "Browse" push-button (or
  2369.     pressing ALT-W) when the cursor is in the "Repl" field.
  2370.  
  2371.     When doing Copy or Move, the files.bbs of the
  2372.     destination area is updated and the "replace" files (if
  2373.     specified) are deleted, just as if the file were tossed
  2374.     from the inbound.
  2375.  
  2376.     You can mark the "NoLoc" checkbox to prevent NEF
  2377.     from deleting the "replace" files in the local area.
  2378.     Click with the mouse, move with the vertical arrows and
  2379.     check with the space bar or use the ALT-L hotkey.
  2380.  
  2381.     You can load a one line description (Desc) from the
  2382.     file_id.diz, files.bbs or specified file by clicking on
  2383.     the "Arc Diz", "FilesBbs", "File" push-buttons or by
  2384.     pressing the ALT-D, ALT-B, ALT-F keys respectively.
  2385.  
  2386.     You can load a multi-line "long description" (Long Desc)
  2387.     by using the same method, when the cursor is in the
  2388.     Long Desc field.
  2389.  
  2390.     The "Arc Diz" method supports also self-extracting
  2391.     archives.
  2392.  
  2393.     If you do not have the "CompressCfg <filename>"
  2394.     statement in Nef.Cfg, the "Arc Diz" push-button will be
  2395.     disabled.
  2396.  
  2397.     Of course you can always fill-in or modify any field
  2398.     manually.
  2399.  
  2400.     Now look at the five push-buttons at the bottom of the
  2401.     hatch dialog:
  2402.  
  2403.     <OK> (ALT-O): to exit the dialog and hatch all the
  2404.       entered files.
  2405.  
  2406.     <Prev> (ALT-P): to visualize the previous hatch entry.
  2407.  
  2408.     <Next> (ALT-N): to create a new (empty) entry in order
  2409.       to hatch another file or to move to next entry if
  2410.       <Prev> has been used.
  2411.  
  2412.     <Copy> (ALT-C): to copy the visualized entry to the
  2413.       first free position, in order to hatch another file
  2414.       by modifying the current entry.
  2415.  
  2416.     <Cancel> or ESC: to cancel the current entry.
  2417.  
  2418.     ALT-F4 or "Close", to abort (cancel all the hatch
  2419.     entries).
  2420.  
  2421.  
  2422.  
  2423. ΓòÉΓòÉΓòÉ 6.3. Errorlevels ΓòÉΓòÉΓòÉ
  2424.  
  2425.  
  2426.              ERRORLEVELS
  2427.  
  2428.  
  2429.  0 - File areas modified: Match or .TIC processed.
  2430.  1 - File areas not modified: Hatch or NO .TIC processed.
  2431.  2 - Help requested.
  2432.  3 - Abnormal termination
  2433.  4 - Configuration file not found.
  2434.  5 - Invalid parameter on command line.
  2435.  6 - No Outbound defined in cfg file.
  2436.  7 - Disk Full.
  2437.  8 - Out of Memory.
  2438.  9 - Can't open Log file.
  2439.  10 - Prefix or Suffix too long.
  2440.  11 - User Input Error (interactive hatch/match).
  2441.  12 - TimeOut waiting for concurrent NEF process to finish.
  2442.  13 - Error while accessing .SAV file.
  2443.  17 - FileBase Busy TimeOut.
  2444.  
  2445. 250 - MsgApi: Init Error.
  2446. 251 - MsgApi: Area Open Error.
  2447.  
  2448.  
  2449. ΓòÉΓòÉΓòÉ 7. Cfg Reference ΓòÉΓòÉΓòÉ
  2450.  
  2451.  
  2452.              CFG REFERENCE
  2453.  
  2454.  
  2455. Before analyzing the cfg keywords in detail, let's introduce the
  2456. overall mechanism that is at the basis of NEF's file forwarding
  2457. capabilities.
  2458.  
  2459. Each area (defined via the FileArea keyword) can be
  2460. mono-directional or bi-directional.
  2461.  
  2462. In bidirectional areas every link can send files to us and we
  2463. forward to everyone, unless those with a "receive-from"
  2464. override.
  2465.  
  2466. Monodirectional areas can be "receive from everyone" or "send to
  2467. everyone". Obviously, at least one link must have an override in
  2468. the opposite direction, unless we are the destination or
  2469. origination of all the files.
  2470.  
  2471. NEF uses the three flags 'I' (Input: we accept from), 'O'
  2472. (Output: we send to) and '*' (bidirectional) to define the
  2473. direction of an area or link.
  2474.  
  2475. Each area has a direction, that can be overridden on a per-node
  2476. basis by a global (in the FileLink statement) or local (in the
  2477. FileArea statement, before the pertinent link address) direction
  2478. override.
  2479.  
  2480. In other words: each link has a direction that is defined in
  2481. order of priority (from lowest to highest) by the area direction
  2482. (I|O|* in FileArea), the global link override (in the FileLink
  2483. statement), the local link override (before link address in the
  2484. FileArea statement).
  2485.  
  2486. It is recommended not to use the global link override when not
  2487. really useful, so that the area definition statements remain
  2488. clearly readable without the need to keep one eye on the
  2489. FileLink statements.
  2490.  
  2491. Usually the global link override is useful when you have an
  2492. uplink for many areas. For example: if one day the uplink and
  2493. one of the downlinks switch their role, you have to move the 'I'
  2494. flag from one FileLink statement to the other with no need to
  2495. change all the area definitions.
  2496.  
  2497. The area direction definition is very useful to allow automatic
  2498. linking via the Link Robot both to normal "Uplink to Downlinks"
  2499. areas and to reverse "Downlinks to Uplink" areas (mostly used
  2500. for "pre" areas to collect files and send them to the
  2501. coordinator).
  2502.  
  2503. As a matter of facts, in response to a link request, the Link
  2504. Robot only adds the requesting address (with no flags) to the
  2505. FileArea statement. So the real characteristics of the link
  2506. depend on the Area direction and on the link flags (FileLink
  2507. statement).
  2508.  
  2509.  
  2510.  
  2511. ΓòÉΓòÉΓòÉ 7.1. Conventions ΓòÉΓòÉΓòÉ
  2512.  
  2513.  
  2514.              Conventions
  2515.  
  2516.  
  2517.  
  2518. - Items between square brackets (e.g. [<item>]) are optional.
  2519.  
  2520. - Items separated by '|' are mutually exclusive (e.g. I|O|*).
  2521.  
  2522. - The names of the various Keywords are NOT case sensitive.
  2523.  
  2524. - The area TAGs are NOT case sensitive.
  2525.  Please be aware that old TIC processors might not be able to
  2526.  handle tags longer than 8 characters or containing dots.
  2527.  
  2528. - <WTAG> is a "Wild TAG" specification: it can be a normal area
  2529.  TAG or contain wildcards in the "OS/2 style".
  2530.  
  2531.  Examples:
  2532.  
  2533.  "*LOC*" specifies all tags that contain "LOC".
  2534.  
  2535.  "FW???" specifies all tags that have up to three characters
  2536.  after "FW".
  2537.  
  2538.  
  2539. - <ACS> is an access privilege specification in the form:
  2540.  <level>[/<keys>].
  2541.  
  2542.  <level> is an integer in the range 0-65535
  2543.  
  2544.  <keys> is a set of digits or (case insensitive) letters from
  2545.  "12345678ABCDEFGHIJKLMNOPQRSTUVWX".
  2546.  
  2547.  To access a protected area it's necessary to have a level
  2548.  above or equal to the specified one and a set of keys containg
  2549.  the required ones.
  2550.  
  2551.  
  2552. - <WSEL> is a combination of <WTAG> and <ACS> in the form:
  2553.  [<WTAG>][:[<level>][/<keys>]].
  2554.  
  2555.  Level and keys are used to enhance the selectivity of <WTAG>.
  2556.  
  2557.  - If <WTAG> is omitted, '*' is assumed.
  2558.  - if ':' is not used, any area matching <WTAG> is
  2559.   included.
  2560.  - if ":/<keys>" is used, <level> is assumed 65535.
  2561.  
  2562.  
  2563.  Examples:
  2564.  
  2565.    Announce OS2*       ; All OS2* areas
  2566.  
  2567.    Announce OS2*:100/fg   ; OS2* areas that can be
  2568.                 ; accessed with privilege level
  2569.                 ; 100 and keys fg
  2570.  
  2571.    Announce :100/fg     ; All areas that can be accessed
  2572.                 ; with level 100 and keys fg
  2573.  
  2574.    Announce *:100      ; All areas that can be accessed
  2575.                 ; with level 100
  2576.  
  2577.    Announce :/g       ; All areas that can be accessed
  2578.                 ; with key g (and level 65535).
  2579.  
  2580.  
  2581. - When a directory path is required, the trailing backslash '\'
  2582.  is optional.
  2583.  
  2584. - The ';' character starts comments: any character following the
  2585.  ';' is ignored. Please note that configuration text strings
  2586.  (e.g. Subj, Origin) can contain the ';' character provided
  2587.  they are enclosed in quotes '"'.
  2588.  
  2589. - The maximum length of configuration lines (including FileArea
  2590.  definitions) is 510 characters.
  2591.  
  2592. - ... means that you can list further items of the same type.
  2593.  
  2594. - Unless differently specified, addresses are standard 4D and
  2595.  MUST begin with the zone number (FileArea statements excluded).
  2596.  
  2597. Please, note that the order of the configuration statements
  2598. follows some logical rule. In order not to create confusion in
  2599. the .cfg file and not to break some _necessary_ order relation,
  2600. please follow the scheme proposed in the example NEF_*.CFG files
  2601. and in this reference documentation.
  2602.  
  2603.  
  2604. ΓòÉΓòÉΓòÉ 7.2. System ΓòÉΓòÉΓòÉ
  2605.  
  2606.              S Y S T E M
  2607.  
  2608.  
  2609. ΓòÉΓòÉΓòÉ 7.2.1. RegKey ΓòÉΓòÉΓòÉ
  2610.  
  2611.  
  2612. RegKey <RegKey>
  2613.  
  2614.     Registered Users only: <RegKey> is the registration key
  2615.     and it is NOT case sensitive.
  2616.  
  2617.   Example:
  2618.  
  2619.     RegKey dfhyuwru6274623
  2620.  
  2621.  
  2622. ΓòÉΓòÉΓòÉ 7.2.2. Address ΓòÉΓòÉΓòÉ
  2623.  
  2624.  
  2625. Address <Address>
  2626.  
  2627.     You can use as many Address statements as you need for
  2628.     all of your AKAs. The first one specifies the "primary"
  2629.     address. <Address> is a standard 4D address
  2630.     specification.
  2631.  
  2632.   Example:
  2633.  
  2634.     Address 2:332/504.0  ; Primary Address
  2635.     Address 2:332/524.0  ; Second line aka
  2636.     Address 2:332/500.0  ; Hub aka
  2637.     Address 9:999/999.9  ; one more aka
  2638.  
  2639.  
  2640. ΓòÉΓòÉΓòÉ 7.2.3. StatusLog ΓòÉΓòÉΓòÉ
  2641.  
  2642.  
  2643. StatusLog <LogFile>
  2644.  
  2645.     <LogFile> is the name of the file where all the
  2646.     operations performed by NEF will be logged, following
  2647.     the "Binkley Style".
  2648.  
  2649.     In multitasking environments, please be sure to use a
  2650.     file that cannot be used by other processes at the same
  2651.     time. For example: if (in your system) NEF can be
  2652.     executed while Binkley is running, please use different
  2653.     log files.
  2654.  
  2655.     Multiple NEF processes using the same config file
  2656.     (and therefore the same <LogFile>) will have no problem
  2657.     since NEF does not begin operations until the previous
  2658.     launched instance (if it uses the same .cfg file) has
  2659.     finished.
  2660.  
  2661.     Should you not want the log file, you can comment this
  2662.     keyword out.
  2663.  
  2664.   Example:
  2665.  
  2666.     StatusLog d:\bbs\log\nef.log
  2667.  
  2668.  
  2669. ΓòÉΓòÉΓòÉ 7.2.4. EchoTossLog ΓòÉΓòÉΓòÉ
  2670.  
  2671.  
  2672. EchoTossLog <filename>
  2673.  
  2674.     When a message is written into echoareas defined with
  2675.     the "AreaTag" statement, the corresponding
  2676.     TAGs are written (one per line) to <filename>.
  2677.  
  2678.     If you use the "MaxPrm" statement (or MAXIMUS
  2679.     environment variable), "EchoTossLog" is not necessary
  2680.     and becomes an override of the echotosslog specification
  2681.     found in the Maximus .PRM file.
  2682.  
  2683.     If you do not like this output, you can override with
  2684.     the NUL name: "EchoTossLog NUL".
  2685.  
  2686.   Example:
  2687.  
  2688.     EchoTossLog d:\bbs\squish\echotoss.log
  2689.  
  2690.  
  2691. ΓòÉΓòÉΓòÉ 7.2.5. NetFile ΓòÉΓòÉΓòÉ
  2692.  
  2693.  
  2694. NetFile <InboundDir>
  2695.  
  2696.     You can specify as many NetFile statements as you need,
  2697.     one for each inbound directory where NEF must look for
  2698.     new .TIC files.
  2699.     <InboundDir> is the pathname of the inbound directory.
  2700.  
  2701.   Example:
  2702.  
  2703.     NetFile c:\file\net
  2704.  
  2705.  
  2706. ΓòÉΓòÉΓòÉ 7.2.6. Outbound ΓòÉΓòÉΓòÉ
  2707.  
  2708.  
  2709. OutBound <RootPath> [<Zone>]
  2710.  
  2711.     The outbound directories are specified with the same
  2712.     method as in squish.cfg.
  2713.     <RootPath> should not have an extension.
  2714.  
  2715.     The first OutBound statement does not have the <Zone>
  2716.     field and specifies the directory where NEF will build
  2717.     file attaches for the zone of the primary address.
  2718.  
  2719.     Subsequent OutBound statements must have the <Zone>
  2720.     field (Decimal). File attaches for the specified <Zone>
  2721.     are built in <RootPath>.<###>, where <###> is a 3 digit
  2722.     extension representing the zone number (hexadecimal).
  2723.  
  2724.     File attaches for zones different from the primary one
  2725.     and not matching any <Zone> of the OutBound statements
  2726.     are built in <RootPath>.<###>, where <RootPath> is the
  2727.     one specified in the first OutBound statement and <###>
  2728.     is a 3 digit extension representing the hexadecimal
  2729.     zone number.
  2730.  
  2731.   Note:
  2732.  
  2733.     The "OutBound" statements MUST be preceded by the
  2734.     "Address" ones.
  2735.  
  2736.   Example:
  2737.  
  2738.     OutBound c:\out\fidonet
  2739.     OutBound c:\out\amiganet 39
  2740.     OutBound c:\out\amiganet 40
  2741.  
  2742.     FileAttaches will be built in:
  2743.     Primary zone -> c:\out\fidonet
  2744.     zone 39    -> c:\out\amiganet.027
  2745.     zone 40    -> c:\out\amiganet.028
  2746.     other zones  -> c:\out\fidonet.<###>
  2747.             where <###> is the 3 digit hexadecimal
  2748.             representation of the zone number
  2749.  
  2750.  
  2751. ΓòÉΓòÉΓòÉ 7.2.7. TicHold ΓòÉΓòÉΓòÉ
  2752.  
  2753.  
  2754. TicHold <TicDir>
  2755.  
  2756.     This specifies the directory that holds all the .TIC
  2757.     files addressed to downlinks until they are sent and
  2758.     erased.
  2759.  
  2760.   Example:
  2761.  
  2762.     TicHold c:\file\tichold
  2763.  
  2764.  
  2765. ΓòÉΓòÉΓòÉ 7.2.8. BusyFlag ΓòÉΓòÉΓòÉ
  2766.  
  2767.  
  2768. BusyFlags
  2769.  
  2770.     This enables the Binkley-Style .BSY support.
  2771.  
  2772.     When attaching a file to a node, the presence of an
  2773.     appropriate .BSY file is checked; if it is present, some
  2774.     other process may be working on the same node, so NEF
  2775.     saves the attach info to a private <config>.SAV file
  2776.     (i.e. NEF.SAV when NEF.CFG is the config file). On
  2777.     subsequent runs, NEF will look for a <config>.SAV file
  2778.     and use the information in it to attempt again the
  2779.     creation of the file attaches.
  2780.     If the .BSY file is not found, it is created, the file
  2781.     attach is built, then the .BSY is erased.
  2782.     The name of the .BSY file is the same as a file attach
  2783.     to the same node: only the extension changes.
  2784.  
  2785.   Warning:
  2786.  
  2787.     The .BSY method has a nasty drawback: if the process
  2788.     that has created a .BSY file hangs or is shutdown
  2789.     abruptly, the .BSY file remains in its outbound
  2790.     directory, so that no other process will gain access to
  2791.     that node until somebody erases the .BSY file. It is
  2792.     advisable to delete *.BSY from the most used outbound
  2793.     directories at startup (in autoexec.bat (Dos) or
  2794.     startup.cmd (OS/2)).
  2795.  
  2796.  
  2797. ΓòÉΓòÉΓòÉ 7.2.9. NoRaidBeforeHatch ΓòÉΓòÉΓòÉ
  2798.  
  2799.  
  2800. NoRaidBeforeHatch
  2801.  
  2802.     Skips the scanning of netmail before the execution of
  2803.     hatch commands. This might be useful to avoid delays
  2804.     with huge *.MSG areas.
  2805.  
  2806.  
  2807. ΓòÉΓòÉΓòÉ 7.2.10. MsgSize ΓòÉΓòÉΓòÉ
  2808.  
  2809.  
  2810. MsgSize <bytes>
  2811.  
  2812.     To specify the maximum size (in bytes) for a message
  2813.     generated by NEF (minimum 8KB, default 12KB).
  2814.  
  2815.     Usually a larger message size is useful to avoid too many
  2816.     messages in reports of filebone availability. Anyway,
  2817.     please be careful not to use a size larger than your
  2818.     downlinks can handle.
  2819.  
  2820.     Example:
  2821.  
  2822.     MsgSize 90000
  2823.  
  2824.  
  2825. ΓòÉΓòÉΓòÉ 7.2.11. TicAreaCfg ΓòÉΓòÉΓòÉ
  2826.  
  2827.  
  2828. TicAreaCfg <filename>
  2829.  
  2830.     This defines the name of the file that contains all the
  2831.     file area definitions. See the "FileArea" keyword below
  2832.     for a description of the syntax.
  2833.  
  2834.     This keyword is optional: if you omit it, you can define
  2835.     your file areas directly in the .cfg file, provided you
  2836.     put all the FileArea statements _after_ the FileLink
  2837.     ones, at the end of the .cfg file.
  2838.  
  2839.     For systems with few areas the one-file configuration is
  2840.     handy, for systems with many areas and links, the
  2841.     separate file solution is recommended.
  2842.  
  2843.     Please note that the TicAreaCfg file can contain
  2844.     FileArea statements and comments ONLY.
  2845.  
  2846.   Example:
  2847.  
  2848.     TicAreaCfg d:\bbs\nef\ticarea.cfg
  2849.  
  2850.  
  2851. ΓòÉΓòÉΓòÉ 7.2.12. CompressCfg ΓòÉΓòÉΓòÉ
  2852.  
  2853.  
  2854. CompressCfg <filename>
  2855.  
  2856.  (OS2)
  2857.     To allow the extraction of File_Id.Diz while using the
  2858.     Pm Hatch.
  2859.  
  2860.     <filename> must specify the location and name of a
  2861.     "Squish style" compress definition file.
  2862.  
  2863.     In the case you are using a case-sensitive
  2864.     de/compression program (e.g. OS/2 ZIP/UNZIP), please
  2865.     make sure to use the correct switches in <filename>.
  2866.  
  2867.     If you are already using Squish and or Maximus, you
  2868.     can just specify the name of their compress.cfg (but do
  2869.     check that they indicate the necessary switches to avoid
  2870.     case sensitiveness during extraction).
  2871.  
  2872.     Refer to the "Compress Definition File" section at the
  2873.     end of this reference for the syntax of this
  2874.     configuration file.
  2875.  
  2876.   Example:
  2877.  
  2878.     CompressCfg c:\squish\compress.cfg
  2879.  
  2880.  
  2881. ΓòÉΓòÉΓòÉ 7.2.13. Squish Support ΓòÉΓòÉΓòÉ
  2882.  
  2883.           Optional Squish Support
  2884.  
  2885.  
  2886. ΓòÉΓòÉΓòÉ 7.2.13.1. SquishCfg ΓòÉΓòÉΓòÉ
  2887.  
  2888.  
  2889. SquishCfg <filename>
  2890.  
  2891.     It is used to specify the squish configuration file, so
  2892.     that the path, type (SDM vs Squish) and primary address
  2893.     for the announcement areas defined with the "AreaTag"
  2894.     statement can be automatically looked up.
  2895.  
  2896.     When SquishCfg is defined, if you use "AreaTag <Tag>" to
  2897.     define announcement areas, the "FromNode <adr>"
  2898.     statement is only used to override the primary address
  2899.     specified for that area in Squish.Cfg (including the
  2900.     -p<address> overrides).
  2901.  
  2902.     The "Include" keyword of Squish.Cfg is supported: just
  2903.     be sure to always use the full pathname in the Include
  2904.     statement if different from the working path.
  2905.  
  2906.     Both echomail and netmail areas are recognized by their
  2907.     Squish tags.
  2908.  
  2909.     Netmail areas will have the Private attribute and no
  2910.     origin by default. Local overrides are still possible
  2911.     via local "Origin" and "Attr" statements.
  2912.  
  2913.   Example:
  2914.  
  2915.     SquishCfg c:\squish\squish.cfg
  2916.  
  2917.  
  2918. ΓòÉΓòÉΓòÉ 7.2.14. Maximus 3.xx Support ΓòÉΓòÉΓòÉ
  2919.  
  2920.          Optional Maximus 3.xx Support
  2921.  
  2922.  
  2923. ΓòÉΓòÉΓòÉ 7.2.14.1. MaxPrm ΓòÉΓòÉΓòÉ
  2924.  
  2925.  
  2926. MaxPrm <filename>
  2927.  
  2928.     If the MAXIMUS environment variable is defined, this
  2929.     statement is an optional override only.
  2930.  
  2931.     It is used to take the default for EchoTossLog and to
  2932.     get the name and location of the files necessary for
  2933.     filebase updating. The ".prm" extension in <filename>
  2934.     can be omitted.
  2935.  
  2936.   Example:
  2937.  
  2938.     MaxPrm d:\bbs\max\max.prm
  2939.  
  2940.  
  2941. ΓòÉΓòÉΓòÉ 7.2.14.2. MaxAreaAdd/MaxAreaCompile ΓòÉΓòÉΓòÉ
  2942.  
  2943.  
  2944. MaxAreaAdd <fileareactl> <lev[/keys]> <acs> [<division>]
  2945. MaxAreaCompile <command>
  2946.  
  2947.     NEF is able to add new (created) areas to the Maximus
  2948.     filearea.ctl or equivalent.
  2949.  
  2950.  
  2951.     <fileareactl> is the fully qualified name of the Maximus
  2952.     file-area definition file.
  2953.  
  2954.     <lev[/keys]> protects areas of higher privilege from
  2955.     being automatically added to the Maximus configuration.
  2956.     The level and keys are to be compared to those of
  2957.     ProtArea statements and FileBone-format files.
  2958.  
  2959.     <acs> is the Maximus access string to be used in
  2960.     <fileareactl> for the new area.
  2961.  
  2962.     <division> is the optional specification of a division
  2963.     where you want to put new areas. If not specified or not
  2964.     found, the new areas will be appended at the end of
  2965.     <fileareactl>.
  2966.  
  2967.     <command> is an external command to be executed before
  2968.     NEF ends, from the Maximus system directory.
  2969.     It should be used to compile the new Maximus
  2970.     configuration via SILT/SILTP.
  2971.  
  2972.  
  2973.     The area name is taken equal to the area TAG, with dots
  2974.     changed to underscores.
  2975.  
  2976.     The area description is taken from the FileBone-format
  2977.     files if available, otherwise it is taken equal to the
  2978.     area TAG.
  2979.  
  2980.  
  2981.     Example:
  2982.  
  2983.     MaxAreaAdd d:\max\filearea.ctl 0 Transient Tic.New
  2984.     MaxAreaCompile siltp max -a -2a
  2985.  
  2986.     The new areas, will be inserted at the end of division
  2987.     "Tic.New" in the file "d:\max\filearea.ctl", with an
  2988.     access string of "Transient". Areas with protection level
  2989.     above 0 or any protection key will NOT be added to
  2990.     maximus configuration.
  2991.  
  2992.     Before terminating, NEF will invoke the SILTP compiler to
  2993.     update the area configuration. The command will be
  2994.     executed after changing the current directory to the
  2995.     Maximus system one (probably d:\max\).
  2996.  
  2997.  
  2998.  
  2999. ΓòÉΓòÉΓòÉ 7.2.14.3. FileBaseUpdate ΓòÉΓòÉΓòÉ
  3000.  
  3001.  
  3002. FileBaseUpdate
  3003.  
  3004.     Requires the MAXIMUS environment variable or the
  3005.     "MaxPrm" statement _before_ in the cfg.
  3006.  
  3007.     NEF will automatically update the filebase for all the
  3008.     areas changed when tossing/hatching new files. No more
  3009.     need to run external FBP (FB).
  3010.  
  3011.   Example:
  3012.  
  3013.     FileBaseUpdate
  3014.  
  3015.  
  3016. ΓòÉΓòÉΓòÉ 7.2.14.4. UniqueDmpLine ΓòÉΓòÉΓòÉ
  3017.  
  3018.  
  3019. UniqueDmpLine
  3020.  
  3021.     Forces the generation of FILES.DMP filebase files with
  3022.     descriptions on one line only (multiple lines are
  3023.     concatenated).
  3024.  
  3025.     By default, multi-line descriptions are output without
  3026.     changes to FILES.DMP: when using L)ocate and N)ewfiles
  3027.     commands, Maximus will respect the original formatting,
  3028.     but the continuation lines will be aligned to the left.
  3029.  
  3030.     When this statement is used, the original formatting of
  3031.     descriptions is lost (in the filebase) but Maximus will
  3032.     be able to word-wrap and align when executing L)ocate or
  3033.     N)ewfiles commands.
  3034.  
  3035.  
  3036. ΓòÉΓòÉΓòÉ 7.3. Tic Processing ΓòÉΓòÉΓòÉ
  3037.  
  3038.  
  3039.  
  3040.              TIC Processing
  3041.  
  3042.  
  3043. ΓòÉΓòÉΓòÉ 7.3.1. NoSecure ΓòÉΓòÉΓòÉ
  3044.  
  3045.  
  3046. NoSecure
  3047.  
  3048.     Disables the secure mode.
  3049.  
  3050.     When "NoSecure" is used, NEF will toss incoming files
  3051.     ignoring errors due to missing password, password
  3052.     mismatch and missing from-authorization (sender not
  3053.     linked, sender receive only).
  3054.  
  3055.     You can also use the "-t" command line switch to toggle
  3056.     between Secure and NoSecure modes.
  3057.  
  3058.     Anyway the error will be noted in the logs and <BAD>
  3059.     message report (see Announce statement).
  3060.  
  3061.   Example:
  3062.  
  3063.     NoSecure
  3064.  
  3065.  
  3066. ΓòÉΓòÉΓòÉ 7.3.2. NoReplace ΓòÉΓòÉΓòÉ
  3067.  
  3068.  
  3069. NoReplace <WSEL> ...
  3070.  
  3071.     The specified <WSEL>s indicate in which areas you do not
  3072.     want NEF to delete files specified by the "Replaces"
  3073.     keyword in inbound TICs.
  3074.  
  3075.   Example:
  3076.  
  3077.     NoReplace *   ; to avoid Replace in all areas
  3078.  
  3079.  
  3080. ΓòÉΓòÉΓòÉ 7.3.3. GetDizDesc ΓòÉΓòÉΓòÉ
  3081.  
  3082.  
  3083. GetDizDesc <WSEL> ...
  3084.  
  3085.     When tossing files, NEF will use the File_Id.Diz
  3086.     description (if available) for FILES.BBS instead of
  3087.     the Desc/LDesc lines of the inbound TIC.
  3088.  
  3089.     Requires CompressCfg
  3090.  
  3091.   Example:
  3092.  
  3093.     GetDizDesc Desc.Poor.*:/p
  3094.  
  3095.  
  3096. ΓòÉΓòÉΓòÉ 7.3.4. NoOverWrite ΓòÉΓòÉΓòÉ
  3097.  
  3098.  
  3099. NoOverWrite
  3100.  
  3101.     The tossed file will NOT overwrite an existing file of
  3102.     the same name, unless an explicit "Replaces" keyword is
  3103.     present in the incoming TIC.
  3104.  
  3105.     The situation will be handled by triggering a "BAD TIC"
  3106.     error.
  3107.  
  3108.  
  3109. ΓòÉΓòÉΓòÉ 7.3.5. CheckCRC ΓòÉΓòÉΓòÉ
  3110.  
  3111.  
  3112. CheckCRC
  3113.  
  3114.     This enables the CRC check of ingoing .TICs.
  3115.     If an ingoing .TIC has the CRC keyword, the specified
  3116.     CRC is checked against that of the relative file and an
  3117.     error is reported in case of mismatch.
  3118.     Outgoing .TICs will have the CRC only if it is present
  3119.     in the ingoing one.
  3120.     TICs originated by NEF (various Hatch modes) will always
  3121.     have the CRC keyword.
  3122.  
  3123.  
  3124. ΓòÉΓòÉΓòÉ 7.3.6. Touch ΓòÉΓòÉΓòÉ
  3125.  
  3126.  
  3127. Touch [Creation] [Write]
  3128.  
  3129.     Ingoing files are "touched" while being moved to their
  3130.     destination directory (i.e. their timestamps are set to
  3131.     NOW, so that they will be seen as new files by all the
  3132.     utilities that use the file date-time to compute the age
  3133.     of files).
  3134.  
  3135.   (OS/2)
  3136.     There are two optional parameters ("Creation" and
  3137.     "Write") that allow to configure the type of touch
  3138.     needed to best suit your environment.
  3139.  
  3140.     "Creation" -> touch the creation (upload) date
  3141.     "Write"   -> touch the last-write (modification) date
  3142.  
  3143.     You can specify either or both options.
  3144.  
  3145.     When no parameter is used, "Creation" is assumed.
  3146.  
  3147.     On FAT, the only available date (last-write) is touched
  3148.     regardless of the Touch options.
  3149.  
  3150.     On HPFS, the specified date(s) is/are touched.
  3151.  
  3152.     Usually, you do not need to specify any touch parameter,
  3153.     so that NEF touches the creation date, not the
  3154.     modification one, in order to make the files recognized
  3155.     as new by Maximus and FLM (my File List Manager) without
  3156.     changing the date that is normally shown and
  3157.     transferred: you "see" and transfer to your downlinks
  3158.     the original date of the file while Maximus and FLM are
  3159.     able to realize that the file is new.
  3160.  
  3161.     WARNING: if you use some other utility that is not smart
  3162.     enough to recognize new files from the creation date,
  3163.     you might need to specify both the "Write" and
  3164.     "Creation" options.
  3165.  
  3166.   (NT, DOS & OS/2 FAT)
  3167.     Warning: The original file timestamp is lost and the
  3168.     downlinks will receive the forwarded files with the new
  3169.     timestamps.
  3170.  
  3171.  
  3172.   Examples:
  3173.  
  3174.     Touch    ; default: touch the Creation (upload) date
  3175.     Touch Creation        ; same as default
  3176.     Touch Write         ; touch the Last Write date
  3177.     Touch Creation Write     ; touch both dates
  3178.  
  3179.  
  3180. ΓòÉΓòÉΓòÉ 7.3.7. KillDate ΓòÉΓòÉΓòÉ
  3181.  
  3182.  
  3183. KillDate Write|Creation
  3184.  
  3185.   (OS/2)
  3186.     When the -0<days> switch is used in a FileArea
  3187.     definition, this statement specifies which date must be
  3188.     used to evaluate the file age.
  3189.  
  3190.     This setting is useful for HPFS (which has separate
  3191.     Write and Creation dates) and ignored for FAT.
  3192.  
  3193.     If not specified, "Creation" is assumed.
  3194.  
  3195.     Attention: if you want to delete the files when they
  3196.     have been on your system for <days> days then you should
  3197.     choose a date that has been touched on toss (as per
  3198.     Touch statement).
  3199.  
  3200.   Examples:
  3201.  
  3202.     KillDate Write    ; Use the Write date
  3203.     KillDate Creation   ; same as default
  3204.  
  3205.  
  3206. ΓòÉΓòÉΓòÉ 7.3.8. MultiLineDesc ΓòÉΓòÉΓòÉ
  3207.  
  3208.  
  3209. MultiLineDesc <nnn> [<c>]
  3210.  
  3211.     By default, files.bbs description must be on a single
  3212.     line; this statement enables Multi-Line support.
  3213.  
  3214.     <nnn> is the number of spaces that must precede the
  3215.     continuation lines.
  3216.  
  3217.     <c> is the continuation character.
  3218.  
  3219.     If <c> is NOT specified, it is assumed that the
  3220.     continuation lines must be preceded by <nnn> spaces.
  3221.  
  3222.     If <c> IS specified, it is assumed that the continuation
  3223.     lines must be preceded by <nnn> spaces, the <c>
  3224.     character and one more space.
  3225.  
  3226.     For example, to have the 2nd and following description
  3227.     lines in files.bbs start at the 32nd column, use:
  3228.  
  3229.     MultiLineDesc 31
  3230.  
  3231.     A description in files.bbs would be like:
  3232.  
  3233.     Test.Zip This is the first description line
  3234.                     this is the 2nd line
  3235.                     this is the 3rd line
  3236.     ^               ^^
  3237.     1              31  32
  3238.  
  3239.     To have the continuation lines preceded by a '|'
  3240.     character, use:
  3241.  
  3242.     MultiLineDesc 29 |
  3243.  
  3244.     A description in files.bbs would be like:
  3245.  
  3246.     Test.Zip This is the first description line
  3247.                    | this is the 2nd line
  3248.                    | this is the 3rd line
  3249.     ^              ^  ^
  3250.     1              29  32
  3251.  
  3252.  
  3253. ΓòÉΓòÉΓòÉ 7.3.9. NewAreasPath/NewAreasFrom ΓòÉΓòÉΓòÉ
  3254.  
  3255.  
  3256.  
  3257. NewAreasPath <path>
  3258. NewAreasFrom <address> [<flags>] [<path>]
  3259.  
  3260.     <path> is the base directory for new file areas
  3261.     automatically created by NEF on reception of .TICs with
  3262.     unknown area TAGs.
  3263.  
  3264.     <address> is a 4D address that must be enabled to
  3265.     automatically create new areas.
  3266.  
  3267.     <flags> represent the <flags> that will be
  3268.     used for the newly created areas (see FileArea).
  3269.  
  3270.       I|O|* Default creation direction.
  3271.         If not used, O is assumed.
  3272.         If the tag is referenced in a FileBone file, the
  3273.         direction specified there overrides this one.
  3274.  
  3275.       -0[<days>]
  3276.       -p<acc>
  3277.       -P<acc>
  3278.       #<aka>
  3279.       @<aka>
  3280.         The specified flags will be used for the new
  3281.         FileArea statement.
  3282.  
  3283.     The <path> in "NewAreasFrom" is an override for the
  3284.     default specified in "NewAreasPath".
  3285.  
  3286.     Any number of NewAreasFrom statements can be used.
  3287.  
  3288.     While adding new areas, NEF will NOT re-order the
  3289.     existing ones, anyway it will respect an existing
  3290.     alphabetical order.
  3291.  
  3292.   Example:
  3293.  
  3294.     NewAreasPath c:\file
  3295.     NewAreasFrom 2:331/110
  3296.     NewAreasFrom 9:1/1 #9:999/999.9
  3297.     NewAreasFrom 9:2/2 -0 -P100 d:\fido\passthru\
  3298.  
  3299.     Let's suppose we have received a .TIC for area NEWAREA,
  3300.     which is not currently defined:
  3301.     - if it is coming from an address different from
  3302.      2:331/110, 9:1/1 and 9:2/2 -> an error is reported.
  3303.     - if it is coming from 2:331/110 -> a new area is
  3304.      created with path c:\file\NEWAREA.
  3305.     - if it is coming from 9:1/1 -> a new area is created
  3306.      with path c:\file\NEWAREA and it is configured so that
  3307.      NEF will use 9:999/999.9 (which must be an aka
  3308.      previously defined in an Address statement) as the
  3309.      from-address for outgoing .TICs.
  3310.     - if it is coming from 9:2/2 -> a passthru area is
  3311.      created with path d:\fido\passthru\NEWAREA and
  3312.      protected with privilege 100.
  3313.  
  3314.  
  3315. ΓòÉΓòÉΓòÉ 7.3.10. DescStart ΓòÉΓòÉΓòÉ
  3316.  
  3317.  
  3318. DescStart "<string>" <WSEL> ...
  3319.  
  3320.     This allows to add <string> at the head of files.bbs
  3321.     descriptions while tossing files from area TAGs that
  3322.     match one of the <WSEL> specifications.
  3323.  
  3324.     This statement is useful for people using download
  3325.     counters and/or maximus flags for free download.
  3326.  
  3327.   Example:
  3328.  
  3329.     DescStart "/bt [00] " 1* 2*
  3330.  
  3331.     This adds "/bt [00] " at the head of files.bbs
  3332.     descriptions while tossing files from areas whose TAG
  3333.     begins with '1' or '2'.
  3334.  
  3335.  
  3336. ΓòÉΓòÉΓòÉ 7.3.11. TagFwd ΓòÉΓòÉΓòÉ
  3337.  
  3338.  
  3339. TagFwd <OrgTag> <FwdTag> <FileSpec> [<FileSpec> ...]
  3340.  
  3341.     This allows to forward files from an area to another.
  3342.  
  3343.     <OrgTag> and <FwdTag> are area TAGs.
  3344.     <FileSpec> is a file specification that accepts the OS/2
  3345.     style wildcards (?,*).
  3346.  
  3347.     All ingoing files of area <OrgTag> which match one of
  3348.     the <FileSpec>s are forwarded to area <FwdTag>.
  3349.     This way you can split or merge areas.
  3350.  
  3351.   Example:
  3352.  
  3353.     TagFwd 1-Comm Bbs AC*n prova.*
  3354.     TagFwd 1-Data bbs *
  3355.     TagFwd 1-DITO BBS *
  3356.     TagFwd 1-Comm BBO *
  3357.     TagFwd ISNMAIN POINTLST ptlist.* ptdoc.*
  3358.  
  3359.     Files AC*n and prova.* coming from area 1-Comm and all
  3360.     the files coming from 1-Data and 1-DITO are forwarded to
  3361.     area BBS.
  3362.  
  3363.     All the files from 1-COMM are also forwarded to area
  3364.     BBO.
  3365.  
  3366.     Files ptlist.* and ptdoc.* from area ISNMAIN are
  3367.     forwarded to area POINTLST.
  3368.  
  3369.  
  3370. ΓòÉΓòÉΓòÉ 7.3.12. FeatureLoad/Feature ΓòÉΓòÉΓòÉ
  3371.  
  3372.  
  3373. FeatureLoad <DllName>
  3374.  
  3375.     (OS/2) Loads a "Feature" DLL, to allow third party
  3376.     extensions to NEF.
  3377.  
  3378.     <DllName> can be a simple filename without extension
  3379.     (".DLL" implied) if the DLL is in the LibPath, otherwise
  3380.     a fully qualified filename (extension included) can be
  3381.     specified.
  3382.  
  3383. Feature <cfgline>
  3384.  
  3385.     (OS/2) Allows to specify configuration statements that
  3386.     are to be parsed by the DLL loaded with the previous
  3387.     FeatureLoad.
  3388.  
  3389.   Note:
  3390.     Multiple FeatureLoad statements are allowed, in which
  3391.     case the Feature statements refer to the last loaded
  3392.     DLL.
  3393.  
  3394.   Example:
  3395.  
  3396.     FeatureLoad MyDll
  3397.     Feature CfgItem1 "This is Item 1"
  3398.     Feature CfgItem2 "This is Item 2"
  3399.  
  3400.  
  3401. ΓòÉΓòÉΓòÉ 7.4. Tic Announcements ΓòÉΓòÉΓòÉ
  3402.  
  3403.  
  3404.             TIC Announcements
  3405.  
  3406.  
  3407. Each announcement area is defined by a dedicated group of
  3408. statements. Many of these statements can be used before the
  3409. first announcement area definition to establish defaults to be
  3410. used in all subsequent area definitions, thus avoiding the need
  3411. to unnecessarily repeat common statements.
  3412.  
  3413.  
  3414. ΓòÉΓòÉΓòÉ 7.4.1. Global Keywords ΓòÉΓòÉΓòÉ
  3415.  
  3416.             Global Keywords
  3417.  
  3418.   Statements that can be used before area definitions to set
  3419.   defaults (please note that all these statements can be
  3420.   overridden in each area definition).
  3421.  
  3422.  
  3423. ΓòÉΓòÉΓòÉ 7.4.1.1. FromNode ΓòÉΓòÉΓòÉ
  3424.  
  3425.  
  3426. FromNode <address>
  3427.  
  3428.     This specifies the 4D address to be used as the
  3429.     from-address in the announcement messages: it is used in
  3430.     the header, in the Origin and in the MSGID. Usually, it
  3431.     should be your primary address.
  3432.  
  3433.   Example:
  3434.  
  3435.     FromNode   2:332/504.0
  3436.  
  3437.  
  3438. ΓòÉΓòÉΓòÉ 7.4.1.2. ToNode ΓòÉΓòÉΓòÉ
  3439.  
  3440.  
  3441. ToNode <address>
  3442.  
  3443.     This specifies the 4D address to be used as the
  3444.     to-address in the announcement messages: it is used in
  3445.     the header. Usually, for echo area announcements, it
  3446.     should be the same as in FromNode.
  3447.  
  3448.   Example:
  3449.  
  3450.     ToNode    2:332/504.0
  3451.  
  3452.  
  3453. ΓòÉΓòÉΓòÉ 7.4.1.3. From ΓòÉΓòÉΓòÉ
  3454.  
  3455.  
  3456. From <name>
  3457.  
  3458.     This specifies the name to be used as the from-name in
  3459.     the announcement messages. Usually it should be the
  3460.     SysOp name.
  3461.  
  3462.   Example:
  3463.  
  3464.     From     Alberto Pasquale
  3465.  
  3466.  
  3467. ΓòÉΓòÉΓòÉ 7.4.1.4. To ΓòÉΓòÉΓòÉ
  3468.  
  3469.  
  3470. To <name>
  3471.  
  3472.     This specifies the name to be used as the to-name in the
  3473.     announcement messages. Usually it should be "All".
  3474.  
  3475.   Example:
  3476.  
  3477.     To      All
  3478.  
  3479.  
  3480. ΓòÉΓòÉΓòÉ 7.4.1.5. Subj ΓòÉΓòÉΓòÉ
  3481.  
  3482.  
  3483. Subj <subject>
  3484.  
  3485.     This specifies the string to be used as the subject in
  3486.     the announcement messages.
  3487.  
  3488.   Note:
  3489.  
  3490.     If the Subj text contains the ';' character, it MUST
  3491.     be enclosed in quotes '"', otherwise it will be taken as
  3492.     the start of a comment.
  3493.  
  3494.   Examples:
  3495.  
  3496.     Subj   New Echo Files
  3497.     Subj   "New files; OS/2 BBS"
  3498.  
  3499.  
  3500. ΓòÉΓòÉΓòÉ 7.4.1.6. Attr ΓòÉΓòÉΓòÉ
  3501.  
  3502.  
  3503. Attr [P][K][C|H|D|N|O]
  3504.  
  3505.     This specifies the attributes to be used in the
  3506.     announcement messages. Usually no special attribute is
  3507.     necessary, except for private announcements in the
  3508.     netmail area.
  3509.  
  3510.     The available attributes are:
  3511.     P -> Private
  3512.     K -> Kill/Sent
  3513.     C -> Crash
  3514.     H -> Hold
  3515.     D -> Direct (equivalent to "CH")
  3516.     N -> Normal (default)
  3517.     O -> Normal (default)
  3518.  
  3519.     The required attributes can be listed in any order and
  3520.     are not case sensitive.
  3521.  
  3522.   Examples:
  3523.  
  3524.     Attr       ; no attributes
  3525.     Attr N      ; no attributes (Normal flavour)
  3526.     Attr PK     ; Private and Kill/Sent
  3527.     Attr PC     ; Private and Crash
  3528.     Attr PDK     ; Private, Direct, and Kill/Sent
  3529.  
  3530.  
  3531. ΓòÉΓòÉΓòÉ 7.4.1.7. HighAsciiOk ΓòÉΓòÉΓòÉ
  3532.  
  3533.  
  3534. HighAsciiOk
  3535.  
  3536.     Grants permission for High Ascii codes (> 127) in file
  3537.     descriptions.
  3538.  
  3539.  
  3540. ΓòÉΓòÉΓòÉ 7.4.1.8. Prefix ΓòÉΓòÉΓòÉ
  3541.  
  3542.  
  3543. Prefix <filename>
  3544.  
  3545.     This specifies the file containing the prefix text for
  3546.     announcement messages: it is put at the head of the
  3547.     message body, just before the real announcement lines.
  3548.     It should usually contain something like "New Echo Files
  3549.     Received:".
  3550.  
  3551.   Example:
  3552.  
  3553.     Prefix    d:\bbs\NEF\PREFIX.NEF
  3554.  
  3555.  
  3556. ΓòÉΓòÉΓòÉ 7.4.1.9. Suffix ΓòÉΓòÉΓòÉ
  3557.  
  3558.  
  3559. Suffix <filename>
  3560.  
  3561.     This specifies the file containing the suffix text for
  3562.     announcement messages: it is put at the end of the
  3563.     message body, just before the tear-line and the Origin.
  3564.     It should usually contain something like "File Request
  3565.     open to everybody between 06:00 and 23:00 GMT".
  3566.  
  3567.   Example:
  3568.  
  3569.     Suffix    d:\bbs\NEF\SUFFIX.NEF
  3570.  
  3571.  
  3572. ΓòÉΓòÉΓòÉ 7.4.1.10. Origin ΓòÉΓòÉΓòÉ
  3573.  
  3574.  
  3575. Origin <origin>
  3576.  
  3577.     This specifies the text to be used as the Origin in
  3578.     announcement messages. The required " * " will
  3579.     automatically be added at the head and the address at
  3580.     the end, truncating <origin> if necessary to fit the 79
  3581.     character maximum length.
  3582.     To disable the Origin (e.g. in netmail area) use an
  3583.     empty origin string.
  3584.  
  3585.   Note:
  3586.  
  3587.     If the Origin text contains the ';' character, it MUST
  3588.     be enclosed in quotes '"', otherwise it will be taken as
  3589.     the start of a comment.
  3590.  
  3591.   Examples:
  3592.  
  3593.     Origin    <ApWorks Modena I><Tel.+39-59-246112/3>
  3594.     Origin    "ApWorks Modena I; +39-59-246112/3"
  3595.     Origin    ; empty origin to disable origin generation
  3596.  
  3597.  
  3598. ΓòÉΓòÉΓòÉ 7.4.1.11. AnnExclude ΓòÉΓòÉΓòÉ
  3599.  
  3600.  
  3601. AnnExclude <filespec> ...
  3602.  
  3603.     The specified files are excluded from announcements.
  3604.  
  3605.     When this statement is used inside an announcement-area
  3606.     definition block, it specifies _additional_ exclusions
  3607.     (besides those of a global statement, if present).
  3608.  
  3609.  
  3610. ΓòÉΓòÉΓòÉ 7.4.2. Area Definition ΓòÉΓòÉΓòÉ
  3611.  
  3612.             Area Definition
  3613.  
  3614.   All the preceding statements can be used both before
  3615.   announcement area definitions (to set defaults) and inside
  3616.   each definition to override the defaults.
  3617.  
  3618.  
  3619. ΓòÉΓòÉΓòÉ 7.4.2.1. AreaTag/AreaPath ΓòÉΓòÉΓòÉ
  3620.  
  3621.  
  3622. AreaTag <Tag> [<path> [-$]]
  3623. AreaPath <path> [-$]
  3624.  
  3625.     One of these statements starts the definition of an
  3626.     announcement area.
  3627.  
  3628.     <Tag> is the area TAG, to be logged to EchoTossLog
  3629.     provided this is not a NetMail area.
  3630.  
  3631.     <path> is the directory for the *.MSG format or the full
  3632.     filename (no extension) for the Squish base.
  3633.  
  3634.     -$ specifies the use of the Squish format.
  3635.  
  3636.  
  3637.   AreaTag <Tag>
  3638.  
  3639.     This is the form to be generally used when SquishCfg is
  3640.     defined.
  3641.  
  3642.     <Tag> will be looked up in SquishCfg to find the
  3643.     corresponding path, message-base type and primary
  3644.     address.
  3645.  
  3646.     A local "FromNode" statement can be used to override the
  3647.     primary address for the area (including -p<address>
  3648.     specifications) found in SquishCfg.
  3649.  
  3650.     If this is an EchoArea, its <Tag> will be output to the
  3651.     EchoTossLog whenever a message is written to this area.
  3652.  
  3653.     If this is a NetArea, as a default, the Origin will not
  3654.     be used and the Private attribute will be set; you can
  3655.     override this with local "Origin" and "Attr" statements.
  3656.  
  3657.  
  3658.   AreaTag <Tag> <path> [-$]
  3659.  
  3660.     This is the form to be used for EchoMail areas when
  3661.     SquishCfg is not defined or you want to override its
  3662.     information AND you want <Tag> to be logged to
  3663.     EchoTossLog.
  3664.  
  3665.  
  3666.   AreaPath <path> [-$]
  3667.  
  3668.     This is the form to be used when SquishCfg is not
  3669.     defined AND you do not need to log a <Tag> to
  3670.     EchoTossLog (NetMail areas or no EchoTossLog defined).
  3671.  
  3672.   Notes:
  3673.  
  3674.     Any of the statements described above in this
  3675.     "Announcements" section can be used after the
  3676.     AreaTag/AreaPath statement to override the defaults for
  3677.     this announcement area only.
  3678.  
  3679.     Please note that you can use different AreaTag/AreaPath
  3680.     definitions with the same message area Tag/Path, in
  3681.     order to announce different file areas in different
  3682.     messages but in the same message area.
  3683.  
  3684.   Examples:
  3685.  
  3686.     AreaTag OS2BBS
  3687.     AreaTag OS2BBS d:\bbs\mail\os2bbs -$
  3688.     AreaPath d:\bbs\mail\net
  3689.  
  3690.  
  3691. ΓòÉΓòÉΓòÉ 7.4.2.2. Announce/NoAnnnouce ΓòÉΓòÉΓòÉ
  3692.  
  3693.  
  3694. Announce <WSEL> ...
  3695. NoAnnounce <WSEL> ...
  3696.  
  3697.     This defines the list of file areas to be announced in
  3698.     the current announcement message area (the one defined
  3699.     by the previous AreaTag/AreaPath statement).
  3700.  
  3701.     Multiple statements are allowed.
  3702.  
  3703.     All the areas that match one of the <WSEL>s in "Announce"
  3704.     and do not match any of the <WSEL>s in "NoAnnounce" are
  3705.     announced in the current area.
  3706.  
  3707.     Obviously you can omit the "NoAnnounce" statement if you
  3708.     do not need to exclude areas that have been included via
  3709.     the "Announce" statement.
  3710.  
  3711.     "Announce *" makes all the file areas announced.
  3712.  
  3713.   Special tags:
  3714.  
  3715.     The following "special tags" can be used in "Announce"
  3716.     or "NoAnnounce" statements as if they were normal area
  3717.     TAGs, but are not included in the "*" wildcard (i.e.
  3718.     "Announce *" does not make them announced).
  3719.  
  3720.     "<BAD>" is used to announce all the TICs that have been
  3721.     processed with some error.
  3722.  
  3723.     "<DEF>" is used to announce all the files that have not
  3724.     been announced elsewhere. A separate announcement is
  3725.     generated after all other announcements have been
  3726.     completed, even if "<DEF>" is listed together with other
  3727.     TAGs.
  3728.  
  3729.     "<OUT>" is used to make a concise outbound report when
  3730.     the OUT or OUTVIEW command line option is used.
  3731.     Subj, Prefix and Suffix are ignored.
  3732.  
  3733.     "<OUTVIEW>" is used to make a detailed outbound report
  3734.     when the OUT or OUTVIEW command line option is used.
  3735.     Subj, Prefix and Suffix are ignored.
  3736.  
  3737.     "<THRU>" represents all passthru areas. If you want to
  3738.     keep NEF from announcing files received in PassThru
  3739.     areas, just use "NoAnnounce <THRU>".
  3740.  
  3741.   Examples:
  3742.  
  3743.     Announce UTILNET SOFTDIST SDS*
  3744.     NoAnnounce SDSOTH <THRU>
  3745.  
  3746.     This announces the file areas with tag "UTILNET",
  3747.     "SOFTDIST" and all those whose TAG starts with "SDS" but
  3748.     not "SDSOTH" or passthru areas.
  3749.  
  3750.     Announce PRIVFILE <BAD> <DEF>
  3751.  
  3752.     This announces area "PRIVFILE" and all the TICs that
  3753.     have been processed with errors; at the end, in a
  3754.     separate message, it announces the files that have not
  3755.     been announced elsewhere.
  3756.  
  3757.     Announce SPECIAL <OUT>
  3758.  
  3759.     This announces the file area with tag "SPECIAL"; at the
  3760.     end, in a separate message, it creates a concise report
  3761.     of the outbound.
  3762.  
  3763.     Announce SPECIAL <OUTVIEW>
  3764.  
  3765.     This announces the file area with tag "SPECIAL"; at the
  3766.     end, in a separate message, it creates a verbose report
  3767.     of the outbound.
  3768.  
  3769.  
  3770. ΓòÉΓòÉΓòÉ 7.4.3. Announce example ΓòÉΓòÉΓòÉ
  3771.  
  3772.  
  3773.  
  3774.   Complete example of the announcement definition section,
  3775.   SquishCfg defined:
  3776.  
  3777. ----------------------------------------------------------------
  3778.  
  3779.  ; Defaults definition
  3780.  
  3781.   FromNode   2:332/504.0
  3782.   ToNode    2:332/504.0
  3783.   From     Alberto Pasquale
  3784.   To      All
  3785.   Subj     New Echo Files
  3786.   Attr
  3787.   Prefix    PREFIX.NEF
  3788.   Origin    ApWorks Modena I (+39-59-246112/3)
  3789.   Suffix    SUFFIX.NEF
  3790.  
  3791.  ; Announcement areas: each statement is local to the preceding
  3792.  ; AreaTag and overrides the default one.
  3793.  
  3794.   AreaTag    APWORKS
  3795.   Announce   APBBS*
  3796.   Prefix    RelPre.NEF
  3797.   Subj     New ApWorks files
  3798.  
  3799.   AreaTag    OS2BBS
  3800.   Announce   APBBS*
  3801.   NoAnnounce  *DOS*
  3802.   Prefix    RelPre.NEF
  3803.   Subj     New APBBS files
  3804.  
  3805.   AreaTag    LOCAL_332.504
  3806.   Announce   *:100/f
  3807.   AnnExclude  NODE*
  3808.   Subj     New Files on ApWorks
  3809.  
  3810.   AreaTag    NETMAIL
  3811.   Announce   <OUTVIEW> <DEF>
  3812.   From     NEF
  3813.   To      Alberto Pasquale
  3814.   Subj     Not Announced Elsewhere
  3815.   HighAsciiOk
  3816.  
  3817.   AreaTag    NETMAIL
  3818.   Announce   <BAD>
  3819.   From     NEF
  3820.   To      Alberto Pasquale
  3821.   ToNode    2:332/504.1
  3822.   Subj     Processed with Errors
  3823.  
  3824. ----------------------------------------------------------------
  3825.  
  3826.   Complete example of the announcement definition section,
  3827.   SquishCfg NOT defined:
  3828.  
  3829. ----------------------------------------------------------------
  3830.  
  3831.  ; Defaults definition
  3832.  
  3833.   FromNode   2:332/504.0
  3834.   ToNode    2:332/504.0
  3835.   From     Alberto Pasquale
  3836.   To      All
  3837.   Subj     New Echo Files
  3838.   Attr
  3839.   Prefix    PREFIX.NEF
  3840.   Origin    <ApWorks Modena I><Tel.+39-59-246112/3>
  3841.   Suffix    SUFFIX.NEF
  3842.  
  3843.  ; Announcement areas: each statement is local to the preceding
  3844.  ; AreaPath and overrides the default one.
  3845.  
  3846.   AreaTag    SWN_332.500 d:\msg\swn -$
  3847.   Announce   UTILNET
  3848.   Subj     UTILNET file news
  3849.  
  3850.   AreaTag    SWN_332.500 d:\msg\swn -$
  3851.   Announce   *:100/f SDS* ECHO-* FTSC NEWSLETR
  3852.   NoAnnounce  ECHO-R*
  3853.   Subj     SDS/NEWS file news
  3854.  
  3855.   AreaPath   d:\msg\net -$   ; Netmail to the SysOp
  3856.   Announce   NODE* POINTLST <BAD> <DEF> <OUTVIEW>
  3857.   From     NEF
  3858.   To      Alberto Pasquale
  3859.   ToNode    2:332/504.1
  3860.   Subj     Reserved file news
  3861.   Attr     PK    ; This must be private and kill/sent
  3862.   Origin        ; No Origin for netmail !
  3863.  
  3864. ----------------------------------------------------------------
  3865.  
  3866.  
  3867. ΓòÉΓòÉΓòÉ 7.5. FileFix Link Robot ΓòÉΓòÉΓòÉ
  3868.  
  3869.  
  3870.  
  3871.             FileFix Link Robot
  3872.  
  3873.  
  3874. It's the traditional "Raid" or "TicFix" function: it allows
  3875. downlinks (but also special uplinks) to link/unlink file areas
  3876. via a netmail message.
  3877.  
  3878. The message should have the agreed password as the subject,
  3879. possibly followed by some switch.
  3880. The required password is that defined in the "FileLink"
  3881. statement described below.
  3882.  
  3883. The body of the message contains the commands.
  3884. There can be several commands on a single line provided they are
  3885. separated by blanks.
  3886.  
  3887. Password, switches and commands are case insensitive.
  3888.  
  3889. Switches that can be used in the subject, after the password,
  3890. only the _first_ letter is required (and checked):
  3891.  
  3892.   -Help      Help.
  3893.   -Query      List all areas (linked and available).
  3894.   -Linked     List linked areas.
  3895.   -Unlinked    List unlinked areas.
  3896.  
  3897.  
  3898. The commands available for the message body are:
  3899.  
  3900.   [+]<WTAG>
  3901.     Links all the areas whose TAG matches <WTAG>.
  3902.     The '+' character is optional (useful in the case <WTAG>
  3903.     starts with the '-' character).
  3904.  
  3905.   -<WTAG>
  3906.     Unlinks all the areas whose TAG matches <WTAG>.
  3907.  
  3908.   %Help     same as -h
  3909.   %Query    same as -q
  3910.   %List     same as -q
  3911.   %Linked    same as -l
  3912.   %Unlinked   same as -u
  3913.  
  3914.   Note: you can use the '?' character in the place of '%'.
  3915.   This is useful when using the FileFix command line option,
  3916.   to avoid that the command line interpreter takes the '%'
  3917.   as the start of an environment variable name.
  3918.  
  3919. Example:
  3920.  
  3921.     From: John Doe of 2:332/580.0
  3922.     To:  Nef    of 2:332/504.0
  3923.     Subj: Secret -H
  3924.     -----------------------------
  3925.     %Query
  3926.     1* -1-COMM
  3927.     +2*
  3928.     -2-WINDOW
  3929.     ---
  3930.  
  3931.     The Help and Query commands are invoked, all areas whose
  3932.     tag begins with '1' are linked, area "1-COMM" is
  3933.     unlinked, all areas whose tag begins with '2' are linked
  3934.     and area "2-WINDOW" is unlinked.
  3935.  
  3936. Notes:
  3937.     The actual order of command execution is based on the
  3938.     area definition order. NEF scans the defined areas from
  3939.     the first to the last one only once, applying for each
  3940.     area all the pertinent commands.
  3941.  
  3942.     If a link in a FileArea statement is not properly
  3943.     defined in a FileLink one, it is removed when the
  3944.     Link Robot re-writes that FileArea statement in
  3945.     execution of an Add or Delete command.
  3946.  
  3947.     While re-writing areas, the Link Robot will NOT re-order
  3948.     the links. However it will respect an existing order
  3949.     while adding new links.
  3950.  
  3951.     If Area aka overrides are used, they are reported by
  3952.     Area-List commands.
  3953.  
  3954.  
  3955. ΓòÉΓòÉΓòÉ 7.5.1. AutoLink ΓòÉΓòÉΓòÉ
  3956.  
  3957.  
  3958.  
  3959. AutoLink <name>
  3960.  
  3961.     The robot will answer to the messages addressed to one
  3962.     of the addresses defined in the "system" section and to
  3963.     one of the names defined in the AutoLink statements.
  3964.     You can use as many AutoLink statements as you need to
  3965.     define all the akas you like.
  3966.     If no AutoLink statement is used, then the Link Robot is
  3967.     disabled.
  3968.  
  3969.   Example:
  3970.  
  3971.     AutoLink NEF
  3972.     AutoLink Raid
  3973.     AutoLink TicFix
  3974.  
  3975.  
  3976. ΓòÉΓòÉΓòÉ 7.5.2. NetMail ΓòÉΓòÉΓòÉ
  3977.  
  3978.  
  3979. NetMail <path> [-$] [-p<adr>]
  3980.  
  3981.     This defines a netmail area to be searched for messages
  3982.     addressed to the robot. You can use as many NetMail
  3983.     statements as you need.
  3984.  
  3985.     The optional -$ indicates a Squish format area.
  3986.  
  3987.     The optional "-p<adr>" specifies the primary (default)
  3988.     address for the area.
  3989.  
  3990.     When multiple NetMails are defined, NEF needs <adr> to
  3991.     choose (via zone matching) the right area where to write
  3992.     the messages addressed to the FileBone's "FileFix" robot.
  3993.  
  3994.     Usually all but the first netmail statements should
  3995.     contain a primary address specification.
  3996.  
  3997.     Note: when a Squish base is used, a pointer to the last
  3998.     scanned message is stored in <path>.NEF, so that next
  3999.     scan will consider new messages only.
  4000.  
  4001.   Example:
  4002.  
  4003.     NetMail d:\msg\fidonet -$        ; default
  4004.     NetMail d:\msg\os2net  -$ -p89:456/789 ; OS2Net
  4005.  
  4006.  
  4007. ΓòÉΓòÉΓòÉ 7.5.3. KillReceived ΓòÉΓòÉΓòÉ
  4008.  
  4009.  
  4010.  
  4011. KillReceived
  4012.  
  4013.     This keyword instructs NEF to kill messages addressed to
  4014.     the Link Robot after the execution of the contained
  4015.     commands. When commented out, the messages are marked as
  4016.     received instead of being erased.
  4017.  
  4018.  
  4019. ΓòÉΓòÉΓòÉ 7.5.4. AreaDescWrap ΓòÉΓòÉΓòÉ
  4020.  
  4021.  
  4022. AreaDescWrap <indent> <right>
  4023.  
  4024.     The descriptions returned by the "FileFix" functions
  4025.     will be word-wrapped so that continuation lines start
  4026.     with <indent> spaces and do not exceed column <right>.
  4027.  
  4028.   Example:
  4029.  
  4030.     AreaDescWrap 25 79
  4031.  
  4032.  
  4033. ΓòÉΓòÉΓòÉ 7.5.5. HelpFile ΓòÉΓòÉΓòÉ
  4034.  
  4035.  
  4036. HelpFile <filename>
  4037.  
  4038.     This keyword defines the file to be put into the Link
  4039.     Robot's answer in reply to a Help request.
  4040.  
  4041.     Usually this file contains instructions for using the
  4042.     Link Robot.
  4043.  
  4044.   Example:
  4045.  
  4046.     HelpFile d:\bbs\nef\NefHelp.Txt
  4047.  
  4048.  
  4049. ΓòÉΓòÉΓòÉ 7.5.6. ProtArea ΓòÉΓòÉΓòÉ
  4050.  
  4051.  
  4052. ProtArea <WTAG> <ACS>
  4053.  
  4054.     This keyword allows to selectively protect areas from
  4055.     automatic linking. Unlinking is always possible.
  4056.  
  4057.     The protection scheme is based on the traditional
  4058.     combination of level and keys.
  4059.  
  4060.     <WTAG>  specifies the TAG or group of TAGs to be
  4061.         protected.
  4062.     <ACS>  is the access privilege required for access.
  4063.  
  4064.     When processing an area TAG, NEF scans the ProtArea
  4065.     statements from the first one to the last one: the first
  4066.     matching <WTAG> determines the protection level and
  4067.     keys. If no match is found then the area gains maximum
  4068.     protection.
  4069.  
  4070.     Usually it's convenient to override the default maximum
  4071.     protection so that you can list only a few special areas
  4072.     with their protection level and keys while letting all
  4073.     the others get a default NULL protection (automatic
  4074.     linking for everybody). To accomplish this result, you
  4075.     can use a "ProtArea * 0" as the last ProtArea statement.
  4076.  
  4077.     Please, note that the order of the ProtArea statements is
  4078.     _essential_, since they area scanned from the first one
  4079.     to the last one in search for a match between the TAG in
  4080.     examination and the <WTAG> of the ProtArea statements.
  4081.  
  4082.   Example:
  4083.  
  4084.     ProtArea PRIVATE  1000/12ABC  ; Protected private area
  4085.  
  4086.     ProtArea 1*    100/P    ; Areas starting with '1'
  4087.                    ; are not for everybody.
  4088.  
  4089.     ProtArea *     0      ; The remaining areas are
  4090.                    ; for everybody.
  4091.  
  4092.  
  4093. ΓòÉΓòÉΓòÉ 7.5.7. FileBone Support ΓòÉΓòÉΓòÉ
  4094.  
  4095.  
  4096.             FileBone Support
  4097.  
  4098.  
  4099. NEF is able to use information distributed via the FileBone.Na
  4100. and FileBone.No files.
  4101.  
  4102. Many useful functions are allowed by the use of these files, so,
  4103. even if you do not receive them from your uplink, you could
  4104. evaluate the possibility of creating "FileBone-style" files on
  4105. your own, just to store some information that can be retrieved
  4106. by NEF.
  4107.  
  4108. When FileBone-style files are used:
  4109.  
  4110. - The Query command reports the areas available on the FileBone,
  4111.  in addition to those that are not linked to the downlink but
  4112.  already available on the local system.
  4113.  
  4114. - Area descriptions can be returned by FileFix commands.
  4115.  
  4116. - Level and Keys protect areas from "FileFix" linking.
  4117.  A node is entitled to add an area only if it has level and
  4118.  keys that match the requirements from BOTH the "ProtArea"
  4119.  statements in Nef.Cfg and the <lev>[/<keys>] specification
  4120.  in a FileBone format file (if available).
  4121.  
  4122. - Requests for unlinked areas can be forwarded to the FileBone.
  4123.  
  4124.  The requests that have been forwarded to some uplink are
  4125.  stored in a file named after the configuration one, changing
  4126.  the extension to ".Fwd". Usually the configuration file is
  4127.  "Nef.Cfg", so the forwarded requests will be stored in
  4128.  "Nef.Fwd".
  4129.  
  4130.  The format is: <Tag> <Addr>, i.e. every line contains a Tag
  4131.  followed by the 4D Address of the downlink that made the
  4132.  request.
  4133.  
  4134.  When a new area is created, NEF looks into this file in order
  4135.  to find nodes to be added to the new "FileArea" definition.
  4136.  
  4137.  If a requested (and not yet defined) Tag is found in two or
  4138.  more FileBone files, the request is forwarded to the uplink
  4139.  defined in the first FileBone statement only.
  4140.  
  4141.  Don't mind if the Nef.Fwd file contains multiple entries for
  4142.  the same Tag. This can happen when multiple requests for the
  4143.  same area have been received. When the first file comes in
  4144.  and the area is created, all entries will be deleted while
  4145.  the link will be added once.
  4146.  
  4147.  
  4148. ΓòÉΓòÉΓòÉ 7.5.7.1. FileBone ΓòÉΓòÉΓòÉ
  4149.  
  4150.  
  4151. FileBone <file> [<acc>] [<fm> <to> <toadr> <fwdacc> [<pre>]]
  4152.  
  4153.     Multiple FileBone statements are allowed; in the case of
  4154.     duplicate TAGs, the first encountered entry is used.
  4155.  
  4156.     <file> is the filename of the FileBone-style file.
  4157.  
  4158.     <acc> is a <ACS> specification that protects the areas
  4159.        listed in <file>.
  4160.  
  4161.     If you want to enable the forward of requests for new
  4162.     areas from your downlinks to your uplink(s), you must
  4163.     specify the following fields (to be enclosed between
  4164.     quotes when containing space) so that they can be used
  4165.     to write netmail messages to your uplink's FileFix:
  4166.  
  4167.     <fm> is the "from" name.
  4168.  
  4169.     <to> is the "to" name.
  4170.  
  4171.     <toadr> is the "to" 4D address.
  4172.  
  4173.     <fwdacc> is a <ACS> specification, to limit the access
  4174.        of downlinks to request forwards addressed to
  4175.        <toadr> for the areas described in <file>.
  4176.  
  4177.     <pre> is an optional string to be prefixed to the area
  4178.        Tags that are being requested.
  4179.  
  4180.   Examples:
  4181.  
  4182.     FileBone \bbs\FileBone.Na "John Doe" SysOp 2:332/1 0
  4183.  
  4184.     The "\bbs\FileBone.Na" file is used by NEF, also for
  4185.     request forwards.
  4186.  
  4187.     When a downlink requests an area that is not currently
  4188.     defined in the NEF configuration (usually TicArea.Cfg)
  4189.     but is described in FileBone.Na, a netmail message is
  4190.     written by NEF from "John Doe" to "SysOp" of 2:332/1
  4191.     using the appropriate "from address" aka and "subject"
  4192.     (password) as per the "FileLink" definition of 2:332/1.
  4193.     The body contains a list of the requested area Tags, one
  4194.     per line.
  4195.  
  4196.     No (<acc> = "0") protection is specified (any downlink
  4197.     has access to request forwards).
  4198.  
  4199.  
  4200.     FileBone \bbs\FB.SP 10/f "John Doe" SysOp 2:332/1 30/a +
  4201.  
  4202.     The visibility of FB.SP information is limited to
  4203.     filelinks having level equal or above 10 and the 'f'
  4204.     key.
  4205.  
  4206.     The access to request forwards is limited to filelinks
  4207.     having level equal or above 30 and the 'a' key.
  4208.  
  4209.     The requested tags will be preceded by "+".
  4210.  
  4211.     If you need a space between the '+' and the tag, then you
  4212.     must specify a <pre> that contains a space, so you have
  4213.     to enclose it in quotes:
  4214.  
  4215.     FileBone \bbs\FB.SP "John Doe" SysOp 2:332/1 0 "+ "
  4216.  
  4217.  
  4218. ΓòÉΓòÉΓòÉ 7.5.7.1.1. FileBone Format ΓòÉΓòÉΓòÉ
  4219.  
  4220.             FileBone Format
  4221.  
  4222. The format for the filebone style is:
  4223.  
  4224.  Area <Tag> <lev>[/<keys>] <flags> <desc>
  4225.  
  4226.  <Tag>
  4227.      is the TIC area Tag.
  4228.      The original filebone format allows 8 character
  4229.      maximum but NEF is not that limited.
  4230.  
  4231.  <lev>
  4232.      is the protection level of the area, for "FileFix"
  4233.      functions.
  4234.      The original format allows the range 0-4095 while NEF
  4235.      allows 0-65535.
  4236.  
  4237.  <keys>
  4238.      are a set of protection keys (1..8, A..X).
  4239.      Not available in the original FileBone format.
  4240.  
  4241.  <flags>
  4242.     is a combinaton of !.*& and possibly other characters.
  4243.  
  4244.     By default (no flags) the area is uni-directional, from
  4245.     the uplink to the defined downlinks.
  4246.  
  4247.     ! : Can be found at any Filebone Hub.
  4248.     . : Only on some Filebone Hubs.
  4249.     * : Any node can hatch into.
  4250.     & : Do not send to downlinks.
  4251.  
  4252.   Others : Private distribution.
  4253.  
  4254.   Examples:
  4255.  
  4256.     !
  4257.       normal area from the uplink to its downlinks,
  4258.       available on all Filebone Hubs.
  4259.  
  4260.    !*&
  4261.       return channel from the downlinks to the
  4262.       uplink, available on all Filebone Hubs.
  4263.  
  4264.     .*
  4265.       bidirectional area (any node can hatch into),
  4266.       available on some Filebone hubs only.
  4267.  
  4268.  
  4269.  <desc>
  4270.     is the description for the area.
  4271.  
  4272.  
  4273.  Example:
  4274.  
  4275.  Area APBBS   0  P ApWorks OS/2 BBS programs
  4276.  Area NODEDIFF 0/f ! FidoNet: Weekly NodeList Updates
  4277.  
  4278.  
  4279. ΓòÉΓòÉΓòÉ 7.5.7.2. ForwardWildReq ΓòÉΓòÉΓòÉ
  4280.  
  4281.  
  4282. ForwardWildReq
  4283.  
  4284.     When a FileFix "Add" request contains wildcards, by
  4285.     default it is NOT forwarded to the filebone.
  4286.     This verb enables even this type of request forward.
  4287.  
  4288.  
  4289. ΓòÉΓòÉΓòÉ 7.6. Link Definitions ΓòÉΓòÉΓòÉ
  4290.  
  4291.  
  4292.             Link Definitions
  4293.  
  4294.  
  4295. The FileLink statement is used to define a link, specifying its
  4296. password, attributes and privileges.
  4297.  
  4298. The FileArea statement is used to define a file area, specifying
  4299. its type and the list of connected systems (that must be defined
  4300. via FileLink statements).
  4301.  
  4302.  
  4303. ΓòÉΓòÉΓòÉ 7.6.1. FileLink ΓòÉΓòÉΓòÉ
  4304.  
  4305.  
  4306. FileLink <address> <password> [#<address>] <flags>
  4307.      [<attr> [<ACS> [<WSEL> ...]]]
  4308.  
  4309.     The parameters of this keyword have been represented on
  4310.     two lines because of space, but they MUST be listed on a
  4311.     unique line in the .cfg file.
  4312.  
  4313.     This keyword defines a file link; you must use a
  4314.     FileLink statement for each of your links (both
  4315.     downlinks and uplinks).
  4316.  
  4317.  
  4318.     <address>
  4319.           is the 4D address of the link.
  4320.  
  4321.     <password>
  4322.           is the case insensitive password to be used
  4323.           for all TIC exchanges and for the Link Robot
  4324.           function. NEF has no limit for the password
  4325.           length, anyway you should be aware that other
  4326.           similar programs might have limits, so check
  4327.           with your downlink/uplink before choosing a
  4328.           long password (8 characters should be OK for
  4329.           everyone).
  4330.  
  4331.     #<address>
  4332.           This optional field indicates a "from" 4D
  4333.           address to be used for the .TICs sent to this
  4334.           link (overrides the zone-match and is in turn
  4335.           overriden by the area override (see
  4336.           "FileArea")).
  4337.  
  4338.     <flags>
  4339.           This field is a (case insensitive) set of
  4340.           characters:
  4341.  
  4342.           <H|C|D|N|F>[<S|T>][<I|O|*>][Y].
  4343.  
  4344.           It can be 1 to 4 characters long:
  4345.  
  4346.          - The first flag is mandatory; it defines the
  4347.           flavour of the file-attaches that NEF will
  4348.           create for .TIC and associated files.
  4349.  
  4350.           Please note that this flag can be overridden
  4351.           on a per-area basis by prefixing the link
  4352.           address with a new flavour-flag in the
  4353.           FileArea statement.
  4354.  
  4355.           The available choices for this flag and the
  4356.           consequent file-attach extension follow:
  4357.  
  4358.           H -> .HLO (Hold)
  4359.           C -> .CLO (Crash)
  4360.           D -> .DLO (Direct)
  4361.           F -> .FLO (Normal)
  4362.           N -> .FLO (Normal)
  4363.  
  4364.           The 'N' flag is provided for "compatibility",
  4365.           but it's the same as 'F'.
  4366.  
  4367.          - The second flag is optional: it defines
  4368.           whether NEF must send a .TIC together with
  4369.           the file or not.
  4370.  
  4371.           S -> .TIC sent (default).
  4372.           T -> .TIC not sent.
  4373.  
  4374.           Usually the default is used (this flag can be
  4375.           omitted), but sometimes points like not
  4376.           receiving the .TIC file.
  4377.  
  4378.           Please note that this flag can be overridden
  4379.           on a per-area basis by prefixing the link
  4380.           address with a new flag in the FileArea
  4381.           statement.
  4382.  
  4383.          - The third flag is optional. It is provided
  4384.           for completeness and it is sometimes very
  4385.           handy, but it is recommended not to use it
  4386.           too often since its use might unnecessarily
  4387.           complicate the interpretation of the
  4388.           configuration.
  4389.  
  4390.           It defines whether this link has
  4391.           bidirectional access to file areas or not.
  4392.  
  4393.           This is an override to the "area direction"
  4394.           field of each FileArea definition.
  4395.  
  4396.           Please note that this flag can be overridden
  4397.           on a per-area basis by prefixing the link
  4398.           address with a new flag in the FileArea
  4399.           statement.
  4400.  
  4401.           I -> Only Input is allowed from this link.
  4402.             NEF will not send files.
  4403.           O -> Only output is allowed to this link.
  4404.             NEF will not accept files.
  4405.           * -> Bidirectional link.
  4406.  
  4407.          - The fourth flag ('Y') is optional.
  4408.           It defines the systems that will be notified
  4409.           when a "Nef Notify" command is issued, with
  4410.           no address list.
  4411.  
  4412.     <attr>
  4413.           These are the (case insensitive) attributes
  4414.           for the Link Robot's netmail replies:
  4415.  
  4416.           K -> Kill/Sent
  4417.           C -> Crash
  4418.           H -> Hold
  4419.           D -> Direct (equivalent to "CH")
  4420.           N -> Normal (default)
  4421.           O -> Normal (default)
  4422.  
  4423.           The Private attribute is always implied.
  4424.  
  4425.           ATTENTION: you should usually use the 'H'
  4426.           attribute for file links that are not netmail
  4427.           links too. Otherwise the "Normal" flavoured
  4428.           netmail replies will be routed as per your
  4429.           routing configuration instead of being held
  4430.           for the file link.
  4431.  
  4432.     <ACS>
  4433.           Represents the access level to the Link Robot
  4434.           for this node.
  4435.  
  4436.           Defaults to 0.
  4437.  
  4438.     <WSEL>
  4439.           The optional list of <WSEL>s specifies the
  4440.           areas that must be automatically linked to
  4441.           this node when they are automatically created
  4442.           by NEF.
  4443.  
  4444.           New areas can be automatically created when
  4445.           unknown TAGs are found in ingoing .TICs (see
  4446.           "NewAreasFrom" above in this reference).
  4447.           You can make NEF automatically link the
  4448.           downlink to the areas that match the <WSEL>
  4449.           specification(s).
  4450.  
  4451.  
  4452.   Examples:
  4453.  
  4454.  
  4455.    - FileLink 2:332/593 pwd593 INY
  4456.  
  4457.     Node 2:332/593 has password "pwd593", is enabled to send
  4458.     .TICs to us ('I'), the file attaches addressed to it
  4459.     (if any) will be normal flavoured ('N') and a
  4460.     notification message will be issued when "Nef Notify" is
  4461.     executed ('Y').
  4462.  
  4463.     Note that file attaches to this node will only be
  4464.     possible if a local area override will be used, since
  4465.     the 'I' flag instructs NEF to accept files from the node
  4466.     but not to send to it.
  4467.  
  4468.     Nothing is specified about the Link Robot's reply flags
  4469.     and access level and keys, so this node will be able to
  4470.     link only areas with protection level 0 and no keys; the
  4471.     Robot's reply will be normal flavoured.
  4472.  
  4473.    - FileLink 2:331/196.1 pwd1961 H NK 300/ab
  4474.  
  4475.     Node 2:331/196.1 has password "pwd1961", nothing is
  4476.     specified about link direction (it will depend on the
  4477.     "area direction" and local overrides), the file attaches
  4478.     will be Hold flavoured ('H'), the reply netmails will be
  4479.     normal flavoured ('N') and kill/sent ('K'), the access
  4480.     level is 300 and the access keys are a,b.
  4481.  
  4482.    - FileLink 2:332/1 pwd1 #2:332/500 H N 900/ab :/f *OS2*
  4483.  
  4484.     Node 2:332/1 has password "pwd1", all the TICs sent to
  4485.     this node will use the from-address 2:332/500 (provided
  4486.     there is no aka override at the "FileArea" level), the
  4487.     file attaches will be Hold flavoured ('H'), the netmail
  4488.     replies will be normal flavoured ('N'), the access level
  4489.     is 900 and the access keys a,b.
  4490.  
  4491.     New areas accessible with the f key or whose TAG
  4492.     contains "OS2" will be automatically linked when they
  4493.     are created by NEF.
  4494.  
  4495.  
  4496. ΓòÉΓòÉΓòÉ 7.6.2. FileArea ΓòÉΓòÉΓòÉ
  4497.  
  4498.  
  4499. FileArea <TAG> <path> I|O|* [<areaflags>] [[<flags>]<link> ...]
  4500.  
  4501.     This keyword defines an echo file area.
  4502.  
  4503.     If you have a small system, you can put the area
  4504.     definitions in the main configuration file (e.g.
  4505.     NEF.CFG). For systems with a large number of areas and
  4506.     links, it is recommended to use a separate file for the
  4507.     area definitions: see the "TicAreaCfg" keyword, formerly
  4508.     discussed in this documentation.
  4509.  
  4510.     ATTENTION: when using the "TicAreaCfg" separate file,
  4511.     you must put ALL the FileArea statements in that file.
  4512.     You are not allowed to put area definitions both in the
  4513.     main .cfg file and in the dedicated TicAreaCfg file at
  4514.     the same time !
  4515.  
  4516.     Please note that all the FileArea statements, if
  4517.     included in the main .cfg file, MUST be defined _after_
  4518.     the FileLink statements.
  4519.  
  4520.     <TAG> is the area TAG.
  4521.  
  4522.     <path> is the directory for the file area.
  4523.  
  4524.     I|O|*  is the (case insensitive) "area direction" and
  4525.         defines the default direction for the area:
  4526.  
  4527.       'I'
  4528.          we accept files from the listed nodes but do
  4529.          not send to them, unless an override flag is
  4530.          present before the <link> or in the pertinent
  4531.          "FileLink" definition.
  4532.  
  4533.          This should usually be used for "pre" areas, in
  4534.          which files must be collected from downlinks
  4535.          and sent to the area coordinator via the
  4536.          uplink, which will probably need a local 'O'
  4537.          override.
  4538.  
  4539.       'O'
  4540.          we send files to the listed nodes but do not
  4541.          accept from them, unless an override flag is
  4542.          present before the <link> or in the pertinent
  4543.          "FileLink" definition.
  4544.  
  4545.          This should usually be used for areas that must
  4546.          be distributed to downlinks. The uplink will
  4547.          need a local 'I' override before its <link>
  4548.          field or a global one in its FileLink
  4549.          definition.
  4550.  
  4551.       '*'
  4552.          the area is bidirectional, so we both send and
  4553.          accept files to/from the listed nodes, unless
  4554.          an override flag is present before the <link>
  4555.          or in the pertinent "FileLink" definition.
  4556.  
  4557.          This should be used for bidirectional areas, in
  4558.          which everybody is allowed to "hatch" files.
  4559.  
  4560.  
  4561.     <areaflags> is one or more of:
  4562.  
  4563.       -0[<days>]
  4564.          When the "-0" (zero) is specified, the area is
  4565.          "Passthru", that is its files will be deleted
  4566.          when already sent to all the downlinks. Please
  4567.          note that ANY file (apart from FILES.*) present
  4568.          in the <path> and not attached to any system
  4569.          will be deleted.
  4570.  
  4571.          If the optional <days> parameter is used, the
  4572.          files will not be deleted until they become
  4573.          older than <days> _AND_ not referenced by any
  4574.          file attach.
  4575.  
  4576.          <days> is an integer <= 65535.
  4577.  
  4578.          Please note that you can use the Touch and
  4579.          KillDate statements to control the date used to
  4580.          evalutate the file age.
  4581.  
  4582.          NEF must be explicitly instructed to delete the
  4583.          old files in passthru areas, usually in some
  4584.          maintenance event.
  4585.  
  4586.          See also the "-p" and "CLEAN" command line
  4587.          options.
  4588.  
  4589.  
  4590.       #<address>
  4591.          Primary address override for this area (highest
  4592.          priority aka).
  4593.  
  4594.          This address will be used as "from" address
  4595.          regardless of the other aka specifications.
  4596.  
  4597.       @<address>
  4598.          Primary address default for this area (lowest
  4599.          priority aka).
  4600.  
  4601.          If no aka specification is applicable, this
  4602.          address will be used.
  4603.          Essentially useful to control the "Origin"
  4604.          address of Hatched files without losing the
  4605.          multi-aka features.
  4606.  
  4607.          The akas specified in "FileLink" definitions
  4608.          and the automatic zone-match will operate
  4609.          normally.
  4610.  
  4611.  
  4612.       -P<ACS>
  4613.          Protection level for the area (Override).
  4614.  
  4615.          The specified access level and keys will be
  4616.          used, regardless of other protection
  4617.          specifications.
  4618.  
  4619.       -p<ACS>
  4620.          Protection level for the area (additional).
  4621.  
  4622.          The specified access level and keys will
  4623.          protect the area, in addition to possible
  4624.          restrictions specified in ProtArea and FileBone
  4625.          statements.
  4626.  
  4627.  
  4628.     The list of linked nodes follows; each node can have
  4629.     some <flags> attached before the node address. The
  4630.     available flags are the same as for the <flags> field in
  4631.     the "FileLink" statement.
  4632.  
  4633.     <flags>
  4634.           This is an optional (case insensitive) field
  4635.           made up of 1 to 3 characters:
  4636.           [H|C|D|N|F][S|T][I|O|*].
  4637.  
  4638.          - The first flag defines the flavour of the
  4639.           file-attaches that NEF will create for .TIC
  4640.           and associated files.
  4641.  
  4642.           Please note that this flag overrides that in
  4643.           the pertinent "FileLink" statement.
  4644.  
  4645.           The available choices for this flag and the
  4646.           consequent file-attach extension follow:
  4647.  
  4648.           H -> .HLO (Hold)
  4649.           C -> .CLO (Crash)
  4650.           D -> .DLO (Direct)
  4651.           F -> .FLO (Normal)
  4652.           N -> .FLO (Normal)
  4653.  
  4654.           The 'N' flag is provided for "compatibility",
  4655.           but it's the same as 'F'.
  4656.  
  4657.          - The second flag defines whether NEF must send
  4658.           a .TIC together with the file or not.
  4659.  
  4660.           S -> .TIC sent.
  4661.           T -> .TIC not sent.
  4662.  
  4663.           Please note that this flag overrides that in
  4664.           the pertinent "FileLink" statement.
  4665.  
  4666.          - The third flag defines the direction of the
  4667.           link.
  4668.  
  4669.           Please note that this flag overrides that in
  4670.           the pertinent "FileLink" statement, which in
  4671.           turn overrides the "area direction".
  4672.  
  4673.           I -> Only Input is allowed from this link.
  4674.             NEF will not send files.
  4675.           O -> Only output is allowed to this link.
  4676.             NEF will not accept files.
  4677.           * -> Bidirectional link.
  4678.  
  4679.     <link>
  4680.           This is a 4D address, that can be abbreviated
  4681.           whenever the preceding address has the same
  4682.           zone, zone:net or zone:net/node.
  4683.  
  4684.           For the first <link>, if incomplete, the
  4685.           primary address for the area is used; anyway
  4686.           NEF always writes the first address in
  4687.           complete form when rewriting the area due to
  4688.           a Link Robot command.
  4689.  
  4690.   Examples:
  4691.  
  4692.   Please note that the situation might be a little different
  4693.   from what explained below, since the FileLink definitions
  4694.   could have some overriding flags.
  4695.  
  4696.  
  4697.   FileArea AREA1 d:\file\area1 O I2:332/1 504.1 .2 1:2/3
  4698.  
  4699.   Typical area definition, where we receive from the
  4700.   uplink (marked with 'I') and forward to the listed downlinks
  4701.   (area direction 'O').
  4702.  
  4703.  
  4704.   FileArea AREA2 d:\file\area2 O -0 I2:332/1 504.1 .2 1:2/3
  4705.  
  4706.   Same as above, but passthru.
  4707.  
  4708.  
  4709.   FileArea AREA3 d:\file\area3 O -030 I2:332/1 504.1 .2 1:2/3
  4710.  
  4711.   Same as above, but the files will not be deleted until they
  4712.   are 30 day old.
  4713.  
  4714.  
  4715.   FileArea AREA4 d:\file\area4 I O2:5/1 3/1 332/504.2 .3
  4716.  
  4717.   This is a "reverse" area, where we receive from the listed
  4718.   nodes (area direction 'I') and send to the one marked with
  4719.   'O'.
  4720.  
  4721.  
  4722.   FileArea AREA5 d:\file\area5 * 2:5/1 3/1 332/504.2 .3
  4723.  
  4724.   This is a bidirectional area (direction '*'), where we
  4725.   receive from any of the listed nodes and forward to all the
  4726.   others.
  4727.  
  4728.  
  4729.   FileArea AREA6 d:\file\area6 O #2:332/500 I2:332/596 C555
  4730.  
  4731.   A normal "up-link to down-links" area ('O'); we use
  4732.   2:332/500 as the primary address, accept files from
  4733.   2:332/596 and forward to 2:332/555 with a crash flavoured
  4734.   file attach.
  4735.  
  4736.  
  4737.   FileArea AREA7 d:\file\area7 O S2:332/504.1 10:10/0 *100/1
  4738.  
  4739.   Normal "up-link to down-links" area ('O'); 10:100/1 is the
  4740.   only node enabled to send to us (bidirectional override
  4741.   '*'); we forward to 2:332/504.1 and 10:10/0. If we hatch
  4742.   files, we send to 10:100/1 too, since it is bidirectional.
  4743.   We send the .TIC accompanying files to 2:332/504.1 ('S')
  4744.   even if it had a 'T' flag in its FileLink definition.
  4745.  
  4746.  
  4747.   FileArea AREA8 d:\file\area8 O -p100/f @2:332/500 504.1
  4748.   This area is protected with level 100 and key f; the default
  4749.   primary address is 2:332/500.
  4750.  
  4751.  
  4752.  
  4753. ΓòÉΓòÉΓòÉ 7.7. Compress Definition File ΓòÉΓòÉΓòÉ
  4754.  
  4755.  
  4756.           COMPRESS DEFINITION FILE
  4757.  
  4758.  
  4759. The file specified in the CompressCfg statement is a sequence of
  4760. Archive definition blocks, each one starting with "Archiver" and
  4761. ending with "End Archiver". You can find an example in the
  4762. Compress.Cfg file included in the distribution pack.
  4763.  
  4764. The order of the archive definition blocks within this file may
  4765. be important: when trying to unpack a compressed file, the list
  4766. of archivers is scanned in a reverse order.
  4767.  
  4768. In the case of two archivers that use the same identification
  4769. string (e.g. ARC and PAK), you must specify the archiver that
  4770. can unpack both (PAK) after the other one (ARC).
  4771.  
  4772. The compress.cfg file can be shared between DOS/NT and OS/2
  4773. applications: the "DOS" and "OS2" keywords are available to
  4774. distinguish between the commands to be used under DOS/NT and
  4775. OS/2.
  4776.  
  4777. O.S. specific archivers or commands must be prefixed with the
  4778. relevant keyword.
  4779.  
  4780. IMPORTANT NOTE: The lines that begin with "DOS" or "OS2" are
  4781. parsed by the DOS/NT and OS/2 versions respectively. If you need
  4782. the OS/2 version to execute a DOS command, you MUST NOT use the
  4783. DOS keyword: if you do, it will never parse that line; if you do
  4784. not, it will execute the DOS command "normally", provided you
  4785. have installed OS/2's Dos support.
  4786.  
  4787. See the examples below.
  4788.  
  4789.  
  4790. ΓòÉΓòÉΓòÉ 7.7.1. Archiver ΓòÉΓòÉΓòÉ
  4791.  
  4792.  
  4793. Archiver <ARCname>
  4794.  
  4795.     Starts the Archive definition block.
  4796.  
  4797.     <ARCname> is the name used to identify this archiver.
  4798.  
  4799.   Example:
  4800.  
  4801.     Archiver ZIP
  4802.  
  4803.  
  4804. ΓòÉΓòÉΓòÉ 7.7.2. Extension ΓòÉΓòÉΓòÉ
  4805.  
  4806.  
  4807. Extension  <ext>
  4808.  
  4809.     Specifies the default extension for the compressed
  4810.     files.
  4811.  
  4812.   Example:
  4813.  
  4814.     Extension ZIP
  4815.  
  4816.  
  4817. ΓòÉΓòÉΓòÉ 7.7.3. Ident ΓòÉΓòÉΓòÉ
  4818.  
  4819.  
  4820. Ident <ofs>,<ID>
  4821.  
  4822.     <ofs> is a decimal integer number representing the
  4823.     offset at which an archive identity marker <ID> must be
  4824.     present.
  4825.  
  4826.     Negative values can be used to indicate offsets from the
  4827.     END of a compressed file. -1 means "the last byte", -2
  4828.     "the second last byte" and so on.
  4829.  
  4830.     <ID> is a series of hexadecimal figures which represent
  4831.     the bytes of the marker string that must be present at
  4832.     the specified offset of the archive file.
  4833.  
  4834.   Example:
  4835.  
  4836.     Ident 0,504b0304  ; "PK^c^d"
  4837.  
  4838.  
  4839. ΓòÉΓòÉΓòÉ 7.7.4. Add ΓòÉΓòÉΓòÉ
  4840.  
  4841.  
  4842. Add <command>
  4843.  
  4844.     Specifies the command to add files to an archive.
  4845.     %a and %f are translated to the name of the archive and
  4846.     file to add.
  4847.  
  4848.   Example:
  4849.  
  4850.     Add zip -jk %a %f
  4851.  
  4852.  
  4853. ΓòÉΓòÉΓòÉ 7.7.5. Extract ΓòÉΓòÉΓòÉ
  4854.  
  4855.  
  4856. Extract <command>
  4857.  
  4858.     Specifies the command to extract files from an archive.
  4859.     %a and %f are translated to the name of the archive and
  4860.     file to extract.
  4861.  
  4862.   Example:
  4863.  
  4864.     Extract unzip -qqnjC %a %f
  4865.  
  4866.  
  4867. ΓòÉΓòÉΓòÉ 7.7.6. View ΓòÉΓòÉΓòÉ
  4868.  
  4869.  
  4870. View <command>
  4871.  
  4872.     This line is recognized and accepted for compatibility,
  4873.     but not used.
  4874.  
  4875.  
  4876. ΓòÉΓòÉΓòÉ 7.7.7. End Archiver ΓòÉΓòÉΓòÉ
  4877.  
  4878.  
  4879. End Archiver
  4880.  
  4881.     This statement is used to close a Archive definition.
  4882.  
  4883.  
  4884. ΓòÉΓòÉΓòÉ 7.7.8. Examples ΓòÉΓòÉΓòÉ
  4885.  
  4886.               Examples
  4887.  
  4888.  
  4889.   Complete example 1 (you need OS/2 only):
  4890.  
  4891. Archiver ZIP
  4892.    Extension   ZIP
  4893.    Ident     0,504b0304
  4894.    Add      zip -jk %a %f
  4895.    Extract    unzip -qqnjC %a %f
  4896.    View      unzip -v %a
  4897. End Archiver
  4898.  
  4899.  
  4900.   Complete example 2 (you need DOS only):
  4901.  
  4902. Archiver ZIP
  4903.    Extension   ZIP
  4904.    Ident     0,504b0304
  4905.    Add      pkzip -a %a %f
  4906.    Extract    pkunzip -n %a %f
  4907.    View      pkzip -v %a
  4908. End Archiver
  4909.  
  4910.  
  4911.   Complete example 3 (you need both OS/2 and DOS):
  4912.  
  4913. Archiver ZIP
  4914.    Extension   ZIP
  4915.    Ident     0,504b0304
  4916. OS2  Add      zip -jk %a %f
  4917. DOS  Add      pkzip -a %a %f
  4918. OS2  Extract    unzip -qqnjC %a %f
  4919. DOS  Extract    pkunzip -n %a %f
  4920. OS2  View      unzip -v %a
  4921. DOS  View      pkzip -v %a
  4922. End Archiver
  4923.  
  4924.  
  4925.   Complete example 4 (archiver to be used under DOS only):
  4926.  
  4927. DOS Archiver ZOO
  4928. DOS   Extension    ZOO
  4929. DOS   Ident      0,5a4f4f             ; "ZOO"
  4930. DOS   Add       zoo a: %a %f
  4931. DOS   Extract     zoo e:O %a %f
  4932. DOS   View       zoo v %a
  4933. DOS End Archiver
  4934.  
  4935.  
  4936.   Complete example 5 (it's a DOS executable, to be used under
  4937.             DOS or OS/2 indifferently):
  4938.  
  4939. Archiver ZOO
  4940.    Extension    ZOO
  4941.    Ident      0,5a4f4f             ; "ZOO"
  4942.    Add       zoo a: %a %f
  4943.    Extract     zoo e:O %a %f
  4944.    View       zoo v %a
  4945. End Archiver
  4946.  
  4947.  
  4948. ΓòÉΓòÉΓòÉ 8. TroubleShooting ΓòÉΓòÉΓòÉ
  4949.  
  4950.  
  4951.             TroubleShooting
  4952.  
  4953.  
  4954. Problem:
  4955.      NEF does not append to Echotoss.log.
  4956.  
  4957. Solution:
  4958.      Make sure that the announcement area is defined with
  4959.      AreaTag (not AreaPath).
  4960.      You might also need the SquishCfg keyword, if you want
  4961.      NEF to automatically retrieve the area Path and type.
  4962.  
  4963.  
  4964. ΓòÉΓòÉΓòÉ 9. SHAREWARE ΓòÉΓòÉΓòÉ
  4965.  
  4966.  
  4967.             S H A R E W A R E
  4968.  
  4969.  
  4970. If you like this program and continue using it, you should pay
  4971. the author for his work, as per the ShareWare concept of
  4972. distribution.
  4973.  
  4974. Please see LICENSE.DOC and REGISTER.DOC for information.
  4975.  
  4976. Thank you for your interest in ApWorks programs.
  4977.  
  4978.  
  4979. ΓòÉΓòÉΓòÉ 9.1. License.Doc ΓòÉΓòÉΓòÉ
  4980.  
  4981.  
  4982.              ΓòöΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòù
  4983.              Γòæ    Γòæ
  4984.              Γòæ N E F Γòæ
  4985.              Γòæ    Γòæ
  4986.              ΓòÜΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓò¥
  4987.  
  4988.             L I C E N S E
  4989.  
  4990.              P O L I C Y
  4991.  
  4992.              May  1996
  4993.  
  4994.  
  4995. This software (program and accompanying documentation) are:
  4996.  
  4997. Copyright (c) 1991-1996 Alberto Pasquale, all rights reserved.
  4998.  
  4999.  
  5000.            DISTRIBUTION FORMAT
  5001.  
  5002.  
  5003. This software is distributed in a locked RAR archive, with
  5004. embedded authenticity-verification information.
  5005.  
  5006. The distribution of modified archives, including those derived
  5007. from the conversion to a different archiver, is explicitly
  5008. prohibited.
  5009.  
  5010. When the RAR extension is not accepted, you should either store
  5011. the original RAR archive inside a different one (e.g. RAR inside
  5012. ZIP) or get the self-extracting executable that is prepared by
  5013. the author (available on ftp.bmtmicro.com/bmtmicro).
  5014.  
  5015.  
  5016.  
  5017.            S H A R E W A R E
  5018.  
  5019.  
  5020. This software is distributed as ShareWare: you are granted the
  5021. right to evaluate the program for a maximum of 30 days before
  5022. paying the author. After the evaluation period, you are required
  5023. to either register (see REGISTER.DOC) or stop using the program.
  5024.  
  5025. You are encouraged to distribute the original and unmodified
  5026. package freely, in any form and on any media, provided you do
  5027. not charge any fee for the program itself.
  5028.  
  5029. This package could be included in CD-ROM collections,
  5030. subscription download areas, BBS packages, provided it remains
  5031. in its complete and unmodified original archive.
  5032.  
  5033. In any case, the user must register with the author after the
  5034. evaluation period.
  5035.  
  5036. IMPORTANT: the registration is NOT a trade transaction, it is to
  5037. be considered as payment of royalties; therefor the registration
  5038. key is personal and NOT transferrable.
  5039.  
  5040.  
  5041.              DISCLAIMER
  5042.  
  5043.  
  5044. This software is provided on an "as is" basis without warranty
  5045. of any kind, expressed or implied, including but not limited to
  5046. the implied warranties of merchantability and fitness for a
  5047. particular purpose.
  5048.  
  5049. The person using the software bears all risk as to its quality
  5050. and performance.
  5051.  
  5052. The author will not be liable for any special, incidental,
  5053. consequential, indirect or similar damages due to loss of data
  5054. or any other reason.
  5055.  
  5056.  
  5057. ΓòÉΓòÉΓòÉ 9.2. Register.Doc ΓòÉΓòÉΓòÉ
  5058.  
  5059.  
  5060.           **  ** ******* *******
  5061.           ***  **  **  *  **  *
  5062.           **** **  ** *   ** *
  5063.           ** ****  ****   ****
  5064.           **  ***  ** *   ** *
  5065.           **  **  **  *  **
  5066.           **  ** ******* ****
  5067.  
  5068.  
  5069.     (C) Copyright 1991-1996  by  Alberto Pasquale
  5070.  
  5071.       A L L  R I G H T S  R E S E R V E D
  5072.  
  5073.  
  5074. For licensing terms and disclaimer, see LICENSE.DOC.
  5075.  
  5076. This program required a lot of work: by registering you will
  5077. support me in developing this and other similar products.
  5078.  
  5079. You will receive a registration Key that removes the initial 2
  5080. second pause and makes the program show "Registered <month/year>
  5081. To: <Reg.String>" instead of the registration request banner.
  5082.  
  5083. The registration is guaranteed valid for all future minor
  5084. updates and, in any case, for all versions that will be released
  5085. in a period of 2 years after registration. After this period, an
  5086. upgrade fee might possibly be required in the case of major new
  5087. releases.
  5088.  
  5089. The registration key works with the current version of the
  5090. program for ANY platform: you do not have to pay anything in
  5091. the case you change your operating system.
  5092.  
  5093. ΓòöΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòù
  5094. Γòæ                               Γòæ
  5095. Γòæ Registration fee: US$ 25, DEM 35, ITL 30,000 or (see below) Γòæ
  5096. Γòæ                               Γòæ
  5097. ΓòÜΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓò¥
  5098.  
  5099.  
  5100.  
  5101. ΓòÉΓòÉΓòÉ 9.2.1. How to Register ΓòÉΓòÉΓòÉ
  5102.  
  5103.  
  5104.             HOW TO REGISTER
  5105.  
  5106.  
  5107.  
  5108. Registering is quite easy; you can register:
  5109.  
  5110.  
  5111. - Directly with me by cash, check or international
  5112.  (not domestic !) postal money order.
  5113.  
  5114. - via local Registration Site in Germany, Denmark (Sweden,
  5115.  Norway), UK, Croatia.
  5116.  
  5117. - via BMT Micro (Wilmington, NC, USA), by credit card, money
  5118.  order, cashiers check, personal check, German or British
  5119.  currency.
  5120.  
  5121. - via PsL (Houston, TX, USA), by credit card.
  5122.  
  5123.  
  5124. The registration key will be delivered via internet e-mail or
  5125. crash netmail depending on availability; fax and postal mail
  5126. will be used only in case of problems.
  5127.  
  5128. Should you not receive your registration key in a reasonable
  5129. time, please feel free to contact me.
  5130.  
  5131. Please allow at least 3 weeks for response to international
  5132. airmail.
  5133.  
  5134.  
  5135. Please address your requests, complaints, suggestions to:
  5136.  
  5137.  Alberto Pasquale of 2:332/504@fidonet
  5138.  
  5139.  alberto.pasquale@interbusiness.it
  5140.  
  5141.  2:332/504@fidonet +39-59-246112 V120 V34+ V32T H16
  5142.  2:332/524@fidonet +39-59-246113 X75 FAX-G3
  5143.  
  5144.  
  5145. ΓòÉΓòÉΓòÉ 9.2.1.1. Author's ΓòÉΓòÉΓòÉ
  5146.  
  5147.       Hot to register directly with the author
  5148.  
  5149. You have to send the registration information and money to:
  5150.  
  5151.    Alberto Pasquale
  5152.    Viale Verdi 106
  5153.    41100 Modena
  5154.    Italy
  5155.  
  5156.  
  5157. ΓòÉΓòÉΓòÉ 9.2.1.1.1. Cash ΓòÉΓòÉΓòÉ
  5158.  
  5159.  
  5160. Cash:
  5161.    Just put the (accurately hidden) banknotes (US$ 25, DEM
  5162.    35, ITL 30,000) together with Register.For in an envelope.
  5163.    If you do not have US dollars, German marks or Italian
  5164.    liras and do not like going to the bank, you can send the
  5165.    equivalent in your currency, provided it is commonly
  5166.    exchangeable.
  5167.  
  5168.  
  5169. ΓòÉΓòÉΓòÉ 9.2.1.1.2. Check ΓòÉΓòÉΓòÉ
  5170.  
  5171.  
  5172. Check:
  5173.    Just put the check (accurately hidden) together with
  5174.    Register.For in an envelope. Please read carefully the
  5175.    following instructions:
  5176.  
  5177.    - Eurocheque: ITL 30,000 (thirty thousand).
  5178.  
  5179.    - Italian check: 30.000 lire
  5180.  
  5181.    - Other (bank) checks: US$ 25, DEM 35 or equivalent.
  5182.  
  5183.    ATTENTION: NO Postal Checks please.
  5184.  
  5185.  
  5186. ΓòÉΓòÉΓòÉ 9.2.1.1.3. Postal Money Order ΓòÉΓòÉΓòÉ
  5187.  
  5188.  
  5189. Postal Money Order:
  5190.  
  5191.    Just go to the post office and ask for an _INTERNATIONAL_
  5192.    postal money order. It is best to go to a major post
  5193.    office, since minor ones are generally not used dealing
  5194.    with international money orders. Usually you can choose
  5195.    whether to use your currency or the recipient's.
  5196.  
  5197.    Please be sure to specify the necessary registration
  5198.    information in the "sender message" field or send
  5199.    Register.For separately to the author.
  5200.  
  5201.    - International money order in italian liras: ITL 30,000
  5202.     (thirty thousand).
  5203.  
  5204.    - International money order in your currency: US$ 25,
  5205.     DEM 35 or equivalent.
  5206.  
  5207.    - Italian money order "vaglia": 30.000 lire.
  5208.  
  5209.    IMPORTANT: Please DO NOT send me normal "domestic" postal
  5210.    money orders, since they are not payable outside of your
  5211.    country; you must use INTERNATIONAL postal money orders.
  5212.  
  5213.    If you would like to receive the key soon, you
  5214.    can FAX me (+39-59-246113) the receipt of the
  5215.    postal money order together with REGISTER.FOR.
  5216.  
  5217.  
  5218. ΓòÉΓòÉΓòÉ 9.2.1.2. Local Registration/Support sites ΓòÉΓòÉΓòÉ
  5219.  
  5220.  
  5221. Local Registration/Support Sites:
  5222.  
  5223.     If you choose this way, you will have contacts with the
  5224.     local supporter only: you will send him the money and
  5225.     registration form; in a few days you will receive your
  5226.     key.
  5227.  
  5228.  
  5229. ΓòÉΓòÉΓòÉ 9.2.1.2.1. Germany ΓòÉΓòÉΓòÉ
  5230.  
  5231.  
  5232. Germany:
  5233.  
  5234.     Roland Schiradin
  5235.     Stockbornstr. 10
  5236.     65343 Eltville
  5237.     Germany
  5238.  
  5239.     Fidonet:  2:2454/169 Mail Only
  5240.     Internet: schiradi@tap.de
  5241.  
  5242.     Reg. Fee: DEM 35
  5243.  
  5244.     He has the APWORKS support echo and TIC file-areas for
  5245.     my programs available. Besides he can provide you with
  5246.     information about the nodes carrying APWORKS in
  5247.     Germany.
  5248.  
  5249.     He has the latest version of ApWorks programs available
  5250.     for F/R with the same magics listed in Readme.1st.
  5251.  
  5252.  
  5253. ΓòÉΓòÉΓòÉ 9.2.1.2.2. Denmark/Sweden/Norway ΓòÉΓòÉΓòÉ
  5254.  
  5255.  
  5256. Denmark
  5257. Sweden
  5258. Norway:
  5259.     Jens Holm
  5260.     Skanderupgade 9, D2
  5261.     8660 Skanderborg
  5262.     Denmark
  5263.  
  5264.     Reg. Fee: 125.- DKR
  5265.  
  5266.     Can be paid cash, check or postal order.
  5267.  
  5268.     Email:
  5269.     2:238/45.888@fidonet
  5270.     Jholm@dk-online.dk
  5271.  
  5272.     for swedish and norwegian users, if in doubt, please
  5273.     contact regsite for payment in local currency, reply will
  5274.     be crashed back.
  5275.  
  5276.  
  5277. ΓòÉΓòÉΓòÉ 9.2.1.2.3. United Kingdom ΓòÉΓòÉΓòÉ
  5278.  
  5279.  
  5280. United Kingdom:
  5281.  
  5282.     Vince Coen
  5283.     Applewood House
  5284.     Epping Road
  5285.     Roydon, Harlow
  5286.     Essex, CM19 5DA, UK
  5287.  
  5288.     Fidonet: 2:257/609
  5289.  
  5290.     Reg. Fee: GBP 15.00
  5291.  
  5292.     Payment can be in Cash, Cheque (bankers card number on
  5293.     order form please), EuroCheck, Credit Card or direct to
  5294.     my bankers. Payment MUST be in Pounds Sterling.
  5295.  
  5296.     For payment through the bank:
  5297.     Bank:     First Direct.
  5298.     Sort code:   40-47-86.
  5299.     Account:    00449334
  5300.     Account name: Vincent Coen.
  5301.  
  5302.     Payment reference must include Sysop name and node number.
  5303.  
  5304.     For payment via Visa/Mastercard/Eurocard there is a 5.50%
  5305.     surcharge which will add 0.83 to the cost of 15.00, i.e.
  5306.     15.83 Pounds Sterling.
  5307.     Credit Card details needed: Name and address of card
  5308.     holder, Card number and card expiry date.
  5309.  
  5310.  
  5311.     The latest version of ApWorks programs are available
  5312.     for F/R with the same magics listed in Readme.1st.
  5313.  
  5314.  
  5315. ΓòÉΓòÉΓòÉ 9.2.1.2.4. Croatia ΓòÉΓòÉΓòÉ
  5316.  
  5317.  
  5318. Croatia:
  5319.  
  5320.     Branko Radojevic
  5321.     KOPIJA d.o.o.
  5322.     Pera Rudenjaka 2a
  5323.     HR-20000 Dubrovnik
  5324.  
  5325.     Fidonet:  2:381/124
  5326.          2:381/20
  5327.  
  5328.     Internet: branko@pfdu.hr
  5329.          sysop@pulsar.fido.hr
  5330.  
  5331.     PULSAR BBS Dubrovnik
  5332.     Data : +385 20 413 299 (ZYX, V34)
  5333.     Voice: +385 20 412 999
  5334.  
  5335.     Reg. Fee: Kn 135
  5336.  
  5337.  
  5338. ΓòÉΓòÉΓòÉ 9.2.1.2.5. Canada ΓòÉΓòÉΓòÉ
  5339.  
  5340.  
  5341. Canada:
  5342.  
  5343.     Mary-Anne Wise
  5344.  
  5345.     58-771 Columbia St.
  5346.     New Westminster, BC V3M 1B6
  5347.  
  5348.     Fidonet:  1:153/831
  5349.  
  5350.     Internet: MWISE@bc.sympatico.ca
  5351.  
  5352.     Reg. Fee: CDN 32.50
  5353.  
  5354.     Methods of payment: cheque, money order
  5355.  
  5356.  
  5357. ΓòÉΓòÉΓòÉ 9.2.1.3. BMT Micro ΓòÉΓòÉΓòÉ
  5358.  
  5359.          How to register with BMT Micro
  5360.  
  5361.  
  5362. You have to fill in the BmtMicro.For registration form and send
  5363. it (or equivalent information) to BMT Micro.
  5364.  
  5365. The registration fee is US$ 25.
  5366.  
  5367. ATTENTION: for any question regarding the program, its
  5368. registration, support etc, you must contact me directly.
  5369. Please contact BMT Micro to order ONLY.
  5370.  
  5371. Usually your key will be delivered within 2 business days.
  5372.  
  5373. In certain holiday periods (Christmas, Easter, end of July,
  5374. first half of August) there might be some delay (a few days for
  5375. Christmas or Easter, a couple of weeks in July/August). If you
  5376. think your order is particularly late, please contact me first !
  5377.  
  5378.  
  5379.     Mail Orders To: BMT Micro
  5380.             PO Box 15016
  5381.             Wilmington, NC  28408
  5382.             U.S.A.
  5383.  
  5384.      Voice Orders: 8:00am - 7:00pm EST (-5 GMT)
  5385.             (800) 414-4268 (Orders only)
  5386.             (910) 791-7052 (Orders / Order Inquires)
  5387.  
  5388.       Fax Orders: (800) 346-1672 24 hours, 7 days a week
  5389.             (910) 350-2937 24 hours, 7 days a week
  5390.  
  5391. Online Orders via BBS: (910) 350-8061 10 lines, all 14.4K
  5392.             (910) 799-0923 28.8k line
  5393.  
  5394. Ordering and general ordering questions:
  5395.           Via AOL: bmtmicro
  5396.           via MSN: bmtmicro
  5397.         Via Prodigy: HNGP66D
  5398.        via Compuserve: 74031,307
  5399.         via Internet: orders@bmtmicro.com
  5400.                telnet@bmtmicro.com
  5401.                http://www.bmtmicro.com
  5402.  
  5403. Credit cards: Visa, Mastercard, Discover, American Express,
  5404.        Diners Club, Carte Blanche.
  5405.  
  5406. They also accept money orders, cashiers checks, personal checks.
  5407. Personal checks are subject to clearance.
  5408. US Currency is welcome (only by registered mail, return receipt
  5409. requested).
  5410.  
  5411.       BMTMICRO ORDERING FROM INSIDE GERMANY ONLY
  5412.       ==========================================
  5413.  
  5414. Persons in Germany may also transfer funds into the BMTMICRO
  5415. account with Deutsche Bank.  Once the money is deposited you
  5416. may either fax a confirmation to BMTMICRO with proof of deposit
  5417. or wait until Deutsche Bank notifies them of the transaction
  5418. (usually 10-18 business days). Account information is as
  5419. follows:
  5420.  
  5421. Deutsche Bank / Frankfurt Branch
  5422. Empf╨önger:  Thomas Bradford / BMT Micro
  5423. Konto-Nummer: 0860221
  5424. Bankleitzahl: 500-700-10
  5425.  
  5426. When you make the transfer, be sure to put your name and the
  5427. program you are registering on the transfer.
  5428.  
  5429. Current exchange rates can be obtained by sending an email to
  5430. dm_to_us@bmtmicro.com.  An automated reply will return todays
  5431. exchange rates.
  5432.  
  5433. It is very important that you send BMTMICRO a completed order
  5434. form by either email or fax if you deposit money into this
  5435. account for a registration.  Fill the order form out as usual
  5436. except in the credit card number field put "DEUTSCHE BANK". They
  5437. will file the order and use it to match against the deposit
  5438. information they receive from the bank.
  5439.  
  5440.               IMPORTANT!
  5441.               ----------
  5442. When you email BMTMICRO your order form, they will reply with an
  5443. acknowledgement.  If you do not get an acknowledgement within
  5444. 24 hours please send your order again in case it was lost.  This
  5445. extra bit of caution can save a lot of confusion.
  5446.  
  5447. If you are concerned that your order is taking too long to
  5448. process, feel free to check with BMTMICRO about the status of
  5449. your order.  It's important to all of us that you feel safe
  5450. doing business with BMTMICRO and please feel free to suggest
  5451. ways we can improve our service to you.
  5452.  
  5453.  
  5454. ΓòÉΓòÉΓòÉ 9.2.1.4. PsL ΓòÉΓòÉΓòÉ
  5455.  
  5456.       How to register with PsL (by credit card)
  5457.  
  5458.  
  5459. You must fill in the PsL.Crd and Register.For forms; then
  5460. you must send BOTH of them to PSL directly (they will forward
  5461. Register.for information to me).
  5462.  
  5463. You can order with MasterCard, Visa, American Express or
  5464. Discover Card: the charge is US$ 25.
  5465.  
  5466. ATTENTION: you MUST NOT send me any information about your
  5467. credit card. If you do, I am NOT allowed to forward your credit
  5468. card info to PSL.
  5469.  
  5470. ATTENTION: for any question regarding the program, its
  5471. registration, key delivery etc, you must contact me directly.
  5472. You must contact PSL to order ONLY.
  5473.  
  5474. PSL will notify me your order within one business day and I will
  5475. usually send your key by e-mail or crash netmail within 24h, so
  5476. if you order by fax or phone, you should usually receive your
  5477. key within 2 business days.
  5478.  
  5479. ATTENTION: In certain "holiday" periods (Christmas, Easter, end
  5480. of July, first half of August) there might be some delay (a few
  5481. days for Christmas or Easter, a couple of weeks in July/August).
  5482. If you think your order is particularly late, please contact me
  5483. first !
  5484.  
  5485. ATTENTION: It may happen that the PSL operator asks you for your
  5486. preferred diskette format. You must be aware that this may be
  5487. "standard" PSL procedure, but I will send you a key ONLY (via
  5488. e-mail, crash netmail, fax or letter), since you already have
  5489. the program.
  5490.  
  5491. IMPORTANT: Please, be sure to always give PsL the address where
  5492. you want to receive your key: e-mail address, fidonet name _and_
  5493. address, fax number, and/or complete postal address. If you are
  5494. not in the fidonet nodelist and I don't receive enough
  5495. information, I will be forced to send you an air-mail letter
  5496. (2-3 weeks for delivery). In the case of doubts, you can send
  5497. the Register.For to me too, by e-mail, crash netmail or fax.
  5498.  
  5499. Credit card registrations may be made by the following methods
  5500. (please be sure to always include all the necessary information
  5501. from BOTH Register.For and PsL.Crd).
  5502.  
  5503.    -- PsL on the Web:
  5504.  
  5505.      http://206.109.101.6
  5506.  
  5507.    -- Phone PsL at:
  5508.  
  5509.      800-2424-PsL i.e. 800-2424-775 (Toll free from USA)
  5510.  
  5511.      +1-713-524-6394 (international)
  5512.  
  5513.      PSL Office Hours:
  5514.  
  5515.      7:00 a.m. to  6:00 p.m. CST Monday->Thursday
  5516.      7:00 a.m. to 12:30 p.m. CST Friday
  5517.  
  5518.      Be sure to have BOTH Register.For AND PsL.Crd
  5519.      available to give order information to PSL.
  5520.      First of all, mention the PSL part number specified
  5521.      in PsL.Crd.
  5522.  
  5523.    -- FAX PsL at +1-713-524-6398
  5524.  
  5525.    -- Email PsL at CompuServe userid 71355,470
  5526.  
  5527.    -- Write PsL at:
  5528.      The Public (software) Library
  5529.      P.O. Box 35705
  5530.      Houston, TX 77235-5705, USA
  5531.  
  5532.    Please, let me insist one more time:
  5533.  
  5534.    ΓòöΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòù
  5535.    Γòæ The above numbers are for ORDERS ONLY.         Γòæ
  5536.    Γòæ Any question about the status of the shipment of the  Γòæ
  5537.    Γòæ order (registration key), registration options,    Γòæ
  5538.    Γòæ product details, technical support, etc, must be    Γòæ
  5539.    Γòæ directed to the author, at the address given above in Γòæ
  5540.    Γòæ this documentation.                  Γòæ
  5541.    ΓòÜΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓòÉΓò¥
  5542.  
  5543.  
  5544. ΓòÉΓòÉΓòÉ 9.2.2. How to fill in Register.For ΓòÉΓòÉΓòÉ
  5545.  
  5546.  
  5547.       INSTRUCTIONS FOR COMPILING REGISTER.FOR
  5548.  
  5549.  
  5550. To avoid errors in the key, please PRINT.
  5551.  
  5552. Thank you very much for your support !
  5553.  
  5554.  
  5555. ΓòÉΓòÉΓòÉ 9.2.2.1. Name ΓòÉΓòÉΓòÉ
  5556.  
  5557.  
  5558. Name:
  5559.    Your complete name.
  5560.  
  5561.    Example: John Doe
  5562.  
  5563.  
  5564. ΓòÉΓòÉΓòÉ 9.2.2.2. Reg ΓòÉΓòÉΓòÉ
  5565.  
  5566.  
  5567. Reg:
  5568.    The registration string you want displayed by the program.
  5569.    You can use any character in the IBM set (including special
  5570.    national characters above ASCII 127; if you do not use code
  5571.    page 437 (USA), please specify the code numbers) and you can
  5572.    use lowercase and uppercase at your preference.
  5573.    Maximum length: 63 characters.
  5574.  
  5575.    Usually it should be the same as your name, in which case
  5576.    you can omit this field.
  5577.  
  5578.  
  5579. ΓòÉΓòÉΓòÉ 9.2.2.3. e-mail to ΓòÉΓòÉΓòÉ
  5580.  
  5581.  
  5582. e-mail to:
  5583.    This is your internet e-mail address, if available.
  5584.  
  5585.  
  5586. ΓòÉΓòÉΓòÉ 9.2.2.4. Netmail to ΓòÉΓòÉΓòÉ
  5587.  
  5588.  
  5589. Netmail to:
  5590.    You have to specify the complete destination field for the
  5591.    netmail message.
  5592.  
  5593.    Examples:
  5594.         John Doe of 1:200/300.4
  5595.         John Doe of 1:200/300.0
  5596.  
  5597.  
  5598. ΓòÉΓòÉΓòÉ 9.2.2.5. Crash to ΓòÉΓòÉΓòÉ
  5599.  
  5600.  
  5601. Crash to:
  5602.    You have to specify the data necessary for crashing the
  5603.    message. Usually this should be your system or your Boss
  5604.    (if you are a point).
  5605.  
  5606.    I will call as 2:332/504@fidonet.
  5607.  
  5608.    - If your system (or your Boss) is 24h and it is in the
  5609.     fidonet nodelist, you can omit this field.
  5610.  
  5611.    - If your system is not 24h, please give me a 24h system to
  5612.     which I can crash your netmail for routing.
  5613.  
  5614.    - If the system in consideration is not in the fidonet
  5615.     nodelist, please add its complete phone number and modem
  5616.     type.
  5617.  
  5618.    Examples:
  5619.         1:200/400@fidonet
  5620.         9:800/700@ABCnet +1-703-4567 V34, ISDNC
  5621.  
  5622.  
  5623. ΓòÉΓòÉΓòÉ 9.2.2.6. Fax ΓòÉΓòÉΓòÉ
  5624.  
  5625.  
  5626. Fax:
  5627.    This is your (24h) fax number, if any.
  5628.  
  5629.  
  5630. ΓòÉΓòÉΓòÉ 9.2.2.7. Address ΓòÉΓòÉΓòÉ
  5631.  
  5632.  
  5633. Address:
  5634.    The postal address is the last opportunity of sending you
  5635.    the key.
  5636.  
  5637.  
  5638. ΓòÉΓòÉΓòÉ 9.2.2.8. Version ΓòÉΓòÉΓòÉ
  5639.  
  5640.  
  5641. Version:
  5642.    You should indicate BOTH the version number AND the
  5643.    Operating System.
  5644.  
  5645.    Example: ver. 2.38  OS/2
  5646.  
  5647.    This is not essential and is included for statistical
  5648.    purposes only (the key works with all current versions).
  5649.  
  5650.  
  5651. ΓòÉΓòÉΓòÉ 9.2.2.9. Notes ΓòÉΓòÉΓòÉ
  5652.  
  5653.  
  5654. Notes:
  5655.    You can send me your wish list for future versions,
  5656.    or anything you like.
  5657.  
  5658.  
  5659. ΓòÉΓòÉΓòÉ 9.2.3. How to fill in BmtMicro.For ΓòÉΓòÉΓòÉ
  5660.  
  5661.  
  5662.       INSTRUCTIONS FOR COMPILING BMTMICRO.FOR
  5663.  
  5664.  
  5665. The first section contains data necessary for BMT Micro (your
  5666. name, company, address, phone and fax).
  5667.  
  5668. The second section contains the "Registration Information" that
  5669. will be relayed to me so that I can build the key and deliver it
  5670. to you.
  5671.  
  5672. The third section contains the product and cost indication.
  5673. The registration is valid for any operating system.
  5674.  
  5675. The forth section contains data for Credit Card payment.
  5676.  
  5677. To avoid errors, please PRINT.
  5678.  
  5679. Thank you very much for your support !
  5680.  
  5681.  
  5682. ΓòÉΓòÉΓòÉ 9.2.3.1. Reg ΓòÉΓòÉΓòÉ
  5683.  
  5684.  
  5685. Reg:
  5686.    The registration string you want displayed by the program,
  5687.    ASCII characters only (<127).
  5688.    Maximum length: 63 characters.
  5689.  
  5690.  
  5691. ΓòÉΓòÉΓòÉ 9.2.3.2. e-mail to ΓòÉΓòÉΓòÉ
  5692.  
  5693.  
  5694. e-mail to:
  5695.    This is your internet e-mail address, if available.
  5696.  
  5697.  
  5698. ΓòÉΓòÉΓòÉ 9.2.3.3. Netmail to ΓòÉΓòÉΓòÉ
  5699.  
  5700.  
  5701. Netmail to:
  5702.    You have to specify the complete destination field for the
  5703.    netmail message.
  5704.  
  5705.    Examples:
  5706.         John Doe of 1:200/300.4
  5707.         John Doe of 1:200/300.0
  5708.  
  5709.  
  5710. ΓòÉΓòÉΓòÉ 9.2.3.4. Crash to ΓòÉΓòÉΓòÉ
  5711.  
  5712.  
  5713. Crash to:
  5714.    You have to specify the data necessary for crashing the
  5715.    message. Usually this should be your system or your Boss
  5716.    (if you are a point).
  5717.  
  5718.    I will call as 2:332/504@fidonet.
  5719.  
  5720.    - If your system (or your Boss) is 24h and it is in the
  5721.     fidonet nodelist, you can omit this field.
  5722.  
  5723.    - If your system is not 24h, please give me a 24h system to
  5724.     which I can crash your netmail for routing.
  5725.  
  5726.    - If the system in consideration is not in the fidonet
  5727.     nodelist, please add its complete phone number and modem
  5728.     type.
  5729.  
  5730.    Examples:
  5731.         1:200/400@fidonet
  5732.         9:800/700@ABCnet +1-703-4567 V34, ISDNC
  5733.  
  5734.  
  5735. ΓòÉΓòÉΓòÉ 9.3. Register.For ΓòÉΓòÉΓòÉ
  5736.  
  5737.  
  5738.  
  5739.  
  5740. NEF Registration Form
  5741.  
  5742. (Please PRINT)
  5743.  
  5744. See Register.Doc for instructions:        Date: __/__/__
  5745.  
  5746. Name: _________________________________________________________
  5747.  
  5748. Reg.: _________________________________________________________
  5749.  
  5750. e-mail to: ____________________________________________________
  5751.  
  5752. Netmail to: ___________________________________________________
  5753.  
  5754. Crash to: _____________________________________________________
  5755.  
  5756. Fax: __________________________________________________________
  5757.  
  5758. Address: ______________________________________________________
  5759.  
  5760.      ______________________________________________________
  5761.  
  5762.      ______________________________________________________
  5763.  
  5764. Version: _.___  OS/2 ( )  NT ( )  DOS ( )
  5765.  
  5766. Notes: ________________________________________________________
  5767.  
  5768. _______________________________________________________________
  5769.  
  5770. _______________________________________________________________
  5771.  
  5772.  
  5773.  
  5774.  
  5775. ΓòÉΓòÉΓòÉ 9.4. BmtMicro.For ΓòÉΓòÉΓòÉ
  5776.  
  5777.  
  5778. BMT Micro
  5779. NEF Registration Form
  5780.  
  5781.       *****************************************
  5782.       * DO NOT SEND this form to the author ! *
  5783.       *****************************************
  5784.  
  5785. See Register.Doc for instructions, please PRINT:  Date: __/__/__
  5786.  
  5787. Name: __________________________________________________________
  5788.  
  5789. Company: _______________________________________________________
  5790.  
  5791. Address: _______________________________________________________
  5792.  
  5793. ________________________________________________________________
  5794.  
  5795. City: ______________________  State/Province: _________________
  5796.  
  5797. Country: ___________________________ Postal Code: ______________
  5798.  
  5799. Phone: _________________________________________________________
  5800.  
  5801. Fax: ___________________________________________________________
  5802.  
  5803.  
  5804.          REGISTRATION INFORMATION
  5805.  
  5806. Reg.: __________________________________________________________
  5807.  
  5808. e-mail to: _____________________________________________________
  5809.  
  5810. Netmail to: ____________________________________________________
  5811.  
  5812. Crash to: ______________________________________________________
  5813.  
  5814.  
  5815. Product: NEF (by Alberto Pasquale)       Price:  US$ 25.00
  5816.  
  5817. North Carolina residents, please add 6% sales tax:   +US$ __.__
  5818.  
  5819.                         Total:  US$ __.__
  5820.  
  5821. For credit card payment only:
  5822.  
  5823. Circle one: VISA / Master / Discover / AMEX / Diner's Club
  5824.  
  5825. Credit card number   : _______________________________________
  5826.  
  5827. Expiration date     : ___/___
  5828.  
  5829. Authorization signature: _______________________________________
  5830.  
  5831.  
  5832. ΓòÉΓòÉΓòÉ 9.5. PsL.Crd ΓòÉΓòÉΓòÉ
  5833.  
  5834.  
  5835.  
  5836.  
  5837. NEF Credit Card Registration Form
  5838. PSL Part number 11474
  5839.  
  5840.       *****************************************
  5841.       * DO NOT SEND this form to the author ! *
  5842.       *****************************************
  5843.  
  5844.    Please read carefully Register.Doc for instructions.
  5845.  
  5846.  
  5847.                  Date _________________________
  5848.  
  5849.  
  5850. Cardholder's name, exactly as it appears on the credit card:
  5851.  
  5852.       _____________________________________________________
  5853.  
  5854. [Company:] _____________________________________________________
  5855.  
  5856.  
  5857. Billing address for the card:
  5858.  
  5859.    ___________________________________________________________
  5860.  
  5861.    ___________________________________________________________
  5862.  
  5863.    ___________________________________________________________
  5864.  
  5865. Payment by:  ( ) MasterCard      ( ) Visa
  5866.        ( ) American Express   ( ) Discover Card
  5867.  
  5868. Card #:  _______________________________  Exp. Date:  __________
  5869.  
  5870. Signature of cardholder: _______________________________________
  5871.  
  5872.  
  5873.  
  5874. ΓòÉΓòÉΓòÉ 10. Sample config files ΓòÉΓòÉΓòÉ
  5875.  
  5876.         Some example configuration files
  5877.  
  5878.  
  5879. ΓòÉΓòÉΓòÉ 10.1. Point or minimal Configuration ΓòÉΓòÉΓòÉ
  5880.  
  5881.  
  5882. ;     NEF 2.38, (c) Copyright 1991-1996 Alberto Pasquale
  5883.  
  5884. ;              Nef.Cfg Example
  5885.  
  5886. ;             Minimal configuration
  5887.  
  5888.  
  5889. ; RegKey <RegKey>           ; registration Key
  5890. Address    2:332/504.1        ; Address
  5891. StatusLog   d:\point\log\nef.LOG   ; Binkley Style Log File
  5892. NetFile    d:\point\inb       ; Inbound
  5893. OutBound   d:\point\outbound     ; Primary Outbound
  5894. TicHold    d:\point\tichold     ; To hold outgoing .TICs
  5895. CheckCRC                ; Check ingoing files
  5896.  
  5897. FileLink 2:332/504 Password C     ; Attach with Crash flavour
  5898.  
  5899. FileArea APBBS   d:\point\file\apbbs   O 2:332/504 ; Output only
  5900. FileArea AREA1   d:\point\file\area1   * 2:332/504 ; This is bidirectional
  5901.  
  5902.  
  5903. ΓòÉΓòÉΓòÉ 10.2. Full configuration ΓòÉΓòÉΓòÉ
  5904.  
  5905.  
  5906. ;      NEF 2.38, (c) Copyright 1991-1996 Alberto Pasquale
  5907.  
  5908. ;              Nef.Cfg  Example
  5909.  
  5910. ;              Full configuration
  5911.  
  5912.  
  5913. ;                SYSTEM
  5914.  
  5915.  
  5916. ; RegKey XXXXXXXXXXXXXXXXXXXXXXXXXXXXX  ; for Registered users
  5917.  
  5918.  Address    2:332/504.0        ; Primary Address
  5919.  Address    2:332/524.0        ; Second line
  5920.  Address    2:332/500.0        ; Hub
  5921.  Address    81:449/9108.4       ; Point in OS2Net
  5922.  
  5923.  StatusLog   d:\bbs\log\nef.log    ; Binkley Style Log File
  5924. ; EchoTossLog  d:\bbs\squish\echotoss.log
  5925.  
  5926.  NetFile    d:\bbs\inb\net      ; Inbounds
  5927.  NetFile    d:\bbs\inb\netp
  5928.  
  5929.  OutBound   d:\bbs\out\fido      ; Primary Outbound
  5930.  OutBound   d:\bbs\out\amiga 39    ; Outbound for zone 39
  5931.  
  5932.  TicHold    d:\bbs\tichold      ; To hold outgoing .TICs
  5933.  
  5934.  BusyFlags               ; .BSY support (multitasking)
  5935.  
  5936. ; NoRaidBeforeHatch           ; Skip TicFix when hatching
  5937.  
  5938.  MsgSize 32000             ; Max size before msg split
  5939.  
  5940.  TicAreaCfg  d:\bbs\nef\TicArea.Cfg  ; Where file areas are defined
  5941.  
  5942.  CompressCfg  d:\bbs\squish\compress.cfg ; OS/2 Only
  5943.  
  5944.  SquishCfg   d:\bbs\squish\squish.cfg  ; Optional support for Squish
  5945.  MaxPrm    d:\bbs\max\max.prm     ; Optional support for Max 3.x
  5946. ; MaxAreaAdd  d:\bbs\max\filearea.ctl 0 Transient Tic.New
  5947. ; MaxAreaCompile siltp max -a -2a
  5948.  FileBaseUpdate             ; Internal Max filebase update
  5949. ; UniqueDmpLine
  5950.  
  5951. ;               TIC PROCESSING
  5952.  
  5953.  
  5954. ; NoSecure            ; Disable security checks
  5955. ; NoReplace 3* AP*:/a      ; Disable replace in spec. areas
  5956. ; GetDizDesc :/f         ; Desc. from File_Id.Diz in spec. areas
  5957. ; NoOverWrite          ; Overwrite only with "replaces"
  5958.  CheckCRC            ; Check CRC of ingoing files
  5959.  
  5960.  Touch Creation         ; Touch Creation date on toss
  5961.  KillDate Creation       ; Use Creation date to kill old files
  5962.  
  5963. ; MultiLineDesc 31        ; Enable Files.bbs multi-line descriptions
  5964.  
  5965.  NewAreasPath c:\file          ; Path for auto-created areas
  5966.  NewAreasFrom 10:10/100         ; Address authorized for auto-creation
  5967.  NewAreasFrom 2:339/900 #2:332/500   ; Address override for created areas
  5968.  
  5969.  DescStart "/bt [00] " 1* 2*      ; Description prefix in areas 1*, 2*
  5970.  DescStart "/b [00] " 3*        ; A different one for areas 3*
  5971.  
  5972.  TagFwd 1-Comm Bbs AC*n TRY.*      ; Some area split forward
  5973.  TagFwd GenNode Pointlst PTLIST.*
  5974.  
  5975. ; FeatureLoad d:\bbs\nef\MyDll      ; Feature DLL support
  5976. ; Feature CfgItem1 "This is Item 1"
  5977. ; Feature CfgItem2 "This is Item 2"
  5978.  
  5979.  
  5980.  
  5981. ;               TIC ANNOUNCEMENTS
  5982.  
  5983. ; Default announcement parameters
  5984.  
  5985.  FromNode   2:332/504.0        ; For the message header
  5986.  ToNode    2:332/504.0
  5987.  From     Alberto Pasquale
  5988.  To      All
  5989.  Subj     New Echo Files
  5990.  Attr                  ; no special attribute
  5991.  
  5992.  Prefix    d:\bbs\nef\PREFIX.NEF   ; Message body prefix, suffix, origin
  5993.  Suffix    d:\bbs\nef\SUFFIX.NEF
  5994.  Origin    <ApWorks Modena I +39-59-246112/3>
  5995.  
  5996. ; Announcement areas: default parameters can be overridden
  5997.  
  5998.  AreaTag    APWORKS          ; If SquishCfg can't be used,
  5999.  Announce   APBBS*          ; path and type of area
  6000.  Prefix    RelPre.NEF        ; must be specified.
  6001.  Subj     New ApWorks files
  6002.  
  6003.  AreaTag    OS2BBS
  6004.  Announce   APBBS*
  6005.  NoAnnounce  *DOS*           ; Do not announce Tags
  6006.  Prefix    RelPre.NEF        ; that contain "DOS".
  6007.  Subj     New APBBS files
  6008.  
  6009.  AreaTag    SWN_332.500
  6010.  Announce   FLEET*
  6011.  Subj     New FleetStreet files
  6012.  
  6013.  AreaTag    SWN_332.500
  6014.  Announce   HARALD* OS2POINT CFOS
  6015.  Subj     New files from Harald Kamm
  6016.  
  6017.  AreaTag    LOCAL_332.504
  6018.  Announce   *:100/f
  6019.  AnnExclude  NODE*           ; do not announce files whose
  6020.  Subj     New Files on ApWorks   ; name begins with NODE.
  6021.  
  6022.  AreaTag    NETMAIL
  6023.  Announce   <OUTVIEW> <DEF>
  6024.  From     NEF
  6025.  To      Alberto Pasquale
  6026.  Subj     Not Announced Elsewhere
  6027.  HighAsciiOk
  6028.  
  6029.  AreaTag    NETMAIL
  6030.  Announce   <BAD>
  6031.  From     NEF
  6032.  To      Alberto Pasquale
  6033.  Subj     Processed with Errors
  6034.  
  6035.  
  6036. ;                LINK ROBOT
  6037.  
  6038.  
  6039.  AutoLink NEF          ; The Link Robot will answer to these names
  6040.  AutoLink Raid
  6041.  AutoLink TicFix
  6042.  
  6043.  NetMail d:\bbs\mail\net -$
  6044.  NetMail d:\bbs\mail\os2net -$ -p81:449/9108.4
  6045.  
  6046. ; KillReceived           ; Kill instead of marking as received
  6047.  AreaDescWrap 25 79        ; Word wrap for area description
  6048.  HelpFile d:\bbs\nef\NefHelp.Txt  ; Returned when help requested
  6049.  
  6050.  ProtArea 1*    300/A     ; Areas 1* and 2* are protected
  6051.  ProtArea 2*    300/B
  6052.  ProtArea *     0      ; All the others are free
  6053.  
  6054.  FileBone d:\bbs\misc\FileAp.Lst
  6055.  FileBone d:\bbs\misc\FileBone.Na 10/f "Alberto Pasquale" SysOp 2:332/1 0
  6056.  
  6057. ; ForwardWildReq         ; Forward requests with wildcards.
  6058.  
  6059.  FileLink 2:332/593 pwd593 IN      ; Simplest link definition
  6060.  FileLink 2:331/196 pwd196 HNY NK 300/a ; This has a Link Robot access
  6061.  FileLink 2:332/123 pwd123 #2:332/500 H N 300/ab MI* FW* ; Full definition
  6062.  
  6063. ; If TicAreaCfg is not used, you can put area definitions here:
  6064.  
  6065. ; FileArea AREA1 d:\file\area1 O I2:332/1 504.1 .2 1:2/3
  6066. ; FileArea AREA2 d:\file\area2 O -0 I2:332/1 504.1 .2 1:2/3
  6067.  
  6068.  
  6069. ΓòÉΓòÉΓòÉ 10.3. Sample Prefix ΓòÉΓòÉΓòÉ
  6070.  
  6071.  
  6072. Echo Files received for distribution:
  6073.  
  6074. ===============================================================================
  6075.  
  6076.  
  6077. ΓòÉΓòÉΓòÉ 10.4. Sample Suffix ΓòÉΓòÉΓòÉ
  6078.  
  6079. ===============================================================================
  6080.  
  6081. F/R allowed to everybody (06:00->23:00 GMT)
  6082. 2:332/504@fidonet +39-59-246112 (ISDNC/V34+/VFC/V32T/H16)
  6083. 2:332/524@fidonet +39-59-246113 (ISDNC/V34/VFC/V32T/H16)
  6084.  
  6085.  
  6086. ΓòÉΓòÉΓòÉ 10.5. TicArea.Cfg ΓòÉΓòÉΓòÉ
  6087.  
  6088.  
  6089. ; typical areas:
  6090. ; AREA1 is "uplink to downlinks"
  6091. ; AREA2 is "uplink to downlinks" and passthru
  6092. ; AREA3 is "uplink to downlinks" and 30 day passthru
  6093. ; AREA4 is "downlinks to uplink"
  6094. ; AREA5 is bidirectional
  6095.  
  6096. FileArea AREA1 d:\file\area1 O I2:332/1 504.1 .2 1:2/3
  6097. FileArea AREA2 d:\file\area2 O -0 I2:332/1 504.1 .2 1:2/3
  6098. FileArea AREA3 d:\file\area3 O -030 I2:332/1 504.1 .2 1:2/3
  6099. FileArea AREA4 d:\file\area4 I O2:5/1 3/1 332/504.2 .3
  6100. FileArea AREA5 d:\file\area5 * 2:5/1 3/1 332/504.2 .3
  6101.  
  6102. ; some special areas with overrides
  6103.  
  6104. FileArea AREA6 d:\file\area6 O #2:332/500 I2:332/596 C555
  6105. FileArea AREA7 d:\file\area7 O -p100/f S2:332/504.1 10:10/0 *100/1
  6106. FileArea AREA8 d:\file\area8 O -p100/f @2:332/500 504.1
  6107.  
  6108.  
  6109. ΓòÉΓòÉΓòÉ 10.6. Sample help file ΓòÉΓòÉΓòÉ
  6110.  
  6111.  
  6112. Command examples:
  6113.  
  6114. %Help    : For Help
  6115. %Query    : For a list of linked and available areas
  6116. %List    : Same as Query
  6117. %Linked   : For a list of linked areas
  6118. %Unlinked  : For a list of unlinked areas
  6119.  
  6120. =====================================================================
  6121.  
  6122. 1* -1-COMM
  6123.  
  6124. Adds all areas whose tag begins with '1', deletes area '1-COMM'.
  6125.  
  6126. =====================================================================
  6127.  
  6128. +2*
  6129. -2-WINDOW
  6130. 1-COMM
  6131.  
  6132. Adds all areas whose tag begins with '2', deletes area '2-WINDOW',
  6133. adds area '1-COMM'
  6134.  
  6135. =====================================================================
  6136.  
  6137. "Special" areas:
  6138.  
  6139. NODEDIFF - FidoNet nodelist (diff)
  6140. NODELIST - Region 33 (ZIPped)
  6141. ISNPTLST - Italian pointlist (from ISNMAIN)
  6142. NET-LIST - Non FidoNet nodelist (diff)
  6143.  
  6144. =====================================================================
  6145.  
  6146.  
  6147. ΓòÉΓòÉΓòÉ 10.7. Compress Definition ΓòÉΓòÉΓòÉ
  6148.  
  6149.  
  6150. ;        Example Compress.Cfg definition file
  6151. ;
  6152. ; If you are already using a Compress.Cfg file with other programs,
  6153. ; you do not need this one.
  6154. ; Just make sure you use the correct switches to avoid case mismatch
  6155. ; with case sensitive archivers, as ZIP/UNZIP.
  6156. ;
  6157. ; The DOS prefix is for the NT version too.
  6158.  
  6159.  
  6160. Archiver ARC
  6161.    Extension   ARC
  6162.    Ident     0,1a
  6163. OS2  Add      arc aw5 %a %f
  6164. DOS  Add      pkpak -oct a %a %f
  6165. OS2  Extract    arc ew %a %f
  6166. DOS  Extract    pkunpak /r %a %f
  6167. OS2  View      arc vw %a
  6168. DOS  View      pkpak v %a
  6169. End Archiver
  6170.  
  6171.  
  6172. DOS Archiver PAK
  6173. DOS   Extension    PAK
  6174. DOS   Ident      -2,fe
  6175. DOS   Add       pak a %a %f
  6176. DOS   Extract     pak e /wn %a %f
  6177. DOS   View       pak v %a
  6178. DOS End Archiver
  6179.  
  6180.  
  6181. Archiver ZIP
  6182.    Extension   ZIP
  6183.    Ident     0,504b0304
  6184. OS2  Add      zip -jk %a %f     ; store in uppercase
  6185. DOS  Add      pkzip -a %a %f
  6186. OS2  Extract    unzip -qqnjC %a %f  ; case insensitive extract
  6187. DOS  Extract    pkunzip -n %a %f
  6188. OS2  View      unzip -v %a
  6189. DOS  View      pkzip -v %a
  6190. End Archiver
  6191.  
  6192.  
  6193. Archiver LH
  6194.    Extension   LZH
  6195.    Ident     2,2d6c68             ; "-lh"
  6196. OS2  Add      lh a %a %f
  6197. DOS  Add      lha a /m %a %f
  6198. OS2  Extract    lh x %a %f /o
  6199. DOS  Extract    lha e /m %a %f
  6200. OS2  View      lh l %a /v /o
  6201. DOS  View      lha l %a
  6202. End Archiver
  6203.  
  6204.  
  6205. Archiver ARJ
  6206.    Extension   ARJ
  6207.    Ident     0,60ea
  6208. DOS  Add      arj a -e+ %a %f
  6209. OS2  Extract    unarj e %a %f
  6210. DOS  Extract    arj e -n %a %f
  6211. OS2  View      unarj l %a
  6212. DOS  View      arj l %a
  6213. End Archiver
  6214.  
  6215.  
  6216. Archiver RAR
  6217.    Extension   RAR
  6218.    Ident     0,526172211a0700
  6219.    Add      rar a -ee -md64 -ep -y -std -c- %a %f
  6220.    Extract    rar e -o- -y -std -c- %a %f
  6221.    View      rar v -y -std -c- %a
  6222. End Archiver
  6223.  
  6224.  
  6225.