Readme for IBM Alternate Library for REXX on zSeries Version 1.4.0
for use with z/OS
 
(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/OS(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/OS and/or TSO/E.
 
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/OS customers can also use the IBM service center to raise a PMR
against RETAIN queue: WTREXX,245
Use program ID: 569501403, FMID: HWJ9143
 
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 object files. You can access and run its
functions as soon as the package is properly integrated into your
z/OS and/or TSO/E 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  Object modules, all listed in step (3.)
        o  JCL job MAKEALT to build the load module
        o  A REXX compiled object file that is used for functional
           verification
        o  This README file with the latest information
 
  (2.)  Allocate the data set <uid>.REXX.ALTLIB.OBJ, for the
        object library with record format FB, record length 80
 
  (3.)  Upload the following object modules to the object library
        <#hlq>.REXX.ALTLIB.OBJ:
 
           EAGKCPT
           EAGKIINI
           EAGKIUNP
           EAGKRLIB
           EAGKRXIN
           EAGKRXLD
           EAGKRXTR
           EAGKXMMS
           EAGKXMSG
           VALTLIB
 
  (4.)  Upload the JCL job MAKEALT to one of your JCL data sets.
 
  (5.)  Customize the JCL job MAKEALT. It contains predefined
        steps to automate the installation and verification.
        It runs the required link-edit steps to create the load
        library <#hlq>.REXX.ALTLIB.LOAD and the REXX module
        VALTLIB.
 
        You must customize the PROC section as follows:
 
        (a.)  Specify the object data set that you have already
              allocated
        (b.)  Replace the first qualifier <#hlq> by the
              appropriate high-level qualifier
        (c.)  The JCL MAKEALT includes a job step to allocate
              the load library <#hlq>.REXX.ALTLIB.LOAD
        (d.)  If desired specify the load data set that you have
              already allocated, and comment or discard the
              entire job step ALLOLOAD
        (e.)  The load library <#hlq>.REXX.ALTLIB.LOAD has record
              format U, record length 0, block size 23200
        (f.)  When the load library is allocated once, you must
              activate job step DELLOAD or comment out job step
              ALLOLOAD, otherwise the job fails.
 
  (6.)  Contents of the load library after successful link-edit
 
           Name      I  Alias-of  I  Size
           ----------I------------I------------
           EAGKCPT                 00000058
           EAGRTALT                00005F80
           EAGRTPRC   EAGRTALT     00005F80
           EAGRTPRQ   EAGRTALT     00005F80
           EAGRTXIN   EAGRTALT     00005F80
           EAGRTXLD   EAGRTALT     00005F80
           EAGRTXTR   EAGRTALT     00005F80
           EAGRTXVH   EAGRTALT     00005F80
           IRXCMPTM   EAGKCPT      00000058
           VALTLIB                 000019C0
 
  (7.)  Verify the Job output listing for all return codes that
        are zero. The output of the verification REXX exec is
        listed at the bottom. It mainly contains the return values
        of the Parse Source and Parse Version statements.
        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:
 
      * ---------------------------------------------------- *
        REXX Source: TSO COMMAND ? ? ? ? MVS MVS ?
        SPI Version: REXX370 3.48 01 May 1992
 
        OK, I was executed by the Alternate Library
      * ---------------------------------------------------- *
 
 
 
3.0  USAGE CONSIDERATIONS
-------------------------
 
The Alternate Library is shipped together with the fee-charged
program product 569501403 for z/OS. 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
569501403 REXX Library can run REXX compiled code.
 
Note, however, that the Alternate Library has almost no benefits
compared to the "real" REXX 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/OS
 
Other company, product, and service names may be trademarks or
service marks of others.
 
 
