ECB Resource Monitor driver (ECBM) readme Copyright IBM Corporation 2005, 2017 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. Contents ________ This file includes the following information: 1.0 Introduction 2.0 Change history 3.0 Prerequisites 4.0 Installing ECBM 5.0 Customizing ECBM 6.0 Running ECBM 7.0 Notices 7.1 Trademarks 7.2 Warranty 7.3 Third Party License and Terms 1.0 Introduction _________________ 2.0 Change history ___________________ 2017Sep29 Initial version 3.0 Prerequistes _________________ APAR PJ42754 (Enhance ECB resource monitor to provide the ability to monitor groups of ECBs and to profile resource usage.) and co-requisite APAR PI44439 (Include z/TPFDF statistics in resource usage by owner name statistics) applied. For more information about APAR PJ42754, see the APEDIT (http://www.ibm.com/support/docview.wss?uid=swg1PJ42754). 4.0 Installing ECBM ____________________ 1) Use FTP to transfer the tar file (ecbm.tar.gz) to your Linux on z system. This file can be placed in any directory as a holding location. For example: /tmp 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 /tmp tar xzf ecbm.tar.gz -C /ztpfdrvs The sample application source files will be extracted in the following directory structure: ecbm/ecbm.cntl ecbm/qec1.c ecbm/qec1.mak ecbm/qec2.c ecbm/qec2.mak ecbm/qecb.c ecbm/qecb.mak 4) Create a maketpf.cfg 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 that contains the sample application source code that was extracted. b) Set TPF_ROOT to the directory that contains 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) Optional: Set the TPF_SS_NAME to the subsystem name. e) Optional: Set USER_VERSION_CODE to any desired two-character string for user version code for the shared objects built. By default, this value is set to null. For more information about these variables, enter man maketpf on your Linux on z build system. 5) Run the maketpf tool with the accompanied control file (ecbm.cntl) to compile and package the sample programs: bldtpf /ztpfdrvs/ecbm/ecbm.cntl 6) Use the standard E-type loader procedure to load the sample application files. 6.0 Running ECBM _________________ Refer to the ECBM user's guide, available in Portable Document Format (PDF), provided along with this driver for more information about running the driver. You can also issue ZTEST ECBM HELP for the online help display. 7.0 Notices ___________ This information was developed for products and services offered in the US. 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, MD-NC119 Armonk, NY 10504-1785 US For license inquiries regarding double-byte character set (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to: Intellectual Property Licensing Legal and Intellectual Property Law IBM Japan Ltd. 19-21, Nihonbashi-Hakozakicho, Chuo-ku Tokyo 103-8510, Japan 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 jurisdictions 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. Any references in this information to non-IBM websites are provided for convenience only and do not in any manner serve as an endorsement of those websites. The materials at those websites are not part of the materials for this IBM product and use of those websites is at your own risk. IBM may use or distribute any of the information you provide in any way it believes appropriate without incurring any obligation to you. 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 Director of Licensing IBM Corporation North Castle Drive, MD-NC119 Armonk, NY 10504-1785 US Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee. ***************************************************************************************** * NOTE TO AUTHOR: There are addtitional legal notices clauses that might be needed, based * on the content. Check with the TPF Lab editor to verify whether these other clauses * might be required for your readme file. ***************************************************************************************** 7.1 Trademarks IBM, the IBM logo, and ibm.com are trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at "Copyright and trademark information" at www.ibm.com/legal/copytrade.shtml. ***************************************************************************************** * NOTE TO AUTHOR: See the "Special attributions list" on the Copyright and trademark * information page (http://www.ibm.com/legal/us/en/copytrade.shtml#section-special). * If your information includes any of these non-IBM trademarks, include the appropriate * special attribution statement. Use a separate paragraph for each special non-IBM * company. In each attribution statement, list only the special non-IBM trademarks that * the information actually uses. For example, if this README contains a reference to * Microsoft, Windows and Linux, add the following special attribution statements: * Linux is a registered trademark of Linus Torvalds in the United States, other * countries, or both. * * Microsoft and Windows are trademarks of Microsoft Corporation in the United States, * other countries, or both. ***************************************************************************************** 7.2 Warranty This package 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 package. IBM has no obligation to supply any updates or enhancements for the package to you even if such are or later become available. 7.3 Third Party License and Terms ***************************************************************************************** * NOTE TO AUTHOR: If your tool or driver uses open source or other third party code, be * sure include any required license terms here. Work with legal as needed. If there are * no third party license terms required, just delete this section. *****************************************************************************************