



IBM Communications Server v6.2.0.1 for Linux on zSeries
INSTALLATION AND RELEASE NOTES
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
-----------------
0. Third-party license terms and conditions, notices, and information
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.2  Linux Streams (LiS) 2.16.18
2.2.3  OpenMOTIF
2.2.4  Java
2.2.5  SSL
2.3  Installation process
2.3.1  Installing the 6.2.0.0 base
2.3.2  Updating to the 6.2.0.1 PTF
2.3.3  Post-install cleanup
3.  Uninstallation information
4.  Known limitations and problems
5.  Documentation updates
6.  Notices and trademarks




0. Third-party license terms and conditions, notices, and information
---------------------------------------------------------------------

The relevant terms and conditions, notices and other information
are provided in the "LICENSE.TXT" file in the 'drivers' subdirectory
within the ibm-commserver-6.2.0.0-s390.tgz file on the installation
media for this product.  Please note that any non-English version
of the information in this file is unofficial and is provided
to you for your convenience only.  The English version of the
file is the official version.




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

CS Linux on zSeries provides SNA connectivity for 31-bit and
64-bit zSeries Linux systems, allowing it to connect to IBM
z/OS Communications Server and other SNA implementations that
support Enterprise Extender, 802.2, and MPC connections.


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.

This release includes support for MPC connections via the
Linux CTC device driver.

For PTF 6.2.0.1, the TN3270E Server nows supports reporting the 
IP address information of client connections to the Host system
when the session initializes. See Technote(FAQ) "IP client resource
visibility for TN3270E Server LUs" at:

    http://www.ibm.com/support/docview.wss?uid=swg21192649 


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

This release contains all the fixes for the CS Linux on zSeries v6.0.1.0 PRPQ.

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

If you are using EE (HPR/IP) connections to z/OS v1r5,
you should have the fix for
z/OS APAR OA06668 applied to the z/OS system.


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 base 6.2.0.0 CS Linux on zSeries product is shipped as a CD-ROM containing
a README file, the PDF documentation, and 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.

The 6.2.0.1 CS Linux on zSeries PTF is shipped as a compressed
tar file (tgz).  The tgz contains the RPMS and this README file.

This file has details for the server component of CS Linux.
If you are installing one of the client components of CS Linux
see the appropriate README file in the ibm-commserver-clients
subdirectories on the install media.



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

