__________________________________________________________

IBM DEVELOPER'S TOOLKIT FOR OS/2 WARP VERSION 3 SMP UPDATE
__________________________________________________________


Welcome to the IBM Developer's Toolkit for OS/2 Warp Version 3 SMP Update.
This Toolkit update has been prepared so that you can take advantage of the
SMP support in the OS/2 Warp Server Advanced Version 4 SMP Feature.

NOTE: Before attempting to install this Toolkit Update, you must be a licensed
      owner of the IBM Developer's Toolkit for OS/2 Warp Version 3 and have it
      installed.  To take advantage of all of the Warp Server function, you
      should be a licensed owner of the IBM Warp Server Toolkit.

This README document contains the following sections:

   - DIRECTORY STRUCTURE OF THE TOOLKIT UPDATE
   - CONTENTS OF THE TOOLKIT UPDATE
   - SMP PROGRAMMING ADDENDUM
   - INSTALLING THE TOOLKIT UPDATE
   - NEW CONTROL PROGRAM FUNCTIONS
   - MARKING SMP APPLICATION'S FILE-HEADERS
   - ICAT ENHANCEMENTS
   - NEW DEBUG KERNEL COMMANDS


DIRECTORY STRUCTURE OF THE TOOLKIT UPDATE
_________________________________________

The Toolkit Update package has the following directory structure:

...\TOOLKIT         -- Root directory of the Toolkit Update
      ÃÄ\BIN        -- Programming tools
      ÃÄ\BOOK       -- Online information
      ÃÄ\H          -- Header files
      ÃÄ\INC        -- Assembler header (.INC) files
      ÃÄ\ICON       -- Toolkit icon (.ICO) files
      ÀÄ\LIB        -- Library files


CONTENTS OF THE TOOLKIT UPDATE
______________________________

The Toolkit Update contains the following files:

   - README.SMP - This file

   - New header files and LIB files:

        \TOOLKIT\H\BSEDOS.H
        \TOOLKIT\H\BSEMEMF.H

        \TOOLKIT\INC\BSEMEMF.INC
        \TOOLKIT\INC\DEVHLP.INC
        \TOOLKIT\INC\BSEDOC.INC

        \TOOLKIT\LIB\OS2286.LIB
        \TOOLKIT\LIB\OS2386.LIB



SMP PROGRAMMING ADDENDUM
________________________

A new online reference, "SMP Programming Addendum," serves as an introduction
to symmetrical multiprocessing (SMP) and contains information targeted for SMP
application and device driver developers.  The file name of this online book
is SMP.INF and it is located in the \TOOLKIT\BOOK subdirectory.


INSTALLING THE TOOLKIT UPDATE
_____________________________

NOTE: You must install the IBM Developer's Toolkit for OS/2 Warp Version 3
      before installing the Toolkit Update.

To install the Toolkit Update, take the following steps:


   1. Start an OS/2 window or OS/2 full-screen session.

   2. Make the CD-ROM drive the working drive by typing the drive
      letter and a colon, and then pressing Enter.  For example, if
      the CD-ROM drive is assigned drive letter F, type:

        F:

   3. Change to the Toolkit subdirectory by typing the following:

       CD TOOLKIT

   4. Next, type the following:

       TKINSTAL



NEW CONTROL PROGRAM FUNCTIONS
_____________________________

Several new functions have been added to the OS/2 control program programming
interface (the functions have a prefix of "Dos").  These functions are
documented in the "SMP Programming Addendum" online book.


MARKING SMP APPLICATION'S FILE-HEADERS
______________________________________

The EXEHDR and MARKEXE utility programs have been updated to recognize the SMP
bit settings.  Refer to the "SMP Programming Addendum" for more information.


ICAT ENHANCEMENTS
_________________

Enhancements made to the ICAT tool include the following:

   - Supports NB05 CV format and C++ in Watcom compiler (also supports separate
     debug file for Watcom).

   - Profile files (.INI and *.@*) no longer need to be erased with each new
     version of ICAT.

   - Debug Session Control (DSC) changes:

      - PID, TID, virtual thread, and process name are displayed, along with the
        processor number on SMP systems.
      - Progress messages are displayed during attach and during single step,
        step over, and when a run event has occurred (such as a breakpoint hit).
      - Clicking on .EXE file automatically updates correct slot.

   - Storage window now has a fill-byte capability.

   - Program monitor window now has clipboard support.

   - Searches can be done from a Passthru window.

   - Bubble help on variables.

   - Contents of any window can be copied to a file.

   - Passthru window filters out certain kernel debugger commands (such as G
     for the GO command) to prevent lockups.

   - New environment variables:

      - CAT_PATH_RECURSE searches the CAT_HOST_BIN_PATH and CAT_HOST_SOURCE_PATH
        subdirectories recursively.
      - CAT_KDB_INIT initializes the kernel debugger from ICAT with
        user-specified commands, such as vsf *.
      - CAT_SETUP_RATE returns the kernel debugger to where it was before ICAT
        was used.

   - Numerous bug fixes and performance enhancements.

NEW DEBUG KERNEL COMMANDS
_________________________

All kernel debugger commands work as before, but a few have been modified to
display or use multi-processor-specific information, and several new
multi-processor-specific commands have been added.

A list of new and changed commands follows:

    The .DP (processor status) command has been added.
    This command dumps out a processor control block verbosely.

    The .DL (display processor spinlocks) command has been added.
    This command displays all the spin locks owned by a particular
    processor.

    The R and the .R (register commands) have been modified to
    indicate on which processor the currently selected slot is
    running.

    The .SS (change current slot) has been modified to change
    which PSA (processor save area) you are currently looking at.

These commands are documented in the "SMP Programming Addendum" (SMP.INF).

The kernel debug diskettes shipped with the Developer's Toolkit for
OS/2 Warp Version 3 will not work with OS/2 for SMP.  (The kernel debug
files for OS/2 for SMP are located on the OS/2 for SMP CD-ROM.)


__________________________________________________________________________

   Thank you for your continued interest in the OS/2 Operating System.
__________________________________________________________________________


TRADEMARK INFORMATION
_____________________

The following terms are trademarks of the IBM Corporation in the United
States or other countries or both:

     ------------------------------------------
     IBM
     ------------------------------------------
     OS/2
     ------------------------------------------

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.

Copyright IBM Corporation, 1996, all rights reserved.

__________________________________________________________________________

                              END-OF-FILE
__________________________________________________________________________
