home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / dialip2.zip / genppp.txt < prev    next >
Text File  |  1996-12-02  |  21KB  |  496 lines
  1.               General Recipe for OS/2 TCP/IP (and IAK) PPP
  2.                     Last updated 96/10/30
  3.  
  4. NOTE:  If you are going to use Compuserve as your internet
  5.        service provider, download file CISPPP.TXT from OS2USER
  6.        library 9.
  7.  
  8. This file is authored by Tony Rall of TEAMIBM (trall@almaden.ibm.com)
  9. with some assistance from Howie Acheson (102562.102@compuserve.com) with
  10. a special thanks to Ron Higgin, OS/2 Advisor, for his comments and
  11. advice.
  12.  
  13.  
  14. PURPOSE - To configure the "Dial Other Internet Provider" dialer for
  15.           accessing an Internet Service Provider (ISP).
  16.  
  17.  
  18. To establish an internet connection you must have one of the following
  19. installed on your system:
  20.  
  21.    o OS/2 Warp V4 with the TCP/IP v4.0 feature installed. If you do 
  22.       not have the TCP/IP feature installed you may do so using the
  23.      "Selective Install for Networking" utility in the
  24.      "Install/Remove" sub-folder of the "System Setup" folder. If
  25.      you do this and do NOT have a LAN connection then use the
  26.      "Easy" TCP/IP install procedure (NOTE: You CAN NOT install 
  27.      TCP/IP v4.0 over the IBM Internet Connection for OS/2 from the 
  28.      WARP 3.0 Bonus Pack. All remnants of the IIC must be removed 
  29.      first.) or,
  30.  
  31.    o OS/2 WARP Connect V3 with the TCP/IP v3.0 feature installed.
  32.       DO NOT install the IBM Internet Connection for OS/2 feature of 
  33.       the WARP Connect Bonus Pack when the TCP/IP feature is 
  34.       installed.  Installing the IIC over the WARP Connect TCP/IP 
  35.       feature will render TCP/IP inoperative.  TCP/IP v3.0 uses the
  36.       same dialer as IIC.  Therefore, you should download and install
  37.       PPP.ZIP to ensure you are using the latest dialer (see above) 
  38.       or,
  39.  
  40.    o OS/2 WARP V3 with the Bonus Pack's IBM Internet Connection for 
  41.       OS/2(IIC) with the latest PPP update applied.  The PPP update 
  42.       may be downloaded from library 9 ("Internet and OS/2") of
  43.       the OS2USER forum as file name "PPP.ZIP", or FTP'd from 
  44.       "ftp.ibm.net",  directory "/pub/PPP", as file name "PPP.ZIP". 
  45.       In addition, download and install the TCP/IP Base Update 
  46.       (PN71501) from Retrieve Software Updates.
  47.  
  48.      To install the PPP update:
  49.  
  50.         - place the "PPP.ZIP" file in your "\TCPIP" directory
  51.         - Open an OS/2 command prompt session
  52.         - Make the "\TCPIP" directory "current"
  53.         - UNZIP (using InfoZip's unzipper) the "PPP.ZIP" file
  54.  
  55.      If you do not have the InfoZip unzipper, PKZIP (V2.04) or
  56.      later may be used BUT you MUST run it from a DOS command
  57.      prompt session and you MUST specify the PKUNZIP "-d" option.
  58.  
  59. =====================================================================
  60. NOTE: CSD PN71501 (TCPIP Base Update) is NOT required for users of 
  61. "OS/2 Warp Connect V3" or "OS/2 Warp V4".
  62. =====================================================================
  63.  
  64.      IF you have the "Warp for Windows Users" (RED spine box)
  65.      product you MUST also install OS/2 Fix Pack 5 or later.
  66.  
  67.  
  68. Once you have the PPP update installed, you need to open the Dial
  69. Other Internet Providers object. Warp V3 users will find this object
  70. in the "Internet Utilities" subfolder of the "IBM Internet Connection
  71. for OS/2" folder.  Warp V4 users will find the object in the
  72. "Internet (Modem)" subfolder of the "Programs" folder.
  73.  
  74. Once you've fired up the "Dial Other Internet Providers" utility,
  75. choose the Add Entry object, or select Add Entry from the Configure
  76. pull-down menu, then configure dialer as follows:
  77.  
  78. * Your primary source of assistance for signing on to an Internet
  79.   Service Provider(ISP) should be the ISP.  The ISP will have to
  80.   provide you with some of the information to configure the dialer.
  81.  
  82. * If your provider has given specific instructions for connecting
  83.   using OS/2 TCP/IP or the Warp IIC, follow them (to the
  84.   letter).
  85.  
  86. ====================================================================
  87. GENERAL CAVEAT
  88.  
  89. The Internet is CASE SENSITIVE.  Any place in this document where
  90. a case is shown for information to be entered into the dialer, be
  91. sure to follow the case EXACTLY.  Be sure to understand and follow
  92. the case for any information provided by your ISP.
  93. ====================================================================
  94.  
  95.  * Use the "Dial Other Internet Providers" application.
  96.  
  97.  * Click on "Add Entry"
  98.  
  99.  * Page 1: (Login Info)
  100.  
  101.      - In the Name:  field, type a "name" for this connection.
  102.        BE SURE TO USE ALL UPPER CASE.  This name serves only to
  103.        identify the target provider dialer entry.  The dialer
  104.        itself does NOT reference this "Name", and hence, it may
  105.        contain any name YOU find meaningful.
  106.  
  107.      - In the Description:  field, enter a description for this
  108.        connection.  This is for descriptive purposes only.  The dialer
  109.        does NOT use the contents of this field.
  110.  
  111.      - For the Login ID: field enter your User ID number.
  112.  
  113.      - Fill in your password.  If you leave Password blank, check
  114.        "Required" and you will be prompted for your pw each time you
  115.        dial.  IMPORTANT-If your password contains one or more blank
  116.        characters (spaces), substitute the the TWO character string "\s"
  117.        for EACH blank character.
  118.  
  119.      - For the Login Sequence use "NONE".  PAP authorization will be
  120.        attempted by ppp.  If this does not work with your provider, try
  121.        a completely blank Login Sequence.  If this doesn't work, look
  122.        at the help information (put cursor in the area and hit F1).
  123.  
  124.     * General comments about the Login Sequence:
  125.  
  126.       o Several characters are invalid in a LS without being preceded
  127.         by the escape character "\", plus other special characters
  128.         (these same comments apply to the Login ID, password, and
  129.         modem initialization strings):
  130.  
  131.           space - replace by "\s"
  132.           carriage return - replace by "\r"
  133.           back slash "\" - replace by "\\"
  134.           double quote " - cannot be used at all (near as I can tell)
  135.           2 second delay - use "\d"
  136.  
  137.       o The first string is sent FROM you to your provider - it is
  138.         usually just a carriage return, "\r".
  139.  
  140.       o Alternate lines are those that the dialer is to wait for from
  141.         your provider.  The dialer (actually slattach.exe) will ignore
  142.         everything it receives until it get an exact match with the
  143.         string you've entered - and the comparison is case-sensitive.
  144.         If slattach doesn't get what it expects in (by default) one
  145.         minute, it will abort the connection.
  146.  
  147.       o If it does get a match, it will send the next line in the
  148.         Login Sequence.
  149.  
  150.       o The on-line help for the Login Sequence is reasonably good.  To
  151.         see it, place your cursor in the LS and hit F1.  It omits a
  152.         couple of details; you can get those using, at an OS/2 command
  153.         prompt, "slattach -?".
  154.  
  155.     * If a Login Sequence, by itself, is insufficient for your needs,
  156.       you must go to a Rexx script (a .cmd file).  One of the most
  157.       frequent motives for this is when you have a provider that
  158.       doesn't have enough phone lines to accommodate his customers
  159.       (I would have to be pretty desperate to use a provider like
  160.       that) - in this case, you may want an automatic redial script.
  161.       The Login Sequence doesn't supply this capability.  (Note:
  162.       using a response file (.rsp) provides no functional advantage
  163.       over using a regular Login Sequence; the only impetus I can
  164.       see for a response file is if slippm.exe has some undesirable
  165.       side effects in your environment.)  WHEN SPECIFYING A "cmd"
  166.       OR "rsp" FILE IN THE LOGIN SEQUENCE, IT MUST BE DONE IN LOWER
  167.       CASE.
  168.  
  169.       Unfortunately, IBM does not include any sample scripts for
  170.       ppp,but here are some samples in OS2USER library 9. If you
  171.       feel that you need a Rexx scrip, I recommend trying to get
  172.       a hold of pppdial.cmd, distributed at popular OS/2
  173.       ftp sites as ppdialxx.zip.
  174.  
  175.       If you want to make your own, issue "ppp -?" for help on the
  176.       parameters required by the ppp driver.  Annex.cmd (or
  177.       slipup.cmd) would need to be changed in the following ways:
  178.  
  179.       The arguments are passed differently to ppp scripts than they
  180.       were for slip.  They come in as individual parameters which,
  181.       in Rexx, must be separated by commas in your script.  (The
  182.       third parameter is CMD - I don't know of a use for it, so I
  183.       discard it.)  The "parse arg" statement near the beginning of
  184.       your script must look like this:
  185.  
  186.        parse  arg interface , port , . , dialcmd , username , password
  187.        typical values: ppp0   com1       ATDTnnn   userid     password
  188.  
  189.       Change all occurrences of the function calls "slip_..." to
  190.       "ppp_...".
  191.  
  192.       Assuming your provider supports PPP IP address configuration
  193.       (this is dynamic and under the covers), you can remove the
  194.       parsing of addresses, configuring the interface, and setting the
  195.       default route - this will be taken care of automatically.
  196.  
  197.   - Connection Type: PPP
  198.  
  199.  
  200. * Page 2: (Connect Info)
  201.  
  202.   - Leave blank Your IP Address, Destination IP Address, Netmask.
  203.  
  204.   - Don't change the MRU (ppp seems to ignore this anyway).
  205.  
  206.   - Domain Nameserver - add the numeric IP address of your provider's
  207.     primary nameserver, e.g., 1.2.3.4
  208.  
  209.   - Your Host Name - enter a name for your PC (mine is "trall").  Put
  210.     the same name in your CONFIG.SYS following other SET statements near
  211.     the top of your CONFIG.SYS (first 20 lines or so).
  212.  
  213.         SET HOSTNAME=TRALL
  214.  
  215.     You must reboot for this to take effect.
  216.  
  217.   - Your Domain Name - usually the name of your provider, e.g.,
  218.     netcom.com
  219.  
  220.  
  221. * Page 3: (Server Info)
  222.  
  223.   - All of this information is optional.  Entering it correctly will
  224.     make it easier to use the related applications.  Your provider
  225.     should supply anything you use here.
  226.  
  227.  
  228. * Page 4: (Modem Info)
  229.  
  230.   - Modem Type - I don't mess with this, but if you don't understand
  231.     the commands for your modem and you can find it in the list, go
  232.     ahead and select it. (See below)
  233.  
  234.   - Com Port - Get this right.  Note that if you use anything above
  235.     com2 you need to define it in CONFIG.SYS with a COM.SYS statement.
  236.  
  237.   - Speed (Baud) - This misnamed field is referring to what is
  238.     actually called the DTE speed - the data transfer rate between
  239.     the com port and the modem.  In general, the higher, the better.
  240.     But the standard com support (COM.SYS) currently supports no
  241.     higher than 57600.  If you seem to be having problems communicating
  242.     with the modem, drop this to 9600 to ensure that this is not the
  243.     cause.
  244.  
  245.   - Data Bits - Leave at 8.
  246.  
  247.   - Parity - Leave at NONE.
  248.  
  249.   - Prefix - Leave at ATDT (unless you don't have tone dialing; then
  250.     use ATDP).
  251.  
  252.   - Mode - Leave at Dial
  253.  
  254.   - Initialization Strings - If your modem type was not in the list
  255.     at the top of the page, see below.
  256.  
  257.  
  258. Modem Init Strings
  259.  
  260. There is also a file titled MODEMIAK.ZIP in OS2USER library 9 that
  261. contains an updated and expanded list of modems and init strings that
  262. can be used with the dialer.
  263.  
  264. Another option is to use the initiation strings suggested for use in
  265. the IBM Dialer.  You can view these by using your editor and loading
  266. the file MODEM.LST that resides in x:\TCPIP\ETC.
  267.  
  268. =====================================================================
  269. NOTE: If you are using OS/2 Warp Connect V3 or OS/2 Warp V4 the
  270.       "MODEM.LST" (and other files normally found in the
  271.       "x:\TCPIP\ETC" directory) will be located (by default) in the
  272.       "x:\MPTN\ETC" directory.
  273. =====================================================================
  274.  
  275. The reason there are 2 init.  strings is that some modems require a
  276. delay between a reset and any other commands.  Typically the first
  277. command is to reset to factory defaults; then the other string is used
  278. to make any changes needed from those defaults.  In practice, most
  279. modems work fine with just one string (which can be quite long), and
  280. this avoids the 2 second delay that is inserted between the 2 strings.
  281.  
  282. If you cannot find a string(s) that work, I recommend you try this (in
  283. Init. string 1; leave Init. string 2 blank):
  284.  
  285.    AT&FM1E1S0=0&C1&D2
  286.  
  287. Not all of these commands are available on every modem; if you
  288. get ERROR when you dial (as a response from the modem), start removing
  289. stuff until you don't.
  290.  
  291.  &F    reset to factory defaults (check your modem manual to see if
  292.        there is a different command for this; if there are several,
  293.        use the one for asynchronous communication with RTS/CTS
  294.        (hardware) flow control)
  295.  
  296.  M1    speaker on (usually a default)
  297.  
  298.  E1    echo on (so you can see the commands being sent to the modem,
  299.        including the dial string)
  300.  
  301.  S0=0  no auto-answer
  302.  
  303.  &C1   signal true carrier-detect
  304.  
  305.  &D2   hang-up when DTR drops (this is how slip/ppp makes the modem
  306.        break the connection)
  307.  
  308.  
  309. ESTABLISHING THE INTERNET CONNECTION
  310.  
  311. Then to establish your PPP connection, select the NAME of the
  312. connection and choose DIAL.  You will then see the initialization of
  313. the modem, the dialing, the logging in, and you should see messages in
  314. the Status Window reporting the remote IP address, VJ compression
  315. enabled, and that the default route address has been assigned.  Do
  316. not be concerned if you see a couple of "fcs" error notices.
  317.  
  318.   The final line will be
  319.  
  320.        "[PPP] Enter Ctrl-C or Ctrl-Break to End Session"
  321.  
  322. When you see the above messages, then the connection is complete and
  323. you can envoke any of the internet applications. You must leave the
  324. dialer running while you have the PPP connection active. You may want
  325. to minimize the dialer after the connection is established.
  326.  
  327. The first thing you should do after connecting to the internet is to use
  328. the "Retrieve Software Updates" and download "Base Update for TCP/IP
  329. (PN71501).  This will allow the full functions of the IBM WebExporer.
  330. No other CSD's or TCP/IP updates are required.
  331.  
  332.  
  333.   PROBLEM SOLVING
  334. The number one reason for an unsuccessful connection is having illegal
  335. characters (usually spaces) in the script, modem strings, password
  336. and/or user ID.  Be sure and check by placing your cursor at the
  337. beginning of a space, pressing and LMB while dragging the cursor to
  338. the end of the space or to the end of the line of the script.  There
  339. should be not empty spaces in any of the "fill in" spaces and only one
  340. space at the end of each line in the script.
  341.  
  342. IMPORTANT
  343. If you are using WARP v4 be sure you have not installed TCP/IP v4.0 
  344. over the WARP 3.0 Bonus Pak IBM Internet Connection for OS/2.  You 
  345. must remove the IIC by deleting all TCPIP references in your 
  346. CONFIG.SYS, rebooting and deleting all the TCPIP directories, 
  347. subdirectories and files.
  348.  
  349. * After clicking on the Dial icon, it switches to Hang-up and then
  350.   immediately switches back to Dial - quitting immediately.
  351.  
  352.   - Make sure there are no spaces in your userid or password; you
  353.     can substitute "\s" for any spaces.
  354.  
  355.   - Your com port is not defined to OS/2.  On ISA bus machines,
  356.     COM1 and COM2 are the only ones defined by default.  If you use
  357.     COM3 or 4, you need to add a COM.SYS statement to config.sys (and
  358.     reboot).
  359.  
  360.     - Make sure the Netmask (on page 2 of the dialer settings) is not
  361.     255.255.255.255 - I consider it best to leave this field totally
  362.     blank.
  363.  
  364.   - Your com port is still held by some other program (another com
  365.     or fax program).  You must exit that program before dialing.
  366.  
  367.   - Anyone using the original red spine Warp (for Windows) and
  368.     communications apps should have at least fix pack 5 installed.
  369.  
  370. * The dialer does not appear to talk to the modem and, after one
  371.   minute, terminates with a failure.  On some hardware combinations
  372.   there appears to be a flow control problem on the com port.
  373.   Issuing the following command before dialing may help:
  374.   MODE.COM COMn:1200
  375.  
  376.   On other modems, forcing the modem to reset after the previous
  377.   connection helps.  Change &D2 in your modem init. string to &D3
  378.   (not all modems support this command).
  379.  
  380.   Other users have solved this problem by replacing com.sys with
  381.   the shareware (by Ray Gwinn) SIO.SYS, generally available at your
  382.   favorite download sites.
  383.  
  384. *  Message in dialer window and in ppp0.log "..could not determine
  385.     hostname". Make sure you have this statement in config.sys:
  386.         SET HOSTNAME=nameofmypc
  387.  
  388.   Lacking this, ppp.exe may hang for one minute before redial
  389.   attempts.
  390.  
  391. * [io_event] Unsupported protocol (xxxx) received.
  392.   The remote server is trying to setup additional communications
  393.   protocols (such as IPX) that ppp.exe does not support.  This is just
  394.   an informational message.  Ppp.exe will reject that protocol; this
  395.   will not cause a problem unless the server insists on that protocol
  396.   being supported.
  397.  
  398. * [io_event] Unsupported protocol (2080) received.
  399.   This is a special case of the previous item.  The 2080 is definitely
  400.   not a ppp protocol - it happens to be a couple of ASCII characters
  401.   typically used to format text (non-ppp) messages.  In other words,
  402.   the server is not yet in ppp mode (but OS/2 is).
  403.  
  404.   This usually means that either:
  405.  
  406.   - you didn't get correctly logged in (from the server's viewpoint),
  407.     and it is sending you error messages, but ppp.exe is expecting
  408.     formatted ppp messages at this point
  409.  
  410.   - you did get logged in, but the server is sending a few more
  411.     text messages, such as:
  412.  
  413.      Ok, you're on
  414.      Let me get my ppp code fired up
  415.      Hold on a sec
  416.      Ok, it's up
  417.      Have a good day
  418.  
  419.   If you want to eliminate this error, you have to find out what the
  420.   messages are.  In the first case (bad login), correcting the login
  421.   should suffice.  In the second, you'll need a fancier Login Sequence
  422.   (not a blank or NONE LS).  One way to determine what is being sent
  423.   is to put an intentional error in your LS: after the last line to be
  424.   sent to the server add a line with "xxxyyy".  This won't match, so
  425.   the Status window will display all messages received.  If it wasn't
  426.   indicating a login error, replace the xxxyyy with the last part of
  427.   the last such message.  In the example above, the last line in your
  428.   Login Sequence should contain:
  429.  
  430.      good\sday
  431.  
  432. * Invalid FCS - Bad phone line or modem, or, more likely, ppp.exe has
  433.   entered ppp mode while the remote system is still sending text
  434.   messages.  The latter can often be corrected by improvising a better
  435.   Login Sequence.  But don't do anything at all if you just get a few
  436.   of these messages at the start of the connection.  If they continue
  437.   throughout your session, you should try to correct the problem -
  438.   usually a phone or modem problem.
  439.  
  440.   - getting a better serial card (with a buffered uart)
  441.  
  442.   - running the com port at a lower speed ("baud" on page 4)
  443.  
  444.   - replacing the serial cable
  445.  
  446.   - getting a better phone connection
  447.  
  448.   - using a better initialization string for the modem
  449.  
  450.   - suppressing modem compression (such as V.42bis)
  451.  
  452.   - replacing the modem
  453.  
  454.   - replacing com.sys with the shareware sio.sys (or vice versa). SIO
  455.     is available from CIS in OS2BVEN library 4 as SIOxxx.ZIP or from
  456.     most OS2 BBB's.
  457.  
  458. * After the message "Enter Ctrl-C or Ctrl-Break to End Session", you get:
  459.  
  460.    notice : DCD lost, exiting
  461.    info : Exit called
  462.    info: Terminating link
  463.  
  464.   - This could be caused by an attempt by your system to send mail to
  465.      a mail gateway if you do not have a correctly configured mail setup.
  466.      Messages may end up queued in etc\mqueue\.  When you make your
  467.      connection an attempt is made to send these messages immediately.  If
  468.      you still have a bad mail configuration, you can get the error
  469.      described above, and ppp (erroneously) hangs up.  Erase the files in
  470.      the etc\mqueue directory and try redialing.
  471.  
  472.   - The problem may be in your modem cable.  Older modem cables frequently
  473.      did not have all pins (25) and/or wires.  If you have an older cable, try
  474.      a new one.
  475.  
  476. * You tell the system to hangup, but the modem stays off-hook (it does
  477.   not hangup).  This can run up your phone bill (if a toll call) and
  478.   can foul up your next connection attempt.  There are 2 ways that
  479.   software can tell the modem to hangup:
  480.  
  481.   The "+++ ATH0" escape sequence and command will make most modems
  482.   hangup, but I know of no way to make the dialer issue this.
  483.  
  484.   The method used by the dialer is to drop DTR.  Unfortunately this
  485.   requires that the modem pay attention to the DTR signal, and modems
  486.   can be configured to ignore it.  On many modems the default setting
  487.   is to obey DTR (and hangup when it drops); on other modems &D2 should
  488.   be included in the init. string.
  489.  
  490.   Some modems may not recognize the change in the DTR signal.  This
  491.   can be controlled by the setting of S25, on at least most modems.
  492.   If &D2 by itself is insufficient to provoke hangup, add S25=5 to
  493.   your modem initialization string.
  494.  
  495.  
  496.