Professional Developers Kit 02/93 Readme: Difference between revisions

From OS2World.Com Wiki
Jump to navigation Jump to search
Created page with " README.NOW Table of Contents: Introduction Changes in the 2/93 PDK Support Information Helpful Hints Installing OS/2 What Other Products Are on the PDK? - Communications - Development Tools - Documentation - Editors - Multimedia Products - Productivity Tools - Test Tools Procedure to install Communications Manager from CD ROM Important information..."
 
No edit summary
 
(6 intermediate revisions by 2 users not shown)
Line 1: Line 1:


                              README.NOW
==Introduction==
This is the 02/93 limited edition version of the Professional Developers Kit (PDK) CD ROM. It contains a Beta release of OS/2 2.1 with WIN-OS/2 Version 3.1, C++, PL/I, Communications Manager, including the new client server version, DCE (Distributed Computing Environment), PEN PM, Visual REXX, OS/2 Redbooks and Technical Library, HyperWrite information developer, PMate automated test tool, Productivity Tools, etc. This Kit is targeted for experienced developers. The OS/2 Developers Toolkit and Kernel Debugger have been matched with the level of OS/2 2.1 on this PDK. Some of the products on this PDK may not have been tested with this level of the operating system.


==Changes in the 02/93 Version of the PDK==
Some of the new products on this PDK include:


  Table of Contents:
OS/2 2.1-install from CD, plus 3.5" and 5.25" diskette images COMM Manager Client, Application, Debugger DCE - distributed computing environment
    Introduction
    Changes in the 2/93 PDK
    Support Information
    Helpful Hints
    Installing OS/2
    What Other Products Are on the PDK?
      - Communications
      - Development Tools
      - Documentation
      - Editors
      - Multimedia Products
      - Productivity Tools
      - Test Tools
    Procedure to install Communications Manager from CD ROM
    Important information on DCE (Distributed Computing Environment)
    PM Debug Considerations (Kernel Debugger)
    Important information on C++


The products on the PDK are listed by category in the section << What Other Products are on the PDK >>, and a '*' next to the name indicates it is NEW for the 2/93 PDK.


For a history file of changes with each new PDK, please see HISTORY.FIL in the root directory.


                          << INTRODUCTION >>
==Support==
The products provided on this CD ROM are beta level and are provided 'AS IS'. There is no warranty or service implied with respect to the program(s) included. You may monitor CompuServe for any information related to this beta product. Your comments/problems may be submitted only via CompuServe and will be appreciated and forwarded to the appropriate personnel for consideration in the next release.
Pls INCLUDE THE LEVEL of PDK with your comments (9/92-white label with no date, 10/92-dated silver label, 11/92-dated blue label, 02/93 dated coral label).


CompuServe users should enter 'GO OS2DF2', Section 12 Developer's CD ROM. (Due to restructuring of CompuServe, all references on this PDK to 'GO OS2DEV' should be updated to 'GO OS2DF2') If you are not a member of CompuServe, please call 1-800-524-3388 and ask for representative #239 for a free introductory membership.


    This is the 02/93 limited edition version of the Professional
==Helpful Hints==
    Developers Kit (PDK) CD ROM. It contains a Beta release of OS/2 2.1
# It is important to read any README files about the products before you use them. Please make sure you check for README files after you have installed products from the CD ROM, or from the diskettes you created.
    with WIN-OS/2 Version 3.1, C++, PL/I, Communications Manager, including
# Many of the products that get installed from this PDK will have their own icons and will be placed in the ISV Tools folder on your desktop. Also, when you go into the PDK Information folder, do an ARRANGE to place the ICONS in a readable order.
    the new client server version, DCE (Distributed Computing Environment),
# The install program works with the following rules. Choose a title and click on the '+' sign to see the subcategories. (Clicking on the '-' sign will shrink this list). Highlight the subcategory by clicking on it. Then choose 'Add' at the bottom of the screen. You can also click on 'Info' to get a description of the product you highlighted.
    PEN PM, Visual REXX, OS/2 Redbooks and Technical Library, HyperWrite
# During the install, if you notice an error with UNPACK.EXE, you may not have enough disk space to install the application. Also, each installation package works differently. If any error occurs on install, please check free space FIRST to make sure you have sufficient hardfile space. Do not install any of the productivity tools into the root directory of any drive.
    information developer, PMate automated test tool, Productivity Tools,
# Please leave the PDK in the CD ROM drive while you are using products on the PDK, even though you may not be accessing the PDK.
    etc. This Kit is targeted for experienced developers. The OS/2
# If you install OS/2, C++, and TOOLKT20 from the PDK, you will find a number of different LINK386.exe file.
    Developers Toolkit and Kernel Debugger have been matched with the
    level of OS/2 2.1 on this PDK.  Some of the products on this PDK
    may not have been tested with this level of the operating system.


The Beta version of LINK386 from the Install menu should be used when the using C++ compiler, since this version has additional support for the C++ class extension. Check your CONFIG.SYS to make sure that you are pointing to the correct Linker.


NOTE: You must ensure that the IBMC\BIN directory occurs before the TOOLKT20\OS2BIN directory in the PATH statement. Also, the recommended order of installation should still be followed to ensure that the EPM /H context sensitive help, and WorkFrame/2, C Set/2 support function correctly. The recommended order of installation is Toolkit, WorkFrame/2, then C Set/2.


                  << CHANGES IN THE 02/93 VERSION OF THE PDK >>
==Installing OS/2==
From CD ROM (both DOS and OS/2 System Users):


In order to install OS/2 from the CD ROM drive both your SCSI adapter and your CD ROM drive must be supported under OS/2. If these are not supported under OS/2 you can create the OS/2 diskettes through DOS support - see text file called DOSINFO.TXT.


    Some of the new products on this PDK include:
You will need 2 blank 1.44MB- 3.5" (or 1.2 MB- 5.25") diskettes to create 'OS/2 Installation Diskette' and 'Operating System/2 Diskette 1' (DISK 1). (Since this is beta code, is recommended that you place OS/2 2.1 in a separate partition on your hardfile rather than installing over OS/2 2.0 GA level).


      OS/2 2.1-install from CD, plus 3.5" and 5.25" diskette images
1) To create the install disks:
      COMM Manager Client, Application, Debugger
* From DOS type 'INSTALL' from the CD ROM drive
      DCE - distributed computing environment
* From OS/2 type 'INSTALL' from the CD ROM drive
Note: the disks you create will be put into your A drive


  The products on the PDK are listed by category in the section
From OS/2 you will see a menu.
  << What Other Products are on the PDK >>, and a '*' next to the name
:select: 'Beta IBM OS/2 2.1'
  indicates it is NEW for the 2/93 PDK.
:Click on the '+' sign to find the subcategories of
::'OS2CD35' to make 2-OS/2 2.1 3.5" 1.44 Meg disks
::or 'OS2CD525' to make 2-OS/2 2.1 5.25" 1.2 Meg disks
:Click on one of the these to highlight
:Click on 'Add' to choose this


  For a history file of changes with each new PDK, please see HISTORY.FIL
