COOL:Gen 6.

eBusiness Edition June 2001

New Features Supplement to the Getting Started Guide

This documentation and related computer software program (hereinafter referred to as the Documentation) is for the end users informational purposes only and is subject to change or withdrawal by Computer Associates International, Inc. (CA) at any time. This documentation may not be copied, transferred, reproduced, disclosed or duplicated, in whole or in part, without the prior written consent of CA. This documentation is proprietary information of CA and protected by the copyright laws of the United States and international treaties. Notwithstanding the foregoing, licensed users may print a reasonable number of copies of this documentation for their own internal use, provided that all CA copyright notices and legends are affixed to each reproduced copy. Only authorized employees, consultants, or agents of the user who are bound by the confidentiality provisions of the license for the software are permitted to have access to such copies. This right to print copies is limited to the period during which the license for the product remains in full force and effect. Should the license terminate for any reason, it shall be the users responsibility to return to CA the reproduced copies or to certify to CA that same have been destroyed. To the extent permitted by applicable law, CA provides this documentation as is without warranty of any kind, including without limitation, any implied warranties of merchantability, fitness for a particular purpose or noninfringement. In no event will CA be liable to the end user or any third party for any loss or damage, direct or indirect, from the use of this documentation, including without limitation, lost profits, business interruption, goodwill, or lost data, even if CA is expressly advised of such loss or damage. The use of any product referenced in this documentation and this documentation is governed by the end users applicable license agreement. The manufacturer of this documentation is Computer Associates International, Inc. Provided with Restricted Rights as set forth in 48 C.F.R. Section 12.212, 48 C.F.R. Sections 52.227-19(c)(1) and (2) or DFARS Section 252.227.7013(c)(1)(ii) or applicable successor provisions.

2001 Computer Associates International, Inc., One Computer Associates Plaza, Islandia,
New York 11749. All rights reserved.

All trademarks, trade names, service marks, or logos referenced herein belong to their respective companies.

Contents

Whats New in COOL:Gen 6.0 eBusiness Edition..4

Java Web Generation.............................................................................................................. 4 HTTP Servlet Request ............................................................................................................ 5 JDBC Support.......................................................................................................................... 6 Timestamp Enhancement in Java Proxy.............................................................................. 6 Hebrew Support ..................................................................................................................... 6 Unicode Support..................................................................................................................... 7 Component Manager ............................................................................................................. 7 COOL:Gen HP-UX CSE Re-Release ..................................................................................... 8 DML Changes for DB2 on UNIX and Windows NT.......................................................... 8 CICS Asynchronous Server-to-Server Support .................................................................. 8 Asynchronous Processing Phase 2 ....................................................................................... 9 MQSeries Connection Retry Logic ..................................................................................... 10 PTFs ........................................................................................................................................ 11

COOL:Gen 6.0 Products .......................................12

COOL:Gen 6.0 Development Platform Environments .................................................... 12 COOL:Gen 6.0 Application Target Environments ........................................................... 13

New Features

Whats New in COOL:Gen 6.0 eBusiness Edition

The COOL:Gen 6.0 eBusiness Edition extends COOL:Gens eBusiness transformation capabilities by providing Java generation and deployment options to leading web application servers such as WebSphere, WebLogic, Jboss, Jrun and iPlanet. This enables companies to transform their OS390 and Unix applications to large-scale Web solutions that leverage proven technology. Also included in this Edition are several new features as well as fixes to the September 2000 COOL:Gen 6.0 release.

Java Web Generation

Java Web Generation allows customers the flexibility to target different platforms for their web/application servers. This product delivers portable runtime and generated code that build on and exceed the functionality delivered in the C++ version of Web Generation (formerly called Web Client Enablement) in the COOL:Gen 6.0 release. This Java version will replace the C++ version of Web Generation at the end of calendar year 2001. Therefore, customers who have purchased the Web Client Enablement for COOL:Gen 5.1 or 6.0 will want to upgrade to this Java version of Web Generation at their earliest convenience.

COOL:Gen eBusiness Edition

Web Generation Architecture
MVS, UNIX, NT
Web Application Server Browser
Web Server Servlet Engine

Enterprise Server

Web Browser
JSP HTML JavaScript CSS
Java Runtime

Server Runtime

Communication Runtime

Server Application

JDBC Driver DBMS

Java Business Logic

DBMS

Java Middle Tier Generated by COOL:Gen

HTTP Servlet Request

This capability enhances the Web Generation product by providing the ability to access the HttpServletRequest via the usage of External Action Blocks. The main function of this feature is to provide the ability to retrieve information available in the HTTP Request headers for the purpose of utilizing it in the generated applications. Taking advantage of this capability requires no modifications to the generated code.

