IBM SAA COMMON USER ACCESS CONTROLS LIBRARY/2 VERSION 1.0
Contents


Announcement Letter Number 292-114 dated March 3, 1992
US - Last Revised on March 3, 1992



Brief Description of Announcement, Charges, and Availability

       IBM SAA (TM) Common User Access (TM) Controls Library/2
Version 1.0 provides a set of CUA (TM) 91 graphical user interface
controls for OS/2 (R) Version 1.3 and Microsoft (1) Windows (2)
Version 3.0 applications.  With these controls, users can now have
consistent Common User Access applications across OS/2 Version 2.0,
OS/2 Version 1.3 and Windows Version 3.0.  In providing the
Presentation Manager (R) Application Programming Interface (API) for
the SAA CUA 91 architecture, Common User Access Controls Library
aides in migration from OS/2 Version 1.3 and Windows Version 3.0 to
OS/2 Version 2.0.  For OS/2 Version 1.3 users, the controls provided
by Common User Access Controls Library include container, value set,
notebook, slider, file dialog and font dialog.  For Windows
Version 3.0 users, the controls provided by Common User Access
Controls Library include spin button, container, value set, notebook,
slider, file dialog and font dialog.
       IBM SAA Common User Access Controls Library/2 Version 1.0 has
National Language Support for the following languages:  Canadian
French, Danish, Dutch, Finnish, French, German, Italian, Norwegian,
Portuguese, Spanish, Swedish, United Kingdom English, and United
States English.  DBCS enablement is provided for Japanese (Kanji),
Korean (Hanguel), and Traditional Chinese.  DBCS language translation
is provided for Japanese (Kanji) only.  Product documentation is
provided in United States English.  National language support is
provided as separate dynamic link libraries (DLLs) on the diskettes
in the program package.
       Planned Availability Date:  March 27, 1992.
 (TM) Trademark of International Business Machines Corporation.
 (R) Registered trademark of International Business Machines
   Corporation.
 (1) Registered trademark of the Microsoft Corporation.
 (2) Trademark of the Microsoft Corporation.


Customer Letter Section

HIGHLIGHTS
o   Offers ability to conform to CUA 91 architecture for OS/2
    Version 1.3 and Windows Version 3.0.
o   Relieves application developers of significant user interface
    development efforts which allows them to concentrate on the
    competitive functions.
o   Provides for easier application migration to OS/2 Version 2.0
    because the CUA Controls APIs for OS/2 Version 1.3 and Windows
    Version 3.0 are consistent with those found in OS/2 Version 2.0.
DESCRIPTION
BUSINESS SOLUTIONS
Common User Access Controls Library provides reusable code components
that enable the IBM graphical user interface CUA 91 architecture.
Refer to Programming Announcement 291-467, dated September 11, 1991,
for a description of the CUA 91 architecture.  Today, IBM is
announcing that it will provide the CUA Controls for OS/2 Version 1.3
and Windows Version 3.0 in the IBM SAA Common User Access Controls
Library/2.  Common User Access Controls Library provides controls
consistent with OS/2 Version 2.0 in look and feel and in API
structure.  Refer to Programming Announcement 291-598, dated
October 22, 1991, for a description of OS/2 Version 2.0.
       Common User Access Controls Library is a productivity tool
that embodies the CUA user interface architecture in a set of dynamic
link libraries (DLLs).  These DLLs may be incorporated directly with
the application code thus allowing the developer to focus more on the
content and quality of their application rather than on CUA
conformance.  The net results should be greater end user satisfaction
with less development resource.
USER PRODUCTIVITY
There are two aspects of user productivity addressed by the Common
User Access Controls Library:
o   Developer productivity gains:
    -   through utilization of reusable components.
    -   through consistency with OS/2 Version 2.0 APIs.
o   End user productivity gains resulting from adoption of CUA.
       IBM has designed its Common User Access Controls Library to
allow developers to maximize their productivity when developing
applications that conform to the CUA 91 architecture.  This
productivity gain can be realized through reusable components, which
implement constructs that employ the CUA 91 architecture.  Packaged
as dynamic link libraries, portions of the Common User Access
Controls Library can be shipped directly with the developed
application.  Details concerning which portions can be redistributed
with the developed application are specified in the License
Information shipped in the program package.
       Common User Access Controls Library is structured to conform
to the same APIs as found in OS/2 Version 2.0.  This similarity of
APIs between the CUA Controls has the effect of reducing rework in
migrating applications incorporating Common User Access Controls
Library from OS/2 Version 1.3 or Windows Version 3.0 to OS/2
Version 2.0.  The APIs for IBM SAA Common User Access Controls
Library/2 Version 1.0 in the OS/2 Version 1.3 environment are the
same as the CUA Controls in OS/2 Version 2.0.  Due to differences
between OS/2 Presentation Manager and Windows, the APIs for Common
User Access Controls Library in the Windows Version 3.0 environment
are similar to those in OS/2 Version 2.0.
       The CUA 91 architecture enhances the object-based user
