This file contains release information for the EXTRA! Tools for 
PowerBuilder not available in the released documentation.             
            
            Environment Concerns            
            ====================

If you plan on using Attachmate's automation tools, and since you have 
received this product you probably are, you need to have the directory 
to your EXTRA! executable files in your path variable in your AUTOEXEC.BAT.
            
...........................................................................
            
            Sample applications 
            ===================

Application Icons:

If you install the EXTRA! Tools for PowerBuilder in a directory other
than the default, "C:\PBTOOLS" the associated icon for the provided
samples will need to be reasigned the new directory path. UTILS.PBL  
has the cooresponding icon, UTILS.ICO, and the SAMPOBJS.PBL has the 
cooresponding icon, SAMPOBJS.ICO, that will both be located in the 
directory that you specified during installation.

Sample assumptions:

Both samples assume that you have EXTRA! for Windows installed and 
the current configuration has session A defined.

...........................................................................              
            
            Common Function Library string buffers
            ======================================

When calling a Common Function Library function that returns data in a 
string buffer you must make sure that sufficient space is allocated for 
the PowerBuilder string in use by other PowerBuilder variables. Not doing 
so may cause data corruption, application errors or General Protection 
Faults.The following sample code demonstrates one way to allocate space 
to a string buffer before calling a Common Function Library function.  
The statement "text = space(255)" allocates 255 bytes for the string 
variable text:

            string text
            int rc
            text = space(255)

            rc = ATMGetString(hWnd, 1, 1, text, 50)
...........................................................................

ATMGLOBS.TXT

The documentation that accompanies this product refers to a text file
called "ATMGLOBS.TXT" and includes instructions on how to include it
in your application. These variables are not needed any longer and can
be disregarded. For those Beta testers who did include these in their 
programs, you may continue using them as before with no problems.

...........................................................................

BETA Testers:

EXTRA! Tools for PowerBuilder program group

        WARNING, WARNING, WARNING!
        
This program group will be deleted, then rebuilt for you on installation 
of the 1.01 version. Please be aware that anything you may have copied into
that program group will not be available through this group after 
installing v1.01
No files will be deleted, however, and you may reinstall your group items 
as you had had them as before. It is recommended that you use a separate 
program group for your own applications and avoid storing anything in the 
EXTRA! Tools for PowerBuilder program group.

...........................................................................

Custom Objects:

MESSENGR - Because of message queing problems that are out of our 
           control, some last minute changes were necessary in the 
           operation of this control. 
           1) The PSUPDATE setting in the text of the control has 3
              settings.
                0 = No PSUPDATES
                1 = All updates except OIA updates
                2 = All updates except PSupdates.
                (please refer to documentation for more information
                 on these settings.)
           2) If the KINTERCEPT setting is 1, only aid keys will be 
              intercepted. This includes all function keys, enter, tab,
              etc.
