home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / HATCH / LINKUP24.ZIP / LINKUP.DOC < prev    next >
Text File  |  1995-12-25  |  18KB  |  418 lines
  1.           ┌────────────────────────────────────────────────────────┐
  2.           │     ───══▀▀      ▀▀  ▀▀▀   ▀▀  ▀▀  ▀▀  ▀▀   ▀▀  ▀▀▀▀▀  │
  3.           │    ───══▀▀      ▀▀  ▀▀▀▀  ▀▀  ▀▀ ▀▀   ▀▀   ▀▀  ▀▀  ▀▀  │
  4.           │   ───══▀▀      ▀▀  ▀▀ ▀▀ ▀▀  ▀▀▀▀    ▀▀   ▀▀  ▀▀▀▀▀    │
  5.           │  ───══▀▀      ▀▀  ▀▀ ▀▀ ▀▀  ▀▀ ▀▀   ▀▀   ▀▀  ▀▀        │
  6.           │ ───══▀▀▀▀▀▀  ▀▀  ▀▀  ▀▀▀▀  ▀▀  ▀▀   ▀▀▀▀▀   ▀▀         │
  7.           └────────────────────────────────────────────────────────┘
  8.  
  9.                                LinkUp version 2.x
  10.          Full Featured Network Update Software for WWIV Based Networks
  11.                Copyright (c) 1995 Imagination Industries Software
  12.                               All Rights Reserved
  13.  
  14. │                                                                            │
  15. │                    I. Disclaimer                                           │
  16. │                    II. History                                             │
  17. │                    III. Terms for Use                                      │
  18. │                    IV. Registration                                        │
  19. │                    V.  Purpose                                             │
  20. │                    VI.  Networking Terminology and Fundamentals:           │
  21. │                    VII. LinkUp Setup                                       │
  22. │                    VIII. LINKUP.INI                                        │
  23. │                    IX. Registered LinkUp Features                          │
  24. │                    X. Command Line Options                                 │
  25. │                    X. Support and Technical Help                           │
  26. │                                                                            │
  27.  
  28.  
  29. ┌─────────────────────────────────────────────────────────────────────────────┐
  30. │                                 Disclaimer                                  │
  31. └─────────────────────────────────────────────────────────────────────────────┘
  32. Imagination Industries, Chavous Camp, and all others associated directly
  33. or indirectly with the creation of LinkUp are hereby not responsible for
  34. any problems caused by LinkUp.  In the event that it messes up something
  35. on your system, it is NOT our fault.  Also, there is no warranty, expressed
  36. or implied.  I do not guarantee this program to work.  It works for me and
  37. my net, and that's all that matters to me.  If you like it, so be it.  If
  38. it doesn't work, I'm sorry.  I will help you correct the problem, but I
  39. give no guarantee that this software will work.  Period.
  40.  
  41. ┌─────────────────────────────────────────────────────────────────────────────┐
  42. │                                   History                                   │
  43. └─────────────────────────────────────────────────────────────────────────────┘
  44.         I did not originally write this software.  It was written by
  45. a man named Jason Whelan.  He wrote the versions up through 2.3.  Come
  46. version 2.3, he decided that he wasn't going to release any updates.
  47. He told me this, and a few months later I poped the question to see if
  48. he was willing to sell it.  He said he was, and here we are today.
  49.     The only stipulation is that I HAVE to maintain backwards
  50. compatibility through version 5.  After that, whether I do or not is
  51. solely up to me.
  52.  
  53. ┌─────────────────────────────────────────────────────────────────────────────┐
  54. │                                Terms for Use                                │
  55. └─────────────────────────────────────────────────────────────────────────────┘
  56. This product and documentation is writen and copyright Chavous Camp,
  57. 1995.
  58.  
  59.     You are entiteled to use this software for a grand total of: 30 days
  60. After that, you are required to register.  There arn't any bugs that
  61. go into suicide mode when you go over 30 days, but I still require you
  62. to register.
  63.  
  64. ┌─────────────────────────────────────────────────────────────────────────────┐
  65. │                                Registration                                 │
  66. └─────────────────────────────────────────────────────────────────────────────┘
  67.         Registration is manditory.  I don't care why you don't want to,
  68. it is manditory if you wish to continue running it after the 30 day
  69. mark.  You will then get support from the author anytime you need it,
  70. and you will recieve extra features as stated in other sections of
  71. this doc.  To register, fill out the REGISTER.FRM and send it to the address
  72. listed within there.
  73.  
  74. ┌─────────────────────────────────────────────────────────────────────────────┐
  75. │                                   Purpose                                   │
  76. └─────────────────────────────────────────────────────────────────────────────┘
  77. Simply put, the purpose is to send out those files necessarry for the
  78. daily opperation of a WWIV-Based network.  Jason originally developed
  79. this for his network, IceLink.  Now, the guinea pig net is my own,
  80. WorldNET.  LinkUp offers all of the features that a program such as
  81. NetUp from Wayne Bell ($100.00 and like $20 for each group after the
  82. first few).  All the features for one low price: $20.00 US funds
  83.  
  84. ┌─────────────────────────────────────────────────────────────────────────────┐
  85. │                  Networking Terminology and Fundamentals:                   │
  86. └─────────────────────────────────────────────────────────────────────────────┘
  87. Even though you SHOULD know this BEFORE starting a network, I will include
  88. this section in here for your reference.
  89.  
  90. Networks are voluntary associations of WWIV bulletin boards which
  91. communicate with each other by making automated network calls between
  92. systems.  The purpose of this communication is to enable the
  93. transmission of E-Mail and Messages from one system to another.  Users
  94. on one BBS may E-Mail users on another networked BBS, and users of one
  95. BBS may post messages which are transmitted for viewing and response by
  96. users of other networked systems which subscribe to a particular message
  97. sub-board.
  98.  
  99. There are two ways of creating a network, one is suited to smaller
  100. networks the other is necessary for larger networks.  The latter must be
  101. used as small networks grow 500 and more systems due to the size
  102. limitation of network packets.
  103.  
  104.  Small Networks:
  105.  
  106. Small networks need only two files, BBSLIST.NET and CONNECT.NET.  All
  107. nodes are listed in each.  These files are to be placed in the DATA
  108. directory of WWIV if the system only operates one network and in a
  109. seperate network directory (defined in INIT option N) if the system
  110. belongs to more than one network.
  111.  
  112. BBSLIST.NET -  For a small network, this file can list all nodes
  113. participating in the network.  The general format of this file is
  114. as follows:
  115.  
  116. ~747534792
  117. @1     & *509-487-6572 #14000 [30118]       "DATA*NORTH*WEST"
  118. @2     % *509-487-8535 #14000 [30118]       "DATA*NORTH*WEST Line ]["
  119. @3     ^ *509-624-2480 #14000 [-1   ]       "Tiki's Express BBS"
  120.  
  121. CONNECT.NET -  For small networks, this file will reflect the
  122. connections of all nodes in the network. The format is as follows:
  123.  
  124. ~747534792
  125. @1    2=0.00 3=0.00
  126. @2    1=0.00
  127. @3    1=0.00
  128.  
  129. This shows @2 and @3 connecting to @1, that is the basic format for each
  130. file.
  131.  
  132.    ┌────────────────────────────────────────────────────────────────┐
  133.    │For this type of setup you will only need to distribute DE1.EXE,│
  134.    │DE10.EXE, DE99.EXE, and DE511.EXE to ALL systems in your network│
  135.    └────────────────────────────────────────────────────────────────┘
  136.  
  137.  Large Networks:
  138.  
  139. Large networks require the BBSLIST and CONNECT files to be split up into
  140. the group format.  This allows each group to approximate 500 or so
  141. nodes.  The format is similar to that of the format for small networks,
  142. however it is beyond the scope of this documentation.  Please consult
  143. the documentation that accompanies the distribution archives for the
  144. NETXX software of WWIV Software Services.
  145.  
  146.   ┌──────────────────────────────────────────────────────────────────────┐
  147.   │You need to make sure that you distribute DE1.EXE, DE10.EXE, DE99.EXE,│
  148.   │& DE511.EXE to ALL systems in your net, PLUS you will need to give out│
  149.   │each group DE file as well(ie. DE257.EXE needs to be given to ALL     │
  150.   │systems in group 1)                                                   │
  151.   └──────────────────────────────────────────────────────────────────────┘
  152.  
  153. ┌─────────────────────────────────────────────────────────────────────────────┐
  154. │                                LinkUp Setup                                 │
  155. └─────────────────────────────────────────────────────────────────────────────┘
  156.         In this section, I am going to simply quote directly from the old
  157. LinkUp docs by Daryl A. Rodrigues, who recieved a free registration
  158. for his services.
  159.  
  160. This section will show you how to run LINKUP from DOS, from within the
  161. BBS as a chain, and from WFC (The Waiting for Caller Screen) using a
  162. macro.
  163.  
  164. From DOS:
  165.  
  166. 1]  Place LINKUP.EXE, LINKUP.CFG(only if you are using the evaluation DE
  167.     files) and LINKUP.HLP in your root BBS directory.
  168.  
  169. 2]  Place all of the DE*.EXE files in the root BBS directory if you only
  170.     run one network.  If you are taking advantage of WWIV's Multi Network
  171.     capability place the DE*.EXE files in the directory of the network you
  172.     operate.
  173.  
  174. 3]  When you run LinkUp for the first time you will be asked several setup
  175.     questions.
  176.  
  177.     On multi-net systems you will be asked to identify the network you
  178.     operate.
  179.  
  180.     Linkup will then ask you for the fill path and filename of the
  181.     editor you wish to use within LinkUp.
  182.  
  183.     LinkUp will read in the network directory by analyzing CONFIG.DAT
  184.     and NETWORKS.DAT
  185.  
  186.  
  187.     Please note that if/when you set up your encryption passwords be
  188.     sure to enter them EXACLY as they are in you DE files, this is
  189.     because the passwords are CASE SENSITIVE!!!
  190.  
  191.  
  192. From within the BBS as a chain:
  193.  
  194. 4]  LinkUp can be run from DOS or can be run as a chain.  The following
  195.     is the setup for running LinkUp as a chain from within the BBS.
  196.  
  197.     A. Description    : GLOBALnet Updates
  198.     B. Filename    : LINKUP.EXE
  199.     C. SL         : 255
  200.     D. AR         : None.
  201.     E. ANSI        : Optional
  202.     F. DOS Interrupt: NOT Used
  203.     G. 300 Baud    : NOT Allowed
  204.     H. Shrink        : Yes
  205.     I. Disable pause: Yes
  206.     J. Local only    : Yes
  207.     K. Multi user    : No
  208.     L. Registered by: Daryl
  209.     M. Usage        : 23
  210.  
  211.     LinkUp will NOT operate remotely, however command line arguments for
  212.     remote operation of LinkUp is discussed in section 9.
  213.  
  214. From WFC as a macro:
  215.  
  216. WWIV Supports the use of macros which are read from a file called
  217. MACROS.TXT which should be located in your \DATA directory:
  218.  
  219. 1. Make sure your main BBS directory is in your path
  220.  
  221. 2. Create a file in your DATA directory called MACROS.TXT
  222.  
  223. 3. To run LinkUp add the following line to MACROS.TXT
  224.  
  225. L Linkup.exe
  226.  
  227. -The 'L' can be any letter of your choosing-
  228. -LINKUP.EXE must be in your main BBS directory-
  229.  
  230. After doing the above, LinkUp can be called from the WFC screen by simply
  231. typing ALT-L.
  232.  
  233. Note: Other programs may be installed as above.  The program being called
  234. must be in your path or your main BBS directory.
  235.  
  236. ┌─────────────────────────────────────────────────────────────────────────────┐
  237. │                                 LINKUP.INI                                  │
  238. └─────────────────────────────────────────────────────────────────────────────┘
  239. Please note: There MUST be either a section in WWIV.INI for LinkUp OR a
  240. LINKUP.INI.  If there is not, all you will get is a black screen with no
  241. cursor.  If you get this, just hit escape once or twice and it will go away.
  242.  
  243. Here is the format for the LinkUp.INI.  I haven't writen in any code yet
  244. that will write this if it doesn't exist (next version-I was in a hurry to
  245. get this one out).
  246.  
  247. [LinkUp]
  248. FILLCHARFG=0
  249. FILLCHARBG=4
  250. These two define the color of the background character (▓).
  251.  
  252. SBORDERFG=14
  253. SBORDERBG=0
  254. These control the status border colors.
  255.  
  256.  
  257. SWINFG=14
  258. SWINBG=1
  259. Status Window text colors
  260.  
  261. STITLEFG=14
  262. STITLEBG=0
  263. Status Window Title colors
  264.  
  265. IBORDERFG=15
  266. IBORDERBG=1
  267. Input Border Colors
  268.  
  269. ITITLEFG=15
  270. ITITLEBG=1
  271. Input Window Title Color
  272.  
  273. IWINFG=15
  274. IWINBG=0
  275. Input Window text Color
  276.  
  277. PDOWNTEXTFG=15
  278. PDOWNTEXTBG=2
  279. Pull Down Menu Selected Text
  280.  
  281. PLINEFG=15
  282. PLINEBG=4
  283. The color of the Pull Down Menu bar
  284.  
  285.  
  286. PDOWNKEYFG=14
  287. PDOWNKEYBG=4
  288. The Color of the key to press to bring up that menu
  289.  
  290. PDOWNFG=15
  291. PDOWNBG=4
  292. This controls the color of the menu titles that arn't selected.
  293.  
  294. ┌─────────────────────────────────────────────────────────────────────────────┐
  295. │                         Registered LinkUp Features                          │
  296. └─────────────────────────────────────────────────────────────────────────────┘
  297.   Please note that as of LinkUp v2.20, ALL of features are available to you
  298.  
  299.  
  300. BBSLIST.*          Files that contain system names, node #, and other info
  301. CONNECT.*          Routing/connecting info for each system
  302. DExxx.*             The necessary decryption files
  303. FBACKHDR.NET         Network Feedback Header
  304. WWIVNEWS.NET         News file for your network
  305. SUBS.*             Files containing all available subs in your net.
  306. CATEG.NET          Categories for subs
  307. NETWORKS.LST         Network information
  308. Pings             Automated sub info requests
  309. Any file             Self-explanatory, must be under NETxx limit of 32k
  310.                  A file can also be sent to a single node if you wish
  311. Group Mail         Source verified mail to all group sysops
  312. Network Mail         Source verified mail to all network sysops (*)
  313. Network SSM's        SSM's to all network sysops
  314. Group SSM's          SSM's to all group sysops
  315. Regular Email         Mail anyone in your net from within LinkUp (including
  316.                  gated e-mail)
  317. Posts!             Allows the NC to post on ANY sub that he/she hosts and
  318.                  supports alpha-numeric subtypes.
  319. Edit files         Edits any file in your net directory
  320. Small Updates         Allows sending of small bbslists to keep network
  321.                  traffic to a minimal amount, plus it is also done
  322.                  using a form interface for adding systems.
  323.                  (please note that this option WILL NOT work if you
  324.                  are not using the group format!!!)
  325. Delete system         Allows you to delete a system without having to edit
  326.                  a BBSLIST file and having to look for the system
  327. Edit System         Allows you to completly edit all info about a
  328.                  system in your network using the forms, works like the
  329.                  add a system option.
  330. Full Help          Complete descriptions of every function by pressing F1
  331.  
  332. In addition to this list of features LinkUp in its registered form is also
  333. packaged with the following modules to facilitate the deligation of the
  334. tasks of administrating your network.  (These modules are NOT available until
  335. you have registered LinkUp.)
  336.  
  337.    Group Coordinator Modules(aka. LinkUpGC) -
  338.  
  339. These modules can be given out to each GC in your network to send out
  340. specific group updates to all systems in the net. The GC's will have
  341. the ability to update ONLY their group's files, they will also be able to
  342. send source verified mail to all of the sysops in their group only.
  343. Group Coordinators may also send the updates directly to the NC for s/he
  344. to verify and send out.
  345.  
  346.    Subs List Coordinator Module(aka. LinkUpSC) -
  347.  
  348. This module will allow one person in your net to perform all the subs list
  349. updating.  It includes the ability to send out pings, SUBS.*, CATEG.NET,
  350. and also the ability to AUTOMATICALLY sort, clean up, and categorize all
  351. sub files.
  352.  
  353.    Misc. Coordinator Module(aka. LinkUpMC)
  354.  
  355. This module is not finished yet, but is planned to allow the NC to
  356. distribute even more duties to various people, to suggest a feature for
  357. this module please E-mail Chavous!
  358.  
  359. ┌─────────────────────────────────────────────────────────────────────────────┐
  360. │                         LinkUp Command Line Options                         │
  361. └─────────────────────────────────────────────────────────────────────────────┘
  362. Command Line Arguments allow a network coordinator to perform all the
  363. functions necessary to operate the network from a remote computer by
  364. using command line options from either DOS or batch files.    The current
  365. command line arguments available are:
  366.  
  367. /? or -H will give you this list (ie. LINKUP /h)
  368. /U or -U will perform a COMPLETE network update (ie.  LINKUP /U)
  369. /Bxxx or -Bxxx will update BBSLIST.xxx (ie.    LINKUP /B1)
  370. /Cxxx or -Cxxx will update CONNECT.xxx (ie.    LINKUP /c0)
  371. (LINKUP /Bnet and/or /Cnet will send out BBSLIST.NET and/or CONNECT.NET)
  372. /F or -F will perform a FBACKHDR.NET update (ie.    LINKUP /f)
  373. /@ or -@ will send out the file after the @ (ie. LINKUP /@testfile.txt)
  374. /N or -N will perform a NETWORKS.LST update (ie.    LINKUP /n)
  375. /W or -W will perform a WWIVNEWS.NET update (ie.    LINKUP /w)
  376. /S or -S will run LinkUp's setup (ie.  LINKUP /s)
  377. /P or -P will run LinkUp's password setup (ie.  LINKUP /p)
  378.  
  379. As of LinkUp v2.30, multiple arguments are allowed(ie. LINKUP /u /W /F /n ...)
  380.  
  381. Typing 'LINKUP' with no parameters will take you to the main menu
  382.  
  383.  
  384. Additional command line arguments may be added in the future, just ask for it!
  385.  
  386. ┌─────────────────────────────────────────────────────────────────────────────┐
  387. │                      Support and technical Assistance                       │
  388. └─────────────────────────────────────────────────────────────────────────────┘
  389.         To recieve information on versions, registrations, or for help,
  390. contact:
  391.  
  392. ME!    Imagination Industries c/o
  393.     Chavous Camp
  394.     1 Wood Fox Ct.
  395.     Elgin, SC 29045-9334
  396.  
  397.     Voice Phone: 803-788-8140
  398.  
  399.     820@6100    WWIVNet
  400.     820@8315    Apex, IceNET
  401.     820@18315 WWIVLink
  402.  
  403.     1@1        WorldNET
  404.     1@251    SteelNET
  405.     1@8309    TFALink
  406.     1@8350    DreamNET, LavaNET
  407.     1@937    FishNET, SpaceNET, DarkNET
  408.     1@8300    TerraNET
  409.  
  410.     Chavous Camp 1:376/126  FidoNET
  411.     aa101648@dasher.csd.scarolina.edu    InterNET
  412.  
  413. OR Call my support board:    The Jedi's Lair
  414.                         803-434-2772
  415.                         28.8k v.34, v.42b, etc
  416.     and email Kal Durak, user #3.
  417.  
  418.