IBM SAA Common User Access Controls Library/2 Version 1.0

NUMBER    292-114 DATE      920303 TYPE      Programming

ABSTRACT
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.

PRODNO 5871-AAA IBM SAA Common User Access Controls Library/2 Version 1.0 (20G0400)

HIGHLIGHTS

 * Offers ability to conform to CUA 91 architecture for OS/2 Version 1.3 and Windows Version 3.0.
 * Relieves application developers of significant user interface development efforts which allows them to concentrate on the competitive functions.
 * 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: 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.
 * Developer productivity gains:
 * through utilization of reusable components.
 * through consistency with OS/2 Version 2.0 APIs.
 * End user productivity gains resulting from adoption of CUA.

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: 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.
 * the benefits specific to adopting CUA 91 architecture.
 * the benefits of user interface consistency between applications.

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 usingCommon 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 thedeveloper 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: 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.
 * Container Control
 * Notebook Control
 * Value Set Control
 * Slider Control
 * File Dialog
 * Font Dialog
 * Spin Button Control (for Windows only, already included in OS/2 Version 1.3 operating system).

CUSTINFO

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.

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:
 * 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.
 * 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: (TM) Trademark of International Business Machines Corporation.
 * 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.
 * 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.

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:
 * IBM Program License Agreement
 * License Information
 * Proof of License
 * Registration Card
 * Four 3.5-inch (1.44 MB) diskettes
 * Four 5.25-inch high density (1.2MB) diskettes
 * 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. The available order type is as follows:
 * 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