home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / plitlk11.zip / VPLPREAD.ME < prev    next >
Text File  |  1995-06-26  |  10KB  |  239 lines
  1.   *****************************************************************
  2.   *****************************************************************
  3.   ****                                                         ****
  4.   ****  Thank you for evaluating PL/I for OS/2 Toolkit.        ****
  5.   ****  You have 60 days from today to explore the capability  ****
  6.   ****  of this product.                                       ****
  7.   ****                                                         ****
  8.   ****  Call the Santa Teresa Laboratory at 800-IBM-4STL       ****
  9.   ****  if you have questions.                                 ****
  10.   ****                                                         ****
  11.   *****************************************************************
  12.   *****************************************************************
  13.  
  14. ================================
  15. IBM* PL/I Toolkit for OS/2* READ.ME file.
  16.  
  17.  This file contains information that may not be available in the
  18.  documentation you receive with the PL/I Toolkit for OS/2.
  19.  
  20.  IBM PL/I Toolkit for OS/2 Version 1 Release 1
  21.  (C) Copyright IBM Corp. 1994. All Rights Reserved. US Government
  22.  Users Restricted Rights--Use, duplication or disclosure restricted
  23.  by GSA ADP Schedule Contract with IBM Corp.
  24. ================================
  25.  
  26.  =================================================================
  27.   ********************************************
  28.   * Corrective Services Diskette (CSD) #0001*
  29.   ********************************************
  30.  
  31.   The following list includes corrections or enhancements that
  32.   have been made to the PL/I for OS/2 Toolkit Version 1 Release 1:
  33.  
  34.   - Under OS/2 Warp 3.0, the Object Manager will now display correctly.
  35.  
  36.   - A new option, DBCS, has been added to the Settings notebook, on
  37.     the NLS page.  The NLS option has been renamed to MRI.  Press the
  38.     Help button on the NLS page of the Settings notebook for more
  39.     information.
  40.  
  41.   - Problems arising when a Visual PL/I project is saved to a drive other
  42.     than the Visual PL/I installation drive have been fixed.
  43.  
  44.   - All project source files can now be viewed from within Visual PL/I,
  45.     and all project-related files will be deleted when a project is deleted.
  46.  
  47.   - Improved font handling when displaying source code.
  48.  
  49.   - Miscellaeous minor bug fixes.
  50.  
  51.   - New options have been added to the C2PLI conversion utility.  Enter
  52.     C2PLI with no arguments for more information.
  53.  
  54.  =================================================================
  55.  
  56. Welcome to Visual PL/I!
  57.  
  58. This file contains the following sections:
  59.  
  60. 1. Warning on level of PL/I for OS/2
  61. 2. Reference to restrictions on the C2PLI tool
  62. 3. New OS/2 header file information
  63. 4. Known restrictions with Visual PL/I
  64.  
  65. 1. Warning on level of PL/I for OS/2
  66.  
  67.    If the PMWIN.CPY file in the \IBMPLI\INCLUDE directory is
  68.    dated June 1, 1994 (Personal Version) or June 2, 1994
  69.    (Professional Version) or earlier, then you MUST install
  70.    the version of PMWIN.CPY that comes with the Visual PL/I product.
  71.    You can find this file in the \PLITK\INCLUDE
  72.    directory with a name of PMWIN.CPN.  Rename the existing
  73.    PMWIN.CPY file in the \IBMPLI\INCLUDE directory, then copy
  74.    the Visual PL/I version into that directory, renaming it
  75.    to PMWIN.CPY.
  76.  
  77. 2. Reference to restrictions on the C2PLI tool
  78.  
  79.    Please refer to the CREAD.ME file in the base Visual PL/I
  80.    directory for information and tips on using the C2PLI tool
  81.    provided with the PL/I for OS/2 Toolkit product.
  82.  
  83. 3. New OS/2 header file information
  84.  
  85.    Newer versions of the OS/2 header files have been provided
  86.    with the Visual PL/I product.  They can be found in the
  87.    \PLITK\NEWCPY\*.CV2 directory.  If you decide to use them,
  88.    please copy them to a directory along your INCLUDE path and
  89.    rename them to *.CPY.
  90.  
  91. 4. Known restrictions with Visual PL/I
  92.  
  93.    A. Scrolling problem in HELP information window
  94.  
  95.       Problem:
  96.       Use of the scroll bar in the Identifiers drop-down list
  97.       may cause Visual PL/I to end unexpectedly.  It seems to
  98.       only occur on fast machines.
  99.  
  100.       Answer:
  101.       To go up or down in the drop-down list, make the furthest
  102.       identifier in the direction you are going the current
  103.       selection.  Drop the list down again and repeat until you
  104.       reach your identifier.
  105.  
  106.       To minimize lost information, enter the text for the
  107.       current identifier then select OK.  Click the right mouse
  108.       button on the base project and select SAVE.  Go back to
  109.       the Help information window, select the next identifier,
  110.       then repeat the process.
  111.  
  112.    B. System Bitmaps are not shown when Visual PL/I is restarted
  113.  
  114.       Problem:
  115.       When more than one system bitmap is placed in a window
  116.       and saved, and then Visual PL/I is stopped and restarted, only
  117.       the first system bitmap will appear in the window when it
  118.       is redisplayed.  An empty rectangle will appear where any
  119.       other system bitmap was placed.
  120.  
  121.       Answer:
  122.       Even though the picture doesn't reappear, the system still
  123.       remembers which system bitmap was originally placed there.  To
  124.       bring back the picture, click the right mouse button on the
  125.       empty rectangle, select CHANGE...  (or press Enter), then
  126.       select OK (or press enter).  The system bitmap will reappear.
  127.  
  128.    C. Bitmaps in dialog boxes do not respond to resizing
  129.  
  130.       Problem:
  131.       When a bitmap is placed in a dialog box and is resized, the
  132.       bitmap in the compiled version of that dialog box does not
  133.       reflect the resizing.
  134.  
  135.       Answer:
  136.       Resizing of bitmaps in dialog boxes is not supported.  The
  137.       bitmap in the compiled dialog box appears as the size of the
  138.       bitmap when it was originally created.  If you wish to
  139.       resize a bitmap, use a window instead of a dialog box.
  140.       Resizing of bitmaps is supported in windows.
  141.  
  142.    D. 'Output windows and menus to .DLG' restrictions
  143.  
  144.       Problem:
  145.       The setting of the 'Output windows and menus to .DLG' option
  146.       on the 'Output Options' page in the Project Settings Notebook is
  147.       restricted to the initial opening of a project.  Changing
  148.       this option after windows or menus have been added to the
  149.       project will cause unpredictable results and is not supported.
  150.  
  151.       Answer:
  152.       If the setting must be changed, you can change it in the
  153.       following way:
  154.  
  155.       1. Create a new code block in the 'My Code Blocks' library and
  156.          name it 'Create a primary window'.  Create the new code block
  157.          by combining the 'Create Std Window' and 'Set Window Pos'
  158.          code blocks found in PMGUIDE.PLF.  Your new code block
  159.          would look something like this:
  160.  
  161.          ++++++++++++++++++++  begin code block +++++++++++++++++++++++
  162.  
  163.             &&pmgmycb.obj BEGIN Create a primary window
  164.             GLOBAL_VARIABLES dcl WINDOW MODULEHANDLE HMODULE;
  165.             INITFUNCTION WINDOW MODULEHANDLE=hModule0;
  166.  
  167.             /* Create a standard window */
  168.  
  169.             WINDOW HANDLE = WinCreateStdWindow(WINDOW PARENT,
  170.                                                ior(WINDOW STYLECOMMA),
  171.                                                WINDOW FCFVAR,
  172.                                                WINDOW CLASS,
  173.                                                WINDOW TITLE,
  174.                                                0,
  175.                                                WINDOW MODULEHANDLE,
  176.                                                WINDOW ID,
  177.                                                addr( WINDOW CLHANDLE ));
  178.  
  179.  
  180.  
  181.             /* Set the window position */
  182.             call WinSetWindowPos(WINDOW HANDLE,
  183.                             HWND_BOTTOM,
  184.                             WINDOW XPOS,
  185.                             WINDOW YPOS,
  186.                             WINDOW XSIZE,
  187.                             WINDOW YSIZE,
  188.                             ior(SWP_MOVE , SWP_SIZE , SWP_ACTIVATE)     );
  189.  
  190.             END
  191.  
  192.          ++++++++++++++++++++  end code block +++++++++++++++++++++++
  193.  
  194.       2. When you change the state of the DLG check box you will need to
  195.          also change the way the primary window is loaded.  To do this,
  196.          click on the right mouse button in the client area of the
  197.          project you are working on and select the LINKS...  item.  Then
  198.          page down the EVENT list box until you find CREATE_STD_WINDOW,
  199.          then select it.  The current code block title will appear in the
  200.          EVENT LINKS list box.
  201.  
  202.          Do one of the following:
  203.  
  204.          If the DLG check box was initially checked but was changed
  205.          to an unchecked state, then you need to replace the 'Load a
  206.          window from a window template' code block with the 'Create
  207.          a primary window' code block you have just created.
  208.  
  209.          If the DLG check box was initially unchecked but was changed
  210.          to a checked state, then you need to replace the 'Create
  211.          Std Window' (or 'Create a primary window') code block with
  212.          the 'Load a window from a window template' code block, which
  213.          can be found in the 'Basic PM Functions' library.
  214.  
  215.       3. Now Save and Build the project to make the changes take
  216.          effect.
  217.  
  218. E. Linker errors when building DLLs.
  219.  
  220.    Problem:
  221.    The linker gives a warning message when building a DLL.  The
  222.    initialization routine, CEE2DIUX, will not be called.
  223.  
  224.    Answer:
  225.    Add the /NOE to the linker options by following these steps.
  226.      1. Clicking on the client area of the project window.
  227.      2. Select Open and then Settings.
  228.      3. Select Compiler & Link.
  229.      4. Add /NOE to the linker command entry field.  The entry
  230.         should now be 'LINK386 /CO /PM:PM /NOE'.
  231.  
  232.  TRADEMARKS
  233.   __________
  234.  
  235.   The following items are trademarks of the IBM Corporation:
  236.       IBM
  237.       OS/2
  238.  
  239.