home *** CD-ROM | disk | FTP | other *** search
/ PC Online 1997 April / PCO_04_97.ISO / filesbbs / os2 / dialip14.arj / DIALIP14.ZIP / READ.ME < prev    next >
Encoding:
Text File  |  1997-02-27  |  21.1 KB  |  457 lines

  1. Hello,                    (read.me  Feb/27/1997)
  2.  
  3.                 Dial IP 1.4
  4.  
  5. This program was originally written to make a connection to the internet thru ppp.exe, check for email, let me know if I had any, and disconnect.  It was/is supposed to do this in the BACKGROUND/UNSEEN at timed intervals throughout the day so that I could know fairly soon when I got email, without having an expensive direct internet connection.  It basically does this, and more.  It ended up turning into a full fledged dialer. 
  6.  
  7. It has something old, something new, something borrowed, something OS/2.  When I first started I went looking for what was out there to use to get done what I needed.  I ended up finding 3 good 
  8. packages out there: rxpop.zip    freeware from       By Christoph Lechleitner
  9.  and
  10. nyts205.zip  freeware The New York Telephone Scheduler Version 2.05
  11. 8/7/96 11/13/96             By Stu Mark and
  12. rxu1a.zip    freeware from       By Dave Boll
  13.  
  14. rxpop has routines excellently showing how to use REXX commands to check for your email!
  15.  
  16. nyts is a nice handy little scheduler.  You might talk to him about trying to do away with the first cmd.exe window that pops up in the background and then goes away.  It would be nice to not have it show up at all!
  17.           
  18. rxu was formerly called ybda or something and has a lot of rexx routines that call C functions which really make rexx more functional. If you have ybda I assume you will want to delete your ydbautil.dll or whatever it is and just use the newer rxu.dll.
  19.  
  20. The rest is all mine.  I have turned it into a GUI program and here it is.  It is shareware, NOT FREE, but hopefully has a reasonable price.  I am asking a small price for my work, not for the others.
  21.  
  22. PRICE:
  23. ======
  24.  
  25. Price:  $10 to $30 U.S.  dollars, $5 if you really don't have the
  26. money, for 1 email id, plus $2 per additional mail id.  Pay what you 
  27. think it is worth or what you can pay.  Pay in the middle and feel
  28. o.k.  If you think it will save you a lot of time writing your own and
  29. does a good job for you pay more, and if you can't afford it right
  30. now, pay less.  If you rip me off you hopefully aren't a christian and
  31. it will surely hasten people not to program for OS/2 since they can't
  32. make any money at it, and it will be just another log in the fire come
  33. judgement day.  
  34. I will send you a registered copy in your name with the number of id.s
  35. enabled that you paid for.
  36.  
  37. nyts205.zip includes: nytsii.doc, nytsii.exe, nytsii.stu, pmpop.exe
  38. Use this or use your own.
  39.  
  40. rxu1a.zip includes: file_id.diz, procs.cmd, rxsrs.exe, rxu.dll, rxu.dsc, rxu.inf
  41.  
  42. my stuff includes: dialip.exe, killbn.cmd, killhex.cmd, showini.cmd, notify.cmd, vputil.dll
  43.  
  44.  
  45. INSTALLATION (after you unzipped the file):
  46. ===========================================
  47. Files needed to run program:  dialip.exe, vputil.dll, rxu.dll, notify.cmd, ppp.exe, pppterm.exe
  48.  
  49. 1.) Put all the files into a directory that you have included in your PATH statement in your config.sys, or make a dialip directory and put x:\dialip in your PATH statement in your config.sys and reboot.
  50.  
  51. 2.) Put vputil.dll and rxu\rxu.dll into a directory that is included in the LIBPATH statement in your config.sys, like x:\OS2\DLL
  52.  
  53. 3.) Copy dialip.hlp into x:\os2\help
  54.  
  55. 4.) Make sure you have SET TMP=x:\TMP  (or whatever path) in your
  56.     config.sys
  57.  
  58. 5.) Make sure you have something like SET ETC=x:\MPTN\ETC  (or whatever path) in your config.sys
  59.  
  60. 6.) Set up any scheduling program you want to run dialip.exe automatically.  If you need, try every 15 or 20 minutes at work, or say every 20, 30, or 60 minutes at home.  Don't go overboard, and try 
  61. not to have everyone do it at the top of every hour, etc... Do it at odd times.  (You might want to change you phone service type if you start dialing every day.  Just once per hour, 12 hours per day, 7 days per week adds up to 84 calls per week, or 360 calls per month.  Check how many local calls you get per month).
  62.  
  63. NOTE:  You can modify notify.cmd to do whatever you want, call your pager, forward it to another location, whatever.  It now pops up a message in epm and plays a tune.
  64.  
  65. CREATING AN ID:
  66. ===============
  67.  
  68. 1.) Fill in all the general info, login name, modem settings, etc...
  69.  
  70. 2.) Go to 'Connection' tab.  Choose a 'Service Provider'.  Hit 'Load Defaults'.
  71.  
  72. 3.) Hit 'Build Connection String'.
  73.  
  74. 4.) If you check 'Automatic Rebuild at Dial Time' it will rebuild the connection string from the current settings at that time before dialing.
  75.  
  76.  
  77. Notes:
  78.  
  79. The 'Connection Commands' are used to build the connection string.  Whatever variables you denote in the connection commands will be replaced when you build your connection string.
  80.  
  81. If you need a special connection string you can use 'Dial then vars - Slattach' or 'All vars - Slattach'.  Where it has <var1> you can go to the 'Extra Var.s' tab and put whatever you want into 'var1'.  For example you could put 'stan' or <login_name>.  If your login_name were 'stan' then <login_name> would get replaced with 'stan'.
  82.  
  83. The 'Extra Variables' tab is where you can define any extra variables you need, var1...var10, which you can specify in your connection string.  The variables will be replaced (even recursively) by their values when you do 'Build Connection String'. 
  84. These are the built in variables:
  85.  
  86. <modem_string_1>
  87. <modem_string_2>
  88. <login_name>
  89. <phone_no>
  90. <com_port>
  91. <baud_rate>
  92. <dial_program>
  93. <dial_string>
  94. <var1>
  95. <var2>
  96. <var3>
  97. <var4>
  98. <var5>
  99. <var6>
  100. <var7>
  101. <var8>
  102. <var9>
  103. <var10>
  104.  
  105. <login_password> is the only var. that will not be replaced (until it dials).
  106.  
  107. Connecting to IBM/Advantis:
  108. ---------------------------
  109.  
  110. This can also be done.  You don't have to fill out as much of the settings.  You will need to make sure you can connect from the IBM dialer first.  Then in Dialip fill out the login_name, password, pop server, and build the connect string.
  111.  
  112.  
  113. RUN ARGUMENTS:
  114. ==============
  115.  
  116. -id    id specifies the group of connection info you are using.  It is not the login name or login password.  This ties into the same info structure used by IBM's 'Dialer' and 'Dial Other IP'.
  117.  
  118. -pw    lets you specify a run time login password. Use like -pwmypassword
  119.  
  120. -v    verbose.  The ppp connection will tell you more of what it is doing.
  121.  
  122. -dl    tells it to dial after it starts.
  123.  
  124. -sm    tells it to send any mail you have queued after it connects.  You can use say Ultimail or whatever to send mail when you are not connected and then when it connects, if you use this flag it will send your queued mail.  This can also be good for sending big files when you want to go to bed, (like now).  You send the file offline, have the dialer connect, send, and hangup, so you don't have to hang around to disconnect!
  125.  
  126. -cm    tells it to check & notify you of any mail you have after it connects.  Right now if you have it check say every 15 minutes and you are not there it will put up a notify window every 15 minutes (taking up memory) until you actually go and get your mail.  I will try to do something about this later.
  127.  
  128. -gdm    tells it to retrieve and delete mail from server if you have any, into the directory you specify on the 'Mail' notebook page.  It does not pull it into other mail programs unfortunately 
  129. yet. It does name them sequentially though, as in emINDEX.msg.  This will keep the build up of notifies from happening if you are gone.
  130.  
  131. -gm    tells it to only retrieve mail from server if you have any, into the directory you specify on the 'Mail' notebook page.  It does not pull it into other mail programs unfortunately yet.  It does 
  132. name them sequentially though, as in emINDEX.msg.  This will keep the build up of notifies from happening if you are gone.
  133.  
  134. -dm    tells it to only delete mail from server if you have any, into the directory you specify on the 'Mail' notebook page.  It does not pull it into other mail programs unfortunately yet.  It 
  135. does name them sequentially though, as in emINDEX.msg.  This will keep the build up of notifies from happening if you are gone.
  136.  
  137. -hu    tells it to hang up when it is done.  It should wait for any mail to send before hanging up.
  138.  
  139. -dnhuim    tells it to Do Not Hang Up If Mail is found, if you do -cm and -hu and -dnhuif it will not hang up if it finds mail, otherwise it will hang up.
  140.  
  141. -ex    tells it to exit the program after optionally connecting.
  142.  
  143. -noshow    tells it to not bring up the dialer window.
  144.  
  145. -not    tells it to pop up a notify window if it finds email.
  146.  
  147. -debug    spills it guts.
  148.  
  149. Examples:
  150. =========
  151.  
  152. In say your NTYS scheduler you might have something like this:
  153.  
  154. dialip.exe -idgoodprovider -dl -sm -gdm -hu -ex -noshow
  155.  
  156. Use stan connection info.
  157. Do not bring up dialer window
  158. Dial/Connect
  159. Send queued mail
  160. Get and delete new mail from server
  161. Hangup/Disconnect  (after send mail is done)
  162. Exit
  163.  
  164.  
  165. dialip.exe -idgoodprovider -dl -sm -gdm -ex
  166.  
  167. Use stan connection info.
  168. Dial/Connect
  169. Send queued mail
  170. Get and delete new mail from server
  171. Exit    /* with connection left running */
  172.  
  173.  
  174. RUN INTERACTIVELY:
  175. ===================
  176.  
  177. If you pull down the ID list, it will list all entries you have made thru your IBM Dialer, and your Dial Other Internet Provider programs.  It will read and save into the same file to store this info. as them.   It DOES NOT use the same password field.  It uses its own.  I am not sure if IBM encrypts their passwords and if so I would not know their scheme so this way we don't mess each other up. 
  178.  
  179. If you chose and ID, then hit 'Load' to restore the saved values.
  180.  
  181. 'Password'    Leaving it blank will make it prompt you for a password at dial time.  Note you can leave it blank and give it a password thru the command line at start up time.
  182.  
  183. 'Delete'    Deletes an ID entry.
  184.  
  185. 'Save'    Saves your new values.
  186.  
  187. 'Hangup'    Hangs up but leaves the program running.
  188.  
  189. 'Dial'    Reads settings first like 'Get email', 'Send email', 'Phone #', 'Com Port', etc...  and then dials to connect.
  190.  
  191. 'Exit'    Hangs up and quits program.
  192.  
  193. 'Check 4 Mail'    Checks for any mail on the server right then.
  194.  
  195. 'Get & Delete Mail'    Gets and Deletes any mail on the server right then.
  196.  
  197. 'Only Get Mail'    Gets and does not Delete any mail on the server right then.
  198.  
  199. 'Only Delete Mail'    Does not Get and does Deletes any mail on the server right then.
  200.  
  201. 'Del Queued Ultimail'  Delete queued ultimail (sometimes 
  202. things get stuck in the queue and won't go away).
  203.  
  204. IP:
  205. ---
  206.  
  207. LOGIN NAME:  Login name to login to ISP.
  208.  
  209. PASSWORD:    Password to login to ISP.
  210.  
  211. PHONE NUMBERS:  Put in the phone number to dial.  You can put in more 
  212.     than one by just separating them with '|'
  213.     like:  1810-463-1601|254-1600|1810-463-1601|254-1600 This means it
  214.     will try these four phone numbers until it connects.  You have I 
  215.     think 100 char.s to use.  For Advantis' dialer you have 2 options,
  216.     to either have it dial using its phone numbers, or have it dial 
  217.     using dialip's phone numbers.
  218.  
  219. DEFAULT ROUTE:  You probably don't have to fill this in, but you can
  220.     if you need to.
  221.  
  222. PROGRAM TO START AT CONNECT:  Whatever command you put in here will be
  223.     run after connection.  Dialip will wait for it to finish before 
  224.     continuing.  So, if you want to start something and continue 
  225.     without waiting for it put 'start' in front of your command like:
  226.     start xxx
  227.  
  228.  
  229. MODEM:
  230. ------
  231.  
  232. INIT STRING 1:  Just put in the modem string to reset your modem.
  233.  
  234. INIT STRING 2:  Put in the modem string to set your modem up properly.  For now to get your modem init strings, use the IBM software dialers to pull up the ones for your modem.  Then hilight them and hit Ctrl-Insert to copy them.  Then go into my program and do Shift-Insert to paste them in.  TURN OFF COMPRESSION, as this does its own.
  235.  
  236. PPP PRIORITY:  Tells OS/2 what priority to run ppp at.  Defaults to 2nd highest priority.  Bump up to Time Critical if your system or your providers is really taxed (like peak usage times).
  237.  
  238. INACTIVITY TIMEOUT:  How much time of no activity before program will automatically disconnect.  Handy if you walk away and forget it.
  239.  
  240. FLOW CONTROL:  Hardware is the preferred option.
  241.  
  242. MRU SIZE:  You can probably leave blank.  Defaults to 1500.  You can put a size in if you need, like 296 for slower connections.
  243.  
  244. ----------
  245. Some of the fields like the com ports are intentionally made so you can overwrite if you need.  You can pick one like com2 of the list or you can type one in if you have something strange like some kind of shared lan modem or whatever.
  246.  
  247.  
  248. EXTRA VARIABLES
  249. ---------------
  250.  
  251. These var.s 1 thru 10 can be used in creating custom connection strings.
  252.  
  253. CONNECTION STRING
  254. -----------------
  255.  
  256. The only field that you must use here is the long connection string field at the bottom.  The other objects can just help you build a proper string.
  257.  
  258. A connection string is built from the 'Connection Program', the 
  259. 'Dial Program', and the 'Connection Commands'.  These are saveable settings that will be used if you use 'Automatic Rebuild at Dial Time'.
  260.  
  261. Picking a 'Service Provider' will fill in these fields with default values for the particular provider that I knew how to connect to.
  262.  
  263.  
  264. Examples:
  265. =========
  266. For example, if you are saying you need to answer to your ISP when you call it with a login_name, and a password, and a third value such as 'slip' or 'ppp'
  267. Try this:
  268.  
  269. 1.) At the connection menu for 'Service Provider' select 'Dial then Vars - Slattach'
  270.  
  271. 2.) Hit 'Load Defaults'
  272.  
  273. 3.) It will then tell you that it will use the following connection commands:
  274.       It will do:
  275.       <modem string 1>
  276.     wait for an OK from your modem
  277.     <modem string 2>
  278.     wait for an OK from your modem
  279.     do the dial string to call your ISP
  280.     Then waitfor whatever you put in <var1>
  281.     Then send whatever you put in <var2>
  282.     Then waitfor whatever you put in <var3>
  283.     Then send whatever you put in <var4>
  284.     Then waitfor whatever you put in <var5>
  285.     Then send whatever you put in <var6>
  286.     etc....
  287.  
  288. If any <vars> are blank it will skip them so you don't have to worry about the rest you don't need.
  289.  
  290. 4.) So, in your case, go to the 'Extra Var.s' tab and stick 'ogin:' into Var1 say to wait for a 'login:' prompt
  291.  
  292. 5.) then put <login_name> so it will send your login name after it receives 'ogin:' from above.
  293.  
  294. 6.) Then stick 'assword:' into Var3 say if you wanted to wait for a 'password:' prompt
  295.  
  296. 7.) then put <login_password> into Var4 so it will send your login password after it receives 'assword:' from above.
  297.  
  298. 8.) Then stick 'connection type:' into Var5 or whatever you see it prompts you for so it will wait for that.  Put in the last piece of the prompt to wait for like 'type:'
  299. This is all ISP dependant.
  300.  
  301. 9.) then put 'ppp' or 'slip' into Var6 so it will send your login password after it receives that from above.
  302.  
  303. In all these above like 'ogin:', 'assword:', 'type:', 'ppp', do not include the '  They are just there to help denote for you what to put in. For 'ppp' just put ppp
  304.  
  305. 10.) Go back to the 'Connection' tab and hit 'Build Connection String' and look at the string.  Whatever you put into any Var.s should show up after the dial phone number.
  306.  
  307. If you choose, 'Automatic Rebuild at Dial Time' it will rebuild this every time it dials.  You could also just make any changes you want right to this connection string, do not select 'Automatic Rebuild at Dial Time', and then whatever you put in here and save will get used every time it dials.  Therefore you have total control over your ability to create your own connection string.
  308.  
  309.  
  310. MANUAL MODE:
  311. ============
  312.  
  313. 1.) Fill in basic items like login name, password, modem settings, etc...
  314.  
  315. 2.) At the connection menu for 'Service Provider' select 'Manual Mode PPP'
  316.  
  317. 3.) Hit 'Load Defaults'
  318.  
  319. 4.) Hit 'Build Connection String'
  320.  
  321. 5.) Hit 'Connect' menu --> 'Dial'
  322.  
  323. 6.) It will start ppp.exe and pppterm.exe.  If pppterm.exe does not show up, bring up your window list and double click it to bring it into the foreground to use it.
  324.  
  325. 7.) Do any at... modem commands to set it up.  (If you got an init string already and ran it once by dialing you probably do not have to do it again.
  326.  
  327. 8.) do 'atdt'phone_number for a touch tone phone or
  328. do 'atdp'phone_number for a rotary phone to dial your ISP.
  329.  
  330. 9.) Keep track of the prompts your ISP uses and the information you need to supply to login to your ISP and start your connection.  Use this info. to create your dialip id to login to your ISP automatically next time.  For example it will probably spew info first and then prompt for something like 'login:',
  331. then          'password:'
  332. etc...
  333.  
  334. 10.) If you successfully log in then hit 'F10'.  Dialip will continue the rest of the setup, etc...
  335. If you did not successfully log in then hit 'ESCAPE'
  336.  
  337.  
  338. If you have troubles look in the file genppp.txt provided.  For one I you will need to replace spaces in say a password with '\s' so 'hal moon'  -> 'hal\smoon'
  339. And if you need a delay I think you can do that with a '\d'.
  340.  
  341. If you have more troubles just email me.
  342.  
  343. MAIL HANDLING
  344. -------------
  345.  
  346. For the mail handling page, for say 'POP ID's to Check for Mail', and
  347. 'POP ID's to Get and Delete Mail for', etc...  in these you put the
  348. number of the pop you want it to do it for.  So if you have 3 pop id.s
  349. you could put '1,2' under 'Get & Delete...'  and '3' under 'Check for
  350. mail...'  Separate the numbers by commas.
  351.  
  352. POP ID.s:
  353. ---------
  354.  
  355. POP SERVER:  Put in the hostname of the machine they tell you, like mickey.global.com  Pop server is your email server you will get mail from.
  356.  
  357. POP ID:   Login name for the POP server.
  358.  
  359. POP PASSWORD:  Login password for the POP server.
  360.  
  361. MAIL STORE DIRECTORY:  If you choose '-gdm' or 'Get Mail', this is the directory where it will put the new mail.
  362. To have PMMail use your mail set this to something like: x:\southsde\pmmail\stan_t0.act\inbox.fld
  363. Then tell PMMail to 'reindex' folder to find your mail.
  364.  
  365. MAIL INDEX:  mail files are given the names emINDEX.msg.  Index is the next index to be used.  You can change it if you need to.  If the program finds that a file exists that it wants to use it will increment the index by 1 until it finds an unused filename so as not to overwrite any mail files.
  366.  
  367. FORWARD TO MAIL ADDRESS:  If you put something in here it will not put the mail into your email client, but will send it to the email address you specify.
  368. This is useful for having one system connect to the internet and pulling down many people's email and forwarding it to them across your intranet!     
  369.  
  370.  
  371. REQUIREMENTS:
  372. =============
  373. All the tcp/ip stuff that comes with Warp Connect, Warp 4.0, or separately purchased IBM TCP/IP software.
  374.  
  375. License:
  376. ========
  377.  
  378. You are granted a license to use the software as is for up to 7 days after which you must either pay to register it or discontinue using it. If you do not register it you have no further rights to use the program. If you do register it you are paying for the right 'to use' that major version of the program for which you paid.  You have no other rights to the program.  You cannot disassemble the code or modify the code in any way.  You can freely distribute the original file to others as shareware. All rights are reserved by me.
  379.  
  380. LIMITATIONS:
  381. ============
  382.  
  383. Should write an install program.
  384.  
  385. Should encrypt password.
  386.  
  387. Add option to wait for autostarted program to finish before hanging up 
  388. and exitting.
  389.  
  390.  
  391. Warranty and Guarantee:
  392. =======================
  393.  
  394. If it doesn't work, I will fix it if I can or I will return your money.
  395.  
  396. Support to Registered Users:
  397.  
  398. If you find a major bug that damages the usability of this program for its intended use I will make every effort to provide you with a fix within 30 days or return you your money.  You can either write me thru snail mail or send email to my email address listed below.
  399.  
  400. My Intent:
  401.  
  402. To provide a good and useful program at a reasonable price and to remedy any bugs that might be found in a reasonable time.
  403.  
  404. DIAL IP CREATED UNDER:
  405. ======================
  406. Warp 4.0 at 1024 x 768 resolution.  If it looks bad under VGA or something else, let me know.
  407.  
  408. -----------------------------------------------------------------
  409.  
  410. To Register Dial IP software:
  411.  
  412. Fill out these fields below:
  413.  
  414.   Whole Name: ________________________________  (First,M.I.,Last)
  415.  
  416.      Address: ________________________________
  417.  
  418. City, State, Zip: ________________________________
  419.  
  420. Where did you get the program: ______________________________________
  421.  
  422. Your Email address and type: ________________________________________
  423.  
  424. ----------------------------------------------------------------------------
  425.   Whole Name: At least 9 characters___________  (First,M.I.,Last)
  426.  
  427.      Address: At least 7 characters___________
  428.  
  429. City, State, Zip: At least 9 characters___________
  430.  
  431.  
  432. Send  $10 to $30 US dollars, $5 if you really don't have the money,
  433. for 1 email id, plus $2 per additional email id. to:
  434. Add Michigan Sales Tax if you are in Michigan.
  435.  
  436. Stan Towianski
  437. (dial ip software)
  438. 8711 Leslie
  439. Sterling Hts, MI  48314
  440.  
  441. I will send you a registered copy in your name with the number of id.s
  442. enabled that you paid for.  
  443.  
  444. Any and all constructive comments are welcomed!
  445.  
  446. Main Posting Areas:
  447.  
  448. Internet: Hobbes (hobbes.nmsu.edu)
  449. Internet: ftp.cdrom.com
  450. CompuServe: os2share (Shareware lib), os2user (Open Forum lib)
  451.  
  452. Contact Info:
  453. =============
  454. Stan Towianski - stan@towianski.agn.net
  455.  
  456. Thank You.
  457.