CS Linux on zSeries 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.

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


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:
      kernel-2.4.21-4.EL.s390
      kernel-source-2.4.21-4.EL.s390
      glibc-kernheaders-2.4-8.34.s390
      gcc-3.2.3-20.s390
      make-3.79.1-17.s390
      binutils-2.14.90.0.4-26.s390
      patch-2.5.4-16.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 xsnaadmin:
      XFree86-4.3.0-35.EL.s390
      openmotif-2.2.16.s390
    Optional, needed for SSL:
      compat-libstdc++-7.2-2.95.3.77.s390
    Optional, needed for JavaCPI-C:
      IBMJava2-SDK-1.4.1-9.0.s390


  RedHat Enterprise Linux 3 for S/390 Quality Update 1 (QU1)
  http://rhn.redhat.com/errata/RHSA-2004-017.html
  ----------------------------------------------------------
    Same as 'RedHat Enterprise Linux 3 for S/390', plus:
      kernel-2.4.21-9.EL.s390               (download)
      kernel-source-2.4.21-9.EL.s390        (download)


  RedHat Enterprise Linux 3 for S/390 Quality Update 3 (QU3)
  http://rhn.redhat.com/errata/RHBA-2004-443.html
  ----------------------------------------------------------
    Same as 'RedHat Enterprise Linux 3 for S/390', plus:
      kernel-2.4.21-20.EL.s390              (download)
      kernel-source-2.4.21-20.EL.s390       (download)


  RedHat Enterprise Linux 3 for zSeries
  -------------------------------------
    See the TechNote at:
      http://www-306.ibm.com/software/network/commserver/z_lin/support/
    for the details of what kernel level is required.  The kernels
    through at least the 2.4.21-15 update need a patch applied.

    Required:
      kernel-2.4.21-?.EL.s390x
      kernel-source-2.4.21-?.EL.s390x
      glibc-kernheaders-2.4-8.34.s390x
      gcc-3.2.3-20.s390x
      make-3.79.1-17.s390x
      binutils-2.14.90.0.4-26.s390x
      patch-2.5.4-16.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')
      glibc-devel-2.3.2-95.3.s390x
      glibc-devel-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 xsnaadmin:
      XFree86-4.3.0-35.EL.s390x
      openmotif-2.2.16.s390x
      rpm with a 31-bit libMrm.so.3
    Optional, needed for SSL:
      compat-libstdc++-7.2-2.95.3.77.s390   (note 's390')
      libstdc++-3.2.3-20.s390               (note 's390')
    Optional, needed for JavaCPI-C:
      IBMJava2-SDK-1.4.1-9.0.s390


  RedHat Enterprise Linux 3 for zSeries Quality Update 3 (QU3)
  http://rhn.redhat.com/errata/RHSA-2004-443.html
  ----------------------------------------------------------
    Same as 'RedHat Enterprise Linux 3 for zSeries', plus:
      kernel-2.4.21-20.EL.s390x             (download)
      kernel-source-2.4.21-20.EL.s390x      (download)


  SuSE Linux Enterprise Server 8 (31-bit)
  ---------------------------------------
    Required:
      k_deflt-2.4.19-32.s390
      kernel-source-2.4.19.SuSE-33.s390
      glibc-devel-2.2.5-87.s390
      gcc-3.2-34.s390
      make-3.79.1-205.s390
      binutils-2.12.90.0.15-33.s390
      patch-2.5.4-126.s390
      xshared-4.2.0-97.s390
    Optional, needed for xsnaadmin:
      xf86-4.2.0-97.s390
      openmotif-2.2.2-71.s390
    Optional, needed for SSL:
      compat-2002.8.15-20.s390
    Optional, needed for JavaCPI-C:
      IBMJava2-SDK-1.4.1-1.0.s390           (download)


  SLES 8 (31-bit) with Service Pack 2
  -------------------------------------------------------
    Same as 'SLES 8 31-bit', plus:
      k_deflt-2.4.19-70.s390                (download)
      kernel-source-2.4.19-70.s390          (download)


  SLES 8 (31-bit) with Service Pack 3
  -------------------------------------------------------
    Same as 'SLES 8 31-bit', plus:
      k_deflt-2.4.21-83.s390                (download)
      kernel-source-2.4.21-83.s390          (download)


  SLES 8 (31-bit) with Jan 2004 update
  --------------------------------------------------------
    Same as 'SLES 8 31-bit', plus:
      k_deflt-2.4.21-94.s390                (download)
      kernel-source-2.4.21-94.s390          (download)


  SLES 8 (31-bit) with Service Pack 4
  -------------------------------------------------------
    Same as 'SLES 8 31-bit', plus:
      k_deflt-2.4.21-261.s390               (download)
      kernel-source-2.4.21-261.s390         (download)


  SuSE Linux Enterprise Server 8 (64-bit)
  ---------------------------------------------------------
    Required:
      k_deflt-2.4.19-34.s390x
      kernel-source-2.4.19.SuSE-34.s390x
      glibc-devel-2.2.5-79.s390x
      gcc-3.2-32.s390x
      make-3.79.1-208.s390x
      binutils-2.12.90.0.15-33.s390x
      patch-2.5.4-94.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')
      glibc-devel-32bit-8.1-9.s390          (note 's390')
      s390-32-1.1-23.s390x
    Optional, needed for xsnaadmin:
      xf86-4.2.0-87.s390x
      openmotif-2.2.2-52.s390x
    Optional, needed for SSL:
      compat-2002.8.15-22.s390x
    Optional, needed for JavaCPI-C:
      IBMJava2-SDK-1.4.1-1.0.s390           (download)


  SLES 8 (64-bit) with Service Pack 2
  -------------------------------------------------------
    Same as 'SLES 8 64-bit', plus:
      k_deflt-2.4.19-71.s390x               (download)
      kernel-source-2.4.19-71.s390x         (download)


  SLES 8 (64-bit) with Service Pack 3
  -------------------------------------------------------
    Same as 'SLES 8 64-bit', plus:
      k_deflt-2.4.21-75.s390x               (download)
      kernel-source-2.4.21-75.s390x         (download)


  SLES 8 (64-bit) with Jan 2004 update
  --------------------------------------------------------
    Same as 'SLES 8 64-bit', plus:
      k_deflt-2.4.21-95.s390x               (download)
      kernel-source-2.4.21-95.s390x         (download)


  SLES 8 (64-bit) with Service Pack 4
  -------------------------------------------------------
    Same as 'SLES 8 64-bit', plus:
      k_deflt-2.4.21-261.s390x              (download)
      kernel-source-2.4.21-261.s390x        (download)