From DOS you will see the syntax for install command.
  in the root directory.
:You will type either 'install 3.5' or 'install 5.25' depending on the size of your A drive.


2) On the 'Welcome to OS/2 Screen' you will see a message that you need OS/2 diskettes 1 through 14 to complete installation. You may ignore this message and press enter to continue installing from the CD ROM. The screens that appear are the same as the OS/2 2.0 install screens but you are installing from CD ROM rather than diskettes.


If you are installing from 5.25" diskettes ONLY, on the Installation Drive Selection screen:
:you MUST choose 1) Accept the drive.
:DO NOT choose 2) Specify a different drive or partition (it won't work and you will get an error message)


3) On the OS/2 'Setup and Installation' Screen, you may choose any of the following system installs (#MB denotes hard disk space needed):
:'Select features and Install'- 20MB - for minimum system (make sure you INCLUDE REXX- everything else can be de-selected)
:'Install Preselected Features' - 32MB - install the most commonly used OS/2 features
:'Install All Features' - 40MB


4) IGNORE the final OS/2 Setup and Installation screen, which says 'Remove the diskette from Drive A and Press Enter to restart your system'.


INSTEAD, press CTL-ALT-DEL to restart your system'. (Make sure that the diskette has been removed from Drive A).


5) It is important that when OS/2 starts up for the first time YOU DO A 'SHUTDOWN'. To do this, as soon as the disk light turns off and the desktop appears set up, please do a 'SHUTDOWN'. Follow the message to restart your system. Note: When OS/2 starts up for the first time, it must build the desktop. You want to ensure that this desktop gets saved, so we recommend that you immediately do a SHUTDOWN.


Making OS/2 2.1 Diskettes (OS/2 System Users):


1) From OS/2 type 'INSTALL' from the CD ROM drive


                            <<  SUPPORT  >>
Note: the disks you create will be used in your A drive, so make sure you choose the correct density


    The products provided on this CD ROM are beta level and are provided
:From OS/2 you will see a menu.
    'AS IS'.  There is no warranty or service implied with respect to the
::select: 'Beta IBM OS/2 2.1'
    program(s) included. You may monitor CompuServe for any information
::Click on the '+' sign to find the subcategories of
    related to this beta product. Your comments/problems may be submitted
:::'OS235' to make 27 OS/2 2.1 3.5" 1.44 Meg disks
    only via CompuServe and will be appreciated and forwarded to the
:::or 'OS2525' to make 32 OS/2 2.1 5.25" 1.2 Meg disks
    appropriate personnel for consideration in the next release.
::Click on one of the these to highlight
    Pls INCLUDE THE LEVEL of PDK with your comments (9/92-white label with no
::Click on 'Add' to choose this
    date, 10/92-dated silver label, 11/92-dated blue label, 02/93 dated
    coral label).


    CompuServe users should enter 'GO OS2DF2', Section 12 Developer's CD
2) Follow the procedure on OS/2 2.1 CD ROM Install starting with Step 2
    ROM.  (Due to restructuring of CompuServe, all references on this PDK
    to 'GO OS2DEV' should be updated to 'GO OS2DF2') If you are not a
    member of CompuServe, please call 1-800-524-3388 and ask for
    representative #239 for a free introductory membership.


Making OS/2 2.1 Diskettes (DOS System Users):
:1) Please read DOSINFO.TXT to create the diskettes
:2) Follow the procedure on OS/2 2.1 CD ROM Install starting with Step 2


                          << HELPFUL HINTS >>
==What Else Is on the PDK?==
Note:  If you see the word 'Install' in the description, it means you will be installing from the CD ROM directly onto your hardfile. If you see the word 'Make...diskettes' you will be creating diskettes, and can install from the diskettes.


  1.It is important to read any README files about the products before
From the CD ROM drive, type 'INSTALL' and select the products you want to install on your hardfile. (Please read helpful hint 1.) The CHOICES ARE:
    you use them.  Please make sure you check for README files after you
    have installed products from the CD ROM, or from the diskettes you created.


  2.Many of the products that get installed from this PDK will have their
===Beta IBM OS/2 2.1===
    own icons and will be placed in the ISV Tools folder on your desktop.
.. this will install OS/2 beta from CD ROM (you must create 2-1.44MB or 2-1.2MB install diskettes) or will create OS/2 2.1 diskettes
    Also, when you go into the PDK Information folder, do an ARRANGE
    to place the ICONS in a readable order.


  3.The install program works with the following rules.  Choose a
See above information.
    title and click on the '+' sign to see the subcategories. (Clicking on the
    '-' sign will shrink this list).  Highlight the subcategory by clicking
    on it.  Then choose 'Add' at the bottom of the screen.  You can also
    click on 'Info' to get a description of the product you highlighted.


  4.During the install, if you notice an error with UNPACK.EXE, you may
===Communications Tools===
     not have enough disk space to install the application. Also, each
    APPCGAME    Install APPC Games
     installation package works differently.  If any error occurs on
    APPCUTIL    Install APPC Utilities (PING, TELL, Remote Execution)
     install, please check free space FIRST to make sure you have sufficient
*  COMMGRCSD  Make Communications Manager Client Server diskettes
     hardfile space. Do not install any of the productivity tools into the
     COMMGRSUD  Make Communications Manager Single User diskettes
     root directory of any drive.
*  COMMGRXPP  Make Communications Manager Applications diskettes
*  COMMGRZBG  Make Communications Manager Debugger diskettes
* COMMGRCS    Install Communications Manager Client Server
     COMMGRSU    Install Communications Manager Single User
     DBMRPW      Install Remote Password Administrator Utility
     DIRSTAT    Install LAN Adapter DirStatus
*  IBMDCE      Make Distributed Computing Environment diskettes
*  MPTS        Make Multi-Protocol Transport Services diskettes
* NSDOS      Make NetWork Services DOS (NSDOS) diskettes
     NWWK        Make NetWare Workstation Kit for OS/2 2.1 diskettes
    PMFTRM      Install ASYNC terminal emulator
    TCP        Make TCP/IP Communications Suite diskettes


  5.Please leave the PDK in the CD ROM drive while you are using
===Development Tools===
     products on the PDK, even though you may not be accessing the PDK.
    ALPHAL      Install Code browser and analysis tool
    ASDT32      Install Application/System Debug Tool (ASDT32)
*  CTFORMAT    Install code and test formatter
    CPPBETA    Make C Set/2 C++ diskettes **
    CPPBETIN    Install C Set/2 C++ diskettes **
    DBGK6479    Make Toolkit Kernel Debugger for OS/2 2.1 diskettes
    DBUGKINS    Install Toolkit Kernel Debugger for OS/2 2.1
    EDITINI    Install Simple Profile Editor for OS/2 2.1
    FORBROWS    Install a PM forum (Bulletin Board) browsing tool
    HEXDMP      Install a binary data display and conversion utility
    IBROW      Install Image browser, using the image toolkit
    OS2TK21    Make Developer's Toolkit for OS/2 2.1 diskettes
    OS2TKINS    Install Developer's Toolkit for OS/2 2.1
