IBM Rational Developer for System z Version 9.0.1

Installation Guide


GI11-8297-09

Note

Before using this information, be sure to read the general information under Documentation notices for IBM Rational Developer for System z.

Tenth edition (December, 2013)

This edition applies to IBM® Rational® Developer for System z® Version 9.0.1 (program number 5724-T07) and to all subsequent releases and modifications until otherwise indicated in new editions.

Order publications by phone or fax. IBM Software Manufacturing Solutions takes publication orders between 8:30 a.m. and 7:00 p.m. eastern standard time (EST). The phone number is (800) 879-2755. The fax number is (800) 445-9269. Faxes should be sent Attn: Publications, 3rd floor.

You can also order publications through your IBM representative or the IBM branch office serving your locality. Publications are not stocked at the address below.

IBM welcomes your comments. You can send your comments by mail to the following address:

IBM Corporation
Attn: Information Development Department 53NA
Building 501 P.O. Box 12195
Research Triangle Park NC 27709-2195.
USA

When you send information to IBM, you grant IBM a nonexclusive right to use or distribute the information in any way it believes appropriate without incurring any obligation to you.

Note to U.S. Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

About this book

This installation guide provides instructions for installing and uninstalling IBM Rational Developer for System z 9.0.1.

This document contains information about the following tasks:

The following names are used in this manual:
  • IBM Rational Developer for System z is called Developer for System z
  • IBM Rational Developer for System z Common Access Repository Manager is called Common Access Repository Manager, abbreviated to CARMA
Note: The configuration information in this document is for IBM Rational Developer for System z Version 9.0.1

Who should read this book

This book is intended for programmers who are installing and configuring Developer for System z 9.0.1 client on their workstations. To use this book, you must be familiar with the Microsoft Windows operating system, the Red Hat Linux operating system, the SUSE Linux operating system, or the Ubuntu operating system.

Where to find more information about Developer for System z

This document does not contain information about using Developer for System z. For that information, see the online help.

For information about product problems and limitations, see the rdz901_releasenotes.html file located in the Documents\nl\en\readme directory of the IBM Rational Developer for System z Installation disc.

For updated documentation and troubleshooting information, see the Library page of the Developer for System z website: http://www-01.ibm.com/software/sw-library/en_US/products/Z964267S85716U24/?S_CMP=rnav.

Introduction to Developer for System z

Developer for System z has a remote system component and a workstation client component. The remote system component is typically installed by a site's system programmer and is transparent to the application programmers. For the remainder of this guide, unless the remote system component is specifically called out, the term Developer for System z refers to the workstation component, which is the graphical user interface powered by the Eclipse platform.

Developer for System z is a set of development tools built on the Eclipse platform (www.eclipse.org). Think of the Eclipse platform as the framework and Developer for System z and other bundled offerings as the tool contributors.

Preinstallation tasks

About this task

