home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / infomt16.zip / infomtch.doc < prev    next >
Text File  |  1995-09-24  |  10KB  |  213 lines
  1. Infomatch Internet OS/2 Warp SLIP Connect Script
  2. Written by Graham TerMarsch (gtermars@infomatch.com)
  3. Version 1.6: September 24, 1995
  4. ----------------------------------------------------
  5.  
  6. This is the documentation file for the Infomatch Internet OS/2 Warp SLIP
  7. Connection Script (hereafter referred to as, "the script").  Please refer to
  8. the README file for more information regarding distribution and restrictions
  9. of usage for this script and the accompanying files.  Portions of this script
  10. are written by Harold Roussel (roussel@physics.mcgill.ca).
  11.  
  12. In this file you'll find information on how to get the script up and running
  13. for yourself with the OS/2 Warp IAK.  If you have problems getting this script
  14. to run, please feel free to contact me; send e-mail to gtermars@infomatch.com
  15. containing a subject line of "Infomatch connect script".
  16.  
  17. Please note that the script is a customization (ok, SERIOUS customization) of
  18. the ANNEX.CMD script that is distributed with the OS/2 Warp IAK.  Portions of
  19. the script have been written by Harold Roussel (roussel@physics.mcgill.ca).
  20.  
  21. -------------------------------------------------------------------------------
  22. Features:
  23.  
  24. - Redial capability
  25. - Audible notification of successful connection or failure to connect to host
  26. - Ability to start other applications upon successful connection
  27. - Command line arguments to turn on/off features as well as set username,
  28.   password, etc.
  29.  
  30. NOTE:   To properly use the redial capability of this script, you must have
  31.         updated your SLIP dialer to a recent version.  Use your 'Retrieve
  32.         Software Updates' icon in the IAK folder to update your version if
  33.         you are unsure of it's level.
  34.  
  35. -------------------------------------------------------------------------------
  36. DISCLAIMER:
  37.  
  38. You were waiting for this, weren't you?  Well, it's a standard disclaimer; I've
  39. managed to get this working on my machine and have thus provided it to others.
  40. By use of this script you acknowledge that I am not responsible for any damages
  41. that may be incurred through it's use, either directly or indirectly.  Yes, I
  42. am available to answer your questions if you have a problem, but I take no
  43. responsibility for your actions.  You downloaded it, and if you use it you take
  44. full responsibility into your own hands.  If you do not agree with this then
  45. simply discontinue use of this script.
  46.  
  47. -------------------------------------------------------------------------------
  48. COMMAND LINE ARGUMENTS:
  49.  
  50. There are several command line arguments that can be used to help customize the
  51. script for your own usage.  Arguments are not case sensitive.
  52.  
  53. -ATTEMPTS xx
  54.         Sets the maximum number of attempts that will be used for dialing to
  55.         'xx'.  A value of 0 signifies that the script should continue to dial
  56.         until a connection is made.  The default value is zero.
  57.  
  58. -NAME xxx
  59.         Sets the username to log into Infomatch Internet with to 'xxx'.  If no
  60.         username is given, the script will ask for one before dialing.
  61.  
  62. -PASSWORD xxx
  63.         Sets the password to log into Infomatch Internet with to 'xxx'.  If no
  64.         password is given, the script will ask for one before dialing.
  65.  
  66. -BEEP xxx
  67.         Sets whether or not the script should beep when either a successful
  68.         connection has been made or the script has failed to connect.  Valid
  69.         values are 'ON' and 'OFF'.  The default value is 'ON'.
  70.  
  71. -AUTOSTART xxx
  72.         Sets whether or not the script should automatically start a REXX script
  73.         file called LOGGEDIN.CMD which is assumed to be somewhere on your path.
  74.         Valid values are 'ON' and 'OFF'.  The default value is 'ON'.
  75.  
  76. -ADDRESS xxx.xxx.xxx.xxx
  77.         Sets your IP address.  This is the address that Infomatch Internet has
  78.         given to your for your connections.  Enter the address in dotted
  79.         decimal notation (ie. 199.60.99.1).  If no address is given, the script
  80.         will ask for one before dialing.
  81.  
  82. -------------------------------------------------------------------------------
  83. HOW TO SETUP YOUR DIALER WITH THIS SCRIPT:
  84.  
  85. Following, find the necessary options that need to be set in the Dial Other
  86. Internet Provider application in order to get the best usage out of this
  87. script.  Have your IP address and username handy.  If you find that there are
  88. entries in your entry that do not appear here it is because they do not affect
  89. the usage of this script (however, they should still be set as needed).
  90.  
  91. Login Info:
  92.   Login ID:             (leave blank)
  93.   Password:             (leave blank)
  94.   Required:             (uncheck this checkbox)
  95.   Phone Number:         (leave blank)
  96.   Login Sequence:       infomtch.cmd [arguments]
  97.          Example:       infomtch.cmd -address 199.60.99.13 -name slip123
  98.                         -password xxx -beep on -autostart off -attempts 0
  99.  
  100.          This sets up the script to log you in as user 'slip123' with password
  101.          'xxx', audible notification on, infinite dialing attempts, and an IP
  102.          address of 199.60.99.13 for your computer.
  103.  
  104.   Connection Type:      SLIP
  105.  
  106. Connect Info:
  107.   MTU Size:             1500
  108.   VJ Compression:       Enabled
  109.   Domain Nameserver:    199.60.99.1
  110.   Your Domain Name:     infomatch.com
  111.  
  112. Server Info:
  113.   News server:          news.infomatch.com
  114.   WWW server:           www.infomatch.com
  115.   POP mail server:      pop3.infomatch.com
  116.   Reply domain:         infomatch.com
  117.   Reply ID:             (your username)
  118.   POP login ID:         (your username)
  119.   POP password:         (your password)
  120.  
  121. Modem Info:
  122.   Set up this page as is necessary for your particular modem.  If you find that
  123.   there are several items that are unavailable for you to enter data into,
  124.   don't worry.
  125.  
  126. -------------------------------------------------------------------------------
  127. HOW TO USE THE AUTOSTART FEATURE:
  128.  
  129. Upon successful connection, the script will attempt to start a REXX script file
  130. called LOGGEDIN.CMD.  This script file should contain the commands required to
  131. start any applications that you wish to have running upon each and every login.
  132. It is assumed that the LOGGEDIN.CMD file is somewhere on your path.  I've
  133. placed mine in the \TCPIP\BIN directory.
  134.  
  135. Note that the LOGGEDIN.CMD file must contain all of the commands needed to set
  136. up the application into it's working directory and start the application; some
  137. applications need to be in a specified working directory when they are started.
  138.  
  139. When starting your applications, it is preferable to use the 'DETACH' command
  140. instead of the 'START' command; START causes an entire command shell to be
  141. started while DETACH only starts the requested application.  The last line of
  142. your LOGGEDIN.CMD script file MUST be 'EXIT'; otherwise you will have one
  143. extra open command line shell.
  144.  
  145. Sample LOGGEDIN.CMD file:
  146.  
  147.    REM **********************************************************************
  148.    REM *** Mail reader.  PMMail requires that you be in the working directory
  149.    REM *** when the application is started.
  150.    REM **********************************************************************
  151.    D:
  152.    CD \PMMail
  153.    DETACH PMMail.Exe
  154.  
  155.    REM **********************************************************************
  156.    REM *** Finished, exit this command shell.
  157.    REM **********************************************************************
  158.    EXIT
  159.  
  160. -------------------------------------------------------------------------------
  161. REVISION HISTORY:
  162.  
  163. 1.6, September 24, 1995
  164.         Script no longer needs a patched dialer program; this script will now
  165.         work properly using any version of the SLIPPM dialer program.  As a
  166.         result, the SLIPPTCH patching program is no longer included in this
  167.         archive.  As well, output shown in the dialer's status window is
  168.         different than in previous versions; I decided to only output relevant
  169.         information instead of the entire login sequence.
  170.  
  171. 1.5, September 17, 1995
  172.         Added the ability to turn on/off any of the features as well as
  173.         customize the behaviour of the script.  This has significant changes
  174.         regarding the command line arguments.
  175.  
  176. 1.4, September 7, 1995
  177.         Added functionality to automatically start a REXX script file called
  178.         LOGGEDIN.CMD upon a successful connection.  This script file must be
  179.         somewhere upon your path.
  180.  
  181. 1.3, August 10, 1995
  182.         Altered the behaviour so that the dialing is no longer heard, and
  183.         added an audible notification to the user for both a successful
  184.         connection as well as failure to connect.
  185.  
  186. 1.2, July 26, 1995
  187.         Internal code alteration.  Modified to make easier to read as well as
  188.         changed the way that the redialing is handled.
  189.  
  190. 1.1, July 14, 1995
  191.         Added Harold Roussel's waitfor2 and waitfor3 routines to make the
  192.         script more robust regarding busy signals and bad connections
  193.  
  194. 1.0, ???
  195.         Initial release.  Featured redial capability.
  196.  
  197. -------------------------------------------------------------------------------
  198. CONTACTING THE AUTHOR:
  199.  
  200. I can be reached by e-mail at gtermars@infomatch.com.  If you do not have
  201. e-mail access, I can be reached by snail mail at:
  202.  
  203.         Graham TerMarsch
  204.         #701-1555 Harwood St.
  205.         Vancouver, B.C.
  206.         Canada     V6G 1X8
  207.  
  208. Note that I have no connection with Infomatch Internet other than that I am a
  209. user of their service.  I am not employed by Infomatch Internet, and receive no
  210. payment for this script.  However, if you do find this script useful, any $$$
  211. or spare computer parts that you can send along would be greatly appreciated.
  212. :-)
  213.