



IBM Communications Server v6.2.0.1 for Linux on zSeries Client
INSTALLATION AND RELEASE NOTES
5724-I33, 5724-I34




* (c) Copyright International Business Machines Corp. 2003, 2004
* All Rights Reserved
* Licensed Material - Property of IBM
*
* US Government Users Restricted Rights - Use, duplication or
* disclosure restricted by GSA ADP Schedule Contract with IBM Corp.




Table of Contents
-----------------
1.  About this release
1.1  New in this release
1.2  Product fix history
1.3  Product compatibility
2.  Installation information
2.1  Hardware requirements
2.2  Software requirements
2.2.1  Linux operating system version
2.2.4  Java
2.3  Installation process
3.  Uninstallation information
4.  Known limitations and problems
5.  Documentation updates
6.  Notices and trademarks




1. About this release
---------------------

CS Linux on zSeries client provides a remote SNA API
for 31-bit and 64-bit zSeries Linux systems, allowing
it to connect to IBM CS Linux servers via TCP/IP.


1.1  New in this release
------------------------

This release includes enhancements for client applications
on Linux or Windows to use a TCP/IP network to access the
server functions.

This release includes support for the 64-bit zSeries Linux
distributions from RedHat and SuSE.


1.2  Product fix history
------------------------

Please check the web sites:
   http://www.ibm.com/software/network/commserver/z_lin
   http://www.ibm.com/software/network/commserver/support
for the latest information about this product.


1.3  Product compatibility
--------------------------

There are no known product compatibility issues with this release.


1.4  Viewing the Documentation
------------------------------

The CS Linux documentation is available on the
CD in the 'docs' subdirectory in PDF format.
The publication names and numbers map to the PDF
file names as shown below:

   Publication name                     Book number   PDF filename
   -----------------------------------  ------------  ------------
   Quick Beginnings                     GC31-6768-00  czx00100.pdf
   Quick Beginnings on zSeries          GC31-6769-00  czx00200.pdf
   Administration Command Reference     SC31-6770-00  czx00300.pdf
   Administration Guide                 SC31-6771-00  czx00400.pdf
   APPC Application Suite User's Guide  SC31-6772-00  czx00500.pdf
   APPC Programmer's Guide              SC31-6773-00  czx00600.pdf
   CPI-C Programmer's Guide             SC31-6774-00  czx00700.pdf
   CSV Programmer's Guide               SC31-6775-00  czx00800.pdf
   LUA Programmer's Guide               SC31-6776-00  czx00900.pdf
   MS Programmer's Guide                SC31-6777-00  czx01100.pdf
   NOF Programmer's Guide               SC31-6778-00  czx01200.pdf
   Diagnostics Guide                    GC31-6779-00  czx01300.pdf
   Glossary                             GC31-6780-00  czx01400.pdf

For Adobe Acrobat users on Windows, there is a zip file in the
docs subdirectory which contains the indices needed to enable
cross-manual searching.
To install this index:
   - copy the zip file to a Windows PC and un-zip it
   - from within Adobe Acrobat:
       Select Edit --> Search --> Select Indexes
       Within the index selection, add the CS Linux books.pdx file.
To perform a search:
   - Select Edit -->Search -->Query.
   - Select the index you want to search, in this case, CS Linux books.
   OR -- insert the term for which you want to search the library.
Search results will be across all the books in the library.


The CS Linux documentation is also available on the Internet at:

    http://www.ibm.com/software/network/commserver/library




2.  Installation information
----------------------------

The CS Linux on zSeries 6.2.0.1. Client is shipped as a compressed tar
file (tgz).  The tgz file contains the RPMS, install shell
scripts, and licensing tool.  You will need an FTP server or
other method of transfering files into the zSeries Linux system.


2.1  Hardware requirements
--------------------------

CS Linux on zSeries Client requires a 31 or 64-bit zSeries system
supported by one of the Linux distributions listed in section
2.2.1 Linux operating system version.

Use the 'uname -m' command to verify the CPU class.
It must report 's390' to indicate a 31-bit environment
or 's390x' to indicate a 64-bit environment.


2.2  Software requirements
--------------------------

2.2.1  Linux operating system version
-------------------------------------

