home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional Developers Kit 1992 November / Disc01 / Disc01.mdf / install / tcp.dsc < prev    next >
Encoding:
Text File  |  1992-10-31  |  41.1 KB  |  1,083 lines

  1.  
  2.                                    IBM TRANSMISSION CONTROL PROTOCOL/
  3.                             INTERNET PROTOCOL VERSION 1.2.1 FOR OS/2:
  4.                                                          README FIRST
  5.  
  6.  
  7.  
  8.   CONTENTS
  9.   ________
  10.  
  11.   CHAPTER 1.  WHY README FIRST
  12.  
  13.   CHAPTER 2.  TCP/IP LAN ADAPTER AND PROTOCOL SUPPORT (TCPLAPS)
  14.  
  15.   Coexistence with IBM Extended Services V 1.0 and LAN Server V 2.0
  16.   Installing TCPLAPS When Both ES and LS are Installed
  17.   Installing TCPLAPS and LS on Your Workstation
  18.   Installing TCPLAPS and ES on Your Workstation
  19.   IBM PC Network(*) Adapters
  20.  
  21.   CHAPTER 3.  PRODUCT IMPLEMENTATION NOTES
  22.  
  23.   General Product Notes
  24.   BASE KIT
  25.   NFS(**) KIT
  26.   X WINDOWS(**) SERVER KIT
  27.   PROGRAMMER'S TOOLKIT
  28.   SOURCE KIT
  29. ***********************************************************************
  30.  
  31.   LICENSE INFORMATION
  32.   ___________________
  33.  
  34.   The licensed program described in this document and all licensed
  35.   material available for it are provided by IBM under terms of the
  36.   Agreement for IBM Licensed Programs.
  37.  
  38.   Any reference to an IBM licensed program in this document is not
  39.   intended to state or imply that only IBM's program may be used.
  40.  
  41.   IBM may have patents or pending patent applications covering
  42.   subject matter described in this document.  The furnishing of this
  43.   document does not give you any license to these patents.  You can
  44.   send inquiries, in writing, to the IBM Director of Commercial
  45.   Relations, International Business Machines Corporation, Purchase,
  46.   New York, 10577.
  47.  
  48.   References in this publication to IBM products, programs, or ser-
  49.   vices do not imply that IBM intends to make them available in all
  50.   countries in which IBM operates.
  51.  
  52.   This document is not intended for production use and is furnished
  53.   as is without any warranty of any kind, and all warranties are
  54.   hereby disclaimed including the warranties of merchantability and
  55.   fitness for a particular purpose.
  56.  
  57.  
  58.   TRADEMARKS
  59.   __________
  60.  
  61.   The following terms, denoted by an asterisk (*) at their first
  62.   occurrences in this publication, are trademarks of IBM Corporation
  63.   in the United States or other countries:
  64.  
  65.   +---------------------+---------------------+---------------------+
  66.   | IBM                 | AIX                 | Operating System/2  |
  67.   +---------------------+---------------------+---------------------+
  68.   | PC Network          | OS/2                | Presentation        |
  69.   |                     |                     | Manager             |
  70.   +---------------------+---------------------+---------------------+
  71.   | PS/2                | Extended Services   | RISC System/6000    |
  72.   +---------------------+---------------------+---------------------+
  73.   | BookManager Read/2  |                     |                     |
  74.   +---------------------+---------------------+---------------------+
  75.  
  76.   The following terms, denoted by a double asterisk (**) at their
  77.   first occurrences in this publication, are trademarks of other
  78.   companies:
  79.  
  80.   TRADEMARK                      OWNED BY
  81.   Hayes                         Hayes Microcomputer Products, Inc.
  82.   Microcom                      Microcom, Inc.
  83.   Microsoft                     Microsoft Corporation
  84.   NDIS                          3Com Corporation/Microsoft Corp.
  85.   Network File System           Sun Microsystems, Inc.
  86.   NFS                           Sun Microsystems, Inc.
  87.   VT100                         Digital Equipment Corporation
  88.   VT200                         Digital Equipment Corporation
  89.   X Window System               Massachusetts Inst. of Technology.
  90.  
  91. ************************************************************************
  92.  
  93.   CHAPTER 1.  WHY README FIRST
  94.   ____________________________
  95.  
  96.  
  97.   This document contains important information about the IBM(*)
  98.   TCP/IP V1.2.1 for OS/2 product.  You should familiarize yourself
  99.   with the contents of this document before attempting to install and
  100.   use this product.
  101.  
  102.   Information provided in this document includes:
  103.  
  104.   o   How to use the TCPLAPS program to successfully install and con-
  105.       figure the IBM LAN Adapter and Protocol Support for your LAN
  106.       environment
  107.  
  108.   o   Implementation notes about specific product features.
  109.  
  110.   An ASCII text version of this document named READ.ME may be found
  111.   in the \DOC subdirectory under the base directory which you
  112.   selected.  The default directory structure is TCPIP\DOC.
  113.  
  114. ************************************************************************
  115.  
  116.   CHAPTER 2.  TCP/IP LAN ADAPTER AND PROTOCOL SUPPORT (TCPLAPS)
  117.   _____________________________________________________________
  118.  
  119.  
  120.   COEXISTENCE WITH IBM EXTENDED SERVICES V 1.0 AND LAN SERVER V 2.0
  121.   _________________________________________________________________
  122.  
  123.   All references to TCPLAPS refer to the LAN Adapter and Protocol
  124.   Support (LAPS) program provided with IBM TCP/IP Version 1.2.1 for
  125.   OS/2(*).
  126.  
  127.   TCPLAPS is a Presentation Manager(*) based utility which allows you
  128.   to install and configure your system to run the NDIS(**) (Network
  129.   Driver Interface Specification) version of TCP/IP for OS/2. TCPLAPS
  130.   is used to associate the IBM TCP/IP protocol with one or more
  131.   network adapters.
  132.  
  133.   All references to ES refer to IBM Extended Services(*) for OS/2
  134.   Version 1.0. All references to LS refer to IBM Local Area Network
  135.   Server Version 2.0
  136.  
  137.   This chapter is provided to help you install both TCPLAPS and other
  138.   IBM NDIS based products, specifically ES and LS.
  139.  
  140.  
  141.   INSTALLING TCPLAPS WHEN BOTH ES AND LS ARE INSTALLED
  142.   ____________________________________________________
  143.  
  144.   If your system has both ES and LS currently installed, please refer
  145.   to the section "INSTALLING TCPLAPS WHEN ES IS INSTALLED" and follow
  146.   the steps listed.
  147.  
  148.  
  149.   INSTALLING TCPLAPS AND LS ON YOUR WORKSTATION
  150.   _____________________________________________
  151.  
  152.   This section is provided to help you install both LAN Services (LS)
  153.   Version 2.0 and Transmission Control Protocol/Internet Protocol
  154.   (TCP/IP) Version 1.2.1 LAN Adapter and Protocol Support (TCPLAPS),
  155.   together on your workstation.
  156.  
  157.   There are two installation scenarios:
  158.  
  159.   1.  Installing LS after TCP/IP has already been installed.
  160.  
  161.   2.  Installing TCP/IP after LS has already been installed.
  162.  
  163.   NOTE:  If you want to install Extended Services (ES) after having
  164.   installed LS and TCP/IP, follow the directions in the IBM Extended
  165.   Services for OS/2 Workstation Installation Guide.
  166.  
  167.   INSTALLING LS AFTER TCPLAPS HAS BEEN INSTALLED AND CONFIGURED
  168.  
  169.   At this point, you should have already installed TCP/IP and
  170.   TCPLAPS.  You should also have used TCPLAPS to configure your work-
  171.   station adapters. If you have not installed TCP/IP, please do so
  172.   now; refer to the TCP/IP Version 1.2.1 for OS/2 Installation and
  173.   Maintenance Guide.  If you have not installed and configured
  174.   TCPLAPS, please do so now; refer to the IBM Transmission Control
  175.   Protocol/Internet Protocol Version 1.2.1 for OS/2: LAN Adapter and
  176.   Protocol Support Introduction and Configuration Guide.
  177.   After TCP/IP and TCPLAPS have been installed and configured, do the
  178.   following before installing LS:
  179.  
  180.   o   Rename the file IBMLVL.INI, which is located on the root direc-
  181.       tory of your boot drive.  For example, if your boot drive is
  182.       the C drive, and you are going to rename the IBMLVL.INI file to
  183.       IBMLVL.TCP, type the following at the C prompt:
  184.  
  185.       RENAME IBMLVL.INI IBMLVL.TCP
  186.  
  187.   You are now ready to begin your installation of LS.  For
  188.   instructions on installing LS, refer to the IBM Operating System/2
  189.   Local Area Network Server Version 2.0 Network Administrator Refer-
  190.   ence Volume 1:  Planning and Installation manual.
  191.  
  192.   Continue installing LS and when you get to the LS "Configure Work-
  193.   station" window, choose to associate the NETBIOS protocol with the
  194.   network adapter you intend to use for LS.  This adapter can be the
  195.   same one that is currently being used for TCP/IP. In this case you
  196.   will have two protocols associated with the same network adapter.
  197.   Continue the installation of LS as stated in the LS Planning and
  198.   Installation manual.
  199.  
  200.   INSTALLING TCPLAPS AFTER LS HAS BEEN INSTALLED
  201.  
  202.   At this time, LS should be installed on your machine.  If it is
  203.   not, refer to the IBM Operating System/2 Local Area Network Server
  204.   Version 2.0 Network Administrator Reference Volume 1: Planning and
  205.   Installation manual to install LS.
  206.  
  207.   There are two ways in which you can configure network adapters for
  208.   TCP/IP. You can use:
  209.  
  210.   1.  TCPLAPS
  211.  
  212.   2.  The LAN Adapter and Protocol Support available with LS
  213.  
  214.  
  215.   Configuring network adapters for TCP/IP using LS
  216.  
  217.   To configure TCP/IP network adapters using LS, do the following:
  218.  
  219.   1.  Install TCP/IP.  Refer to the TCP/IP Version 1.2.1 for OS/2
  220.       Installation and Maintenance manual for information.
  221.  
  222.   2.  Copy the three files IFNDIS.SYS, INET.SYS, and TCPIP.NIF from
  223.       the BIN sub-directory to the IBMCOM\PROTOCOL directory.  The
  224.       \BIN sub-directory is located on the drive and path which you
  225.       entered in ICAT for "Base directory for the installation".
  226.  
  227.   3.  Refer to the IBM Operating System/2 Local Area Network Server
  228.       Version 2.0 Network Administrator Reference Volume 1:  Planning
  229.       and Installation manual to reconfigure your system.  When
  230.       reconfiguring, you should select to associate TCP/IP as a pro-
  231.       tocol with the network adapter that you intend to use for
  232.       TCP/IP.  This adapter can be the same as the one being used for
  233.       LS.  In this case, you will have two protocols associated with
  234.       the same adapter.
  235.  
  236.  
  237.   Configuring network adapters for TCP/IP using TCPLAPS
  238.  
  239.   To configure TCP/IP network adapters using TCPLAPS, perform the
  240.   following steps after you have installed LS:
  241.  
  242.   1.  Install TCP/IP.  Refer to the TCP/IP Version 1.2.1 for OS/2
  243.       Installation and Maintenance Guide for information.
  244.  
  245.   2.  Install TCPLAPS
  246.  
  247.       a.  Insert the TCPLAPS diskette and invoke LAPS. If, for
  248.           example, the TCPLAPS diskette is in your A drive, enter the
  249.           following at the command prompt:
  250.  
  251.           A:LAPS
  252.  
  253.       b.  In the TCPLAPS Main Menu, select the INSTALL button.
  254.  
  255.       c.  In the "Installation" window select the "LAN Adapter Pro-
  256.           tocol Support" button.  Then select the CONTINUE button.
  257.  
  258.       d.  A message will pop up telling you that an earlier version
  259.           of LAPS is installed.  You will then be asked if you would
  260.           like to upgrade.  Select YES.
  261.  
  262.       e.  In the "Source Path" window, select OK.
  263.  
  264.           NOTE:  If the progress indicator on the screen does not
  265.           begin to move, close the window and remove the TCPLAPS
  266.           diskette.  To close the window, double click on the upper
  267.           left hand corner.  You should then shut down and reboot
  268.           your workstation.  After rebooting, repeat the installation
  269.           of TCPLAPS beginning with step 2a.
  270.  
  271.       f.  You will be prompted when the installation is complete.
  272.           Select OK to go to the Main Menu window.
  273.  
  274.   3.  Perform the following steps to configure TCPLAPS:
  275.  
  276.       a.  Select the CONFIGURE button from the Main Menu window.
  277.  
  278.       b.  In the "Configure Workstation" window, look at the "Current
  279.           Configuration" list to see if the network adapter that you
  280.           intend to use is there.  If it is, continue to the next
  281.           step.  If it is not then select the appropriate network
  282.           adapter from the "Network Adapters" list.  After selecting
  283.           the appropriate network adapter, select the ADD button.
  284.  
  285.       c.  Select the network adapter (in the current configuration
  286.           list) which TCP/IP will be using.
  287.  
  288.           This can be the same network adapter that you use for LS.
  289.  
  290.       d.  Select IBM TCP/IP from the Protocols list.
  291.  
  292.       e.  Select the ADD button below the Protocols list.  IBM TCP/IP
  293.           will appear in the Current Configuration list, under the
  294.           network adapter you selected.
  295.  
  296.       f.  Select OK.
  297.  
  298.       g.  Select EXIT from the Main Menu window.
  299.  
  300.           NOTE:  TPCLAPS only configures TCP/IP.  If you want to con-
  301.           figure LS, refer to the IBM Operating System/2 Local Area
  302.           Network Server Version 2.0 Network Administrator Reference
  303.           Volume 1: Planning and Installation manual.
  304.  
  305.   4.  Shut down and reboot your workstation so that all changes to
  306.       your CONFIG.SYS will be in effect.
  307.  
  308.  
  309.   INSTALLING TCPLAPS AND ES ON YOUR WORKSTATION
  310.   _____________________________________________
  311.  
  312.   This section is provided to help you install both IBM Extended Ser-
  313.   vices (ES) Version 1.0 and IBM Transmission Control
  314.   Protocol/Internet Protocol (TCP/IP) Version 1.2.1 for OS/2 together
  315.   on your workstation.
  316.  
  317.   There are two possible installation scenerios:
  318.  
  319.   1.  Installing ES after TCP/IP has already been installed.
  320.  
  321.   2.  Installing TCP/IP after ES has already been installed.
  322.  
  323.   NOTES:
  324.  
  325.   1.  To install LAN Services (LS) after having installed ES and
  326.       TCP/IP, follow the directions in the IBM Operating System/2
  327.       Local Area Network Server Version 2.0 Network Administrator
  328.       Reference Volume 1: Planning and Installation manual.
  329.  
  330.   2.  To install TCP/IP after installing LS and ES, refer to the
  331.       section "Installing TCP/IP After ES" and follow the steps
  332.       listed.
  333.  
  334.  
  335.   INSTALLING ES AFTER TCPLAPS
  336.  
  337.   At this point you should have already installed TCP/IP and TCPLAPS.
  338.   You should also have used TCPLAPS to configure your workstation
  339.   adapters. If you have not installed TCP/IP, please do so now; refer
  340.   to the TCP/IP Version 1.2.1 for OS/2 Installation and Maintenance
  341.   Guide.  If you have not installed and configured TCPLAPS, please do
  342.   so now; refer to the IBM Transmission Control Protocol/Internet
  343.   Protocol Version 1.2.1 for OS/2: LAN Adapter and Protocol Support
  344.   Introduction and Configuration Guide.
  345.  
  346.   After TCP/IP and TCPLAPS have been installed and configured, do the
  347.   following before installing ES:
  348.  
  349.   1.  Delete the following DEVICE and RUN lines in your CONFIG.SYS:
  350.       (this example assumes C: is your boot drive)
  351.  
  352.       o   DEVICE=C:\IBMCOM\LANMSGDD.OS2 /I:C:\IBMCOM
  353.  
  354.       o   RUN=C:\IBMCOM\PROTOCOL\NETBIND.EXE
  355.  
  356.       o   RUN=C:\IBMCOM\LANMSGEX.EXE
  357.  
  358.   2.  If you have a STARTUP.CMD file on the boot drive, rename it.
  359.       For example, enter the following at the OS/2 command prompt:
  360.  
  361.       RENAME STARTUP.CMD STARTUP.TCP
  362.  
  363.   3.  Shut down and reboot your workstation.
  364.  
  365.   4.  Delete the IBMCOM directory, including all files and sub-
  366.       directories in it.
  367.  
  368.       NOTE:  This can be done one of three ways:
  369.  
  370.       a.  Manually, using the DELETE and RMDIR commands
  371.  
  372.       b.  Using the File Manager on OS/2 1.3
  373.  
  374.       c.  Using the Drive icon in the OS/2 System Icon menu for OS/2
  375.           2.0
  376.  
  377.       If you are unable to delete a file in the IBMCOM directory, it
  378.       is because the file is currently being used, and you need to
  379.       delete a DEVICE or RUN line in the CONFIG.SYS.  Return to your
  380.       CONFIG.SYS and look for a DEVICE line or a RUN line that has
  381.       IBMCOM in it.  When you find one, delete that line and then
  382.       shut down and reboot your machine.
  383.  
  384.   You are now ready to install ES.  Refer to the IBM Extended Ser-
  385.   vices for OS/2 Workstation Installation Guide for information.
  386.   After installing ES perform the following steps:
  387.  
  388.   1.  Install TCPLAPS
  389.  
  390.       a.  Insert the TCPLAPS diskette and invoke LAPS. If, for
  391.           example, the TCPLAPS diskette is in your A drive, enter the
  392.           following at the command prompt:
  393.  
  394.           A:LAPS
  395.  
  396.       b.  In the TCPLAPS Main Menu, select the INSTALL button.
  397.  
  398.       c.  In the "Installation" window select the "LAN Adapter Pro-
  399.           tocol Support" button.  Then select the CONTINUE button.
  400.  
  401.       d.  A message will pop up telling you that an earlier version
  402.           of LAPS is installed.  You will then be asked if you would
  403.           like to upgrade.  Select YES.
  404.  
  405.       e.  In the "Source Path" window, select OK.
  406.  
  407.           NOTE:  If the progress indicator on the screen does not
  408.           begin to move, close the window and remove the TCPLAPS
  409.           diskette.  To close the window, double click on the upper
  410.           left hand corner.  You should then shut down and reboot
  411.           your workstation.  After rebooting, repeat the installation
  412.           of TCPLAPS beginning with step 1a.
  413.  
  414.       f.  You will be prompted when the installation is complete.
  415.           Select OK to go to the Main Menu window.
  416.  
  417.   2.  Perform the following steps to configure TCPLAPS:
  418.  
  419.       a.  Select the CONFIGURE button from the Main Menu window.
  420.  
  421.       b.  In the "Configure Workstation" window, look at the "Current
  422.           Configuration" list to see if the network adapter that you
  423.           intend to use is there.  If it is, continue to the next
  424.           step.  If it is not then select the appropriate network
  425.           adapter from the "Network Adapters" list.  After selecting
  426.           the appropriate network adapter, select the ADD button.
  427.  
  428.       c.  Select the network adapter (in the current configuration
  429.           list) which TCP/IP will be using.
  430.  
  431.           This can be the same network adapter that you use for ES.
  432.  
  433.       d.  Select IBM TCP/IP from the Protocols list.
  434.  
  435.       e.  Select the ADD button below the Protocols list.  IBM TCP/IP
  436.           will appear in the Current Configuration list, under the
  437.           network adapter you selected.
  438.  
  439.       f.  Select OK.
  440.  
  441.       g.  Select EXIT from the Main Menu window.
  442.  
  443.           NOTE:  TCPLAPS only configures TCP/IP.  If you want to con-
  444.           figure ES, refer to the IBM Extended Services for OS/2
  445.           Workstation Installation Guide.
  446.  
  447.   3.  If you renamed a STARTUP.CMD file, change the file name back to
  448.       STARTUP.CMD.  Using the previous example, enter the following
  449.       at the OS/2 command prompt:
  450.  
  451.       RENAME STARTUP.TCP STARTUP.CMD
  452.  
  453.   4.  Shut down and reboot your workstation so that all changes to
  454.       your CONFIG.SYS will be in effect.
  455.  
  456.  
  457.   INSTALLING TCPLAPS AFTER ES HAS BEEN INSTALLED
  458.  
  459.   At this time, ES should be installed on your machine.  If it is
  460.   not, refer to IBM Extended Services for OS/2 Workstation Installa-
  461.   tion Guide for installation information.  Perform the following
  462.   steps after you have installed ES:
  463.  
  464.   1.  Install TCP/IP.  Refer to the TCP/IP Version 1.2.1 for OS/2
  465.       Installation and Maintenance Guide for information.
  466.  
  467.   2.  Install TCPLAPS
  468.  
  469.       a.  Insert the TCPLAPS diskette and invoke LAPS. If, for
  470.           example, the TCPLAPS diskette is in your A drive, enter the
  471.           following at the command prompt:
  472.  
  473.           A:LAPS
  474.  
  475.       b.  In the TCPLAPS Main Menu, select the INSTALL button.
  476.  
  477.       c.  In the "Installation" window, select the "LAN Adapter Pro-
  478.           tocol Support" button.  Then select the CONTINUE button.
  479.  
  480.       d.  A message will pop up telling you that an earlier version
  481.           of LAPS is installed.  You will then be asked if you would
  482.           like to upgrade.  Select YES.
  483.  
  484.       e.  In the "Source Path" window, select OK.
  485.  
  486.           NOTE:  If the progress indicator on the screen does not
  487.           begin to move, close the window and remove the TCPLAPS
  488.           diskette.  You should then shut down and reboot your work-
  489.           station.  After rebooting, repeat the installation of
  490.           TCPLAPS beginning with step 2a.
  491.  
  492.       f.  You will be prompted when the installation is complete.
  493.           Select OK to go to the Main Menu window.
  494.  
  495.   3.  Perform the following steps to configure TCPLAPS:
  496.  
  497.       a.  Select the CONFIGURE button from the Main Menu window.
  498.  
  499.       b.  In the "Configure Workstation" window, look at the "Current
  500.           Configuration" list to see if the network adapter that you
  501.           intend to use is there.  If it is, continue to the next
  502.           step.  If it is not then select the appropriate network
  503.           adapter from the "Network Adapters" list.  After selecting
  504.           the appropriate network adapter, select the ADD button.
  505.  
  506.       c.  Select the network adapter (in the current configuration
  507.           list) which TCP/IP will be using.
  508.  
  509.           This can be the same network adapter that you use for LS.
  510.  
  511.       d.  Select IBM TCP/IP from the Protocols list.
  512.  
  513.       e.  Select the ADD button below the Protocols list.  IBM TCP/IP
  514.           will appear in the Current Configuration list, under the
  515.           network adapter you selected.
  516.  
  517.       f.  Select OK.
  518.  
  519.       g.  Select EXIT from the Main Menu window.
  520.  
  521.           NOTE:  TPCLAPS only configures TCP/IP.  If you want to con-
  522.           figure ES, refer to the IBM Extended Services for OS/2
  523.           Workstation Installation Guide.
  524.  
  525.   4.  Shut down and reboot your workstation so that all changes to
  526.       your CONFIG.SYS will be in effect.
  527.  
  528.  
  529.   IBM PC NETWORK(*) ADAPTERS
  530.   __________________________
  531.  
  532.   The following section provides important information concerning IBM
  533.   PC Network Adapters when you have installed TCPLAPS along with ES
  534.   and/or LS on the same machine.  The IBM PC Network Adapters are:
  535.  
  536.   o   IBM PC Network II and Baseband Adapters
  537.  
  538.   o   IBM PC Network II/A and Baseband/A Adapters
  539.  
  540.   Please read this section if you are using any of the IBM PC Network
  541.   adapters and any of the following scenarios apply to your setup:
  542.  
  543.   o   You installed LS after TCPLAPS was installed.
  544.  
  545.   o   You want to make network adapter changes using the LAN Adapter
  546.       and Protocol Support facilities of ES or LS.
  547.  
  548.   In the above situations, when using TCPLAPS to configure the IBM PC
  549.   Network Adapters, the necessary device driver statements will not
  550.   be added to your CONFIG.SYS for these adapters.
  551.  
  552.   The reason for this is a difference between the Network Information
  553.   Files (.NIF) used by TCPLAPS and ES/LS.  To ensure that your IBM PC
  554.   Network adapters will be properly configured by TCPLAPS do the
  555.   following:
  556.  
  557.   IF YOU ARE USING THE IBM PC NETWORK II AND BASEBAND ADAPTERS
  558.   ____________________________________________________________
  559.  
  560.   Using an editor, look at the file IBMNET.NIF.  This file is located
  561.   on your boot drive in the \IBMCOM\MACS subdirectory.  For example,
  562.   using the OS/2 editor, and assuming your boot drive is C:, you
  563.   would enter:
  564.  
  565.   E C:\IBMCOM\MACS\IBMNET.NIF
  566.  
  567.   Look at the file and find the line [ADAPTER].  Look at the fifth
  568.   line below this, and if it has RANGE = 0-1, delete the entire line
  569.   RANGE = 0-1.  If your IBMNET.NIF file does NOT contain this "range
  570.   = " line (as shown below), your adapter will be properly configured
  571.   by TCPLAPS, and NO modifications are needed.
  572.  
  573.   Here is what the IBMNET.NIF file will contain BEFORE your modifica-
  574.   tions :
  575.  
  576.  
  577.     [ADAPTER]
  578.     display = "Adapter mode"
  579.     type = decimal
  580.     default = "0"
  581.     set = "0", "1"
  582.     RANGE = 0-1     <-----  DELETE THIS LINE
  583.     optional = yes
  584.     editable = yes
  585.     virtual = no
  586.     help = "This parameter identifies the network adapter card assignment
  587.      if more than one IBM PC Network adapter card resides in the
  588.      workstation.  Set this parameter to a 0 to denote the primary network
  589.      adapter card and a 1 to denote the alternate network adapter card."
  590.  
  591.   Here is what the IBMNET.NIF file will contain AFTER your modifica-
  592.   tions :
  593.  
  594.     [ADAPTER]
  595.     display = "Adapter mode"
  596.     type = decimal
  597.     default = "0"
  598.     set = "0", "1"
  599.     optional = yes
  600.     editable = yes
  601.     virtual = no
  602.     help = "This parameter identifies the network adapter card assignment
  603.      if more than one IBM PC Network adapter card resides in the
  604.      workstation.  Set this parameter to a 0 to denote the primary network
  605.      adapter card and a 1 to denote the alternate network adapter card."
  606.  
  607.   IF YOU ARE USING THE IBM PC NETWORK II/A AND BASEBAND/A ADAPTERS
  608.   ________________________________________________________________
  609.  
  610.   Using an editor, look at the file IBMNETA.NIF.  This file is
  611.   located on your boot drive in the \IBMCOM\MACS subdirectory.  For
  612.   example, using the OS/2 editor, and assuming your boot drive is C:,
  613.   you would enter:
  614.  
  615.   E C:\IBMCOM\MACS\IBMNETA.NIF
  616.  
  617.   Look at the file and find the line [ADAPTER] Look at the fifth line
  618.   below this, and if it has RANGE = 0-1, delete the entire line RANGE
  619.   = 0-1.  If your IBMNETA.NIF file does NOT contain this "range = "
  620.   line (as shown below), your adapter will be properly configured by
  621.   TCPLAPS, and NO modifications are needed.
  622.  
  623.   Here is what the IBMNETA.NIF file will contain BEFORE your modifi-
  624.   cations :
  625.  
  626.     [ADAPTER]
  627.     display = "Adapter mode"
  628.     type = decimal
  629.     default = "0"
  630.     set = "0","1"
  631.     RANGE = 0-1     <-----  DELETE THIS LINE
  632.     optional = yes
  633.     editable = yes
  634.     virtual = no
  635.     help = "This parameter identifies the network adapter card assignment
  636.      if more than one IBM PC Network adapter card resides in the
  637.      workstation.  Set this parameter to a 0 to denote the primary network
  638.      adapter card and a 1 to denote the alternate network adapter card."
  639.  
  640.   Here is what the IBMNETA.NIF file will contain AFTER your modifica-
  641.   tions :
  642.  
  643.     [ADAPTER]
  644.     display = "Adapter mode"
  645.     type = decimal
  646.     default = "0"
  647.     set = "0","1"
  648.     optional = yes
  649.     editable = yes
  650.     virtual = no
  651.     help = "This parameter identifies the network adapter card assignment
  652.      if more than one IBM PC Network adapter card resides in the
  653.      workstation.  Set this parameter to a 0 to denote the primary network
  654.      adapter card and a 1 to denote the alternate network adapter card."
  655.  
  656. *************************************************************************
  657.  
  658.   CHAPTER 3.  PRODUCT IMPLEMENTATION NOTES
  659.   ________________________________________
  660.  
  661.   GENERAL PRODUCT NOTES
  662.   _____________________
  663.  
  664.  
  665.   FILES ON THE PRODUCT DISKETTES ARE IN PACKED FORMAT
  666.  
  667.   The files on the product diskettes are in packed format.  The
  668.   installation and configuration program (ICAT.EXE) will unpack them
  669.   and copy them to your hard disk drive.  The files have the same
  670.   file name on the diskettes before they are unpacked as they have
  671.   after they are unpacked on your hard disk drive. Do NOT use the
  672.   OS/2 "COPY" command to transfer files from diskettes to your hard
  673.   disk drive.  Use the ICAT program to install all features and files
  674.   of the TCP/IP for OS/2 product.
  675.  
  676.  
  677.   PUBLICATIONS PROVIDED IN BOOKMANAGER READ/2(*) FORMAT
  678.  
  679.   The publications for TCP/IP V1.2.1 for OS/2 are provided in
  680.   BookManager Read/2 format on publications diskettes.  The Base Kit
  681.   has one publications diskette, which contains the following product
  682.   publications:
  683.  
  684.          BASE KIT
  685.  
  686.          File Name   Publication Title
  687.          -------     ------------------------------------------
  688.          EALH2101    IBM TCP/IP Version 1.2.1 for OS/2:
  689.                      Installation and Maintenance
  690.  
  691.          EALA2101    IBM TCP/IP Version 1.2.1 for OS/2:
  692.                      User's Guide
  693.  
  694.          EALS3101    IBM TCP/IP Version 1.2.1 for OS/2:
  695.                      Quick Reference Guide
  696.  
  697.          EALA5001    IBM TCP/IP Version 1.2.1 for OS/2:
  698.                      LAN Adapter and Protocol Support
  699.                      Introduction and Configuration Guide
  700.  
  701.   The Programmer's Toolkit has one publications diskette, which con-
  702.   tains the Programmer's Reference.
  703.  
  704.          PROGRAMMER'S TOOLKIT
  705.  
  706.          File Name   Publication Title
  707.          -------     ------------------------------------------
  708.          EALP4101    IBM TCP/IP Version 1.2.1 for OS/2:
  709.                      Programmer's Reference
  710.  
  711.  
  712.   See the README file on each publications diskette for additional
  713.   information regarding file size and instructions for unpacking the
  714.   files onto your disk drive.  Also included in the README is the IBM
  715.   softcopy agreement.
  716.  
  717.  
  718.   TCP/IP DEVICE DRIVERS REQUIRE 80K BYTES LOW ORDER MEMORY
  719.  
  720.   For OS/2 V1.3 systems only, the TCP/IP device drivers require 80K
  721.   bytes of low order memory, which is shared with the DOS full-screen
  722.   session (when present).   The effect of this is that the memory
  723.   available to DOS programs running in the DOS Box is effectively
  724.   reduced by 80K bytes when TCP/IP is running.  This does not include
  725.   memory required for NDIS-related drivers which are needed for all
  726.   NDIS-based IBM products.
  727.  
  728.  
  729.   BASE KIT
  730.   ________
  731.  
  732.  
  733.   LPRMON
  734.  
  735.   In OS/2 2.0 environments only, when using LPRMON to redirect output
  736.   to an AIX(*) RISC System/6000(*) host using the TYPE command, the
  737.   output is sent from the OS/2 machine and received by the RISC
  738.   System/6000, but does not print.  The output is stored in
  739.   /usr/spool/lpd.
  740.  
  741.  
  742.   PMANT
  743.  
  744.   The default key mapping for the PA2 function is the Print Screen
  745.   key on OS/2 2.0.  The default OS/2 2.0 configuration is to use the
  746.   Print Screen key to print the current window.  This overrides the
  747.   PA2 function in PMANT.
  748.  
  749.   To get access to the PA2 function within PMANT, you can either:
  750.  
  751.   1.  Redefine another key in PMANT to provide the PA2 function.
  752.       Refer to the PMANT section of the User's Guide for details on
  753.       how to remap the keyboard.
  754.  
  755.   2.  Disable the Print Screen function in OS/2 2.0.  Refer to the
  756.       OS/2 2.0 online help for details.
  757.  
  758.  
  759.   TCPIP\SAMPLES DIRECTORY
  760.  
  761.   The following is a list of "sample" programs (i.e., provided "as
  762.   is") which are located in the \SAMPLES subdirectory under the base
  763.   directory which you selected.  The default directory structure is
  764.   TCPIP\SAMPLES.  Any documentation available for these programs is
  765.   found in the respective subdirectories.
  766.  
  767.  
  768.   Some of the sample programs included are:
  769.  
  770.   NSTAT.EXE                An OS/2 Presentation Manager (PM) applica-
  771.                            tion for NETSTAT functions
  772.  
  773.   RN.EXE                   A ReadNews client
  774.  
  775.   NAMED.EXE                Domain Name Server
  776.  
  777.   TRACERTE.EXE             Trace Route
  778.  
  779.   RCOPY.EXE                Remote Copy command (via AIX)
  780.  
  781.  
  782.   SENDMAIL
  783.  
  784.   A new parameter "-t" has been added, which removes recipients from
  785.   the mail body (e.g., To:, Cc:). Also, "NEWFILES" attribute support
  786.   has been added to allow filenames greater than eight alphanumeric
  787.   characters.  Finally, sendmail now filters all control characters
  788.   except tabs, CR, and LF from incoming mail files.
  789.  
  790.  
  791.   SLIP
  792.  
  793.   SLIO and SLIPCALL will work with an analog telephone line and two
  794.   "Hayes(**)-Compatible" modems.  The communications port on the PS/2
  795.   must be set to 8 data bits, no parity, and 1 stop bit.  This is
  796.   true for the local and the remote host.  SLIPCALL -r should do
  797.   this; however, if you are having problems, use the MODE command:
  798.  
  799.        mode com1:9600,n,8,1
  800.  
  801.   The following modem settings apply to the Microcom(**) QX/V.32c
  802.   modems.  This information is provided for informational purposes
  803.   only.
  804.  
  805.   AT Mode Front Panel Configuration Switches
  806.  
  807.     Switch  Position  Function
  808.     ------  --------  --------
  809.        1      Up      Respond to DTR
  810.        2      Down    AT mode (as opposed to Microcom SX mode)
  811.        3      Up      No result codes (ATQ1).  This not the default.
  812.        4      Down    Command Echo off (ATE1).  This is not the default.
  813.        5      Up      Auto-Answer Enabled (S0=1).
  814.        6      Up      Carrier follows remote system.
  815.        7      Up      Long form result codes (ATV1)
  816.        8      Down    Smart Mode (Dumb Mode ignores commands).
  817.        9      Up      Not Used
  818.       10      Up      Asynchronous
  819.       T/D     Out     Alternates between talk and data mode.
  820.       O/A     In      Goes off hook and in answer mode when T/D pressed.
  821.  
  822.  
  823.   AT Mode Rear Panel Configuration Switches
  824.  
  825.     Switch  Position  Function
  826.     ------  --------  --------
  827.        1      Down    Affected by AT&W or AT*W when reset (1 and 2).
  828.        2      Down    Affected by AT&W or AT*W when reset (1 and 2).
  829.        3      Down    Auto-reliable mode (3 and 4).
  830.        4      Up      Auto-reliable mode (3 and 4).
  831.        5      Down    Use extended result codes.
  832.        6      Up      Restore config stored with AT&W or AT*W on reset.
  833.        7      Down    Read switches on Reset.
  834.        8      Down    BPS rate adjust disabled.
  835.  
  836.  
  837.   SNMPD
  838.  
  839.   The format of the SNMPTRAP.DST file in the publications is incom-
  840.   plete.  The file must be terminated with a <carriage return> char-
  841.   acter.  The correct format for the file is:
  842.  
  843.         host_name UDP <carriage return>
  844.  
  845.  
  846.   NFS(**) KIT
  847.   ___________
  848.  
  849.  
  850.   USING NFS CLIENT WITH THE OS/2 2.0 "DRIVES" ICON VIEW
  851.  
  852.   You cannot use the "Drives" icon to look at NFS mounted file
  853.   systems.  Although an icon representing NFS mounted drives appears
  854.   in the Drives-Icon View, double-clicking on the icon does not suc-
  855.   cessfully open the drive window.
  856.  
  857.  
  858.   USING NFS CLIENT WITH OS/2 2.0 "DRAG-AND-DROP" FILES
  859.  
  860.   You cannot drag a file from a local drive icon and drop it on an
  861.   NFS-mounted drive icon.  The result of this action is that an empty
  862.   file (i.e., length=0) with the correct filename is created on the
  863.   target drive.
  864.  
  865.  
  866.   X WINDOWS(**) SERVER KIT
  867.   ________________________
  868.  
  869.   The X Windows Server has been updated in V1.2.1 to include support
  870.   for non-US keyboards and X window "PseudoColor" visual type.  The
  871.   non-US keyboard support is documented in the updated V1.2.1 publi-
  872.   cations.  Refer to the PMX on-line documentation for information
  873.   about the new color features and other X server features which are
  874.   not documented in the updated publications.
  875.  
  876.   To view the on-line documentation, you can either select "PMX
  877.   help..." from the "Help" pull-down of the "PMX Server" window, or
  878.   type "VIEW <tcpip>\HELP\OS2X" from an OS/2 command prompt (where
  879.   <tcpip> is the base directory where TCP/IP for OS/2 is installed).
  880.  
  881.   The remainder of this section describes implementation notes for
  882.   the TCP/IP V1.2.1 for the OS/2 X Windows Server.
  883.  
  884.  
  885.   USING TELNET CLIENTS AND PMX SIMULTANEOUSLY (OS/2 2.0 ONLY)
  886.  
  887.   In certain OS/2 2.0 configurations, we have observed two problems
  888.   which occur only when using Telnet clients (e.g., TN, VT100(**),
  889.   VT220(**), PMANT, TN3270, etc.)  launch X client programs for the
  890.   PMX server.  The problems with the recommended workarounds are
  891.   listed below:
  892.  
  893.   1.  PM window loses keystrokes despite having focus.
  894.  
  895.       This may occur after you close down PMX clients, or PMX itself,
  896.       and change focus to a PM window, especially one containing a
  897.       Telnet client session.  In both cases, you may regain keyboard
  898.       input by switching to another PM window and then returning
  899.       focus to the affected PM window BY CLICKING IN THE CLIENT AREA
  900.       of that window.  Returning focus by clicking on the PM title
  901.       bar of the window will not restore keyboard input.
  902.  
  903.  
  904.   2.  Delays in window and keyboard events.
  905.  
  906.       This may occur after you click on the PM title bar of a PM X
  907.       client window (e.g., to give focus to or drag the window).
  908.       Typically, the window will not actually gain focus, and the
  909.       system performance then appears to degrade.  For example, if
  910.       you try to drag an X window by its PM title bar, the window
  911.       movement may be delayed or you may experience what appears to
  912.       be a temporary system hang.
  913.  
  914.       You can prevent these symptoms from occurring by giving focus
  915.       to X client windows only by FIRST clicking in the client area
  916.       of an X window.  Focus to X client windows will follow the
  917.       cursor movement to other X client windows, and you can then
  918.       safely use the PM title bars on the X client windows.
  919.  
  920.  
  921.   GARBLED PM FONTS
  922.  
  923.   Occasionally, PM becomes garbled and the information in PM windows
  924.   becomes unreadable.  Repeatedly selecting the "Refresh all clients
  925.   (F2)" pull-down from the PMX Server window steadily restores the
  926.   fonts.
  927.  
  928.  
  929.  
  930.   XMODMAP KEYBOARD FILES
  931.  
  932.   If you maintained keyboard definition files to customize your PMX
  933.   keyboard support using XMODMAP, they may no longer work.  Changes
  934.   made to accommodate the new non-US keyboard support necessitated
  935.   changes to PMX which may invalidate some previous XMODMAP keyboard
  936.   mapping definitions.
  937.  
  938.  
  939.   WINDOW MANAGER HINTS
  940.  
  941.   Currently, not all window manager hints are supported.  Those not
  942.   supported are the use of client specified icons, colormap con-
  943.   ventions, and some size conventions, such as "increments" and
  944.   "aspect ratios" of width and height.
  945.  
  946.  
  947.   GRAB IMPLEMENTATION
  948.  
  949.   "Grabs" are not completely supported yet.  While the cursor is
  950.   outside of any X window, no X client has control of focus.  X
  951.   clients do have control if the cursor is inside some X client
  952.   window.  Also no drawing can be done outside of X windows, so no
  953.   client could draw a "rubber band" or "resize rectangle" outside of
  954.   the X windows into the PM environment.  Otherwise X "grab" behavior
  955.   is supported.
  956.  
  957.  
  958.  
  959.   BACKGROUND WINDOW SCROLLING
  960.  
  961.   There is a problem in the initial product version of the OS/2 X
  962.   server, in some circumstances, where a PM window or PM frame of an
  963.   X window is on top of an X window.  If the X window in the back-
  964.   ground is scrolled, pieces of the PM frame or PM window can become
  965.   part of the scrolled data.  This situation is easily corrected by
  966.   refreshing the contents of the X client window; e.g., select
  967.   "refresh all clients" from the PMX Command pull-down menu, or raise
  968.   the background window to the top by clicking on its frame.
  969.  
  970.  
  971.   CURSOR LIMITATIONS
  972.  
  973.   If an X client creates a cursor using bitmaps that are larger than
  974.   32x32, the portion in the lower left corner is used, instead of the
  975.   portion around the "hot spot".  The result may be an incorrect
  976.   appearing cursor.  The user may avoid using cursors created by X
  977.   applications by starting PMX with the -noxcursor parameter.
  978.  
  979.  
  980.   PM DEVICE DRIVERS
  981.  
  982.   Some types of text display or "stippling" are slow on certain PM
  983.   Display Drivers.  We have some command line options that can impact
  984.   this.  As of the shipping of this update, several PM device driver
  985.   limitations exist.
  986.  
  987.   o   Using XGA drivers, some X fonts display incorrectly and some-
  988.       times even garble PM window titles in non-X windows.  A
  989.       workaround to this is to run with PMX with the -xga flag,
  990.       although this slows PMX performance.
  991.  
  992.   o   OS/2 2.0 has some system limits on the number of PM bitmaps
  993.       that can be created.  If you use the -nofbm command line
  994.       option, PMX will not use PM bitmaps to store fonts.   This
  995.       saves PM storage but decreases PMX text speed performance.
  996.       Note that the -xga and -nofbm flags actually do the same thing
  997.       at this point.
  998.  
  999.  
  1000.   PROGRAMMER'S TOOLKIT
  1001.   ____________________
  1002.  
  1003.  
  1004.   NCS CPP
  1005.  
  1006.   The NCS CPP command does not support the #error directive.  The
  1007.   user may need to make the following change in some of the MS C
  1008.   6.00A header files.
  1009.  
  1010.  
  1011.     From:
  1012.            #if defined(_DLL) && !defined(_MT)
  1013.            #error Cannot define_DLL without _MT
  1014.            #endif
  1015.  
  1016.     To:
  1017.            #if defined(_DLL) && !defined(_MT)
  1018.            //#error Cannot define _DLL without _MT
  1019.            #endif
  1020.  
  1021.  
  1022.  
  1023.   SOURCE KIT
  1024.   __________
  1025.  
  1026.  
  1027.   HOW TO BUILD THE TCP/IP V1.2.1 PRODUCT SOURCE CODE
  1028.  
  1029.   If you have purchased the TCP/IP V1.2.1 for OS/2 Source Kit, the
  1030.   TCPBUILD.CMD can be used to build TCP/IP product components from
  1031.   source.   However, before using TCPBUILD, you must edit the proce-
  1032.   dure file and customize the command for your installation.  This
  1033.   section describes the changes that you must make to the
  1034.   TCPBUILD.CMD file before you can use the file.
  1035.  
  1036.   1.  After installing the source code with ICAT, change the current
  1037.       working directory to the TCP/IP source directory (c:\tcpip\src
  1038.       is the default).
  1039.  
  1040.   2.  Edit the file TCPBUILD.CMD to configure the build process for
  1041.       your installation.
  1042.  
  1043.   3.  Review these variables, which are set by the procedure, to
  1044.       ensure their accuracy for your installation.
  1045.  
  1046.       MICROSOFT_COMPILER_BASE       The base directory of MS C 6.00A
  1047.                                     compiler.  (Microsoft(**))
  1048.  
  1049.       TCPIP_SOURCE_BASE             The base directory of TCP/IP
  1050.                                     source
  1051.  
  1052.       TCPIP_INCLUDE_BASE            The base directory of TCP/IP
  1053.                                     include header file.
  1054.  
  1055.       MASM_BIN                      The base directory of the Macro
  1056.                                     Assembler
  1057.  
  1058.       TOOLKIT_BASE                  The base directory of the OS/2
  1059.                                     Programmer's Toolkit
  1060.  
  1061.       OS2_DIR                       The base directory of the OS/2
  1062.                                     libraries
  1063.  
  1064.       TMP                           A directory for temporary files
  1065.  
  1066.   4.  After verifying that the command file accurately reflects your
  1067.       installation, issue the command:
  1068.  
  1069.  
  1070.                TCPBUILD           which will build the entire TCP/IP source code
  1071.             or
  1072.                TCPBUILD  / FTP    which, for example, will build only the
  1073.                                   FTP component from the source code
  1074.  
  1075. Support:
  1076.  
  1077. Support is provided to developers via CompuServe.  CompuServe users 
  1078. should enter 'GO: OS2DEV'.  If you are not a member of CompuServe, 
  1079. please call 1-800-524-3388 and ask for representative #239 for a free 
  1080. introductory membership.  
  1081.  
  1082.  
  1083.