Readme for IBM Alternate Library for REXX on zSeries Version 1.4.0
for use with z/VM V5.2, or later.
 
(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 V5.2, or later.
 
1.2  Help contacts
 
If you encounter any problems when installing or using the
Alternate Library, use the IBM service center to raise a PMR
against RETAIN queue: RASS,148
Use program ID: 569501404
 
or visit our home page at:
http://www.ibm.com/software/awdtools/rexx
 
1.3  Unzip and upload
 
The REXX Alternate Library package is made available in 2 formats:
a ZIP file and a VMARC file. The contents are the same. Choose the
format that is more convenient to you. With a ZIP file, you unpack
the files on your local system, then send each file to the host.
With the VMARC file you send the VMARC file to the host, then
perform the unpack on the host system.
 
If you choose the ZIP file, unzip the ZIP file on your local
system. Upload the files to the z/VM host using FTP. A batch
script file ftpput.cmd will make the upload process easier.
Set the user ID and password accordingly and call the
following command: ftp -s:ftpput.cmd *hostname*
 
If you choose the VMARC file, upload the VMARC to the z/VM host
using FTP. It should be sent with Fixed records, lrecl 80. The
following is a sample of the upload process.
     ftp *hostname*
     *userid*
     *password*
     binary
     quote site fix 80
     put MAKEALTV.VMARC
     quit
Once the VMARC file has been sent to the host, you must unpack
it on the host. Use this command: VMARC UNPK MAKEALTV VMARC
 
 
 
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.)  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.
 
  (2.)  If you choose the ZIP file, perform these steps.
 
        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 Load Module
        o  Alternate Library activation exec
        o  Message repositories
        o  A REXX compiled exec and module which is used for
           the functional verification
 
        Upload the following files to the CMS minidisk:
           MAKEALTV README    - this readme
           EAGACTAL EXEC      - installation of the alternate lib
           EAGALPRC MODULE    - find compiler library module
           EAGRTALT MODULE    - rexx compiler alternate library
           EAGALUME REPAMENG  - CMS Message Repository
           EAGALUME TXTAMENG  - Message Repository
           VALTLIB  SEXEC     - source code for alt lib test
           VALTLIB  CEXEC     - compiled test for alt lib
           VALTLIB  TEXT      - object deck for alt lib test
           VALTLIB  REXXMOD   - alt lib test module
 
        A batch script file ftpput.cmd will make the upload
        process easier. Set the user ID and password accordingly
        and call the following command:
        ftp -s:ftpput.cmd *hostname*
 
  (3.)  If you choose the VMARC file, perform these steps.
 
        Upload the VMARC to the z/VM host using FTP. It should be
        sent with Fixed records, lrecl 80. The following is a
        sample of the upload process.
          ftp *hostname*
          *userid*
          *password*
          binary
          quote site fix 80
          put MAKEALTV.VMARC
          quit
 
        Unpack the VMARC file on the host using the following
        command: VMARC UNPK MAKEALTV VMARC
 
  (4.)  Read the header of EAGACTAL EXEC. 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
        for the System Product Interpreter, 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 5695-014, Library for REXX on zSeries. It is
designed for REXX developers who want to distribute REXX compiled
products. IBM grants you the right to package the Alternate
Library with your REXX compiled products. This allows customers
who do not own the REXX Library (5695-014) to run REXX compiled
code.
 
Note, however, that the REXX Runtime Library program product
(5695-014) 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.
 
