
     IBM DEVELOPER CONNECTION DEVICE DRIVER KIT FOR OS/2 - Version 2
     ===============================================================

This file contains information you need to install the IBM Developer Connection
Device Driver Kit for OS/2, and additional information not included in the
documentation.

This README file is divided into the following categories:

o  Before You Install the IBM Developer Connection Device Driver Kit for OS/2

o  Installing the IBM Developer Connection Device Driver Kit for OS/2

o  Getting Help

o  Late-Breaking News and Special Notes

o  Your Satisfaction

o  Trademarks


Before You Install the IBM Developer Connection Device Driver Kit for OS/2
===========================================================================

   Software Requirements
   ---------------------
   One of the following:
     OS/2 2.0 with ServicePak XR06055 (See Note)
     OS/2 2.1
     OS/2 Warp

   NOTE:  Without the ServicePak, your OS/2 2.0 installation will not
          return the correct results from application-specific exits
          even though the exit completes correctly.  Also, Workplace
          Shell objects created during an installation will not use
          the specified icon.

   Hardware Requirements
   ---------------------
   1. The SWAPPER.DAT file may grow during installation depending on the
      number of components you select.  To do a full installation on an
      8MB RAM system, at least 15MB of disk space should be available to
      SWAPPER.DAT.  Systems with more RAM require less disk space (for
      example, a system with 16MB RAM will require 10MB of disk space
      for a full installation).

   2. You must have at least 2MB of disk space on your boot drive.

   NOTE:  If you are installing over a previous version of the DDK and
          you don't want any of your previous DDK files, you can use a
          special tool called DELDDK to delete all information related
          to the installed DDK.  This file is located in the \DDKx86\SETUP
          directory on the CD.  DELDDK will delete all .INI information,
          the old DDK folder on the Desktop, and the specified DDK tree.

   WARNING: Make sure to BACK UP any files that you want to
            save BEFORE you run DELDDK.  ALL files under the
            specified directory and its subdirectories will be
            DELETED by DELDDK.


Installing the IBM Developer Connection Device Driver Kit for OS/2
==================================================================
To start the installation process, execute the DDKINST command file
located in the root directory of the CD.  The DDK installation program
allows installation of selected (or all) components.

NOTES:  The "Delete the Installed Components and Reinstall" option
        might not work in certain situations.  To circumvent this
        problem, back up any files that you want to save and use the
        DELDDK tool to delete the previously installed DDK.  You can
        then run a fresh installation.

        When components are selected from the "Install - directories"
        panel, the installation program displays the total hard disk
        space (in bytes) necessary to install all the selected
        components.  You can review the free space available on each
        disk by selecting the "Disk space..." push button from the same
        panel.

        The "bytes needed" figure displayed by the installation program
        (which includes space for the installation program work files)
        is an approximation of the MAXIMUM number of bytes of free space
        required to perform an installation on a FAT-formatted disk.
        Significantly less space is required for installation on an
        HPFS-formatted disk.


Getting Help
============

   Using Your DDK
   --------------
   "Using Your DDK" in the DDK for OS/2 folder is an online document that
   describes in detail how to use the IBM Developer Connection Device
   Driver Kit for OS/2.

   It includes the following information:

   - A list of available driver source code, tools, and documentation
   - Compilers that are required to build a specific driver
   - A tree structure showing where specific driver files are located
   - Instructions on how to build a specific driver
   - Special considerations etc.

   Device Driver Documentation
   ---------------------------
   The \BOOK directory, under the DDK base directory, contains the
   DDK online documentation.  The files contained in this directory
   are .INF files and can be viewed with the OS/2 VIEW command.  You
   also can view the documentation directly from the CD (without
   installing the books on your hard disk) by double-clicking on
   "DDK References on DDK CD-ROM" in the DDK for OS/2 folder on the
   Desktop.

   PowerPC Documentation
   ---------------------
   PowerPC Reference Platform Specification V1.0 is included in the
   DDK online documentation.  To order a hardcopy of this reference,
   call 1-800-POWERPC using MPR-PPC-RPU-02 as the order number.

   Service and Technical Support
   -----------------------------
   We are ready to help you with your IBM Developer Connection Device
   Driver Kit for OS/2 questions.  You can contact us through the
   following channels:

   1. Use a PC and modem to place a call to the DUDE BBS at (407)982-3217
      (N, 8, 1  14.4 KBPS).  After completing a self-registration, you
      will have limited access to the system.  Additional information on
      Driver Development Support Center (DDSC) and system operations will
      be presented on the system after registration.  Within one business
      day, the DUDE team will verify the completion of your registration
      information, upgrade your access level to NORMAL, and notify you.

   2. Developers experiencing problems connecting to the DUDE BBS can call
      (407)982-4239 where they will hear a recorded message directing them to
      leave a name and phone number.  The messages are retrieved throughout
      the day, Monday-Friday, 8.00 a.m to 5.00 p.m. Eastern time.  A member
      of the DUDE team will return the call by the end of the next business
      day.


