home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 2 BBS / 02-BBS.zip / irexp119.zip / REXDIAL.DOC < prev    next >
Text File  |  1998-11-16  |  7KB  |  167 lines
  1. Internet Rex dialer program
  2. ---------------------------
  3.  
  4. 1. Introduction
  5. ---------------
  6.   Rexdial.exe and RexdialP.exe are a scripting programs meant to be used 
  7. along with Internet Rex in order to phone up and connect to your Internet 
  8. provider.  It's scripting abilities are limited, but it's small, quick, and 
  9. processor friendly.  Rexdial.exe yields timeslices to DesqView - RexdialP.exe
  10. yeilds timeslices to OS/2.
  11.  
  12. 2. Writing scripts
  13. ------------------
  14.   Script files are just regular text files containing a list of commands for
  15. Rexdial to execute.  The name Internet Rex uses for the script it creates
  16. is rex.scr.
  17.   You'll probably have to modify the default script Rex creates to connect
  18. properly to your provider.  Most of the initial part of the script will have
  19. been created correctly by Rex: the part that needs modifying is the part
  20. after the "dial" statement, the part where Rex talks to your provider and
  21. tries to initiate a PPP or SLIP session.
  22.   To fill in the rest of the script, try logging in to your provider once
  23. manually using your favourite comm. program.  Write down the prompts your
  24. provider gives and the correct responses to them.  These will be plugged 
  25. into the rex.scr file Rex creates.
  26.  
  27.   The two most important commands you'll need to use to create your script
  28. are WAITFOR and SEND.  These do pretty much exactly what you think they'll
  29. do: WAITFOR waits for a string to appear, and SEND sends a string you 
  30. specify.  For example, the command
  31.   WAITFOR login:
  32. would wait until "login:" came through the modem from your provider.  It
  33. wouldn't wait all day though: at the top of the script, Rex has included 
  34. the command "set timeout 30".  This means that Rexdial will wait a maximum of
  35. 30 seconds for login: to appear: if it doesn't appear in that time, Rexdial
  36. will decide the login attempt failed and will give up.
  37.   The SEND command sends the string following it, plus a carriage return at
  38. the end.  For instance:
  39.   SEND myusername
  40. would be like typing "myusername" into the keyboard and hitting return.
  41.   Using WAITFOR and SEND you should be able to negotiate your server's logon
  42. prompts and start up a PPP session.
  43.  
  44.   There are a few more commands Rexdial understands though.  Here is a
  45. complete listing of the commands and what they do.  You can also comment
  46. your scripts: any line beginning with # will be ignored by Rexdial.
  47.  
  48.   DIAL <phone number>
  49.     This dials the phone number you specify.  It will try X times, where X
  50.   is the number set with the SET REDIAL command.  BUSY and NO CARRIER's
  51.   count as a try.  NO DIAL TONE's do not.  Rexdial will try until it receives
  52.   a CONNECT or the number of attempts is too big.
  53.  
  54.   HANGUP
  55.     Simple....  :)  Hangs up the phone.
  56.  
  57.   INIT
  58.     This initializes your modem by sending the string set by the SET INIT
  59.   command and waiting for an OK from your modem.
  60.  
  61.   SEND <string>
  62.     Sends the string to the modem, along with a carriage return.
  63.  
  64.   SET
  65.     This sets a number of different internal variables for Rexdial.  There
  66.   are 6 values to set:
  67.     SET BAUD <baud rate>
  68.       This sets the speed at which Rexdial talks to your modem.
  69.         eg: SET BAUD 38400
  70.       If you're running a FOSSIL driver and your COM port is locked at a
  71.     particular speed, set the baud rate to your COM port's locked baud
  72.     rate, otherwise Rexdial won't work.
  73.  
  74.     SET INIT <init string>
  75.       This sets the init string for your modem.  eg: SET INIT AT&F1|
  76.  
  77.     SET INTERRUPT <interrupt number>
  78.       This sets the interrupt your COM port uses.  eg: SET INTERRUPT 4
  79.       This command does nothing with RexdialP, where it is pointless.
  80.  
  81.     SET PORT <COM port base address>
  82.       For Rexdial.exe ONLY!
  83.       This sets the base address of your COM port.  eg: SET PORT 0x3f8
  84.  
  85.     SET PORT <COM port>
  86.       For RexdialP.exe ONLY!
  87.       This sets the COM port to use: eg. SET PORT COM2
  88.  
  89.     If you are going to issue these commands, they MUST appear before the
  90.   INIT command in your script.
  91.  
  92.     SET REDIAL <redials>
  93.       This tells Rexdial how many times to try to connect to your provider 
  94.     before giving up.  Naturally, if you're going to issue this command, you
  95.     should do so before giving a DIAL command.  Setting REDIAL to 0 tells
  96.     Rexdial to keep dialing until it connects.
  97.  
  98.     SET TIMEOUT <seconds>
  99.       This tells Rexdial how long to wait for strings in the WAITFOR command.
  100.     You can issue this command anytime you like in a script.
  101.  
  102.   WAIT <seconds>
  103.     Rexdial pauses for however many seconds you specify.
  104.  
  105.   WAITFOR <string>
  106.     Waits until the string appears from the remote site.  It will only wait
  107.   the number of seconds specified by the SET TIMEOUT command.
  108.  
  109. 3. Running Rexdial or RexdialP
  110. ------------------------------
  111.   To make Rexdial execute a script, run 
  112.     Rexdial.exe <name of the script file>
  113. for the DOS version, or 
  114.     RexdialP.exe <name of the script file>
  115. for the OS/2 version.
  116.   You can interrupt the execution of a script at any time by hitting the
  117. escape key.  Rexdial will hangup if the script is interrupted.
  118.   Rexdial exits with errorlevel 0 if the script completed succesfully.  If
  119. anything prevented Rexdial from completing the script, it will exit with a 
  120. non-zero errorlevel and hangup.
  121.  
  122. 4. Copyright and legal stuff
  123. ----------------------------
  124. Rexdial.exe and RexdialP.exe (hereafter the two programs are referred to
  125. singly as Rexdial) are freeware.  You can use them with any program 
  126. you like at any time you like.  Later versions may include a more expanded 
  127. command set, but may be restricted to being used with Internet Rex.
  128.  
  129. Rexdial is warranted to do nothing.  It is guaranteed to take up disk space -
  130. nothing more.  If you don't like what it does, by all means contact me and
  131. let me know and I'll see about improving it.  I make no promises though.
  132.  
  133. By running Rexdial you agree that Khan Software and Charles Cruden 
  134. assume no responsibilty for anything the program may do.  If you decide
  135. you need to modify Rexdial, you implicitly assume responsibility for
  136. the program as you've modified it.
  137.  
  138. Redistribution of this version of Rexdial in an unmodified form is free and 
  139. legal, provided you include Rexdial.doc along with the executable and
  140. acknowledge Charles Cruden as the author.  Redistribution of Rexdial.exe (as 
  141. opposed to RexdialP.exe) also requires that you acknowledge Chris Blum (who
  142. wrote the UART routines used for Rexdial.exe).  Redistribution of Rexdial
  143. in a modified form requires written permission from Charles Cruden at Khan
  144. Software.
  145.  
  146. Rexdial.exe uses Chris Blum's UARTINT UART routines.
  147.  
  148. Internet Rex is copyright Khan Software.
  149.  
  150. 5. Contacting the author
  151. ------------------------
  152. You can contact Charles Cruden and Khan Software via the following methods:
  153.  
  154. Netmail: FidoNet 1:342/806
  155.          SoftNet 10:3030/0
  156.          STN Net 111:1403/11
  157.          BattleNet 169:4100/101
  158.  
  159. email: cruden@cs.ualberta.ca
  160.  
  161. Snail mail: Charles Cruden
  162.             10945 - 90 Ave
  163.             Edmonton, Alberta
  164.             Canada
  165.             T6G 1A4
  166.  
  167.