interface defined in previous CUA guidelines.  Rather than
interacting with applications, users interact with objects that
represent the inputs and outputs of their jobs.  CUA conformance
benefits an organization in the following two ways:
o   the benefits specific to adopting CUA 91 architecture.
o   the benefits of user interface consistency between applications.
       Increased user productivity is enabled through emphasis on
direct manipulation of objects.  Objects, which are represented by
controls and icons in applications, mimic objects in the real world.
A user can transfer knowledge about an object from the real world to
the computer environment.  A sense of familiarity is provided and
learning time and errors are reduced.  The user is allowed to
concentrate more on the task at hand.
       User interface consistency across multiple applications and
environments helps a user transfer knowledge of one product to
another.  Minimizing the need to learn new techniques for similar
tasks should yield savings in user training.  Common User Access
Controls Library helps stretch this consistency to the OS/2
Version 1.3 and Windows Version 3.0 platforms.
GROWTH ENABLEMENT
The similarity of Common User Access Controls Library to the CUA 91
architecture constructs in OS/2 Version 2.0 increases organizations'
opportunities to develop code that can be more easily migrated to
OS/2 Version 2.0.  Those customers who plan to migrate to OS/2
Version 2.0 with near term OS/2 Version 1.3 or Windows Version 3.0
development can better position their application for migration to
OS/2 Version 2.0.  Because those portions of applications using
Common User Access Controls Library which were developed for OS/2
Version 1.3 and Windows Version 3.0 will run on OS/2 Version 2.0, an
organization is also better able to stage technical growth as
dictated by their business.
       Common User Access Controls Library components provide the
application developer with many highly flexible features.  In
addition, many customization options are provided to allow the
developer to change the appearance of the controls.
INVESTMENT PROTECTION
Common User Access Controls Library supports existing customer
investment by enabling the CUA 91 architecture on platforms which
support IBM compatible 286-based machines.
PRODUCT POSITIONING
In September 1991, IBM announced CUA extensions to its SAA
architecture.  The SAA CUA 91 architecture strategy is focused on
providing a user interface that can exploit increasing levels of
application-to-application interoperability at the programming
workstation while allowing users the freedom to customize and
organize their work environments as the job requires.  Application
developers are encouraged to participate in this strategy by enabling
their application to the enhancements as documented in the following
publications:  SAA CUA Guide to User Interface Design (SC34-4289) and
SAA CUA Advanced Interface Design Reference (SC34-4290).
       This strategy recognizes that application developers require
not only a definition of the user interface, but productivity tools
to assist in the development of software to make the user interface a
reality.  The Common User Access Controls Library provides the
application developer a set of dynamic link libraries (DLLs) for both
the OS/2 Version 1.3 and Windows Version  3.0 programming
environments that can be used in the development of applications that
conform to the CUA 91 architecture.  Common User Access Controls
Library fully exploits CUA 91 architecture guidelines.  Other CUA 91
architecture guidelines such as the definition of major objects are
the responsibility of the application developer.
       DLLs, sample code and online documentation are provided for
the following the CUA 91 architecture constructs:
o   Container Control
o   Notebook Control
o   Value Set Control
o   Slider Control
o   File Dialog
o   Font Dialog
o   Spin Button Control (for Windows only, already included in OS/2
    Version 1.3 operating system).
       Usage of these controls will allow development of programs
that conform to the application orientation of the CUA 91
architecture for both the OS/2 Version 1.3 and Windows Version 3.0
environment.  The consistency of the Common User Access Controls
Library interfaces with the new APIs in OS/2 Version 2.0 will provide
for user interface migration with minimal rework.
PUBLICATIONS
       The IBM SAA Common User Access Controls Library/2 Version 1.0
publications, the Programming Guide, the Programming Reference for
OS/2 Presentation Manager, and the Programming Reference for
Microsoft Windows, are shipped as part of the program package and are
not separately orderable.  Online versions of these publications are

also available on the diskettes shipped in the program package.
SCHEDULE
       The planned availability date is March 27, 1992.
TECHNICAL INFORMATION
SPECIFIED OPERATING ENVIRONMENT
MACHINE REQUIREMENTS:  IBM SAA Common User Access Controls Library/2
Version 1.0 is an extension of OS/2 Version 1.3 and Windows
Version 3.0:
o   OS/2 Version 1.3:
    -   Any OS/2 SE Version 1.3 or OS/2 EE Version 1.3 or OS/2
        Version J1.3 or OS/2 Version K1.3 or OS/2 Version T1.3
        supported workstation.
    -   A 3.5-inch or 5.25-inch high-capacity diskette drive.
    -   A display and associated display adapter supported by OS/2 SE
        Version 1.3 or OS/2 EE Version 1.3 or OS/2 Version J1.3 or
        OS/2 Version K1.3 or OS/2 Version T1.3.
    -   No memory is required above that needed for OS/2 SE
        Version 1.3 or OS/2 EE Version 1.3 or OS/2 Version J1.3 or
        OS/2 Version K1.3 or OS/2 Version T1.3.
