REadme for IBM Alternate Library for REXX on zSeries Version 1.4.0
for use with z/VM
 
(c) Copyright International Business Machines Corporation,
1989, 2003. All Rights Reserved.
Note to US Government Users Restricted Rights - Use, duplication
or disclosure restricted by GSA ADP Schedule Contract with IBM
Corp.
 
NOTE: Before using this information and the product it supports,
read the general information under "NOTICES" in this document.
 
DISCLAIMER:
===========
IBM LICENSES THE DOWNLOAD TO YOU ON AN "AS IS" BASIS, WITHOUT ANY
WARRANTIES (EXPRESS OR IMPLIED), INCLUDING BUT NOT LIMITED TO THE
IMPLIED  WARRANTIES OR CONDITIONS  OF  MERCHANTABILITY,  QUALITY,
PERFORMANCE OR FITNESS FOR ANY PARTICULAR PURPOSE.
 
CONTENTS
--------
 
1.0  ABOUT THIS README FILE
1.1  Who should read this readme file
1.2  Help contacts
1.3  Unzip and upload
 
2.0  INSTALLING THE ALTERNATE LIBRARY PACKAGE
 
3.0  USAGE CONSIDERATIONS
 
4.0  NOTICES
4.1  Copyright license
4.2  Trademarks
 
 
1.0  ABOUT THIS README FILE
---------------------------
 
This file contains the latest information about installing the
IBM(R) z/VM(R) REXX Alternate Library Version 1.4.0.
 
 
1.1  Who should read this readme file
 
Users who want to install the REXX Alternate Library
under z/VM.
 
1.2  Help contacts
 
If you encounter any problems when installing or using the
Alternate Library, send your comments to this e-mail
address:
REXXHELP@VNET.IBM.COM
 
or visit our home page at:
http://www.ibm.com/software/awdtools/rexx/zseries/index.html
 
z/VM customers can also use the IBM service center to raise a PMR
against RETAIN queue: WTREXX,245
Use program ID: 569501404
 
1.3  Unzip and upload
 
Unzip the zip file and then upload the files to the host
using the ftpput.cmd command file.
Set the user ID and password accordingly and call the
following command: ftp -s:ftpput.cmd *hostname*
 
 
2.0  INSTALLING THE ALTERNATE LIBRARY PACKAGE
---------------------------------------------
 
The REXX Alternate Library package is a loadable file that
contains multiple files. You can access and run its
functions as soon as the package is properly integrated into your
z/VM environment.
 
The following steps are required to install the Alternate Library:
 
  (1.)  Unpack the zipped file that contains the Alternate Library
        on a workstation. It contains the following files:
 
        o  This README file with the latest information
        o  Alternate Library and Loader Module
        o  Alternate Library activation exec
        o  Message repositories
        o  A REXX compiled exec and module which is used for
           the functional verification
 
  (2.)  Allocate or use a CMS minidisk of your choice, which will
        contain all files from the Alternate Library package.
        The minimum size for a 3380 DASD is 1 cylinder. It can
        be used for the package and for the files after the
        activation.
 
  (3.)  Upload the following files to the CMS minidisk:
           MAKEALT  README
           EAGACTAL EXEC
           EAGALPRC MODULE
           EAGRTALT MODULE
           EAGALUME REPAMENG
           EAGALUME TXTAMENG
           VALTLIB  SEXEC
           VALTLIB  CEXEC
           VALTLIB  TEXT
           VALTLIB  REXXMOD
 
  (4.)  Read the header of EXEC EAGACTAL. It includes additional
        information, such as:
          - Purpose of EAGACTAL
          - Who should use this exec
          - Notes about error messages
 
  (5.)  To start the installation and verification, invoke
        command EAGACTAL and follow the instructions as requested.
        You will be prompted to:
 
        (1.) Verify if a REXX Library exists already
        (2.) Specify the file mode of the SOURCE disk
        (3.) Specify the file mode of the TARGET disk
        (4.) Activate the Alternate Library
        (5.) Run the verification
 
  (6.)  Check the output of the Verification step. The CEXEC
        output and the MODULE output are both listed.
        The Alternate Library uses the System Product Interpreter.
        The REXX "Parse Version ..." statement returns REXX370,
        whereas the REXX Runtime Library Version is REXXC370.
 
        This is the expected output of the Verification step:
 
           -> Running the REXX compiled EXEC:
          * ---------------------------------------------------- *
            REXX Source: CMS COMMAND VALTLIB EXEC A1 VALTLIB CMS
            SPI Version: REXX370 4.02 01 Dec 1998
 
            OK, I was executed by the Alternate Library
          * ---------------------------------------------------- *
 
           -> Running the REXX compiled MODULE:
          * ---------------------------------------------------- *
            REXX Source: CMS COMMAND VALTLIB EXEC * VALTLIB CMS
            SPI Version: REXX370 4.02 01 Dec 1998
 
            OK, I was executed by the Alternate Library
          * ---------------------------------------------------- *
 
 
 
3.0  USAGE CONSIDERATIONS
-------------------------
 
The Alternate Library is shipped together with the fee-charged
program product 569501404 for z/VM. It is designed for REXX
developers who want to distribute REXX compiled products. IBM
grants you to package the Alternate Library to your REXX
compiled products. That is why customers who do not own the
569501404 REXX Library can run REXX compiled code.
 
Note, however, that the "real" REXX Runtime Library offers many
benefits compared to the REXX Alternate Library.
 
This package enables users to install the Alternate Library in
their system in a fast and easy way.
Vendors who distribute REXX compiled code may want to add this
package to their installation.
 
 
 
4.0  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 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:
 
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.
 
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 Deutschland
Informationssysteme GmbH
Department 3982
Pascalstrasse 100
70569 Stuttgart
Germany
 
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.
 
 
4.1 Copyright license:
 
This information contains sample application programs in source
language, which illustrates 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. 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
IBM's application programming interfaces.
 
 
4.2 Trademarks
 
The following terms are trademarks of the IBM Corporation in the
United States, other countries, or both:
 
IBM
z/VM
 
Other company, product, and service names may be trademarks or
service marks of others.
 
 