Late-Breaking News and Special Notes
====================================

   CHANGE/SUPPORT NOTICE
   ---------------------
   The source code contained in this DDK, besides sample code,
   includes the latest actual, buildable source code that will
   produce working drivers for different types of devices.

   The goal of the DDK is to provide device driver developers with
   as much of this tested code as early as possible.  However, some
   of this source code might be "preliminary" or "IBM internal use
   code."  This type of code is considered "unsupported" and is
   subject to change without notice.  Examples of this unsupported
   code are any function calls that are not documented in the
   available IBM Reference Manuals included in "Using Your DDK" (in
   the "Online Documentation" section under "DDK Roadmap").

   Device Drivers Referencing PMWINP.H
   -----------------------------------
   Any device drivers that previously referenced the files PMWINP.H
   or PMWINP.INC have been changed to reference the files PMWINX.H
   and PMWINX.INC.  If you are migrating to the current DDK, change
   any drivers on previous DDKs that referenced the files PMWINP.*
   to refer to the new PMWINX.* files.

   Microsoft MASM 6.0B
   -------------------
   Building drivers with Microsoft MASM 6.0B has known problems. We
   suggest that you use Microsoft MASM 6.0 for a successful build.

   OS/2 DEBUG KERNELS
   ------------------
   The OS/2 debug kernels are now supplied with The Developer Connection
   for OS/2.

   MODULE LEVEL VERSION CONTROL
   ----------------------------
   This DDK includes information on "Module Level Version Control,"
   an important procedure for device-driver developers.  Refer to
   the "Module Level Version Control" section in "Using Your DDK" for
   more information.

   CONSIDERATIONS WHEN INSTALLING THE OS/2 2.1 SERVICEPAK XR06200
   --------------------------------------------------------------
   Delivering the OS/2 2.1 ServicePak XR06200 uncovered a problem
   that IBM believes is limited to display drivers.  If you modify
   the source code provided in the DDK using the same display driver
   name and then install the ServicePak, your device driver will be
   overwritten.

   IBM has updated its display driver utilities to recognize display
   drivers not packaged in the OS/2 2.1 product. IBM also has tested
   a representative set of display drivers that support a broad range
   of popular display adapters and hardware systems.  This will help
   users recover their previous level of high resolution and color
   support.

   The updated utilities and workaround information are available
   electronically on worldwide bulletin boards and will be delivered
   with the ServicePak. These updates and workarounds apply only to U.S.
   versions of the ServicePak.

   IBM continues to work with independent hardware vendors and other
   software developers to architect and define standards.

   Developer Connection Browser
   ----------------------------
   The Developer Connection Browser has been removed from the DDK.

   Device Driver Conference Presentations
   --------------------------------------
   The Device Driver Conference Presentations has been removed from
   the DDK. Please refer to a previous version of the DDK for any
   information you might need.

Your Satisfaction
=================
Your satisfaction with IBM is important to us. If you are not totally
satisfied with this product, please contact us through one of the Service
and Technical support channels listed above.

Tell us what is not meeting your expectations and why you are dissatisfied.
Provide your name, your organization's name, and your telephone number so
we can contact you.  We will work with you to resolve your concerns.

Also, print the survey in "Using Your DDK" document, fill it out, and
send it to us.  Your input will help us plan future products for you.


Trademarks
==========
The following terms are trademarks of the IBM Corporation in the United
States and/or other countries:

   IBM
   OS/2
   OS/2 Warp


   IBM DISCLAIMS ALL WARRANTIES, WHETHER EXPRESSED OR IMPLIED,
   INCLUDING WITHOUT LIMITATION, WARRANTIES OF FITNESS AND
   MERCHANTABILITY WITH RESPECT TO THE INFORMATION IN THIS DOCUMENT.
   BY FURNISHING THIS DOCUMENT, IBM GRANTS NO LICENSES TO ANY RELATED
   PATENTS OR COPYRIGHTS.

   (c) Copyright IBM Corporation, 1995, all rights reserved.

