home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / comm / q4rly20.zip / Q4RLY.DOC < prev    next >
Text File  |  1989-04-03  |  7KB  |  207 lines
  1. The Q4RLY20.ARC file contains the following:
  2.  
  3. Q4RLY.SCR  - Qmodem 4.0 script for PCRelay mail transfers
  4. Q4RLY.DOC  - This documentation file
  5. READ.ME    - A little file to remind you that this is for QModem 4.0
  6. RP.BAT     - Example RECEIVE batch file for RelayNet(tm) transfers
  7. SP.BAT     - Example SEND batch file for RelayNet(tm) transfers.
  8.  
  9. Features:
  10. ---------
  11.  
  12.         Easy "fill-in-the-blank" installation
  13.         Flexible configuration
  14.         MANual and DIRectory dialing modes
  15.         MANual dial mode can restrict number of re-dials
  16.         Will gracefully exit and log when:
  17.                 the HUB drops carrier on you
  18.                 the HUB hangs on you
  19.                 the HUB didn't answer after the specified number
  20.                         of attempts
  21.  
  22.         Will recover and continue to try and deliver the mail
  23.         when:
  24.                 an incoming caller interrupts
  25.                 a baud mis-match with the HUB occurs
  26.                 you get a line that's sooooo noisy it just
  27.                         produces garbage
  28.  
  29.  
  30. Introduction:
  31. -------------
  32.  
  33.         This script is distributed free of charge to BBS Sysops
  34. whose systems are members of the RelayNet(tm) Network.  No fee of
  35. any kind may be asked or charged for it's distribution, exclusive
  36. of the cost of media.  Sysops who are RelayNet(tm) members are
  37. encouraged to distribute this script to other Sysops in the net,
  38. and to make it available to new nodes.
  39.  
  40. INSTALLATION:
  41. -------------
  42.  
  43.         To install Q4RLY.SCR on your system, make sure you have a
  44. copy in the directory you have specified in your Qmodem
  45. Installation <ALT>N.  Then, using an ASCII editor (not a word
  46. processor) you must edit the strings in the ASSIGN statements at
  47. the top of the script.  The following is a description of each of
  48. these fields and it's importance.  MAKE SURE THAT ALL STRING
  49. ENTRIES ARE ENCLOSED IN QUOTES!  If the example here uses quotes
  50. - then they are required.
  51.  
  52.  
  53. Q4RLY.DOC - Page 2                               Installation
  54.  
  55.  
  56. ASSIGN PROT "P"
  57. ---------------
  58.  
  59.         This is the Qmodem letter representing the download
  60. protocol you wish to use.  You should have corresponding Rx.BAT
  61. and Sx.BAT files (where x is the protocol letter) in your Qmodem
  62. default directory.  Example .BAT files for protocol 'P' are
  63. included in this package.
  64.  
  65. *** NOTE ***
  66.         Qmodem 4.0 will NOT pass a download path/file
  67. specification to an external protocol unless that protocol has
  68. been defined in the Qmodem install routine as using a download
  69. filename prompt.  To avoid conflicts with differing setups, where
  70. some people have their download directories hard-coded in their
  71. zmodem .bat files, and some use the download filename prompt to
  72. pass the filenames, it is strongly suggested that you set up a
  73. special set of .bat files for your RelayNet(tm) transfers.
  74.  
  75.         The example .bat files (RP.BAT SP.BAT) are the ones I use
  76. on my system daily.  Protocol letter P in the Qmodem install
  77. routine is defined as using a download filename prompt.  This
  78. allows the script to pass the information to the .BAT file.  You
  79. should modify these files to reflect the dsz command line that
  80. you prefer to use, but DO NOT move or remove the %1, %2, %3
  81. paramaters.
  82.  
  83. ASSIGN PWRD "xxxxxxxx"
  84. ----------------------
  85.  
  86.         This is where you specify your password on the HUB.  This
  87. field is MANDATORY if you are using the MANual dial option to do
  88. your mail.  The contents are meaningless if you use the DIRectory
  89. option for blind re-dialing.
  90.  
  91. ASSIGN NAME "BOB BROWNE"
  92. ------------------------
  93.  
  94.         Enter your name (in quotes) as you use it to log on to
  95. the HUB
  96.  
  97. ASSIGN DOOR "25"
  98. ----------------
  99.  
  100.         Enter the number of the HUBDOOR you on the system you
  101. call (in quotes).
  102.  
  103. ASSIGN NODEID "SOLUTION"
  104. ------------------------
  105.         Enter your NODEID as it appears in your RelayNet(tm)
  106. tag-line.  This is used for the UPLOAD function, as well as a
  107. display on the HUB while you are loggin in.
  108.  
  109.  
  110.  
  111. Q4RLY.DOC - Page 3                              Installation
  112.  
  113. ASSIGN HUB "HUBNY1"
  114. -------------------
  115.  
  116.         This is the HUBID for the HUB that you call.  It is
  117. currently only used for display and logging purposes.
  118.  
  119. ASSIGN PATH "E:\Q4\RELAY"
  120. -------------------------
  121.  
  122.         This is where you specify the directory that your packets
  123. are sent and received from.  This MUST be the same as the
  124. directory you specified in your PCRelay CONFIG program as your
  125. communications directory, otherwise the PCRelay software will not
  126. find the packets.
  127.  
  128. ASSIGN INIT "H"
  129. ---------------
  130.  
  131.         You can specify any special modem initialization string
  132. your mail transfers will require here.  The AT part need not be
  133. included.  My init is simply "H" in order to hang up the phone
  134. before I begin dialing (PCBoard takes the phone off hook when
  135. doing the event).  This field may be null, but be sure the quote
  136. marks are still there as in ASSIGN INIT ""
  137.  
  138.  
  139. ASSIGN TYPE "MAN"
  140.         OR
  141. ASSIGN TYPE "DIR"
  142. -----------------
  143.  
  144.         Use "MAN" for MANual dialing mode, "DIR" for DIRectory
  145. dialing mode.  Manual dialing mode enables you to set the maximum
  146. number of re-dial attempts.  Type "DIR" (ASSIGN TYPE "DIR") uses
  147. Qmodem's built in dialer, and cannot limit the number of redial
  148. attempts.  However, using DIRectory mode is more secure, as your
  149. PASSWORD will be read from the dialer, and does not need to be in
  150. the script.
  151.  
  152. ASSIGN PHONE "x-xxx-xxx-xxxx"
  153.         OR
  154. ASSIGN PHONE "xx"
  155. -----------------------------
  156.  
  157.         If you have selected MANual mode dialing, then enter
  158. the full telephone number of your HUB (x-xxx-xxx-xxxx).  If you
  159. have selected DIRectory dialing mode, then enter the dialer
  160. number (1 through 200 - from the Qmodem <ALT>D screen) for your
  161. HUB.
  162.  
  163.  
  164.  
  165. Q4RLY.DOC - Page 4                              Installation
  166.  
  167.  
  168. ASSIGN DIALS xx
  169. ---------------
  170.  
  171.         Replace the xx with the maximum number of re-dial
  172. attempts (MANual mode only).
  173.  
  174. ASSIGN WAIT xxxx
  175. ----------------
  176.  
  177.         Replace the xxxx with the number of milliseconds
  178. (1000 = 1 second) to wait between re-dials (MANual mode only.)
  179.  
  180. ASSIGN 9 0
  181. ASSIGN CALLERS 0
  182. ----------------
  183.  
  184.         These are internal counters and should NOT be edited.
  185.  
  186. That's all you need do to install the script.
  187.  
  188. To activate unattended script transfers, place the following
  189. segment in your event.sys file
  190.  
  191. cd \pcrelay
  192. export                              this example assumes that your qmodem
  193. cd \qmodem                          directory is called \qmodem and that
  194. qmodem /s=Q4RLY.SCR                 your relay directory is called
  195. cd \pcrelay                         \pcrelay
  196. import
  197.  
  198. Now your all set to run on automatic pilot!!  Please watch the script for
  199. the first time that it runs to make sure that all your entries are correct.
  200.  
  201. If you have any improvements to this script, then add them and upload the
  202. results to the SOS BBS, or SEND them to node SOLUTION.
  203.  
  204. Thanks,
  205.                                                   ---[ Bob ]---
  206.  
  207.