home *** CD-ROM | disk | FTP | other *** search
/ IBM CD Showcase / OS2_CD_ROM.iso / smce0001 / wplace / readme.doc < prev    next >
Encoding:
Text File  |  1993-06-29  |  14.3 KB  |  380 lines
  1.  
  2.                                     README for
  3.                              Ultimedia (TM) Workplace/2
  4.                                    Release 1.0
  5.                         5871-AAA (c) Copyright IBM (R) Corp. 1993
  6.  
  7.  
  8.  
  9.  
  10.    This README contains information related to Ultimedia Workplace/2,
  11.    a versatile tool for organizing and managing multimedia files.  This
  12.    file contains helpful hints found in our testing as well as updated
  13.    information that did not make our printed publications.
  14.  
  15.    o   Miscellaneous Workplace/2 notes
  16.  
  17.    o   Installation notes
  18.  
  19.    o   Improving performance of Workplace/2 tutorial
  20.  
  21.    NOTE:  If you are viewing this file with a program that uses
  22.    proportional fonts, you may wish to change to a monospaced
  23.    font, for the best readability.
  24.  
  25.  
  26. MISCELLANEOUS WORKPLACE/2 NOTES
  27. _______________________________
  28.  
  29.  
  30.    When using Workplace/2, be aware of the following:
  31.  
  32.    o   Workplace/2 stores temporary files in a user-specified directory.
  33.        This directory information is saved in the environment variable TEMP.
  34.        If the specified directory is not valid, C:\ is used instead.
  35.  
  36.    o   When defining database schema which is attached to the Light Table
  37.        folder, be sure that the database column selected as the join field
  38.        is long enough to hold the object title, object filenames or Extended
  39.        Data that the objects will actually use.  If the database row's field
  40.        value does not match the object data, because the data was
  41.        truncated to fit the column, the database row will not be linked
  42.        with the object.
  43.  
  44.    o   After creating an LT Query Sequencer folder, open the LT Query
  45.        Sequencer in the Templates folder and make sure that the objects
  46.        are in the correct sequence -- an LT Query object on the left and
  47.        an LT Query Result on the right.  If the objects are reversed,
  48.        move the LT Query Result to the right of the LT Query.  Do this
  49.        for both LT Query Sequencers -- the one in the Templates folder and
  50.        the one you just created.  Then close the LT Query Sequencer from
  51.        the Templates folder.  All LT Query Sequencer folders you create
  52.        from now on will have the objects in the correct sequence.
  53.  
  54.    o   Oracle tables with LONG field(s) are not supported.
  55.  
  56.    o   ICO files (with .ICO file extension) is deleted from our supported
  57.        file types list.
  58.  
  59.    o   Unpredictable results may occur with images with dimensions
  60.        greater width than 1024 pels and greater depth than 768 pels.
  61.  
  62.    o   If another application realizes the custom palettes, the color
  63.        of the image browser may not be correct.
  64.  
  65.    o   When selecting multiple objects from the Light Table folder to create
  66.        LT Reference objects, do not mix BMP files or ICO files with other
  67.        data file objects.  You can select all BMP files as one group, then
  68.        create LT Reference from these selected objects.  Select all
  69.        ICO files as another group to create LT Reference.  Then select all
  70.        the rest of the objects to create LT Reference.
  71.  
  72.  
  73.  
  74.  
  75. INSTALLATION NOTES
  76. __________________
  77.  
  78.  
  79.    Ultimedia Workplace/2 Uninstall Steps
  80.    _____________________________________
  81.  
  82.       Using this Guide
  83.       ________________
  84.  
  85.       This guide details a simple deinstallation.  Certain exercises
  86.       will require some thoughtful analysis by you the user, since all
  87.       possible configurations and scenarios can't be anticipated.
  88.  
  89.       Some of the things this guide can't anticipate are:
  90.  
  91.          - name changes to Desktop objects and Folders
  92.          - locations of Desktop objects and Folders
  93.          - location of Light Table and Light Table Query
  94.            Sequencer objects
  95.  
  96.       CONFIG.SYS changes are recommended as part of uninstalling
  97.       Workplace/2.  This file is very sensitive to errors and can
  98.       cause OS/2 (R) reboot failures, so exercise caution when handling it.
  99.  
  100.  
  101.       Assumptions
  102.       ___________
  103.  
  104.       Examples here are written as if Ultimedia Workplace/2 was installed
  105.       on
  106.  
  107.          D:\WORKPLAC
  108.  
  109.       If your install location is different, replace occurrences of
  110.       D:\WORKPLAC in these instructions with your location.
  111.  
  112.  
  113.       Step-by-Step Instructions
  114.       _________________________
  115.  
  116.       1. Deregister Workplace Object Classes introduced by Workplace/2
  117.  
  118.          - run D:\WORKPLAC\INSTALL\DEREGIST.CMD
  119.  
  120.          Depending on your System Configuration, several errors may be
  121.          reported during execution - this is acceptable.
  122.  
  123.       2. Remove the following objects from the Desktop:
  124.  
  125.          - Safe
  126.          - Clipdata.BMP
  127.  
  128.          NOTE: The Safe object cannot be deleted from the desktop through
  129.                the pulldown menu.  Instead, you can do the following:
  130.  
  131.                - open an OS/2 Window
  132.                - cd into your current active "Desktop" directory on your
  133.                  boot drive
  134.  
  135.                    Ex.   cd C:\Desktop
  136.  
  137.                - delete the "Safe" directory
  138.  
  139.                If you've rebuilt your desktop at some earlier point,
  140.                your current active desktop may be named something like
  141.                "Desktop1" or "Desktop2" instead.
  142.  
  143.       3. Several Objects must be deleted from the Templates folder.  Like
  144.          the Safe object mentioned earlier, these objects can not be
  145.          deleted from the desktop.
  146.  
  147.          ===================================================================
  148.          ==================  Special Filesystem Note  ======================
  149.          ===================================================================
  150.          The objects will have different names, depending on whether
  151.          your boot drive filesystem is formatted as HPFS or FAT.  Some HPFS
  152.          names have spaces in the middle of their names, so the names must
  153.          be surrounded by double quotes when they are passed to a command
  154.          such as ERASE.  The names in these categories will be listed with
  155.          the quotes, such as "LT Query".  Use the quotes when you enter the
  156.          command, i.e.
  157.  
  158.                  ERASE "LT Query"
  159.          ====================================================================
  160.  
  161.                - open an OS/2 Window
  162.                - cd into your current active "Desktop" directory on your
  163.                  boot drive
  164.  
  165.                           cd C:\Desktop
  166.  
  167.                - cd into the Templates subdirectory
  168.  
  169.                     on FAT:   cd Template
  170.                     on HPFS:  cd Templates
  171.  
  172.                - Erase the following files
  173.  
  174.                       FAT                HPFS
  175.                       ___                ____
  176.  
  177.                       Clipdata.BMP       Clipdata.BMP
  178.                       LT_Query           "LT Query"
  179.                       LT_Quer1           "LT Query Result"
  180.  
  181.                - Erase the following directories and their contents
  182.  
  183.                       FAT                HPFS
  184.                       ___                ____
  185.  
  186.                       LT_Quer2           "LT Query Sequencer"
  187.                       Light_Ta           "Light Table"
  188.  
  189.                NOTE: After you have removed the objects from the Templates
  190.                folder, open the Templates folder on your Desktop to verify
  191.                that the objects have been removed.
  192.  
  193.       4. Delete the following objects from the Ultimedia Tools folder:
  194.  
  195.          - Audio Browser
  196.          - Image Browser
  197.          - Story Browser
  198.          - Text Browser
  199.          - Video Browser
  200.          - Query Editor
  201.          - Query Result Viewer
  202.          - Workplace Tutorial
  203.          - Workplace README
  204.  
  205.          NOTE: You can delete the entire folder if it only contains
  206.          these items.  Other IBM Ultimedia products (such as Ultimedia
  207.          Builder/2 and Ultimedia Perfect Image/2) share the same Ultimedia
  208.          Tools folder, in which case deleting the entire folder is not
  209.          appropriate!
  210.  
  211.       5. Delete the Sample Light Table folder from the Desktop, which is
  212.          created during Workplace/2 installation.
  213.  
  214.       6. Remove all references to D:\WORKPLAC\xxx found in CONFIG.SYS.  Do NOT
  215.          remove the entire item  (e.g. don't delete LIBPATH line), simply
  216.          remove any D:\WORKPLAC item.  PLEASE consult OS/2 documentation
  217.          about CONFIG.SYS semantics if you are unfamiliar with them - making
  218.          mistakes in this file can cause your system not to boot.  Save a
  219.          copy of CONFIG.SYS somewhere safe before you make the changes.
  220.  
  221.          NOTE: Two CONFIG.SYS variables may be deleted entirely.  The
  222.                first variable, "WORKPLAC",  should go.  The second,
  223.                "UMPATH", should be deleted if it only has a reference to
  224.                D:\WORKPLAC\xxx, as in:
  225.  
  226.                         SET UMPATH=D:\WORKPLAC\DATA;
  227.  
  228.                Other products, like Ultimedia Builder/2, also use the
  229.                variable UMPATH.  If it had been installed before Workplace,
  230.                the UMPATH variable on your system would look like:
  231.  
  232.                         SET UMPATH=D:\WORKPLAC\DATA;D:\BUILDER\DATA;
  233.  
  234.                In this case, the value should look like this after
  235.                modification:
  236.  
  237.                         SET UMPATH=D:\BUILDER\DATA;
  238.  
  239.       7. Reboot the system  (Necessary to free busy DLL's for removal)
  240.  
  241.       8. Remove the program directory and all it's contents (D:\WORKPLAC)
  242.  
  243.  
  244.       DEINSTALLING IOPROCS
  245.       ____________________
  246.  
  247.       After installing multiple Ultimedia products (Builder/2, Perfect
  248.       Image/2, or Workplace/2) and then deciding to deinstall one or
  249.       more of the products, you need to run the MMIOINI program
  250.       to deregister certain I/O procedures.  To run MMIOINI:
  251.  
  252.       Icon:
  253.       1. Open the Drives folder
  254.       2. Open the drive where you installed the product
  255.       3. Open the product folder (default name:  WORKPLAC)
  256.       4. Open the INSTALL folder
  257.       5. Double-click on the MMIOINI.EXE icon
  258.  
  259.       Command line:
  260.       1. Change to the product directory (default name: WORKPLAC)
  261.       2. Change to the INSTALL directory
  262.       3. Type:  MMIOINI.EXE
  263.  
  264.       The MMIO Procs Install/Remove screen appears.  To deregister a
  265.       procedure, click on the checkbox next to it.  The I/O procedures
  266.       that should be deregistered are:  The PCX I/O procedure, the
  267.       TARGA I/O procedure, and all I/O procedures relating to TIFF.
  268.       Then deinstall the product(s).  If you still have Ultimedia
  269.       products remaining on your system after the deinstall, you
  270.       should run MMIOINI again to reregister (click on checkbox to
  271.       check) the same I/O procedures listed above.  Failing to do this
  272.       will yield unpredictable results from the remaining Ultimedia
  273.       products that are still installed.
  274.  
  275.  
  276.  
  277.  
  278. IMPROVING TUTORIAL'S PERFORMANCE
  279. ________________________________
  280.  
  281.  
  282.    o   It is a recommendation to run the tutorial on a 486 machine
  283.        with at least 12 megabytes of memory.
  284.  
  285.    o   The tutorial runs much faster if you can copy it to your hard
  286.        drive.  If you want to do this, you'll need about 60 megabytes
  287.        of available storage on your hard drive.  To do so:
  288.  
  289.        1. Copy the TUTOR directory from the Workplace/2 CD-ROM with the
  290.           following contents.
  291.  
  292.           - STARTWP.CMD
  293.           - the subdirectories:  UBLIB, WPTUTOR
  294.           - the subdirectory WPSAMPLE if you want to do Practice
  295.  
  296.        2. Change to the TUTOR directory on your hard drive.
  297.  
  298.        3. Enter the command:  STARTWP
  299.  
  300.    o   The following is an example of how performance of the tutorial
  301.        might be improved if running on a 486 machine with 12 megabytes
  302.        of memory.  This example assumes that the 486 machine has
  303.        a new installation of OS/2 2.1 and that the CONFIG.SYS file
  304.        has the default values for a 12 megabyte machine.  This example
  305.        presents a temporary CONFIG.SYS to be used only with the
  306.        tutorial.  Upon completion of the tutorial, the original
  307.        CONFIG.SYS should be restored.  All of this is explained in the
  308.        text below.  The effect of changes such as these are dependent
  309.        upon your system hardware and software configuration, and upon
  310.        other applications that will be running in your environment.
  311.  
  312.        In this example, the CONFIG.SYS file is assumed to be on the C
  313.        drive.
  314.  
  315.         1. Save a copy of the original CONFIG.SYS as this file needs to be
  316.            restored after running the tutorials.
  317.  
  318.                 COPY C:\CONFIG.SYS C:\CONFIG.OLD
  319.  
  320.         2. Change the following values in CONFIG.SYS.  For further
  321.            information on these OS/2 variables, consult the OS/2 help
  322.            facility.
  323.  
  324.                 BUFFERS=80
  325.  
  326.                         This variable is in all CONFIG.SYS files, its
  327.                         default value is 30.
  328.  
  329.                 DISKCACHE=64,LW,32
  330.  
  331.                         This variable is in all CONFIG.SYS files, the
  332.                         default value depends on the amount of available
  333.                         memory and the type of filesystem format, FAT or
  334.                         HPFS.
  335.  
  336.                         Your CONFIG.SYS may have other values included
  337.                         with the DISKCACHE variable.  The important
  338.                         parameters in this example are "64" (block size)
  339.                         and "32" (threshold)
  340.  
  341.                 PRIORITY=ABSOLUTE
  342.  
  343.                         This variable is usually not in CONFIG.SYS, add
  344.                         this line at the end of the file.
  345.  
  346.         3. Shutdown and reboot the system
  347.  
  348.         4. Upon completion of the tutorials, copy the modified CONFIG.SYS
  349.            to CONFIG.TUT.
  350.  
  351.                 COPY C:\CONFIG.SYS C:\CONFIG.TUT
  352.  
  353.         5. Restore the orignal CONFIG.SYS which you saved in the first
  354.            step.
  355.  
  356.                 COPY C:\CONFIG.OLD C:\CONFIG.SYS
  357.  
  358.         6. Shutdown and reboot the system
  359.  
  360.  
  361.  
  362.  
  363. TRADEMARK INFORMATION
  364. _____________________
  365.  
  366.  
  367.    Terms which have been marked with a (R) in this document are
  368.    registered trademarks as follows:
  369.  
  370.           IBM and OS/2 are registered trademarks of
  371.           International Business Machines Corperation.
  372.  
  373.           TARGA is a registered trademark of Truevision, Inc.
  374.  
  375.  
  376.    Terms which have been marked with a (TM) in this document are
  377.    trademarks of International Business Machines Corporation as follows:
  378.  
  379.           Ultimedia
  380.