home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / wf2b1.zip / READ.ME < prev    next >
Text File  |  1993-08-26  |  14KB  |  303 lines
  1. ===============================================================================
  2.      IBM* WorkFrame/2* read.me file:
  3.  
  4.      IBM WorkFrame/2   V2 BETA   Driver 0816
  5. ===============================================================================
  6.  
  7. IBM WORKFRAME/2 BETA TEST INSTALLATION
  8. ____________________________
  9.  
  10.  
  11. 1. REQUIRED PREREQUISITES
  12. _____________________________
  13.  
  14.    A) OS/2 2.1 product level
  15.    B) CSet++ v2.0 product level (no Beta's)
  16.  
  17.         If you are not able to obtain the above pre-requisites, please
  18.         make sure that you SPECIFY your configuration when making problem
  19.         reports.
  20.  
  21. 2. INSTALLATION
  22. ________________
  23.    This beta package consists of 3 ZIP files.
  24.         1) WF2B1.ZIP  -WorkFrame/2 2.0 BETA diskette 1.
  25.         2) WF2B2.ZIP  -WorkFrame/2 2.0 BETA diskette 2.
  26.            Use pkunzip to uncompress and unpack these files to a diskettes.
  27.            (3.5inch 1.44M floppy) with the following commands:
  28.            PKUNZIP2 -d wf2b1.zip a:
  29.                 -label this diskette "IBM WorkFrame/2 2.0 BETA DISK1"
  30.            PKUNZIP2 -d wf2b2.zip a:
  31.                 -label this diskette "IBM WorkFrame/2 2.0 BETA DISK2"
  32.  
  33.         3) WF2BCPP.ZIP - a modified version of the cppinst.exe program which
  34.            comes with cset++ v2.0.  This program will copy some additional
  35.            'Options DLL' to your ibmcpp\dll subdirectory, and will create
  36.            a sample project folder and CSet++ actions profile in your main
  37.            CSet++ tools folder.
  38.  
  39.            NOTE: if you have installed a previous BETA version of WF2 Version2,
  40.                 then you do NOT need to download wf2bcpp.zip again, nor do you
  41.                 need to re-run cppinbet.exe.  No changes have been made to this
  42.                 component.
  43.  
  44.            -copy wf2bcpp.zip to your harddisk, and issue the command:
  45.              PKUNZIP2 wf2bcpp.zip a:
  46.            -label this diskette 
  47.                   IBM CSet++ Installation for WorkFrame/2
  48.  
  49.            These DLL's provide dialogs which let you select options for the
  50.            compiler, or other CSet++ tools.
  51.            This program has been tested with the above
  52.            configuration.  If you run it with earlier (beta) versions of
  53.            the CSet++ product, you may encounter problems, one of which
  54.            is that the existance of CSet++ will not be detected.  If you
  55.            encounter similar messages, ignore them and continue with
  56.            installation.
  57.  
  58.         4) WF2BDOC.ZIP  - contains a PostScript printable copy of the
  59.            WorkFrame/2 2.0 Introduction manual and an ascii file 
  60.            containing a survey.  Please fill out the survey and send it
  61.            back to us. (See covering letter for details)
  62.  
  63.            NOTE: if you have installed a previous BETA version of WF2 Version2,
  64.                 then you do NOT need to download wf2bdoc.zip again.
  65.                 No changes have been made to this component.
  66.  
  67.    The correct order of installation is:
  68.         1) IBM CSet++ (with or without WF/2 1.1)
  69.         2) IBM WorkFrame/2 2.0 Beta
  70.         3) modified CSet++ installation program (cppinbet.exe) see
  71.            above.
  72.  
  73.    Installing from Diskettes
  74.         1) insert the diskette labelled
  75.                   IBM WorkFrame/2 2.0 BETA Diskette 1
  76.            and type:
  77.                   a:wfsetup
  78.            Insert IBM WorkFrame/2 2.0 BETA Diskette 2 when prompted.
  79.  
  80.         2) insert the diskette labelled
  81.                   IBM CSet++ Installation for WorkFrame
  82.            and type:
  83.                   a:cppinbet
  84.            NOTE: this step is only necessary if you already have CSet++
  85.                 installed on your machine.  WorkFrame is a stand alone
  86.                 program, and can be used with other compilers and tools.
  87.  
  88.         6) after re-booting as necessary, WorkFrame/2 is ready for
  89.            use.  Please see the section below, before beginning the
  90.            tutorial.  We invite you to try the tutorial which will
  91.            help to familiarize you with WorkFrame/2 v2.0.  The tutorial
  92.            is located in the "Information" folder, which is located in
  93.            the main IBM WorkFrame/2 folder on the desktop.
  94.  
  95. 3. Tutorial
  96. ___________
  97.  
  98.    The first part of the tutorial presents an overview of the 
  99.    WorkFrame/2.  This information is also contained 
  100.    in the PostScript version of the Introduction booklet
  101.    delivered with the Beta package.  
  102.  
  103.    When doing the tutorial:
  104.         - Do not try to set the "Respect case in symbol names" option
  105.           when "Setting Linker Options".  This option does not exist.
  106.  
  107.         - When specifying the make file for the Functions project,
  108.           specify it as MAK.BAK rather than the name given in the
  109.           tutorial.  This file is shipped with the product.
  110.  
  111.         - Do NOT follow the steps for creating a make file.  Your system
  112.           may hang.  
  113.  
  114.         - When "Making" the project for the first time, the compiler,
  115.            DDE4CPP.EXE, may trap.  Keep repeating the make, until all
  116.            nmake actions end with return codes of 0 (zero).
  117.  
  118.         - In the "Adding a Function" section, the line numbers are wrong:
  119.                 - Line 35 is really line 45.
  120.                 - Line 56 is really line 66.
  121.                 - Line 167 is really line 176.
  122.                 - Line 174 is really line 183.
  123.  
  124.         - Using Ctrl+H may not work on some systems, from within EPM.  Ctrl-H
  125.           from within EPM should provide keyword help.
  126.  
  127.         - The "Running the Project" section contains the following typos:
  128.                 - "Open->Test program" should be "Open->Target program".
  129.                 - 2.03 should be 2.3 and 4.1209 should be 5.29.
  130.  
  131.         - Skip the section "Adding the Calculator as an Action" and all
  132.           subsequent ones.
  133.  
  134.  
  135.  
  136.  
  137. KNOWN PROBLEMS/LIMITATIONS
  138. __________________________
  139.  
  140. 4. MakeMake tool is not functional
  141. ____________________________
  142.  
  143.    There are various problems with the Makefile generation tool, and its
  144.    interaction with the options dlls.  They generally appear as
  145.    general protection faults, or else MakeMake dies quietly.  We do not
  146.    recommend use of MakeMake at this time.  (MakeMake appears in the tools
  147.    folder).  It does seem to work for the Hello World sample, and many other
  148.    projects, especially those using only a single directory.
  149.  
  150.    UPDATE for 0816 driver.
  151.    MakeMake is now working better, although there are still known problems.
  152.    Please give it a try.
  153.  
  154.  
  155. 6. Error context help in EPM
  156. ____________________________
  157.  
  158.    If you have started EPM in an iconized form (EPM /i), you may
  159.    encounter problems importing the compiler error messages.  Double
  160.    clicking on an error line will edit the file correctly, but the
  161.    errors may not be highlighted.  If EPM has not been previously
  162.    started, the errors should appear correctly highlighted.
  163.  
  164.    NOTE: In order to make WorkFrame/2 send errors to the editor do the
  165.          following, assuming EPM is the editor.
  166.          This must be done for each project.
  167.          1) open the settings for your project.
  168.          2) Select the 'Actions' page find the 'Edit' action and press
  169.             'Options'
  170.          3) Change the parameters to /W %a %z and check the
  171.             'Send errors to editor' checkbox.
  172.          4) save changes.
  173.          Now, when you have a compilation error, double click on the error
  174.          from within a monitor window, and the file containing the error
  175.          will be opened, and positioned on the error.  Note also that an
  176.          additional item is added to the EPM menu bar.
  177.  
  178. 7. Hangs, Traps, and other problems
  179.   1)  After 'Adding', or 'Changing' an action in an action profile,
  180.       WorkFrame/2 sometimes hangs.  Try to recover with CTRL_ALT_ESC,
  181.       but you may have to re-boot.
  182.    NOTE for driver 08/16 -this should now be fixed.
  183.  
  184.   2)  Another spurious problem is 'loss of focus'.  At various times
  185.       you may find that none of your windows has the foreground emphasis,
  186.       although mouse actions may work.  Try closing WF/2 from the system
  187.       task list, or CTRL_ALT_ESC.
  188.    NOTE for driver 08/16 -this should now be fixed.
  189.  
  190.   3)  On some machines a compile action run through monitor may result
  191.       in a protection fault in module IBMCPP.  Retry the action.  This
  192.       seems to be machine dependent.  
  193.   4)  If you are using the MakeMake utility, in conjunction with the
  194.       DDE4ICC2 options dll, you may see strange messages or traps.  
  195.       We are attempting to rectify this situation (that's why we don't
  196.       recommend use of MakeMake at this time).
  197.  
  198.       Please report these problems via Compuserve, with a scenario 
  199.       which will allow us to re-create the problem if possible.
  200.  
  201.  
  202.  
  203. 8. IBM WORKFRAME/2 REINSTALLATION
  204. _________________________________
  205.  
  206.    Each installation of WorkFrame/2 V2.0 generates a new set of
  207.    WorkFrame/2 templates in the Template Folder on the Desktop.
  208.  
  209.    To avoid multiple WorkFrame/2 templates:
  210.  
  211.        When?
  212.        -----
  213.        1. After undo-installation and before running
  214.           re-installation again.
  215.        2. Before re-installation of WorkFrame/2 V2.0 on top
  216.           of a previously installed WorkFrame/2 V2.0
  217.           without performing undo-installation.
  218.  
  219.        How?
  220.        ----
  221.        1. Open template folder from the desktop
  222.        2. Select a WorkFrame/2 template
  223.        3. Click on the left button of the mouse
  224.        4. Select "Open ->" from pop up
  225.        5. Select "Settings"
  226.        6. From "Settings" note book, select "General"
  227.           page
  228.        7. From "General" page, deselect the "template"
  229.           checkbox.
  230.        8. Repeat for the rest of the WF/2 templates
  231.  
  232.        9. Go to an OS/2 Window (command prompt)
  233.       10. Make boot drive as the default drive
  234.       11. Change current directory to "DESKTOP\TEMPLATE"
  235.       12. There should be 2 files and 1 DIR for WorkFrame/2
  236.               ACTIONS_    (file)
  237.               WORKFRAM    (file)
  238.               WORKFRA1    (dir)
  239.           Sometimes, it might have other names,
  240.           but they must be:
  241.               ACTIONxx    (file)
  242.               WORKFRxx    (file)
  243.               WORKFRxx    (dir)
  244.           Delete these files and remove the directory.
  245.           The WorkFrame/2 templates will be deleted
  246.           after these files and directory are removed.
  247.       13. WorkFrame/2 re-installation can be run now, and
  248.           a new set of WorkFrame/2 templates can be
  249.           generated by the re-installation.
  250.  
  251.  
  252.  
  253. Currently active Problem Tracking Reports (PTRs):
  254.  
  255. PTR #    Description
  256. _______  ___________________________________________________________
  257.  
  258. SHEL     CK01114  OPEN            PROFILE - CLEAN UP AND DOCUMENTATION   
  259. SHEL     CK01242  OPEN            BASE PROJECT - PHANTOM HELP MESSAGES   
  260. SHEL     CK01312  OPEN            EPM TRAPS WITH MULTIPLE SOURCE RENDERE 
  261. SHEL     CK01314  OPEN            OS2 - EPM CRASHES WHEN DRAGGINE ERROR  
  262. SHEL     CK01375  OPEN            HELP FOR MAKEMAKE, NOTES SECTION       
  263. SHEL     CK01430  OPEN            MONITOR - ERROR MESSAGE PROCESSING STO 
  264. SHEL     CK01456  OPEN            MONITOR - UNABLE TO RESTART ACTIONS FR 
  265. SHEL     CK01491  OPEN            MAKEMAKE - BLANK ERRORS DIALOG         
  266. SHEL     CK01533  OPEN            PMLIB - CAN'T CREATE LIBRARY LISTING F 
  267. SHEL     CK01542  OPEN            CUSTOMIZED HELP NOT WORKING.           
  268. SHEL     CK01544  OPEN            SPURIOUS TRAPS IN DDE4CPP.EXE WHEN LAU 
  269. SHEL     CK01555  OPEN            LIBRARY MANAGER TUTORIAL'S ONLINE HELP 
  270. SHEL     CK01563  OPEN            TUTORIAL - PROBLEMS WITH DOCUMENTATION 
  271. SHEL     CK01564  OPEN            MAKEMAKE: NO ENTRY IN DEFAULT DLL FOR  
  272. SHEL     CK01566  OPEN            NMAKE.EXE DOES NOT HANDLE %S PROPERLY  
  273. SHEL     CK01568  OPEN            BASE: CAN'T DROP FILES ONTO A BASE PRO 
  274. SHEL     CK01570  OPEN            MAKEMAKE: MISSING FILE DIALOG          
  275. SHEL     CK01582  OPEN            PMLIB: NO CONFIRMATION WHEN NEW LIB CR 
  276. SHEL     CK01591  OPEN            CLC SAMPLES DON'T MAKE FROM GUI BUT DO 
  277. SHEL     CK01593  OPEN            MESSAGE ROUTER - INVOKING ACTIONS FROM 
  278. SHEL     CK01595  OPEN            HELP NEEDED FOR NEW MAKEMAKE MSG IDE_M 
  279. SHEL     CK01596  OPEN            MONITOR/COMPOSITE - RENAME BP IN COMPO 
  280. SHEL     CK01597  OPEN            MONITOR/COMPOSITE - MONITORS GETTING O 
  281. SHEL     CK01598  OPEN            MAKEMAKE: MESSAGE BIND HAS INCORRECT R 
  282. SHEL     CK01599  OPEN            MAKEMAKE: ABEND AFTER LOOP DETECTED IN 
  283. SHEL     CK01600  OPEN            MAKEMAKE: MULTIDIRECTORY RESOURCE AND  
  284. SHEL     CK01601  OPEN            COMPILE OPTIONS (DDE4ICC) ERRONEOUS WA 
  285. SHEL     CK01602  OPEN            LIB UTILITY: LOST CAPABILITY TO INSPEC 
  286. SHEL     CK01603  OPEN            PMLIB TRAPS WHEN SPECIFYING NEW NAME   
  287. SHEL     CK01604  OPEN            NO HELP TEXT FOR THE NEW LIB DEFAULT O 
  288. SHEL     CK01606  OPEN            MIGRATE - A FEW PROBLEMS               
  289. SHEL     CK01607  OPEN            COPYRIGHT INFO NEEDS TO APPEAR ON ALL  
  290. SHEL     CK01608  OPEN            MAKEMAKE: LINKER LIBRARY FILES HAVE TH 
  291. SHEL     CK01611  OPEN            DDE3DEF2 - DEFAULT ACTION NAVIGATION B 
  292. SHEL     CK01612  OPEN            MONITOR - RESTART - FAILS FOR DEFAULT  
  293. SHEL     CK01614  OPEN            PMLIB DOESN'T DELETE OBJECT FILES PROP 
  294. SHEL     CK01616  OPEN            PMLIB: INCONSISTENT DIRECT MANIPULATIO 
  295. SHEL     CK01617  OPEN            HELP: INCORRECT HELP PANEL FOR BASE PR 
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.