*  PEN-PM      Install Pen-PM
*  PENPM      Make Pen-PM diskettes
    PMPRTF      Install 32bit Printf programming support
*  REXXAPPC    Install REXX APPC
*  REXXMATH    Install REXX Math
*  REXXNETB    Install REXX Net Bios
*  SOMII      Make System Object Modules (SOM) diskettes
     VIEWALL    Install a tool that presents all the books on the bookshelf
    VREXX      Install Visual REXX
    WRKF        Make WorkFrame/2 diskettes
    WRKFINS    Install WorkFrame/2


  6.If you install OS/2, C++, and TOOLKT20 from the PDK, you will find
** The license agreement for C++ expires April 15, 1993. Do not use after this date.
    a number of different LINK386.exe file.
C++ DOES NOT include the USL Class libraries (such as iostream, complex and task). In the U.S., the USL Class libraries can be purchased separately for a nominal charge, by calling
1-800-3IBM-OS2 and requesting the USL Class libraries. For other geographies, members of the current DAP program should contact their IBM OS/2 DAP representative, and members of the WorldWide DAP program should monitor CompuServe for information regarding acquisition of the USL Class libraries as soon as fulfillment in these geographies is available.


    The Beta version of LINK386 from the Install menu should be used
===Documentation===
    when the using C++ compiler, since this version has additional
.. Icons are created on your desktop for the various documents. On line docs will use either Library Reader/2 (.BOO format) or VIEW (.INF format). Library Reader/2 does not get installed on your hardfile, it stays on the CD. For more information on individual documents that are listed below, highlight the choice and press the "Info" button. If the document is something you are interested in reading, press the "Add" button and an icon will be created in the PDKINFO folder that allows you access to the document without copying it to your hardfile.
    support for the C++ class extension. Check your CONFIG.SYS to
    make sure that you are pointing to the correct Linker.


      NOTE: You must ensure that the IBMC\BIN directory occurs before
    CCPPINFO    IBM C/C++ Information
      the TOOLKT20\OS2BIN directory in the PATH statement. Also, the
    CMINFO      Communications Manager Information
      recommended order of installation should still be followed to ensure
    DBMINFO    Database Manager (ES 1.0) Information
      that the EPM /H context sensitive help, and WorkFrame/2, C Set/2
    EPMINFO    Enhanced Editor Information
      support function correctly. The recommended order of installation
    LR2INFO    Library Reader/2 Information
      is Toolkit, WorkFrame/2, then C Set/2.
    LSINFO      LAN Server 3.0 Information
    MMPMINFO    Multimedia Presentation Manager/2 Information
    MOS2INFO    Miscellaneous OS/2 Information
    REDBOOKS    OS/2 Version 2.0 Technical Compendium ("Redbooks")
    REXXINFO    REXX Programming Interfaces
    TCPINFO    TCP/IP Version 1.2.1 for OS/2 Information
    TKINFO      OS/2 2.0 Technical Library (Toolkit Information)
*  USING OS/2 Tips and Techniques on Using OS/2 2.1


                        <<< INSTALLING OS/2 >>>
===Editors===
    EPM        Install updated version of the Enhanced Editor with macro support
*  HYPWRITE    Install HyperWrite Editor
*  SLICK      Install Slick Editor Demo
    TINYED      Install Tiny OS/2 and DOS editor


===Multimedia Products===
    CDEXPL      Install a compact disc digital audio explorer
    MMPM2TK    Install Multimedia Presentation Manager Toolkit and Base
    MMPM35      Make Multimedia Presentation Manager Base 3.5" diskettes
    MMPM525    Make Multimedia Presentation Manager Base 5.25" diskettes


   From CD ROM (both DOS and OS/2 System Users):
===Productivity Tools===
    DINFO      Install utility to Monitor your SWAPPER.DAT file
    GPSCLOCK   Install Simple Digital Clock for OS/2 1.3+
    IPFCPP      Install IPFC Pre-processor
    MAGNIFY    Install a PM magnifying glass
*  PMDCLIP    Install ClipArt for PMDraw
    PMDRAW      Install Drawing tool for creating foils and presentations
*  PMDRAWSamp  Sample PMDRAW images
    PMGLOBE    Install an OS/2 Presentation Manager World Globe
    PMTIMER    Install utility to time execution of programs
    PMTREE      Install Graphical display of/interaction with PM windows
*  QCONFIG    Install System Configuration Utility
    SCRAP      Install Screen capture utility, using the image toolkit
    TXT2PS      Install Printer filter to convert plain ASCII files to PS


    In order to install OS/2 from the CD ROM drive both your SCSI adapter
===Test Tools===
    and your CD ROM drive must be supported under OS/2. If these are not
  *  PMATE      Install PMATE Test Tool
    supported under OS/2 you can create the OS/2 diskettes through DOS
    support -- see text file called DOSINFO.TXT.


    You will need 2 blank 1.44MB- 3.5" (or 1.2 MB- 5.25") diskettes to create
==Procedure to install Communications Manager from CD ROM==
    'OS/2 Installation Diskette' and 'Operating System/2 Diskette 1' (DISK 1).
If you choose to install OS/2 Communications Manager from the CD ROM, you will encounter INVALID error messages. The following is the procedure and the workaround to successfully install.
    (Since this is beta code, is recommended that you place OS/2 2.1 in a
    separate partition on your hardfile rather than installing over OS/2
    2.0 GA level).


1) You want to install COMMUNICATIONS MANAGER FROM the CD ROM


    1) To create the install disks:
:Choose COMMRCS or COMMGRSU from the menu
                -From DOS type 'INSTALL' from the CD ROM drive
::'Install IBM Beta Version Products from the CD ROM'
                -From OS/2 type 'INSTALL' from the CD ROM drive
::The first screen you see is a configuring screen, ....
        Note: the disks you create will be put into your A drive
::The IBM logo screen appears, click OK.
::A window will appear saying that you are copying temporary product files.
::You will see an Installation Notes screen.  Click OK.
::If you are installing Client/Server you will see a selection window to determine if you are a Client or Server.
::You will then be asked to select your TARGET DRIVE. Choose your target drive and Click on OK.


        From OS/2 you will see a menu.
2) The Communications Manager Setup window.
          select:    'Beta IBM OS/2 2.1'
          Click on the '+' sign to find the subcategories of
                        'OS2CD35'  to make 2-OS/2 2.1 3.5" 1.44 Meg disks
                or    'OS2CD525' to make 2-OS/2 2.1 5.25" 1.2 Meg disks
          Click on one of the these to highlight
          Click on 'Add' to choose this


        From DOS you will see the syntax for install command.
:You will then see the Communications Manager Setup window.
            You will type either 'install 3.5' or 'install 5.25' depending
