home *** CD-ROM | disk | FTP | other *** search
/ New Horizons Shareware Collection / HORIZONS1.BIN / ICTXT.IC / CONFIGS.TXT next >
Text File  |  1994-02-27  |  22KB  |  467 lines
  1. ┌───────────────────────────────────────────────────────────────────────────┐
  2. │   ICSETUP.EXE  &  DNICON.CFG                                              │ 
  3. └───────────────────────────────────────────────────────────────────────────┘
  4.  
  5.    ┌DNICON.CFG┐
  6.    └──────────┘
  7.      Is the MAIN config file used by IconUpD.EXE  Make Sure that this 
  8.      file is in the SAME directory as ICONUPD.EXE.
  9.  
  10.      Run ICSETUP.exe to Create or to Edit DNICON.CFG File
  11.  
  12.      ICSETUP will also configure ICMAINT.CFG file.
  13.      
  14.      IMPORTANT - you have to have DNICON.CFG in your IconUpDater directory
  15.      no matter what, even if you are running Multi-line and are using
  16.      DNICONx.CFG.  If you do not your Key probably will not work!
  17.  
  18.      
  19.   ┌ICSETUP.EXE┐
  20.   └───────────┘
  21.    ICSETUP now makes it easier than ever to change or update your 
  22.    information in your config file.  It is now menu drive with
  23.    editable lines on test, no more retyping a Path to a file
  24.    just to change on character!!
  25.  
  26.    Note: When using the line editor in ICSETUP I added to special
  27.    keys.  Ctrl-C will clear the line amd Ctrl-R will replace the
  28.    original text that was there when you first entered the line
  29.    editor.
  30.    
  31.    This Program will Create the Config file "DNICON.CFG" if it does
  32.    not exist; and enter some of the standard information for you.
  33.  
  34.    If your config file DOES exist then ICSETUP will load it so you
  35.    can freely edit each config line painlessly. 
  36.    
  37.    Important - if you are upgrading from an older version then you
  38.    should print out your old DNICON.CFG file, then delete it.
  39.    After you have done that run ICSETUP and create a new DNICON.CFG.
  40.    ** If you are currently running IconUpDater version 2.51, then
  41.    it is O.k to load in the config file from v 2.51.
  42.  
  43.    Make sure you compress ALL you BBS's Icons into a ZIP or ARJ format,
  44.    and specify this FULL Path and Filename in the DNICON.CFG!!
  45.  
  46.   ┌Multi-Line┐
  47.   └──────────┘
  48.  
  49.    SysOps...   You can now create Multiple CONFIG files in the same
  50.    directory as ICONUPD.EXE (meaning NO multiple copies of the program.)
  51.      
  52.    Special NOTE! When you use the "Save as..." command in ICSETUP, and
  53.    you want to Save Multiple Configs.  Make sure you save the original
  54.    DNICON.CFG file first and exit ICSETUP, then re-run ICSETUP and
  55.    select "Save as..." to make multiple Config Files.
  56.  
  57.        The multiple config file names go something like:
  58.  
  59.                  DNICON.CFG    <--- Main CONFIG.FILE
  60.                          (You MUST have this file
  61.                           in your IconUpDater's DIR
  62.                           regardless of the number of
  63.                           nodes you have.)
  64.                  DNICON1.CFG   <--- Node 1 Config File
  65.                  DNICON2.CFG   <--- Node 2 Config File
  66.                  DNICON3.CFG   <--- Node 3 Config File
  67.                  DNICONx.CFG   <--- Node x Config File
  68.  
  69.  |----------------------------*-Wildcat Only-*------------------------------|
  70.  |                                                                          |
  71.  |      When IconUpDater starts up it reads in the environment variable     |
  72.  |      %WCNODEID% if you have your config file set to Multi-line "Y".      |
  73.  |      Then IconUpDater adds this variable to the end of your door.sys     |
  74.  |      and reads in your DNICONx.CFG....  for example:                     |
  75.  |                                                                          |
  76.  |              say a user calls in on node #4 then IconUpDater will        |
  77.  |              first look for DNICON4.CFG. and read in the proper info,    |
  78.  |              like the IRQ for Node#4 and the Locked Baudrate. Then       |
  79.  |              it will look for c:\wc30\wcwork\node4\door.sys, and next,   |
  80.  |              it will search for c:\wc30\wcork\node4\userinfo.dat         |
  81.  |                                                                          |
  82.  |              Get the picture?   I hope this make it easier on you.       |
  83.  |                                                                          |
  84.  |--------------------------------------------------------------------------|
  85.  
  86.    For other BBS software packages:
  87.  
  88.     In your login1.bat or door.bat pass the node # there...
  89.  
  90.     ex.          
  91.            c:                             c:
  92.            cd\DownIcon                    cd\DownIcon
  93.            iconupd 2          or          iconupd %1
  94.            cd\bbs                         cd\bbs
  95.            exit                           exit
  96.                ^
  97.                |--- this would load DNICON2.CFG file!
  98.              
  99.  
  100.      More on Configs:
  101.  
  102.       To change a Node# Config file, just pass the number to             
  103.       ICSETUP when you run in from the DOS prompt... like so...
  104.                                       
  105.                c:/>ICSETUP 2
  106.  
  107.          This will run ICSETUP with DNICON2.CFG loaded. 
  108.  
  109.  
  110.  
  111.    Making Duplicate Config files... the easy way:
  112.  
  113.  
  114.        ICSETUP will duplicate Node# Configs for ya also... 
  115.        Select "Save As..." from the main menu then select
  116.        Multiple, then type the number of confgis you want to 
  117.        create.  If you enter "5", then ICSETUP will create
  118.        DNICON1.CFG DNICON2.CFG ...  DNICON5.CFG.
  119.  
  120.  
  121.        REALIZE that you MUST compress all your icons for your BBS
  122.        into one ALLICONS.ZIP file... or ARJ file. Once you do this
  123.        and specify the path to this file in your DNICON.CFG file,
  124.        which ICSETUP makes for you, IconUpDater, along with
  125.        ICMAINT, will keep track of when you update your icons,
  126.        whether you add them, remove some, or just change them...
  127.        see ICMAINT.EXE for more info....
  128.  
  129.   DigiBoards - You must specify FOSSIL on the IRQ line to of the config 
  130.        file. You should also specify DIGI on the Base Address line 
  131.        of the config file. Run ICSETUP.exe.  When you specify DIGI 
  132.        on line #3, IconUpDater reads in the environment varible 
  133.        WCPORTID, to make sure the program pass the proper port 
  134.        to the com routines.
  135.  
  136.   Fossil - 
  137.        1st DO NOT setup IconUpdater to run Fossil unless you
  138.        are running DigiBoard or have talk to Ryan.
  139.  
  140.        When running DigiBoard and/or Fossil you must use Streamline's
  141.        SDPF.EXE file.  This is a Fossil driven trasfer protocol, that
  142.        supports X,Y,Z and more modem.  DSZ & GSZ do not support Digi,
  143.        or fossil.  When you specify FOSSIL on line #2 of the config,
  144.        IconUpDater ignores whatevr is on line #7 (the GSZ or DSZ).
  145.  
  146.        When using Digi and/or fossil you must set an environment 
  147.        variable in your AUTOEXEC.BAT...:  SET DSZPORT=DSZ.LOG
  148.        If you do not set this then SDPF transfer protocol will not
  149.        function properly, you must also Turn On the Fossil Driver or
  150.        turn on the fossil drive for that com port.
  151.  
  152.  
  153.      ICSETUP is very well document as your run the program, so there is
  154.          not much here on it.  Feel free to call me if you have any
  155.          questions.  My number is at the end of this document.
  156.  
  157.    * Imortant *
  158.          DO NOT FORGET to fill out the ICMaintenance part of 
  159.          ICSETUP, or IconUpDater will not work properly.
  160.  
  161.          You MUST have a directory setup with only your BBS icons
  162.          that your are current using on your BBS!  IconUpDater and
  163.          ICFILE.EXE and ICMAINT.EXE will all access and utilize this
  164.          directory so you must have it.  You must have ICMAINT.CFG
  165.          and ICMAINT.EXE in your IconUpDater directory!
  166.          You MUST have a ZIP or ARJ file of all your icons and
  167.          specify the full path and filename to where this ZIP or
  168.          ARJ file is. (and they can't be in your icons directory!)
  169.  
  170.  
  171.  
  172. ┌───────────────────────────────────────────────────────────────────────────┐
  173. │   CONFIG FILE PRINTS OUT WITH DESCRIPTION FOLLOW....                      │ 
  174. └───────────────────────────────────────────────────────────────────────────┘
  175.  
  176.  
  177.  
  178. WILDCAT                 < 1>..BBS software package. (or NON-WILDCAT)
  179. 0                       < 2>..IRQ# (run ICSETUP.EXE for more Info.)
  180. 0                       < 3>..base address if needed (RUN ICSETUP for this!!)
  181. 19200                   < 4>..Locked BaudRate (leave at 19200 unless Higher)
  182. N                       < 5>..Multi Line BBS (Y/n) (run ICSETUP for more info)
  183. c:\wc30\wcwork\node1    < 6>..Path to your Door.sys file (just the path)
  184. c:\gsz\gsz.exe          < 7>..The Full patht o Gsz or DSZ.
  185. Demo Version            < 8>..Your BBS name if Registered! (see NOTE)
  186. USA                     < 9>..Date Format "USA"= Month/Day/Year
  187. Ryan                    <10>..Sysop's First Name
  188. Andersen                <11>..Sysop's Last Name
  189. Y                       <12>..(Y/N) Local Waring sounds ON (yes or no)
  190. 07/29/93                <13>..Date you last updated your BBS's ICONS
  191. Y                       <14>..Allow ANSI caller (Yes or No) (should be Y)
  192. d:\icons\duoicpak.zip   <15>..FULL Path and filename of your ALL ICON Packet.
  193. Y                       <16>..Scan user Last Time On Date to run ICUPD Y or N
  194. 0                       <17>..Minimum security level access (see sysop.txt)
  195. N                       <18>..Force [A]uto Icon Scan D/L (Y/N)
  196. ON                      <19>..(ON/OFF)-Icon Scan Percentage Complete Bar
  197. embership File          <20>..#1 Optional Menu item description 
  198. M                       <21>..Optional Menu item Hot Key #1
  199. D:\digital\duonline.reg <22>..FULL Path and filename to downloaded #1
  200. DUOnline.REG 2.2        <23>..50 Char.Desc. or "DOOR" to run another door(#1)
  201. 0                       <24>..Minimum security level to access #1
  202. Y                       <25>..Forced File (Y/N) #1
  203. he Download Door        <26>..#2 Optional Menu item description 
  204. T                       <27>..Optional Menu item Hot Key #2
  205. C:\dldoor\dldoor.exe    <28>..FULL Path and filename to downloaded #2
  206. DOOR                    <29>..50 Char.Desc. or "DOOR" to run another door(#2)
  207. 0                       <30>..Minimum security level for access #2
  208. N                       <31>..Forced File or Door on user. (Y/N) #2
  209. et RIPterm 1.53         <32>..#3 Optional Menu item description 
  210. G                       <33>..Optional Menu item Hot Key #3
  211. D:\rip\riptm154.exe     <34>..FULL Path and filename to downloaded #2
  212. RIPterm version 1.54    <35>..50 Char.Desc. or "DOOR" to run another door(#3)
  213. 0                       <36>..Minimum security level to access #3
  214. N                       <37>..Forced File (Y/N) #3
  215. c:\wc30                 <38>..Path to WildCat Activity Log
  216. 15                      <39>..Maximum Icons before enabling auto sending.
  217. N                       <40>..RIP callers ONLY (Y/N)
  218. Y                       <41>..Prompt QModem Pro Users (Yes/No)
  219.  
  220.       A break down of the above follows.......
  221.  
  222.    NOTE! : this must be exactly "Demo Version" or IconUpDater will
  223.        NOT run.  If you have paid for a registered copy then put
  224.        your BBS's name here exactly how you spelled it when you
  225.        reegistered it.  NOTE: It is Case Sensitive.
  226.  
  227.  
  228.            USE ICSETUP TO SETUP THIS CONFIG FILE.!!!!!!
  229.  
  230.  
  231.     ===================================================================              
  232.                Details follow.....
  233.  
  234.   - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  235.  
  236. This is the first part of ICSETUP.EXE
  237.  
  238.             [ General Setting ]
  239.  
  240. WILDCAT                 < 1>..BBS software package. (or NON-WILDCAT)
  241. 0                       < 2>..IRQ# (run ICSETUP.EXE for more Info.)
  242. 0                       < 3>..base address if needed (RUN ICSETUP for this!!)
  243. 19200                   < 4>..Locked BaudRate (leave at 19200 unless Higher)
  244. N                       < 5>..Multi Line BBS (Y/n) (run ICSETUP for more info)
  245. c:\wc30\wcwork\node1    < 6>..Path to your Door.sys file (just the path)
  246. DSZ                     < 7>..Protocol Engine (can only be DSZ or GSZ)
  247.  
  248.      One note here... the base address on line #3.  If you are runn
  249.      a standard setup such as COM 1 & IRQ 4 or COM 2 & IRQ 3 then
  250.      leave line #2 and line #3 at "0".  But if you are running a non-
  251.      standard setup such as COM 3 & IRQ 5... NO problem, I have tested
  252.      this on my system... just put IRQ "5" on line #2 and "3E8" on
  253.      line #3. If you are running non standard set ups then you probably
  254.      know what the port addresses are and what IRQs you are running.
  255.  
  256.  
  257.  
  258.               [ BBS SETUP ]
  259.  
  260. Demo Version            < 8>..Your BBS name if Registered! (see NOTE)
  261. USA                     < 9>..Date Format "USA"= Month/Day/Year *
  262. Ryan                    <10>..Sysop's First Name
  263. Andersen                <11>..Sysop's Last Name
  264.  
  265.       Pretty straight forward.  I just ask for your BBS initials
  266.       for those situations when a lengthly name like "Digital 
  267.       Universe Online BBS" is too long for displaying on a particular
  268.       part of the screen.
  269.  
  270.       * NEW * The Date Format. If you use standard USA date format of
  271.       Month/Day/Year (MM/DD/YY), then put USA in all CAPS.
  272.       For a Date Format of DD/MM/YY, leave it BLANK.
  273.  
  274.  
  275.               [ ICON SETUP ]
  276.  
  277. Y                       <12>..(Y/N) Local Waring sounds ON (yes or no)
  278. 07/29/93                <13>..Date you last updated your BBS's ICONS
  279. Y                       <14>..Allow ANSI caller (Yes or No) (should be Y)
  280. d:\icons\duoicpak.zip   <15>..FULL Path and filename of your ALL ICON Packet.
  281. Y                       <16>..Scan user Last Time On Date to run ICUPD Y or N
  282. 0                       <17>..Minimum security level access (see sysop.txt)
  283. N                       <18>..Force [A]uto Icon Scan D/L (Y/N)
  284. ON                      <19>..(ON/OFF)-Icon Scan Percentage Complete Bar
  285.  
  286.   Some notes here:  Line #13 will be automatically updated if you
  287.   use ICMAINT.EXE.  I suggest you do.  I was designed to decease
  288.   sysop maintenance of icons. See the section on ICMaintenance.
  289.  
  290.   Line #15: YOU MUST HAVE A ZIP ( or ARJ) FILE OF ALL YOUR ICONS, AND
  291.   IT CAN NOT BE IN YOUR "Working Icons Directory".  ICSETUP.EXE will
  292.   test to see if you specified the proper path.  Use ICSETUP.
  293.  
  294.   Line #16: If you put "N" here, IconUpDater will load (run) for 
  295.   every user that callers in.  If you set it to "Y" then IconUpDater
  296.   will grab the user "Last Time On" date from the DOOR.SYS file and
  297.   compare it to the date on line #13, if the user's date is old than
  298.   the date on line #13, then IconUpDater will run for that user so
  299.   he/she can do an Auto Icon Scan to get the latest icons.
  300.  
  301.   Line #17:  Any time I ask for a security level, I am ask for a
  302.   value ( an actual #) not a variable like "NEWUSER" OR "SYSOP".
  303.   This value in WildCat is the Menu Access level.  Most WC systems
  304.   have their NEWUSERs set to a menu access level of "10".  So if
  305.   you put "20" on line #17, then only users with a menu access
  306.   level of "20" or above will have access to the Button (File or
  307.   Door program, depending on how you have it setup).  This is
  308.   IMPORTANT, because if you are running an ADULT BBS and you have
  309.   adult material icons then you want to keep those icons out of
  310.   your all icons ZIP file, so normal users can not access them.
  311.   Therefore you can setup one of the menu option with a zip file
  312.   of jsut you adult icons and set the security level on it.  See
  313.   below.
  314.  
  315.   Line #18: If you set this to "Y" then any usr who accesses
  316.   IconUpDater will not be able to enter to your BBS until after
  317.   they have done and Icon Scan.  Set this to "N"o to disable this
  318.   option.
  319.  
  320.   Line #19: Set this to "ON" if you like to have a Percentage
  321.   status bar of the icons scan process.  It does slow the scanning
  322.   down a tad, so that's why I give you the option to turn it "OFF."
  323.  
  324.  
  325.             [ FILE SETUP ]
  326.  
  327. embership File          <20>..#1 Optional Menu item description 
  328. M                       <21>..Optional Menu item Hot Key #1
  329. D:\digital\duonline.reg <22>..FULL Path and filename to downloaded #1
  330. DUOnline.REG 2.2        <23>..50 Char.Desc. or "DOOR" to run another door(#1)
  331. 0                       <24>..Minimum security level to access #1
  332. Y                       <25>..Forced File (Y/N) #1
  333.  
  334.      Once again pretty straight forward.  Note: I say "Optional"
  335.      because you do not have to offer any files to your users
  336.      from IconUpDater if you wish, but most offer at least
  337.      RIPterm. 
  338.  
  339.      Starting version 2.60 of IconUpDater, there are now 3
  340.      definable menu options.  Definable? Yes!  Because you can
  341.      set each one of these up individually to transfer a file
  342.      to your user, or use theam as DOS hooks to run other (.exe files)
  343.      Doors, like DUO's Download Door.
  344.  
  345.      Realize that not only can you force a file on a user with
  346.      IconUpDater, but you can also force them to run another door 
  347.      program before heading on to the BBS.  Read more about all this
  348.      in the area headed "Forcing files."
  349.  
  350.      Lines 20 to 37 are for the 3 definable menu options, adn they
  351.      all follow the same format (now, before they did not) <g>.
  352.  
  353.     [G]et RIPterm Program 
  354.      │ └────────────┴───────── Definable menu item description. 
  355.      └── Definable hot key.
  356.  
  357.     d:\wc30\rip\riptm154.exe  <--- actual FULL path and filename of the
  358.                        file you offer for download.
  359.  
  360.     RIPterm Communications...   <--- Enter upto a 50 character        
  361.                      description of the file or
  362.            or                                            /   
  363.                                    /
  364.           DOOR      <------------ Put the Key word "DOOR" in
  365.                       all CAPS to tell IconUpDater
  366.                       to run the file and not 
  367.                       make it a downloadable file.
  368.  
  369.  
  370.     20  --- this would be the lowest security level that could 
  371.            access this menu option.  Any user with a security
  372.            level of 19 and under would not have access.
  373.  
  374.     Y  --- or N  for a Forced File... see SysOp.Txt file.
  375.  
  376.  
  377.  
  378.           [ ADDITIONAL SETUP ]
  379.  
  380. c:\wc30                 <38>..Path to WildCat Activity Log
  381. 15                      <39>..Maximum Icons before enabling auto sending.
  382. N                       <40>..RIP callers ONLY (Y/N)
  383. Y                       <41>..Prompt QModem Pro Users (Yes/No)
  384.  
  385.     If you are not running a wildcat system don't worry about
  386.     line #38.  Line #39 was added to give you yet another configurable
  387.     option.  Let me explain it this way;  if this is set to say 20,  
  388.     and a caller did an Auto Icon Scan and he was missing 19 icons,
  389.     then IconUpDater starts send him the icons one at a time to his
  390.     icons directory.  If he was missing 20 or more icons then IconUpdater
  391.     will give him 3 choices, 1) Download the ALL ICONS file, 2) Continue
  392.     and download the icons 1 at a time,  or 3) Compress the icons he is 
  393.     missing into a new Updated ZIP file and send it to him.
  394.  
  395.     The last line of the config file, #40, has been added due to the 
  396.     high numeber of requests to create a door that forces RIP!
  397.  
  398.     With this addition, you can set this option to "Y" for yes, and
  399.     IconUpDater will not allow any ANSI or ASCII callers on to your 
  400.     system.  IconUpDater has it's own built in RIP dectector, so if
  401.     you have this set to Y and IconUpDater does not dectect RIP, that
  402.     caller gets message sent to him and then IconUpDater hangs up on
  403.     them and tells Wildcat that the caller has hung up in the door.
  404.     Realize this is not the same as a drop carrier.
  405.  
  406.     This Message that is sent to the ANSI callers before IconUpDater
  407.     hangs up on them is "NOANSI.ANS"...see "Menu File Names" section.
  408.  
  409.     If the caller is on in ASCII (no collor at all), a default
  410.     message of "Sorry this system only allow RIP callers..."
  411.     is sent and then the caller is disconnected.
  412.  
  413. #41) if Set to Yes "Y", then the following happens....
  414.  
  415.      I have added a QModem Pro Terminal Detection, so that
  416.      QMPro users can abort the Scan if they wish.  Remember
  417.      that for right now QMPro does not comprehend all the RIP
  418.      script language, and therefore the Auto Scan feature
  419.      in IconUpDater does not work very well... specifically:
  420.  
  421.      QMPro for DOS:  The Auto Scan feature finds the icons,
  422.              but does not not put them in the
  423.              icons in the QMPRO\ICONS directory.
  424.              These QMPro users should then do an
  425.              Auto Scan, then select "U" for Send
  426.              Updated Icons ZIP file.  IconUpDater
  427.              will then ZIP up the icons not found
  428.              and send this ZIP file to the QMPro
  429.              user, who should then Drop to DOS and
  430.              unZIP it in their icons directory.
  431.  
  432.      QMPro for Windows:  The Auto Scan feature can't not scan
  433.              for icons, nor can it sned the user
  434.              icons 1 at a time and put them in the
  435.              user's icon directory.  QMPro for 
  436.              Windows does not comprehend the RIP
  437.              code to do this.  Therefore QMPro
  438.              for Windows users should [A]bort the
  439.              Auto Scan feature.
  440.  
  441.    For these 2 reason is why I added the QModemPro RIP terminal
  442.    dectection. IF you are FORCING your users in to the Auto Scan
  443.    feature... no worries... IconUpDater will still prompt the
  444.    QMPro user and allow him to abort with out being stuck in a loop.
  445.  
  446.    Now this QModemPro RIP terminal dectection is an option, like most
  447.    things in IconUpDater.  Run ICSETUP and go to "Additional" and it
  448.    is the last option under "Additional".  Set it to "Y"es to turn
  449.    this feature on (recommended).  And when Mustang fixes the QMpro
  450.    problems then you can just set this feature to "N" and turn it off.
  451.  
  452.  
  453.  ***      
  454.     One other rather important note.  You can create a standard text
  455.     file of names, where each name is on a seprate line, fully left
  456.     justified, and exactly matches the names in you user database...
  457. >>  and the file must be called "ANSIUSER.LST".  This is the list
  458.     of ANSI users that IconUpDater will allow to access the BBS
  459.     even if you have line # 40 set to "Y"es.  So you may want to
  460.     create this file and at least have your name in it.
  461.  
  462.  
  463.  
  464.  
  465.  ---------------------------------------------------------------------------
  466.    Ryan Andersen                                              513-860-9669
  467.