2.2.2 Linux Streams (LiS) 2.16.18 (plus patch)
----------------------------------------------

CS Linux uses the LiS streams implementation
provided by the "LiS" open source project.
The 2.16.18 level is required plus a CS Linux v6.2 specific patch.
The 2.16.18 level should be used even if there are later
levels available, unless IBM support indicates otherwise.


If you already have a previous level of LiS installed,
or you are about to apply the patch shipped with CS Linux 6.2.0.0
or are about to change the kernel you are running,
LiS should be completely uninstalled by doing:

    unset LD_PRELOAD
    PATH=$PATH:/sbin
    cd /usr/src/LiS
    make uninstall
    make very-clean
    cd
    rm -rf /usr/src/LiS /usr/src/LiS-2.16
    /sbin/shutdown -r now


If you are running SLES 8,
either the base level or SP2 (Service Pack 2),
you should run the following commands to make sure the
kernel source is consistent with the running kernel.

    cp -p /boot/kernel/.config \
      /usr/src/linux-2.4.19.SuSE/.config
    cp -p /boot/kernel/version.h \
      /usr/src/linux-2.4.19.SuSE/include/linux/version.h
    cp -p /boot/kernel/autoconf.h \
      /usr/src/linux-2.4.19.SuSE/include/linux/autoconf.h
    mv /usr/src/linux-2.4.19.SuSE/.kversion \
      /usr/src/linux-2.4.19.SuSE/.kversion.save


If you are running SLES 8 SP3 (Service Pack 3) or January 2004 update or later
you should run the following commands to make sure the
kernel source is consistent with the running kernel.

  cd /usr/src/linux-2.4.21-XX
    where 2.4.21-XX matches the k_deft and kernel-source RPMs
  make clean
  make mrproper
  make cloneconfig
  make dep


The LiS package can be obtained from the following URL:

    ftp://ftp.gcom.com/pub/linux/src/LiS/LiS-2.16.18.tgz

The LiS-2.16.18-CS62.patch file is on the CS Linux on zSeries CD.
Now copy the LiS-2.16.18.tgz and LiS-2.16.18-CS62.patch files
to the /usr/src directory on your Linux system.
Make sure to use binary mode if you FTP the tgz file.


Execute the following commands to unpack LiS:

    cd /usr/src
    tar -xzf LiS-2.16.18.tgz


Apply the patch by running the commands:

    cd /usr/src/LiS-2.16
    patch -g0 -p1 < ../LiS-2.16.18-CS62.patch


Execute the following commands to build LiS:

    PATH=$PATH:/sbin
    cd /usr/src/LiS-2.16
    make
      select the default answer to all the questions.
    make install
    insmod streams


See http://www.gcom.com/LiS/index.html for more information on LiS.



2.2.3 OpenMOTIF
---------------

The CS Linux administration GUI ('xsnaadmin') uses the
MOTIF implementation from the Open group at the 2.2 level.
This is not required for the command-line administration tool ('snaadmin').

For RedHat Enterprise Linux 3 for S/390
or a SLES 8 distribution
use the openmotif-2.2.2 RPM which ships on the Linux install media.

For RedHat Enterprise Linux 3 for zSeries use the
openmotif-2.2.3-3.RHEL3.s390.rpm which ships as part of
RHEL3-QU3 (Quality Update 3).

If you are using the QU3 or later release of RedHat Enterprise Linux 3,
you may see the following message during installation:
  Open Motif 2.2.2 is not installed (see README for details)
  CS Linux will install, but you will not be able to run xsnaadmin
This message can be ignored and xsnaadmin will still run.



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.1 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.1-1.0.s390.rpm



2.2.5 SSL
---------

