home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / tolkit45.zip / readme next >
Text File  |  1999-05-11  |  18KB  |  431 lines
  1. _______________________________________________________________________________
  2.  
  3. README - IBM OS/2 DEVELOPER'S TOOLKIT VERSION 4.5
  4. _______________________________________________________________________________
  5.  
  6. Welcome to the IBM OS/2 Developer's Toolkit Version 4.5 (hereafter referred to
  7. as the Toolkit).  In addition to this README, the "Using Your Toolkit" online
  8. book (located in the "book" subdirectory) is included to help you:
  9.  
  10.    -  See what is new and what has changed in the Toolkit
  11.    -  Become familiar with the Toolkit
  12.    -  Access information about the Toolkit more easily and quickly
  13.  
  14. This README, a supplement to "Using Your Toolkit," contains the following
  15. information:
  16.  
  17.    -  Introduction to the Toolkit
  18.    -  Installing the Toolkit
  19.    -  Updates to CONFIG.SYS
  20.    -  Programming considerations
  21.  
  22. Use a non-proportional font to view this file.
  23.  
  24.  
  25. _______________________________________________________________________________
  26. INTRODUCTION TO THE TOOLKIT
  27.  
  28. The IBM OS/2 Developer's Toolkit Version 4.5 provides development support
  29. for new features in the "OS/2 Warp Server for e-business" operating system.
  30.  
  31. The Toolkit helps you develop applications for OS/2 by providing you with:
  32.  
  33.    - Header files
  34.    - Library files
  35.    - Online documents
  36.    - Programming tools
  37.    - Sample application programs
  38.  
  39.  
  40. _______________________________________________________________________________
  41. INSTALLING THE TOOLKIT
  42.  
  43. This section provides a step-by-step procedure for installing the Toolkit.
  44.  
  45. This Toolkit is a follow-on to previous releases and should not be considered
  46. a replacement for any earlier release.  DO NOT install this toolkit "over"
  47. any previous release.  For a first-time installation of this Toolkit, specify
  48. an unused target location in the "Destination" field when prompted by the
  49. Toolkit installation program.  For subsequent (additive) installations of this
  50. release (for example, to install components that were not requested during the
  51. original installation), the same destination directory may be respecified.
  52.  
  53. There may be Corrective Service Distributions (CSD's) available for this
  54. release of the Toolkit.  Toolkit CSD's provide a mechanism for updating the
  55. components of an existing Toolkit installation.  The CSD images are designed
  56. to be installed "over" an existing Toolkit of the appropriate release.
  57. CSD's for each release are numbered sequentially (from CSD1 to CSDn), and
  58. the installation instructions for a particular "numbered" CSD can be found
  59. in the "numbered" README file (eg. README.1) included with the CSD package.
  60.  
  61. _______________________________________________________________________________
  62. System Requirements
  63.  
  64. The following is the prerequisite software required:
  65.  
  66.    o  One of the following versions of the OS/2 operating system:
  67.  
  68.       - OS/2 Warp Server for e-business
  69.       - OS/2 Warp Version 4
  70.       - OS/2 Warp Version 3
  71.       - OS/2 Warp with WIN-OS/2 Version 3
  72.       - OS/2 Warp Connect
  73.       - OS/2 Warp Connect with WIN-OS/2
  74.  
  75.    o  Various components have additional software requirements.  The
  76.       Toolkit components that you choose to install will function only if
  77.       the underlying operating system supports the component.  Some of the
  78.       additional requirements include the following:
  79.  
  80.       - Open32 samples require the Open32 interfaces (previously known as
  81.         the IBM Developer API Extensions for OS/2 or DAPIE)
  82.       - OpenGL samples require OpenGL (also referred to as Enhanced 3D
  83.         Graphics)
  84.       - All REXX samples, with the exception of the REXX API samples,
  85.         require Object REXX
  86.  
  87.         Note: The features listed above are available on OS/2 Warp Server for
  88.               e-business and OS/2 Warp Version 4.  If you are using version 3
  89.               of the OS/2 operating system, you will need to obtain support
  90.               for these components either via FixPak 17 or later (for Open32
  91.               support), or from the Developer Connection CD (for OpenGL and
  92.               Object REXX support).
  93.  
  94.    o   To use the latest level of Universal Language Support, one of the
  95.        following operating systems is required:
  96.  
  97.        - OS/2 Warp Server for e-business
  98.        - OS/2 Warp Version 4
  99.        - OS/2 Warp Version 3 with FixPak 32 or later 
  100.  
  101.        If you do not have Universal Language Support, you will receive errors 
  102.        when using the NMAKE32, RC, and MKTMPF tools.  
  103.  
  104.    o   The new TCP/IP Toolkit Version 4.21 is also provided, which contains
  105.        sample programs that take advantage of the new 32-bit TCP/IP interfaces
  106.        in OS/2 Warp Server for e-business.  If you are using an older version
  107.        of the operating system, these sample programs may fail with the error
  108.        "SYS1804: The system cannot find the file TCPIP32" if the target machine
  109.        is not configured with TCP/IP Version 4.1 or newer.
  110.  
  111. Before you install the Toolkit, make sure you have:
  112.  
  113.    -  A personal computer capable of running OS/2 Warp
  114.  
  115.    -  A CD-ROM drive
  116.  
  117.    -  A hard disk drive with at least 90 MB of free disk space (to
  118.       install the entire Toolkit)
  119.  
  120. We recommend that you use a mouse when installing the Toolkit.
  121.  
  122. If you will be installing the IBM VisualAge C++ 3.0 compiler, please read the
  123. following notes:
  124.  
  125.       Installing your compiler first and the OS/2 Warp Toolkit last
  126.       prevents unexpected results due to environment variable changes
  127.       (automatic updates to CONFIG.SYS).  To avoid a downlevel SOM Runtime
  128.       installed by the VisualAge C++ 3.0 compiler, follow these steps for
  129.       installation:
  130.  
  131.       1. Start the installation program for VisualAge C++ 3.0.
  132.  
  133.       2. Deselect the OS/2 Warp Toolkit entries in the installation screen
  134.          and proceed with the installation.
  135.  
  136.       3. After completing the installation of VisualAge C++, but before
  137.          restarting the system, edit CONFIG.SYS and modify the LIBPATH
  138.          statement by moving x:\IBMCPP\DLL after y:\OS2\DLL, where x is
  139.          the drive where the VisualAge C++ compiler is installed and y is
  140.          the drive where the OS/2 Warp Version 4 operating system files
  141.          are installed.  This prevents the SOM Runtime installed by
  142.          VisualAge C++ from overriding the SOM Runtime shipped with OS/2
  143.          Warp Version 4.
  144.  
  145.       4. Save the modified CONFIG.SYS and restart your system.
  146.  
  147.       5. Install the IBM OS/2 Developer's Toolkit Version 4.5 and restart
  148.          your system.
  149.  
  150.  
  151. _______________________________________________________________________________
  152. Installation Program
  153.  
  154. Install all or part of the Toolkit using the Toolkit Installation program
  155. (a Presentation Manager/2 (PM) application) on the CD-ROM.  Using the
  156. Toolkit Installation program, you can install:
  157.  
  158.      - Header files
  159.      - Library files
  160.      - Online documents
  161.      - Programming tools
  162.      - Sample application programs
  163.  
  164. The Toolkit Installation will copy chosen files to your machine and update
  165. CONFIG.SYS with respect to the locally installed files.
  166.  
  167.  
  168. _______________________________________________________________________________
  169. Installation Help
  170.  
  171. To get online help while using the Toolkit Installation program, do one of
  172. the following:
  173.  
  174.    -  Press F1
  175.    -  Select the Help push button
  176.    -  Choose one of the help choices from the Help menu
  177.  
  178. _______________________________________________________________________________
  179. Installing the Toolkit
  180.  
  181. To install the Toolkit, do the following:
  182.  
  183.    1. Start the Toolkit Installation Program:
  184.     
  185.       - If you are installing the Toolkit from a Developer Connection CD-ROM
  186.         and are using the interfaces provide by the Developer Connection,
  187.         follow the instructions provided by that interface.
  188.  
  189.       - If you are working directly with the "installation image" of the
  190.         Toolkit (for example, you have downloaded and unpacked on online
  191.         version of the toolkit, or you are referencing the subdirectory
  192.         tree of the installation image as is exists on the CD-ROM), then
  193.         locate and execute the "tkinstal.exe" program.
  194.  
  195.    2.  The IBM OS/2 Developer's Toolkit Version 4.5 Installation window is
  196.        displayed.  Select each component you want to install.  Depending on
  197.        the components you select for installation, additional components might
  198.        be automatically selected for installation.  A plus (+) sign in a box
  199.        in front of a component indicates that the component has at least one
  200.        level of subcomponents from which you can select.  Select the plus
  201.        sign in front of the component to expand the list of components.
  202.  
  203.    3.  If desired, change the default destination for the selected
  204.        components by editing the "Destination" field.  If the entire
  205.        Toolkit is not required, components may still be deselected in the
  206.        usual manner.  However, it is important that the paths are not
  207.        changed from their defaults for all components other than the root,
  208.        because the directory structure on the CD-ROM cannot be changed.
  209.  
  210.    4.  Select Options to specify what updates to your system are required.
  211.        You can choose to:
  212.  
  213.           - Install the selected files.
  214.           - Register Workplace Shell classes for the components that
  215.             utilize them.
  216.           - Create Workplace Shell objects.
  217.           - Select the file where any CONFIG.SYS updates are to be made,
  218.             or deselect the "Write CONFIG.SYS updates to:" check box to
  219.             prevent the Toolkit Installation program from updating
  220.             CONFIG.SYS.
  221.  
  222.    5.  To install all selected components of the Toolkit:
  223.  
  224.           a. Select Install.
  225.           b. Follow the prompts in the message boxes to complete the
  226.              installation.
  227.  
  228.    6.  A message box is displayed indicating successful completion of the
  229.        installation.
  230.  
  231.    7.  To make the changes effective, shut down and restart your system.
  232.        After the Toolkit is installed, the Toolkit folder appears on the
  233.        Desktop, represented by a toolbox icon.
  234.  
  235.  
  236.  
  237. _______________________________________________________________________________
  238. UPDATES TO CONFIG.SYS
  239.  
  240. The Toolkit Installation program adds the paths of all needed environment
  241. variables with the appropriate Toolkit path.  These variables include
  242. BOOKSHELF, DPATH, HELP, and so on.  If you choose to make these updates
  243. manually, do the following before installing the Toolkit:
  244.  
  245.    1. Select Options from the Toolkit Installation program.
  246.  
  247.    2. Change the file name in the "Write CONFIG.SYS updates to:" field to
  248.       something other than CONFIG.SYS (for example, CONFIG.001).
  249.  
  250.    3. This file can be compared to your original CONFIG.SYS once the
  251.       installation is complete.  You can then make the appropriate
  252.       modifications to CONFIG.SYS as you choose.
  253.  
  254.  
  255.  
  256. _______________________________________________________________________________
  257. PROGRAMMING CONSIDERATIONS
  258.  
  259.   o The OS/2 C libraries provide all of the functions necessary for C
  260.     development; however, they do not support C++ development.  Currently,
  261.     this support must be provided by a compiler vendor.
  262.  
  263.   o If you are using the C Runtime Headers provided with the Toolkit, be
  264.     sure to link with the C Runtime libraries provided in the LIB
  265.     directory to prevent link errors.  If you are not using the C Runtime
  266.     libraries, you should not use the C Runtime Headers provided in the 
  267.     Toolkit.
  268.  
  269.   o MPTS programming information is included in the TCP/IP Programming
  270.     Reference.
  271.  
  272.  
  273. _______________________________________________________________________________
  274. Tools
  275.  
  276.   o  There are two versions of the Program Maintenance Utility (NMAKE) and
  277.      of the Resource Compiler (RC).  The default versions of these tools are
  278.      referenced by the names "NMAKE" and "RC" and the "alternate" versions
  279.      of these tools are referenced by the names "NMAKE32" and "RC16".  The
  280.      differences between these tools are as follows:
  281.  
  282.      NMAKE   - This is the "old" Program Maintenance Utility.  Because of the
  283.                semantic and syntactic differences between this utility and
  284.                the "new" version of NMAKE (NMAKE32), the old version has been
  285.                restored as the default program maintenance utility.  This
  286.                version of NMAKE is documented in the Tools Reference book.
  287.  
  288.      NMAKE32 - This is the "Enhanced Program Maintenance Utility".  In the
  289.                previous release of the Toolkit (IBM Developer's Toolkit for
  290.                OS/2 Warp Version 4) this was the default NMAKE utility, but
  291.                it has been renamed to NMAKE32 for this release.  This version
  292.                of NMAKE is documented in the file "book\nmake32.inf".
  293.  
  294.      RC16    - This is the old "Legacy Resource Compiler".  It is included for
  295.                customers who cannot update their resource scripts to compile
  296.                with the newer version of RC.  This version of RC is documented
  297.                in the file "book\rc16.inf".
  298.  
  299.      RC      - This is the "new" Resource Compiler.  Where possible, backward
  300.                compatibility with RC16 is maintained, but the new RC has
  301.                stricter syntax checking and may issue errors against some
  302.                resource scripts.  This version of RC also contains additional
  303.                features such as true national language support and a full-
  304.                featured C-language preprocessor.  This version of RC is
  305.                documented in the Tools Reference book.
  306.  
  307.  
  308.   o  If you encounter a trap in LIBUNI.DLL when using Make Template File
  309.      (MKTMPF) or the Resource Compiler (RC) on an OS/2 Warp Version 3
  310.      system, change the SET LANG=ENUS437 statement in CONFIG.SYS to SET
  311.      LANG=EN_US.
  312.  
  313.  
  314. _______________________________________________________________________________
  315. VoiceType Developer's Toolkit
  316.  
  317.   o  The VoiceType Developer's Toolkit online documentation is in HTML
  318.      format.  You need an HTML browser, such as IBM WebExplorer or
  319.      Netscape Navigator for OS/2 Warp, to view it.
  320. _______________________________________________________________________________
  321.  
  322.  
  323. _______________________________________________________________________________
  324. TCP/IP
  325.  
  326.   o  Compiling an application with the BSD 4.3 header files:
  327.  
  328.      The 4.3 BSD header files (for TCP/IP versions prior to 4.1) are also 
  329.      included with this Toolkit.  To access the header files, define 
  330.      TCPV40HDRS before including (#include) any of the TCP/IP header
  331.      files.  Do this on the command line with the /D switch:
  332.  
  333.          icc /DTCPV40HDRS /c myprog.c
  334.  
  335.      or in your .c file:
  336.  
  337.      #define TCPV40HDRS
  338.      #include <sys\socket.h>
  339.       ...
  340.  
  341.      To link an application that was compiled with these header files, 
  342.      you must specify so32dll.lib and tcp32dll.lib on the link line:
  343.  
  344.       ilink /NOFREEFORMAT myprog,myprog.exe,NULL, so32dll.lib tcp32dll.lib
  345.  
  346.   o  Update to "Compiling an RPC API Application"
  347.  
  348.      Use these steps to compile and link an RPC API application using IBM 
  349.      VisualAge C++ for OS/2: 
  350.  
  351.      1. To compile your program, enter: 
  352.  
  353.       icc /DTCPV40HDRS /C myprog.c
  354.  
  355.      2. To create an executable program, you can enter (on one line): 
  356.  
  357.       ilink /NOFREEFORMAT myprog,myprog.exe,NULL, rpc32dll.lib 
  358.             so32dll.lib tcp32dll.lib
  359.  
  360.  
  361.      Notes:
  362.      -  The RPC API is not re-entrant.  If you are creating a multithreaded 
  363.         program, you must serialize the access to the APIs. 
  364.  
  365.      -  For more information about the compile and link options, and 
  366.         dynamic link libraries, see the user's guide provided with your 
  367.         compiler. 
  368.  
  369.      -  RPC applications must be compiled using the 4.3 BSD API (pre-TCP/IP 
  370.         4.1 header files).  Using the 4.4 header files with an RPC application 
  371.         is not supported.
  372. _______________________________________________________________________________
  373.  
  374.  
  375. _______________________________________________________________________________
  376. SOM
  377.  
  378.   o  As of 6/97, IBM no longer supports SOM. 
  379. _______________________________________________________________________________
  380.  
  381. Thank you for your continued interest in OS/2.
  382. _______________________________________________________________________________
  383.  
  384.  
  385. TRADEMARK INFORMATION
  386. _____________________
  387.  
  388. The following terms are trademarks of the IBM Corporation in the United
  389. States or other countries or both:
  390.  
  391.    -------------------------------------------------------
  392.    IBM
  393.    -------------------------------------------------------
  394.    OS/2
  395.    -------------------------------------------------------
  396.    Presentation Manager
  397.    -------------------------------------------------------
  398.    SOM
  399.    -------------------------------------------------------
  400.    VisualAge
  401.    -------------------------------------------------------
  402.    VoiceType
  403.    -------------------------------------------------------
  404.    WebExplorer
  405.    -------------------------------------------------------
  406.    WIN-OS/2
  407.    -------------------------------------------------------   
  408.    Workplace Shell
  409.    -------------------------------------------------------
  410.  
  411.  
  412. The following terms are trademarks of other companies:
  413.  
  414.    ----------------------------------------------------------------
  415.    Netscape                    Netscape Communications Corporation
  416.    Netscape Navigator
  417.    ----------------------------------------------------------------
  418.  
  419. IBM DISCLAIMS ALL WARRANTIES, WHETHER EXPRESSED OR IMPLIED, INCLUDING
  420. WITHOUT LIMITATION, WARRANTIES OF FITNESS AND MERCHANTABILITY WITH
  421. RESPECT TO THE INFORMATION IN THIS DOCUMENT.  BY FURNISHING THIS
  422. DOCUMENT, IBM GRANTS NO LICENSES TO ANY RELATED PATENTS OR COPYRIGHTS.
  423.  
  424. Copyright IBM Corporation, 1999, all rights reserved.
  425.  
  426. _______________________________________________________________________________
  427.  
  428. END-OF-README-FILE
  429. _______________________________________________________________________________
  430.  
  431.