::Click on CLOSE in the Communications Manager Setup Window
            on the size of your A drive.
::You will then be asked if you 'Want to install Communications Manager Setup before Closing'. Click on YES
::At the end of the process, the Communications Manager Completion window pops up.  Select CLOSE on this Window
::Note:  If you select either the Installation or Setup pushbuttons you will encounter an error opening the configuration file.


    2) On the 'Welcome to OS/2 Screen' you will see a message that you
3) Perform a Shutdown and Reboot
        need OS/2 diskettes 1 through 14 to complete installation. You
:At this point perform a SHUTDOWN, and reboot your system.
        may ignore this message and press enter to continue installing from
:When your system comes up, change to the drive and subdirectory with CMLIB.
        the CD ROM. The screens that appear are the same as the OS/2 2.0
:type 'CMSETUP' (to bring up the Communications Manager Setup window)
        install screens but you are installing from CD ROM rather than
:Click on OK at the logo.
        diskettes.
:The Communications Manager Setup window appears, and click on SETUP.


4) You will be asked to choose your source drive.
:The drive that the PDK is in and directory that Communications Manager is in should be defaulted.


        If you are installing from 5.25" diskettes ONLY, on
5) Continue with the INSTALL
        the Installation Drive Selection screen:
:You will then see the OPEN Configuration window with the cursor pointing to the Configuration File name. Enter the Configuration File name on that line and Continue with the INSTALL.
              you MUST choose 1) Accept the drive.
:Note: if you require further information on installing Communications Manager, please check the Communications Manager on-line documentation.
              DO NOT choose 2) Specify a different drive or partition
              (it won't work and you will get an error message)


6) After completing your configuration, you will see a window: 'Please wait, verifying configuration values' and then the Install window will appear. Select the OK pushbutton and continue.
:You will see a completion window that says you must restart your workstation to enable your changes. Select the CLOSE pushbutton on this window.
:Select the CLOSE pushbutton on the CMSETUP window. Shutdown your workstation.


    3) On the OS/2 'Setup and Installation' Screen, you may choose any of
7) To start communications, select the 'Start Communications' icon from the 'Communications Manager' group.
        the following system installs (#MB denotes hard disk space needed):
            'Select features and Install'- 20MB - for minimum system (make
                                          sure you INCLUDE REXX- everything
                                          else can be de-selected)


            'Install Preselected Features' - 32MB - install the most commonly
==Important information on DCE==
                                          used OS/2 features
Before you create the DCE diskettes and use DCE, you must read the README.DCE on the PDK. You can find it in the subdirectory COMM\DCE on your CD ROM drive.


            'Install All Features' - 40MB
==PM Debug Considerations==
The Debug version of the PM subsystem contains an IRQ 3 at the start of initialization. A terminal emulator should be attached so the operator can step over this break-point.


==Important information on C++==
The IBM C/C++ compiler shipped on this CD ROM contains modified versions of the OS/2 Toolkit 2.0 header files. If you will be using the 2.0 toolkit, then you can ignore the rest of these instructions. If you will be using the 2.1 toolkit also provided on this CD ROM, you will need to make similar changes to those versions of the header files for use with the compiler.  Here is what you need to do after having installed both the compiler and the 2.1 Toolkit:


    4) IGNORE the final OS/2 Setup and Installation screen, which says
1. Rename the OS2.H, BSEDOS.H, and OS2DEF.H header files found in the x:\ibmcpp\INCLUDE directory in order to preserve them.
        'Remove the diskette from Drive A and Press Enter to restart your
        system'.


        INSTEAD, press CTL-ALT-DEL to restart your system'. (Make sure
2. Copy the OS2.H, BSEDOS.H and OS2DEF.H header files from the 2.1 Toolkit (should be in the \toolkt20\c\os2h directory) to the x:\ibmcpp\INCLUDE directory.
        that the diskette has been removed from Drive A).


    5) It is important that when OS/2 starts up for the first time YOU DO
3. Modify the 3 files by doing the following:
        A 'SHUTDOWN'. To do this, as soon as the disk light turns off and
:a) In BSEDOS.H, change the word 'class' to 'pclass' on line 199.
        the desktop appears set up, please do a 'SHUTDOWN'.  Follow the
:b) In OS2DEF.H, delete the five occurances of the word 'unsigned' from lines 91 to 97 and change '((void *) 0)' to '0' on line 61
         message to restart your system. NoteWhen OS/2 starts up for the
:c) In OS2.H, add the following four lines between lines 38 and 39
        first time, it must build the desktop. You want to ensure that
  #ifdef __cplusplus
        this desktop gets saved, so we recommend that you immediately do a
         }
        SHUTDOWN.
  #endif