o   Windows Version 3.0:
    -   Any Windows 3.0 supported workstation that can run Windows
        standard or enhanced mode.
    -   A 3.5-inch or 5.25-inch high-capacity diskette drive.
    -   A display and associated display adapter supported by Windows
        Version 3.0.
    -   No memory is required above that needed for Windows
        Version 3.0.
PROGRAMMING REQUIREMENTS:
o   OS/2 Version 1.3:
    -   OS/2 SE Version 1.3 or OS/2 EE Version 1.3 or OS/2
        Version J1.3 or OS/2 Version K1.3 or OS/2 Version T1.3.
    -   IBM C/2 (TM) Language Compiler Version 1.1 or Microsoft C
        Compiler Version 5.1 or Microsoft C Compiler Version 6.0.
o   Windows Version 3.0:
    -   Microsoft Windows Version 3.0.
    -   DOS Version 3.1 or later.
    -   Microsoft C Compiler Version 5.1 or Microsoft C Compiler
        Version 6.0.
 (TM) Trademark of International Business Machines Corporation.
PLANNING INFORMATION
PACKAGING:  IBM SAA Common User Access Controls Library/2 Version 1.0
program package is distributed in one package with the following
materials:
o   IBM Program License Agreement
o   License Information
o   Proof of License
o   Registration Card
o   Four 3.5-inch (1.44 MB) diskettes
o   Four 5.25-inch high density (1.2MB) diskettes
o   IBM SAA Common User Access Controls Library/2 Version 1.0 binder
    containing the Programming Guide and Programming Reference
    manuals.
SECURITY, AUDITABILITY AND CONTROL
       User management is responsible for evaluation, selection, and
implementation of security features, administrative procedures, and
appropriate controls in application systems and communication
facilities.
ORDERING INFORMATION
       Orders for new licenses will be accepted March 3, 1992, unless
a later date is specified, orders entered prior to the planned
availability date will be assigned a schedule date of April 3, 1992.
Shipment of orders will commence on the availability date.  Orders
entered after the planned availability date will be scheduled for
shipment on the Friday following the week of order entry or as soon
thereafter as supply permits.
       To order the programs in this announcement for order type,
specify the order type number, feature number, part number, program
name, media and quantity.
Order-Type      Feature  Part
Number          Number   Number     Program Name              Media
5871-AAA        2463     20G0400    IBM SAA                   Dual
                                     Common User Access
                                     Controls Library/2
                                     Version 1.0
       The available order type is as follows:
o   Program Package -- program diskette with documentation.
IBM EDUCATION FULFILLMENT CENTER:  The announced program is eligible
to be ordered through the IBM Education Fulfillment Center.  Please
note that availability through the IBM Education Fulfillment Center
may not coincide with the programming availability dates noted in
other sections of this document.
       The IBM Education Fulfillment Center is the order processing
location for selected Personal Computers and related
hardware/software for eligible education end-users.
TERMS AND CONDITIONS
LICENSING:  The program in this announcement is licensed under the
terms and conditions of the IBM Program License Agreement.  A copy of
the agreement is included in the program package.  Details concerning
which portions of the Licensed Program can be redistributed with
applications incorporating IBM SAA Common User Access Controls
Library/2 Version 1.0 are specified in the License Information
shipped in the program package.
LIMITED WARRANTY:  Program:  Yes.  Media:  Three months.
PROGRAM SERVICES:  Central Service, including a Support Center, will
be available until September 27, 1993.  The program in this
announcement is supported by the Common User Access Controls Library
Support Group, Cary, North Carolina.  Access to this Support Center
is through the IBM Support Center.  The statement of service included
in the program package describes this service.
CUSTOMER FULFILLMENT OPTION:  Yes.
VOLUME DISCOUNT:  Volume discounting is available under the terms and
conditions of the IBM Customer Agreement (ICA) and the Exhibit for
Personal Computer/System Programs.  The program in this announcement
is included in the Eligible Program List for Personal Computer/System
Programs.  It may be added to the applicable category in the space
provided on the Eligible Program List.  Program Packages are included
in Category A under 5871-AAA.
TESTING PERIOD:  Two months for up to three licenses.
       ICA must be in effect.
NATIONAL EDUCATION LICENSE FEE:  A National Education License Fee
(NELF) is available under the terms and conditions of the Education
Allowance Attachment.  The NELF, which represents a 30% discount off
the single unit price, is not subject to any further discount or
allowance.
CHARGES
PROGRAM                                           ONE-TIME
NAME                       ORDER TYPE             CHARGE
IBM SAA Common User        Program Package        $595
 Access Controls Library/2
 Version 1.0 (20G0400)