JDBC Support
In addition to the standard DBMS capabilities that COOL:Gen applications have always provided, the implementation of JDBC within the Java Web Generation feature provides the ability to access multiple databases simultaneously from one procedure step/action block. COOL:Gen will manage the rollbacks and commits across each of the connections. This enhancement does come with some restrictions; the most significant is that the action diagram logic may not perform any operation that would result in a 'join' between two tables in different databases. Likewise, there should be no relationships between tables that will reside in different databases. The separate databases may reside on different DBMS's if desired.

Timestamp Enhancement in Java Proxy

In prior COOL:Gen releases, the Java Proxy timestamp implementation limited millisecond support to only 3 significant digits. This varied from other COOL:Gen application behavior. With this release, a mechanism was provided to allow the full 6 significant digit millisecond support to be supported within the Java Proxy applications.

Hebrew Support
The Hebrew language has been certified on COOL:Gen 6.0 for Windows NT/2000. Certification on Windows 98 will be forthcoming when Microsoft issues a fix that is needed on the Windows 98 operating system.

Unicode Support
Limited Unicode support is now available to allow multiple languages to be stored on and accessed from a single database. Data entry may be performed using terminals that have different code pages. When the server load module's code page is set to UTF8 (code page ID 1201), the data will be translated from any client code page to UTF8 and managed on the server. Data sent back to a client will be translated to the client code page. Therefore, a client may always display data entered in their code page. Generated Java clients must be modified to support Unicode. Specifically, the system property file.encoding must be set to UTF-8 before any call to the server. With these modifications, the Java Proxy can retrieve (and update) records from a server using UTF8 and display (and enter) that data on a Unicode enabled Internet browser (like Netscape or Internet Explorer).

Component Manager
The Component Manager allows a user to browse component specifications and to transfer those component specifications between COOL:Gen Encyclopedias. It also supports assembly of existing components into new applications. When the user drags and drops a component specification from a Data Source onto another Data Source all required related objects will be transferred at the same time. That is, Gen-to-Gen drag-and-drop object types will be model, interface, and operation. With prior releases, the Component Manager was a separate product. With this eBusiness Edition, Component Manager has been merged into COOL:Gen and supports the COOL:Gen 6.0 Meta Model (9.0.A2). The Component Manager is available only on the Microsoft operating systems.

COOL:Gen HP-UX CSE Re-Release

Hewlett Packard released a patch to HP-UX 11 in March 2001 that caused an incompatibility with CAs commercial offering of the COOL:Gen 6.0 HP-UX Client Server Encyclopedia. CA has updated the COOL:Gen 6.0 HP CSE with this release so incompatibilities disappear.

DML Changes for DB2 on UNIX and Windows NT

In prior version of COOL:Gen, the DML generated for DB2 on UNIX and Windows NT did not support the WITH or OPTIMIZING n USING clauses. Starting with this release, these clauses will be generated for the READ, READ EACH, SUMMARIZE and SUMMARIZE EACH Action Diagram statements that have been detailed to include these optional clauses.

CICS Asynchronous Server-to-Server Support

This feature will complete the Asynchronous Communications project, which was delivered with the COOL:Gen 6.0 release once it completes beta. At the time this document was published, this feature was still in beta test status. When the feature has completed beta test, it will be available on a separate CD. Please reference the September 2000 version of the COOL:Gen 6.0 New Features Document for a detailed description of this feature. See http://support.ca.com/ for a copy of the document or refer to the Getting Started guide that was shipped with COOL:Gen 6.0.

Asynchronous Processing Phase 2

When this capability was released in COOL:Gen 6.0, the server code had not been completely modified to act in a truly asynchronous manner. The net effect to the requesting application was that it never had to code for the fact that a response was actually being returned, the COOL:Gen 6.0 runtime handled the response. Starting with the COOL:Gen 6.0 release when an asynchronous flow of the type No Response" was executed, the request token runtime would spawn a new working thread. This thread would remain active and maintain the client side connection for the duration of the server pstep execution. Upon completion of the server execution the server runtime would send a response back to the client side working thread. That working thread then would discard the response in a manner appropriate to the communication interface. This allowed for freeing up of buffers and system resources. As of this update, the COOL:Gen 6.0 eBusiness Edition, the client side working thread as well as the intermediate COOL:Gen communication infrastructure are aware of the type of flow currently taking place. Thus the complete round trip communications that had been maintained between client and server need no longer be maintained when processing a No Response type of asynchronous flow. The outbound processing of the request from client to server has not been changed. However, the inbound or returning communication from the server is no longer passed back to the client. The client side working thread will complete once the transfer of data to the server has completed. It will no longer wait for the return flow from the server side.