:and add the following four lines between lines 23 and 24
#ifdef __cplusplus
      extern "C" {
  #endif
:Note that one of the lines is blank in each case (just for readability). Also note that they are added in the order above in order not to mess up the line numbers of subsequent inserts.


 
[[Category:Information]]
  Making OS/2 2.1 Diskettes (OS/2 System Users):
 
    1) From OS/2 type 'INSTALL' from the CD ROM drive
        Note: the disks you create will be used in your A drive, so make
              sure you choose the correct density
 
        From OS/2 you will see a menu.
          select:    'Beta IBM OS/2 2.1'
          Click on the '+' sign to find the subcategories of
                        'OS235'  to make 27 OS/2 2.1 3.5" 1.44 Meg disks
                or    'OS2525' to make 32 OS/2 2.1 5.25" 1.2 Meg disks
          Click on one of the these to highlight
          Click on 'Add' to choose this
 
 
    2) Follow the procedure on OS/2 2.1 CD ROM Install starting with Step 2
 
 
  Making OS/2 2.1 Diskettes (DOS System Users):
 
    1) Please read DOSINFO.TXT to create the diskettes
 
    2) Follow the procedure on OS/2 2.1 CD ROM Install starting with Step 2
 
 
 
                  <<< WHAT ELSE IS ON THE PDK?  >>>
 
 
      Note:  If you see the word 'Install' in the description, it means
      you will be installing from the CD ROM directly onto your hardfile.
      If you see the word 'Make...diskettes' you will be creating
      diskettes, and can install from the diskettes.
 
 
      From the CD ROM drive, type 'INSTALL' and select the products
      you want to install on your hardfile.  (Please read helpful hint
      1.) The CHOICES ARE:
 
    1.<< Beta IBM OS/2 2.1 >>
          .. this will install OS/2 beta from CD ROM (you must
            create 2-1.44MB or 2-1.2MB install diskettes) or will create
            OS/2 2.1 diskettes
      See above information.
 
 
 
    2.<< Communications Tools >>
 
 
      APPCGAME    Install APPC Games
      APPCUTIL    Install APPC Utilities (PING, TELL, Remote Execution)
    *  COMMGRCSD  Make Communications Manager Client Server diskettes
      COMMGRSUD  Make Communications Manager Single User diskettes
    *  COMMGRXPP  Make Communications Manager Applications diskettes
    *  COMMGRZBG  Make Communications Manager Debugger diskettes
    *  COMMGRCS    Install Communications Manager Client Server
      COMMGRSU    Install Communications Manager Single User
      DBMRPW      Install Remote Password Administrator Utility
      DIRSTAT    Install LAN Adapter DirStatus
    *  IBMDCE      Make Distributed Computing Environment diskettes
    *  MPTS        Make Multi-Protocol Transport Services diskettes
    *  NSDOS      Make NetWork Services DOS (NSDOS) diskettes
      NWWK        Make NetWare Workstation Kit for OS/2 2.1 diskettes
      PMFTRM      Install ASYNC terminal emulator
      TCP        Make TCP/IP Communications Suite diskettes
 
    3.<< Development Tools >>
 
      ALPHAL      Install Code browser and analysis tool
      ASDT32      Install Application/System Debug Tool (ASDT32)
    *  CTFORMAT    Install code and test formatter
      CPPBETA    Make C Set/2 C++ diskettes **
      CPPBETIN    Install C Set/2 C++ diskettes **
      DBGK6479    Make Toolkit Kernel Debugger for OS/2 2.1 diskettes
      DBUGKINS    Install Toolkit Kernel Debugger for OS/2 2.1
      EDITINI    Install Simple Profile Editor for OS/2 2.1
      FORBROWS    Install a PM forum (Bulletin Board) browsing tool
      HEXDMP      Install a binary data display and conversion utility
      IBROW      Install Image browser, using the image toolkit
      OS2TK21    Make Developer's Toolkit for OS/2 2.1 diskettes
      OS2TKINS    Install Developer's Toolkit for OS/2 2.1
    *  PEN-PM      Install Pen-PM
    *  PENPM      Make Pen-PM diskettes
      PMPRTF      Install 32bit Printf programming support
    *  REXXAPPC    Install REXX APPC
    *  REXXMATH    Install REXX Math
    *  REXXNETB    Install REXX Net Bios
    *  SOMII      Make System Object Modules (SOM) diskettes
      VIEWALL    Install a tool that presents all the books on the bookshelf
      VREXX      Install Visual REXX
      WRKF        Make WorkFrame/2 diskettes
      WRKFINS    Install WorkFrame/2
 
 
    **  The license agreement for C++ expires April 15, 1993.  Do not use
        after this date.
        C++ DOES NOT include the USL Class libraries (such as iostream,
        complex and task).  In the U.S., the USL Class libraries can be
        purchased separately for a nominal charge, by calling
        1-800-3IBM-OS2 and requesting the USL Class libraries.  For other
        geographies, members of the current DAP program should contact
        their IBM OS/2 DAP representative, and members of the WorldWide DAP
        program should monitor CompuServe for information regarding
        acquisition of the USL Class libraries as soon as fulfillment in
        these geographies is available.
 
 
 
    4.<< Documentation >>
 
          .. Icons are created on your desktop for the various
            documents.  On line docs will use either Library Reader/2
            (.BOO format) or VIEW (.INF format).  Library Reader/2 does
            not get installed on your hardfile, it stays on the CD.  For
            more information on individual documents that are listed
            below, highlight the choice and press the "Info" button.  If
            the document is something you are interested in reading, press
            the "Add" button and an icon will be created in the PDKINFO
            folder that allows you access to the document without copying
            it to your hardfile.
 
      CCPPINFO    IBM C/C++ Information
      CMINFO      Communications Manager Information
      DBMINFO    Database Manager (ES 1.0) Information
      EPMINFO    Enhanced Editor Information
      LR2INFO    Library Reader/2 Information
      LSINFO      LAN Server 3.0 Information
      MMPMINFO    Multimedia Presentation Manager/2 Information
      MOS2INFO    Miscellaneous OS/2 Information
      REDBOOKS    OS/2 Version 2.0 Technical Compendium ("Redbooks")
      REXXINFO    REXX Programming Interfaces
      TCPINFO    TCP/IP Version 1.2.1 for OS/2 Information
      TKINFO      OS/2 2.0 Technical Library (Toolkit Information)
    *  USING OS/2  Tips and Techniques on Using OS/2 2.1
 
    5.<< Editors >>
 
      EPM        Install updated version of the Enhanced Editor with
                  macro support
    *  HYPWRITE    Install HyperWrite Editor
    *  SLICK      Install Slick Editor Demo
      TINYED      Install Tiny OS/2 and DOS editor
 
    6.<< Multimedia Products >>
 
      CDEXPL      Install a compact disc digital audio explorer
      MMPM2TK    Install Multimedia Presentation Manager Toolkit and Base
      MMPM35      Make Multimedia Presentation Manager Base 3.5" diskettes
      MMPM525    Make Multimedia Presentation Manager Base 5.25" diskettes
 
 
    7.<< Productivity Tools >>
 
      DINFO      Install utility to Monitor your SWAPPER.DAT file
      GPSCLOCK    Install Simple Digital Clock for OS/2 1.3+
      IPFCPP      Install IPFC Pre-processor
      MAGNIFY    Install a PM magnifying glass
  *  PMDCLIP    Install ClipArt for PMDraw
      PMDRAW      Install Drawing tool for creating foils and presentations
  *  PMDRAWSamp  Sample PMDRAW images
      PMGLOBE    Install an OS/2 Presentation Manager World Globe
      PMTIMER    Install utility to time execution of programs
      PMTREE      Install Graphical display of/interaction with PM windows
  *  QCONFIG    Install System Configuration Utility
      SCRAP      Install Screen capture utility, using the image toolkit
      TXT2PS      Install Printer filter to convert plain ASCII files to PS
 
 
    4.<< Test Tools >>
 
  *  PMATE      Install PMATE Test Tool
 
 
      << Procedure to install Communications Manager from CD ROM >>
 
    If you choose to install OS/2 Communications Manager from the CD ROM,
    you will encounter INVALID error messages.  The following is the
    procedure and the workaround to successfully install.
 
1) You want to install COMMUNICATIONS MANAGER FROM the CD ROM
 
    Choose COMMRCS or COMMGRSU from the menu
 
    'Install IBM Beta Version Products from the CD ROM'
 
 
    The first screen you see is a configuring screen, ....
 
    The IBM logo screen appears, click OK.
    A window will appear saying that you are copying temporary product
    files.
 
    You will see an Installation Notes screen.  Click OK.
 
    If you are installing Client/Server you will see a selection
    window to determine if you are a Client or Server.
 
    You will then be asked to select your TARGET DRIVE.  Choose your target
    drive and Click on OK.
 
 
 
 
2) The Communications Manager Setup window.
 
    You will then see the Communications Manager Setup window.
 
    Click on CLOSE in the Communications Manager Setup Window
 
    You will then be asked if you 'Want to install Communications Manager
    Setup before Closing'.  Click on YES
 
    At the end of the process, the Communications Manager Completion
    window pops up.  Select CLOSE on this Window
 
    Note:  If you select either the Installation or Setup pushbuttons
    you will encounter an error opening the configuration file.
 
 
 
