home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / pltkcsd3.zip / PLITKCSD.DOC < prev    next >
Text File  |  1996-08-06  |  14KB  |  287 lines
  1. =====================================================================
  2.   IBM PL/I for OS/2 Toolkit CSD READ.ME file.
  3.   This file contains information that may not be available in the
  4.   documentation you receive with PL/I for OS/2 Toolkit.
  5.   IBM PL/I for OS/2 Toolkit Version 1 Release 1
  6.   (C) Copyright IBM Corp. 1996. All Rights Reserved. US Government
  7.   Users Restricted Rights--Use, duplication or disclosure restricted
  8.   by GSA ADP Schedule Contract with IBM Corp.
  9. =====================================================================
  10.  
  11. CSD#3 is cumulative and contains the LPEX Editor and ILINK linker
  12. that were part of CSD#2.  Because of these new parts, CSD#2 (and
  13. consequently CSD#3), require approximately 11.5 MB on your hard disk
  14. in addition to the space you used to install the original toolkit.
  15.  
  16. INSTALLATION:
  17. To Start the CSD Installation, place DISKETTE #1 into drive A:
  18. 1) Enter SERVICE.
  19. 2) Hit CONTINUE in the README window.
  20. 3) Hit Continue in the Installation Options window. (This will update
  21.    components.)
  22. 4) Hit Update in the Update Window.  (This will update CONFIG.SYS and
  23.    save BACKUP version so that in case of error during installation,
  24.    the previous version can be restored.  Remember to delete this
  25.    copy after successful install of CSD.
  26. 5) Hit OK in the Installation and Maintenance window.
  27. 6) Hit EXIT in Logo Window.
  28. =================================================================
  29. ********************************************
  30. * Corrective Services Diskette (CSD) #0003 *
  31. ********************************************
  32.  
  33. The Performance Analyzer (execution trace tool) has been added to the
  34. Toolkit as part of this CSD.  In order to create a trace using the
  35. Performance Analyzer, you should:
  36.    - Compile your program with PROFILE and GONUMBER
  37.    - Link the resulting object file with IBMOPA3.OBJ and use the /DE /NOE
  38.      linker options.
  39. Online help is available from within the Performance Analyzer from the
  40. pull-down menus.
  41.  
  42. An online version of the Toolkit Reference Guide is included as part of
  43. this CSD.  There have been changes made to the book that are in the
  44. online version but are not reflected in the printed version of the book.
  45.  
  46. The following code blocks for the visual PL/I builder have been added
  47. in this CSD:
  48.  
  49.  Debug Functions
  50.     Function                       Description
  51.     --------------------------     -------------------------------------------
  52.     Display a string               Displays a string using WinMessageBox.
  53.     Display string ║║ variable     Displays a string and a variable using
  54.                                      WinMessageBox.
  55.     Display a variable             Displays a variable using WinMessageBox.
  56.  
  57.  
  58.  File Dialog  Functions
  59.     Function                       Description
  60.     --------------------------     -------------------------------------------
  61.     Display File Dialog Control    Displays the File Dialog control for
  62.                                      selecting files.
  63.  
  64.  
  65.  Multimedia Functions
  66.     Function                       Description
  67.     --------------------------     -------------------------------------------
  68.     CMD Open Audio                 Opens an audio device using the
  69.                                      MCI command interface.
  70.     CMD Open Audio VAR             Opens an audio device with a variable
  71.                                      using the MCI command interface.
  72.     CMD Load Audio                 Loads an audio file for play using the
  73.                                      MCI command interface.
  74.     CMD Play Audio                 Plays an audio device using the MCI command
  75.                                      interface.
  76.     CMD Rewind Audio               Rewinds an audio device using the MCI command
  77.                                      interface.
  78.     CMD Close Audio                Closes an audio device using the MCI command
  79.                                      interface.
  80.     STR Open Audio                 Opens an audio device for play using the
  81.                                      MCI string interface.
  82.     STR Acquire Audio              Acquires an audio device using the
  83.                                      MCI string interface.
  84.     STR Load Audio                 Loads an audio device using the
  85.                                      MCI string interface.
  86.     STR Load Audio from VAR        Loads an audio device from a variable using
  87.                                      the MCI string interface.
  88.     STR Play Audio                 Plays an audio device using the
  89.                                      MCI string interface.
  90.     STR Rewind Audio               Rewinds an audio device using the
  91.                                      MCI string interface.
  92.     STR Release Audio              Releases an audio device using the
  93.                                      MCI string interface.
  94.     STR Close Audio                Closes an audio device using the
  95.                                      MCI string interface.
  96.     STR Acq/Play/Rew/Rel Audio     Acquires, plays, rewinds, and releases
  97.                                      an audio device using the
  98.                                      MCI string interface.
  99.     CMD Open Video                 Opens a video device using the
  100.                                      MCI command interface.
  101.     CMD Load Video                 Loads a video device using the
  102.                                      MCI command interface.
  103.     CMD Load Video from VAR        Loads a video device from a variable
  104.                                      using the MCI command interface.
  105.     CMD Window Video               Sets the window for a video device
  106.                                      using the MCI command interface.
  107.     CMD State Video                Gets the state of a video device
  108.                                      using the MCI command interface.
  109.     CMD Cue Video                  Cues a video device using the
  110.                                      MCI command interface.
  111.     CMD Put Video                  Puts a rectangle for a video device
  112.                                      using the MCI command interface.
  113.     CMD Play Video                 Plays a video device using the
  114.                                      MCI command interface.
  115.     CMD Rewind Video               Rewinds a video device using the
  116.                                      MCI command interface.
  117.     CMD Close Video                Closes a video device using the
  118.                                      MCI command interface.
  119.     STR Open Video                 Opens a video device using the
  120.                                      MCI string interface.
  121.     STR Acquire Video              Acquires a video device using the
  122.                                      MCI string interface.
  123.     STR Load Video                 Loads a video device using the
  124.                                      MCI string interface.
  125.     STR Play Video                 Plays a video device using the
  126.                                      MCI string interface.
  127.     STR Rewind Video               Rewinds a video device using the
  128.                                      MCI string interface.
  129.     STR Release Video              Releases a video device using the
  130.                                      MCI string interface.
  131.     STR Close Video                Closes a video device using the
  132.                                      MCI string interface.
  133.     STR Acq/Play/Rew/Rel Video     Acquires, plays, rewinds, and releases
  134.                                      a video device using the
  135.                                      MCI string interface.
  136.     MM Get Audio Error             Gets audio error information.
  137.     MM Get Video Error             Gets video error information.
  138.     MM Start Audio Recorder        Starts the Audio Recorder in a
  139.                                      separate DOS session.
  140.     Generic mciSendString          Generic MCI string interface code block.
  141.     mciPlayFile                    Plays an audio file using the
  142.                                      mciPlayFile interface.
  143.     mciPlayFile in VAR             Plays an audio file from a variable
  144.                                      using the mciPlayFile interface.
  145.     mciRecordAudioFile             Records an audio file using the
  146.                                      mciRecordAudioFile interface.
  147.  
  148. About the Debug Functions:
  149.  
  150.   - With the release of PL/I for OS/2 V1.2, the use of the PL/I display
  151.     statement is no longer supported in PM programs.  You can use the new
  152.     Debug code blocks where you used to use the PL/I display statement.
  153.  
  154. About the Multimedia Functions:
  155.  
  156.   - Two sets of code blocks are provided.  One set is written to the
  157.     MCI String interface, the other set is written to the MCI Command
  158.     interface.  For more information about these interfaces, please
  159.     refer to the Multimedia Presentation Manager/2 documentation.
  160.  
  161.   - A small sample multimedia program has been provided.  This program,
  162.     MMSAMPLE, shows how to trigger the playing of .wav files on a
  163.     thread using some of the new multimedia code blocks.  The program
  164.     assumes you have the MMPM/2 features of the OS/2 operating system
  165.     installed in the C:\MMOS2 directory.  If you have installed the
  166.     MMPM2 features in a different directory, you must update the
  167.     MMSAMPLE program with the appropriate path.  Use 'Load Project...'
  168.     to load the MMSAMPLE.PMG file.
  169.  
  170.   - The following MCI header files are provided to support the new
  171.     multimedia code blocks:
  172.  
  173.      MCIAPI.CPY - Transformed from C to PL/I in its entirety using the
  174.                   C2PLI tool.
  175.      MCIOS2.CPY - A subset of the original mcios2.h file was transformed.
  176.                   The supplied mcios2.cpy file will support all of the
  177.                   function in the multimedia code blocks.  If the user
  178.                   would like to extend the supplied code blocks,
  179.                   additional translation of the mcios2.h file may be
  180.                   necessary.
  181.  
  182. Other changes with this CSD:
  183.  
  184.   - Users can now specify their own code block names for Any Code
  185.     code blocks.  Simply provide a PL/I comment (/* ... */) on the
  186.     first line of the Any Code code block and it will appear as the
  187.     code block name in the Event Links list box.  The code block name
  188.     is loaded at two different points in the project development
  189.     process: during the initial project load (when the *.pmg file is
  190.     read) and when a new code block is created.  After installing CSD#3,
  191.     all Any Code code blocks with PL/I comments on their first line will
  192.     have a new, more descriptive, name.  To change the name of an existing
  193.     Any Code code block, simply add a PL/I comment as the first line
  194.     and save.  The next time the project is loaded the new code block
  195.     name will appear.
  196.  
  197.   - The problem with the DLL Import Variable code block has been fixed.
  198.  
  199.   - All list boxes now have their first item selected automatically
  200.       if no other selections have been made.
  201.  
  202.   - The GRAPHIC compiler option is not the default anymore.  You
  203.       must choose the DBCS option on the NLS page of the Settings
  204.       notebook to get the GRAPHIC compiler option.
  205.  
  206.   - Assorted cosmetic problems were corrected.
  207.  
  208. Known problems:
  209.  
  210.   - WS_DISABLE style on a control disables any further changes to the
  211.     control:
  212.  
  213.       Once the WS_DISABLE style has been assigned to a control you
  214.       cannot change that control from within Visual PL/I.  To enable
  215.       a WS_DISABLEd control you must do the following:
  216.         1. Edit the *.pmg file and find the #define for that control.
  217.            For example, PB_BUTTON1.
  218.         2. Three lines above that #define you will see a 8 character
  219.            string that begins with a 'c'.  For example, c0000000.
  220.         3. Change the 'c' to an '8', save the .pmg file and the
  221.            control should be re-enabled the next time you load the
  222.            project.
  223.  
  224. ********************************************
  225. * Corrective Services Diskette (CSD) #0002 *
  226. ********************************************
  227.  
  228.   The following list includes corrections or enhancements that
  229.   have been made to the PL/I for OS/2 Toolkit Version 1 Release 1
  230.   since CSD#1:
  231.  
  232.   - The LPEX editor is now available.  Run LPEX by double
  233.     clicking on the "LPEX Editor" icon in the PL/I Toolkit
  234.     folder, or by entering LXPM on the command line.  A guide for
  235.     using LPEX with PL/I has been included in .INF format with
  236.     this CSD.  To view the online document, double click on the
  237.     "LPEX Guide" icon in the PL/I Toolkit folder.
  238.  
  239.   - Support for the ILINK linker is now included in the PL/I
  240.     for OS/2 Toolkit.  To view the online document, double click
  241.     on the "ILINK Guide" icon in the PL/I Toolkit folder.  For
  242.     ILINK arguments, enter the following at the command line:
  243.            ILINK /?
  244.  
  245.   - The ILIB librarian is also supported.  For ILIB arguments, enter:
  246.            ILIB /?
  247.  
  248.   - No fixes have been made to Visual PL/I or C2PLI beyond what was
  249.     in CSD #1.
  250.  
  251.  =================================================================
  252.   ********************************************
  253.   * Corrective Services Diskette (CSD) #0001 *
  254.   ********************************************
  255.  
  256.   The following list includes corrections or enhancements that
  257.   have been made to the PL/I for OS/2 Toolkit Version 1 Release 1:
  258.  
  259.   - Under OS/2 Warp 3.0, the Object Manager will now display correctly.
  260.  
  261.   - A new option, DBCS, has been added to the Settings notebook, on
  262.     the NLS page.  The NLS option has been renamed to MRI.  Press the
  263.     Help button on the NLS page of the Settings notebook for more
  264.     information.
  265.  
  266.   - Problems arising when a Visual PL/I project is saved to a drive other
  267.     than the Visual PL/I installation drive have been fixed.
  268.  
  269.   - All project source files can now be viewed from within Visual PL/I,
  270.     and all project-related files will be deleted when a project is deleted.
  271.  
  272.   - Improved font handling when displaying source code.
  273.  
  274.   - Miscellaeous minor bug fixes.
  275.  
  276.   - New options have been added to the C2PLI conversion utility.  Enter
  277.     C2PLI with no arguments for more information.
  278.  
  279.  
  280.   TRADEMARKS
  281.   __________
  282.  
  283.   The following items are trademarks of the IBM Corporation:
  284.       IBM
  285.       OS/2
  286.  
  287.