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.