3) Perform a Shutdown and Reboot
 
    At this point perform a SHUTDOWN, and reboot your system.
 
    When your system comes up, change to the drive and subdirectory
    with CMLIB.
 
      type 'CMSETUP' (to bring up the Communications Manager Setup window)
 
    Click on OK at the logo.
 
    The Communications Manager Setup window appears, and click on SETUP.
 
 
4) You will be asked to choose your source drive.
 
    The drive that the PDK is in and directory that Communications
    Manager is in should be defaulted.
 
 
5) Continue with the INSTALL
 
    You will then see the OPEN Configuration window with the cursor
    pointing to the Configuration File name.  Enter the Configuration
    File name on that line and Continue with the INSTALL.
 
    Note: if you require further information on installing Communications
    Manager, please check the Communications Manager on-line documentation.
 
6) After completing your configuration, you will see a window: 'Please
    wait, verifying configuration values' and then the Install window will
    appear.  Select the OK pushbutton and continue.
 
    You will see a completion window that says you must restart your
    workstation to enable your changes.  Select the CLOSE pushbutton
    on this window.
 
    Select the CLOSE pushbutton on the CMSETUP window.  Shutdown
    your workstation.
 
7) To start communications, select the 'Start Communications' icon from
    the 'Communications Manager' group.
 
 
 
                    << Important information on DCE >>
 
    Before you create the DCE diskettes and use DCE, you must read the
    README.DCE on the PDK.  You can find it in the subdirectory COMM\DCE on
    your CD ROM drive.
 
 
                    << PM Debug Considerations >>
 
    The Debug version of the PM subsystem contains an IRQ 3 at the start
    of initialization.  A terminal emulator should be attached so the
    operator can step over this break-point.
 
 
                    << Important information on C++ >>
 
 
    The IBM C/C++ compiler shipped on this CD ROM contains modified
    versions of the OS/2 Toolkit 2.0 header files.  If you will be using
    the 2.0 toolkit, then you can ignore the rest of these instructions.
    If you will be using the 2.1 toolkit also provided on this CD ROM, you
    will need to make similar changes to those versions of the header files
    for use with the compiler.  Here is what you need to do after having
    installed both the compiler and the 2.1 Toolkit:
 
1.  Rename the OS2.H, BSEDOS.H, and OS2DEF.H header files found in
    the x:\ibmcpp\INCLUDE directory in order to preserve them.
 
 
2.  Copy the OS2.H, BSEDOS.H and OS2DEF.H header files from the 2.1
    Toolkit (should be in the \toolkt20\c\os2h directory) to the
    x:\ibmcpp\INCLUDE directory.
 
3.  Modify the 3 files by doing the following:
    a)  In BSEDOS.H, change the word 'class' to 'pclass' on line 199.
    b)  In OS2DEF.H, delete the five occurances of the word 'unsigned'
        from lines 91 to 97 and change '((void *) 0)' to '0' on line 61
    c)  In OS2.H, add the following four lines between lines 38 and 39
                #ifdef __cplusplus
                    }
                #endif
 
        and add the following four lines between lines 23 and 24
                #ifdef __cplusplus
                    extern "C" {
                #endif
 
        Note that one of the lines is blank in each case (just for
        readability).  Also note that they are added in the order above
        in order not to mess up the line numbers of subsequent inserts.

Latest revision as of 14:33, 5 May 2024

Introduction

This is the 02/93 limited edition version of the Professional Developers Kit (PDK) CD ROM. It contains a Beta release of OS/2 2.1 with WIN-OS/2 Version 3.1, C++, PL/I, Communications Manager, including the new client server version, DCE (Distributed Computing Environment), PEN PM, Visual REXX, OS/2 Redbooks and Technical Library, HyperWrite information developer, PMate automated test tool, Productivity Tools, etc. This Kit is targeted for experienced developers. The OS/2 Developers Toolkit and Kernel Debugger have been matched with the level of OS/2 2.1 on this PDK. Some of the products on this PDK may not have been tested with this level of the operating system.

Changes in the 02/93 Version of the PDK

Some of the new products on this PDK include:

OS/2 2.1-install from CD, plus 3.5" and 5.25" diskette images COMM Manager Client, Application, Debugger DCE - distributed computing environment

The products on the PDK are listed by category in the section << What Other Products are on the PDK >>, and a '*' next to the name indicates it is NEW for the 2/93 PDK.

For a history file of changes with each new PDK, please see HISTORY.FIL in the root directory.

Support

The products provided on this CD ROM are beta level and are provided 'AS IS'. There is no warranty or service implied with respect to the program(s) included. You may monitor CompuServe for any information related to this beta product. Your comments/problems may be submitted only via CompuServe and will be appreciated and forwarded to the appropriate personnel for consideration in the next release. Pls INCLUDE THE LEVEL of PDK with your comments (9/92-white label with no date, 10/92-dated silver label, 11/92-dated blue label, 02/93 dated coral label).

CompuServe users should enter 'GO OS2DF2', Section 12 Developer's CD ROM. (Due to restructuring of CompuServe, all references on this PDK to 'GO OS2DEV' should be updated to 'GO OS2DF2') If you are not a member of CompuServe, please call 1-800-524-3388 and ask for representative #239 for a free introductory membership.

Helpful Hints

  1. It is important to read any README files about the products before you use them. Please make sure you check for README files after you have installed products from the CD ROM, or from the diskettes you created.
  2. Many of the products that get installed from this PDK will have their own icons and will be placed in the ISV Tools folder on your desktop. Also, when you go into the PDK Information folder, do an ARRANGE to place the ICONS in a readable order.
  3. The install program works with the following rules. Choose a title and click on the '+' sign to see the subcategories. (Clicking on the '-' sign will shrink this list). Highlight the subcategory by clicking on it. Then choose 'Add' at the bottom of the screen. You can also click on 'Info' to get a description of the product you highlighted.
  4. During the install, if you notice an error with UNPACK.EXE, you may not have enough disk space to install the application. Also, each installation package works differently. If any error occurs on install, please check free space FIRST to make sure you have sufficient hardfile space. Do not install any of the productivity tools into the root directory of any drive.
  5. Please leave the PDK in the CD ROM drive while you are using products on the PDK, even though you may not be accessing the PDK.
  6. If you install OS/2, C++, and TOOLKT20 from the PDK, you will find a number of different LINK386.exe file.

The Beta version of LINK386 from the Install menu should be used when the using C++ compiler, since this version has additional support for the C++ class extension. Check your CONFIG.SYS to make sure that you are pointing to the correct Linker.

NOTE: You must ensure that the IBMC\BIN directory occurs before the TOOLKT20\OS2BIN directory in the PATH statement. Also, the recommended order of installation should still be followed to ensure that the EPM /H context sensitive help, and WorkFrame/2, C Set/2 support function correctly. The recommended order of installation is Toolkit, WorkFrame/2, then C Set/2.

Installing OS/2

From CD ROM (both DOS and OS/2 System Users):

In order to install OS/2 from the CD ROM drive both your SCSI adapter and your CD ROM drive must be supported under OS/2. If these are not supported under OS/2 you can create the OS/2 diskettes through DOS support - see text file called DOSINFO.TXT.

You will need 2 blank 1.44MB- 3.5" (or 1.2 MB- 5.25") diskettes to create 'OS/2 Installation Diskette' and 'Operating System/2 Diskette 1' (DISK 1). (Since this is beta code, is recommended that you place OS/2 2.1 in a separate partition on your hardfile rather than installing over OS/2 2.0 GA level).