This version of CS Linux has been tested with the following
Linux operating system versions.  It may also run satisfactorily
on other Linux distributions.

  RedHat Enterprise Linux 3 for S/390
  RedHat Enterprise Linux 3 for zSeries
  SuSE Linux Enterprise Server 8 for IBM Mainframe (SLES8)
  SuSE Linux Enterprise Server 9 for IBM Mainframe (SLES9)


For each operating system version you also need to have loaded
a set of optional RPMs.  Some of these RPMs come from the Linux
install media and some need to be downloaded (the URLs or FTP sites
for the download sites are described later).  Each of the RPMs
which you need to download are noted with "(download)".  For the
64-bit distributions, some 31-bit ('s390.rpm') packages are needed
in addition to the 64-bit ('s390x.rpm') packages.  These are
noted in the lists below.  Use the
"rpm -q -a" command to see what packages are currently installed.


  RedHat Enterprise Linux 3 for S/390
  -----------------------------------
    Required:
      binutils-2.14.90.0.4-26.s390
      XFree86-libs-4.3.0-35.EL.s390
      rpm-4.2.1-4.4      (from http://rhn.redhat.com/errata/RHEA-2004-010.html)
    Optional, needed for JavaCPI-C:
      IBMJava2-SDK-1.4.1-9.0.s390


  RedHat Enterprise Linux 3 for zSeries
  -------------------------------------
    Required:
      binutils-2.14.90.0.4-26.s390x
      XFree86-libs-4.3.0-35.EL.s390x
      XFree86-libs-4.3.0-35.EL.s390         (note 's390')
      glibc-2.3.2-95.3.s390x
      glibc-2.3.2-95.3.s390                 (note 's390')
      glib-1.2.10-11.1.s390x
      glib-1.2.10-11.1.s390                 (note 's390')
      rpm-4.2.1-4.4      (from http://rhn.redhat.com/errata/RHEA-2004-010.html)
    Optional, needed for JavaCPI-C:
      IBMJava2-SDK-1.4.1-9.0.s390


  SuSE Linux Enterprise Server 8 (31-bit)
  ---------------------------------------
    Required:
      binutils-2.12.90.0.15-33.s390
      xshared-4.2.0-97.s390
    Optional, needed for JavaCPI-C:
      IBMJava2-SDK-1.4.1-1.0.s390           (download)


  SuSE Linux Enterprise Server 8 (64-bit)
  ---------------------------------------------------------
    Required:
      binutils-2.12.90.0.15-33.s390x
      xshared-4.2.0-87.s390x
      addonlibs-32bit-8.1-9.s390            (note 's390')
      baselibs-32bit-8.1-9.s390             (note 's390')
      glibc-32bit-8.1-9.s390                (note 's390')
      s390-32-1.1-23.s390x
    Optional, needed for JavaCPI-C:
      IBMJava2-SDK-1.4.1-1.0.s390           (download)


  SuSE Linux Enterprise Server 9 (31-bit)
  ---------------------------------------
    Required:
      glibc-2.3.3-98.28.s390
      XFree86-libs-4.3.99.902-43.22.s390
    Optional, needed for JavaCPI-C:
      IBMJava2-SDK-1.4.2-1.0.s390           (download)


  SuSE Linux Enterprise Server 9 (64-bit)
  ---------------------------------------
    Required:
      glibc-2.3.3-98.28.s390x
      glibc-32bit-9-200407011411.s390       (note 's390')
      XFree86-libs-4.3.99.902-43.22.s390x
    Optional, needed for JavaCPI-C:
      IBMJava2-SDK-1.4.1-1.0.s390           (download)



2.2.4 Java
----------

A Java may be needed for CS Linux if you use the JavaCPI-C API.
The JavaCPI-C API supports a 31-bit Java only, but you can use
a 31-bit Java on a 64-bit zSeries Linux system.
Using the latest Java 1.4.2 SDK from the web site below satisfies
all the requirements.

    http://www.ibm.com/developerworks/java/jdk

For RedHat Enterprise Linux 3, use the IBMJava2-SDK-1.4.1-9.s390.rpm
from the Linux install media.

Install the Java SDK package with a command like:

    rpm -i IBMJava2-SDK-1.4.2-1.0.s390.rpm



2.3 Installation process
------------------------

If you have a previous level of CS Linux already installed, follow
the steps in section 3 to remove it before installing this new level.

To install this level of CS Linux follow these instructions.

-  Download the 6.2.0.1 Linux zSeries client PTF tgz package from:

       ftp://ps.software.ibm.com/ps/products/cslinux/fixes/v6201

   then uncompress and un-tar it:

       mkdir /tmp/ibmcs
       cd /tmp/ibmcs
       tar -xzf ibm-commserver-client-6.2.0.1.s390.tgz

-  Run the installibmcscli shell script

       ./installibmcscli

   The installibmcscli shell script will test for certain
   pre-requisites and issue warning messages if they are
   not met.  You will be prompted to read and accept the
   license agreement, then the installibmcscli tool will
   install the RPMs.

-  Add the CS Linux binary directories to your PATH.
   You may wish to change your profile to do this automatically.

       export PATH="$PATH:/opt/ibm/sna/bin"
       export LD_LIBRARY_PATH=/usr/lib:/opt/ibm/sna/lib
       export LD_RUN_PATH=/usr/lib:/opt/ibm/sna/lib

   For Java CPI-C applications you should
   also set the environment variable:

       export CLASSPATH=$CLASSPATH:/opt/ibm/sna/java/cpic.jar


-  Start CS Linux.  After installation this will
   happen automatically when the system is rebooted.

       cd /
       sna start


2.3.1 Post-install cleanup
--------------------------

   When you are done with the installs, the tgz file and
   temporary directory created in section 2.3 may be erased.




3. Uninstallation information
-----------------------------

The CS Linux packages can be removed with the following commands:

    /opt/ibm/sna/bin/sna stop
    rpm -e ibm-commserver-ptf
    rpm -e ibm-commserver-docs
    rpm -e ibm-commserver-ecl
    rpm -e ibm-commserver-cli
    rpm -e ibm-commserver
    /sbin/shutdown -r now

Not all of these packages will be installed on every system.

The CS Linux Client no longer requires Streams, so you can uninstall
the LiS package if no other applications require it.




4.  Known limitations and problems
----------------------------------

4.1 Number of concurrent LUA+APPC+CPI-C+NOF applications
--------------------------------------------------------

The maximum number of concurrent LUA+APPC+CPI-C+NOF applications
using the CS Linux Client is 240.

If this limit is reached, the following message will be logged
in /var/opt/ibm/sna/sna.err:
  hh:mm:ss TZ dd mmm yyyy 16392-13(33-0) E (hostname) PID pid# (application)
  Failed to allocate an IPC control block.




5.  Documentation updates
-------------------------

The CS Linux on zSeries Client no longer requires Streams, so
the references in Quick Beginnings on zSeries to Streams and
LiS do not apply to the Client.



6.  Notices and trademarks
--------------------------

6.1 Notices
-----------

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 give you any license to these patents.
You can send license inquiries, in writing, to:

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

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

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

The following paragraph does not apply to the United Kingdom or any
other country where such provisions are inconsistent with local law:
INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES
THIS PUBLICATION AS IS WITHOUT WARRANTY OF ANY KIND,
EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
THE IMPLIED WARRANTIES 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.

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:

IBM Corporation
P.O. Box 12195
3039 Cornwallis Road
Research Triangle Park, NC 27709-2195
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 information and all licensed
material available for it are provided by IBM under terms of the
IBM Customer Agreement, IBM International Program License Agreement,
or any equivalent agreement between us.


Trademarks
----------

The following terms are trademarks of the IBM Corporation
in the United States or other countries or both:

 ACF/VTAM
 Advanced Peer-to-Peer Networking
 Application System/400
 APPN
 AS/400
 eServer
 IBM
 S/390
 VTAM
 zSeries


The following terms are trademarks or registered trademarks of other
companies:

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

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

Intel is a trademark of Intel Corporation.

Linux is a trademark of Linus Torvalds.

RedHat and RPM are trademarks of Red Hat, Inc.

SuSE Linux is a trademark of SuSE Linux AG.

UnitedLinux is a trademark of UnitedLinux LLC.

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

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

