home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
OS/2 Shareware BBS: 10 Tools
/
10-Tools.zip
/
vabasi11.zip
/
IP21153O.ZIP
/
OS2
/
SERVER
/
README.1ST
< prev
next >
Wrap
Text File
|
1997-06-10
|
26KB
|
614 lines
========================================================================
IBM VisualAge for Basic for OS/2 and for Windows Version 1.1
README File
========================================================================
Licensed Materials -- Property of IBM.
IMPORTANT: The license for this version of IBM VisualAge for
Basic starts just after the table of contents below. If you are
installing this product, please page down and read the license. If you
agree to the terms of the license, signify your agreement by continuing
with the installation. If you do not agree to the terms of the license,
then you have to cancel the install. For other translations of this
license agreement, please look in the \VABASIC\LICENSE subdirectory.
For a description of known product defects and restrictions, please
read the VERSION1.TXT file located in the \VABASIC directory.
========================================================================
Table of Contents
1. License Agreement
2. About Product Support
3. Installation Information
4. Guide to VisualAge for Basic Documentation
5. Description of Functions Supported in this Version
6. Copyright Notice and Trademarks for this README File
========================================================================
1. INTERNATIONAL PROGRAM LICENSE AGREEMENT
__________________________________________
Part 1 - General Terms
______________________
PLEASE READ THIS AGREEMENT CAREFULLY BEFORE USING THE PROGRAM. IBM WILL
ONLY LICENSE THE PROGRAM TO YOU IF YOU FIRST ACCEPT THE TERMS OF THIS
AGREEMENT BY USING THE PROGRAM. IF YOU DO NOT AGREE TO THE TERMS OF
THIS AGREEMENT, PROMPTLY NOTIFY THE PROVIDER OF THE PROGRAM AND
REQUEST A REFUND OF THE AMOUNT YOU PAID.
The Program is owned by International Business Machines Corporation or
one of its subsidiaries (IBM) or an IBM supplier, and is copyrighted
and licensed, not sold.
IBM grants you a nonexclusive license for the Program. If IBM grants
you multiple licenses for the Program, the terms of this Agreement apply
to each license. The term "Program" means the original program and all
whole or partial copies of it, including portions merged into other
programs. A Program consists of machine-readable instructions,
audio/visual content (such as images, text, recordings, or pictures),
and related licensed materials. THIS AGREEMENT INCLUDES PART 1 -
GENERAL TERMS AND PART 2 - COUNTRY UNIQUE TERMS. THE TERMS OF PART 2
MAY REPLACE OR MODIFY THOSE OF PART 1. "LICENSE INFORMATION," WHICH IBM
PROVIDES FOR THE PROGRAM, MAY CONTAIN ADDITIONAL TERMS REGARDING THE
PROGRAM. ANY SUCH ADDITIONAL TERMS ARE PART OF THIS AGREEMENT.
1.License
_________
USE OF THE PROGRAM
You may use the Program on only one machine at any one time, except as
otherwise stated in this section. You agree to ensure that anyone who
uses the Program (accessed either locally or remotely) does so only for
your authorized use and complies with the terms of this Agreement.
A Program is considered to be in use when it resides in memory or is
otherwise stored on a machine. A Program stored on a network server
solely for the purpose of being distributed to other machines is not
considered to be in use.
IBM specifies charges for Programs based on how much you use a Program
(for example, the number of users), resources (for example, processor
size), or a combination of both.
For a Program managed by a license management tool, copies may be made
and stored on machines under control of that tool, but your use may not
exceed the total number of users or amount of resource authorized.
Certain Programs IBM designates for home or travel use may be stored on
the primary and another machine, provided the Program is not in active
use on both machines at the same time.
You may 1) copy the Program for backup and 2) merge the Program into
another program. You must reproduce the copyright notice and any other
legend of ownership on each copy, or partial copy, of the Program. You
may use any portion of the Program IBM marks restricted (for example,
"Restricted Materials of IBM") only to 1) resolve problems related to
the use of the Program and 2) modify the Program so that it will work
together with other products.
You may not: 1) use, copy, merge, or transfer the Program except as
provided in this Agreement; 2) reverse assemble, reverse compile, or
otherwise translate the Program except as specifically permitted by law
without the possibility of contractual waiver; or 3) sublicense, rent or
lease the Program.
TRANSFER OF RIGHTS AND OBLIGATIONS
You may transfer all your rights and obligations under a license for a
Program to another party, unless IBM specifies otherwise in its
License Information.
To transfer such rights and obligations, you must transfer a copy of
this Agreement, the License Information, all other documentation
(including proof of entitlement), and at least one complete, unaltered
copy of the Program to the other party. Your license is then
terminated.
A Program which IBM licenses in multiples of two or more (for example,
as a pack) may only be transferred in its entirety. In this case,
individual licenses may not be transferred.
2. CHARGES, PAYMENT, AND TAXES
______________________________
Payment must be made to the party (either IBM or its reseller) from whom
you acquired the Program. If you acquired the Program from IBM, you
agree to pay as IBM specifies. If any authority imposes a duty, tax,
levy or fee (excluding those based on IBM's net income) on the Program
supplied by IBM under this Agreement, you agree to pay that amount as
IBM specifies or supply appropriate exemption documentation.
You agree to notify IBM or its reseller and pay any applicable charges
if you change the number of users or amount of resource authorized. IBM
does not give refunds or credits for charges already due or paid.
3. LIMITED WARRANTY
___________________
For certain Programs IBM warrants that when they are used in the
specified operating environment they will conform to their spec-
ifications. IBM does not warrant uninterrupted or error-free
operation of a Program. The warranty period for a Program expires when
its Program services are no longer available. IBM will specify in its
License Information if a Program is warranted or not warranted.
During the warranty period warranty service is provided, without charge,
through defect-related Program services. Program services are
available for at least one year following a Program's general
availability. Therefore, the duration of warranty service depends on
when you obtain your license. If a Program does not function as
warranted during the first year after you obtain your license and IBM is
unable to make it do so, you may return the Program to the party (either
IBM or its reseller) from whom you acquired it and your money will be
refunded. To be eligible, you must have acquired the Program while
Program services (regardless of the remaining duration) were available
for it.
THESE WARRANTIES REPLACE ALL OTHER WARRANTIES OR CONDITIONS, EXPRESS
OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OR
CONDITIONS OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
These warranties give you specific legal rights, and you may also have
other rights which vary from jurisdiction to jurisdiction. Some
jurisdictions do not allow the exclusion or limitation of implied
warranties, so the above exclusion or limitation may not apply to you.
In that event such warranties are limited in duration to the warranty
period. No warranties apply after that period.
4. PROGRAM SERVICES
___________________
Defect-related Program services are provided for warranted Programs and
for selected other Programs. If your reported problem can be reproduced
in the specified operating environment, defect correction information, a
restriction or a bypass will be issued. Program services are provided
only for the unmodified portion of a current release of a Program.
Information regarding how you may obtain Program services will be
provided by the party (either IBM or its reseller) from whom you
acquired the Program. The duration of Program services is specified in
the License Information.
5. PATENTS AND COPYRIGHTS
_________________________
If a third party claims that a Program IBM provides to you infringes
that party's patent or copyright, IBM will, at its expense, defend you
against that claim and pay all costs, damages, and attorney's fees that
a court finally awards, provided that you 1) promptly notify IBM in
writing of the claim and 2) allow IBM to control, and cooperate with
IBM in, the defense and any related settlement negotiations. If such a
claim is made or appears likely to be made, you agree to permit IBM to
enable you to continue to use the Program, or to modify it, or replace
it with one that is at least functionally equivalent. If IBM determines
that none of these alternatives is reasonably available, you agree to
return the Program to IBM on IBM's written request. IBM will then give
you a credit for a one-time charge Program, provided its total charges
have been fully paid. This is IBM's entire obligation to you regarding
any claim of infringement. IBM has no obligation regarding any claim
based on any of the following: 1) your modification of a Program; 2)
the combination, operation, or use of a Program with any programs, data,
or apparatus that IBM did not provide; or 3) infringement by a non-IBM
Program.
6. LIMITATION OF LIABILITY
__________________________
Regardless of the basis on which you may be entitled to recover damages
from IBM, for any claim (including fundamental breach, negligence,
misrepresentation or other tort), IBM's liability will only be for 1)
payments referred to in the patents and copyrights terms described
above; 2) bodily injury (including death), and damage to real property
and tangible personal property; and 3) the amount of any other actual
direct damages or loss, up to the greater of the equivalent of U.S.
$100,000 in your local currency or IBM's then generally available
license charge for the Program.
IBM WILL NOT BE LIABLE FOR ANY SPECIAL, INCIDENTAL, OR INDIRECT DAMAGES
OR FOR ANY ECONOMIC CONSEQUENTIAL DAMAGES (INCLUDING LOST PROFITS OR
SAVINGS), EVEN IF IBM, OR ITS RESELLER, HAS BEEN ADVISED OF THE POSSI-
BILITY OF SUCH DAMAGES. SOME JURISDICTIONS DO NOT ALLOW THE EXCLUSION
OR LIMITATION OF INCIDENTAL OR CONSEQUENTIAL DAMAGES, SO THE ABOVE
LIMITATION OR EXCLUSION MAY NOT APPLY TO YOU.
IBM will not be liable for 1) loss of, or damage to, your records or
data or 2) any damages claimed by you based on any third party claim.
This limitation of liability also applies to any developer of a Program
supplied to IBM. It is the maximum for which we are collectively
responsible.
7. GENERAL
__________
You may terminate your license at any time. If you do so, all your
license rights to the Program are terminated. You may keep a copy of
the Program in your archives. IBM may terminate your license if you
fail to comply with the terms of this Agreement. If IBM does so, all
your license rights to the Program are terminated and you must destroy
all your copies of it.
You agree to comply with all applicable export laws and regulations.
Neither party may bring a legal action under this Agreement more than
two years after the cause of action arose.
This Agreement is governed by the laws of the country in which you
acquired the Program.
This Agreement is governed by the laws of the State of New York.
After downloading the Software, you can view or print a copy of this
License, along with the complete Copyright Notices for IBM
VisualAge for Basic, in the file NOTICES.TXT in the directory where you
installed the Software.
END OF LICENSE AGREEMENT
========================================================================
2. ABOUT PRODUCT SUPPORT
For the latest information concerning IBM VisualAge for Basic, please
consult our Web Page:
http://www.software.ibm.com/ad/vabasic/vabasic.htm
========================================================================
3. INSTALLATION INFORMATION
For information on how to install VisualAge for Basic, including
prerequisite and configuration information, see the file INSTALL.TXT.
Installation information is also located in the "VisualAge for Basic
Getting Started" hardcopy and softcopy books.
INSTALLING VISUALAGE FOR BASIC CLIENT AND SERVER ON THE SAME MACHINE:
For users planning to install both the VisualAge for Basic Client and
the VisualAge for Basic Server on a single OS/2 machine, you must install
both programs in the same directory.
For users planning to install VisualAge for Basic Client or Server on
OS/2, and the machine has DB2/2 Server installed, stop the database
manager (type 'db2stop' at any OS/2 command prompt) before installing
VisualAge for Basic.
========================================================================
4. GUIDE TO VISUALAGE FOR BASIC DOCUMENTATION
------------------------------------------------------------------------
4.A. Summary of VisualAge for Basic Documentation
VisualAge for Basic documentation includes online help, online books,
and separately orderable hardcopy books. To order any of the hardcopy
publications listed below, call 1-800-879-2755 and select option 1.
VisualAge for Basic also ships printable PostScript files of some books,
which are located in the \BOOKS directory on the CD-ROM. These files
are not copied onto your machine during the installation.
VisualAge for Basic Online Help
-- Provides comprehensive, task-oriented information to help you use
the VisualAge for Basic graphical user interface to create GUI
applications, DB2 stored procedures, and DB2 user-defined functions.
-- Provides detailed descriptions of all VisualAge for Basic language
elements, including all components, events, functions, methods,
objects, properties, and statements.
Online Books:
VisualAge for Basic Getting Started
-- Tells you how to install and start using VisualAge for Basic.
Includes a quick tour and five tutorials.
Document number: GC26-8926-00
Softcopy format: \help\getstart.inf
Printable format:
\books\getstrt1.ps - Installation, Quick tour, First tutorial
\books\getstrt2.ps - Four tutorials, Glossary
VisualAge for Basic Programming Guide
-- Tells you how to use the VisualAge for Basic visual development
environment to develop GUI applications.
Document number: SC26-8833-00
Softcopy format: \help\proguide.inf
Printable format:
\books\proguid1.ps -
Part 1 Working with VisualAge for Basic Tools
\books\proguid2.ps -
Part 2 Writing Code
Part 3 Integrating with External Systems (thru Chapter 19)
\books\proguid3.ps -
Part 3 Integrating with External Systems (Chapters 20, 21)
Part 4 Advanced Techniques
Appendixes
Glossary
VisualAge for Basic Language Reference
-- Provides detailed descriptions of all VisualAge for Basic language
elements, including all components, events, functions, methods,
objects, properties, and statements, in A to Z order.
Document number: SC26-8693-00
Online help format: Select Help=>Language Reference
Printable format:
\books\lrfront.ps -
Front matter, Data Types, Operators,
Constructors, Reserved Words
\books\lrah.ps -
Language elements A thru H
\books\lrip.ps -
Language elements I thru P
\books\lrqz.ps -
Language elements Q thru Z
\books\lrerror.ps -
Error messages
\books\lrcomm.ps -
Communication components and related elements
\books\lrback.ps -
Glossary, Index
VisualAge for Basic Data Access Guide
-- Tells you how to access data from VisualAge for Basic applications
using embedded SQL and the DB2 CLI and ODBC function call
interfaces.
-- Tells you how to create, build, test, register, call, and manage
DB2 stored procedures and user-defined functions.
Document number: SC26-8692-00
Softcopy format: \help\dataaccg.inf
Printable format: \books\dataaccg.ps
------------------------------------------------------------------------
4.B. Accessing VisualAge for Basic Documentation
To view the VisualAge for Basic online help, install the product,
then from any product window, select the Help menu or press F1.
To view the online books, or the online help for the Stored Procedure OLE
custom control (SP OCX), install the product, then:
-- On OS/2, open the VisualAge for Basic folder, open the
VisualAge Information folder, and double click on
Getting Started, Programming Guide, or Data Access Guide.
-- On Windows NT and Windows 95**, open the VisualAge for Basic folder,
and click on Getting Started, Programming Guide, Data Access Guide,
or SP OCX.
To view the online help for the Stored Procedure VBX, install the
SP VBX component on Windows 3.1, open the VisualAge for Basic group,
and click on SP VBX/OLE.
------------------------------------------------------------------------
4.C. Suggestions for Using the VisualAge for Basic Documentation:
1. For installation information:
-- See the file INSTALL.TXT in the CD-ROM root directory
-- See Getting Started, chapter 1, but note that the install procedure
there for AIX server in the hardcopy version of the book
is incorrect. See the online book or the INSTALL.TXT file for
the correct procedure for AIX server.
2. For an overview and "quick tour" of VisualAge for Basic, see
Getting Started (hardcopy or softcopy), Chapter 2.
3. For step-by-step information for some common and some complex tasks,
see the tutorials in Getting Started.
4. For information on how to use the VisualAge for Basic visual
development environment to develop GUI applications, see
Getting Started, the online task help, or the Programming Guide,
Part 1.
5. For detailed information on VisualAge for Basic language elements, see
the Language Reference online help or the Language Reference book.
6. For information on VisualAge for Basic programming techniques,
see the Programming Guide, Part 2.
7. For information on integrating external object systems,
such as OpenDoc, SOM, and OLE, with your VisualAge for Basic
applications, see Part 3 of the Programming Guide.
8. For information on accessing databases, and on developing, building,
testing, registering, calling, and managing stored procedures
and user-defined functions, see the online task help
and the Data Access Guide.
9. For sample programs, see the \vabasic\samples directory.
README files in this directory and its subdirectories explain how to
use the sample programs.
10. For more information about SOMObjects programming, see the files
\vabasic\help\somguide.inf (SOMObjects User's Guide, document number
SC23-2680-01), and \vabasic\help\somref.inf (SOMObjects Program
Reference, document number SC23-2681-01).
11. For tutorials and samples on using the communication controls, see
the \vabasic\samples\comm subdirectory. Each subdirectory contains
a postscript file that explains the samples provided in that
subdirectory. The postscript files are:
- For APPC support: vabasic\samples\comm\appc\appsampl.ps
- For ASYNC support: vabasic\samples\comm\async\comsampl.ps
- For EHLLAPI support: vabasic\samples\comm\hllapi\hllsampl.ps
- For NETBIOS support: vabasic\samples\comm\netbios\netsampl.ps
- For TCP/IP support: vabasic\samples\comm\tcpip\tcpsampl.ps
========================================================================
5. DESCRIPTION OF FUNCTIONS SUPPORTED IN THIS VERSION
Version 1.1 of VisualAge for Basic contains a number of defect
fixes for errors in the product code, documentation, and samples.
Among the more significant fixes:
OS/2 users can now execute multiple instances of VisualAge for Basic
and/or multiple instances of executables generated by VisualAge for
Basic. This capability existed previously only for Windows users
of VisualAge for Basic.
VisualAge for Basic no longer crashes when double clicking the
System Menu of the Code Editor on OS/2.
Corrections to the "VisualAge for Basic Getting Started" book and
other books have been added.
Crashes when using an Editable Grid have been fixed.
Memory leaks in the string manipulation functions have been fixed.
Crashes building or running DB2 stored procedures have been fixed.
Errors displaying/processing special or DBCS characters have been
fixed.
------------------------------------------------------------------------
General Scenarios Supported:
-- Create client GUI applications that run on OS/2, Windows NT, and/or
Windows 95.
-- Integrate third-party visual and non-visual objects and controls
developed in C++, SOM, OLE, and OpenDoc into client applications.
-- Define, create, and manipulate objects in Basic using Object
Oriented extensions to the Basic language.
-- Migrate applications written in Microsoft Visual Basic 3.0 into
VisualAge for Basic.
-- Edit server procedures locally, and build and debug server
procedures locally and remotely.
-- Browse stored procedures in the DB2CLI.PROCEDURES catalog, and
browse user-defined functions in the DB2 catalog.
-- Invoke server procedures from a VisualAge for Basic client and
from other clients.
Definition: "server procedures" is used as a general term that includes
stored procedures and user-defined functions.
------------------------------------------------------------------------
Platforms Supported:
Client platforms: OS/2, Windows NT, Windows 95
Server platforms: AIX, OS/2, Windows NT
------------------------------------------------------------------------
Language Supported:
The complete VisualAge for Basic language is described in the VisualAge
for Basic online help. See the file \VABASIC\VERSION1.TXT for a
list of known defects and restrictions in this version.
------------------------------------------------------------------------
Functions Supported:
Project:
-- Creating a new project
-- Opening an existing project
-- Saving the project and changing the project name via Save as
-- Running the Project
-- Viewing the project: Forms, Modules, Build files, Components, etc.
-- Showing a file in full path or just the name
-- Loading projects written in Microsoft Visual Basic 3.0, modifying
them, and saving them in Visual Age for Basic format
-- Building server procedures (creation/deletion)
-- Generating an executable (.EXE) version of the project.
-- Accessing database information in ODBC data sources using a
Data component and/or Data Access classes.
-- Accessing database information in DB2 using Embedded SQL statements
or CLI calls.
Forms:
-- Selection and appropriate menu and icon state
-- Opening the Code Editor, Property Editor and Menu Editor
via menu item, mouse, keyboard
-- Showing or hiding design version of selected form
-- Saving in a file (.i), and changing name of file via Save As
Modules:
-- Selection and appropriate menu and icon state
-- Opening Code Editor on it via menu item, mouse, keyboard
-- Saving in a file (.bas), and changing name of file via Save As
-- Creating/removing a Module
Window Pulldown:
-- Property Editor
-- Toolbox
-- Menu Editor
-- Code Editor
-- Color selector
-- Component catalog
-- Stored procedure catalog
-- User-defined function catalog
Options Pulldown:
-- Interpreter
-- Project
-- Environment
-- Database
------------------------------------------------------------------------
Components shipped in this version:
Checkbox
Combo Box
Command Button
Common Dialog
Directory List Box
Drive List Box
File List Box
Frame
Grid
Horizontal Scrollbar
Image
Label
Line
Listbox
OLE Container (Windows NT and Windows 95 only)
OpenDoc Container (OS/2 only)
Option Button
Picture Box
Shape
Textbox
Timer
Vertical Scrollbar
========================================================================
6. COPYRIGHT NOTICE AND TRADEMARKS FOR THIS README FILE
(C) Copyright International Business Machines Corporation 1997.
All Rights Reserved.
AIX, DB2, DB2/2, DB2/6000, IBM, and OS/2 are trademarks of International
Business Machines Corporation.
Microsoft, Windows, and the Windows 95 logo are trademarks or registered
trademarks of Microsoft Corporation.
Other company, product, and service names, which may be denoted by a
double asterisk (**), may be trademarks or service marks of others.
========================================================================