home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / pcnt4v11.zip / README.TXT < prev    next >
Text File  |  1999-03-13  |  8KB  |  174 lines

  1.                         PPPCNT OS2 PPP CoNnecTion Utility
  2.  
  3.                          (ala UNIX style PPP connection)
  4.  
  5.                   Copyright GIGAplexed Consulting Services 1998
  6.                   A REXX example that drives PPP customizations)
  7.  
  8. Prereq's
  9.  
  10.     PPP module
  11.     Warp 3 Used Version 2.0 Revision 1.12 for testing Warp 3.
  12.     Warp 4 contains the proper revision of PPP module already.
  13.  
  14.     OS2 Version 3 or higher (I haven't tried with earlier versions) with a
  15.     working configuration of PPP. Please DO NOT use this package to install
  16.     PPP. It won't do that for you.
  17.  
  18.     NOTE: Where referred to slippm.exe and 'Dial Other Provider' are the same.
  19.  
  20.  
  21. Assessment: This installation makes almost no change to your environment.
  22. Uninstall can be as simple as getting rid of the parts listed in pppcnt.lst.
  23. Config.sys is not changed. One thing is that the resolv file gets changed on a
  24. connection basis, but the original is maintained in 'resolv.ori' should you need
  25. it for some reason.
  26.  
  27.   WHY A UTILITY TO DO THIS? (if you don't care go directly to 'WHAT TO
  28. DO ...')
  29.  
  30. If you have never used IBM's Global ISP then you may not know the difference
  31. but believe me, the dialer.exe is a great deal nicer than slippm.exe. (ie 'Dial
  32. Other Provider') But still I hate using another window to drive something
  33. connection oriented, that I use on a regular basis. Actually slippm was reverse
  34. engineered to include PPP. It's annoying interface is stark, requires you to hit
  35. enter to launch your connection and asks 'Select OK to Exit'. Well if I
  36. canceled the app don't I want to exit? Also they did not implement any of
  37. the custom window save features like holding the 'alt' key and moving
  38. window permanently to a new location. On the good side this GUI is pretty
  39. rock solid in terms of problems. This utility DOES NOT DISPENSE entirely of
  40. slippm! You should still enter your connections via this GUI and test them for
  41. success. Then proceed to use PPPCNT.
  42.  
  43. You may already have a connection(s) defined within slippm? I thought to
  44. myself, wouldn't it be neat to just setup the connection info in slippm and
  45. then go off and launch ppp.exe directly by hand. (which slippm does) So for a
  46. while I had this little command file to start my connection from an icon which
  47. worked pretty dandy. Unless of course I was spaced or stoned and invoked
  48. the cmd file multiple times, then we had problems.
  49.  
  50. So I needed an indicator on the desktop but did not want the full GUI and
  51. lacked the proper specs to define the shared data area that would tell me
  52. when ppp was up and operational. Think about it .... ppp has to talk to you
  53. through some common programming communication medium to signal the
  54. event, then my little widget can say 'we're ready!'.
  55.  
  56. SO after a long walk in the park I devised a way to CHEAT!
  57.  
  58. My application knows when things are happening by using pstat to display
  59. Process ID info. I guessed and tested to find the shared memory name.
  60.  
  61. Now my utility could go from red to yellow and finally knew when to turn on
  62. the green light. But how was I to reset the icon to red when ... nothing was
  63. left running? Another trick up my sleeve. The REXX signal instruction
  64. provided just the trick.
  65.  
  66.   WHAT TO DO TO MAKE YOUR PPP GO GO GO ...
  67.  
  68.                      Click for Warp 3 or Warp 4 Downloads.
  69.  
  70.  
  71. Download the '.zip' file and unzip to \TCPIP\ETC or for warp 4 use
  72. \MPTN\ETC. Run 'dial other providers' and if it does not contain any dialer
  73. definitions create at least one. Also test dial these accounts from that dialer.
  74. It creates initial pointers in the TCPOS2.INI file that will manage which
  75. connection is active/last. Now you are ready to procede to create the
  76. PPPCNT account icons on your desktop without further need for dial other
  77. providers. Run PINSTALL 'account name'. (no quotes) Account name is one
  78. that is displayed in your Dial Other Providers screen. (under name) You can
  79. PINSTALL for as many accounts as are defined. Using an existing icon updates
  80. it and does not create new.
  81.  
  82. This will check for PPP's existance on your machine and install a traffic light
  83. icon on your desktop with the appropriate account name.
  84.  
  85. The icon's WPS setup information requires that the 'start minimized' button
  86. be set. This alleviates a slight contention problem in execution. (window is also
  87. unnecessary except for debug purposes. So if you are looking at the window
  88. that launches PPP titled 'your connection name' and wondering why things
  89. are proceding slowly, you have your answer. Minimize the window or bring
  90. the 'PPP Connection' window to the front.
  91.  
  92. If you have an internal variable volume modem you may want to manually edit
  93. the appropriate modem command string in Dial Other Providers to attenuate
  94. the sound. For USRobotics it is Mx where x=0 (off) and x=3 (for the deaf
  95. rocker) DO NOT set the '&M' parameter or you will turn error correction off
  96. and make your connection so slow as to be useless!
  97.  
  98. Now just 'click' and away you go!
  99.  
  100.   Shutting Down the Connection
  101.  
  102. To shutdown, select 'PPP Connection' from the task list. (control-esc) In that
  103. window (PPP's log) hit control-C. (and note red light is set back on when
  104. window goes away) It should be noted that care should be taken not to hit
  105. control-C twice as the first cancels PPP then the second will cancel the exec
  106. prior to the red light being set on the icon. Should this happen, proper icon will
  107. be set next time application is invoked. (in other words this is a trivial issue)
  108.  
  109. Slippm saves the connection info in TCPOS2.INI and pppcnt.cmd reads it each
  110. time it executes so changes made within slippm are automatically used.
  111.  
  112. CUSTOMIZATION ICONS
  113.  
  114. PPPCNT has the facility to specify alternate action icons. I ship a sample, ace,
  115. duce, three card to show you how it works. Get creative and make your
  116. own. Have a cool one, send it to me for inclusion in the package.
  117.  
  118.                  example: pinstall IBM three.ico two.ico ace.ico
  119.  
  120.  
  121. where 'IBM' is an account name defined in the 'dial other provider' window.
  122.  
  123. Case sensitivity in account name is important! Also if you invoke pinstall for a
  124. connection icon which already exists on your desktop, it is redefined. The icon
  125. names are maintained with the account name in TCPOS2.INI.
  126.  
  127.   DEBUGGING AND ERRORS
  128.  
  129. If there is an error message and exec is still running you can just switch to the
  130. 'PPP connection' window in the task list. The problem is that when the exec
  131. concludes the window usually goes away faster than you can see. In that
  132. case, it is easiest to modify the WPS object in the folllowing manner and let
  133. the window hang with all the info at completion.
  134.  
  135. If you you need to see (or suspect) error messages that disappear too quickly
  136. it is most convenient to uncheck the 2 boxes on the 'SESSION' page for
  137. settings of the WPS object. (right click icon and select 'settings') Uncheck
  138. these...
  139.  
  140. Start Minimized
  141. Close Window on Exit
  142.  
  143. If you experience difficulty you may contact me at
  144. 76354.1617@compuserve.com. Please be sure to include enough info so that
  145. my response may be thorough.
  146.  
  147.  
  148. Change History
  149. ______________
  150.  
  151. 04/26/98 Formal introduction
  152.  
  153. 04/28/98 Scripts now work (tested with Compuserve)
  154.          Made changes with "@" so that password is not displayed in log
  155.          Added custom icon feature
  156.  
  157. 05/06/98 Noted condition when double control-C is hit from PPP Connection
  158.          as leaving status icon in confused state. (ie green when gone)
  159.          This is because first control-C returns to exec (RXppp) from PPP and
  160.          second cancels exec prior to resetting icon.
  161.          If it hurts ... don't do it! Reinvocation will sync ... trivial.
  162.  
  163.          Added more checks for 'PPP running' in starting stage.
  164.  
  165. 06/04/98 Fixed problem with objectids and shorter account names
  166.  
  167. 11/28/98 Modifications for Warp 4. Kept as separate zip file. (fairly trivial)
  168.  
  169. 02/22/99 Added nameserver resolution file setting and maintenance of original
  170.          resolve file (as resolv.ori) should the user want it for some reason.
  171.  
  172. 03/12/99 Added null setting for empty modem strings per a bug report.
  173.          Also set CCVIEW=NO so you cannot accidentally reinvoke.
  174.