NOTE: The COOL:Gen 6.0 eBusiness Edition release contains a modification to the internal runtime behavior of asynchronous cooperative flows. Due to the nature of these changes if an application is using the COOL:Gen action statement "USE Async" with response handling modifier of "No Response" then both the client side and the target server side runtimes must be at the same release level. Either both at COOL:Gen 6.0 or both at COOL:Gen 6.0 eBusiness Edition. If both client and server runtimes are not at the same release level the No Response form of USE Async statement will not be processed properly. MVS Users Only - The asynchronous flow type of "No Response" for CICS and IMS servers participating in client/server flows (NOT server-to-server flows) is being delivered in PTF format. PTF GEM6001 (CA APAR LO92748) is required for Host Construction and MVS Implementation Toolset while PTF RTM6005 (CA APAR unknown) is required for Runtime. As a result of applying these PTFs any CICS and IMS servers wanting to implement the modified asynchronous flow type of "No Response" require re-generation and re-installation.

MQSeries Connection Retry Logic

Cooperative flow connections using middleware communications type of MQseries will now support a connection retry mechanism. With the COOL:Gen 6.0 release if an error is encountered during the processing of a cooperative flow then the COOL:Gen runtime would report a fatal error ending execution of the application. The COOL:Gen 6.0 eBusiness Edition, includes enhancements, which will allow repeated attempts to process the failed request. The number of retry attempts is controlled by a new set of entry points contained within the MQSeries user exit library. ( NT: mqscx60n.dll, Unix: libmqscx.60.__ ) Please refer to the user exit source file cimqclex.c delivered with this update for further information regarding this retry feature. Customers that have modified cimqclex.c in a previous release will need to incorporate those modifications into this new version of the exit routine source code.

10

PTFs
This eBusiness Edition is an update for COOL:Gen 6.0 products on Windows and some UNIX platforms and must be installed on top of an existing COOL:Gen 6.0 installation. This eBusiness Edition supersedes all Windows and Unix (except Sequent) platform PTFs distributed prior to its release. Installation of this eBusiness Edition will be a prerequisite for any subsequent PTFs to COOL:Gen 6.0 Windows and Unix (except Sequent) products as of April 30th, 2001.

11

COOL:Gen 6.0 Products

COOL:Gen 6.0 Development Platform Environments
Workstations Windows 98/95* Windows NT Windows 2000 Encyclopedias MVS Windows NT Windows 2000 UNIX: HP-UX RS/6000 Encyclopedia Clients Windows 98/95* Windows NT Windows 2000 Implementation Toolset1 Windows 98/95* Windows NT Windows 2000 MVS CICS, IMS, TSO UNIX: HP-UX, SUN, RS/6000, Sequent Compaq TRU64 Compaq OpenVMS Tandem Guardian

* Windows 95 is supported with COOL:Gen 6.0 and the eBusiness Edition wherever Windows 98 is supported. This is the last release in which Windows 95 will be supported.

12

COOL:Gen 6.0 Application Target Environments

Windows NT Oracle SQL Server DB2 Informix Sybase ODBC Client, Server or Block TE2 Client Manager Comm. Bridge DCE, MQSeries Tuxedo Client Encina Client & Server Proxies COM, C Windows 2000 Oracle SQL Server DB2 Informix Sybase ODBC Client, Server or Block TE2 Client Manager Comm. Bridge DCE, MQSeries Tuxedo Client Encina Client & Server Proxies COM, C HP-UX Oracle Sybase Informix Tuxedo or TE2 Server or Block Tuxedo Server MQSeries Encina DCE C Proxy MVS DB2 CICS , IMS, TSO, Batch, LE/370 Server or Block DCE, MQSeries Encina Server (CICS)

13

Windows 98/95* Oracle Informix Sybase ODBC Client Tuxedo Client Encina Client Proxies COM, C

RS/6000 AIX Oracle Sybase Informix DB2 Tuxedo or TE Server or Block DCE, MQSeries Encina Server Tuxedo Server C Proxy
2

Sun Solaris Oracle Sybase Informix Tuxedo or TE

2

Sequent Oracle Informix Tuxedo or TE2 Server or Block Tuxedo Server

Server or Block Tuxedo Server MQSeries C Proxy

Compaq TRU64 Unix Oracle Informix Tuxedo or TE2 Server or Block Tuxedo Server

Compaq OpenVMS (Alpha) Rdb Oracle C ACMS or TE2 Server or Block C Proxy

Tandem Guardian NonStop SQL NSK Pathway Server or Block

JVM

JDBC Java Web Generation Java Proxy

1 Implementation Toolset (IT) creates applications for these target environments. 2 TE Transaction Enabler provides the functionality of a TP monitor.

* Windows 95 is supported with COOL:Gen 6.0 and the eBusiness Edition wherever Windows 98 is supported. This is the last release in which Windows 95 will be supported

14