home *** CD-ROM | disk | FTP | other *** search
/ The Devil's Doorknob BBS Capture (1996-2003) / devilsdoorknobbbscapture1996-2003.iso / MYBBS.ZIP / WINDOWS / DESKTOP / MYBBS / LINKER / LINKER.DOC < prev    next >
Text File  |  1994-05-24  |  32KB  |  859 lines
  1. Linker v3.6 Multi-Network Sender/Support Software
  2.  
  3. Written by Hellfire 1@1 Apex / 1@13600 WWIVLink
  4. Documented by Parapuke 1@8251 Apex / 1@18251 WWIVLink
  5. Documentation upgraded by Ketol Ketih 1@10 Apex / 1@13601 WWIVLink
  6. Parts updated by King Master 2@19 Apex / 1@13605 WWIVLink
  7.  
  8.  
  9. Please note - this program is GreenWare. You may use it for an evaluation
  10. period of 30 DAYS. Even though this software is FULLY ENABLED without
  11. registration make no mistake the software is not licensed to you unless
  12. you register.  The registration fee is merely Ten Dollars, or you may apply
  13. to our alternative GREENWARE program. The GREENWARE program requires that you
  14. email Parapuke 1@18251.WWIVLink or 1@8251.WWIVnet and send in the GREENWARE
  15. registration form.
  16.  
  17. The GREENWARE registration form has more information on what that means.
  18.  
  19. Please send money to:
  20.  
  21.                 John Wheeler
  22.                 8703 East Wabash Ave  Lot #57
  23.                 Terre Haute, IN 47803
  24.  
  25. Files in Linker Package
  26. -----------------------
  27.  
  28.             LINKER.DOC:    This file
  29.             LINKER.EXE:    1-1.  Primary Executable file
  30.             LINKERGD.EXE:  Primary Executable for systems using Gold System.
  31.             LINKUTIL.EXE:  2-1.  Used to create Linknets.Net as well as
  32.                            enhancements.
  33.             LINKER.DAT:    3-1.  Definable Enhancements
  34.             FILEREQ.BAT:   (goes in your root bbs directory) for those systems
  35.                            that compiled WWIV with the PACKSCAN Option on.
  36.             FILE_ID.DIZ:   File description
  37.             GREENWAR.REG:  GREENWARE registration form
  38.             WHATSNEW.DOC:  A list of new features in current update
  39.             SOFTWARE.TXT:  A list of support boards and other software
  40.                            produced by Microtech Solutions and PURGware
  41.             FILE_ID.DIZ    Gee, I wonder..
  42.  
  43.  
  44. Linker may be distributed as SHAREWARE as long as it is also distributed with
  45. the above files.
  46.  
  47.  
  48. 1-1. Introduction.
  49.  
  50. Linker originated in the twisted mind of Hellfire during the cold winter
  51. nights of his igloo home in Saskatoon, Saskatchewan, Canada where he was tired
  52. of spending all his hard earned money on calls to pick up his various networks
  53. from the United States.
  54.  
  55. Linker will take multiple networks that are received by a host/hub system and
  56. combine them into one call on one network using sub type 10/512.  When your
  57. system receives this sub type, it will process the messages being received,
  58. moving them to the appropriate data directory to be processed just as though
  59. you had received the call ON that network.  In return, messages from your
  60. system will be processed and combined to be returned back to the host/hub
  61. system.  This return process will happen when the Network2.exe runs a second
  62. time.  Originally intended as a preview of things to come in WWIV networking,
  63. it has proven itself as a trustworthy addition to any multinetworking system
  64. used by close to 500 WWIV systems, as well as adding several refinements which
  65. will be found later in this document.
  66.  
  67. The two primary files you will need to do this are Linker.Exe and a created
  68. file called Linknets.Net, both of which will end up located in your root bbs
  69. directory.  You will also need to make some small changes in your Callout.Net
  70. file in your defined Data directory.  The other files I will explain later.
  71.  
  72. 1-2. Instructions for setup of Linker.
  73.  
  74. In order to use this program you will need to do several things.  FIRST,
  75. obtain permission to connect with a person that also has a copy of this
  76. program.  Request this of the appropriate Network authority dependent upon the
  77. network/networks you wish to connect to.
  78.  
  79. When this is done, go to the data directories of those networks you wish to 
  80. combine into one call and change the information to read... 
  81.  
  82. @1234           +     "ABCDEFGHUJKLMNO"
  83.  
  84. Do not change the information in callout.net on that network you wish to send
  85. the packets TO and as a safety outlet, I recommend you do not remove any
  86. pre-established password.
  87.  
  88. Needless to say, this is a false entry but it will give you the idea.  All you 
  89. need to change is to place a + in the callout.net to assure that the messages
  90. are NOT compressed as well as no attempt is made to call the system as there
  91. will be nothing pending for that system. There is no need whatsoever to change
  92. the existing password, nor even to enter one, if this is the first time someone
  93. has connected with you within that network. It is important that no compression
  94. is used on a Linked connection. Linker checks for an S<node number>.NET file
  95. when analyzeing for pending data. If compression is used Linker will be unable
  96. to find the uncompressed network file.
  97.  
  98. When CALLOUT.NET setup is done you will need to set up a file called
  99. LINKNETS.NET. The fallowing information is included to show you how to edit
  100. that file useing LINKUTIL and how to edit the file manually.
  101.  
  102. Move Linkutil.Exe into your root BBS directory now.  In Linkutil, select "Edit
  103. Linknets.Net" and you will be prompted for the following information:
  104.  
  105. Network the package is FROM.
  106. System number in this originating network the package is from.
  107. Network the package is to go TO.
  108. System number in the receiving network the package is to go to.
  109.  
  110. So the structure of what you will be creating in Linknets.Net is as follows;
  111.  
  112. LINK=        <- this is the node and net you want to LINK FROM
  113. NET=         <- this is the FROM network as defined in Init.Exe -1
  114. TO=          <- this is the node and net you want to LINK it TO.
  115. NET=         <- this is the TO network as defined in Init.Exe -1
  116.  
  117. As an example, my board "The Resource Center" has connects to the St. Louis
  118. 314 Multinet Server on two networks (WWIVnet and WWIVlink)   The INIT network 
  119. #, Node # and Network for each BBS are as follows: 
  120.  
  121.   The Resource Center                   314 Multinet Server
  122.  
  123. INIT    NODE     NETWORK               INIT   NODE    NETWORK
  124. -----   -----    --------              -----  ------  --------
  125. 0       18251    WWIVlink              0       314    WWIVlink
  126. 1        8251    WWIVnet               1      1023    WWIVnet
  127.  
  128. In order for these two boards to exchange network traffic (using WWIVLink in 
  129. this example) each board will have to have a LINKNETS.NET file in their main 
  130. BBS directory that looks like: 
  131.  
  132. The Resource Center                     314 Multinet Server
  133.  
  134. LINK=1023                               LINK=8251
  135. NET=1                                   NET=1
  136. TO=314                                  TO=18251
  137. NET=0                                   NET=0
  138.  
  139. What the LINKNETS.NET file for the Resource Center is telling Linker to do
  140. is to intercept all net packets destined for WWIVnet node 1023 and combine 
  141. them into the outbound net packet destined for WWIVlink node 314 that goes as 
  142. a type 10/512 message.  When WWIVlink node 314 receives the packet with the
  143. type 10/512 message, it will know that traffic for WWIVnet node 8251 is 
  144. destined for a P1.NET packet in the WWIVnet data directory while the WWIVlink 
  145. data goes into a P1.NET in the WWIVlink data directory. 
  146.  
  147. Now, just to make things a bit more interesting, I'm going to add ICEnet to 
  148. both systems, but change the network numbers for INIT on the 314 Server (but 
  149. leave them straight across to represent how they connect in the CALLOUT.NET's)
  150. but we will use ICEnet as the transporting network in this example:
  151.  
  152.   The Resource Center                   314 Multinet Server
  153.  
  154. INIT    NODE     NETWORK               INIT   NODE    NETWORK
  155. -----   -----    --------              -----  ------  --------
  156. 0       18251    WWIVlink              2       314    WWIVlink
  157. 1        8251    WWIVnet               0      1023    WWIVnet
  158. 2        8251    ICEnet                1      1023    ICEnet
  159.  
  160. The Resource Center                     314 Multinet Server
  161.  
  162. LINK=314                                LINK=18251
  163. NET=0                                   NET=2 
  164. TO=1023                                 TO=8251 
  165. NET=2                                   NET=1
  166. LINK=1023                               LINK=8251
  167. NET=1                                   NET=0 
  168. TO=1023                                 TO=8251 
  169. NET=2                                   NET=1
  170.  
  171. At the risk of repeating myself, I will go over the LINKNETS.NET file for 
  172. The Resource Center a line at a time:
  173.  
  174.  
  175. LINK=314            Intercept all traffic destined for node 314
  176. NET=0               on INIT network 0
  177. TO=1023             direct it to  the net packets for node 1023
  178. NET=2               on INIT network 2
  179. LINK=1023           Intercept all traffic destined for node 1023
  180. NET=1               on INIT network 1
  181. TO=1023             direct it to the net packets for node 1023
  182. NET=2               on INIT network 2
  183.  
  184. ---------------------------------------------------------------
  185.  
  186. LASTLY...  While still in your root bbs directory, rename the Network2.Exe
  187. to Net2.Exe and then copy the Linker's Linker.Exe and rename it to
  188. Network2.exe and put it into the root bbs directory in the original
  189. Network2.exe's place.
  190.  
  191. There is a new enhancement starting version 3.2 which will create a
  192. directory in your root directory called BADLINK.  This directory will contain
  193. messages and files sent via Linker to your system of which it doesn't know
  194. what to do with.  This may be restricted files, networks to which have been
  195. misdirected or even bad packets.  You should check this directory on occasions
  196. to see what is there.
  197.  
  198. ***************************************************************************
  199. 1-3.  Modifications of source code for REGISTERED USERS of WWIV ONLY!
  200. ***************************************************************************
  201. Linker Clean up Mod for WWIV 4.24
  202. ---------------------------------
  203.  
  204. Here is a simple mod you can implement to clean up your pending packets after
  205. a network connection. Sometimes you will get a connect but will you will not
  206. receive data to the system. This mod will clean that up.
  207.  
  208. Load up NETSUP.C and find the function cleanup_net
  209.  
  210.         if (ok) {
  211.           holdphone(1);
  212.           hangup=0;
  213.           using_modem=0;
  214.           if (run_external1_x("NETWORK1")<0)
  215.             abort=1;
  216.           else
  217.             any=1;
  218.           ok2=1;
  219.           run_external1_x("LINKER /O"); // add this line
  220.         }
  221.  
  222.  
  223. Linker does and always has supported EPREPROC.NET format. So do not be afraid
  224. of installing Linker useing this format. Please see the WWIVNET.DOC file that
  225. came with NETxx.ZIP on how to install it. I suggest putting LINKER.EXE into
  226. your main WWIV directory and if you are useing the linker clean up mod you
  227. should put
  228.  
  229. LINKER /I
  230.  
  231. into the EPREPROC.NET file. If not then just
  232.  
  233. LINKER
  234.  
  235. will do.
  236.  
  237. Linker BISS mod for WWIV 4.24
  238. -----------------------------
  239.  
  240. This mod will allow you to send BISS Back Issue subs from the mail prompt when
  241. you add a new subscriber.
  242.  
  243. This mod is real simple just load up the file READMAIL.C and replace the
  244. function add_netsubscriber with the fallowing function. Only a few changes
  245. were made to the function but I just felt it was as easy to show you the whole
  246. function as to write the changes.
  247.  
  248. void add_netsubscriber(unsigned short sn)
  249. {
  250.   char s[10], s1[81], ns1[80];
  251.   FILE *host;
  252.  
  253.   if (!valid_system(sn))
  254.     sn=0;
  255.  
  256.   nl();
  257.   prt(1,get_string(1265));
  258.   nln(2);
  259.   prt(2,get_string(1266));
  260.   mpl(7);
  261.   input(s,7);
  262.   if (s[0]==0)
  263.     return;
  264.   sprintf(ns1,"%sN%s.NET",net_data,s);
  265.   strcpy(s1,s);
  266.   if (!exist(ns1)) {
  267.     nl();
  268.     ansic(6);
  269.     npr("%s%s",get_string(1267),ns1); nl();
  270.     return;
  271.   }
  272.   nl();
  273.   if (sn) {
  274.     outstr(get_string(1268));
  275.     npr("%u.%s",sn,net_name);
  276.     outstr(get_string(1269));
  277.     npr("%s? ",s);
  278.   }
  279.   if (!sn || !ny()) {
  280.     prt(2,get_string(1270));
  281.     mpl(5);
  282.     input(s,5);
  283.     if (!s[0])
  284.       return;
  285.     sn=atoi(s);
  286.     if (!valid_system(sn)) {
  287.       npr("@%u%s%s.", sn, get_string(1271), net_name);
  288.       nl();
  289.       return;
  290.     }
  291.   }
  292.   sprintf(s,"%u\n",sn);
  293.   host=fsh_open(ns1,"a+t");
  294.   if (host) {
  295.     fprintf(host,s);
  296.     fsh_close(host);
  297.   }
  298.   send_biss(sn, s1, net_num);
  299. }
  300.  
  301. Then load up BBSOVL1.C and add the fallowing function to the end of the file.
  302.  
  303. void send_biss(unsigned short sn, char *s, int net_num)
  304. {
  305.   char s1[81];
  306.  
  307.   sprintf(s1,"NETWORK2.EXE /B:%u,%s .%d", sn, s, net_num);
  308.   run_external(s1);
  309. }
  310.  
  311. and your done.
  312.  
  313. ***************************************************************************
  314. ***************************************************************************
  315.  
  316. WHOMOD02.MOD                 A WhoMod, 1993, Gallifreyan Communications Limited
  317. Version 1.0
  318. Author: Keeper Of The Matrix,
  319.         1@1 TARDISNet, 1@2925 WWIV\Ice\God\APEX\CHAOS\SOLAR\TERRANet,
  320.         1@22925 WWIVLink
  321. Date  : December 17th, 1993
  322. Tested: WWIV v4.23                      Difficulty: ▓▒░░░ <A Block Read>
  323. ===============================================================================
  324.  
  325.                                 Description
  326.                                 -----------
  327.  
  328.         . . . This mod is for those of you that use the Linker software and
  329. want to get rid of those connects that are pretty much 'voided' because of
  330. Linker . . . AND they will eliminate all of the nets when you do a force a
  331. callout <i.e. the BBS will not ask what network you want to connect to, it
  332. will automatically go to the network that has not been 'linked'> . . .
  333.  
  334. Thanks goes to Hellfire for writing Linker and Chris Yarnell of Anything
  335. Goes...
  336.  
  337. Now to the mod!
  338.  
  339. --------
  340.  
  341. File: NETSUP.C
  342.  
  343. Add these two lines in void force_callout:
  344.  
  345. =   if (!net_networks[net_num].con)
  346. =     read_call_out_list();
  347. =
  348. =   i=-1;
  349. =   for (i1=0; i1<net_networks[net_num].num_con; i1++) {
  350. +      if ((net_networks[net_num].con[i1].options & options_PCP_night))
  351. +        continue;
  352. =     if (net_networks[net_num].con[i1].sysnum == sn) {
  353. =       i=i1;
  354. =       break;
  355. =     }
  356. =   }
  357. =
  358. =   if (i!=-1) {
  359.  
  360.  
  361. Replace this void...
  362.  
  363. void print_pending_list(void)
  364. {
  365.   int i,i1,i2,nn,num_ncn, num_call_sys,abort=0;
  366.   char s[100],ch,s1[100];
  367.   long l,l2;
  368.   unsigned long ss;
  369.   net_call_out_rec *con;
  370.   net_contact_rec *ncn;
  371.  
  372.   if ((net_networks[0].sysnum==0) && (net_num_max==1))
  373.     return;
  374.  
  375.   time(&l);
  376.   ss=thisuser.sysstatus;
  377.   thisuser.sysstatus |= sysstatus_pause_on_page;
  378.  
  379.   nl();
  380.   nl();
  381.   pla(get_string(912),&abort);
  382.   if (net_num_max>1) {
  383.     pla(get_string(913),&abort);
  384.     pla(get_string(914),&abort);
  385.     pla(get_string(961),&abort);
  386.   } else {
  387.     pla(get_string(915),&abort);
  388.     pla(get_string(916),&abort);
  389.     pla(get_string(962),&abort);
  390.   }
  391.  
  392.   for (nn=0; nn<net_num_max; nn++) {
  393.  
  394.     set_net_num(nn);
  395.  
  396.     if (!net_sysnum)
  397.       continue;
  398.  
  399.     if (!net_networks[net_num].con)
  400.       read_call_out_list();
  401.     if (!net_networks[net_num].ncn)
  402.       read_contacts();
  403.  
  404.     con=net_networks[net_num].con;
  405.     ncn=net_networks[net_num].ncn;
  406.     num_call_sys=net_networks[net_num].num_con;
  407.     num_ncn=net_networks[net_num].num_ncn;
  408.  
  409.     for (i1=0; i1<num_call_sys; i1++) {
  410.       i2=-1;
  411.       for (i=0; i<num_ncn; i++) {
  412.         if (con[i1].sysnum==ncn[i].systemnumber) {
  413.           i2=i;
  414.           break;
  415.         }
  416.       }
  417.       if (i2!=-1) {
  418.         if (ok_to_call(i1)) {
  419.           if ((bytes_to_k(ncn[i2].bytes_waiting)>=con[i1].min_k) ||
  420.              (labs(l-ncn[i2].lastcontact)>=SECONDS_PER_DAY))
  421.             ch='*';
  422.           else
  423.             ch='+';
  424.         } else
  425.           ch=' ';
  426.         if (ncn[i2].lastcontactsent) {
  427.           sprintf(s1,"%4ld:",(l-ncn[i2].lastcontactsent)/SECONDS_PER_HOUR);
  428.           l2=(((l-ncn[i2].lastcontactsent)%SECONDS_PER_HOUR)/60);
  429.           itoa(l2,s,10);
  430.           if (l2<10) {
  431.             strcat(s1,"0");
  432.             strcat(s1,s);
  433.           } else
  434.             strcat(s1,s);
  435.         } else
  436.           strcpy(s1,get_string(917));
  437.       if (!(con[i1].options & options_PCP_night)) {
  438.         if (net_num_max>1) {
  439.           sprintf(s,"%s7│5 %c%s%-11s%s%-6u%s%6ldk%s%11s 7│",0
  440.             charstr(14,' '),
  441.             ch,
  442.             get_string(974),
  443.             net_name,
  444.             get_string(974),
  445.             ncn[i2].systemnumber,
  446.             get_string(974),
  447.             bytes_to_k(ncn[i2].bytes_waiting),
  448.             get_string(974),
  449.             s1);
  450.             pla(s,&abort);
  451.         } else {
  452.           sprintf(s,"%s7│5 %c%s%-6u%s%6ldk%s%11s 7│",0
  453.             charstr(21,' '),
  454.             ch,
  455.             get_string(974),
  456.             ncn[i2].systemnumber,
  457.             get_string(974),
  458.             bytes_to_k(ncn[i2].bytes_waiting),
  459.             get_string(974),
  460.             s1);
  461.             pla(s,&abort);
  462.         }
  463.        }
  464.       }
  465.     }
  466.   }
  467.  
  468.   for (nn=0; nn<net_num_max; nn++) {
  469.  
  470.     set_net_num(nn);
  471.  
  472.     if (!net_sysnum)
  473.       continue;
  474.  
  475.     sprintf(s,"%sDEAD.NET",net_data);
  476.     i=sh_open1(s,O_RDONLY | O_BINARY);
  477.     if (i>0) {
  478.       l=filelength(i);
  479.       sh_close(i);
  480.       if (net_num_max>1) {
  481.         sprintf(s,
  482.           "%s%s%-11s%s%6ldk%s",
  483.           charstr(14,' '),
  484.           get_string(966),
  485.           net_name,
  486.           get_string(967),
  487.           bytes_to_k(l),
  488.           get_string(964));
  489.       } else {
  490.         sprintf(s,
  491.           "%s%s%6ldk%s",
  492.           charstr(21,' '),
  493.           get_string(965),
  494.           bytes_to_k(l),
  495.           get_string(964));
  496.       }
  497.       pla(s,&abort);
  498.     }
  499.   }
  500.   for (nn=0; nn<net_num_max; nn++) {
  501.  
  502.     set_net_num(nn);
  503.  
  504.     if (!net_sysnum)
  505.       continue;
  506.  
  507.     sprintf(s,"%sCHECK.NET",net_data);
  508.     i=sh_open1(s,O_RDONLY | O_BINARY);
  509.     if (i>0) {
  510.       l=filelength(i);
  511.       sh_close(i);
  512.       if (net_num_max>1) {
  513.         sprintf(s,
  514.           "%s%s%-11s%s%6ldk",
  515.           charstr(14,' '),
  516.           get_string(966),
  517.           net_name,
  518.           get_string(967),
  519.           bytes_to_k(l));
  520.         strcat(s,get_string(1242));
  521.       } else {
  522.         sprintf(s,
  523.           "%s%s%6ldk",
  524.           charstr(21,' '),
  525.           get_string(965),
  526.           bytes_to_k(l));
  527.         strcat(s,get_string(1242));
  528.       }
  529.       pla(s,&abort);
  530.     }
  531.   }
  532.  
  533.  
  534.   if (net_num_max>1)
  535.     pla(get_string(918),&abort);
  536.   else
  537.     pla(get_string(963),&abort);
  538.   nl();
  539.   thisuser.sysstatus=ss;
  540.   if((!useron) && (lines_listed))
  541.     pausescr();
  542. }
  543.  
  544. =============================================================================
  545.  
  546. NOTE - You will have to put a '=' in your CALLOUT.NET for the connects you
  547. would like to disappear from the pending box...
  548.  
  549. If you have any q's .... Leave me E-mail in the above addresses....
  550.  
  551. ***************************************************************************
  552.  
  553. And remember, if your goldfish becomes pregnant from your cat and your
  554. computer overheats to the point of "The China Syndrome", no one forced you
  555. to try this program BUT IT WORKS WELL ON MY SYSTEM AS WELL AS THOSE SYSTEMS
  556. THAT HAVE ALSO BEEN TESTING IT.  If you have any questions or comments, feel
  557. free to address them to me on one of the following networks:
  558.  
  559. WWIVnet  1@8251
  560. WWIVlink 1@18251
  561. ICEnet   1@8251
  562.  
  563.  
  564.  
  565. 2-1.  Linkutil.Exe Explanations.
  566.  
  567. Beginning version 3.1ß4, there is a new addition to the Linker utility called
  568. Linkutil.Exe.  With this, you will be able to edit the direction of which
  569. messages will travel, get a list of definable available files from fellow
  570. Linker users , send out lists of subscribers to subs of which you host,
  571. requests files via network connections and even send files.
  572.  
  573. When you enter Linkutil, you will be confronted by the following selection of
  574. things to do;
  575.  
  576. [E]dit LINKNETS.NET
  577. [G]et file listing
  578. [L]ist Subscriber Editor
  579. [R]equest file
  580. [S]end file
  581. [Q]uit
  582.  
  583. [*]Option?
  584.  
  585. 2-2.  Edit Linknets.Net
  586.  
  587. In the Edit mode, you will be prompted to explain which network you wish to
  588. send packages to and from as well as the systems to which the packages are
  589. bound for.  Just follow the prompts.
  590.  
  591. Here is the entry screen.
  592.  
  593. [W]rite LINKNETS.NET [M]odify entry [A]dd entry [D]elete Link [Q]uit ?
  594.  
  595.  
  596. 2-3.  Get File List.
  597.  
  598. This will permit you to get lists of files, sysop defined, from systems also
  599. using Linker.  They will be returned to you in your transfer section in the
  600. Sysop Directory.
  601.  
  602. 2-4.  List Subscriber Editor.
  603.  
  604. The following is the information available from the Sub Editor
  605.  
  606. Sub: (name)
  607. [A]dd Subscriber
  608. [D]elete a Subscriber
  609. [P]ost Subscriber list
  610. [R]ules posting
  611. [S]ort Subscriber list
  612. [V]iew Subscriber list
  613. [Q]uit
  614. [*]Option?
  615.  
  616. As this part of LinkUtil is straightforward, it would be redundant to list
  617. all the commands again to say how they work.
  618.  
  619. Rules Posting, this is an automated posting feature build into Linkutil. The
  620. feature can be used to post messages on any sub it does not need to be
  621. limited to just "Rules". The feature is pretty straight forward so I just
  622. outlined it a bit rather then trying to describe it in full sentences.
  623.  
  624.        o  Posts Rules (or any text info you want) on the sub being edited.
  625.        o  uses an R(subtype).* file which is located in your network
  626.           subdirectory
  627.        o  There may be multiple R(subtype) files in your directory, and
  628.           LinkUtil will post ALL R(subtype) files for the current subtype.
  629.        o  If the R(subtype) file starts with a tilde (~), the line of text
  630.           immediately following the tilde will be used as the message title
  631.           in place of "Rules Posting"
  632.        o  Rules are AUTOMATICALLY posted on the days defined in LINKER.DAT
  633.           when LINKUTIL /M is run in your midnight batch file.
  634.        o  You may, through LINKUTIL /M post rules on ANY subtype that you
  635.       subscribe to, not just ones you host.  LINKUTIL /M posts ALL rules
  636.       for ALL subtypes encountered in your Network subdirectories.
  637.       You could, in fact, post a textfile on EVERY sub you subscribe to
  638.           on a certain day (or days) each month, although why you would like
  639.           to is beyond me.
  640.  
  641.  
  642. 2-5.  Request File.  ** SEE NOTE AFTER 2-6 **
  643.  
  644. To request a file from a fellow Linker sysop, simply enter this option and
  645. enter the file name you wish to receive.  Follow the prompts.
  646.  
  647. 2.6.  Send File
  648.  
  649. You may send a file to any fellow Linker sysop by following the prompts from
  650. this area.  You will need to enter the following information
  651.  
  652. File name {Include path} :
  653. Description :
  654.  
  655. With this, the file will be sent to your fellow sysop, there to be found in
  656. his transfer\sysop directory
  657.  
  658. 2-6-1. * WARNING *  Some networks do NOT permit the transmission of files
  659. across the networks.  The penalty for this violation is usually removal from
  660. the network!  This is understandable as the networking must be paid for some
  661. way, usually out of some working sysop's pocket.  In transmitting files long
  662. distance, you will be greatly enlarging the bill for someone and that someone
  663. might be you.  My recommendations for this portion is for use cross town
  664. where there is no cost or if it is to be long distance, call the board in
  665. question and upload the file directly.  If you MUST send a file long distance,
  666. obtain permission from all intervening sysops and make arrangements.  In some
  667. cases, with fore knowledge that a file is coming through, there will be no
  668. trouble. In other cases, financial re- reimbursement will be asked and in
  669. other cases, you will be refused.  Be courteous and you will find that there
  670. is much less problems created for yourself and others.
  671.  
  672. New feature for Linker 3.2  /s command  line.  There is a new prompt from the
  673. dos command line that is now added.  You may send files from dos now using as
  674. is in the example;
  675.  
  676. LINKUTIL /A:1 /N:1 /S:C:\WWIV\DLOADS\WWIVNET\LINKER32.ZIP
  677.  
  678.  
  679. 3-1.  Linker.Dat
  680.  
  681. The Linker.Dat is a list of sysop definable enhancements with activate
  682. automated features now found in Linkutil.  The Linker.Dat is placed in the
  683. root BBS directory.  The following is a list of those defines. With
  684. every option that is added, speed during Analysis is reduced slightly. The
  685. PACKSCAN option reduces speed by about 20%.  In order to either enter something
  686. or remove it you need to comment it.  To take something out, put a ;
  687. (semi-colon) in front of it or to have it active, have the command against the
  688. left margin. You may also just add these things to your WWIV.INI file.
  689.  
  690. SUBSEND            Sends back issue messages when there is a new sub request.
  691.                    This process called BISS (Back Issue Sub Sending).
  692.  
  693. PACKSCAN=LOG.TXT   generic log somewhere in main WWIV directory.  since this
  694.                    can be become disgustingly large, you may wish to comment
  695.                    this out. It will generate some information you may wish
  696.                    to look at. The best setup for those who hate large logs
  697.                    is to put the log info into your NETDAT0.LOG. You would
  698.                    put in it in like this
  699.  
  700.                    PACKSCAN=C:\WWIV\GFILES\NETDAT0.LOG
  701.  
  702.                    for those who wish to put thier network log information
  703.                    in the daily user log you can use the USERLOG option on
  704.                    your PACKSCAN command. Example:
  705.  
  706.                    PACKSCAN=USERLOG
  707.  
  708. REMNOTE.DAT        security support (gets list of systems that can request
  709.                    files) ,supported in WWIV v4.23. Please check the
  710.                    WWIV 4.23 documentation for more information on this
  711.                    and the Packscan/Linker support.
  712.  
  713. PURGEDAY=1         to purge out dead.net, sending undelivered mail to the system
  714.                    of origin.
  715.  
  716. LISTGENDAY=1       date that you wish to generate subscriber lists to post.
  717.  
  718. DIRS               Indicates to allow the following DIRS to be requestable or
  719.                    if there is no DIRS then system will not allow auto file
  720.                    requesting. Make sure to arrange the dirs in a linear
  721.                    format and at the end of the Linker.dat file or WWIV.INI
  722.                    area.
  723.  
  724. MOREINFO           This will cause the output of more information. This is
  725.                    usually used for debuging linked connections.
  726.  
  727. RULESDAY=1         Put in the date of the month that you wish to automaticly
  728.                    post sub rules. LinkUtil will post rules that you place in
  729.                    your network data directory. The file name must be named
  730.                    R<sub type>.* and in that file you can have any text
  731.                    that you wish to post. Make sure if you have gated subs
  732.                    that you post sub rules on only ONE of the networks
  733.                    otherwise you will be sending multiple rule posts.
  734.  
  735. UPDIR=1            This option allows you to change the directory that files
  736.                    are placed when sent by Linker. Linker defaults to directory
  737.                    0 if one is not provided
  738.  
  739. PRITTY             Enables the Graphical Interface. Which shows what files
  740.                    files are being scanned and also shows a neet little
  741.                    bar graph.
  742.  
  743. T_COLOUR=          Text colour of graphical interface.
  744.  
  745. B_COLOUR=          Background colour of graphical interface.
  746.  
  747. MAINTLOG=          When this is added to Linker.dat LINKUTIL.EXE will output
  748.                    a verbose log file which is a recording of LINKUTIL's
  749.                    actions.
  750.  
  751. DELETE_UNKNOWN     When this option is enabled LINKUTIL will delete any
  752.                    Unknown systems on your hosted subs when they are sorted.
  753.  
  754. DISK_BUFFER        This option will greatly increase analyzation time if
  755.                    enabled the draw back is that 32727 Bytes extra is
  756.                    needed to do so.
  757.  
  758. LISTCOLOUR=
  759.  
  760. LISTCOLOUR is the colours used when subscriber lists are generated. These
  761. colours correspond with your WWIV colours so if you wish to use the
  762. standard 0-9 and A-Z your welcome to do so. Each number and comma
  763. corresponds to a line in the list generation. Linkutil will default to
  764. the original colours if this option is not included. Each number corresponds
  765. to a line in the Subscriber List. Here is a rundown.
  766.  
  767. Line 1: Systems Subscribing to:
  768.  
  769. Line 2: Hosted by             :
  770.  
  771. Line 3: ════════════════════════════════════════════════════════════════════
  772.  
  773. Line 4: Node    System Name   .....etc.
  774.  
  775. Line 5: ───── ───────────────────────────────────  ─────────────────────  ──
  776.  
  777. Line 6 & 7: The names of the systems subscribing color 6 is the color of the
  778. "Host" system, and color 7 is the color of the rest of the systems.
  779.  
  780. Line 8: ───── ───────────────────────────────────  ─────────────────────  ──
  781.         ^^Note that this is the end header,make it the same color as Line 5.
  782.  
  783. Line 9: Total Systems on <Network Name>.
  784.  
  785. Line 10: ═════════════════════════════════════════════════════════════════════
  786.          ^^Another "End Header" Make it the same color as Line 3.
  787.  
  788. Line 11: Total Systems on all networks:
  789.  
  790.  
  791. 4-1.  Command Line Options
  792.  
  793. The fallowing information outlines the possible command line options for
  794. Linker and Linkutil.
  795.  
  796. This is the complete list of command line options to Linker
  797.  
  798. LINKER [.[n]][/I][/O]
  799.  
  800. [.[n]]: n indicates the network in which Linker will scan
  801. [/B:[node],[subtype]]: Send back Issue subs to [node] for [subtype]
  802.   [/I]: Analyzes incoming data only
  803.   [/O]: Analyzes outgoing data only
  804.  
  805. LINKUTIL also has the fallowing command line options.
  806.  
  807. LINKUTIL [/F:filename[;]...][/S:[[drive:][path][filename[;]...]][/A:[n]]
  808.          [/N:[n]][/M]
  809.  
  810. /F:[filename[;]...]: name of file to request
  811. /S:[[drive:][path][filename[;]...] path and name of file to send
  812. /A:[n]: Node to request file from
  813. /N:[n]: Network to request file from
  814. /M: Run maintenance in unattended mode
  815.  
  816. Trouble Shooting
  817. ----------------
  818.  
  819. Q: It doesn't work!
  820. A: The most common problem with setting up linker is naming the data file
  821.    linknets.net to linknets.dat in the mistaken belief that it should be a
  822.    data file. Be sure that you have Linknets.net in your wwiv main dir.
  823.  
  824. Q: My packets are all mashed and mail is everywhere!
  825. A: check all your network data dirs for network2.exe's delete them, they
  826.    should only appear in your wwiv main dir. If you cannot then linker is
  827.    not for you.
  828.  
  829. Q: I have done that and they are still a mess! Mail doesn't seem to be
  830.    going to the correct place.
  831. A: Check your linknets.net. You likely have the nodes cross configured and
  832.    it's sending to an incorrect node or network.
  833.  
  834. Q: I am getting no linked packets in from my server.
  835. A: Inform your server, he may not have things set up incorrectly on his end.
  836.  
  837. Q: He has it set fine there, but I have noticed that my mail isn't linking.
  838. A: THREE possibilities.
  839.  
  840.         ONE your network processors are in the wrong order. Re-install
  841.         the works just to be sure.
  842.  
  843.         TWO try setting the linker processer up as an event every
  844.         night before you do your callouts. Doing this should clear up
  845.         pending network data.
  846.  
  847.         THREE you have compression set on your network data, remove it.
  848.         that is go into callout.net and remove the semicolon ";"
  849.  
  850. Q: I am running VBBS and it just doesn't work right for me.
  851. A: tough, either switch to WWIV or you are on your own.
  852.  
  853. Note:  Mods used here in the documentation are used with permission of the
  854. authors of those mods and are for use ONLY by those sysops who have registered
  855. WWIV BBS software with WWIV Support Services.  For further information on WWIV
  856. registration, contact Filo, 1@2051 WWIVNet or you local Network AC/GC.
  857. Remember, SOFTWARE PIRACY IS AGAINST THE LAW.  Lets all support the Shareware
  858. concept.
  859.