If your file system is FAT32 instead of NTFS, more space will be required.
You will also require 100 MB in the TEMP directory.
You
will require 100 MB in the /tmp directory.Before using this information and the product it supports, read the information in Notices.
This edition applies to version 6.0.1 of IBM Rational EGL COBOL Generation Extension for zSeries (part number 5724-N92) and to all subsequent releases and modifications until otherwise indicated in new editions.
This file is available in the following national languages:
| Traditional Chinese |
Brazilian Portuguese |
German |
| Simplified Chinese |
Korean | Spanish |
| Japanese |
Before you install IBM(R) Rational(R) COBOL Generation Extension for zSeries(R), your system must meet the requirements listed in this section.
Your system must meet the software requirements described in this section before you install Rational COBOL Generation Extension for zSeries.
Before you install this product, you must install one of the following software items:
Note that to install version 6.0.1 (or later) of Rational Application Developer or Rational Software Architect, you must first install version 6.0 of the product and then update the product to version 6.0.1 or later using the update tool, Rational Product Updater. Refer to Installing updates.
If you did not install the EGL optional feature when you installed Rational Application Developer or Rational Software Architect, then you must install this feature before you install Rational COBOL Generation Extension for zSeries. Refer to Installing the EGL feature.
If you updated Rational Application Developer or Rational Software Architect to version 6.0.1 or later before installing the EGL feature, then you need to update the EGL feature as well. Refer to Updating the EGL feature.
For information on the software requirements for installing Rational Application Developer or Rational Software Architect, refer to the installation guide for the corresponding product.
Note that when you install Rational COBOL Generation Extension for zSeries, it shares the common development environment of Rational Application Developer or Rational Software Architect. (The IBM Rational Software Development Platform is installed only once.) Rational Application Developer and Rational Software Architect have the same user interface, called a workbench. When you install Rational COBOL Generation Extension for zSeries, functionality is added to the workbench by contributing plug-ins. A plug-in is a software module that adds function to an existing program or application.
Disk space requirements:
If your file system is FAT32 instead of NTFS, more space will be required.
You will also require 100 MB in the TEMP directory. You
will require 100 MB in the /tmp directory.Other hardware requirements are the same as those for Rational Application Developer and Rational Software Architect. Refer to the installation guide for the corresponding product.
You must have a user ID that meets the following requirements before you install Rational COBOL Generation Extension for zSeries:
You must have a user ID belonging to the Administrators group. You
must be able to log in as root.Rational COBOL Generation Extension for zSeries cannot coexist with the following software installed on the same machine:
If either of these products is already installed on your system, you will not be able to install Rational COBOL Generation Extension for zSeries.
Also, it is recommended that you uninstall Rational COBOL Generation Extension for zSeries if you choose to install either WebSphere Development Studio Client Advanced Edition for iSeries or WebSphere Developer for zSeries onto the same system. Installing either WebSphere Development Studio Client Advanced Edition for iSeries or WebSphere Developer for zSeries onto the same system onto the same system as Rational COBOL Generation Extension for zSeries is not supported.
You will need the IBM Rational COBOL Runtime for zSeries (5655-R29) for runtime library execution on the zSeries machine. You must purchase this product (which is not available through Passport Advantage(R)) separately from the IBM Rational COBOL Generation Extension for zSeries. For information about customizing and administering the Rational COBOL Runtime for zSeries see IBM Rational COBOL Runtime Guide for zSeries. You will find a PDF version of this document in the IBM Publications Center at http://www.elink.ibmlink.ibm.com/public/applications/publications/cgibin/pbi.cgi. It is also available from IBM developerWorks(R) at ftp://www6.software.ibm.com/software/developer/rational/zip/rational_cobol_runtime_guide_en.pdf.
Before you install the product, check the following things:
If
you want to enable the product to be used by users other than root, then you
must set the umask variable. The umask setting for the terminal session used
to install the product is set to 0022. To set this variable, log in as root
user, start a terminal session, and type umask 0022.
You can install the product from the CD, from an electronic image that has been downloaded and extracted on your local machine, or from an electronic image located on a shared drive.
For instructions on downloading and creating an electronic image, refer to Creating an electronic installation image.
For instructions on creating an installation image on a shared drive, refer to Creating an installation image on a shared drive.
The installation program can also be run in an interactive console mode, which may be better suited for persons with accessibility requirements. The -accessibility option makes the runtime console mode wizard easier to use with screen reader programs. To run in console mode, change to the \disk1 directory of the installation image and type the following command on one line:
setup.exe -is:javaconsole -log @NONE -accessibility setup.bin -is:javaconsole -log @NONE -accessibilityNote that the -is:javaconsole option is critical when specifying the -accessibility option. If you do not specify this option the installation program will hang. The -log @NONE option turns logging off to eliminate log information being listed in the console window. If you experience any problem during the install, you may want to eliminate this option in order to collect log information.
To install Rational COBOL Generation Extension for zSeries, follow these steps:
Mount
the CD drive. Drive:\setup.exe CD_device/setup where CD_device by
default is /media/cdrom on SUSE Linux and /mnt/cdrom on Red Hat Linux.
If you are installing from
an installation image on a shared drive on your network, you must locally
map the drive by specifying a device name (for example, x:\sharename). If
you map to a network drive without specifying a device name (for example,
\\computername\sharename), you may get the following error message when you
try to install Rational COBOL Generation Extension for zSeries and the installation will not complete:
The wizard cannot continue because of the following error: could not load wizard specified in /wizard.inf(104)
Verify
the permissions on the setup file that is located
in this temporary directory is executable, for example by typing:
chmod +x setup
setup.exe ./setupImportant: Do not install into a directory whose name contains
double-byte characters or special characters such as a dollar sign. Doing
so may cause undesirable results such as class path problems.Note:
The disk space requirement shown is the total number of bytes needed
for all the files. The actual disk space needed can be considerably greater.
In particular, if your disk is formatted as FAT32, the many small files can
use disk space inefficiently due to the disk blocking structure that FAT32
uses.
To create an electronic installation image from downloaded files:
Modify
the permissions on the extractor.bin file that is located in this directory
by typing: chmod +x extractor.bin extractor.exe./extractor.binYou can place a copy of the installation image on a shared drive so that users can install across a network.
In order to run the installation program from a shared drive, you must either work with a downloaded electronic image of Rational COBOL Generation Extension for zSeries or copy the contents of the product CD as described below. For information on creating an electronic image, refer to Creating an electronic installation image.
You need approximately 75 MB of disk space on a Windows system and 125 MB of disk space on a Linux system to store the content of the CD. To copy the files from the CD:
Mount
the CD drive or DVD drive. network_drive:\install_image install_imageThe Rational COBOL Generation Extension for zSeries installation program can be run silently if you do not want to interact with the installation wizard.
To install Rational COBOL Generation Extension for zSeries silently:
setup.exe -silent ./setup.bin -silent setup.exe -silent -P installLocation="<my location>" ./setup.bin -silent -P installLocation="<my location>"Important: Do not install into a directory whose name contains double-byte characters
or special characters such as a dollar sign. Doing so may cause undesirable
results such as class path problems..
You can also install silently to a directory other than the default location by using a response file. For more information, see Silently installing using a response file.
For silent installation, you can use a response file to specify the installation settings prior to running the installation program. The response file for IBM Rational COBOL Generation Extension for zSeries is called responsefile.txt and it is located in the \disk1\util directory of the installation CD or the directory where you stored the electronic installation image.
To silently install using a response file, create a response file and then invoke the installation program in silent mode using the response file option.
To create a response file:
-P installLocation= "x:\myDirectory\" -P installLocation= "/myDirectory/"To invoke the installation program silently using the response file that you created, follow all the instructions given already in the section Invoking silent installation but start the installation program using the following command:
setup.exe -options ".\my response file.txt" -silent ./setup.bin -options "./my response file.txt" -silentwhere my response file is the name of your saved response file.
The EGL feature in Rational Application Developer or Rational Software Architect is a prerequisite to installing Rational COBOL Generation Extension for zSeries.
The following steps will guide you through the process of installing the EGL feature from a CD of Rational Application Developer V6.0 or Rational Software Architect V6.0. For additional information, refer to the installation guide for Rational Application Developer V6.0 or Rational Software Architect V6.0.
The following steps will guide you through the process of updating the EGL feature if you installed it after you updated Rational Application Developer or Rational Software Architect to version 6.0.1 or later. If you installed the EGL feature before you updated Rational Application Developer or Rational Software Architect to version 6.0.1 or later, then you do not need to update the EGL feature.
Uninstalling Rational COBOL Generation Extension for zSeries does not uninstall Rational Application Developer or Rational Software Architect.
Note that if you uninstall Rational Application Developer or Rational Software Architect, then Rational COBOL Generation Extension for zSeries is not automatically uninstalled. However, Rational COBOL Generation Extension for zSeries will not be functional if Rational Application Developer or Rational Software Architect has been uninstalled.
To uninstall Rational COBOL Generation Extension for zSeries:
Tip: If you are working in a file manager, you can click on the file to launch the uninstaller.
Note that your workspace directory, which contains your work, is not deleted.
To uninstall Rational COBOL Generation Extension for zSeries silently:
installation_directory\egl_cobolgen_prod\_uninst /installation_directory/egl_cobolgen_prod/_uninst uninstaller.exe -silent ./uninstaller.bin -silentTo confirm the results of uninstalling the product, refer to the file uninstall_log.txt.
Rational Product Updater is a tool that searches for and installs product updates and optional new features for Rational software products from the IBM update site.
Rational Product Updater is installed automatically when you install Rational Application Developer or Rational Software Architect. You can search for and install the following kinds of updates:
Any dependencies between updates are automatically enforced. Rational Product Updater will also update itself.
Rational Product Updater also enables you to perform these tasks:
To launch Rational Product Updater, run the following command:
installation_directory\updater\eclipse\rpu.exe installation_directory/updater/eclipse/rpuRefer to the help system in Rational Product Updater for information on using the tool. To access the help, select Help > Help Contents in Rational Product Updater.
Use Rational Product Updater to update Rational Application Developer version 6.0 or Rational Software Architect version 6.0 to version 6.0.1 or later. This is a software prerequisite for installing Rational COBOL Generation Extension for zSeries.
For more information on installing the version 6.0.1 refresh pack or later updates, refer to the installation instructions provided with the update.
Note to U.S. Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
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 document 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 document. The furnishing of this document does not grant you any license to these patents. You can send license inquiries, in writing, to:
For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to:
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 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.
Any references in this information to non-IBM Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk.
IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you.
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:
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.
Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products.
The following terms are trademarks of International Business Machines Corporation in the United States, other countries, or both:
Microsoft(R) and Windows are trademarks of Microsoft Corporation in the United States, other countries, or both.
Linux is a trademark of Linus Torvalds in the United States, other countries, or both.
Other company, product or service names, may be trademarks or service marks of others.