/*********************************************************************/ /* Licensed Materials - Property of IBM */ /* "Restricted Materials of IBM" */ /* 5748-T15 */ /* Copyright IBM Corp. 2005, 2012 */ /* All Rights Reserved */ /* US Government Users Restricted Rights - Use, duplication */ /* or disclosure restricted by GSA ADP Schedule Contract */ /* with IBM Corp. */ /*********************************************************************/ /* This driver is provided on an "as is" basis. There are no */ /* warranties, express or implied, including the implied warranties */ /* of merchantability and fitness for a particular purpose. */ /* IBM has no obligation to provide service, defect correction, or */ /* any maintenance for the driver. IBM has no obligation to supply */ /* any updates or enhancements for the driver to you even if such are*/ /* or later become available. */ /*********************************************************************/ POOL/POOL64 sample driver README Note to US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. CONTENTS __________ This file includes the following information: 1.0 PreRequisites 2.0 Installing POOL/POOL64 sample driver 3.0 Customizing POOL/POOL64 sample driver 4.0 Running POOL/POOL64 sample driver 5.0 NOTICES 5.1 Trademarks 1.0 PREREQUISITES POOL/POOL64 sample driver _____________________________________________ The release levels are the following: maketpf/bldtpf tool for z/TPF 1.1 2.0 INSTALLING ___________________________ 1) FTP the tar file (pool.tar.gz) to your linux system. This can be placed in any directory as a holding location, for example: /tmp/ztpftar pool.tar.gz 2) Create a root directory that will hold the unpacked files, for example: /ztpfdrvs 3) Extract the source code from the tar file by entering the following commands: cd /ztpfdrvs tar -xvzf /tmp/ztpftar/pool.tar.gz The driver source files will be extracted in the following directory structure: pool/Makefile pool/app_drvs.mak pool/pool.cntl pool/qdmc.asm pool/qdme.asm pool64/Makefile pool64/app_drvs.mak pool64/po64.cntl pool64/qdma.asm pool64/qdmb.asm 4) Create a maketpf.cfg file with the following contents: APPL_ROOT := /ztpfdrvs TPF_ROOT := /ztpfbeta TPF_BSS_NAME := BSS #TPF_SS_NAME := WP #USER_VERSION_CODE := 51 Set APPL_ROOT to the directory containing the driver source code extracted. Set TPF_ROOT to the directory containing the z/TPF source code. Set TPF_BSS_NAME to the basic subsystem name of your TPF system. By default, this is set to BSS. Optionally, set the TPF_SS_NAME to the subsystem name Optionally, set USER_VERSION_CODE to any desired two-character string for user version code for the shared objects built. By default, this is set to null. Refer to the maketpf tool documentation for details on these variables. 5) Run the maketpf tool with the accompanied control file (pool.cntl,po64.cntl) to assemble, compile, and link the driver programs: bldtpf /ztpfdrvs/pool/pool.cntl bldtpf /ztpfdrvs/pool64/po64.cntl 6) Use the standard load procedure to transfer and load the following driver programs to the TPF system: pool: QDMC.so, QDME.so pool64: QDMB.so, QDMA.so See Program Management for more information about building and loading programs to TPF system. 3.0 CUSTOMIZING POOL/POOL64 sample driver _____________________________________________ Update base/rt/cvzz.asm (or the tool that execute driver programs) to make an entry for this POOL/POOL64 driver. The entrance shared object for the POOL driver is QDMC. The entrance shared object for the POOL64 driver is QDMB. Build and load the updated CVZZ program to the TPF system. 4.0 RUNNING POOL/POOL64 sample driver _______________________________________ Please read the driver user guide, available in Portable Document Format (PDF), provided along with this driver for commands to run this driver. You can also issue ZTEST POOL HELP for online help display of the POOL driver. You can also issue ZTEST PO64 HELP for online help display of the POOL64 driver. 5.0 NOTICES ___________ IBM may not offer the products, services, or features discussed in this information 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 information. The furnishing of this information does not give 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 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 Corporation Department 830A Mail Drop P131 2455 South Road Poughkeepsie, NY 12601-5400 U.S.A. Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee. Any references in this information to non-IBM Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk. 5.1 TRADEMARKS _________________ The following terms are trademarks of the International Business Machines Corporation in the United States, or other countries, or both: IBM Other company, product, and service names may be trademarks or service marks of others. THIS DOCUMENT IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. IBM DISCLAIMS ALL WARRANTIES, WHETHER EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE AND MERCHANTABILITY WITH RESPECT TO THE INFORMATION IN THIS DOCUMENT. BY FURNISHING THIS DOCUMENT, IBM GRANTS NO LICENSES TO ANY PATENTS OR COPYRIGHTS. Copyright IBM Corporation 2012. All rights reserved.