1) To create the install disks:

  • From DOS type 'INSTALL' from the CD ROM drive
  • From OS/2 type 'INSTALL' from the CD ROM drive

Note: the disks you create will be put into your A drive

From OS/2 you will see a menu.

select: 'Beta IBM OS/2 2.1'
Click on the '+' sign to find the subcategories of
'OS2CD35' to make 2-OS/2 2.1 3.5" 1.44 Meg disks
or 'OS2CD525' to make 2-OS/2 2.1 5.25" 1.2 Meg disks
Click on one of the these to highlight
Click on 'Add' to choose this

From DOS you will see the syntax for install command.

You will type either 'install 3.5' or 'install 5.25' depending on the size of your A drive.

2) On the 'Welcome to OS/2 Screen' you will see a message that you need OS/2 diskettes 1 through 14 to complete installation. You may ignore this message and press enter to continue installing from the CD ROM. The screens that appear are the same as the OS/2 2.0 install screens but you are installing from CD ROM rather than diskettes.

If you are installing from 5.25" diskettes ONLY, on the Installation Drive Selection screen:

you MUST choose 1) Accept the drive.
DO NOT choose 2) Specify a different drive or partition (it won't work and you will get an error message)

3) On the OS/2 'Setup and Installation' Screen, you may choose any of the following system installs (#MB denotes hard disk space needed):

'Select features and Install'- 20MB - for minimum system (make sure you INCLUDE REXX- everything else can be de-selected)
'Install Preselected Features' - 32MB - install the most commonly used OS/2 features
'Install All Features' - 40MB

4) IGNORE the final OS/2 Setup and Installation screen, which says 'Remove the diskette from Drive A and Press Enter to restart your system'.

INSTEAD, press CTL-ALT-DEL to restart your system'. (Make sure that the diskette has been removed from Drive A).

5) It is important that when OS/2 starts up for the first time YOU DO A 'SHUTDOWN'. To do this, as soon as the disk light turns off and the desktop appears set up, please do a 'SHUTDOWN'. Follow the message to restart your system. Note: When OS/2 starts up for the first time, it must build the desktop. You want to ensure that this desktop gets saved, so we recommend that you immediately do a SHUTDOWN.

Making OS/2 2.1 Diskettes (OS/2 System Users):

1) From OS/2 type 'INSTALL' from the CD ROM drive

Note: the disks you create will be used in your A drive, so make sure you choose the correct density

From OS/2 you will see a menu.
select: 'Beta IBM OS/2 2.1'
Click on the '+' sign to find the subcategories of
'OS235' to make 27 OS/2 2.1 3.5" 1.44 Meg disks
or 'OS2525' to make 32 OS/2 2.1 5.25" 1.2 Meg disks
Click on one of the these to highlight
Click on 'Add' to choose this

2) Follow the procedure on OS/2 2.1 CD ROM Install starting with Step 2

Making OS/2 2.1 Diskettes (DOS System Users):

1) Please read DOSINFO.TXT to create the diskettes
2) Follow the procedure on OS/2 2.1 CD ROM Install starting with Step 2

What Else Is on the PDK?

Note: If you see the word 'Install' in the description, it means you will be installing from the CD ROM directly onto your hardfile. If you see the word 'Make...diskettes' you will be creating diskettes, and can install from the diskettes.

From the CD ROM drive, type 'INSTALL' and select the products you want to install on your hardfile. (Please read helpful hint 1.) The CHOICES ARE:

Beta IBM OS/2 2.1

.. this will install OS/2 beta from CD ROM (you must create 2-1.44MB or 2-1.2MB install diskettes) or will create OS/2 2.1 diskettes

See above information.

Communications Tools

   APPCGAME    Install APPC Games
   APPCUTIL    Install APPC Utilities (PING, TELL, Remote Execution)
*  COMMGRCSD   Make Communications Manager Client Server diskettes
   COMMGRSUD   Make Communications Manager Single User diskettes
*  COMMGRXPP   Make Communications Manager Applications diskettes
*  COMMGRZBG   Make Communications Manager Debugger diskettes
*  COMMGRCS    Install Communications Manager Client Server
   COMMGRSU    Install Communications Manager Single User
   DBMRPW      Install Remote Password Administrator Utility
   DIRSTAT     Install LAN Adapter DirStatus
*  IBMDCE      Make Distributed Computing Environment diskettes
*  MPTS        Make Multi-Protocol Transport Services diskettes
*  NSDOS       Make NetWork Services DOS (NSDOS) diskettes
   NWWK        Make NetWare Workstation Kit for OS/2 2.1 diskettes
   PMFTRM      Install ASYNC terminal emulator
   TCP         Make TCP/IP Communications Suite diskettes

Development Tools

   ALPHAL      Install Code browser and analysis tool
   ASDT32      Install Application/System Debug Tool (ASDT32)
*  CTFORMAT    Install code and test formatter
   CPPBETA     Make C Set/2 C++ diskettes **
   CPPBETIN    Install C Set/2 C++ diskettes **
   DBGK6479    Make Toolkit Kernel Debugger for OS/2 2.1 diskettes
   DBUGKINS    Install Toolkit Kernel Debugger for OS/2 2.1
   EDITINI     Install Simple Profile Editor for OS/2 2.1
   FORBROWS    Install a PM forum (Bulletin Board) browsing tool
   HEXDMP      Install a binary data display and conversion utility
   IBROW       Install Image browser, using the image toolkit
   OS2TK21     Make Developer's Toolkit for OS/2 2.1 diskettes
   OS2TKINS    Install Developer's Toolkit for OS/2 2.1
*  PEN-PM      Install Pen-PM
*  PENPM       Make Pen-PM diskettes
   PMPRTF      Install 32bit Printf programming support
*  REXXAPPC    Install REXX APPC
*  REXXMATH    Install REXX Math
*  REXXNETB    Install REXX Net Bios
*  SOMII       Make System Object Modules (SOM) diskettes
   VIEWALL     Install a tool that presents all the books on the bookshelf
   VREXX       Install Visual REXX
   WRKF        Make WorkFrame/2 diskettes
   WRKFINS     Install WorkFrame/2
** The license agreement for C++ expires April 15, 1993. Do not use after this date.

