home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / cset21v3.zip / OS2WF21 / READ.ME < prev    next >
Text File  |  1993-10-21  |  22KB  |  482 lines
  1. ===============================================================================
  2.      IBM* WorkFrame/2* READ.ME file:
  3.  
  4.      IBM WorkFrame/2 Version 2.1
  5.      (C) Copyright IBM Corp., 1991,1993, All Rights Reserved
  6.      US Government Users Restricted Rights - Use, duplication or disclosure
  7.      restricted by GSA ADP Schedule Contract with IBM Corp.
  8. ===============================================================================
  9.  
  10.  
  11. CONTENTS
  12. ________
  13.  
  14.         1. Prerequisites
  15.         2. Installation
  16.         3. Installing from a CD-ROM
  17.         4. Reinstallation
  18.         5. Migration from previous versions of IBM WorkFrame/2 
  19.         6. Tutorial
  20.         7. WorkFrame/2 Considerations and Notes
  21.         8. Considerations and Notes for Using Other Products
  22.  
  23. _______________________________________________________________________________
  24.  
  25.  
  26. 1. PREREQUISITES
  27. ________________
  28.  
  29.    A) OS/2* Version 2.1 product.
  30.  
  31.    B) There are several fixes to the OS/2 product that are strongly recommended.
  32.  
  33.       * A patch is available that fixes a shutdown problem with OS/2, and
  34.         several problems with WorkPlace Shell*.   This fix is available on-line
  35.         from several networks, and is distributed as 21WPSF.ZIP.   The fix
  36.         can also be obtained by contacting the IBM support center, and asking
  37.         for a fix to APAR PJ08727.
  38.  
  39.         If you do not have this fix installed, please ensure you allow the
  40.         shutdown to complete fully, especially during installation of the
  41.         WorkFrame/2 product.   This may take several minutes to complete.
  42.  
  43.       * A fix is also available if you are having trouble installing WorkFrame/2.
  44.         Contact the IBM support center, and ask for a fix to APAR PJ10892.
  45.  
  46.       In North America, you can dial 1-800-237-5511 to contact the support center.
  47.  
  48.  
  49.  
  50. 2. INSTALLATION
  51. ________________
  52.  
  53.      Installation Order
  54.      __________________
  55.  
  56.           If you are installing the products contained in the IBM C Set ++*
  57.           package, the preferred order of installation is:
  58.  
  59.           1. IBM Developer's Toolkit
  60.           2. IBM WorkFrame/2 Version 1.1 (optional)
  61.           3. IBM WorkFrame/2 Version 2.1
  62.           4. IBM C/C++ Tools
  63.           5. Other products that are integrated into the WorkFrame/2 product.
  64.  
  65.           If you install the Toolkit after the WorkFrame/2 product, follow
  66.           these steps to copy the action for the NMAKE.EXE tool into the
  67.           default actions profile.  (Do these steps after both products are
  68.           installed.)
  69.  
  70.           1. Open the "IBM WorkFrame/2 V2.1" folder.
  71.           2. Open the "Actions Profiles" folder.
  72.           3. Open the "Default Actions Profile" and the
  73.              "IBM Toolkit Profile".
  74.           4. In the "IBM Toolkit Profile",
  75.              select the action with class MAKE and name NMake.
  76.           5. Hold down mouse button 2, press the Ctrl key, and
  77.              drag the action to the Actions list in the
  78.              "Default Actions Profile".
  79.              A copy of the action will appear in the default actions profile.
  80.           6. Close both actions profiles and the "Actions Profiles" folder.
  81.  
  82.  
  83.      WorkFrame/2 Installation
  84.      ________________________
  85.  
  86.           The installation program consists of two phases, and requires you to
  87.           reboot between them.  If you are re-installing on top of an existing 
  88.           copy of WorkFrame/2 version 2.1, you will also be required to reboot 
  89.           following the installation.  
  90.  
  91.           Before installing WorkFrame/2:
  92.           1.  Close any applications you do not need running.
  93.           2.  Avoid doing any computer
  94.               work while the product is installing.
  95.  
  96.           Do not minimize the Setup program while it is running.
  97.  
  98.  
  99.      Installation Errors
  100.      ___________________
  101.  
  102.           During phase 2 of installation, you may get errors about objects that
  103.           could not be created or about initialization files that could not be 
  104.           modified.  If this happens, wait for all disk activity to end and then 
  105.           select the Retry push button on the message box.  
  106.  
  107.           If after selecting Retry twice, the installation continues to fail,
  108.           you may be encountering a bug in the OS/2 WorkPlace Shell.  You can
  109.           contact your IBM support representative, and ask for a fix to APAR 
  110.           PJ10892.  You can also use an alternate installation program, that 
  111.           attempts to work-around this problem.
  112.  
  113.           First, select "Undo installation..."  from the "Options" pull down.
  114.           Next, exit the WFSETUP installation program and start the WF386 
  115.           program.  This program will repeat phase 1 of the installation and 
  116.           then ask you to reboot your machine.  Before you reboot, try to 
  117.           minimize the number of programs that will be running after the machine 
  118.           is rebooted.  Phase 2 will have a better chance of success if other
  119.           programs (such as the IBM AntiVirus scanning program) are not running
  120.           during the install.
  121.  
  122.  
  123.  
  124. 3. INSTALLING FROM A CD-ROM
  125. ___________________________
  126.      
  127.      You can install the WorkFrame/2 product from the IBM C Set ++ CD-ROM.
  128.      Start the installation by going to the OS2WF21 directory on the 
  129.      CD-ROM and entering "wfsetup" (or "wf386" if appropriate -- see 
  130.      "Installation Errors" above).
  131.  
  132.      If you want to create WorkFrame/2 diskettes, you will find the diskette 
  133.      images in the IMAGE\IBMWF21 directory.  DISK1.IMG and DISK2.IMG are the 
  134.      first and second diskettes respectively.  Use the LOADDSKF utility 
  135.      shipped on the CD-ROM to create the diskettes from the images.  
  136.  
  137.      Note that you cannot run the WorkFrame/2 product from the
  138.      CD-ROM, only install it.
  139.  
  140.  
  141. 4. REINSTALLATION
  142. _________________
  143.  
  144.      If you want to reinstall the WorkFrame/2 product, you can start the 
  145.      setup program from the WorkFrame/2 folder.  Alternatively, to start the 
  146.      program from the command line, go to the directory where you installed 
  147.      the WorkFrame/2 product and enter "wfsetup" (or "wf386" if you used that 
  148.      program to install the first time).  
  149.  
  150.      1. Besides updating the CONFIG.SYS and copying files to your machine, the 
  151.         WorkFrame/2 installation program also registers WorkPlace Shell classes 
  152.         with the OS/2 Desktop.  Before reinstalling the WorkFrame/2 product, you 
  153.         need to deregister any WorkFrame/2 classes registered in a previous
  154.         installation.  To do this, select "Undo installation..."  from the 
  155.         "Options" pull-down in the WorkFrame/2 Installation program.  Then you 
  156.         can remove the WorkFrame/2 templates created in the Templates folder by 
  157.         following the instructions in step 2.
  158.  
  159.         You do not need to remove the WorkFrame/2 entries in CONFIG.SYS;
  160.         they will be handled by the installation program when you are
  161.         reinstalling.  
  162.  
  163.      2. Each installation of the WorkFrame/2 V2.1 product generates a new set of 
  164.         WorkFrame/2 templates in the Template Folder on the Desktop.  By 
  165.         generating a new set, the WorkFrame/2 product avoids writing over 
  166.         templates that you customized.  However, if you did not customize the 
  167.         original templates, the new ones will be duplicates.  To avoid having 
  168.         duplicate templates, complete the following steps before reinstalling 
  169.         the WorkFrame/2 product:  
  170.  
  171.         1. Open the "Templates" folder.
  172.  
  173.         2. Drag the "Folder" template to the Desktop to create a new folder.
  174.  
  175.         3. Open the new folder you just created.
  176.  
  177.         4. Open the pop-up menu of one of the WorkFrame/2 templates
  178.            and select the "Move..." item.
  179.  
  180.         5. When the "Move" dialog appears, select "Folder" as the
  181.            destination.  Then select the "Move" push button.
  182.            The template will be moved to the new folder.
  183.  
  184.         6. Move the other WorkFrame/2 templates to the new folder using
  185.            the same steps detailed above.
  186.  
  187.         7. Close the "Folder" object and drag it to the "Shredder" icon.
  188.            Delete the object as you would any other Desktop object.
  189.  
  190.  
  191. 5.  MIGRATING FROM PREVIOUS VERSIONS OF WORKFRAME/2
  192. ___________________________________________________
  193.  
  194.      The Setup program has a utility which eases the migration from
  195.      projects created by previous versions of the WorkFrame/2 product.
  196.      To invoke this utility, select "Migrate" from the "Options" pull-down.
  197.  
  198.      Note that when you migrate projects (and their associated language
  199.      profiles), the names of the compiler and linker options DLLs will
  200.      not be changed.  Because this version of WorkFrame/2 supports more
  201.      powerful interfaces to options DLLs, you may want to replace
  202.      the options DLL used for an action with a newer version, if one is
  203.      available.
  204.  
  205.      For the C Set ++ product, the DLLs should be migrated as follows:  
  206.      DDE4CSET and DDE4ICC should be replaced by DDE4ICC2.  DDE4ICL should be 
  207.      replaced by DDE4ICL2.  Note that when you use a new DLL, you will have 
  208.      to re-enter the options for that action.  
  209.  
  210.  
  211. 6. TUTORIAL
  212. ___________
  213.  
  214.      Once you have read the Introduction booklet, you will want to
  215.      continue with the IBM WorkFrame/2 Tutorial (found in the WorkFrame/2
  216.      Information folder).  The first part of the tutorial contains an
  217.      on-line version of the Introduction booklet.  The last part takes you
  218.      step-by-step through a sample software project.
  219.  
  220.      While doing the tutorial, keep in mind the following:
  221.  
  222.      1. The latter part of the tutorial describes using the EPM editor in
  223.         conjunction with the Monitor window.  Some steps may not work for
  224.         the reasons described in the "Error context help in EPM" section below.
  225.  
  226.      2. The CLC sample is only meant to be used in conjunction with the
  227.         tutorial.  Do not change it in any way other than through the tutorial.
  228.  
  229.      3. The figure in Lesson 12 shows both a make file and a dependency file
  230.         in the MakeMake Results window.  Typically, no dependency file will
  231.         actually be created using the IBM C Set ++ compiler.
  232.  
  233.      4. As you do the tutorial, you may run into General Protection Violations 
  234.         caused by the IBM C Set ++ compiler (in DDE4CPP.EXE).  Simply end the 
  235.         program and continue; the violations do not affect the outcome of the 
  236.         tutorial.  
  237.  
  238.  
  239. 7.  WORKFRAME/2 CONSIDERATIONS AND NOTES
  240. ________________________________________
  241.  
  242.      General
  243.      _______
  244.  
  245.         * Some components of the WorkFrame/2 product may not adopt system-wide
  246.           settings, such as colors.  (CK00794)
  247.  
  248.         * If you use the "Undo installation..." option of the setup program, you
  249.           may encounter messages saying that some objects and folders cannot be
  250.           removed.  You can ignore this message.  (CK01548)
  251.  
  252.      Setup
  253.      _____
  254.  
  255.         * Do not minimize the Setup program when it is running or you may not
  256.           be able to maximize it again.  (CK01684)
  257.  
  258.  
  259.      Projects and Composite Projects
  260.      _______________________________
  261.  
  262.         * You can use Universal Naming Convention (UNC) names to specify the
  263.           locations of files in the Directories list on the Source page of a 
  264.           base project's Settings notebook.  However, the directory specified
  265.           as the project's Working Directory must follow the standard FAT or 
  266.           HPFS naming format.  
  267.  
  268.         * Renaming base projects within a composite project and then selecting
  269.           an action from the composite project's pop-up menu may cause errors.
  270.           Before selecting the action, respecify the contents on the composite
  271.           project's Target and Sequence pages to reflect the new project names.
  272.           (CK01596)
  273.  
  274.         * In the WorkPlace Shell environment, a common method of creating
  275.           duplicate objects with common settings is to make them from a template 
  276.           with those settings.  This techniques generally works with WorkFrame/2 
  277.           objects, except for the setting on the Profile page of a project's
  278.           Settings notebook.  (CK01783)
  279.  
  280.         * On rare occasions, updates to the actions profile may not be reflected 
  281.           when you open the Actions page in the Settings notebook of a project.  
  282.           If this occurs, go to the project's Profile page, add a space to the 
  283.           end of the name, and hit <enter> (ignoring any errors).  Remove the 
  284.           space you added, and press <enter> again.  (CK01807) 
  285.  
  286.         * Do not rename or move a base project while the Monitor window is being 
  287.           used to run an action for that project.  (CK01811) 
  288.  
  289.      Actions Profiles
  290.      ________________
  291.  
  292.         * Help for the dialog used to add or change an action may fail if an 
  293.           error message is displayed as the dialog is appearing.  
  294.  
  295.           The most common scenario is when the options DLL specified on the
  296.           Options page cannot be found.  If this occurs, verify that the DLL
  297.           exists in the LIBPATH or specify a DLL that does.
  298.           (CK01759) and (CK01801).
  299.  
  300.      IBM Library Manager
  301.      ___________________
  302.  
  303.         * Do not drag objects from the IBM Library Manager to the "Drive A:"  
  304.           icon or folder if there is no diskette in drive A:.  Doing so causes 
  305.           the mouse pointer to change into the "busy" icon until another object 
  306.           module is moved.  (CK01104) 
  307.  
  308.         * The IBM Library Manager will lock the system under the following
  309.           scenario:
  310.           1. Modify an existing library.
  311.           2. Select a file in the "Files" list in the "Object files" group.
  312.           3. Change the name in the Library field without pressing the
  313.              Enter key.
  314.           4. Drag the file selected in step 2 to a new location.
  315.              (CK01772)
  316.  
  317.         * When using the IBM Library Manager, always close the Errors window 
  318.           using the OK push button rather than the System Menu icon.  Otherwise, 
  319.           you will only be able to close the IBM Library Manager from the Window 
  320.           List.  (CK01781) 
  321.  
  322.         * Selecting Esc on a help panel describing the IBM Library Manager
  323.           Settings notebook causes the focus to be misplaced.  Click on
  324.           the Settings notebook to return the focus to it.  (CK01803)
  325.  
  326.      Moving and Renaming WorkFrame/2 Folders
  327.      _______________________________________
  328.  
  329.           Different components of the WorkFrame/2 product need to be able to
  330.           locate each other as the product is being used.  Some of the files are 
  331.           stored in the operating system's DESKTOP directory and can be renamed 
  332.           or moved using the WorkPlace Shell interface.  If you do use the
  333.           WorkPlace Shell interface to move the WorkFrame/2 icon into a folder
  334.           or rename the icons that are part of the WorkFrame/2 product, do the 
  335.           following to avoid errors:  
  336.  
  337.           1. Find the Default Actions Profile, open it, and then close it.  
  338.              Doing this lets the other active WorkFrame/2 components know where
  339.              this action profile is located.  
  340.  
  341.           2. If you change the Desktop location of an actions profile, the base 
  342.              projects using that profile may not be able to find it.  If this 
  343.              happens, locate the actions profile on the Desktop and open the 
  344.              Profile page of the project's Settings notebook.  Drag the actions 
  345.              profile into the field where the Profile is specified on the 
  346.              notebook page.  
  347.  
  348.        MakeMake
  349.        ________
  350.  
  351.         * The MakeMake utility is intended to create a useful first draft of a 
  352.           make file that can be used with the Toolkit's NMAKE utility.  Not all 
  353.           subtleties in the build process can be accounted for, so you may
  354.           need to change the make file produced by MakeMake.
  355.  
  356.         * If both the "Depend on project" and "Depend on Makefile" options are 
  357.           selected, the resulting make file may cause every file to be rebuilt
  358.           every time.  Selecting only one or neither of these options will result
  359.           in a correct make file.  (CK01818) 
  360.  
  361.         * When you use MakeMake to build a very large make file, the make file may
  362.           not be displayed correctly in the MakeMake Results window.  However, 
  363.           the make file will be saved correctly.  (CK01789) 
  364.  
  365.         * Do not rename or move a base project while the MakeMake tool is being 
  366.           used to create a make file for that project.  (CK01810) 
  367.  
  368.         * Do not change the working directory of a base project while the 
  369.           MakeMake tool is being used to create a make file for that project.  
  370.           The operating system will hang.  (CK01815) 
  371.  
  372.         * When the option "Separate dependency file" is selected, the MakeMake 
  373.           utility will create a separate dependency file only if there is data 
  374.           to put into it.  
  375.  
  376.        Other
  377.        _____
  378.  
  379.         * Combining extremely large libraries may cause the IBM Library Manager 
  380.           tool to fail.  If this happens, split the larger libraries into 
  381.           smaller ones and retry the operation.  (CK01741) 
  382.  
  383.         * The LINK entry point in the default options DLL (DDE3DEF2.DLL) 
  384.           truncates some library names to 8 characters.  (CK01794) 
  385.  
  386.         * Invoking the DDE3MSGB.EXE tool, (called Message Bind Plus) in the 
  387.           Toolkit actions profile, on a nonexistent message file will cause the 
  388.           tool to abnormally end.  (CK01796) 
  389.  
  390.  
  391. 8. CONSIDERATIONS AND NOTES FOR USING OTHER PRODUCTS
  392. ____________________________________________________
  393.  
  394.      IBM C Set ++  Compiler
  395.      ______________________
  396.  
  397.         * The IBM C Set ++ compiler may cause General Protection Violations
  398.           (GPVs) when running in the WorkFrame/2 environment.  
  399.           These are caused by preloading the compiler and can be ignored;
  400.           compilation of your program is not affected.  To avoid the GPVs,
  401.           you can use the /TL- compiler option to not preload the compiler.
  402.           To specify this option, deselect "Preload compiler components"
  403.           on the "Other" page of the compiler options dialogs.  Alternatively,
  404.           you can set AUTOFAIL=YES in your CONFIG.SYS file to not display
  405.           the GPV screens.
  406.  
  407.      Toolkit Message Bind (MSGBIND)
  408.      ______________________________
  409.  
  410.         * To bind all the messages in a .MSG file to an executable file,
  411.           use the "BIND::Parse and bind messages" action from the Toolkit
  412.           actions profile.  This is the equivalent to the WorkFrame/2 v1.x 
  413.           Message Bind action.  
  414.  
  415.           If you want to bind only some of the messages, you must create the MSGBIND
  416.           response file yourself, and use an extension of .RSP for this file.  
  417.           You can then run the "BIND::Messages" action against the .RSP file.
  418.  
  419.      PL/I Support
  420.      ____________
  421.  
  422.         * If you are using the IBM PL/I product, do not run the PL/I compiler in 
  423.           more than one Monitor window at a time.  Due to a problem in the 
  424.           IBMWF.DLL file (shipped with the IBM PL/I product), the DLL can cause 
  425.           either a General Protection Violation or hang the operating system.  
  426.  
  427.           Make sure that "Multiple, concurrent monitors" is always
  428.           deselected on the Monitor page of the Settings notebook
  429.           of PL/I projects.
  430.  
  431.      EPM
  432.      ____
  433.  
  434.         * If you have started EPM in an iconized form (EPM /i), you may 
  435.           encounter problems importing the compiler error messages.  Double-
  436.           clicking on an error line will edit the file correctly, but the errors 
  437.           may not be highlighted.  If EPM has not been previously started, the 
  438.           errors should appear correctly highlighted.  
  439.  
  440.         * Dragging a single error from a Monitor window to the EPM editor may 
  441.           not always result in the editor's cursor being located at the error.  
  442.           When this happens, double-click on the error to move the editor's 
  443.           cursor.  (CK01672) 
  444.  
  445.         * Dragging more than one file from a base project to the EPM editor will 
  446.           cause the editor to end abnormally.  Instead, select the "Edit -> EPM" 
  447.           action from the pop-up menu of one of the files.  (CK01312) 
  448.  
  449.         * Dragging an error line from the Monitor window to the EPM editor's 
  450.           title bar will cause EPM to end abnormally.  (CK01314) 
  451.  
  452.      Linking
  453.      _______
  454.  
  455.           Temporary response files are created regardless of whether the
  456.           WorkFrame/2 product directs the linking to be done in the WorkFrame/2 
  457.           Monitor, an OS/2 Window, or in OS/2 full-screen mode.  If the linking
  458.           is done in an OS/2 Window or full screen, the WorkFrame/2 cannot delete
  459.           the response files.  
  460.  
  461.      SOM version 2.0
  462.      _______________
  463.  
  464.           Using both the SOM Version 2.0 product and WorkFrame/2 Version 2.1 
  465.           will cause multiple software errors.  Do not have both the SOM Version 
  466.           2.0 and WorkFrame/2 Version 2.1 products installed on your machine.  
  467.  
  468.  
  469. TRADEMARKS AND SERVICE MARKS
  470. ____________________________
  471.  
  472.      The following terms, denoted by an asterisk (*) in this README, are 
  473.      trademarks or registered trademarks of the IBM Corporation in the United 
  474.      States or other countries:  
  475.  
  476.           C Set ++
  477.           IBM
  478.           OS/2
  479.           WorkFrame/2
  480.           WorkPlace Shell.
  481.  
  482.