If you plan on using SSL with the CS Linux TN3270 server,
you will first need to install the optional RPMs:

  RedHat Enterprise Linux 3 for S/390
  -----------------------------------
    compat-libstdc++-7.2-2.95.3.77

  RedHat Enterprise Linux 3 for zSeries
  -------------------------------------
    compat-libstdc++-7.2-2.95.3.77                                            ?

  SLES 8 (31-bit)
  ----------------------------------
    compat-2002.8.15-20.s390

  SLES 8 (64-bit)
  ----------------------------------
    compat-2002.8.15-20.s390                                                  ?


If the prerequisite RPMs are already installed when CS Linux is
installed, then the gskit RPM (gsk6bas-6.0-5.39.s390.rpm) will be
automatically installed at that time.  In addition, necessary
updates to the Java configuration and file locations are made.

If the prerequisite RPMs are not installed when CS Linux is
installed and at a later time you wish to install the gskit
toolkit and co-requisite updates, follow these instructions.

-  Follow the steps in section 2.3.1 to unpack the tgz file
   and then run the installgskit shell script.

     ./installgskit

The key manager function of gskit requires a customized
Java 1.4.1 JRE, which is shipped as part of the CS Linux on zSeries RPM.
To invoke the key manager, just type:

    snakeyman



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

2.3.1 Installing the 6.2.0.0 base
---------------------------------

If you already have CS Linux v6.2.0.0 installed, proceed to section 2.3.2.

The 6.2.0.0 level must be installed before the 6.2.0.1 PTF.

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.

-  Copy or FTP the ibm-commserver-6.2.0.0-s390.tgz file
   from the CD-ROM to the Linux zSeries system.
   Make sure to use binary mode for the tgz file.

-  Log into the Linux zSeries system as root.

-  Uncompress and unpack the tar file
   into an empty temporary directory:

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

-  Run the installibmcs shell script

       ./installibmcs

   The installibmcs 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.  You will then prompted for the name
   of the server that will be the master server in the CS Linux
   domain.  If you want to run CS Linux as a standalone node,
   do not specify this parameter.  Once the prompts have
   been answered the installibmcs tool will install the RPMs.

   You can convert the node from standalone to being in a domain
   and visa-versa at a later time using the snanetutil command.

-  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:/opt/ibm/sna/bin/X11"
       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

   For some applications you may also need to set the LD_PRELOAD
   environment variable, but you should not make this a global change:

       export LD_PRELOAD=/usr/lib/libpLiS.so


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

       cd /
       sna start

   For systems with limited memory a reboot may be required.
   For larger systems this may not be needed.  If the CS Linux node
   fails to start, check the /var/log/messages file for an entry like:
      kernel: SNA Trace Driver can only get X blocks of memory - please reboot
   If these messages persist even after rebooting you need more memory
   or you need to reduce the number of kernel modules.

-  Run the CS Linux MOTIF administration tool. We strongly
   recommend you use the Motif administration program until
   you are familiar with CS Linux operation.  Simply follow
   the instructions you are given.

   You will need to use a remote XWindows server, as Linux on zSeries only
   contains XWindows client capability.  On the XWindows server, run:

       xhost +XX

   where XX is the TCP/IP name or address of the Linux on zSeries system.

   Now tell the xsnaadmin client where the server is and start it up:

       export DISPLAY=YY:Z
       xsnaadmin &

   where YY is the TCP/IP name or address of the XWindows server
   and Z is the virtual display number (typically '0').


2.3.2 Updating to the 6.2.0.1 PTF
---------------------------------

The 6.2.0.0 level must be installed before the 6.2.0.1 PTF.
See section 2.3.1 for instruction on installing the 6.2.0.0 base release.

-  Download the 6.2.0.1 zSeries server 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-6.2.0.1.s390.tgz

-  Install the 6.2.0.1 RPM with the command:

       rpm -Uhv ibm-commserver-6.2.0.1-1.s390.rpm

    or

       rpm -Uhv ibm-commserver-6.2.0.1-1.s390x.rpm

    depending on whether you are running a 31bit or 64bit Linux.

-  Restart CS Linux with the commands:

       cd /
       sna start


2.3.3 Post-install cleanup
--------------------------

   When you are done with the installs, the tgz file and
   temporary directory created in sections 2.3.1 and 2.3.2 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.


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

