/*********************************************************************/ /* Licensed Materials - Property of IBM */ /* "Restricted Materials of IBM" */ /* 5748-T15 */ /* Copyright IBM Corp. 2016 */ /* 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. */ /*********************************************************************/ FFACT 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 INSTALLATION 3.0 CUSTOMIZATION 4.0 RUNNING THE DRIVER 5.0 NOTICES 5.1 Trademarks 1.0 PREREQUISITES __________________ The release levels are the following: maketpf/bldtpf tool for z/TPF 1.1 2.0 INSTALLATION _________________ 1) FTP the tar file (ffact.tar.gz) to your linux system. This can be placed in any directory as a holding location, for example: /tmp/ztpftar 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/ffact.tar.gz The driver source files will be extracted in the following directory structure: qfnl/FFACTReadme.txt qfnl/qfnl.cntl qfnl/qfnl.mak qfnl/qfnl.cpp ... 4) Create a maketpf.cfg file with the following contents: APPL_ROOT := /ztpfdrvs TPF_ROOT := /ztpf TPF_BSS_NAME := BSS #TPF_SS_NAME := WP #USER_VERSION_CODE := a) Set APPL_ROOT to the directory containing the driver source code extracted. b) Set TPF_ROOT to the directory containing the z/TPF source code. c) Set TPF_BSS_NAME to the basic subsystem name of your TPF system. By default, this is set to BSS. d) Optionally, set the TPF_SS_NAME to the subsystem name. e) 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 (qfnl.cntl) to assemble, compile, and link the driver programs: bldtpf /ztpfdrvs/qfnl/qfnl.cntl In addition, you should either copy or include the qfnl.cntl control file in your usr.cntl, and build a new IPAT: maketpf IPAT -f 6) Use the standard load procedure to transfer and load the following to the TPF system: QFNL.so IPAT.so See Program Management for more information about building and loading programs to the TPF system. 3.0 CUSTOMIZATION __________________ Update base/rt/cvzz.asm (or the tool that executes driver programs) to make an entry for this driver. The shared object QFNL is the main entry point for this driver. Build and load the updated CVZZ program to the TPF system. 4.0 RUNNING THE DRIVER _______________________ Please read the user's guide, available in Portable Document Format (PDF), provided along with this driver for more information about running the 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. (C) Copyright IBM Corporation 2016. All rights reserved.