IBM REXX Alternate Library Version 1.4.0 for z/OS Readme (c) Copyright International Business Machines Corporation, 1989, 2005. 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 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 * Visit our home page at: http://www.ibm.com/software/awdtools/rexx/rexxzseries/support/ * Support for this product is available by contacting IBM Technical Support. For customers entitled to technical support, U.S. customers may call 1-800-IBM-SERV (1-800-426-7378). For non-U.S. customers, contact the IBM Support Center in your country. Users may also contact the IBM Support Center electronically by visiting https://techsupport.services.ibm.com/ssr/login. Use program ID: 569501403, FMID: HWJ9140 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.) Download and unzip MAKEALTZ.ZIP in a temporary directory on a PC. It contains the following files: * JCL job REXX.MAKEALTZ.CNTL to build the load module and REXX compiled object file that is used for functional verification * This README file with the latest information * ftpput.cmd to aid in uploading files to host system. (2.) Edit the file "ftpput.cmd" which looks like this: uid password quote site LRECL=80 quote site RECFM=FB binary put MAKEALTZ.CNTL '#hlq.REXX.MAKEALTZ.CNTL' ascii put MAKEALTZ.README '#hlq.REXX.MAKEALTZ.README' quit Change "uid" and "password" to your FTP userid and password on the host system. Change "#hlq" to the high level qualifier. Save and close "ftpput.cmd". (3.) Open a DOS window and issue the following command: ftp -s:ftpput.cmd *hostname* where "*hostname" is the FTP name of your host system. To connect your PC to a host you have to know the fully qualified name of your host system, e.g. "system.domain.com". (4.) Upload (as text FB 80) the JCL job REXX.MAKEALTZ.CNTL. This is performed by steps 2 and 3. If you choose not to use FTP, then you must upload this dataset as fixed block 80 logical record length. (5.) Customize the JCL job REXX.MAKEALTZ.CNTL. You will need to add the appropriate job card for your work site. You must also change the proc statement which identifies the qualifiers for the intermediate object library and the final load library. Replace the <#hlq> with the appropriate high level qualifier. (6.) The JCL contains predefined steps to automate the installation and verification. It does the necessary steps to: (a.) Create the object library (b.) Assemble and link-edit steps to create the load library (c.) Create the REXX verification module VALTLIB. Submit and execute the JCL. (7.) The resulting load library contents after successful link-edit are: 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 (8.) 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 * ---------------------------------------------------- * (9.) When you are satisfied that the alternate load library has been successfully created and verified, then the object library dataset, the readme, and the JCL are no longer necessary. You may optionally delete them. 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 Runtime 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 GmbH Department 0790 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.