C++ DOES NOT include the USL Class libraries (such as iostream, complex and task). In the U.S., the USL Class libraries can be purchased separately for a nominal charge, by calling 1-800-3IBM-OS2 and requesting the USL Class libraries. For other geographies, members of the current DAP program should contact their IBM OS/2 DAP representative, and members of the WorldWide DAP program should monitor CompuServe for information regarding acquisition of the USL Class libraries as soon as fulfillment in these geographies is available.

Documentation

.. Icons are created on your desktop for the various documents. On line docs will use either Library Reader/2 (.BOO format) or VIEW (.INF format). Library Reader/2 does not get installed on your hardfile, it stays on the CD. For more information on individual documents that are listed below, highlight the choice and press the "Info" button. If the document is something you are interested in reading, press the "Add" button and an icon will be created in the PDKINFO folder that allows you access to the document without copying it to your hardfile.

   CCPPINFO    IBM C/C++ Information
   CMINFO      Communications Manager Information
   DBMINFO     Database Manager (ES 1.0) Information
   EPMINFO     Enhanced Editor Information
   LR2INFO     Library Reader/2 Information
   LSINFO      LAN Server 3.0 Information
   MMPMINFO    Multimedia Presentation Manager/2 Information
   MOS2INFO    Miscellaneous OS/2 Information
   REDBOOKS    OS/2 Version 2.0 Technical Compendium ("Redbooks")
   REXXINFO    REXX Programming Interfaces
   TCPINFO     TCP/IP Version 1.2.1 for OS/2 Information
   TKINFO      OS/2 2.0 Technical Library (Toolkit Information)
*  USING OS/2  Tips and Techniques on Using OS/2 2.1

Editors

   EPM         Install updated version of the Enhanced Editor with macro support
*  HYPWRITE    Install HyperWrite Editor
*  SLICK       Install Slick Editor Demo
   TINYED      Install Tiny OS/2 and DOS editor

Multimedia Products

   CDEXPL      Install a compact disc digital audio explorer
   MMPM2TK     Install Multimedia Presentation Manager Toolkit and Base
   MMPM35      Make Multimedia Presentation Manager Base 3.5" diskettes
   MMPM525     Make Multimedia Presentation Manager Base 5.25" diskettes

Productivity Tools

   DINFO       Install utility to Monitor your SWAPPER.DAT file
   GPSCLOCK    Install Simple Digital Clock for OS/2 1.3+
   IPFCPP      Install IPFC Pre-processor
   MAGNIFY     Install a PM magnifying glass
*  PMDCLIP     Install ClipArt for PMDraw
   PMDRAW      Install Drawing tool for creating foils and presentations
*  PMDRAWSamp  Sample PMDRAW images
   PMGLOBE     Install an OS/2 Presentation Manager World Globe
   PMTIMER     Install utility to time execution of programs
   PMTREE      Install Graphical display of/interaction with PM windows
*  QCONFIG     Install System Configuration Utility
   SCRAP       Install Screen capture utility, using the image toolkit
   TXT2PS      Install Printer filter to convert plain ASCII files to PS

Test Tools

*  PMATE       Install PMATE Test Tool

Procedure to install Communications Manager from CD ROM

If you choose to install OS/2 Communications Manager from the CD ROM, you will encounter INVALID error messages. The following is the procedure and the workaround to successfully install.

1) You want to install COMMUNICATIONS MANAGER FROM the CD ROM

Choose COMMRCS or COMMGRSU from the menu
'Install IBM Beta Version Products from the CD ROM'
The first screen you see is a configuring screen, ....
The IBM logo screen appears, click OK.
A window will appear saying that you are copying temporary product files.
You will see an Installation Notes screen. Click OK.
If you are installing Client/Server you will see a selection window to determine if you are a Client or Server.
You will then be asked to select your TARGET DRIVE. Choose your target drive and Click on OK.

2) The Communications Manager Setup window.

You will then see the Communications Manager Setup window.
Click on CLOSE in the Communications Manager Setup Window
You will then be asked if you 'Want to install Communications Manager Setup before Closing'. Click on YES
At the end of the process, the Communications Manager Completion window pops up. Select CLOSE on this Window
Note: If you select either the Installation or Setup pushbuttons you will encounter an error opening the configuration file.

3) Perform a Shutdown and Reboot

At this point perform a SHUTDOWN, and reboot your system.
When your system comes up, change to the drive and subdirectory with CMLIB.
type 'CMSETUP' (to bring up the Communications Manager Setup window)
Click on OK at the logo.
The Communications Manager Setup window appears, and click on SETUP.

4) You will be asked to choose your source drive.

The drive that the PDK is in and directory that Communications Manager is in should be defaulted.

5) Continue with the INSTALL

You will then see the OPEN Configuration window with the cursor pointing to the Configuration File name. Enter the Configuration File name on that line and Continue with the INSTALL.
Note: if you require further information on installing Communications Manager, please check the Communications Manager on-line documentation.

6) After completing your configuration, you will see a window: 'Please wait, verifying configuration values' and then the Install window will appear. Select the OK pushbutton and continue.

You will see a completion window that says you must restart your workstation to enable your changes. Select the CLOSE pushbutton on this window.
Select the CLOSE pushbutton on the CMSETUP window. Shutdown your workstation.

7) To start communications, select the 'Start Communications' icon from the 'Communications Manager' group.

Important information on DCE

Before you create the DCE diskettes and use DCE, you must read the README.DCE on the PDK. You can find it in the subdirectory COMM\DCE on your CD ROM drive.

PM Debug Considerations

The Debug version of the PM subsystem contains an IRQ 3 at the start of initialization. A terminal emulator should be attached so the operator can step over this break-point.

Important information on C++

The IBM C/C++ compiler shipped on this CD ROM contains modified versions of the OS/2 Toolkit 2.0 header files. If you will be using the 2.0 toolkit, then you can ignore the rest of these instructions. If you will be using the 2.1 toolkit also provided on this CD ROM, you will need to make similar changes to those versions of the header files for use with the compiler. Here is what you need to do after having installed both the compiler and the 2.1 Toolkit:

1. Rename the OS2.H, BSEDOS.H, and OS2DEF.H header files found in the x:\ibmcpp\INCLUDE directory in order to preserve them.

2. Copy the OS2.H, BSEDOS.H and OS2DEF.H header files from the 2.1 Toolkit (should be in the \toolkt20\c\os2h directory) to the x:\ibmcpp\INCLUDE directory.

3. Modify the 3 files by doing the following:

a) In BSEDOS.H, change the word 'class' to 'pclass' on line 199.
b) In OS2DEF.H, delete the five occurances of the word 'unsigned' from lines 91 to 97 and change '((void *) 0)' to '0' on line 61
c) In OS2.H, add the following four lines between lines 38 and 39
#ifdef __cplusplus
       }
#endif
and add the following four lines between lines 23 and 24
#ifdef __cplusplus
     extern "C" {
#endif
Note that one of the lines is blank in each case (just for readability). Also note that they are added in the order above in order not to mess up the line numbers of subsequent inserts.