home *** CD-ROM | disk | FTP | other *** search
/ IBM Presents OS/2 Software Hits 1995 / OS-2_SW_HITS_2ND_EDITION_1995.ISO / i17 / dbox20c1.exe / DBOXC1.ZIP / DOC / readme.dbx < prev   
Text File  |  1994-07-19  |  21KB  |  451 lines
  1.  
  2.    TCP/IP 2.0 for OS/2 DOS/Windows Access Kit
  3.  
  4.      This kit includes these APAR fixes from PTF UN50383
  5.      Corrective Service.
  6.  
  7.   --------------------------------------------------------------------
  8.   1.0  Obtaining CSDs
  9.  
  10.  
  11.      You can obtain Corrective Service Diskettes (CSDs) electronically
  12.      by:
  13.  
  14.            o   Using FTP to access SOFTWARE.WATSON.IBM.COM as Anonymous.
  15.  
  16.                NOTE:  Fixes for TCP/IP for OS/2 are located in the
  17.                       pub\tcpip\os2 directory.
  18.  
  19.            o   Establishing a modem connection to the NCSBBS bulletin
  20.                board at 1-919-517-0001.
  21.  
  22.                NOTE:  Set your modem settings to: none,8,1.
  23.  
  24.      The latest CSDs for TCP/IP Version 2.0 for OS/2 are shown in the
  25.      following table:
  26.  
  27.         +---------------------------+---------------------------+
  28.         | KIT NAME                  | PACKAGE NAME              |
  29.         +---------------------------+---------------------------+
  30.         | Applications Kit          | APP20CSD.PKG              |
  31.         +---------------------------+---------------------------+
  32.         | Base Kit                  | TCP20CSD.PKG              |
  33.         +---------------------------+---------------------------+
  34.         | Domain Name Server Kit    | DNS20CSD.PKG              |
  35.         +---------------------------+---------------------------+
  36.         | DOS/Windows Access Kit    | DOS20CSD.PKG              |
  37.         +---------------------------+---------------------------+
  38.         | Extended Networking Kit   | XNT20CSD.PKG              |
  39.         +---------------------------+---------------------------+
  40.         | Network File System Kit   | NFS20CSD.PKG              |
  41.         +---------------------------+---------------------------+
  42.         | Programmer's Tool Kit     | PGM20CSD.PKG              |
  43.         +---------------------------+---------------------------+
  44.         | X Window System Client    | XCL20CSD.PKG              |
  45.         | Kit                       |                           |
  46.         +---------------------------+---------------------------+
  47.         | X Window System Server    | PMX20CSD.PKG              |
  48.         | Kit                       |                           |
  49.         +---------------------------+---------------------------+
  50.  
  51.  
  52.  
  53.         This README file reflects new and changed functions for
  54.         the TCP/IP 2.0 for OS/2: DOS/Windows Access kit, and
  55.         documents changes introduced in the original product
  56.         as well as changes due to Corrective Service Diskette
  57.         (CSD) UN50383.
  58.  
  59.         This file contains information you will need after you install
  60.         the DOS/Windows Access Kit.  It contains a brief description
  61.         of the kit, the software requirements, and information you
  62.         will need to configure and use the kit.
  63.  
  64.         The order of information in this file is:
  65.  
  66.          1. What is the DOS/Windows Access Kit?
  67.          2. Software requirements
  68.          3. What does the DOS/Windows Access Kit support?
  69.          4. The ETC environment variable.
  70.          5. Name resolution
  71.          6. Coexistence with TCP/IP Version 2.1 for DOS
  72.          7. COMTCP
  73.          8. Tracing
  74.  
  75.   1. What is the DOS/Windows Access Kit?
  76.  
  77.  
  78.         The DOS/Windows Access Kit is a virtual device driver and a
  79.         set of TCP/IP Version 2.1 for DOS programs and dynamic link
  80.         libraries.  After you install this kit, you can run selected
  81.         TCP/IP Version 2.1 for DOS applications in an OS/2 V2.1
  82.         Virtual DOS Machine (VDM), including a WINOS2 session.  This
  83.         kit also lets you run DOS and Windows applications written to
  84.         any of the documented TCP/IP Version 2.1 for DOS APIs.
  85.  
  86.  
  87.   2. Software requirements
  88.  
  89.  
  90.         The TCP/IP Version 2.0 for OS/2 DOS/Windows Access Kit
  91.         requires OS/2 V2.1.
  92.  
  93.         If you want to run Windows applications written to any of the
  94.         TCP/IP Version 2.1 for DOS APIs, then you must also install
  95.         the Windows support provided with OS/2 V2.1.
  96.  
  97.  
  98.   3. What does the DOS/Windows Access Kit support?
  99.  
  100.  
  101.      This section describes what is supported by the DOS/Windows
  102.      Access Kit, as well as any restrictions that apply.
  103.  
  104.  
  105.      Supported TCP/IP Version 2.1 for DOS APIs
  106.      -----------------------------------------
  107.  
  108.         The following list shows the TCP/IP Version 2.1 for DOS
  109.         application programming interfaces that are supported by the
  110.         DOS/Windows Access Kit.  Any application written to these
  111.         libraries will run in an OS/2 V2.1 VDM.
  112.  
  113.         Library               Description
  114.         -------               -----------
  115.         SOCKETS.LIB           Real mode small model sockets library
  116.         SOCKETL.LIB           Real mode large model sockets library
  117.         RPCS.LIB              SUN RPC small model library
  118.         RPCL.LIB              SUN RPC large model library
  119.         FTPAPI.LIB            FTP Application Programming Interface
  120.                               library
  121.         WINSOCK.LIB           Windows Sockets API V1.1 library
  122.         WFTPAPI.LIB           Windows FTP Application Programming
  123.                               Interface library
  124.         BIOS int14h           BIOS Interrupt 14 Telnet
  125.                               Redirector (see COMTCP below).
  126.  
  127.         NOTE:  For more information on TCP/IP Version 2.1 for DOS
  128.         application programming interfaces, see "TCP/IP Version 2.1
  129.         for DOS:  Programmer's Reference," SC31-7046.
  130.  
  131.  
  132.      Restrictions
  133.      ------------
  134.  
  135.         Although the DOS/Windows Access Kit supports all of the
  136.         documented TCP/IP Version 2.1 for DOS APIs, there are some
  137.         applications, shipped with TCP/IP Version 2.1 for DOS, that
  138.         are not supported by the DOS/Windows Access Kit because they
  139.         manage the DOS TCP/IP protocol stack (INET).  Because the
  140.         DOS/Windows Access Kit lets you run on the OS/2 TCP/IP stack,
  141.         there is no DOS stack to manage.  The following table lists
  142.         DOS TCP/IP applications that are not supported in a VDM, and
  143.         the corresponding (suggested) OS/2 TCP/IP applications:
  144.  
  145.            DOS              OS/2
  146.         Application      Application     Description
  147.         -----------      -----------     ------------
  148.         ifconfig         ifconfig        Used to manage network interfaces.
  149.         arp              arp             Used to manage ARP table entries.
  150.         netstat          netstat         Used to query internal structures.
  151.         route            route           Used to manage static routes.
  152.         routed           routed          RIP support.
  153.         snmpd            snmpd           SNMP Agent support.
  154.         inet -d <flg>    vdebug <flg>    Internal protocol stack tracing.
  155.  
  156.  
  157.  
  158.   4. The ETC environment variable
  159.  
  160.  
  161.         Both OS/2 and DOS TCP/IP applications use the ETC environment
  162.         variable to find the path to the TCP/IP configuration and name
  163.         resolution files.  The OS/2 TCP/IP installation program
  164.         initializes the ETC variable by creating an entry like this in
  165.         CONFIG.SYS, on the boot drive:
  166.  
  167.            SET ETC=<path>\ETC
  168.  
  169.         The DOS/Windows Access Kit initializes the ETC variable by
  170.         creating an entry like this in in the AUTOEXEC.BAT file on
  171.         your boot drive:
  172.  
  173.            SET ETC=<path>\DOS\ETC
  174.  
  175.         The two different directories are used because some files have
  176.         different formats in OS/2 and DOS systems.
  177.  
  178.         When you install the DOS/Windows Access Kit, the following
  179.         files are stored in the <path>\DOS\ETC directory.
  180.  
  181.         File                  Description
  182.         ----                  -----------
  183.         RESOLV                Domain Name Server name resolution
  184.         HOSTS                 HOSTS file name resolution
  185.         SERVICES              Service name to port number mapping
  186.         PROTOCOL              Protocol name to protocol ID mapping
  187.  
  188.  
  189.  
  190.   5. Name resolution
  191.  
  192.  
  193.         The DOS TCP/IP programming interfaces use name resolution
  194.         files like those used by OS/2 TCP/IP.  These files are:
  195.  
  196.         File                  Description
  197.         ----                  -----------
  198.         RESOLV                Domain Name Server name resolution
  199.         HOSTS                 HOSTS file name resolution
  200.  
  201.         When you install the DOS/Windows Access Kit, the installation
  202.         program sets the ETC environment variable (in the AUTOEXEC.BAT
  203.         file on the boot drive) to the directory that contains the
  204.         name resolution files.  This is usually the <path>\DOS\ETC
  205.         subdirectory.  If you change the ETC path in AUTOEXEC.BAT, or
  206.         if you would like to use a HOSTS file, you must update one or
  207.         both of the RESOLV and HOSTS files pointed to by the ETC path
  208.         in AUTOEXEC.BAT.  In most cases, you can just copy the
  209.         corresponding files from the ETC path specified in CONFIG.SYS
  210.         to the ETC path specified in AUTOEXEC.BAT.
  211.  
  212.         If you do NOT modify the ETC environment variable in
  213.         AUTOEXEC.BAT (to point to a path other than the path set
  214.         during installation), the configuration notebook (TCPIPCFG)
  215.         will update the RESOLV file when you change the configuration
  216.         notebook pages that correspond to the RESOLV file.  The
  217.         configuration program does this by copying the RESOLV file
  218.         from the ETC path specified in CONFIG.SYS to the ETC path
  219.         specified in AUTOEXEC.BAT after it makes any changes.
  220.  
  221.  
  222.   6. Coexistence with TCP/IP Version 2.1 for DOS
  223.  
  224.  
  225.         You can use the DOS/Windows Access Kit to run TCP/IP Version
  226.         2.1 for DOS applications in an OS/2 virtual DOS machine (VDM).
  227.         Because TCP/IP Version 2.1 for DOS does not have a separate
  228.         Applications Kit, and because you don't run the OS/2 TCP/IP
  229.         stack and the DOS TCP/IP stack at the same time, there are
  230.         some considerations when you install and configure DOS TCP/IP
  231.         on an OS/2 machine using the DOS/Windows Access Kit.
  232.  
  233.         1.  The TCP/IP Version 2.0 for OS/2 DOS/Windows Access Kit is
  234.             available after the TCP/IP Version 2.1 for DOS CSD
  235.             2.1.0.3.  If you are installing TCP/IP Version 2.1 for DOS
  236.             (CSD 2.1.0.3 or earlier) and the DOS/Windows Access Kit on
  237.             the same workstation and expect to run TCP/IP Version 2.1
  238.             for DOS applications in an OS/2 VDM, then you must replace
  239.             the following files from TCP/IP Version 2.1 for DOS with
  240.             the corresponding files from the DOS/Windows Access Kit:
  241.  
  242.             Module                Description
  243.             ------                -----------
  244.             WINSOCK.DLL           Windows Sockets API V1.0 and V1.1
  245.                                   support.
  246.  
  247.         2.  When running TCP/IP Version 2.1 for DOS in an OS/2 VDM,
  248.             you do not use the TCP/IP Version 2.1 for DOS stack nor
  249.             any of the DOS TCP/IP network interface support.  Instead
  250.             you use the TCP/IP Version 2.0 for OS/2 stack and its
  251.             interfaces.  For this reason you should not allow CUSTOM
  252.             (the TCP/IP Version 2.1 for DOS configuration program) to
  253.             modify your CONFIG.SYS file.
  254.  
  255.         3.  After installing both the DOS/Windows Access Kit and
  256.             TCP/IP Version 2.1 for DOS, you should modify the
  257.             AUTOEXEC.BAT on the boot drive to set the ETC environment
  258.             variable to the ETC directory that was created when you
  259.             installed TCP/IP Version 2.1 for DOS.
  260.  
  261.  
  262.  
  263.   7. COMTCP
  264.  
  265.  
  266.         The COMTCP command lets you intercept BIOS Serial Port
  267.         Services Interrupt (int 14H) requests and redirect them over a
  268.         Transmission Control Protocol connection.
  269.  
  270.                          ┌─ -c 1────────┐  ┌─ -p 23───────┐
  271.     >>──COMTCP──┬─────┬──┼──────────────┼──┼──────────────┼──────────>
  272.                 └─ -o─┘  └─ -c com_port─┘  └─ -p tcp_port─┘
  273.        ┌─ -t 3───────┐
  274.     >──┼─────────────┼── host── dos_command─────────────────────────><
  275.        └─ -t timeout─┘
  276.  
  277.   COMTCP Help
  278.  
  279.     >>──COMTCP──┬─ -?──┬────────────────────────────────────────────><
  280.                 └─ -??─┘
  281.  
  282.         Parameter       Description
  283.         ---------       -----------
  284.         -o              Instructs   COMTCP   not  to  use  the  TELNET
  285.                         protocol.
  286.  
  287.                         By default, COMTCP uses the TELNET protocol to
  288.                         support initial option  negotiation  with  the
  289.                         host   and   to   quote   the  TELNET  command
  290.                         character.  When the TELNET protocol is turned
  291.                         off, option negotiation is inhibited  and  all
  292.                         bytes  sent  and received are passed by COMTCP
  293.                         without being quoted.   If this  parameter  is
  294.                         omitted, COMTCP uses the TELNET protocol.
  295.  
  296.         -C com_port     Specifies   the   DOS  communication  port  to
  297.                         intercept.  Valid port numbers are  1,  2,  3,
  298.                         and   4,  which  correspond  to  communication
  299.                         devices COM1,  COM2,  COM3,  and  COM4.    The
  300.                         default communication port is 1.
  301.  
  302.         -P tcp_port     Specifies  a  port  (other  than  the  default
  303.                         TELNET port) associated with  the  connection.
  304.                         The default TELNET port is 23.
  305.  
  306.         host            Specifies  the  name  of  the host or internet
  307.                         address of the host with  which  you  want  to
  308.                         establish a TELNET connection.
  309.  
  310.         dos_command     Specifies  the  command  to  be initiated when
  311.                         TCP/IP is connected to the remote  host.    In
  312.                         many   instances   the  dos_command  starts  a
  313.                         terminal emulator.  Enter the  dos_command  as
  314.                         you would from the DOS prompt.
  315.  
  316.         -?              Displays information about the COMTCP command.
  317.  
  318.         -??             Displays detailed information about the COMTCP
  319.                         command.
  320.  
  321.   8. Tracing
  322.  
  323.  
  324.         The  DOS/Windows  Access  Kit  virtual  device driver supports
  325.         tracing.  The following instructions are supplied to help  you
  326.         create  a  trace  so  that  we can better service our product.
  327.         This facility is not intended for general use.    The  tracing
  328.         support  has two possible output destination options.  You can
  329.         route the trace output to an internal 64K buffer or to  a  COM
  330.         port.    If  you want to route the trace output to a COM port,
  331.         add  the /C:n parameter to the "DEVICE=<dbox>\BIN\VDOSTCP.VDD"
  332.         statement that was added to the CONFIG.SYS file, on  the  boot
  333.         drive,  when  you  installed the DOS/Windows Access Kit.  This
  334.         parameter specifies the COM port  to  which  trace  output  is
  335.         sent.  The format of this parameter is:
  336.  
  337.             /C:{1|2}
  338.  
  339.         To  specify  that  trace  output is sent to the COM2 port, you
  340.         would enter the device statement like this:
  341.  
  342.            DEVICE=<dbox>\BIN\VDOSTCP.VDD /C:2
  343.  
  344.  
  345.  
  346.      Tracing with VDEBUG
  347.      -------------------
  348.  
  349.         The DOS/Windows Access Kit contains the VDEBUG trace  program.
  350.         You  can use VDEBUG.EXE to set tracing on and off, and to dump
  351.         the current state of the internal trace buffer (if tracing  to
  352.         the  internal buffer).   The VDEBUG parameters can be either a
  353.         series of flags separated by logical operators:
  354.  
  355.                 &         and
  356.  
  357.                 |         or
  358.  
  359.                 ~         not
  360.  
  361.         or you can specify the -d option to dump  the  internal  trace
  362.         buffer.
  363.  
  364.         Here are the flags and the traces they produce:
  365.  
  366.         Flag                  Trace Description
  367.         ----                  ----- -----------
  368.         Tobuffer              Sends trace output to the internal trace
  369.                               buffer instead of a COM port
  370.         Kentry                Traces TCP/IP Version 2.1 for DOS kernel
  371.                               calls
  372.         Vsocket               Traces calls from the virtual device
  373.                               driver to the TCP/IP Version 2.0 for
  374.                               OS/2 protocol stack
  375.         All                   Turns on all of the trace flags
  376.  
  377.         NOTE:   You  need  specify  only enough characters to uniquely
  378.         identify a flag when passing parameters to VDEBUG.EXE.  In the
  379.         list above, the characters necessary to  uniquely  identify  a
  380.         flag are shown in uppercase.
  381.  
  382.         TRACE EXAMPLES:  The following table shows what is produced by
  383.         various combinations of trace options.
  384.  
  385.         VDEBUG Parameters     Trace Description
  386.         -----------------     -----------------
  387.         all&~tobuffer         Turns on all tracing, and sends the
  388.                               output to the COM port specified on the
  389.                               DEVICE=<dbox>\BIN\VDOSTCP.VDD statement
  390.                               in the CONFIG.SYS.
  391.  
  392.         vsocket|kentry        Traces all calls from an OS/2 VDM to the
  393.                               VDD, and calls from the VDD to the
  394.                               TCP/IP Version 2.0 for OS/2 stack; Sends
  395.                               trace output to the COM port specified
  396.                               in config.sys.
  397.  
  398.         k|t                   Traces all calls from an OS/2 VDM to the
  399.                               VDD.  Sends trace output to the internal
  400.                               buffer where you can view it using the
  401.                               vdebug -d command.
  402.      --------------------------------------------------------------------
  403.       APAR Fixes
  404.  
  405.  
  406.      The following is a list of APARs fixed in CSD UN57546.
  407.  
  408.      +------------+-------------+---------------------------------------+
  409.      | PN45654    | VDOSTCP.VDD | Fixed: DOS BOX COMTCP transmits       |
  410.      |            |             | before checking line status.          |
  411.      +------------+-------------+---------------------------------------+
  412.      | PN46358    | COMTCP.EXE  | Fixed: Customer cannot connect to     |
  413.      |            | WINSOCK.DLL | mail in the DOS box when using SUN    |
  414.      |            |             | Select system.                        |
  415.      +------------+-------------+---------------------------------------+
  416.      | PN46944    | WINSOCK.DLL | Fixed: Customer cannot access INFO    |
  417.      |            | PING.EXE    | application when accessing DOS box.   |
  418.      |            | WPING.EXE   |                                       |
  419.      |            | DSKDBOX.TCP |                                       |
  420.      +------------+-------------+---------------------------------------+
  421.      | PN48210    | PING.EXE    | Fixed: WIN-OS/2 Memory corruption     |
  422.      |            | WPING.EXE   | causing other WIN OS/2 components to  |
  423.      |            | DSKDBOX.TCP | trap.                                 |
  424.      +------------+-------------+---------------------------------------+
  425.      | PN52335    | ASYNCSEL    | Fixed: Cello does not work correctly. |
  426.      +------------+-------------+---------------------------------------+
  427.      | PN53497    | WPING.EXE   | Fixed: WPING that ships with DOS      |
  428.      |            |             | Box Access Kit receives General       |
  429.      |            |             | Protection fault.                     |
  430.      +------------+-------------+---------------------------------------+
  431.  
  432.      The following is a list of APARs fixed in CSD UN50383.
  433.  
  434.      +------------+-------------+---------------------------------------+
  435.      | PN45654    | VDOSTCP.VDD | Fixed: DOS BOX COMTCP transmits       |
  436.      |            |             | before checking line status.          |
  437.      +------------+-------------+---------------------------------------+
  438.      | PN46358    | COMTCP.EXE  | Fixed: Customer cannot connect to     |
  439.      |            | WINSOCK.DLL | mail in the DOS box when using SUN    |
  440.      |            |             | Select system.                        |
  441.      +------------+-------------+---------------------------------------+
  442.      | PN46944    | WINSOCK.DLL | Fixed: Customer cannot access INFO    |
  443.      |            | PING.EXE    | application when accessing DOS box.   |
  444.      |            | WPING.EXE   |                                       |
  445.      |            | DSKDBOX.TCP |                                       |
  446.      +------------+-------------+---------------------------------------+
  447.      | PN48210    | PING.EXE    | Fixed: WIN-OS/2 Memory corruption     |
  448.      |            | WPING.EXE   | causing other WIN OS/2 components to  |
  449.      |            | DSKDBOX.TCP | trap.                                 |
  450.      +------------+-------------+---------------------------------------+
  451.