IBM Rational COBOL Generation Extension for zSeries Fix Pack 6.0.1 Interim Fix 002 Readme

For Rational COBOL Generation Extension for zSeries, Version 6.0.1

© Copyright International Business Machines Corporation 2000, 2009. All rights reserved. US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

Contents

1.0 About this release
2.0 Installation information
3.0 Product fix history
4.0 Known limitations, problems, and workarounds
5.0 IBM Rational Software Support
6.0 Notices and trademarks

1.0 About this release

Important: This version of the readme file contains limited information. For a complete and updated version, see the file available online at: www3.software.ibm.com/ibmdl/pub/software/rationalsdp/bdcz/601/html/readme_6012_iFix_002.html

This interim fix contains fixes to the version 6.0.1 interim fix 001 release of IBM® Rational® COBOL Generation Extension for zSeries®.

2.0 Installation information

For information about the installation requirements and installation instructions for this interim fix, see the Installation instructions at: www3.software.ibm.com/ibmdl/pub/software/rationalsdp/bdcz/60/install_instruction/6012_iFix_002/install.html  

3.0 Product fix history

New fixes in this release are listed below. APAR numbers are in parentheses.

  • (PK37914) Need to close CCU Security Manager to perform build from scripts
  • (PK56176) Incorrect COBOL generated for IF statement comparing two array items with different indexes
  • (PK59392) EGL function syslib.convert does not work correctly in COBOL when CHAR item substructured with HEX
  • (PK61906) COBOL generated for EGL produces compiler errors for SET statement
  • (PK61953) ABEND 0C4/AKEA when running CICS generated code from EGL
  • (PK62581) CICS translator returning return code 08 when processing a string statement containing unnecessary continuation character
  • (PK63479) Storage corruption due to incorrect length specification on VSAM record structure
  • (PK63532) Incorrect code generated for EGL program when referencing more than one record structure for the same VSAM file
  • (PK64646) The value in the TWAOFFSET build descriptor option is not being set in the generated COBOL
  • (PK65154) Incorrect code page conversion if any of the CHAR fields contain double byte characters
  • (PK66285) IGYPS2120-S and IGYPS2121-S compile errors with generated COBOL
  • (PK68010) Form fields truncated or missing
  • (PK68271) EGL Generating section name over 30 characters in length
  • (PK69600) Build server not handling end of line character properly
  • (PK73201) EGL generating invalid index when IF condition requires character to number conversion

4.0 Known limitations, problems, and workarounds

4.1  Build failure if V7.x build scripts are used for V6.x generation

IBM Rational COBOL Runtime for zSeries supports EGL applications generated both from version 6.x and version 7.x.  In recent PTFs to support version 7.x applications, there has been a change in build scripts related to generation of JCX files.  If  you generate using version 6.x but have updated build scripts, this may result in failures during generation.  To avoid problems, do one of the following:

  • If the runtime server is updated to the latest PTF level, but the client is 6012, continue to use the build scripts from before - do NOT use the updated build scripts from the  latest PTF
  • If you do use the latest build scripts, then edit FDABCL script, and change HASJCX=NO to HASJCX=YES
  • To any build descriptors for COBOL generation, add a user defined symparm HASJCX=YES

4.2 Problem with roll back for interim fix 002

Uninstalling this interim fix to roll your installation back to interim fix 001 may result in corruption of files in the \installDirectory\bin directory, including eglbatchgen.jar and distbuild.jar.  When this error occurs, these files are replaced with empty files (file size = 0).   If this problem occurs, perform the following steps to restore the product to the interim fix 001 level:

  1. Uninstall interim fix 001 for both Rational Application Developer and Rational COBOL Generation Extension
  2. Reinstall interim fix 001 for both products

For details on any additional known limitations, problems and workarounds for this release, see the updated version of this readme file at: www3.software.ibm.com/ibmdl/pub/software/rationalsdp/bdcz/601/html/readme_6012_iFix_002.html 

5.0 IBM Rational Software Support

IBM Rational Software Support provides you with technical assistance.

When you contact customer support, the support representative will require the versions of the installed products or interim features on your system.

To determine the versions:

  1. Start IBM Rational Product Updater and complete one of the following steps:
    • If the product is running, click Help > Software Updates > IBM Rational Product Updater.
    • On Windows® operating systems, click Start > Programs > IBM Rational > Rational Product Updater.
    • On Red Hat Enterprise Linux® 3.0 (GNOME desktop environment), open the main menu and click Programming > Rational Product Updater.
    • On SUSE Linux Enterprise Server 9.0 (K Desktop Environment), open the main menu and click IBM Rational > Rational Product Updater.
  2. Click the Installed Products tab.

For product news, updates, and fixes, consult the following sites for information regarding EGL COBOL Generation:

Before you contact IBM Rational Software Support, gather the background information that you will need to describe your problem. When describing a problem to an IBM software support specialist, be as specific as possible and include all relevant background information so that the specialist can help you solve the problem efficiently. To save time, know the answers to these questions:

  • What software versions were you running when the problem occurred?
  • Do you have logs, traces, or messages that are related to the problem?
  • Can you reproduce the problem? If so, what steps do you take to reproduce it?
  • Is there a workaround for the problem? If so, be prepared to describe the workaround.

6.0 Notices and trademarks

© Copyright IBM Corporation 2006, 2009. All Rights Reserved.

This information was developed for products and services offered in the U.S.A. IBM may not offer the products, services, or features discussed in this documentation in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service.

IBM may have patents or pending patent applications covering subject matter described in this documentation. The furnishing of this documentation does not give you any license to these patents. You can send license inquiries, in writing, to:

IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk, NY 10504-1785
U.S.A.

For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to:

IBM World Trade Asia Corporation
Licensing
2-31 Roppongi 3-chome, Minato-ku
Tokyo 106, Japan

The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OR CONDITIONS OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you.

This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice.

Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact:

Intellectual Property Dept. for Rational Software
IBM Corporation
3600 Steeles Avenue East
Markham, Ontario
Canada L3R 9Z7

Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee.

The licensed program described in this documentation and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement or any equivalent agreement between us.

Trademarks and service marks

The following terms are trademarks of International Business Machines Corporation in the United States, other countries, or both:

  • developerWorks
  • IBM
  • Rational
  • zSeries

Linux is a trademark of Linus Torvalds in the United States, other countries, or both.

Microsoft and Windows are trademarks of Microsoft Corporation in the United States, other countries, or both.

Other company, product, or service names may be trademarks or service marks of others.