home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
OS/2 Shareware BBS: 10 Tools
/
10-Tools.zip
/
pltkcsd3.zip
/
PLITKCSD.DOC
< prev
next >
Wrap
Text File
|
1996-08-06
|
14KB
|
287 lines
=====================================================================
IBM PL/I for OS/2 Toolkit CSD READ.ME file.
This file contains information that may not be available in the
documentation you receive with PL/I for OS/2 Toolkit.
IBM PL/I for OS/2 Toolkit Version 1 Release 1
(C) Copyright IBM Corp. 1996. All Rights Reserved. US Government
Users Restricted Rights--Use, duplication or disclosure restricted
by GSA ADP Schedule Contract with IBM Corp.
=====================================================================
CSD#3 is cumulative and contains the LPEX Editor and ILINK linker
that were part of CSD#2. Because of these new parts, CSD#2 (and
consequently CSD#3), require approximately 11.5 MB on your hard disk
in addition to the space you used to install the original toolkit.
INSTALLATION:
To Start the CSD Installation, place DISKETTE #1 into drive A:
1) Enter SERVICE.
2) Hit CONTINUE in the README window.
3) Hit Continue in the Installation Options window. (This will update
components.)
4) Hit Update in the Update Window. (This will update CONFIG.SYS and
save BACKUP version so that in case of error during installation,
the previous version can be restored. Remember to delete this
copy after successful install of CSD.
5) Hit OK in the Installation and Maintenance window.
6) Hit EXIT in Logo Window.
=================================================================
********************************************
* Corrective Services Diskette (CSD) #0003 *
********************************************
The Performance Analyzer (execution trace tool) has been added to the
Toolkit as part of this CSD. In order to create a trace using the
Performance Analyzer, you should:
- Compile your program with PROFILE and GONUMBER
- Link the resulting object file with IBMOPA3.OBJ and use the /DE /NOE
linker options.
Online help is available from within the Performance Analyzer from the
pull-down menus.
An online version of the Toolkit Reference Guide is included as part of
this CSD. There have been changes made to the book that are in the
online version but are not reflected in the printed version of the book.
The following code blocks for the visual PL/I builder have been added
in this CSD:
Debug Functions
Function Description
-------------------------- -------------------------------------------
Display a string Displays a string using WinMessageBox.
Display string ║║ variable Displays a string and a variable using
WinMessageBox.
Display a variable Displays a variable using WinMessageBox.
File Dialog Functions
Function Description
-------------------------- -------------------------------------------
Display File Dialog Control Displays the File Dialog control for
selecting files.
Multimedia Functions
Function Description
-------------------------- -------------------------------------------
CMD Open Audio Opens an audio device using the
MCI command interface.
CMD Open Audio VAR Opens an audio device with a variable
using the MCI command interface.
CMD Load Audio Loads an audio file for play using the
MCI command interface.
CMD Play Audio Plays an audio device using the MCI command
interface.
CMD Rewind Audio Rewinds an audio device using the MCI command
interface.
CMD Close Audio Closes an audio device using the MCI command
interface.
STR Open Audio Opens an audio device for play using the
MCI string interface.
STR Acquire Audio Acquires an audio device using the
MCI string interface.
STR Load Audio Loads an audio device using the
MCI string interface.
STR Load Audio from VAR Loads an audio device from a variable using
the MCI string interface.
STR Play Audio Plays an audio device using the
MCI string interface.
STR Rewind Audio Rewinds an audio device using the
MCI string interface.
STR Release Audio Releases an audio device using the
MCI string interface.
STR Close Audio Closes an audio device using the
MCI string interface.
STR Acq/Play/Rew/Rel Audio Acquires, plays, rewinds, and releases
an audio device using the
MCI string interface.
CMD Open Video Opens a video device using the
MCI command interface.
CMD Load Video Loads a video device using the
MCI command interface.
CMD Load Video from VAR Loads a video device from a variable
using the MCI command interface.
CMD Window Video Sets the window for a video device
using the MCI command interface.
CMD State Video Gets the state of a video device
using the MCI command interface.
CMD Cue Video Cues a video device using the
MCI command interface.
CMD Put Video Puts a rectangle for a video device
using the MCI command interface.
CMD Play Video Plays a video device using the
MCI command interface.
CMD Rewind Video Rewinds a video device using the
MCI command interface.
CMD Close Video Closes a video device using the
MCI command interface.
STR Open Video Opens a video device using the
MCI string interface.
STR Acquire Video Acquires a video device using the
MCI string interface.
STR Load Video Loads a video device using the
MCI string interface.
STR Play Video Plays a video device using the
MCI string interface.
STR Rewind Video Rewinds a video device using the
MCI string interface.
STR Release Video Releases a video device using the
MCI string interface.
STR Close Video Closes a video device using the
MCI string interface.
STR Acq/Play/Rew/Rel Video Acquires, plays, rewinds, and releases
a video device using the
MCI string interface.
MM Get Audio Error Gets audio error information.
MM Get Video Error Gets video error information.
MM Start Audio Recorder Starts the Audio Recorder in a
separate DOS session.
Generic mciSendString Generic MCI string interface code block.
mciPlayFile Plays an audio file using the
mciPlayFile interface.
mciPlayFile in VAR Plays an audio file from a variable
using the mciPlayFile interface.
mciRecordAudioFile Records an audio file using the
mciRecordAudioFile interface.
About the Debug Functions:
- With the release of PL/I for OS/2 V1.2, the use of the PL/I display
statement is no longer supported in PM programs. You can use the new
Debug code blocks where you used to use the PL/I display statement.
About the Multimedia Functions:
- Two sets of code blocks are provided. One set is written to the
MCI String interface, the other set is written to the MCI Command
interface. For more information about these interfaces, please
refer to the Multimedia Presentation Manager/2 documentation.
- A small sample multimedia program has been provided. This program,
MMSAMPLE, shows how to trigger the playing of .wav files on a
thread using some of the new multimedia code blocks. The program
assumes you have the MMPM/2 features of the OS/2 operating system
installed in the C:\MMOS2 directory. If you have installed the
MMPM2 features in a different directory, you must update the
MMSAMPLE program with the appropriate path. Use 'Load Project...'
to load the MMSAMPLE.PMG file.
- The following MCI header files are provided to support the new
multimedia code blocks:
MCIAPI.CPY - Transformed from C to PL/I in its entirety using the
C2PLI tool.
MCIOS2.CPY - A subset of the original mcios2.h file was transformed.
The supplied mcios2.cpy file will support all of the
function in the multimedia code blocks. If the user
would like to extend the supplied code blocks,
additional translation of the mcios2.h file may be
necessary.
Other changes with this CSD:
- Users can now specify their own code block names for Any Code
code blocks. Simply provide a PL/I comment (/* ... */) on the
first line of the Any Code code block and it will appear as the
code block name in the Event Links list box. The code block name
is loaded at two different points in the project development
process: during the initial project load (when the *.pmg file is
read) and when a new code block is created. After installing CSD#3,
all Any Code code blocks with PL/I comments on their first line will
have a new, more descriptive, name. To change the name of an existing
Any Code code block, simply add a PL/I comment as the first line
and save. The next time the project is loaded the new code block
name will appear.
- The problem with the DLL Import Variable code block has been fixed.
- All list boxes now have their first item selected automatically
if no other selections have been made.
- The GRAPHIC compiler option is not the default anymore. You
must choose the DBCS option on the NLS page of the Settings
notebook to get the GRAPHIC compiler option.
- Assorted cosmetic problems were corrected.
Known problems:
- WS_DISABLE style on a control disables any further changes to the
control:
Once the WS_DISABLE style has been assigned to a control you
cannot change that control from within Visual PL/I. To enable
a WS_DISABLEd control you must do the following:
1. Edit the *.pmg file and find the #define for that control.
For example, PB_BUTTON1.
2. Three lines above that #define you will see a 8 character
string that begins with a 'c'. For example, c0000000.
3. Change the 'c' to an '8', save the .pmg file and the
control should be re-enabled the next time you load the
project.
********************************************
* Corrective Services Diskette (CSD) #0002 *
********************************************
The following list includes corrections or enhancements that
have been made to the PL/I for OS/2 Toolkit Version 1 Release 1
since CSD#1:
- The LPEX editor is now available. Run LPEX by double
clicking on the "LPEX Editor" icon in the PL/I Toolkit
folder, or by entering LXPM on the command line. A guide for
using LPEX with PL/I has been included in .INF format with
this CSD. To view the online document, double click on the
"LPEX Guide" icon in the PL/I Toolkit folder.
- Support for the ILINK linker is now included in the PL/I
for OS/2 Toolkit. To view the online document, double click
on the "ILINK Guide" icon in the PL/I Toolkit folder. For
ILINK arguments, enter the following at the command line:
ILINK /?
- The ILIB librarian is also supported. For ILIB arguments, enter:
ILIB /?
- No fixes have been made to Visual PL/I or C2PLI beyond what was
in CSD #1.
=================================================================
********************************************
* Corrective Services Diskette (CSD) #0001 *
********************************************
The following list includes corrections or enhancements that
have been made to the PL/I for OS/2 Toolkit Version 1 Release 1:
- Under OS/2 Warp 3.0, the Object Manager will now display correctly.
- A new option, DBCS, has been added to the Settings notebook, on
the NLS page. The NLS option has been renamed to MRI. Press the
Help button on the NLS page of the Settings notebook for more
information.
- Problems arising when a Visual PL/I project is saved to a drive other
than the Visual PL/I installation drive have been fixed.
- All project source files can now be viewed from within Visual PL/I,
and all project-related files will be deleted when a project is deleted.
- Improved font handling when displaying source code.
- Miscellaeous minor bug fixes.
- New options have been added to the C2PLI conversion utility. Enter
C2PLI with no arguments for more information.
TRADEMARKS
__________
The following items are trademarks of the IBM Corporation:
IBM
OS/2