4.1 Connectivity Options
------------------------

4.1.1 Enterprise Extender
-------------------------

CS Linux can be used over TCP/IP interfaces using Enterprise Extender.
These TCP/IP interfaces include:

    HiperSockets (hsiX)
    OSA-2 Ethernet, lcs mode only (ethX)
    OSA-2 Tokenring, lcs mode only (trX)
    OSA-Express Fast Ethernet, qdio or lcs (ethX)
    OSA-Express Token Ring, qdio or lcs (trX)
    OSA-Express GigE, qdio mode only (ethX)


4.1.2 802.2 connections
-----------------------

CS Linux can be used over 802.2 connections using the
Linux 'lcs' device driver.  These 802.2 interfaces include:

    OSA-2 Ethernet (ethX)
    OSA-2 Token Ring (trX)
    OSA-Express Token Ring, lcs mode only (trX)
    OSA-Express Fast Ethernet, lcs mode only (ethX)

OSA-2 adapters must be configured for tcp/ip non-shared mode
for 802.2 connections.

To use OSA-Express with 802.2 you need to have the MCL released
in March 2004 or later applied.
In OSA/SF you define the OSA-Express adapter with a 'TCP/IP address'
of 0.0.0.X where X is the SAP value to be used by CS Linux.
The OSA-Express is not configured in 'sna' mode, that is only
when the adapter is used by VTAM.  See the TechNote at:
    http://www-306.ibm.com/software/network/commserver/z_lin/support/
for the details on configuring 802.2 and OSA-Express.


If you want to use an adapter for CS Linux but not for TCP/IP,
you have to manually tell Linux to load the device driver and
enable the adapter.  For RedHat this is done by having an
entry in the /etc/modules.conf file for that adapter and modifying
the appropriate /etc/sysconfig/network-scripts/ifcfg-* file to
look something like this:

    DEVICE=eth1
    ONBOOT=yes
    BOOTPROTO=none

For SuSE this is done by having an entry in the
/etc/modules.conf file for that adapter and modifying
the appropriate /etc/sysconfig/network/ifcfg-* file to
look something like this:

    DEVICE=eth1
    BOOTPROTO="none"
    STARTMODE="onboot"


4.1.3 MPC connections
---------------------

CS Linux can be used over MPC connections using the
Linux 'ctcmpc' device driver.  These MPC connections
can be to VM/VTAM, VSE/VTAM, MVS/VTAM or CS/390 and
the ctcmpc driver can use virtual CTCs under VM or
real channels between processors.  Please see the
README file that is included with the ctcmpc driver
for details on how to install and configure that driver.



4.2 TN3270 Server
-----------------

