home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / smp4uptk.zip / README.SMP next >
Text File  |  1996-11-19  |  7KB  |  216 lines
  1. __________________________________________________________
  2.  
  3. IBM DEVELOPER'S TOOLKIT FOR OS/2 WARP VERSION 3 SMP UPDATE
  4. __________________________________________________________
  5.  
  6.  
  7. Welcome to the IBM Developer's Toolkit for OS/2 Warp Version 3 SMP Update.
  8. This Toolkit update has been prepared so that you can take advantage of the
  9. SMP support in the OS/2 Warp Server Advanced Version 4 SMP Feature.
  10.  
  11. NOTE: Before attempting to install this Toolkit Update, you must be a licensed
  12.       owner of the IBM Developer's Toolkit for OS/2 Warp Version 3 and have it
  13.       installed.  To take advantage of all of the Warp Server function, you
  14.       should be a licensed owner of the IBM Warp Server Toolkit.
  15.  
  16. This README document contains the following sections:
  17.  
  18.    - DIRECTORY STRUCTURE OF THE TOOLKIT UPDATE
  19.    - CONTENTS OF THE TOOLKIT UPDATE
  20.    - SMP PROGRAMMING ADDENDUM
  21.    - INSTALLING THE TOOLKIT UPDATE
  22.    - NEW CONTROL PROGRAM FUNCTIONS
  23.    - MARKING SMP APPLICATION'S FILE-HEADERS
  24.    - ICAT ENHANCEMENTS
  25.    - NEW DEBUG KERNEL COMMANDS
  26.  
  27.  
  28. DIRECTORY STRUCTURE OF THE TOOLKIT UPDATE
  29. _________________________________________
  30.  
  31. The Toolkit Update package has the following directory structure:
  32.  
  33. ...\TOOLKIT         -- Root directory of the Toolkit Update
  34.       ├─\BIN        -- Programming tools
  35.       ├─\BOOK       -- Online information
  36.       ├─\H          -- Header files
  37.       ├─\INC        -- Assembler header (.INC) files
  38.       ├─\ICON       -- Toolkit icon (.ICO) files
  39.       └─\LIB        -- Library files
  40.  
  41.  
  42. CONTENTS OF THE TOOLKIT UPDATE
  43. ______________________________
  44.  
  45. The Toolkit Update contains the following files:
  46.  
  47.    - README.SMP - This file
  48.  
  49.    - New header files and LIB files:
  50.  
  51.         \TOOLKIT\H\BSEDOS.H
  52.         \TOOLKIT\H\BSEMEMF.H
  53.  
  54.         \TOOLKIT\INC\BSEMEMF.INC
  55.         \TOOLKIT\INC\DEVHLP.INC
  56.         \TOOLKIT\INC\BSEDOC.INC
  57.  
  58.         \TOOLKIT\LIB\OS2286.LIB
  59.         \TOOLKIT\LIB\OS2386.LIB
  60.  
  61.  
  62.  
  63. SMP PROGRAMMING ADDENDUM
  64. ________________________
  65.  
  66. A new online reference, "SMP Programming Addendum," serves as an introduction
  67. to symmetrical multiprocessing (SMP) and contains information targeted for SMP
  68. application and device driver developers.  The file name of this online book
  69. is SMP.INF and it is located in the \TOOLKIT\BOOK subdirectory.
  70.  
  71.  
  72. INSTALLING THE TOOLKIT UPDATE
  73. _____________________________
  74.  
  75. NOTE: You must install the IBM Developer's Toolkit for OS/2 Warp Version 3
  76.       before installing the Toolkit Update.
  77.  
  78. To install the Toolkit Update, take the following steps:
  79.  
  80.  
  81.    1. Start an OS/2 window or OS/2 full-screen session.
  82.  
  83.    2. Make the CD-ROM drive the working drive by typing the drive
  84.       letter and a colon, and then pressing Enter.  For example, if
  85.       the CD-ROM drive is assigned drive letter F, type:
  86.  
  87.         F:
  88.  
  89.    3. Change to the Toolkit subdirectory by typing the following:
  90.  
  91.        CD TOOLKIT
  92.  
  93.    4. Next, type the following:
  94.  
  95.        TKINSTAL
  96.  
  97.  
  98.  
  99. NEW CONTROL PROGRAM FUNCTIONS
  100. _____________________________
  101.  
  102. Several new functions have been added to the OS/2 control program programming
  103. interface (the functions have a prefix of "Dos").  These functions are
  104. documented in the "SMP Programming Addendum" online book.
  105.  
  106.  
  107. MARKING SMP APPLICATION'S FILE-HEADERS
  108. ______________________________________
  109.  
  110. The EXEHDR and MARKEXE utility programs have been updated to recognize the SMP
  111. bit settings.  Refer to the "SMP Programming Addendum" for more information.
  112.  
  113.  
  114. ICAT ENHANCEMENTS
  115. _________________
  116.  
  117. Enhancements made to the ICAT tool include the following:
  118.  
  119.    - Supports NB05 CV format and C++ in Watcom compiler (also supports separate
  120.      debug file for Watcom).
  121.  
  122.    - Profile files (.INI and *.@*) no longer need to be erased with each new
  123.      version of ICAT.
  124.  
  125.    - Debug Session Control (DSC) changes:
  126.  
  127.       - PID, TID, virtual thread, and process name are displayed, along with the
  128.         processor number on SMP systems.
  129.       - Progress messages are displayed during attach and during single step,
  130.         step over, and when a run event has occurred (such as a breakpoint hit).
  131.       - Clicking on .EXE file automatically updates correct slot.
  132.  
  133.    - Storage window now has a fill-byte capability.
  134.  
  135.    - Program monitor window now has clipboard support.
  136.  
  137.    - Searches can be done from a Passthru window.
  138.  
  139.    - Bubble help on variables.
  140.  
  141.    - Contents of any window can be copied to a file.
  142.  
  143.    - Passthru window filters out certain kernel debugger commands (such as G
  144.      for the GO command) to prevent lockups.
  145.  
  146.    - New environment variables:
  147.  
  148.       - CAT_PATH_RECURSE searches the CAT_HOST_BIN_PATH and CAT_HOST_SOURCE_PATH
  149.         subdirectories recursively.
  150.       - CAT_KDB_INIT initializes the kernel debugger from ICAT with
  151.         user-specified commands, such as vsf *.
  152.       - CAT_SETUP_RATE returns the kernel debugger to where it was before ICAT
  153.         was used.
  154.  
  155.    - Numerous bug fixes and performance enhancements.
  156.  
  157. NEW DEBUG KERNEL COMMANDS
  158. _________________________
  159.  
  160. All kernel debugger commands work as before, but a few have been modified to
  161. display or use multi-processor-specific information, and several new
  162. multi-processor-specific commands have been added.
  163.  
  164. A list of new and changed commands follows:
  165.  
  166.     The .DP (processor status) command has been added.
  167.     This command dumps out a processor control block verbosely.
  168.  
  169.     The .DL (display processor spinlocks) command has been added.
  170.     This command displays all the spin locks owned by a particular
  171.     processor.
  172.  
  173.     The R and the .R (register commands) have been modified to
  174.     indicate on which processor the currently selected slot is
  175.     running.
  176.  
  177.     The .SS (change current slot) has been modified to change
  178.     which PSA (processor save area) you are currently looking at.
  179.  
  180. These commands are documented in the "SMP Programming Addendum" (SMP.INF).
  181.  
  182. The kernel debug diskettes shipped with the Developer's Toolkit for
  183. OS/2 Warp Version 3 will not work with OS/2 for SMP.  (The kernel debug
  184. files for OS/2 for SMP are located on the OS/2 for SMP CD-ROM.)
  185.  
  186.  
  187. __________________________________________________________________________
  188.  
  189.    Thank you for your continued interest in the OS/2 Operating System.
  190. __________________________________________________________________________
  191.  
  192.  
  193. TRADEMARK INFORMATION
  194. _____________________
  195.  
  196. The following terms are trademarks of the IBM Corporation in the United
  197. States or other countries or both:
  198.  
  199.      ------------------------------------------
  200.      IBM
  201.      ------------------------------------------
  202.      OS/2
  203.      ------------------------------------------
  204.  
  205. IBM DISCLAIMS ALL WARRANTIES, WHETHER EXPRESSED OR IMPLIED, INCLUDING
  206. WITHOUT LIMITATION, WARRANTIES OF FITNESS AND MERCHANTABILITY WITH
  207. RESPECT TO THE INFORMATION IN THIS DOCUMENT.  BY FURNISHING THIS
  208. DOCUMENT, IBM GRANTS NO LICENSES TO ANY RELATED PATENTS OR COPYRIGHTS.
  209.  
  210. Copyright IBM Corporation, 1996, all rights reserved.
  211.  
  212. __________________________________________________________________________
  213.  
  214.                               END-OF-FILE
  215. __________________________________________________________________________
  216.