home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 3 Comm / 03-Comm.zip / phon22.zip / INSTRUCT.ION < prev    next >
Text File  |  1994-12-26  |  9KB  |  146 lines
  1. Contents of phon22.zip
  2.      instruct.ion (this file)
  3.      phone22.scr (replacement for phone.scr)
  4.      disconct.19 (replacement for disconct.scr -- disconnect with report)
  5.      
  6.      
  7.        >>WARNING Save your existing scripts before overwriting them. <<
  8.  
  9. Use these scripts at your own risk. Testing cannot include every possible modem
  10. and configuration. Read instructions carefully. If you don't understand 
  11. procedures given here do NOT attempt to use these scripts!!
  12.  
  13. These scripts are based on the v3.5 scripts in the newscr.exe file (an official
  14. CS upload) available in the CSSCRIPTS area. If you are not sure if you're using
  15. these scripts change to the directory containing your scripts and open 
  16. phone.scr in any plain text editor. All scripts from newscr.exe are v3.5 or 
  17. later and phone.scr has not been changed since this version.  If you are not 
  18. using these scripts I strongly suggest you download them and install them 
  19. before using the scripts included here. Some older versions of disconct.scr 
  20. actually hang up by calling the hang up section of phone.scr!!! Therefore it is
  21. mandatory that these versions be upgraded.
  22.  
  23. Phone22.scr:
  24.   This is a replacement for phone.scr which shows bps rate at connection. In
  25. order for it to work the response "CONNECT nnnn" >MUST< be received from your
  26. modem (where nnnn = bps number or nothing if 300). This script does NOT look 
  27. for the connect message in modem settings. "CONNECT" must appear to log on. If
  28. the word "CONNECT" is on the connect message line in modem settings then these
  29. scripts should work but the following test will assure success. To test your 
  30. modem's response choose Terminal Emulation -> Manual Connect.  Enter your reset
  31. such as AT&F  press enter.  Response should be OK Enter your init. string 
  32. without ^M such as AT&F&C1&D2  press enter. Again OK Dial your phone number 
  33. ATDTnnnnnnn  press enter. Use the actual strings from your modem and session 
  34. settings. After modems connect you should get connect response "CONNECT nnnn".
  35. You may hang up now. Additional lines are all right but the "CONNECT" must 
  36. appear. If it does you may use this script. If you have multiple session 
  37. settings, init. strings and bps rates (ini files) you should try this for each.
  38. In addition if the primary conection is repeatedly busy this script will try 
  39. the alternate connection after the specified number of retries rather than 
  40. failing as some CS phone.scr's do.
  41.   
  42.   Information reported:
  43.    If modem response is a single line "CONNECT nnnn" script will show
  44. "Connected at xxxx bps" where xxxx is 300, 1200, 2400, 4800, 7200, 9600, 12000
  45. or 14400. For 19200 and 38400 script will report DTE. Other bps rates will be 
  46. reported as 300 or unknown. If your modem appends the word ARQ or REL (often 
  47. enabled by a \V1, \V2, &A1, &A2, &A3 command or adding 2 to your S95 command 
  48. depending on your modem model - see your modem docs for your command) on the 
  49. connect message for connections with a protocol then "w/ error control" will 
  50. be appended to the bps rate message. Except for 19200 & 38400 the script 
  51. assumes a single line response shows DCE (modem to modem rate). You may need 
  52. to add a W2 command to your init to assure the single line response shows DCE.
  53.  
  54.    If your modem supports a multiple line response enabled usually by a 
  55. setting of the S95 register or the W1 command then the script will search for 
  56. the CARRIER line. If the carrier rate is 2400, 4800, 9600 or 14400 then the 
  57. script will report this as "nnnn bps DCE". If the carrier rate is different or 
  58. the line is not present then the script defaults to searching for the CONNECT 
  59. line. After finding one of these carrier lines the script will then search for 
  60. the line PROTOCOL: and if the protocol response is V.42, LAP-M, LAPM, MNP or 
  61. ALT it will add the protocol to the report as LAP-M or MNP. The script will 
  62. then search for the COMPRESSION: line and if it finds V.42BIS, MNP5 or CLASS 5 
  63. it will add V.42bis or MNP5 to the report. Finally the script searches for the
  64. CONNECT line and adds the bps rate found here to the report as the DTE. If any 
  65. of these lines is missing the script immediately goes to search for the connect
  66. message. So if there is no protocol the script won't search for compression. 
  67. The report for an oldstyle 9600 only CS node could be 
  68. "9600 bps DCE LAP-M V.42bis 19.2kb DTE". 
  69. It is advisable to set your S95 register so that the connect line reports DTE 
  70. which may require even numbers. S95=44 will be the setting that enables the 
  71. full report for many modems. The following S95 settings should result in 
  72. accurate reports: S95=1, 3, 4, 6, 12, 14, 44 & 46. S95=1 or 3 have the least 
  73. chance for error but also return the least information; generally S95=44 or 46 
  74. will be the preferred setting if you connect w/ a modem to modem rate of 2400, 
  75. 4800, 9600 or 14400 bps. 
  76.  
  77. Installing phone22.scr:
  78.    First save your existing phone.scr. This is crucial! Change to the directory
  79. containing your scripts and copy phone.scr phone.sav or any way you wish.  Copy
  80. phone22.scr into your script directory. Then copy phone22.scr phone.scr  CIM 
  81. looks for phone.scr only so you must make phone22.scr phone.scr. When you 
  82. connect to CS the connect message will appear in the CIM window right after 
  83. "Dialing nnn" assuming you connect. If you fail to connect repeatedly you can 
  84. restore your old phone.scr by copy phone.sav phone.scr.
  85.  
  86. Disconct.19:
  87.    This script uses escape and hang up commands from your modem settings. If 
  88. the modem responds with the connect failure string from modem settings at any 
  89. time the script is running then the message "No Carrier" appears in the CIM 
  90. window. No carrier will cause your modem to hang up the line. If the modem 
  91. responds with the acknowledge string from your modem settings to the escape 
  92. code then the message "Modem Received Escape Code: OK" will appear in the CIM 
  93. window. If the modem responds with the acknowledge string to the hang up 
  94. command then the message "Modem Responds OK to Hangup" will appear. Since the 
  95. v3.5 disconct.scr uses a very rapid method to assure that the node has received 
  96. the BYE and then exits the script you'll usually only get a brief appearance of 
  97. "Wait..." in the message window before the process is complete. However if you 
  98. select cancel while connecting or Control+D to leave TE while not online then 
  99. the reports on the process will be displayed.
  100.      Disconct.19 adds a new variable to allow you to easily change the hangup
  101. procedure if your modem has problems disconnecting. The 1st actual line of 
  102. disconct.19 is 
  103. OldOff = 0;
  104. OldOff = 0 tells cim to follow the normal v3.5 hangup procedure. OldOff accepts
  105. values of 0, 1 or 2. 1 sets it to use the older procedure of actually hanging 
  106. up your modem after sending the bye and 2 hangs up at the Host Name: prompt 
  107. without sending the bye. 2 is only needed in extreme cases where the modem 
  108. locks during the disconnect procedure. 1 should solve almost all disconnect
  109. problems. If you change the OldOff value be sure to maintain the semi-colon at
  110. the end of the line.
  111.  
  112. Installing disconct.19:
  113.      Procedure is similar to that for phone22.scr. First SAVE your existing
  114. disconct.scr: Copy disconct.scr disconct.sav   
  115. Then install disconct.19: copy disconct.19 disconct.scr       
  116. To restore your old script: copy disconct.sav disconct.scr
  117.  
  118. Tweaking:
  119.    Feel free to alter scripts. Remember punctuation DOES matter. Most 
  120. punctuation marks have a definite meaning to CIM. Capitalizing may be stored
  121. for names or definitions so be consistent. CIM will parse the script and will
  122. report errors and line numbers and then safely fail the procedure being 
  123. attempted if errors exist. See the file script.doc available in the DosCim 
  124. Support Forum library for further information.
  125.    To have phone22.scr report your modem init string delete the ! at the start 
  126. of line 127 in the section >Modem_OK:<. You may wish to increase the wait in 
  127. line 128 to 20 if you choose this so you have time to read your init string.
  128.    To have connect message stay on screen longer in phone22.scr go to section
  129. >Modem_Success:< (line 369) and change the number "15" to whatever you wish.
  130. This setting is in 1/10 of a second and I suggest a maximum of 25 and that you
  131. increase by 5 at a time.
  132.    To have No Carrier message stay on screen longer in disconct.scr version
  133. go to section >Got_Nocarr:< (line 166) and increase the number "10" to 
  134. whatever you wish.
  135.    To have Modem Received Hangup message stay on screen longer in disconct.scr 
  136. version go to section >Hangok_Almost:< (line 161) and change the number "10" 
  137. to whatever you wish.
  138.  
  139. Send questions, comments, suggestions and complaints to
  140.      Mike Tannenbaum  75110,2037  by CS mail only.
  141.  
  142. If your modem response is not found by this script I'd be glad to attempt
  143. to add it. Follow the test procedure for manual connect and before sending any
  144. commands to the modem turn logging on. You can then copy the appropriate 
  145. lines into your mail from terminal.log and add their meaning.
  146.