The CS Linux TNServer is limited to a certain number
of open files/sockets.  The actual limit
depends on how much memory the Linux system has available.
Use the 'cat /proc/sys/fs/file-max' command to see
what the current limit is.  For any value of file-max
you must have:

    ( (#_of_ReDir_clients * 2) + #_of_TN3270_clients ) < file-max

This limit can be increased by following the instructions in:
    /usr/src/linux*/Documentation/filesystems/proc.txt
in the section titled "file-nr and file-max".

If the customer hits this limit they will see this in /var/opt/ibm/sna/sna.err:
  hh:mm:ss TZ dd mmm yyyy 4102-6(0-1) E (hostname) PID pid# (snatnsrvr_mt)
  O/S accept call failed with error code 23.
  hh:mm:ss TZ dd mmm yyyy 4102-8(1-1) E (hostname) PID pid# (snatnsrvr_mt)
  Failed to initialize TN3270 or TN Redirector Client due to serious error.


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

There is an O/S limit that prevents more than 255 open Streams
(i.e. applications) on CS Linux at once.  CS Linux itself uses
some of these streams internally.  That means the total number
of concurrent LUA+APPC+CPI-C+NOF applications must be less than
about 230.  A single application can have multiple SNA sessions
open and that only counts as 1 open stream.

If the customer hits this limit they will see this in /var/opt/ibm/sna/sna.err:
  hh:mm:ss TZ dd mmm yyyy 16388-10(1-0) E (hostname) PID pid# (application)
  Error opening Stream to SNA kernel subsystem.
  Errno = 28 (No space left on device)
  hh:mm:ss TZ dd mmm yyyy 16385-6(1-10) E (hostname)
  SNA Kernel open error 28.




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

CS Linux comes with the common set of applications from
the APPC Application Suite:
    aping
    acopy, aftp, aftpd
    atell, atelld
    aname, anamed
    arexec, arexecd

The invokable TP definitions for these applications
are in /etc/opt/ibm/sna/asuite.tps.  These can be activated
with the command:

    /opt/ibm/sna/bin/snatpinstall -a /etc/opt/ibm/sna/asuite.tps


CS Linux also comes with a few sample source code
programs in /opt/ibm/sna/samples which you can compile.
Examples of the configuration, compile and run steps are below.
More details are in the appropriate "Programmer's Guide"
for each API.



- "asample"
   snaadmin define_mode, mode_name=LOCMODE
   snaadmin define_local_lu, lu_alias=TPLU1, lu_name=TPLU1
   snaadmin define_local_lu, lu_alias=TPLU2, lu_name=TPLU2
   cd /opt/ibm/sna/samples
   gcc -o asample2 -I /opt/ibm/sna/include \
      -L /opt/ibm/sna/lib -lappc -lsna -lcsv -lpLiS asample2.c
   gcc -o asample1 -I /opt/ibm/sna/include \
      -L /opt/ibm/sna/lib -lappc -lsna -lcsv -lpLiS asample1.c
   ./asample2 &
   ./asample1 /etc/hosts



- "csample"
   snaadmin define_mode, mode_name=LOCMODE
   snaadmin define_local_lu, lu_alias=TPLU1, lu_name=TPLU1
   snaadmin define_local_lu, lu_alias=TPLU2, lu_name=TPLU2
   snaadmin define_cpic_side_info, sym_dest_name=CPICTEST, \
      lu_alias=TPLU1, partner_lu_name=TPLU2, tp_name=TPNAME2, \
      mode_name=LOCMODE
   snaadmin define_tp, tp_name=TPNAME2
   snaadmin define_tp_load_info, tp_name=TPNAME2, userid=root, \
     path=/opt/ibm/sna/samples/csample2, type=QUEUED, \
     env=APPCTPN=TPNAME2, env=APPCLLU=TPLU2, \
     env=LD_LIBRARY_PATH=/usr/lib:/opt/ibm/sna/lib|LD_RUN_PATH=/usr/lib:/opt/ibm/sna/lib
   cd /opt/ibm/sna/samples
   gcc -o csample2 -I /opt/ibm/sna/include \
      -L /opt/ibm/sna/lib -lcpic -lappc -lsna -lcsv -lnof -lpLiS csample2.c
   gcc -o csample1 -I /opt/ibm/sna/include \
      -L /opt/ibm/sna/lib -lcpic -lappc -lsna -lcsv -lnof -lpLiS csample1.c
   chmod ugo+s csample2
   export APPCLLU=TPLU1
   export APPCTPN=TPNAME1
   ./csample1 /etc/hosts
   unset APPCLLU
   unset APPCTPN



- "lsample"
   snaadmin define_*_dlc, ...
   snaadmin define_*_port, ...
   snaadmin define_*_ls, ...
   snaadmin define_internal_pu, ...
   snaadmin define_lu_0_to_3, ...
   cd /opt/ibm/sna/samples
   gcc -o lsample -I /opt/ibm/sna/include \
      -L /opt/ibm/sna/lib -llua -lsna -lcsv -lpLiS lsample.c
   export SNATBLG=/opt/ibm/sna/samples/luatblg.dat
   ./lsample LUNAME



- "JPing"
   rpm -q -a | grep Java
      make sure the Java SDK is installed
   snaadmin define_node, ...
   snaadmin define_cpic_side_info, sym_dest_name=SIDE, ...
   PATH=/opt/IBMJava2-s390-141/jre/bin:/opt/IBMJava2-s390-141/bin:$PATH
   export LD_LIBRARY_PATH=/usr/lib:/opt/ibm/sna/lib
   export CLASSPATH=$CLASSPATH:/opt/ibm/sna/java/cpic.jar
   export LD_PRELOAD=/usr/lib/libpLiS.so
   cd /opt/ibm/sna/samples
   javac JPing.java
   java JPing SIDE
   unset LD_PRELOAD




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.

