home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS - Coast to Coast / simteldosarchivecoasttocoast2.iso / citadel / k2ne603c.zip / READ603.TXT < prev   
Text File  |  1992-09-12  |  58KB  |  1,133 lines
  1.  
  2. TO: All Citadel:K2NE Sysops and Prospective Sysops
  3. FR: K2NE Software
  4. RE: Citadel:K2NE Version 6.03
  5. ON: 92Sep12
  6.  
  7.   Included in this new distribution package is our release of
  8. Version 6.03 of the Citadel:K2NE BBS.  This file will address the
  9. differences between Citadel:K2NE and Citadel-86 as distributed
  10. by Hue, Jr. in the Minneapolis MN area.  A good bit of what follows
  11. is duplicated from information included in our prior Citadel:K2NE
  12. releases.  Please pardon the redundancy!
  13.  
  14. NOTE - If you are upgrading from Citadel:K2NE V4.05, please carefully
  15. read the "ZIPfile Support Addendum" to be found below.
  16.  
  17. NOTE - We have adopted the following file-naming convention when placing
  18. the Citadel:K2NE filesets on bulletin boards and pay-services for
  19. general downloading:
  20.  
  21.    DISK-1 is uploaded as K2NE603A(.ZIP or .LZH),
  22.    DISK-2 is uploaded as K2NE603B(.ZIP or .LZH), and
  23.    DISK-3 is uploaded as K2NE603C(.ZIP or .LZH).
  24.  
  25.    On GEnie, the source-code file is K2NE603S.LZH.
  26.  
  27. This will allow us to upload new releases without being concerned with
  28. filename "collisions" with previously uploaded versions.
  29.  
  30. ****************** Special Notes for V6.03 **********************
  31.  
  32. A great deal of what has been done for Version 6.03 is "behind the scenes"
  33. work, mostly involving "code tightening" and debugging of a few troublesome
  34. areas of the system.  "Visible changes" include the following:
  35.  
  36. 1)  Modified audio used with windowed reports.
  37.  
  38. 2)  Removed function "fakeFullCase()".  Most folks are using
  39.     terminals which support upper and lower case, and it should
  40.     be left to the writer how a message should appear!
  41.  
  42. 3)  Modified display format of message totals at room-prompts.
  43.  
  44. 4)  When a user is done visiting all rooms containing new messages,
  45.     and upon returning to the base-room by the "G" command, Citadel
  46.     will now print a message telling the user that all rooms have
  47.     been checked and no new messages remain.  Local sysop can use
  48.     ALLDONE.BLB in the help-area directory for a customized
  49.     message if the default is not satisfactory. If user is in "expert"
  50.     mode then the file ALLDONEX.BLB is used - if it exists.
  51.  
  52. 5)  When a user is done "reading the system" and returns to the base-room,
  53.     getting the message described in the 92Aug25 note, the user will
  54.     now also get a prompt asking if he wants to log off the system.
  55.     An affirmative answer will trigger the logoff routines.
  56.  
  57. 6)  The latest version of CITAGATE.EXE is included with the release of
  58.     Citadel:K2NE V6.03, offering support for Internet-style messages
  59.     into and out of the Citadel network.  This has been specifically
  60.     tested in conjunction with the KA9Q "NOS" TCP/IP package and found
  61.     to work quite well.  CITAGATE will now handle import/export of
  62.     messages to/from Internet and UseNet with proper setup.  Please
  63.     see accompanying documentation (and the CITAGATE "help screen")
  64.     for more information.
  65.  
  66. ****************** Special Notes for V6.02 **********************
  67.  
  68. Citadel:K2NE Sysops:  After all the code-hacking to give your users
  69. something new, better or different with each release, THIS release
  70. is for YOU!
  71.  
  72. NOTE:  Beginning with this release, the ".AB" command is handled
  73.        by a batch-file called AIDEBKUP.BAT, which goes in your
  74.        "home-area" directory (with CTDL.EXE etc.).  A sample
  75.        is available.
  76.  
  77. 1)  Removed "Re-init Modem" from Sysop Commands.  It is much
  78.     easier to just press ESC then do a ".TQ" from the console,
  79.     which resets the modem also.  Resetting the modem via
  80.     remote is suicidal in any event, and not needed!
  81.  
  82. 2)  Added parameter #MODEMIDLE to CTDLCNFG.SYS.  Usage is
  83.     #MODEMIDLE "string".  Citadel will send "string" to the
  84.     modem when sysop presses ESC to enter console mode when
  85.     there is no user online.  This will enable those sysops
  86.     who own modems that insist on answering the phone with
  87.     DTR suppressed to send a string to the modem commanding
  88.     it to not answer incoming calls.
  89.  
  90. 3)  Entry of file descriptions prior to uploading now utilizes
  91.     standard Citadel editor.
  92.  
  93. 4)  Added code to allow Citadel to handle the job of answering
  94.     the line instead of modem "ring counts."  In order to do this,
  95.     your modem MUST return a NUMERIC value of "2" every time the
  96.     line rings.  First, in your #modemSetup string, use whatever
  97.     your modem needs to tell it to return NUMERIC ("nonVerbose")
  98.     result codes, then (also in #modemSetup) tell it NOT to answer
  99.     the phone (usually by using the equivalent of the Hayes
  100.     command "S0=0").  Next, use the command-line parameter
  101.     "rings=n" for CTDL.EXE in the batchfile that handles your BBS,
  102.     where "n" is the number of rings you want before the BBS
  103.     answers the line.  Just ignore all of this stuff if you want
  104.     Citadel to continue to handle answering the line in
  105.     the "traditional" manner.
  106.  
  107. 5)  Added optional configuration parameter #MODEMANSWER [string]
  108.     which, if used, will make a record of the string you want to use
  109.     when you want Citadel to make the modem do the job of answering
  110.     the line (see previous note).  If missing it defaults to "ATA".
  111.     Usage:  #MODEMANSWER "string"  with no "\r" or "\n" needed.
  112.  
  113. 6)  The daily cumulative activity totals are displayed in a window
  114.     while the system is waiting for a call.
  115.  
  116. 7)  Network information now displays in a scrolling window on
  117.     the console screen.  Just a fluff, but a nice one.
  118.  
  119. 8)  Network nodelist (with indicators for work-pending) is now
  120.     windowed (via the F3 key) from the console (while waiting
  121.     between calls).
  122.  
  123. 9)  Adjusted code that handles the console status-bar for proper
  124.     operation when Citadel is first brought up.  Also, tightened
  125.     all window-oriented code for the networker, net status reports,
  126.     and pending-events (ALT-A) windows.
  127.  
  128. 10) If you have Citadel set up so that Citadel handles answering the
  129.     phone (see note #4 above) you will hear a "ring-tone" from your
  130.     computer speaker when the phoneline is ringing.  This may be
  131.     defeated by putting the parameter "noringer" on your CTDL.EXE
  132.     command-line.
  133.  
  134. 11) Added CTDL.EXE parameter "nonoises" for those that want to
  135.     shut off the ringer AND the "exploding windows" sound-effects.
  136.  
  137. 12) ALT-X to exit to DOS is now in a console window.  It will accept
  138.     a Y or N but otherwise will burp at you!
  139.  
  140. 13) Beginning with V6.02, all standby-screen displays will use
  141.     ANSI option, therefore #ANSICONSOLE setting is no longer relevant
  142.     and will be pulled from CTDLCNFG.SYS with the next revision that
  143.     "demands" an upgrade of the Configurator (CONFG.EXE).  Meanwhile,
  144.     you should set #ANSICONSOLE to 1 in order to avoid possible ugliness
  145.     in case there is some of the older code "lurking about."
  146.     The release package for V6.02 will contain a "freshly recompiled"
  147.     version of CONFG.EXE to handle those "just in case" bugs which
  148.     like to surface here and there.  Note also that beginning with
  149.     V6.02 you MUST have ANSI.SYS loaded as a device-driver in your
  150.     DOS CONFIG.SYS file.
  151.  
  152. ****************** Special Notes for V6.01 **********************
  153.  
  154. The following is a list of changes and enhancements peculiar to
  155. this MAJOR RELEASE (V6.01) of Citadel:K2NE.  Please note that a
  156. FOSSIL DRIVER is ABSOLUTELY REQUIRED to upgrade to Version 6.01!
  157.  
  158. 1)  Removed built-in terminal code and manual-dialer options.
  159.     This was done because this feature was suffering from
  160.     general disuse - if folks need a terminal they certainly
  161.     can do better than to use Citadel - plus it saves space!
  162.  
  163. 2)  Abbreviated display for the ".RS" command.  Removed some
  164.     information that is really superfluous.
  165.  
  166. 3)  Citadel:K2NE now uses a FOSSIL driver for all modem I/O routines!!
  167.     Each Citadel:K2NE sysop will have to obtain his/her FOSSIL
  168.     independently.  According to all available documentation,
  169.     "all FOSSILs are created (essentially) equally" so it **shouldn't**
  170.     matter which one is used.  However, this stuff was all tested
  171.     using X00.SYS (Gwinn FOSSIL driver), so I can only "vouch"
  172.     for that one!
  173.  
  174. 4)  Module LIBFOSSL.C added to the CN library for CTDL.EXE and CONFG.EXE.
  175.     Function "interpret()" has been removed from Citadel since
  176.     it is now completely superfluous.  The FOSSIL now handles
  177.     ALL modem control and I/O functions.
  178.  
  179. 5)  Modified Configurator to take #modemSetup and write it out
  180.     to INITLINE.SYS, and modified Citadel to look for INITLINE.SYS
  181.     at boot-time and grab the modem initialization string from it.
  182.     Configurator version bumped to 11.  Citadel:K2NE version
  183.     major-release series bumped to 6.  Beginning with Version 6.01,
  184.     the new (Version 11.1) configurator will be REQUIRED.
  185.     All "mini-interpreter" routines in CTDLCNFG.SYS should be
  186.     either removed or disabled (by indenting a space) except for
  187.     the "#alldone" line.  Configurator (V11.1) will check for
  188.     existence of an active FOSSIL driver and will NOT permit
  189.     Citadel to be configured until a FOSSIL is properly installed.
  190.  
  191.     NOTE:  The presence of a "#modemSetup" line in CTDLCNFG.SYS is
  192.            absolutely essential.  If it is not there, you still will
  193.            get a "Must have either #modemSetup or #INIT_PORT" note,
  194.            and the configurator will bomb.  DO NOT USE #INIT_PORT.
  195.            Citadel:K2NE now ignores it, will not look for it, and you
  196.            will (subsequently) NOT generate an INITLINE.SYS file
  197.            unless you have a "#modemSetup" specified.  The FOSSIL
  198.            will be properly pointed at the COMport you specify with
  199.            your #COM setting, and your modem will reset between
  200.            calls (and between net calls and net sessions) at the
  201.            baud-rate you specify in #SYSBAUD.  DO NOT ATTEMPT TO
  202.            MANUALLY EDIT "INITLINE.SYS" - let the Configurator
  203.            do it for you!
  204.  
  205.     NOTE:  The stand-alone CITANET.EXE (tm) networker has not yet been
  206.            updated for FOSSIL compliance.  DO NOT attempt to use
  207.            any Version 5.xx CITANET (tm) utility.  The CtdlTabl.Sys
  208.            file used by a V5.xx CitaNet (tm) is NOT compatible with
  209.            the Citadel:K2NE V6.xx CtdlTabl.Sys and hence, older
  210.            CITANET.EXE programs will NOT RUN!  A new CitaNet (tm)
  211.            utility will be released in the near future.
  212.  
  213.     ["CitaNet" and "CITANET.EXE" are registered trademarks belonging
  214.       to Vince Quaresima t/a K2NE Software.  All rights are reserved!]
  215.  
  216. 6)  Added optional configuration variable "#modemReset" for those who
  217.     need a bit more than "AT" sent to the modem as a "prod" after each
  218.     online session.  Syntax (in CTDLCNFG.SYS) is:
  219.  
  220.     #modemReset "AT etc etc etc etc"
  221.  
  222.     Assuming a Hayes command-set compatible modem, the string should
  223.     start off with "AT".  What follows can be anything you determine
  224.     that your modem should be "told" in order to reset it.  If this
  225.     parameter is not used in CTDLCNFG.SYS, then Citadel will assume
  226.     a reset-string of "AT" and will send this to your modem immediately
  227.     after dropping DTR at the end of each online session.  This should
  228.     hopefully make sure that your modem resets to your SysBaud value
  229.     in between each use.  Do not use "\r" or "\n" at the end of this
  230.     string (same goes for #modemSetup).  Citadel will append it for you.
  231.  
  232. 7)  Added optional configuration variable "#DTR-DELAY" for those who
  233.     have modems which need a bit extra time to drop carrier when
  234.     DTR is pulled down.  If your modem seems to be having problems
  235.     resetting at the end of a call or between nodes during networking,
  236.     try adding "#DTR-DELAY n" to your CTDLCNFG.SYS file
  237.     (where n is any integer).  For example, "#DTR-DELAY 1" will add
  238.     about 20 milliseconds to the time the system will wait after pulling
  239.     DTR.  "2" would add about 40 milliseconds, "3" about 60 milliseconds,
  240.     and so forth.  You can play with this using CONFG ONLYPARAMS until
  241.     your modem behaves satisfactorily.  In all liklihood you won't need
  242.     to use it, but if you do, values in the range 50 to 80 seem to be
  243.     most appropriate.  The "granularity" of the DTR-delay is on the
  244.     order of 20 milliseconds, so you have lots of "play room" here.
  245.  
  246.  A special note of THANKS goes to three people:
  247.     *  Mike and Margaret Cottle (The Wizard and Wicked Witch) of
  248.        Wicca Citadel, one of our beta sites.
  249.     *  Mike Safaryn (BioMan) of Hornet's Nest Citadel.
  250.  Without their untiring assistance and patience through numerous system
  251.  crashes and networking snafus Citadel:K2NE Version 6.01 would have been
  252.  absolutely impossible!
  253.  
  254. ****************** Special Notes for V5.20 **********************
  255.  
  256. See INCREM.020 for complete details.
  257.  
  258. ****************** Special Notes for V5.19 **********************
  259.  
  260. See INCREM.019 for complete details.
  261.  
  262. ****************** Special Notes for V5.18 **********************
  263.  
  264. See INCREM.018 for complete details.
  265.  
  266. ****************** Special Notes for V5.17 **********************
  267.  
  268. See INCREM.017 for complete details.
  269.  
  270. ****************** Special Notes for V5.16 **********************
  271.  
  272. SEE INCREM.016 FOR COMPLETE DETAILS.  INCLUDES INFORMATION ON
  273. THE FIDONET/CITANET (tm) GATEWAY.
  274.  
  275. ****************** Special Notes for V5.15 **********************
  276.  
  277. FIDOnet (tm) compatibility is HERE!  See the following notes for
  278. more details.
  279.  
  280. SEE INCREM.015 FOR COMPLETE DETAILS.
  281.  
  282. ****************** Special Notes for V5.14 **********************
  283.  
  284. SEE INCREM.014 FOR COMPLETE DETAILS.
  285.  
  286. ****************** Special Notes for V5.13 **********************
  287.  
  288. SEE INCREM.013 FOR DETAILS.
  289.  
  290. ****************** Special Notes for V5.12 **********************
  291.  
  292. Please see INCREM.012 for details on features and facilities
  293. added to this release (V5.12).
  294.  
  295. ****************** Special Notes for V5.11 **********************
  296.  
  297. The major addition to the software for V5.11 is the addition of
  298. "read-only rooms."  Please see INCREM.011 for complete details.
  299.  
  300. ****** Special Notes for Versions beginning with V5.10 **********
  301.  
  302. If you are upgrading to V5.10 (or later!) from any Version 5.x other
  303. than Version 5.09, we strongly recommend that you use the CONFG.EXE
  304. contained in the V5.10 distribution set (or more recent) and when doing
  305. the upgrade on your system, execute "CONFG N" before
  306. bringing up your V5.1x BBS.  In addition, you are STRONGLY ADVISED
  307. to read INCREM.009 THOROUGHLY prior to installing V5.11 (or newer)
  308. as there have been MAJOR CHANGES effecting how we handle "closed login"
  309. with ENTEROK set to 0 and how this relates to the "LOCK" and
  310. "SECURE" parameters.  Please do NOT bombard us with questions
  311. that are adequately answered in that file!!!!!
  312.  
  313. Please see INCREM.009 and CTDLSTAT.DOC for a complete discussion
  314. of CTDLSTAT.EXE and suggestions for its possible use.  CTDLSTAT.EXE
  315. and CTDLSTAT.DOC can be found as part of CTDLUTLS.LZH, contained
  316. as part of DISK-2.LZH (if you are downloading via modem) or on
  317. Citadel:K2NE Distribution Diskette #2 (if obtained otherwise).
  318.  
  319. ******** SYSOPS RUNNING "DOORS"  PLEASE TAKE NOTE!!!! *****
  320.  
  321. Beginning with V5.10, there has been a major change in the method
  322. by which Citadel:K2NE generates the information that is "passed through"
  323. to Doors.  READ INCREM.010, dates 90MAR22 and 90MAR23, for complete
  324. information!!  If you are setting up a NEW SYSTEM, then the automatic
  325. Door-installation procedures in DISK-3 will handle the new procedures
  326. for you, and set up a "sample door" that you can use for future reference.
  327.  
  328. ************************************************************
  329.  
  330. 1: Room traversal commands
  331.  
  332. We have provided the use of "+" and "-" to move between rooms.  If in FLOOR
  333. mode, you can move between adjacent rooms on the same floor.  When not in
  334. FLOOR mode, the commands range over the entire list of rooms on your BBS.
  335. If you have hidden rooms on your system, "+" or "-" will ONLY take a user
  336. to a hidden room if that room is already known to the user.  In the case
  337. of invitation-only rooms, the same thing applies.
  338.  
  339. Please note that "+" and "-" can NOT be used to get to the Mail> room.
  340. This is intentional.
  341.  
  342. A bug that sometimes caused a problem if a floor existed containing no
  343. public rooms has been fixed.
  344.  
  345. 2: Floor traversal commands
  346.  
  347. We have provided the use of ">" and "<" to move between floors.  It is rather
  348. obvious what this will do, and you are encouraged to try it for yourself.
  349. We think you will find it is quite neat and saves quite a bit of time.
  350.  
  351. If a user uses > or < to move between floors, and if the destination floor
  352. does not contain any rooms known to that user, then that floor will be
  353. skipped.
  354.  
  355. Please note that > and < only work when the user is in FLOOR mode.  If the
  356. user is not in FLOOR mode and tries to use these commands, a polite little
  357. note is displayed.
  358.  
  359. 3: Additional command for logging out
  360.  
  361. We have provided ".TY" [.Terminate Yes] as a logout option.  It performs
  362. EXACTLY the same way as ".TQ" and is provided so that those users in parts
  363. of the country where the Protosoft IdeaTree (c) program is used will be able
  364. to use their terminal SCRIPT files and/or macros with a minimum of fuss.
  365.  
  366. You will find the file LOGOUT.MNU included in your Citadel package.  This
  367. file is to be placed in your HELPAREA directory, and is used in conjunction
  368. with the new logout command-set.
  369.  
  370. 4: Known Room reporting options [starting with Ver 4.01]
  371.  
  372. We have modified the ".K" command for selective reporting of roomnames
  373. known to the logged-in user by "room type".
  374.  
  375.    1) .KA -- known Anonymous rooms
  376.    2) .KP or .KH -- known Private/Hidden rooms
  377.    3) .KD -- known Directory rooms
  378.    4) .KZ or .KF -- known Forgotten rooms
  379.    5) .KN -- known Networked rooms
  380.    6) .KR -- known Rooms <user-stipulated matching-string>
  381.  
  382. For your convenience, we have included KNOWNOPT.MNU for you to place in
  383. your HELPAREA directory which works in conjunction with this command-set.
  384.  
  385. 5: DOORS!!!!!
  386.  
  387. Yes, you read it correctly.  Citadel:K2NE, starting with the Ver 4.01
  388. release, now supports DOORS.  Rather than blow the size of this file
  389. out to an absurd amount, we have set up a separate utility package
  390. (CTDLDOOR.ARC) which contains full instructions on how to implement
  391. the DOORS options for your Citadel:K2NE system.  If the idea of DOORS
  392. simply turns you off, or if you don't have the space or desire to
  393. use it, simply ignore it.  If a user tries to execute any DOORS-related
  394. command on your system, the BBS will simply report that DOORS are not
  395. being supported.  If you DO want the DOORS capability for your system,
  396. you will need to obtain the CTDLDOOR.ARC file, either from Jersey
  397. Devil or any Citadel:K2NE system supporting DOORS.  Please take note that
  398. we do things a bit differently than PCBoard, RBBS, or STadel-PC, and
  399. there is no guarantee that a "door" which works for those systems
  400. will work with ours (or vice-versa).
  401.  
  402. Currently, we make no distinction between "ordinary user DOORS" or
  403. "Aide DOORS" or "Sysop DOORS".  This will be forthcoming with
  404. subsequent updating of the software.
  405.  
  406. 6: For System Aides and Remote Sysops
  407.  
  408. We have added the following commands for all Aides:
  409.    1) .AQS -- Aide Query System-log
  410.        This will type out the currently active CALLLOG.SYS file, if present.
  411.    2) .AQN -- Aide Query Network-log
  412.        This will type out the currently active NETLOG.SYS file, if present.
  413.    3) .AQU -- Aide Query Userbase
  414.        This will type out a report of the entire database of valid users for
  415.        your system, showing some of their config switch settings and other
  416.        neat and clever goodies.   The headings in this report are as follows:
  417.            a) No.:   An index number for convenience only
  418.            b) Name:  User-name
  419.            c) Aide:  If user is Aide then "yes" - else "no"
  420.            d) Exp:   Expert or Novice userlevel of user
  421.            e) Wid:   Terminal/screen width of user
  422.            f) FM:    Floormode (yes or no)
  423.            g) LF:    Linefeeds (1 for yes; 0 for no)
  424.            h) NP:    Net privs (1 for yes; 0 for no)
  425.            i) LDC:   Long-distance credits (yes/no)
  426.            j) NFM:   Net-forward mail (1 for yes; 0 for no)
  427.            k) KR:    Has the user been in this room (changes for each room)
  428.            l) Log:   Log number as used by LOGEDIT etc.
  429.    4) .AQBS - Aide Query Backup System-log
  430.        Rather obvious, as is the next one...
  431.    5) .AQBN - Aide Query Backup Network-log
  432.  
  433. These commands can be used by any Aide while in any room.  The room need
  434. not be a directory room.
  435.  
  436. The following commands are for Remote Sysops, or Aide-at-Console:
  437.    1) .ADS -- Aide Delete System-log   [These two commands are gone as of
  438.    2) .ADN -- Aide Delete Network-log   V5.10]
  439.  
  440. In both cases, the current CALLLOG.SYS (or NETLOG.SYS) is renamed to
  441. the appropriate ".BAK" file and a new file is started.
  442.  
  443. We have changed the format of the messages written to the CALLLOG.SYS file
  444. to make it a bit more readable.  In addition, several user activities are
  445. reported to the file that were not in prior versions.  All user uploading
  446. and downloading, as well as chat requests, net sessions, and a few other
  447. goodies, are now reported to the CALLLOG.  The new format, however, means
  448. that certain "old-style" utilities that depended on the format of the
  449. old CALLLOG.SYS file may not work.  Specifically, you will more than likely
  450. have serious problems with CALLSTAT.EXE and similar "independent" programs.
  451.  
  452. Note:  If your present Citadel is using the old-style CALLLOG.SYS format,
  453.        the results on screen using .AQ will appear quite strange.  Not to
  454.        worry!  As soon as you start a new CALLLOG.SYS file, all will be
  455.        just fine!
  456.  
  457. 7: For the Sysop
  458.  
  459. a) V5.19 permits you the option of being able to view a user while that
  460. user is in the Mail> room or in an Anonymous room.  It is our belief that
  461. in this day and age of frivolous litigation, a sysop should be able to know
  462. what is happening on his BBS at all times.  It is also rather contrary to
  463. what has become "Citadel tradition" to do this.
  464.  
  465.        1) to enable the "visible mail room", simply press CTRL V at any
  466.           time while the system is idle.  A message will be displayed to
  467.           the console screen at that time which will show you the status
  468.           of your Mail> room.  This will also determine whether you can
  469.           watch your user while in an Anonymous room.
  470.        2) your users will NOT know which way you have your system set up, nor
  471.           will your Aides.  The only "signal" the system gives is a status
  472.           statement that appears on Console Screen ONLY.  Try it and you will
  473.           see what is meant.
  474.        3) The status will NOT change in between calls, or during a call,
  475.           unless you toggle it using CTRL V.  The system defaults to
  476.           "privacy" mode at bootup.
  477.  
  478. b) For a minor cosmetic change, when a caller logs in, and again at logout,
  479. the time is displayed (in "civilian" time) to the caller and (obviously) on
  480. your system console.  Also, your SPACEbar can be used to PAUSE the display
  481. whenever the system is typing (same as the "P" key).  You may want to tell
  482. your users about this as well.
  483.  
  484. c) Your Status Bar has been modified to reflect the following:
  485.  
  486.        1) the baudrate of the online user will appear to the left of the
  487.           user's name on the status bar.  "S" indicates logged-in at
  488.           the system console.
  489.        2) In between calls, the name of the last logged-in user will
  490.           display to the status bar.  Obviously, nothing will appear here
  491.           when you first bring the system up.
  492.        3) If you are using Anytime Net outdialing, when your BBS checks
  493.           to see if it is necessary to make a call-out for networking, this
  494.           "mini-event" will appear on the status bar along with the
  495.           "decision" as to the need for networking at that time.
  496.        4) The status bar has been relocated to the bottom of your console
  497.           screen (at least for IBMs...).  In addition, we have freed up one
  498.           additional line for sysConsole display, giving you 24 lines.
  499.  
  500. d) Ver 5.xx contains some changes in the way in which your NETLOG.SYS file will
  501. appear to you.  This was done primarily to make our work easier in debugging
  502. the modifications needed to the networker in order to add the code for the
  503. Flashmail! and Net_Switch capabilities.  This release fully supports
  504. AnyTime Net, with a bit of streamlining added to the inner workings of the
  505. networker to help cut down on your phone bill expenses.  It is TOTALLY
  506. compatible with standard C86-Net networking.  Please note the following:
  507.  
  508.        1) You may trigger Anytime Net whenever your system is idle.
  509.           To do this, simply press F2 (QuickNet).  If there is work
  510.           to be done, your system will immediately go to Anytime Net
  511.           mode to do this work.  It will stay in Anytime Net mode until
  512.           the work is completed or until the "duration" part of your
  513.           DEADTIME parameter has expired (whichever occurs first).
  514.        2) You may break your system OUT of Anytime Net mode in between
  515.           network calls by pressing your ESC key.
  516.        3) We have rearranged the format of the Network Node List that
  517.           you see when you choose the <N>et <V>iew option in the
  518.           Sysop Function menu.  It will be much easier for you to see
  519.           which nodes are DISABLED using the new display format.
  520.        4) You may also view the current status of your network nodes
  521.           by pressing F3 at any time the system is idle.
  522.  
  523. e) Here is a brief overview on how Citadel:K2NE handles your log
  524. record of caller-activity in the CALLLOG.SYS file:
  525.  
  526.     a) The reporting format of the file now generally follows the format
  527.           DATE  TIME: [action]
  528.  
  529.        For example:
  530.          88Jul01  3:15pm: Joe Twit logged on
  531.          88Jul01  3:22pm: Operator called by Joe Twit
  532.          88Jul01  3:31pm: File "filespec.ext" in BBS News] downloaded by
  533.                           Joe Twit [Jmodem transfer]
  534.          88Jul01  3:40pm: File "testfile.doc" uploaded to a private
  535.                           room by Joe Twit [Xmodem transfer]
  536.          88Jul01  3:45pm: Joe Twit logged out
  537.  
  538.        For file downloading, only PROTOCOLed downloading is reported to the
  539.        log file.  It is our belief that reporting ASCII buffer-capturing of
  540.        textfiles would lead to a lot of essentially unimportant information
  541.        being dumped to the log file.
  542.  
  543.        As noted previously, the Aide-level command ".AQS" is the method of
  544.        choice for reading the CALLLOG.SYS file while logged in, whether via
  545.        modem or from the system Console.  The method we employed to do this
  546.        should simply report "no calllog.sys" in the event your Citadel:K2NE
  547.        is not set for the CALLLOG option in your CTDLCNFG.SYS file.  If you
  548.        spot any problems because of this, please let us know right away,
  549.        and we will arrange a fix.
  550.  
  551.  
  552.     b) The unfortunate side-effect of these changes is that any pre-existing
  553.        system-management utilities that used CALLLOG.SYS in conjunction with
  554.        other Citadel-related bulletin boards for the PC clone family
  555.        probably will no longer work.  [Well, you can't have EVERYTHING!]
  556.  
  557. f) Starting with Version 3.09.05 (88Jul08) we incorporated the AnyTime
  558.    Net capabilities of the "Twin Cities" Citadel-86 V3.09.  For complete
  559.    information on how to use this, please consult ANYTIME.DOC which is
  560.    contained in the ARCed CTDLRUN file.  You also need the CONFG.EXE file
  561.    contained in that package, or any of the "K2NE" configurators beginning
  562.    with Ver 3.09.07.
  563.  
  564. g) If you are running your system to automatically detect the baudrate
  565.    of an incoming caller and if you have any sort of problem with
  566.    your modem resetting to its highest baudrate between calls (or after
  567.    a networking session), or if your system does not RELIABLY detect
  568.    the caller's baudrate, then you may need some patches to your
  569.    CTDLCNFG.SYS file.  If you are not "intimately familiar" with the
  570.    way these "mini-interpreter" routines operate, we have prepared
  571.    "canned" patches for you.  They are available at Jersey Devil
  572.    Citadel (609 893-2152).
  573.  
  574.    Note:  Several minor tweaks of the original "Minnesota" source code
  575.           were needed to get this to work with absolute reliability.
  576.           If Ver 5.19 is your first venture into the "K2NE style" of
  577.           Citadel, you may have to do some fiddling as the old-style
  578.           code had its share of problems with auto-baudrate-detection.
  579.  
  580.           Also, we have encountered problems where some modems will cause
  581.           customized system banners (BANNER.BLB files) to be prematurely
  582.           "chopped" when a call is detected.  To date, we know that the
  583.           Everex 2400bps modems do this.  Others may.  Hayes, Supra and
  584.           Avatex modems do not have this problem.  We suspect that other
  585.           true-Hayes-compatible modems also will not have this problem.
  586.           The reason this happens is that the modems involved apparently
  587.           send a "verbose" message (even when set to numeric-response
  588.           mode) whenever they detect a carrier at less than their highest
  589.           possible baudrate.  This message contains either "S" or "N"
  590.           (or both) and Citadel interprets this as if the user aborted
  591.           the banner typeout.  We have a fix, but since it is not a major
  592.           problem, the fix is "not yet in."
  593.  
  594. h) If you set your READOK parameter to 0 in your CTDLCNFG.SYS file, this
  595.    causes your system to configure so that a user must be LOGGED IN to
  596.    read messages.  We made a minor adjustment in this.  Your users will
  597.    be able to read messages in your BASEROOM ("Lobby>" or whatever you
  598.    call it) REGARDLESS of how you have your READOK parameter set.  This
  599.    is to allow you to let a new user know that his account has been
  600.    set up (if you are running "closed" login with LOGINOK set to 0).
  601.    This ONLY affects your BASEROOM.  If you have READOK set to 0,
  602.    unlogged callers will ONLY be able to read your BASEROOM messages.
  603.  
  604. i) The runtime-code release Citadel:K2NE no longer supports the Zenith
  605.    MS-DOS machine.  The Zenith support IS still in the source-code.
  606.    If you are running Citadel on one of these machines you have two
  607.    options:
  608.  
  609.     1) Contact Jersey Devil (609 893-2152) or Morningstar Keep (609 953-8010)
  610.        and leave mail to the sysop.  Either Vince or Brian will be happy
  611.        to compile the Zenith version for you and put it in a DIR room for
  612.        you to download.  You may also obtain the code via US Mail.  Leave
  613.        mail to the sysop requesting a mailing address.
  614.  
  615.     2) Download (or obtain via US mail) the source code and compile it
  616.        yourself.  This is ultimately the best solution since you will then
  617.        be able to tailor the system to your precise preference.  In order
  618.        to do this you will more than likely have to use the Borland
  619.        Turbo C compiler (or go through a LOT of agony "massaging" the
  620.        code to the specifications of any other compiler).  We have been
  621.        using Turbo-C Ver 1.5, and will be switching to Ver 2.0 in a few
  622.        weeks.  While Turbo-C has its critics (and its faults) we have
  623.        found it to be relatively easy to use, and the code it generates
  624.        is fast and reasonably "tight."  We include our MAKEfiles and
  625.        all other compiler-oriented "script" files along with the source.
  626.        Naturally, these files are set up specific to the way that the
  627.        compiler is installed on our software-development machines.  We
  628.        will be glad to assist you in getting your compiler set up to
  629.        "conform" with ours if you have difficulty in getting it to work.
  630.        If you need help with any of this, be sure to include your
  631.        TURBO C REGISTRATION SERIAL NUMBER with any request for assistance.
  632.        While Citadel:K2NE is public domain, the C compiler is not!!
  633.  
  634. j) Function keys and other administrivia...
  635.  
  636.    While the system is idle, you may use your function keys as follows:
  637.  
  638.      F1: This will backup your CALLLOG.SYS and NETLOG.SYS files and start
  639.          new ones.  If you are not using a netlog, it will bypass the
  640.          netlog backup although it still will appear on screen as if it
  641.          were backing it up.
  642.  
  643.      F2: This will trigger Anytime Net (if there is work to be done).
  644.  
  645.      F3: This will display your list of network nodes, along with the
  646.          work-status of each node.  If no work-note appears for a node,
  647.          then that node does not need to be called.  The numbers
  648.          which appear along with the work-status are the numbers of the
  649.          net(s) to which that node belongs.  If you have nodes that are
  650.          not members of any net, then they will appear as DISABLED.
  651.          You may still use the <N>et <D>ial function to call those
  652.          nodes from your Console.
  653.  
  654.      F4: This will allow you to exercise any of the network administrative
  655.          functions formerly restricted to the CTRL-L/N area.  For your
  656.          convenience, a file called NETKEYS.BLB is included with the
  657.          Ver. 5.19 miscellaneous file-set.  There is nothing "magical" or
  658.          special about the structure of this file.  You may edit it to
  659.          suit your pleasure.  If the file is not present, Citadel will
  660.          run quite nicely in its absence.
  661.  
  662.   ALT X: You may use ALT X to exit from Citadel to MS-DOS.  The old method
  663.          (CTRL-L/X/Y) still works.  If you press ALT X you will be asked
  664.          to confirm your decision.  Answering "Y" will bring you to DOS
  665.          following an orderly shutdown of Citadel:K2NE.
  666.  
  667. k) Odds and ends, bugs, and other miscellany...
  668.  
  669.    1.  The DEBUG_SWITCH option in the Sysop menu has been made a compile-time
  670.    option and is not available in the runtime fileset.  This is true, also,
  671.    of other options in that menu that are not directly supported due to their
  672.    "program-debugging" function.  They serve no real purpose during ordinary
  673.    use of the software, but they are still available in the source files for
  674.    those of you who wish to engage in the friendly art of CitaTinkering!
  675.    However, we must caution you that if you activate those functions without
  676.    complete knowledge of what they do (and the implications of what they do)
  677.    you are on your own!
  678.  
  679.    2.  You may notice cryptic references to a "dialing directory" in several
  680.    areas of the source-code.  This may come in a later release, and more
  681.    details will be available at that time.
  682.  
  683.    3 thru 5 omitted - dated material.
  684.  
  685.    6.  If your system goes into an Anytime-Net session which SPANS
  686.    the midnight (change of date) hour, it will not come OUT of that
  687.    session without manual intervention (ESC works just fine).  Until
  688.    we fix it, the best thing for you to do is simply structure your
  689.    #event coding in CTDLCNFG.SYS to avoid ANYTIME-NET around midnight.
  690.    Make sure that any nodes netting TO you do the same thing.  This
  691.    is one bug that we will put a priority on swatting.
  692.  
  693.    7 omitted - dated material.
  694.  
  695.  
  696. ---------------------------------------------------------------------------
  697.    In the interest of brevity, additions and enhancements relevant
  698.    to the ongoing development of enhancements for Citadel:K2NE
  699.    are included in our running INCREM series of modification
  700.    reports.  These have been included in the CITGUIDE fileset which
  701.    can be found as part of the DISK-3.LZH package.  You are VERY STRONGLY
  702.    urged to read these "INCREM" files, as they will probably answer most
  703.    of the questions and concerns you may have as you start up your
  704.    Citadel:K2NE system.  Even "us experienced folk" end up referring to
  705.    these files regularly!  Read them.  Dump them to your printer.
  706.    Keep them handy.  They will help you!!
  707. ---------------------------------------------------------------------------
  708.  
  709.  
  710. ===NOTE=== Changes/additions for Function Keys beginning with Ver. 5.03:
  711.  
  712.       F6 will look for a file called FIDODAY.HLP in your HelpArea
  713.          directory and will print it to console screen.  At Jersey
  714.          Devil, we are using that to print the list of EchoMail
  715.          Conferences and the number of new messages in each conference
  716.          as a result of the last link to FIDOnet.  If the file is not
  717.          there, Citadel will ignore it and "repaint" your "awaiting
  718.          call" screen.
  719.  
  720.       F7 will step through the screen BACKGROUND colors.
  721.          This is DISABLED if you are using the "ansi" parameter.
  722.          See INCREM.009 for details.
  723.  
  724.       F8 will step through the screen FOREGROUND (text) colors.
  725.          This is DISABLED if you are using the "ansi" parameter.
  726.          See INCREM.009 for details.
  727.  
  728.       F9 will view your NETLOG file from console while waiting for calls.
  729.  
  730.       F10 will allow you to send a message to an online user when the system
  731.          is at any room> prompt.  At Jersey Devil Citadel, we use this to
  732.          tell the user that the sysop wants to chat with him if he has the
  733.          time.  You can use it, for example, to send a message to the user
  734.          asking him to log off because you need to use your machine, or any
  735.          other use your active imagination can concoct!  The file containing
  736.          the message sent to the user is CHATCALL.BLB, and it goes in the
  737.          same directory as all your other *.BLB files.  If this file is
  738.          not present, the BBS will send "The sysop requests a chat." to
  739.          the user as the "default message."
  740.  
  741. Some Notes on File Encryption
  742. ---- ----- -- ---- ----------
  743.  
  744. Historically, Citadel bulletin boards have used a rudimentary form of
  745. file encryption to protect some of the system files from "prying eyes."
  746. It is our contention that this encryption was, for all practical purposes,
  747. useless.  It required nothing in the way of "computer knowledge" to access
  748. files which have heretofore been encrypted by this means.  In addition,
  749. the presence of the encrypt/decrypt code in the software caused an added
  750. "step" every time messages would be saved or read.  Another disadvantage
  751. to encryption was that file-compression utilities such as ARC, PKARC,
  752. PKPAK, PKZIP or ZOO would result in absolutely no space conservation
  753. for those sysops wishing to backup their system files to floppy disk,
  754. forcing them to resort to more complex backup utilities in those
  755. instances where the size of the files (particularly CTDLMSG.SYS)
  756. exceeded the capacity of the standard 360K diskette.  By removing
  757. encryption, we have found that a 650K message-file will usually compress
  758. to a size small enough to be stored on a standard floppy.  In addition,
  759. the improvement in system speed and reduction of executable code size
  760. more than justifies the removal of encryption in and of itself.
  761.  
  762. The only reason this topic even merits discussion is that we view it to
  763. be our responsibility to warn you NOT to have any directory room on
  764. your system "windowing" onto the directory containing CTDLMSG.SYS,
  765. CTDLLOG.SYS, CTDLROOM.SYS and CTDLNET.SYS.  These are the files that
  766. were formerly encrypted.  As long as you heed this warning, the only
  767. way these files could be viewed by an online user would be if that
  768. user were an Aide with the remote-sysop-password (who could then
  769. create a DIR room opening onto the directory in question), or if you
  770. are running a "drop to DOS" door which a user would be able to access.
  771. Reasonable precautions will enable you to FULLY maintain the security
  772. of these files while still allowing you, as the system operator, to
  773. view them, print them, and compress them for backup purposes.  DO NOT
  774. attempt to EDIT any of these files, as Citadel keeps records of pointers
  775. which may then skew resulting in major problems.
  776.  
  777. How Do I Convert My Encrypted System?
  778. --- -- - ------- -- --------- ------
  779.  
  780. 1. Obtain the file CITCNVRT.ARC.
  781. 2. BACK UP your current CTDL.EXE, CONFG.EXE and CTDLCNFG.SYS files!!
  782. 3. UnARC the file into the directory containing your existing CTDL.EXE,
  783.    CONFG.EXE, and CTDLCNFG.SYS files.
  784. 4. Make SURE you BACK UP your current *.SYS files for your existing BBS.
  785. 5. Go to the Directory containing CTDL.EXE, CONFG.EXE and CTDLCNFG.SYS.
  786. 6. At the DOS prompt, type INSTALL and press ENTER.
  787.    At that point, a PreConfiguration routine will execute, preparing
  788.    your system for the UNCRYPT program to operate.  UNCRYPT will begin
  789.    automatically, and once it is done, your system will automatically
  790.    run the new configuration routines.  When all this automagical stuff
  791.    is finished, your de-crypted files will be ready for the new BBS code.
  792. 7. Put the V5.19 CTDL.EXE and CONFG.EXE files where you had your old ones.
  793. 8. Bring your system up.  It should run normally, utilizing the V5.19
  794.    software.
  795.  
  796. What Is TOC_READ.COM
  797. ---- -- ------------
  798.  
  799. TOC_READ is a public domain utility for reading the table of contents
  800. (or "TOC") for archived ARC, PAK, ZIP and LZH files.
  801. We have included it in the CTDLEXEC fileset.  Put it in your
  802. ROOT directory.  Citadel:K2NE V5.19 expects it to be there!
  803. __________________________________________________________________________
  804.  
  805. Easy Installation is Finally Here! [Feb. 17, 1990]
  806. ---- ------------ -- ------- -----
  807.  
  808. The complete set of Citadel:K2NE files is now being distributed in the
  809. form of three LHARCed files, DISK-1.LZH, DISK-2.LZH and DISK-3.LZH.
  810. You should extract each of these files to a SEPARATE FLOPPY DISK.
  811. Place DISK 1 in your A: drive.  Type COPYBBS.  Sit back and watch
  812. the show!  When done, you should have a completely installed and
  813. "ready to run" Citadel:K2NE system.  At that point, all you have to
  814. do is edit the CTDLCNFG.SYS file that you will find in your
  815. "C:\K2NE" directory so that it suits your particular installation.
  816. There are instructions included on one of the DISK-?.LZH files as
  817. to how this should be done.  Please read those instructions!!
  818.  
  819. NOTE!!! If you are ALREADY a Citadel:K2NE system, you
  820. should NOT do this, as it will obliterate your existing BBS files!
  821. __________________________________________________________________________
  822.  
  823.  
  824. ANSI Color Addendum [Feb. 17, 1990]
  825. ---- ----- --------
  826.  
  827. Please read INCREM.009 very carefully for a complete explanation of
  828. how Citadel:K2NE uses ANSI colors.  In this INCREM file, you will find
  829. instructions on how to use the command-line parameters needed to activate
  830. this feature, as well as a list of numeric color-codes.
  831.  
  832. Thanks go to Alan Bowen for his original work on the ANSI color support
  833. code.
  834.  
  835. ZIPfile Support Addendum
  836. ------- ------- --------
  837.  
  838. Beginning with V5.02, Citadel:K2NE now fully supports access to ZIPfiles
  839. via the BBS software.  Your users may view ZIPfile directories using the
  840. command ".RZD" followed by the .ZIP file they want to view.  Note that
  841. UPPERCASE is REQUIRED for the "Z" in this command.  A lowercase "z" will
  842. invoke the ZMODEM command sequence.
  843.  
  844. Your users may also selectively download members of a ZIPfile by using
  845. the command ".RpZF" (where p is the protocol -- Ymodem and Zmodem
  846. are supported for this facility).  Wildcards are supported for selectively
  847. downloading members of a ZIPfile.  The key here is to experiment.
  848.  
  849. To set this up you need to do a few things:
  850.  
  851.   1) put a copy of PKARC in your ROOT directory and RENAME it to
  852.      ARCHIVER.EXE.
  853.   2) put a copy of PKZIP in your ROOT directory and RENAME it to
  854.      ZIPPER.EXE
  855.   3) put a copy of both PKXARC (or PKUNPAK) and PKUNZIP in your
  856.      ROOT directory.
  857.   4) go to the same directory where you should already have a file
  858.      called DEARC.SYS.  Create a file called UNZIP.SYS and on its
  859.      first and ONLY line, put "PKUNZIP.EXE" (without the quotes).
  860.  
  861. If ARCHIVER.EXE is missing, your system will not be able to read
  862. the directory of an ARC file.  Similarly, if ZIPPER.EXE is missing,
  863. your system will not be able to read the directory of a ZIP file.
  864.  
  865. If you do not wish to support downloading selective files from within
  866. ARC files, do not create DEARC.SYS.  Similarly, to defeat the
  867. ability to download selective files from within ZIP files, do not
  868. create the file UNZIP.SYS.  Citadel:K2NE checks for the existence  and
  869. the contents of these two files as you bring the system online,
  870. and if it does not find one or the other, it will disable
  871. the corresponding function automatically.
  872.  
  873. LHARC (LZH) File Support Addendum
  874. ----- ----- ---- ------- --------
  875.  
  876. Beginning with Version 5.03, Citadel:K2NE supports archived files
  877. created using the LHARC.EXE file archiving utility.  If you want
  878. your installation to support this, there are a couple of things
  879. you must do:
  880.  
  881.  1) Put a copy of LHARC.EXE in your ROOT directory.
  882.  
  883.  2) Create a textfile called UNLHARC.SYS in the same directory
  884.     you are using for DEARC.SYS and UNZIP.SYS.  This file MUST
  885.     consist of ONLY ONE LINE of text, and that line MUST be
  886.     exactly "LHARC X" without the quote marks and WITHOUT a
  887.     terminating carriage return.  If you find a file called
  888.     UNLHARC.SYS in the fileset you downloaded, use it.  It should
  889.     only show as being SEVEN bytes long in your directory.
  890.  
  891. The commands for using this from within the BBS are as follows:
  892.  
  893.  1) ".RH" (read LHARC) followed by:
  894.         "D" - read the directory of a LZH filetype
  895.         "F" - read a file contained in a LZH archive
  896.  
  897.  2) ".R[protocol]H" (read [using protocol] LHARC)
  898.        General format is similar to the ".read [protocol] Archive"
  899.        procedures.
  900.  
  901. FIDOnet/RBBSnet Addendum
  902. ------- ------- --------
  903.  
  904. If you are interested in using FIDOnet or RBBSnet, you are referred to
  905. the more than ample documentation and guidelines available for these
  906. excellent conferencing systems.  Such information is readily available
  907. on most bulletin boards utilizing the RBBS-PC software.  At Jersey Devil
  908. we are running SmlNet (Small Network) as our user-interface, and access
  909. it via Citadel's support for Doors.  For further information, contact
  910. Jersey Devil Citadel.
  911.  
  912. File Transfer Addendum
  913. ---- -------- --------
  914.  
  915. Version 5.19 of Citadel:K2NE handles file transfer protocols via
  916. external "protocol drivers."  Currently, XMODEM, 1-K XMODEM, YMODEM,
  917. YMODEM-BATCH, WINDOWED-XMODEM, ZMODEM and JMODEM are supported. We have
  918. had very satifying results with the DSZ.COM protocol handler
  919. utility.  Registration information for DSZ.COM can be obtained by
  920. viewing the DSZ default screen (type DSZ, press ENTER).  There is
  921. no cost for bulletin-board registration of this excellent utility.
  922.  
  923. Similarly, JMODEM can be supported by JMODEM.COM, and WINDOWED-XMODEM
  924. by SUPERK.COM.  The sysop can modify this through manipulation of
  925. the XFERCTL.BAT file as documented elsewhere.
  926.  
  927. We have added <U> and <D> to allow your users to Upload and Download
  928. using Citadel alot more easily than has historically been the case.
  929. The older command-sequences still work, however, since many folks are
  930. using automated "script" files to handle unattended sessions in conjunction
  931. with their terminal software.  A modified set of *.HLP files has been
  932. created, and it includes JMODEM and ZMODEM help information for your
  933. users.
  934.  
  935. Please note that ZMODEM, JMODEM, Windowed-Xmodem and YMODEM (single)
  936. are ALSO supported for message uploading and downloading!  This is,
  937. of course, in addition to XMODEM.
  938.  
  939. When your users do a "protocolled" reading of messages, they will be
  940. given the opportunity to have the message-stream compressed before it
  941. is sent to them.  In order to support this, you should have one of
  942. the following programs in your PATH: ARC.EXE, PKARC.EXE, PKPAK.EXE
  943.  
  944. While it is possible that other utilities may work, these have been
  945. tested and are known to work.  Experiment at your own peril.
  946.  
  947. For more "intimate" details of the development of this aspect of
  948. Citadel:K2NE, please see the INCREM files.
  949.  
  950. Note:  PKARC, PKXARC, PKPAK, PKUNPAK, PKZIP and PKUNZIP are all
  951. the work of Phil Katz and are SHAREWARE programs.  You are referred
  952. to the documentation which accomanies his full releases for complete
  953. details on how they work, how to use them, and how to register your
  954. copies of these outstanding file handling utilities.  Naturally, we
  955. cannot be responsible for how they work, or for any problems you may
  956. encounter in getting them to work on your hardware.  We have never
  957. had the slightest bit of difficulty with any of these utilities, but
  958. we must keep the "legal beagles" happy and disclaim any and all
  959. liability for anything that happens because you are using them.
  960.  
  961. FlashMail! Addendum
  962. ---------- --------
  963.  
  964. The FlashMail! utility is simple in concept and execution.  It allows
  965. Citadel:K2NE to pass mail messages when a user has set his mail-forwarding
  966. address [".ECA"].  Old-style Citadel-86 permitted this, but only from one
  967. system to another.  The mail would stop at the second system even if the
  968. recipient on that system had his address set to some other system.  This
  969. is no longer the case.  Incoming mail for a user will be forwarded out of
  970. the receiving BBS if that user has his forwarding address set.  If the
  971. user has his address set to a LONG DISTANCE node, that user will have
  972. his mail forwarded to that node ONLY IF HE HAS LD CREDITS.  This will
  973. enable you to keep a handle on your LD expenses generated by this utility.
  974. The BBS checks for loops in mail paths so that it is NOT POSSIBLE for
  975. someone of evil intent (or accidental stupidity) to create what we call
  976. a "ping-pong" or "infinite loop" effect.  If the system detects that this
  977. has occured, it will automatically shut off the forwarding flag of the
  978. offending user, thus killing the loop.
  979.  
  980. In addition, as a FlashMail! message "makes its way" toward its ultimate
  981. destination, the RETURN MAILPATH is automatically constructed and imbedded
  982. into the message-header.  Thus, when the recipient elects to respond to the
  983. message, it will automatically make its way back to the original sender.
  984. This acts totally transparent to the BBS and totally invisible as far as
  985. you and your users are concerned.  In order for this "automatic return mail"
  986. feature to work, every system in the path must be running V3.09.07:K2NE or
  987. a more recent update-release of the "K2NE code."
  988.  
  989. Naturally, subsequent releases of the code that we will be making available
  990. will support this, but prior releases of the "K2NE dialect" of Citadel-86
  991. do NOT support this.  Neither do any other "dialects" of Citadel-86 as
  992. far as we know, including "ports" of Citadel code to the Atari ST or the
  993. Commodore/Amiga.  However, ALL OTHER ASPECTS of networked-mail are COMPLETELY
  994. cross-compatible with Citadel-86, as well as STadel and Citadel-68K (as
  995. far as we have been able to determine).
  996.  
  997. Net_Switch Addendum
  998. ---------- --------
  999.  
  1000. The Net_Switch enables you to specify paths for network mail to systems that
  1001. are not on your network node list.  Naturally, this requires cooperation among
  1002. the sysops of each system involved, at least to a certain extent.
  1003.  
  1004. The easiest way to explain this is probably to use an example.  Let's assume
  1005. that a user on your BBS (let's call your system "A") wants to send netmail to
  1006. his friend on system "C".  You do not net with system "C", but you know that
  1007. system "B" DOES net with system "C".  Ideally, system B is local to you, and
  1008. system C is local to system B.  You do not normally net with system B, but
  1009. you have an "agreement" with its operator to allow mail from your node to
  1010. go to his system.  Net_Switch allows this to happen.
  1011.  
  1012. 1) Use an ASCII file editor to create a file called NETPATH.SYS and put this
  1013. file in the same directory that contains your CTDL.EXE program.
  1014.  
  1015. 2) Put the following line in the file:
  1016.  
  1017. >System C: US1231231234 US4564564567|
  1018.   |         |            |          "Pipe" symbol indicates END OF PATH.
  1019.   |        Node ID for  Node ID for
  1020.   |         System B     System C
  1021.  "Human name"
  1022.   for Sys.C
  1023.  
  1024. The line MUST begin with the ">" symbol.  The colon (:) is REQUIRED as is
  1025. the SPACE that comes immediately after it.  The "US" is the Country Code
  1026. and is required.
  1027.  
  1028. You may include up to forty (40) nodes in a single mail-path.  Citadel
  1029. will start "reading" the path at the ">" and will continue reading the
  1030. path until it encounters the "|" symbol.  Spaces and CRs are ignored.
  1031. The only SPACE that is required is the one immediately after the ":"
  1032. character.  The others are included for "readability".   Again, the
  1033. system is coded to detect path loops and to prevent them from hanging
  1034. the networker in a "deadly embrace."
  1035.  
  1036. Also, you are not limited to any number of paths in the file.
  1037.  
  1038. Now let's use a "real world" example.  Here is a short table for three
  1039. Citadel:K2NE systems in our local area:
  1040.  
  1041.   Alternative Reality   US 609 461 6039
  1042.   Willie's Place        US 609 261 4315
  1043.   Galactic Keep         US 609 654 7468
  1044.   Jersey Devil          US 609 893 2152
  1045.  
  1046. Suppose I want to set up a path from Jersey Devil (my BBS) to Alternative
  1047. Reality using the following route:
  1048.  
  1049.  Jersey Devil --> Galactic Keep --> Willie's Place --> Alternative Reality
  1050.  
  1051. I would enter the following line in my NETPATH.SYS file:
  1052.  
  1053. >Alternative Reality: US6096547468 US6092614315 US6094616039|
  1054.  
  1055. "Alternative Reality" does NOT have to be in my normal node list in order
  1056. for this to work.  In fact, if it IS in my normal list, the path will be
  1057. bypassed and net-mail will go directly to Alternative Reality.
  1058.  
  1059. This assumes the following:
  1060.    a) Jersey Devil nets with Galactic Keep
  1061.    b) Galactic Keep nets with (or has a PATH to) Willie's Place
  1062.    c) Willie's Place nets with (or has a PATH to) Alternative Reality
  1063.  
  1064. When a user does a ".EN" to sent net-mail, Citadel:K2NE will FIRST check the
  1065. normal list of net nodes and if it finds the node-destination that the user
  1066. typed in, it will go directly to it.  If it fails to find the node, the BBS
  1067. will then check NETPATH.SYS (if it exists) to see if a path has been set up.
  1068. If it finds no path, it will not let the user enter the message.  If it does
  1069. not find NETPATH.SYS, it will not let the user enter the message.  Thus,
  1070. if you do not WANT to use Net_Switch, simply do not create a NETPATH.SYS file
  1071. and you won't have to worry about it!
  1072.  
  1073. Hopefully this set of examples is clear.  If you don't understand it, please
  1074. feel free to ask Alan or myself for help.
  1075.  
  1076. Note:  To avoid a bug which sometimes causes problems if you do not have
  1077.        a NETPATH.SYS file in place, simply create a file in your Citadel
  1078.        "home area" directory called NETPATH.SYS.  If you do not intend
  1079.        to use the Net_Switch options, the contents of this file are totally
  1080.        irrelevant, but its existence is VITAL on some PC Clones.
  1081.        If your machine is one of these, and if this file is missing, it is
  1082.        possible to cause an apparent "lockup" when using the ".M" command
  1083.        if NETPATH.SYS is missing.To play it safe, just create NETPATH.SYS
  1084.        and forget it!
  1085.  
  1086. <><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><>
  1087.  
  1088. NOTE:
  1089.  
  1090. 1) "CitaNet" and "CitaGate" are registered TRADEMARKS of Vince Quaresima, K2NE.
  1091.    All rights to the use of these trademarks are reserved.
  1092.  
  1093. <><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><>
  1094.  
  1095. DISCLAIMER:
  1096.  
  1097.   The runtime code for Citadel:K2NE Ver 5.19 is hereby and herewith released
  1098. irrevocably into the PUBLIC DOMAIN.  This code is made available with
  1099. absolutely no guarantees or warranties, including (but not limited to) the
  1100. Warranty of Merchantability and the Warranty of Fitness for a Specific Purpose.
  1101. We do not assume responsibility or liability for incident or consequent damages
  1102. of any nature resulting from the use of this software.
  1103.  
  1104. <><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><>
  1105.  
  1106. UPDATES:
  1107.  
  1108.   You are invited to call our BBS, Jersey Devil Citadel (609) 893-2152
  1109. to update your Citadel:K2NE software.  Your comments and suggestions
  1110. will also be welcomed.  We hope you enjoy it!!
  1111.  
  1112.   If you have any problems or questions relating to the installation or
  1113. operation of Citadel:K2NE, and if the copious amount of Citadel-related
  1114. documentation that is "floating around out there" has only managed to
  1115. confuse you further, please feel free to call Jersey Devil and leave
  1116. Mail> to the Sysop with any question you may have.  Please realize that
  1117. Sysop Mail on that BBS is VERY busy, and it may take a few days before
  1118. you receive an answer.
  1119.  
  1120. <><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><>
  1121.  
  1122. FINAL NOTE:
  1123.  
  1124.   There is a LOT of information concerning the development of Citadel:K2NE
  1125. including particulars for each version.  This is contained in a series of
  1126. INCREM.### files which are readily available from Jersey Devil node, and
  1127. probably many other places!  Most of your semi-technical questions are
  1128. probably answerable by a good "read" of these files.  If you have any
  1129. questions, PLEASE obtain and read these files, as your answers are probably
  1130. contained in them!
  1131.  
  1132. <><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><>
  1133.