Before you install the product, complete the following steps:
  1. Confirm that your system meets the requirements that are described in the Client installation requirements section.
  2. Confirm that your user ID meets the required access privileges for installing the product. See User privileges requirements.
  3. Read the Planning to install section.
  4. Upgrade Rational License Key Server to version 8.1.2 or higher.
    Note: If you use floating licenses for Rational Developer for System z (including token licenses), you must upgrade the license key server to Rational License Key Server, Version 8.1.2 or higher, before installing the product. Rational License Key Server, Version 8.1.2 or higher can be used with earlier versions of the product. For information about how to upgrade from version 7.1 or earlier versions of Rational License Key Server to version 8.1.2 or higher, see Migrating to Rational Common Licensing (http://publib.boulder.ibm.com/infocenter/rational/v0r0m0/index.jsp?topic=/com.ibm.rational.license.doc/topics/r_migration.html).
  5. Before installing or uninstalling, disable antivirus and malware detection software.
    Note: Some antivirus and malware detection software occasionally locks certain files, especially .dll files. The locking interferes with installation and uninstallation operations. When .dll or other files are locked by these programs, installation and uninstallation operations fail with errors indicating that files could not be removed.

Client installation requirements

About this task

To prepare for installation, confirm these requirements:
  • Media requirements
  • Hardware and software requirements

Media requirements

You can match references to physical discs with references to electronic image directories as shown in the following table.
Table 1. Disc name and electronic image references
Disc Name Electronic Image Directory Name
IBM Rational Developer for System z Installation disc
  • RDz901_Setup
  • RDz901\disk1
  • RDz901_RTCz\disk1
  • RTC403\disk1
  • RTC405\disk1
IBM Rational Developer for System z z/OS® and Multiplatforms Server Installation disc
  • RDz901_zOS_SMPE
  • RDz901_RSE
IBM Rational Developer for System z Quick Start and Documentation disc
  • RDz901_QSandDocumentation
To install Developer for System z on the workstation, you must have access to either of the following media:
  • Developer for System z installation disc:
    • Developer for System z Installation disc
  • Developer for System z electronic image
    After you have downloaded the Developer for System z images from Passport Advantage® and expanded them, the following directories apply to installing Developer for System z on the workstation:
    • RDz901_Setup
    • RDz901\disk1
To install the required System z components on the System z remote system, you must have access to either of the following media:
  • Developer for System z installation disc:
    • Developer for System z Server for z/OS Server Installation disc
  • Developer for System z electronic image:
    After you have downloaded the Developer for System z images from Passport Advantage and expanded them, the following directories apply to installing required software on the System z remote system:
    • RDz901_zOS_SMPE
    • RDz901_RSE
For instructions on installing the host code, see the installation configuration documentation in the related product directory:
  • RDz901_zOS_SMPE for z/OS systems

Media for additional offerings

In addition to the Developer for System z media, you might have additional installation media for other offerings that are bundled with Developer for System z.

To install the Rational Team Concert™ Integration extension, you must have access to the following media:
  • IBM Rational Developer for System z installation disc
    • Rational Developer for System z Installation disc
  • IBM Rational Developer for System z electronic images
    After you have downloaded the Developer for System z electronic images, the following directory applies to installing the extension:
    • RDz901_RTCz\disk1

    See Installing the Rational Team Concert Integration for System z extension for details on installing this software.

Hardware and software requirements

The following information on hardware and software requirements for Developer for System z, is also available in Prerequisites for IBM Rational Developer for System z. The Prerequisites document contains the most current information about hardware and software requirements. A link to the Prerequisites document can be found on the library page of the Developer for System z Web site:

http://www-01.ibm.com/software/sw-library/en_US/products/Z964267S85716U24/?S_CMP=rnav.

Client prerequisites for Developer for System z

Developer for System z is a licensed program to support users who want to write large-scale business applications.

There are prerequisites and co-requisites for using this software.

Hardware requirements

Verify that you meet the minimum hard disk space requirements to install the product. The following table provides an account of space requirements according to each aspect of the installation process:

Hardware Requirements
Processor
  • Minimum: 32-bit (x86) core2 duo (or equivalent)
  • Recommended: 64-bit (x64) core2 quad (or equivalent)
Memory
  • Minimum: 3 GB RAM
  • Recommended: 4 GB RAM
Disk space
  • Minimum: 1.5 GB
  • Recommended: 2 GB - 5 GB, depending upon Rational Developer for System z configuration and installation of other bundled software.
    Note: Solid® State Drives (SSDs) might further improve performance.
Display 1024 x 768 resolution

Recommended: 1280 x 1024

Workstation prerequisites

Before you can install the product, verify that your system meets the software requirements.

Operating systems
The following operating systems are supported for this product:
Product Name 32-bit 64-bit PTFs or Service Levels Required
Microsoft Windows XP Professional yes no Service Pack 3 or later
Microsoft Windows Server 2008 R2 Enterprise Edition no yes Service Pack 1 or later
Microsoft Windows Server 2008 R2 Standard Edition no yes Service Pack 1 or later
Microsoft Windows Server 2012 Datacenter Edition no yes All available service recommended
Microsoft Windows Server 2012 Essentials Edition no yes All available service recommended
Microsoft Windows Server 2012 Standard Edition no yes All available service recommended
Microsoft Windows 7 Professional Edition yes yes Service Pack 1 or later
Microsoft Windows 7 Enterprise Edition yes yes Service Pack 1 or later
Microsoft Windows 7 Ultimate Edition yes yes Service Pack 1 or later
Microsoft Windows 8 Professional Edition yes yes All available service recommended
Microsoft Windows 8 Enterprise Edition yes yes All available service recommended
Red Hat Linux Desktop v 6.0 yes yes All available service recommended
Red Hat Linux Enterprise Server v 6.0 yes yes All available service recommended
SUSE Linux Enterprise Server v 11.0 yes yes All available service recommended
SUSE Linux Enterprise Desktop v 11.0 yes yes All available service recommended
Ubuntu v 12.04 LTS yes yes All available service recommended
Note:
  1. Developer for System z language support is dependent on the previously listed operating systems having the base language support.
  2. To install Developer for System z in 32-bit mode on Red Hat 6.0, 64-bit edition, the following packages (32-bit libraries) are required:
    • libgtk-x11-2.0.so.0
    • libpk-gtk-module.so
    • libcanberra-gtk-module.so
    • xulrunner.i686
Hosted Development Environments/Virtualization Support
Product Name Version PTFs or Service Levels required
Citrix® XenApp 6.0 all available maintenance
VMware® vSphere 4.1 ESXi and vSphere 5 ESXi all available maintenance

For additional information about Software support services for IBM SWG products in a virtualization environment, see Software support for IBM SWG products in a VMware environment.

Workstation corequisites

Developer for System z requires the software listed in this section to be installed as a corequisite to installation depending on the Developer for System z functions you select to install.

Note: For information about supported database servers, Web application servers, and other software products, see the online help.
TXSeries for Multiplatforms
Note: There is no TXSeries support on the Developer for System z Linux client.
One of the following levels must be installed to support applications with embedded CICS® statements:
Program Number Product Name PTFs or Service Levels Required
5724–B44 TXSeries for Multiplatforms v 7.1 all available maintenance
5655–M15 TXSeries for Multiplatforms v 6.2 all available maintenance
The related product Web site is as follows:

http://www.ibm.com/software/htp/cics/txseries/

DB2 Connect
To support applications with embedded SQL statements, one of the following levels must be installed:
Program Number Product Name PTFs or Service Levels Required
5724-B56 DB2® Connect Personal Edition v 10.1  
5724-B55 DB2 Connect™ Personal Edition v 9.7  
Web Browser
To view the readme files and the installation guide, one of the following web browsers must be installed:
Product Name PTFs or Service Levels Required
Microsoft Internet Explorer 8.0 or later all available maintenance
Firefox 10.0 or later all available maintenance
Adobe Acrobat Reader
The following software must be installed to properly view product documentation PDFs:
Product Name PTFs or Service Levels Required
Adobe Acrobat Reader Version 7.0 or later all available maintenance

User privileges requirements

You must have a user ID that meets the following requirements before you install IBM Rational Developer for System z.
  • Your user ID must not contain double-byte characters.
  • To install for all users of the system, you must have an ID that belongs to the Administrators group. If you do not have Administrator privileges, you can only install for the current user.

Planning to install

Read all of the topics in this section before attempting to install any of the product features. Many problems can be avoided by proper planning and understanding the key aspects of the installation process before actually beginning installation.

Installation methods

You can install Developer for System z by using several methods.

These are some factors that might determine the installation method that you use:

  • The format and method by which you access the installation files (for example, from installation discs or files downloaded from IBM Passport Advantage)
  • Whether you are installing onto your own workstation, or making the installation files available to your enterprise.
  • Whether you are installing by using the Installation Manager GUI, or installing silently.

These are the typical installation methods that you might use:

  • Installing from the installation discs
  • Installing from a downloaded electronic image on your workstation
  • Installing from an electronic image on a shared drive
  • Installing from a repository on an HTTP server
Note: With the latter three methods, to install Developer for System z, you can run the Installation Manager program in silent mode. For details on running Installation Manager in silent mode, see Silent installation.

Installing from installation discs

With this method, you have the installation discs containing the installation files, and typically you are installing Developer for System z on your own workstation. For an overview of the steps, see Overview: Installing Developer for System z from the installation discs .

Using electronic images

Extracting electronic images

If you download the installation files from IBM Passport Advantage, you must extract the electronic images from the compressed files for Developer for System z and any bundled offerings you want to install before you can begin the installation. Developer for System z electronic images are packaged as .zip files.

Installing from a downloaded electronic image on a workstation

With this method, you have downloaded the installation files from IBM Passport Advantage and you will install Developer for System z on your own workstation. For an overview of the steps, see Overview: Installing Developer for System z from an electronic image on your workstation .

Installing from an electronic image on a shared drive

With this method, you will place the electronic image on a shared drive so that users in your enterprise can access the installation files for Developer for System z from a single location. For an overview of the steps, see Overview: Installing Developer for System z from an electronic image on a shared drive .

Installing from a repository on an HTTP server

This method provides an alternative way to install across a network. This method is different from using an electronic image on a shared drive because, to place installation files for Developer for System z on an HTTP Web server, you must use a utility application called IBM Packaging Utility which is provided with the Developer for System z installation media on the Rational Enterprise Deployment disc. IBM Packaging Utility is used to copy the installation files in a package format that can be used for installing Developer for System z directly from an HTTP Web server. The directory on the HTTP Web server that contains the package is called a repository. The same repository can also be used for other offerings, and for future service updates. For an overview of the steps, see Overview: Installing Developer for System z from a repository on a HTTP Web server and Overview: Placing Developer for System z on an HTTP web server.

Feature installation

You can customize the Developer for System z installation by the features and bundled offerings to install. The Developer for System z launchpad provides you with the option of a guided installation or an expert installation.

For more information about the Developer for System z launchpad program, see Installing Developer for System z by using the launchpad program.

Installation Manager automatically enforces any dependencies between features so that all of the required features are selected.

Note: After you finish installing the package, you can still add or remove features from the installation by running the Modify Packages wizard in Installation Manager. For more information, see Modifying installed packages.

Features for Developer for System z

The following table shows the features of Developer for System z that you can choose to install. For information about the available features of other offerings that are bundled with Developer for System z, see the documentation for those offerings.

Table 2. Developer for System z features
Feature Description
System z Integrated Development Environment (required) Provides an interactive, workstation-based environment where you can connect to a mainframe and develop mainframe-based applications in COBOL, PL/I, Assembler, C/C++, and Java™.
Code Review Inspects the code for compliance with rules and best practices. Code review highlights potential problems and recommends code changes for improved quality.
Line-Level Code Coverage Provides the tools to measure and report on test coverage of an application. Reports indicate which source code lines have been tested and which lines remain to be tested.
System z Code Generators Provides design tools and wizards that you can use to rapidly create System z application code skeletons and logic from UML models or user-provided input.
IBM z/OS Automated Unit Testing Framework (zUnit) Provides a code-driven unit testing framework for Enterprise COBOL and PL/I. The IBM z/OS Automated Unit Testing Framework (zUnit) provides an automated solution for executing and verifying Enterprise COBOL and PL/I unit test cases that are written using the zUnit framework.
SCLM Developer Toolkit Provides tools to access and work with source code managed by Software Configuration and Library Manager (SCLM).
Rational ClearCase® SCM Adapter Provides the IBM Rational ClearCase SCM and ClearCase MVFS plug-ins, which enable versioning of software artifacts in ClearCase versioned object bases (VOBs) by using snapshot views and dynamic views when ClearCase VOB and view servers are also installed.
CA Endevor Software Change Manager Provides tools to access and work with source code managed by CA Endevor Software Change Manager.
Enterprise Service Tools for CICS (including Service Component Architecture) Enterprise Service Tools for CICS provide an integrated set of tools that support modern application architectures and the transformation and reuse of existing CICS application processes. The tools support generation of Web service descriptions and service flow processing artifacts directly to a z/OS system, including CICS TS and the CICS Service Flow Runtime. Enterprise Service Tools quickly enable the move towards service-oriented architecture (SOA).
BMS Screen Designer Enables you to visually create and modify Basic Mapping Support (BMS) map sets. It is designed for CICS developers who are familiar with terminal-based tools (for example, SDF II) or GUI-based tools, such as the BMS editor included with VA COBOL.
CICS Code Generators Provides design tools and wizards that you can use to create CICS Transaction Server application code skeletons and logic from UML models or user-provided input, for example, using UML models or database schema definitions to generate CICS transactions which provide Create, Read, Update, and Delete interfaces to DB2 tables.
Enterprise Service Tools for IMS™ Provides an integrated set of tools that support modern application architectures and the transformation and reuse of existing IMS application processes. The tools support the generation of Web service descriptions and processing artifacts directly to a z/OS system, including the IMS SOAP Gateway and IMS information 2.0 applications. Enterprise Service Tools are designed to enable the move towards service-oriented architecture (SOA).
MFS Screen Designer Enables you to create and modify Message Format Service (MFS) message and format files. Many Information Management System (IMS) programs are based on MFS, which is an IMS Transaction Manager environment facility that formats messages to and from terminal devices.
IMS Code Generators Provides code snippets that you can use to add common programming objects to IMS application code.
Data Tools Provides relational database tools to work with tables, table views, and filters. With these tools, you can create physical database models by reverse engineering database tables or by using DDL scripts. You can also use the tools to create SQL statements, DB2 routines (such as stored procedures and user-defined functions), and several types of files, including SQLJ, SQL DDL, and XML files.
System z Stored Procedures Enables you to create and test DB2 stored procedures written in COBOL, PL/I, Java, or SQL, and deploy them directly to a z/OS system.
System z Debugger Provides a workstation-based interface to IBM Debug Tool, facilitating remote debug sessions with applications executing on a z/OS System. Note: This feature requires that you have a license for IBM Debug Tool.
Common Access Repository Manager (CARMA) Provides a unified interface and set of services for accessing System z-based source control management tools. CARMA also provides a generic graphical user interface (GUI) client that you can use as a framework for accessing and interfacing with custom source control management systems.
Plug-in Development Environment (PDE) Provides tools for creating, developing, testing, debugging, and deploying Eclipse plug-ins, which you can use to extend the IBM Software Delivery Platform Eclipse environment.

IBM Installation Manager

IBM Installation Manager is a program that installs Developer for System z and other packages on your workstation. It also updates, modifies, and uninstalls these and other packages that you install. A package can be a product, a group of components, or a single component that is designed to be installed with the Installation Manager.

For the most current information about the IBM Installation Manager, see the Installation Manager information center at

http://publib.boulder.ibm.com/infocenter/install/v1r7/index.jsp

Installation Manager is an installation management tool that has several time-saving features. It helps you install, update, modify, and uninstall product packages on your computer. It keeps track of what you are about to install, as well as what you have already installed and what is available for you to install. It searches for updates so that you know that you are installing the latest version of a package. It also provides tools for managing licenses for the packages it installs, and for updating and modifying packages.

For information about how to deploy Developer for System z to many users, see the information available in the "Enterprise installation articles" section of the Installation Manager Information Center at

http://publib.boulder.ibm.com/infocenter/install/v1r7/topic/com.ibm.im.articles.doc/topics/articles.html

and on the Rational Installation Wiki on developerWorks® at

https://www.ibm.com/developerworks/wikis/display/rationalinstall/Home.

Use the six wizards in Installation Manager to maintain a package through its lifecycle, as follows:
  • The Install wizard walks you through the installation process. You can install a package by accepting the defaults, or you can change the default settings to customize an installation. Before you install a package, you see a summary of your selections throughout the wizard. Using the wizard, you can install one or more packages at one time.
  • The Update wizard searches for available updates to packages that you have installed. An update might be a released fix, a new feature, or a new version of the product. Details of the contents of the update are provided in the wizard. You can decide whether to apply an update.
  • With the Modify wizard, you can change certain elements of a package that you have installed. During the first installation of the package, you select the features to install. If you require other features later, you can use the Modify wizard to add the features. You can also remove features.
  • The Manage Licenses wizard helps you set up the licenses for your packages. Use this wizard to change a trial license to a full license, to set up the servers for floating licenses, and to select the type of license to use for each package.
  • The Import wizard adds packages that were installed by using installation tools other than Installation Manager to the list of installed packages.

    Installation Manager tracks the products that it installs, including selectable features and maintenance updates for products. Earlier versions of some products that can be installed with Installation Manager might have been installed with different installation technology. Installation Manager must import information about existing installations of these products before Installation Manager can modify and update the products.

    Note: This wizard is available only after Installation Manager detects a package in a repository that requires this feature.
  • The Roll Back wizard enables you to revert to a previous version of a package.
  • The Uninstall wizard removes a package from your computer. You can uninstall more than one package at a time.

Installing Installation Manager

About this task

IBM Installation Manager is typically installed automatically as part of the Developer for System z installation process.

If you need to install IBM Installation Manager by itself, without installing Developer for System z, you can find the installation files at these locations:
  • On the IBM Rational Developer for System z Installation Setup disc, in the InstallerImage_platform directory where platform is the platform on which you are installing (for example, win32 or linux).
  • If you downloaded an electronic image, in the RDz901_Setup\InstallerImage_platform directory
You can install Installation Manager directly from the installation media, or copy the InstallerImage_platform directory to a shared location where it can be accessed by others.
  1. Change to the InstallerImage_platform directory.
  2. To install as administrator for all of the users on the system, run the following command:

    install.exe

    install

    To install as a non-administrator for the current user only, run the following command:

    userinst.exe

    userinst

  3. On the first page of the Install Packages wizard, click Check for Other Versions and Extensions to install the latest available version. If a newer version is available, it is automatically selected for installation. Click Next.
  4. On the Licenses page, read the license agreements for IBM Installation Manager. If you agree to the terms of all of the license agreements, click I accept the terms in the license agreements and then click Next.
  5. On the Location page, in the Installation Manager Directory field, type the path for the directory where Installation Manager must be installed or accept the default path. Then click Next.
  6. On the Summary page, review your choices before starting the installation process. To change your selections, click Back to return to the previous pages. When you are satisfied with your selections, click Install.
You can also silently install Installation Manager by doing these steps:
  1. Open a command prompt or terminal window and change to the InstallerImage_platform directory (where platform is the platform on which you are installing).
  2. To install silently as administrator for all of the users on the system, run the following command:

    installc.exe -acceptLicense

    installc -acceptLicense

    To install as a non-administrator for the current user only, run the following command:

    userinstc.exe -acceptLicense

    userinstc -acceptLicense

    Note: By providing the -acceptLicense command line option, you indicate that you accept the terms of the IBM Installation Manager license agreement.

Starting Installation Manager

About this task

IBM Installation Manager is installed and started automatically when you start the Developer for System z installation.

If you need to start Installation Manager manually to update, modify, roll back, or uninstall packages following the installation, do these steps:

  1. Open the Start menu from the Taskbar.
    • For an administrator installation, click All Programs > IBM Installation Manager > IBM Installation Manager.
    • For a non-administrator installation, click All Programs > My IBM Installation Manager > IBM Installation Manager
  1. Open a terminal window.
  2. Go to the Installation Manager install directory/eclipse directory.
  3. Run this command: ./IBMIM

Uninstalling Installation Manager

About this task

Note: You cannot uninstall IBM Installation Manager until all of the packages have been uninstalled.
The IBM Installation Manager must be uninstalled using the Add or Remove Programs panel.
  1. Open the Start menu from the Taskbar.
  2. Select Control Panel -> Add or Remove Programs -> IBM Installation Manager.
  3. Click Remove and follow the on-screen instructions.
Do these steps to uninstall Installation Manager:
  1. Open a terminal window.
  2. Run the following command: /var/ibm/InstallationManager/uninstall/uninstall.

Using Installation Manager

Installation repositories

Installable offerings, or packages, are stored in locations called repositories, which can be on an HTTP Web server, shared network drive, physical discs, or a local workstation. Installation Manager retrieves packages from these repositories to install them on your system.

When you launch the installation of Developer for System z from the launchpad program, the necessary repository information is passed to Installation Manager automatically. Anytime you start Installation Manager manually from the Windows Start menu, you must specify the repositories that contain the packages to be installed. Enter the repository details in the Installation Manager repository preferences so that Installation Manager knows where to look for them. For more details, see Setting repository preferences in Installation Manager.

Some organizations might bundle and host their own product packages within their intranet. For this type of business case scenario, see Installing from a repository on an HTTP server. Your system administrators must provide you with the correct URL.

By default, IBM Installation Manager uses an embedded URL in each package that you install to connect to a repository server through the Internet and search for installable packages, such as service updates and new features.

Setting repository preferences in Installation Manager

About this task

When you start the installation of Developer for System z from the launchpad program, the necessary repository information is automatically passed to Installation Manager. However, if you start Installation Manager manually from the Windows Start menu, for example to install packages from a repository located on a Web server, you must add the repository location in the Installation Manager preferences before you can install the package. Adding the repository locations is done on the Repositories panel of the Preferences window in Installation Manager. By default, Installation Manager uses an embedded URL in each Rational software development product to connect to a repository server through the Internet and search for installable packages, updates, and new features. Your organization could require you to redirect the repository to use intranet sites.

Note: Before starting the installation process, be sure to obtain the installation package repository URL from your administrator.
To add, edit, or remove a repository location in Installation Manager, take the following steps:
  1. Start Installation Manager.
  2. On the Start page of Installation Manager, click File -> Preferences, and then click Repositories. The Repositories page opens, showing any available repositories, their locations, and if they are accessible.
  3. On the Repositories page, click Add Repository.
  4. On the Add repository window, enter the URL of the repository location or browse to it and enter a file path, and then click OK. The new or changed repository location is listed. If the repository is not accessible, a red x is displayed in the Accessible column.
  5. Click OK to exit.

Package groups and the shared resource directory

When you install Developer for System z with IBM Installation Manager, you must choose a package group and a shared resource directory.

Package groups

During the installation process, you must specify a package group for Developer for System z and any other bundled offerings you are installing. A package group represents a directory in which the packages share resources with other packages in the same group. This is known as shell sharing. When you install Developer for System z and any bundled offerings with Installation Manager, you can create a new package group or install the packages into an existing package group. (Some packages might not be able to share a package group, in which case the option to use an existing package group is not available.)

Note: Under most circumstances, when you install multiple packages at the same time, all of the packages are installed into the same package group.

A package group is assigned a name automatically; however, you choose the installation directory for the package group.

After you create the package group by successfully installing a package, you cannot change the installation directory for the package group. The installation directory contains files and resources that are specific to the packages installed into that package group. Other resources in the packages that can potentially be shared by other package groups are placed in the shared resources directory.

Shared resources directory

The shared resources directory is the directory where resources that can be shared by different packages, potentially in different package groups, are stored. Using a common location for these resources allows Installation Manager to install only one copy of each of these resources, thus conserving disk space, rather than installing separate copies of the same resources when they are used by multiple packages.

Important: You can specify the shared resources directory only once: the first time that you install a package. For best results, use the largest drive for this directory. You cannot change the directory location later unless you uninstall all of the packages.

Extending an existing Eclipse IDE

The Developer for System z package includes a version of the Eclipse integrated development environment (IDE), or workbench, which is installed when you install Developer for System z. However, if you have an existing Eclipse integrated IDE that is already installed on your workstation, you can extend that IDE by adding the Developer for System z functionality to the existing environment.

To extend an existing Eclipse IDE, during the Developer for System z installation, select the Extend an existing Eclipse IDE option on the Location page of the Install Packages wizard. You are asked for the location of the existing Eclipse IDE and the Java Virtual Machine (JVM) to use.

You might extend an existing Eclipse IDE, for example, because you want to gain the functionality provided in the Developer for System z package, but also want to have the preferences and settings in your current IDE when you work with the functionality from Developer for System z. You also might want to work with plug-ins you have already installed to extend the Eclipse IDE.

To be extended, the existing Eclipse IDE must be version 4.2.2 and must use at least version 1.6 of the IBM Java Development Kit (JDK). Installation Manager checks that the Eclipse environment you specify meets the requirements for the installation package. If the requirements are not met, you will not be able to extend that Eclipse IDE.

Installing Developer for System z

Installation tasks summary

The following sections provide an overview of the various installation methods you might use when installing Developer for System z.

Overview: Installing Developer for System z from the installation discs

About this task

In this installation scenario, you have the physical discs containing the installation files, and typically you are installing Developer for System z on your own workstation.

The general steps for installing from the installation discs are these:
  1. Complete the preinstallation steps that are listed in Preinstallation tasks.
  2. Insert the Rational Developer for System z Installation disc into the DVD drive.
  3. If autorun is enabled on the system, the Developer for System z launchpad program automatically opens. If autorun is not enabled, start the launchpad program by running the following command from the root of the disc:

    : launchpad.exe

    : launchpad.sh

    For details, see Installing Developer for System z by using the launchpad program.

  4. Click Install Rational Developer for System z.
  5. Decide whether to do an expert installation or a guided installation of Developer for System z. A guided installation uses an installation wizard to help you decide which features to install. An expert installation starts with the most common features selected and asks you for the features to install. For details, see Installing Developer for System z by using the launchpad program.
  6. To install Developer for System z and any bundled offerings, follow the on-screen instructions in the IBM Installation Manager Install Packages wizard. For details, see Installing Developer for System z by using Installation Manager.
  7. Configure the licenses for Developer for System z and any bundled offerings you installed, as needed. If you have a trial license and must configure a term or permanent license, or if you want to configure floating licenses, do so now. See Managing licenses for details.
  8. Install additional software included with Developer for System z. For more information, see Installing additional software.

Overview: Installing Developer for System z from an electronic image on your workstation

About this task

The general steps for installing from an electronic installation image are these:
  1. Ensure that your workstation has sufficient space to store both the files that you must download from IBM Passport Advantage, the extracted installation image, and the offerings that you plan to install. See Hardware requirements.
  2. Download all of the required parts for Developer for System z and any bundled offerings to install from IBM Passport Advantage to a temporary directory.
  3. Extract the installation image from the compressed files that you downloaded and verify that the installation image is complete. See Extracting electronic images for details.
  4. Continue with the steps inInstalling from an electronic image.

Installing from an electronic image

About this task
Do these steps:
  1. Complete the pre-installation steps that are listed in Preinstallation tasks.
  2. Start the launchpad program by running the following command from the root of the RDz901_Setup directory:

    launchpad.exe

    launchpad.sh

    For details, see Installing Developer for System z.

    Note: If your operating system is Windows 7 or Windows 8 and you are installing the product for all users, then you must run launchpad.exe as administrator.
  3. Click Install Rational Developer for System z.
  4. Decide whether to do an expert installation or a guided installation of Developer for System z. A guided installation uses an installation wizard to help you decide which features to install. An expert installation starts with the most common features selected and asks you for the features to install. For details, see Installing Developer for System z.
  5. To install Developer for System z and any bundled offerings, follow the on-screen instructions in the IBM Installation Manager Install Packages wizard. For details, see Installing Developer for System z by using Installation Manager.
  6. Configure the licenses for Developer for System z and any bundled offerings that you installed as needed. If you have a trial license and must configure a term or permanent license, or if you want to configure floating licenses, do so now. See Managing licenses for details.
  7. Install the additional software included with Developer for System z. For more information, see Installing additional software.

Overview: Installing Developer for System z from an electronic image on a shared drive

About this task

In this scenario, you will place the electronic image on a shared drive so that users in your enterprise can access the installation files for Developer for System z and any bundled offerings from a single location. Installing from a shared drive is also useful when you need to install silently on many user systems. Do these steps to place the installation image on a shared drive:
  1. Ensure that the shared drive has sufficient disk space to store both the files that you must download from IBM Passport Advantage and the extracted installation image. For details, see Hardware requirements.
  2. Download all of the required parts for Developer for System z and any bundled offerings from IBM Passport Advantage to a temporary directory on the shared drive.
    Note: You can instead download the parts to your workstation and copy only the extracted installation image to the shared drive.
  3. Extract the installation image from the downloaded files to an accessible directory on the shared drive and verify the installation image is complete. See Extracting electronic images for details.
To install Developer for System z interactively from the installation files on the shared drive, do these steps:
  1. Change to the RDz901_Setup directory on the shared drive containing the installation image.
  2. Follow the steps in Installing from an electronic image to install Developer for System z and any bundled offerings.

For information about installing silently by using a shared electronic image, see Silent installation.

Overview: Installing Developer for System z from a repository on a HTTP Web server

About this task

In this scenario, the product packages are retrieved by the IBM Installation Manager from an HTTP Web server.

These steps assume the repository containing the packages for Developer for System z and any bundled offerings has been created on the HTTP Web server. For details on copying the installation packages to an HTTP Web server, see Overview: Placing Developer for System z on an HTTP web server.

To install the Developer for System z package from a repository on an HTTP server, take the following steps:
  1. Complete the pre-installation steps listed in Preinstallation tasks.
  2. Install IBM Installation Manager. See Installing Installation Manager.
  3. Start Installation Manager. For details, see Starting Installation Manager.
  4. Add the URL of the repository containing the Developer for System z package to the repository preference in Installation Manager. See Setting repository preferences in Installation Manager.
  5. Click Install to start the Install Packages wizard in Installation Manager, and follow the on-screen instructions to complete the installation.
  6. Configure the licenses for Developer for System z and any bundled offerings you installed as needed. If you have a trial license and need to configure a term or permanent license, or if you want to configure floating licenses, do so now. See Managing licenses for details.
  7. Install additional software included with IBM Rational Developer for System z. For more information, see Installing additional software.

Overview: Placing Developer for System z on an HTTP web server

You can place the Developer for System z install package, and the other offering packages, on an HTTP web server by using the IBM Packaging Utility to create an installation repository. You might choose this method if you have several different offerings or service updates that must be placed in a single repository in addition to the Developer for System z 9.0.1 offering and its bundled offerings. You can use this repository to install interactively or silently.

Note: Though you can install silently from a repository on an HTTP web server, such a server is not required for silent installations.

To place packages on an HTTP web server, you use the IBM Packaging Utility to create a new installation repository or copy to an existing repository. For detailed instructions on installing and using IBM Packaging Utility, see the Installation Manager information center, at http://publib.boulder.ibm.com/infocenter/install/v1r7/index.jsp. The "Managing packages with Packaging Utility" topic at http://publib.boulder.ibm.com/infocenter/install/v1r7/topic/com.ibm.cic.auth.ui.doc/topics/c_modes_pu.html contains the most current information.

After you have created the repository, do these steps:

  1. Provide the users in your enterprise with the URL of the installation repository. Users can point to the repository and install without having the installation media on their systems.
  2. Use the repository for silent installations. For details on running silent installations, see Silent installation.

Installing Developer for System z by using the launchpad program

The Developer for System z launchpad program provides you with a single location to view release information and begin the installation process.

Use the launchpad program to start the installation of Developer for System z in the following cases:
  • You are installing from the product installation discs.
  • You are installing from an electronic image on your workstation.
  • You are installing from an electronic image on a shared drive.

When you start the installation from the launchpad program, IBM Installation Manager is launched with the necessary repository location information automatically configured. This automatic configuration frees you from having to set the repository location manually in the Installation Manager preferences.

On the Install Rational Developer for System z panel of the launchpad, you can decide to install for all of the users (which requires you to have administrator access) or only for the current user. Then, you click one of the provided links to start a guided installation or an expert installation.

You can choose to do an expert installation rather than selecting a guided installation. Selecting an expert installation launches the Developer for System z installation with the most common features and bundled offerings selected by default.

Note: No matter which installation option you select from the launchpad program, you can always customize the set of features to be installed by selecting and deselecting additional features on the Features panel in Installation Manager.
To start the Developer for System z installation from the launchpad program as an administrator, do these steps:
  1. Complete the preinstallation tasks that are described in Preinstallation tasks, if you have not done so already.
  2. If you are installing from the installation discs, insert the IBM Rational Developer for System z Installation Setup disc into the DVD drive. If you are installing from an electronic image, open the RDz901_Setup directory.
  3. If auto-run is enabled on the system, the launchpad program starts automatically when you insert the IBM Rational Developer for System z Installation Setup disc into the DVD drive. If auto-run is not enabled on the system or you are installing from an electronic image, start the launchpad program by running the following command from the root of the disc or the RDz901_Setup directory:
    • : launchpad.exe
    • : launchpad.sh
  4. Read the Welcome information about the Welcome panel and, to see the available documentation, select Product documentation on the left and click the links.
  5. To install IBM Rational Developer for System z, click Install IBM Rational Developer for System z on the left. If you are installing for all of the users, click the Install for all users radio button. If you are installing only for the current user, click the Install for the current user radio button.
  6. Specify the kind of installation to use.
    1. To start a guided installation of IBM Rational Developer for System z, click Start guided installation. On the Developer for System z installation wizard, select the features to install by selecting the corresponding boxes. Then, to continue the guided (or custom) installation, click the link at the bottom of the panel .
    2. To start an expert installation of IBM Rational Developer for System z, click Start expert installation.
  7. IBM Installation Manager is launched to install Developer for System z and any specified bundled offerings. To complete the installation, follow the prompts in the Install Packages wizard. For more details, see Installing Developer for System z by using Installation Manager.
Note: The launchpad panel also has an Install optional software option. Select that box to install optional software such as these:
  • TXSeries for Multiplatforms v7.1
  • DB2 Connect
  • Data Studio

Installing Developer for System z by using Installation Manager

About this task

When you launch the Developer for System z installation from the launchpad program (see Installing Developer for System z by using the launchpad program), IBM Installation Manager starts and the Install Packages wizard is displayed. The following steps guide you through using the Install Packages wizard of Installation Manager to install Developer for System z.

Procedure

  1. The first panel of the wizard displays a list of the packages that are available for installation. The available packages include Developer for System z and any bundled offerings that are recommended based on your selections from the launchpad. For more details about the launchpad program, see Installing Developer for System z by using the launchpad program. The available bundled offerings vary, depending on the edition of Developer for System z that you purchased.
  2. If prompted to update IBM Installation Manager to a newer version, to install the update immediately, click Yes, or to install the newer version later, click No. If you click Yes, Installation Manager updates itself and prompts you for to restart it. Click OK to restart Installation Manager.
    Note:
    • Rational Developer for System z ships with two versions of the Rational Team Concert client and Rational Team Concert Integration for System z. To show both the version 4.0.3 and version 4.0.5 installation options, select the "Show all versions" check box on the Install Packages panel.
    • You must have version 4.0.5 (or later) of Rational Team Concert Server installed in order to connect using the Rational Team Concert version 4.0.5 client.
  3. On the Licenses panel, read the license agreement for the selected packages. Each package to be installed has a license agreement. Click each package name to display the corresponding license agreement.
    1. If you agree to the terms of all of the license agreements, click I accept the terms of the license agreements.
    2. To continue, click Next.
  4. On the Location panel, if you do not have any other packages already installed on the system, specify the location to use for the shared resources directory. In the Shared Resources Directory field, enter the path of the shared resources directory to use. If you are also installing Installation Manager with Developer for System z, in the Installation Manager Directory field, enter the location to install Installation Manager . Select a location on the largest drive for the shared resources directory, because it will be used by every package that you install using Installation Manager, and it cannot be changed after the first package is installed. If you already have one or more packages installed on your system, Installation Manager displays the location of the shared resources directory, but you cannot select or change the location.
    Note: To change the location of the shared resources directory at a later time, you must uninstall all of the packages and then re-install them, specifying a new shared resources directory.

    When you have finished making your selections, click Next.

  5. On the next Location panel, specify whether to create a new package group to contain the Developer for System z package, or to use an existing package group on the system. When you install packages into the same package group, they share a common workbench, and the functionality from the different packages is combined in that workbench. This is known as shell sharing. Packages that are installed into different package groups do not share a workbench and are kept separate from each other. When you have finished making your selections, click Next.
    • To create a new package group for Developer for System z, click Create a new package group. Enter the installation directory to use for the new package group. This directory is where resources are stored which are specific to the packages installed in the package group. Each package group you create on the system has a separate installation directory. This directory is different from the shared resources directory, where resources are installed that can be shared by packages in different package groups. Click Next.
      Note: If you are installing on a 64-bit operating system, you can choose whether to create a 32-bit or 64-bit package group by selecting the corresponding radio button below the Installation Directory field. If you select the 32-bit package group, the installed packages run in 32-bit mode. You cannot change the bit mode of an existing package group after it has been created. Some software packages may support only 32-bit or 64-bit modes and can only be installed into a package group configured for the same architecture.
    • To install Developer for System z into an existing package group, click Use an existing package group. Then, select the package group into which to install Developer for System z. Click Next. If the selected package group is not compatible with Developer for System z, you are prompted to select a compatible package group or to create a new package group.
  6. On the next Location panel, specify whether to extend an existing Eclipse IDE already installed on the system, adding the functionality in the packages that you are installing. To select this option, you must have Eclipse Version 4.2.2 that uses IBM Java Development Kit (JDK) version 1.6 or later.
    • To use the Eclipse IDE and JDK that are packaged with Developer for System z instead of extending an existing one, click Next.
    • To extend an existing Eclipse IDE, select Extend an existing Eclipse. In the Eclipse IDE field, specify the location of the folder containing the Eclipse executable file (eclipse.exe for Windows systems and eclipse for Linux systems.) The Eclipse IDE JVM field displays the Java Virtual Machine (JVM) for the IDE that you specified. Click Next.
  7. On the Features page, under Translations, select the languages to install for this package group. The user interface and documentation for Developer for System z is installed in that language.
    Note: Your choices apply to all of the packages that are installed in this package group.
    Note: In this release of Developer for System z, selecting any of the available languages results in the national language translations for all of the languages being installed.
  8. On the next Features page, select the features to install for Developer for System z and any bundled offerings that you are installing. If you are doing a guided installation, a set of features is selected by default based on your responses to the questions in the installation wizard. To view a description of a feature, click the name of that feature. The feature description is displayed in the Details section at the bottom of the panel. For more information about the available features of Developer for System z, see Feature installation. For information about the available features of the offerings that are bundled with Developer for System z, see the documentation for those offerings.

    When you have finished selecting the features to install, click Next.

  9. On the help system configuration page, specify how you want to access the Help system and then click Next.
  10. On the z/OS connection panel, optionally configure a remote z/OS connection that is created the first time that you launch the Developer for System z workbench using a new workspace. Developer for System z connects to the server to automatically retrieve the workbench configuration settings. This automatic retrieval can help you roll out common configuration settings to multiple users without having to configure each client separately.

    For more information about this feature, see "Push-to-client considerations" in the Developer for System z Host Configuration Reference Guide (SC14-7290).

    By default, the z/OS connection configuration is disabled. If you do not want to configure a z/OS connection, clear the Configure my z/OS connection now check box and click Next. To enable this feature and enter the z/OS connection settings, do these steps:

    1. Select the Configure my z/OS connection now check box.
    2. Enter the host name of the Developer for System z server in the Host name field.
    3. In the Connection name field, enter a name to be used for this connection in the Developer for System z Remote Systems view.
    4. Select either userid/password or certificate for the server authentication method.
    5. Enter the daemon port of the Developer for System z server in the Daemon port field.
    6. Click Next. The z/OS connection will be configured the first time that you launch the Developer for System z workbench by using a new workspace.
  11. On the Summary panel, review your choices before you begin the installation. To change the choices you made on the previous panels, click Back and make the changes. When you are satisfied with the installation choices, click Install. The installation begins and a progress indicator shows the percentage of the installation complete.
  12. When the installation process is complete, a message confirms the success of the installation.

    To view the installation log file for the current session, click View log file.

  13. If necessary, configure the licensing for Developer for System z and other bundled offerings that you installed through the Manage License panel in Installation Manager. This step could include configuring floating license support or installing product activation kits to install permanent or term license keys. For more details, see Managing licenses.

Silent installation

About this task

You can install Developer for System z in silent mode. When you run Installation Manager in silent mode, its user interface is not available; instead, you use a response file to supply the commands required to install the package.

Running Installation Manager in silent mode is helpful because you can use a batch process to install, update, modify, and uninstall packages through scripts.

These are the three main tasks for silent installation:
  1. If you are planning to install silently on multiple systems, copy the installation image to a location on a shared drive or server.
  2. Create the response file.
  3. Run Installation Manager in silent install mode.

The following sections explain the task of copying the installation image to a shared drive or server. For the most current information about the remaining tasks (creating response files and running Installation Manager in silent mode to install the package), see the information center for Installation Manager at http://publib.boulder.ibm.com/infocenter/install/v1r7/index.jsp.

The "Working in silent mode" topic at http://publib.boulder.ibm.com/infocenter/install/v1r7/topic/com.ibm.silentinstall12.doc/topics/t_silentinstall_overview.html provides detailed information about these topics.

Copying the installation image to a shared drive or server

About this task

If you are planning to install silently on multiple systems, copy the installation image to a location on a shared drive where other systems in the intranet can access it.

To copy the installation image from physical installation discs to a shared location, do these steps:
  1. Insert the IBM Rational Developer for System z Installation disc into the DVD drive.
  2. Copy the contents of the Developer for System z Installation disc into the shared location where the installation image is to be stored.
  3. To make other offerings that are bundled with Developer for System z available for silent installation, follow the previously mentioned process for these offerings.
    1. If the bundled offering installation is contained on a single installation disc, copy the contents of that installation disc to the directory you created in Step 1. If the bundled offering includes multiple installation discs, do these steps.
      1. Create a new directory in the shared location to contain the product installation files for the bundled offering. This directory can have any name.
      2. For each installation disc, create a diskN directory for each installation disc inside the directory you created to contain the product installation files, where N corresponds to the number of the installation disc. Copy the contents of each installation disc into the corresponding diskN directory that you created for that disc.
After you have finished copying the contents of the installation discs to the shared location, you are ready to create a response file and install silently.
To copy the installation image from an electronic image to a shared location, do these steps:
  1. Extract each of the compressed files that you downloaded for Developer for System z and any bundled offerings that are to be made available for silent installations to the shared location where the image is to be stored. Alternatively, extract the compressed files on the local system and copy the extracted files and directories to the shared location.
  2. In the shared location, verify that you now have these files:
    1. The root of the shared directory has these directories:
      • RDz901_Setup
      • RDz901
      • One directory for each bundled offering that you are making available for silent installations. The available bundled offerings vary, depending on the edition of Developer for System z that you purchased.
    2. The RDz901 directories, and the directory for each bundled offering that you copied to the shared location has one or more diskN directories, one for each installation disc for the product.
After you have verified the directory structure of the shared installation image you are ready to create a response file and install silently.

Alternatively, copy the installation image to a repository on an HTTP Web server and use the repository to install silently. To create a repository, use the IBM Packaging Utility. For more details, see Overview: Placing Developer for System z on an HTTP web server.

Post-installation tasks

Configuring the help content

The default for help delivery draws content from the web dynamically. With this remote help, you always have the latest content available from within the product. You can also install the help content locally on your computer.

For additional information about installing and configuring help, see Configuring help content (Configuring help content in the Eclipse client)

To install the help content locally, see one of these topics:
Note: Downloading the help content from the Help download site uses the RDz901_updateSite.zip file. If you do not have internet access, the RDz901_updateSite.zip file is also available in the documentation\help folder on the Developer for System z setup and installation disc and on the Developer for System z Quick Start disc.

Enabling context-sensitive help for EXEC CICS, EXEC SQL, and EXEC DLI statements

Enabling context-sensitive help for EXEC CICS, EXEC SQL, and EXEC DLI statements requires access to the IMS and CICS information centers.

The online versions of these information centers are at:

CICS: http://pic.dhe.ibm.com/infocenter/cicsts/v5r1/index.jsp

IMS: http://publib.boulder.ibm.com/infocenter/dzichelp/v2r2/index.jsp

The IMS and CICS information centers can also be installed locally or on an intranet server. For information about obtaining, installing, and initializing the IMS information center, see Installing and initializing the Information Management Software for z/OS Solutions (IMS) information center. For information about obtaining, installing, and initializing the CICS information center, see Installing and initializing the CICS Transaction Server Version information center

Installing and initializing the Information Management Software for z/OS Solutions (IMS) information center

The Information Management Software for z/OS Solutions information center is available as an installable information center for Microsoft Windows XP Professional systems. The installable information center can run on a local system or on an intranet Windows system.
The Information Management for z/OS Solutions information center DVD (SK5T-7377) can be ordered from the IBM Publication Center for a low cost. The installable information center is available only in English and might not be available for ordering in your country or region. To order the Information Management for z/OS Solutions information center DVD:
  1. Go to the IBM Publications website.
  2. Select your country, region, or language from the drop-down menu, and click Go.
  3. On the next page, select Search for publications.
  4. On the Quick Publications Center search page, enter SK5T-7377 in the Publication number field, and click Go.

After you receive the IMS information center DVD and install the information center, follow the instructions provided in the information center for obtaining the latest updates.

Note: When you install the IMS information center, you can install only the latest DB2 and IMS topics. These topics are the only topics that you need to enable context-sensitive help for EXEC SQL and EXEC DLI statements.
Note: The IMS information center is available only for Microsoft Windows systems. If you are using Linux systems, use the online version of the information center or install the information center on a Microsoft Windows server that you can access on the intranet.

To enable context-sensitive help for EXEC SQL and EXEC DLI statements, go where you installed the information center and initialize the information center by running IC_start.bat. This routine initializes the information center on the 8801 port. The information center must be initialized by using the 8801 port to ensure that the help information can be found by context-sensitive help.

Note: Initializing the IMS information center initialization using the shortcuts in the Start menu results in a random assignment of a port number. If you use the shortcuts provided in the Start menu, context-sensitive help cannot locate and display the appropriate documentation.

To open the IMS information center, run IC_start.bat and use a browser to link to http://127.0.0.1:8801/help/index.jsp.

Installing and initializing the CICS Transaction Server Version information center

The CICS Transaction Server Version information center can run in Microsoft Windows, Linux, and AIX environments. A package is provided for each platform on the IBM Publications Center. Each package contains all of the Eclipse code and CICS documentation that is required to run an information center on a workstation or a server.

To download the CICS Information Center:

  1. Go to the IBM publications center website: http://www.ibm.com/e-business/linkweb/publications/servlet/pbi.wss.
  2. Click Search for publications and enter the appropriate publication number:
    SK4T-2664 	CICS Transaction Server Version Information Center for AIX
    SK4T-2665 	CICS Transaction Server Version Information Center for Linux
    SK4T-2666 	CICS Transaction Server Version Information Center for Windows
  3. Download the information center package.
  4. Extract the package and follow the instructions in the readme file to install the information center. Each package is compressed as a .zip file. The .zip file contains the correct compressed file format for Linux, AIX, and z/OS systems.

After you have installed the information center, follow the instructions provided in the information center for obtaining the latest updates.

To enable context-sensitive help for EXEC CICS statements, go where you installed the information center and initialize the information center by running IC_start.bat. To open the CICS Information Center, either run help_cd_start.bat, or run IC_start.bat and use a browser to link to http://127.0.0.1:9999/help/index.jsp.

Managing licenses

Licensing for the installed IBM software and customized packages is administered by using the Manage Licenses wizard in IBM Installation Manager. The Manage Licenses wizard displays license information and can be used to configure the licenses for each of the installed packages.

Trial licenses that are provided with some of the Rational products expire 30 or 60 days after installation. You must activate your product to use it after the expiration date. Using the Manage Licenses wizard, you can upgrade the trial versions of an offering to a licensed version by importing a product activation kit. You can also enable floating license enforcement for offerings with trial or permanent licenses to use floating license keys from a license server.

  • For more information on managing licenses for your Rational product, see the Rational licensing support page at http://www-306.ibm.com/software/rational/support/licensing/.

Authorized User License

An IBM Rational Authorized User license permits a single, specific individual to use a Rational software product. Purchasers must obtain an Authorized User license for each individual user who accesses the product in any manner. An Authorized User license cannot be reassigned unless the purchaser replaces the original assignee on a long-term or permanent basis.

For example, if you purchase one Authorized User license, you can assign that license to one specific individual, who can then use the Rational software product. The Authorized User license does not entitle a second person to use that product at any time, even if the licensed individual is not actively using it.

Floating license

An IBM Rational Floating license is a license for a single software product that can be shared among multiple team members; however, the total number of concurrent users cannot exceed the number of floating licenses that you purchase. For example, if you purchase one floating license for a Rational software product, any user in your organization can use the product at any given time. Another person who wants to access the product must wait until the current user logs off.

To use floating licenses, you must obtain floating license keys and install them on Rational License Server. The server responds to end-user requests for access to the license keys; it grants access to the number of concurrent users that matches the number of licenses the organization purchased.

Note: If you use floating licenses for Rational Developer for System z (including token licenses), before installing the product you must upgrade the license key server to Rational License Key Server, Version 8.1.2 or later. Rational License Key Server, Version 8.1.2 or later can be used with earlier versions of the product. For information about how to upgrade from Version 7.1 or an earlier Rational License Key Server to version 8.1.2 or later, see Migrating to Rational Common Licensing (http://publib.boulder.ibm.com/infocenter/rational/v0r0m0/index.jsp?topic=/com.ibm.rational.license.doc/topics/r_migration.html).

Token license

The token-based license model means that you can buy a certain number of token licenses. If you use a Rational tool that checks out a FEATURE that is token-based, the FEATURE line in the license file specifies the number of tokens that are checked out.

Token-based licenses can only be used with floating licenses. They cannot be used for authorized user license.

Note: If you use floating licenses for Rational Developer for System z (including token licenses), before installing the product you must upgrade the license key server to Rational License Key Server, Version 8.1.2 or later. Rational License Key Server, Version 8.1.2 or later can be used with earlier versions of the product. For information about how to upgrade from Version 7.1 or an earlier Rational License Key Server to Version 8.1.2 or later, see Migrating to Rational Common Licensing (http://publib.boulder.ibm.com/infocenter/rational/v0r0m0/index.jsp?topic=/com.ibm.rational.license.doc/topics/r_migration.html).

For more details about token licensing, contact your local IBM marketing representative.

License enablement

If you are installing a Rational software product for the first time or want to extend a license to continue using the product, you can enable the licensing for the product in two ways.

Licenses for Rational Software Development Platform offerings are enabled in the following two ways:
  • Importing a product activation kit
  • Enabling Rational Common Licensing to obtain access to floating license keys
Note: Trial licenses that are provided with some of the Rational products expire 30 or 60 days after installation. You must activate the product to use it after the expiration date.

Activation kits

Product activation kits contain permanent or term license keys for the trial Rational product. You purchase the activation kit, download the activation kit .zip file to a local computer, and then import the activation kit .jar file to enable the license for the product. Use IBM Installation Manager to import the activation kit to the product.

Floating license enforcement

Optionally, obtain floating license keys, install IBM Rational License Server, and enable Floating license enforcement for the product. Floating license enforcement provides the following benefits:
  • License compliance enforcement across the organization
  • Fewer license purchases
  • Serve license keys for IBM Rational Team Unifying and Software Development Platform desktop products from the same license server

For more information on obtaining activation kits and Floating licenses, see Purchasing licenses.

Viewing license information for installed packages

About this task

You can review license information for the installed packages, including license types and expiration dates, from IBM Installation Manager.

To view license information, do these steps:
  1. Start IBM Installation Manager.
  2. On the main page, click Manage Licenses.

The package vendor, current license types, and expiration dates are displayed for each installed package.

Importing a product activation kit

About this task

To install a permanent or term license key, import the activation kit from the download location or the product media by using IBM Installation Manager.

If you have not purchased an activation kit, you must do this first. If you have purchased a product or a product activation kit, insert the appropriate disc or download the activation kit from IBM Passport Advantage to an accessible workstation. The activation kit is packaged as a Java archive (.jar) file. The .jar file contains the permanent license key and must be imported to activate the product.

To import the activation kit .jar and enable the new license key, do these steps:
  1. Start IBM Installation Manager.
  2. On the main page, click Manage Licenses.
  3. Select a package and click the Import Activation Kit button.
  4. Click Next. Details for the selected package are shown, including the current license kind and the version range of the license.
  5. Browse to the path on the media disc or download location for the activation kit, select the appropriate Java archive (.jar) file, and click Open.
  6. Click Next. The Summary page displays the target install directory for the activation kit, the product the new license applies to, and version information.
  7. Click Finish.

The product activation kit with its permanent license key is imported to the product. The Manage Licenses wizard indicates whether the import operation was successful.

Enabling floating licenses

About this task

If your team environment supports floating license enforcement, you can enable floating licenses for the product and configure a connection to obtain access to floating license keys.

Before enabling the floating license enforcement, obtain the license server connection information from your administrator. For details on license server, license key, and Rational Common Licensing administration, see the IBM Rational License Management Guide.

To enable floating licenses as the license type for specified packages and configure license server connections:
  1. In the IBM Installation Manager for the Rational Software Development Platform, click File > Open > Manage Licenses.
  2. Select a version of a package and then click Configure Floating license support. Click Next.
  3. Click Enable Floating license enforcement.
  4. Configure one or more license server connections, as follows:
    1. Click an empty field in the Servers table or click Add.
    2. If your administrator provided you with information for a redundant server environment, click Redundant Server. Fields for the primary, secondary, and tertiary server names and ports are displayed.
    3. Enter the host name of the license server in the Name field.
    4. (Optional) Enter a value in the Port field for environments where a firewall is used. Do not assign a value to this port unless your administrator instructs you to do so.
    5. For redundant server environments, enter the names and ports (if required) for the secondary and tertiary servers.
    6. (Optional) To confirm that the connection information is correct and that the server is available, click Test Connection.
    7. Click OK.
  5. Click Next.
  6. (Optional) Configure the license usage order for the shell shared or custom packages. The order of licenses in the list determines the order in which the package attempts to obtain access to license keys for a given licensed package. Click Finish.

The Manage Licenses wizard indicates whether the floating licenses configuration is successful.

Now, when you next open the enabled product, a connection is created to the license server to obtain a license key from the pool of available floating license keys.

Purchasing licenses

About this task

You can purchase new licenses if the current product license is about to expire or if you want to acquire additional product licenses for team members.

To purchase licenses and enable the product, complete these steps:
  1. Determine the type of license you want to purchase.
  2. Go to ibm.com® or contact your IBM sales representative to purchase the product license. For details, visit the IBM Web page on How to buy software.
  3. Depending on the type of license you purchase, use the Proof of Entitlement you receive and enable your product by doing one of these steps:
    • If you purchase Authorized User licenses for the product, go to Passport Advantage and follow the instructions for downloading the product activation kit file. After you have downloaded the activation kit, import the product activation .jar file by using Installation Manager.
    • If you purchase Floating licenses for the product, click the link to the IBM Rational Licensing and Download site, log in (IBM registration is required), and select the link to connect to the IBM Rational License Key Center. Then, use your Proof of Entitlement to obtain floating license keys for the license server.

      Optionally, go to Passport Advantage to download the activation kit for your product. After importing the activation kit, you can optionally switch from a floating to a permanent license type if you use your PC offline for long periods.

To import the activation kit or enable floating license support for the product, use the Manage Licenses wizard in IBM Installation Manager.

Silently installing and configuring licenses

You can import product licenses and configure floating license support silently, just like you can install packages silently. You must generate a response file to be used by IBM Installation Manager to configure the licenses. For details on recording a response file and running silent installations, see Silent installation. When recording a response file, use the Manage Licenses panel to import an activation kit or configure floating license support before you exit Installation Manager. The necessary information for performing these tasks silently are written in the response file.

Increasing the number of file handles on Linux computers

For best product performance, increase the number of file handles to more than the default of 1024 handles.

Before you begin

Important: Before you work with a Rational product, increase the number of file handles. Most Rational products use more than the default limit of 1024 file handles for a process. A system administrator might need to make this change.

About this task

CAUTION:
Ensure that you complete the following steps correctly. If this procedure is not completed correctly, your computer will not start.

To increase the number of file handles on a Linux computer, complete these steps:

Procedure

  1. Log in as root. If you do not have root access, obtain it.
  2. Change to the etc directory.
    Attention: If you increase the number of file handles in the next step, do not leave an empty initscript file on the computer. If you do so, the computer will not start the next time that you restart it.
  3. Use the vi editor to edit the initscript file in the etc directory. If this file does not exist, type vi initscript to create it.
  4. On the first line, type ulimit -n 4096. The number chosen, 4096, is significantly larger than 1024, which is the default on most Linux computers.
    Important: Do not set the number of handles too high, because doing so can negatively impact system-wide performance.
  5. On the second line, type eval exec "$4".
  6. Make sure to complete steps 4 and 5, and then save and close the file.
  7. Optional: Restrict the number of handles that are available to users or groups by modifying the limits.conf file in the etc/security directory. If you do not have this file, consider using a smaller number in step 4 (for example, 2048) so that most users have a reasonably low limit on the number of open files that are allowed for each process. Doing this step is less important if you use a relatively low number in step 4. However, if you set a high number in step 4 and you do not establish limits in the limits.conf file, computer performance can be significantly reduced.
    The following sample limits.conf file restricts all of the users, and then sets different limits for others afterwards. This sample assumes that you set handles to 8192 in step 4.
    *      soft nofile 1024
    *      hard nofile 2048
    root    soft nofile 4096
    root    hard nofile 8192
    user1   soft nofile 2048
    user1 hard nofile 2048   

    The "*" in the example sets the limits for all of the users first. These limits are lower than the limits that follow. The root user has a higher number of allowable handles open, while the number available to user1 is between the two. Before making changes, make sure that you read and understand the documentation contained in the limits.conf file.

Additional configuration requirements for Linux operating systems

If you use a Linux operating system, ensure that your computer meets the requirements listed in this topic.

32-bit xulrunner package requirement on 64-bit systems

If you installed Developer for System z in a 32-bit package group on a Linux 64-bit system, you must install the 32-bit version of the xulrunner package. If the package is not installed, you might see the following error message when you run the product:

   org.eclipse.swt.SWTError: No more handles
	 [Unknown Mozilla path (MOZILLA_FIVE_HOME not set)]
The 32-bit xulrunner package can often be found and installed by using the package manager installed with the Linux distribution. (For example, you might use YUM on Red Hat Linux or YaST on SUSE Linux.) Alternatively, download the 32-bit xulrunner RPM from the update site for the Linux distribution, the 32-bit Linux distribution discs (if the discs are available), or another RPM package distribution source, and install it by using the rpm command. For example:
rpm -Uvh <xulrunner module name>

Environment variable might need to be set for Firefox or Mozilla browsers

You might need to set the environment variable MOZILLA_FIVE_HOME to the folder containing the Firefox or Mozilla installation. For example, setenv MOZILLA_FIVE_HOME /usr/lib/firefox-1.5.

If you do not set this environment variable, when you run the product you might see the following error message:
org.eclipse.swt.SWTError: No more handles 
   [Unknown Mozilla path (MOZILLA_FIVE_HOME not set)]

Firefox browsers must be dynamically linked

To support the SWT browser widget, the Firefox browser must be dynamically linked, which means that it should not be downloaded from mozilla.org but compiled from source. This is typically the case when the Firefox browser is provided as part of the distribution (that is, it is in a place such as /usr/lib/firefox).

One way to ensure that this is true is to see if it is the browser that is pointed at by /etc/gre.conf. The purpose of this gre.conf file is to point at an embeddable browser.

If the browser is not dynamically linked, you might see the following error message when you run the product:
org.eclipse.swt.SWTError: No more handles
   (java.lang.UnsatisfiedLinkError: 
   /home/n0002466/.eclipse/ibm.software.development.platform_7.0.0
   /configuration/org.eclipse.osgi/bundles/267/1/.cp/libswt-mozilla-gtk-3236.so
   (libxpcom.so: cannot open shared object file: No such file or directory))
    SUSE Linux might require a fix for invisible text problem.))

SUSE Linux might require a fix for invisible text problem

If the operating system is SUSE Linux Enterprise Desktop 10 SP1 or SUSE Linux Enterprise Server 10 SP1, you might need the following operating system update to resolve the problem of text not being displayed in some editors:
http://support.novell.com/techcenter/psdb/44ab155e3202595389c101e6cf7e20f2.html

Starting Developer for System z

About this task

You can start Developer for System z from the Windows desktop environment or the command-line interface, as follows:
  • To start IBM Rational Developer for System z from the Windows Start menu, click Start > All Programs > [package group name] > IBM Rational Developer for System z > IBM Rational Developer for System z.
  • To start IBM Rational Developer for System z on a Linux system, click the IBM Rational Developer for System z shortcut from the application shortcut menu in the desktop environment.
  • To start Developer for System z from a command line, type product installation directory\eclipse.exe .
  • To start Developer for System z from a command line, type product installation directory/eclipse.

Modifying installed packages

Before you begin

To modify an installation, you might need access to the original installation media and update media. For more information, see the Installation Manager help.
Note: Before modifying the installation, close all of the programs that were installed using Installation Manager.

About this task

The IBM Installation Manager Modify Packages can be used to change the content of the installed packages by adding or removing features. This facility is available only for those packages that have been installed by using the IBM Installation Manager.

Note: You cannot modify the Eclipse location or JVM.

Procedure

To modify an installed package, do these steps:

  1. From the main panel of Installation Manager, click the Modify Packages icon.
  2. On the Modify Packages panel, select the package group that contains the packages to modify. If you need help in determining what packages are installed, click Cancel, then click File > View Installed Packages. The package groups and packages that are installed on the system are displayed. When you are ready, click Modify Packages again, select the package group, and click Next.
  3. On the Languages panel, select or clear any languages to add or remove, and click Next.
  4. On the Features panel, the currently installed features are already selected. Select any additional features that are to be installed, or clear any of the installed features that are to be removed. When you have finished making your selections, click Next.
  5. On the Summary panel, review your choices before you begin modifying the installation. To change the choices you made on previous panels, click Back and make your changes. When you are satisfied with your choices, click Modify to make the specified changes. The modification process begins and a progress indicator shows you the percentage of the process completed.
  6. After the Complete page displays the results, see the complete installation log by clicking View Log File.

Updating installed packages

Before you begin

Before updating, close all of the programs that were installed using Installation Manager.

About this task

You can use IBM Installation Manager to install product updates and new features for any of the packages that were installed by Installation Manager.

By default, Internet access is required to install updates unless the repository preferences point to a local or network update repository to which the system has access. See the Installation Manager help for more information.

To find and install package updates, take the following steps:
  1. To install updates from a specific repository, for example a repository stored on an HTTP Web server in the intranet, you need to specify the repository location in the Installation Manager preferences before proceeding. To let Installation Manager search the internet for updates, you do not need to do this step.
    Note: If you specify repositories in the Installation Manager preferences, Installation Manager searches the internet for updates in addition to searching the repositories you specify. If you do not want Installation Manager to search for updates, go to File -> Preferences and deselect the Search service repositories during installation and updates checkbox at the bottom of the Repositories panel. This tells Installation Manager to search only the repositories specified in the preferences and not to search the internet.
  2. From the main panel of the Installation Manager, click Update.
  3. On the Update Packages panel, select the package group that contains the packages to modify. If you need help determining what packages are installed, click Cancel, then click File -> View Installed Packages. The page that is displayed shows you the package groups and packages that are installed on the system. To check for updates for all of the installed packages, select the Update All check box. Click Next to continue.
  4. Installation Manager searches for any available updates to the installed packages. The next panel displays a list of available updates that were found.
  5. By default, only the recommended updates are displayed. To see all of the updates for the package, click Show All. The updates are displayed with the required dependencies preselected.
  6. Select the updates to install and click Next.
  7. On the Licenses panel, read the license agreements for the selected updates. There is a license agreement for each update you selected to install. On the left side of the License panel, click each package name to display its license agreement.
    1. If you agree to the terms of all of the license agreements, click I accept the terms of the license agreements.
    2. Click Next to continue.
  8. On the Summary panel, review your choices before you begin installing the updates. To change the choices you made on previous panels, click Back and make your changes. When you are satisfied with your installation choices, click Update to install the update. The update installation begins and a progress indicator shows you the percentage of the installation completed.
  9. The Complete page is displayed with results.
  10. Click View Log File link to see the complete installation log.

Uninstalling Developer for System z

About this task

The Uninstall option in the Installation Manager can be used to uninstall packages that were previously installed using Installation Manager.

To uninstall the packages, you must log in to the system using the same user account that you used to install the packages.

To begin the uninstallation process, do one of these steps :
  • From the Windows Add or Remove Programs screen, select IBM Rational Developer for System z (package group name) and click Remove. The IBM Installation Manager is started.
  • From the Windows Start menu, click Start > All Programs > IBM Installation Manager > IBM Installation Manager.
    Note: If you did a non-administrator installation, click Start > All Programs > My IBM Installation Manager > My IBM Installation Manager.
To begin the uninstallation process, do these steps:
  1. Open a terminal window.
  2. Change to the Installation Manager install directory/eclipse directory. (Example: /opt/IBM/InstallationManager/eclipse)
  3. Run ./IBMIM.

Procedure

  1. Close all of the programs that you installed using Installation Manager.
  2. From the main panel of Installation Manager, click Uninstall.
  3. On the Uninstall Packages panel, select the packages to uninstall. Click Next.
  4. In the Packages page, select the packages to uninstall and click Next.
  5. On the Summary panel, review the packages you selected to uninstall. To make any changes, click Back. To begin the uninstallation process, click Uninstall.
  6. The Complete panel is displayed after the uninstallation finishes and shows the results. Click Done.

Migration

Migrating WebSphere Developer for zSeries or WebSphere Developer for System z workspaces

About this task

If you have a workspace that you used in WebSphere® Developer for zSeries® 6.0.1 or WebSphere Developer for System z 7.0, and you want to migrate the workspace for use with IBM Rational Developer for System z Version 9.0.1, follow these steps:
  1. Install IBM Rational Developer for System z Version 9.0.1.
  2. Start Rational Developer for System z, specifying the name of the workspace you are migrating. The old workspace is migrated automatically so that all of the old artifacts are present in the new workspace.
  3. The Rational Developer for System z Version 7 workspaces are migrated to Version 9.0.1.
Note: Developer for System z cannot be upgraded from Version 7, 8.0, or 8.5 to Version 9.0.1. Version 9.0.1 can coexist with all of the previous versions of Developer for System z in a different installation location.
Note: Developer for System z cannot migrate a Windows-based workspace into a Linux-based Developer for System z 9.0.1 workspace.

Installing additional software

Installing the required System z components

For instructions on installing the host code, see the installation configuration documentation in the related product directory:
  • RDz901_zOS_SMPE for z/OS systems
  • RDz901_RSE

Installing IBM TXSeries for Multiplatforms

About this task

IBM TXSeries for Multiplatforms provides a local CICS development platform so that you can develop CICS programs.

IBM TXSeries has its own set of installation documentation, which is available on the disc with the product.

To install IBM TXSeries for Multiplatforms:
  1. Insert the IBM Rational Developer for System z Installation disc, or open the RDz90_Setup directory of the electronic image.
  2. Start the launchpad program by running launchpad.exe.
  3. Click the Install optional software tab on the left of the launchpad window.
  4. Click Launch IBM TXSeries for Multiplatforms v7.1 installation.
  5. When prompted, insert the IBM TXSeries for Multiplatforms v7.1 installation CD, or specify the location that contains the electronic installation image.
  6. After the installation starts, follow the prompts on the screen to install.

Installing IBM Data Studio

About this task

IBM Data Studio has its own set of installation documentation, which is available on the disc with the product.

To install IBM Data Studio:
  1. Insert the IBM Rational Developer for System z Installation disc, or open the RDz90_Setup directory of the electronic image.
  2. Start the launchpad program by running launchpad.exe.
  3. Click the Install optional software tab on the left of the launchpad window.
  4. Click Launch IBM Data Studio installation.
  5. When prompted, insert the IBM Data Studio installation CD, or specify the location that contains the electronic installation image.
  6. After the installation starts, follow the prompts on the screen to install.

Installing the Rational Team Concert Integration for System z extension

The Rational Team Concert Integration for System z extension can be installed at the same time that you install Developer for System z if you do these steps:
  1. Start the installation by choosing either a guided or expert installation from the launchpad, as described in Installing Developer for System z by using the launchpad program.
  2. When Installation Manager starts, "Rational Team Concert - Client for Eclipse IDE" and the "Rational Team Concert Integration for System z extension" are listed on the Available Packages panel. Select the Rational Team Concert Integration for System z extension.
  3. If either Rational Developer for System z or Rational Team Concert - Client for Eclipse IDE is not selected, and you do not already have the one that is not selected installed, select that one.
    Note:
    • Rational Developer for System z ships with two versions of the Rational Team Concert client and Rational Team Concert Integration for System z. To show both the version 4.0.3 and version 4.0.5 installation options, select the "Show all versions" check box on the Install Packages panel.
    • You must have version 4.0.5 (or later) of Rational Team Concert Server installed in order to connect using the Rational Team Concert version 4.0.5 client.
  4. Click Next and follow the panels in the Install Packages wizard to install the extension.

Known problems and limitations

This section covers known problems and limitations with installation and uninstallation.

For information about product problems and limitations, see the rdz901_releasenotes.html file located in the Documents\nl\en\readme directory of the IBM Rational Developer for System z Installation disc.

IBM Packaging Utility

You can use the IBM Packaging Utility software to copy packages to a repository that can be placed on a Web server available over HTTP or HTTPS.

The Packaging Utility software is included on the IBM Rational Enterprise Deployment disc. To place a repository containing Developer for System z and other packages on a Web server available over HTTP, use the Packaging Utility to copy the packages into the repository.

You can use this utility to do these tasks:
  • Generate a new repository for packages.
  • Copy packages to a new repository. You can copy multiple packages into a single repository, thereby creating a common location in your enterprise from which products can be installed using IBM Installation Manager.
  • Delete packages from a repository.

For detailed instructions on installing and using IBM Packaging Utility, see the Installation Manager information center, at http://publib.boulder.ibm.com/infocenter/install/v1r7/index.jsp. The "Managing packages with Packaging Utility" topic at http://publib.boulder.ibm.com/infocenter/install/v1r7/topic/com.ibm.cic.auth.ui.doc/topics/c_modes_pu.html contains the most current information.

Documentation notices for IBM Rational Developer for System z

© Copyright IBM Corporation 2009, 2013.

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:

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:

Intellectual Property Licensing
Legal and Intellectual Property Law
IBM Japan, Ltd.
1623-14, Shimotsuruma, Yamato-shi
Kanagawa 242-8502 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 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 websites are provided for convenience only and do not in any manner serve as an endorsement of those websites. The materials at those websites are not part of the materials for this IBM product and use of those websites 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:

Intellectual Property Dept. for Rational Software
IBM Corporation
5 Technology Park Drive
Westford, MA  01886
U.S.A.

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

Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained in other operating environments may vary significantly. Some measurements may have been made on development-level systems and there is no guarantee that these measurements will be the same on generally available systems. Furthermore, some measurements may have been estimated through extrapolation. Actual results may vary. Users of this document should verify the applicable data for their specific environment.

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.

All statements regarding IBM's future direction or intent are subject to change or withdrawal without notice, and represent goals and objectives only.

This information is for planning purposes only. The information herein is subject to change before the products described become available.

This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental.

Copyright license

This information contains sample application programs in source language, which illustrate programming techniques on various operating platforms. You may copy, modify, and distribute these sample programs in any form without payment to IBM, for the purposes of developing, using, marketing or distributing application programs conforming to the application programming interface for the operating platform for which the sample programs are written. These examples have not been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these programs. The sample programs are provided "AS IS", without warranty of any kind. IBM shall not be liable for any damages arising out of your use of the sample programs.

Each copy or any portion of these sample programs or any derivative work, must include a copyright notice as follows:

© (your company name) (year). Portions of this code are derived from IBM Corp. Sample Programs. © Copyright IBM Corp. 2009, 2013.

If you are viewing this information in softcopy, the photographs and color illustrations may not appear.

Trademark acknowledgments

IBM, the IBM logo, and ibm.com are trademarks or registered trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the web at www.ibm.com/legal/copytrade.shtml.

Adobe, the Adobe logo, PostScript, and the PostScript logo are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States, and/or other countries.

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

Windows is a trademark of Microsoft Corporation in the United States, other countries, or both.

UNIX is a registered trademark of The Open Group in the United States and other countries.

Java and all Java-based trademarks and logos are trademarks or registered trademarks of Oracle and/or its affiliates.

Other product and service names might be trademarks of IBM or other companies.

Copyright license

This information contains sample application programs in source language, which illustrate programming techniques on various operating platforms. You may copy, modify, and distribute these sample programs in any form without payment to IBM, for the purposes of developing, using, marketing or distributing application programs conforming to the application programming interface for the operating platform for which the sample programs are written. These examples have not been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these programs. The sample programs are provided "AS IS", without warranty of any kind. IBM shall not be liable for any damages arising out of your use of the sample programs.

Trademark acknowledgments

IBM, the IBM logo, and ibm.com are trademarks or registered trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at www.ibm.com/legal/copytrade.shtml.

Rational are trademarks of International Business Machines Corporation and Rational Software Corporation, in the United States, other countries, or both.

Intel and Pentium are trademarks of Intel Corporation in the United States, or other countries, or both.

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

Java and all Java-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States and other countries.

UNIX is a registered trademark of The Open Group in the United States and other countries.