z/TPF Enterprise Edition 1.1 Software Profiler Copyright International Business Machines Corporation, 2006. 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. ************ * CONTENTS * ************ This file includes the following information: 1.0 Description 2.0 Unpacking Instructions 2.1 New z/TPF Installation 2.2 Update Existing z/TPF Installation 3.0 Installation 4.0 Notices 4.1 Trademarks ******************* * 1.0 DESCRIPTION * ******************* The z/TPF Software Profiler is a performance measurement tool that collects and analyzes data to help you understand the performance characteristics of your z/TPF application and system software. This package contains source files for the z/TPF Enterprise Edition 1.1 Software Profiler. ****************************** * 2.0 Unpacking Instructions * ****************************** Before you begin to unpack and install z/TPF Software Profiler, ensure that you have met the following prerequisite: Obtain and unpack z/TPF Enterprise Edition V1.1 base (PUT00) version. You may also obtain and unpack any PUT level packages that are available for z/TPF. Keep in mind that PUTs must be applied in order. 2.1 New z/TPF Installation -------------------------- If this is your initial installation of z/TPF with Software Profiler, you must download the GA/PUT00 Software Profiler package. Installation instructions for z/TPF product recommend that you create a holding directory for the tar file on your Linux for zSeriesŪ file system, such as /tmp/ztpfpkg. The installation instructions for z/TPF product also recommend that you create a root directory on your Linux system to unpack the source tar files. This directory name can be /ztpfPUTnn, where "nn" is the PUT number you are installing. For example, use nn=00 if you are installing the base release of z/TPF. Use nn=01 for PUT01, and so on. Once the required directories on Linux are established, use File Transfer Protocol (ftp) in binary mode to copy the zTPF.SoftwareProfiler.PUT00.source.tar.gz file to the /tmp/ztpfpkg directory on Linux. Extract the contents of zTPF.SoftwareProfiler.PUT00.source.tar.gz by using the folowing commands on Linux: cd /ztpfPUTnn tar -xzf /tmp/ztpfpkg/zTPF.SoftwareProfiler.PUT00.source.tar.gz You can take two different approaches to apply PUT updates concurrently with this new z/TPF installation. The first approach is to apply all PUTs up to the most recent in one step. To do this, download the tar file associated with the "Software Profiler Cumulative Updates" link. The tar file is named zTPF.SoftwareProfiler.PUTall.source.tar.gz. It contains all changes to Software Profiler code from PUT 1 to the most recently released PUT. Use File Transfer Protocol (ftp) in binary mode to copy the zTPF.SoftwareProfiler.PUTall.source.tar.gz file to the /tmp/ztpfpkg directory on Linux. Unpack zTPF.SoftwareProfiler.PUTall.source.tar.gz to the same Linux file system as the PUT 00 code. This will overlay the PUT 00 version of each file with the most current version. Use the folowing commands on Linux: cd /ztpfPUTnn tar -xzf /tmp/ztpfpkg/zTPF.SoftwareProfiler.PUTall.source.tar.gz The second approach to apply PUT updates to this new z/TPF installation is to unpack one PUT tar file at a time. For example, if z/TPF has released 4 PUTs, but you want to install only PUT 1 and PUT 2, you must download the separate tar file for each PUT, store these tar files on your Linux file system in /tmp/ztpfpkg, and then unpack each tar file in PUT order to obtain the Software Profiler source code up to PUT 2. Unpacking non-sequential combinations of PUT tar files is not supported. 2.2 Update Existing z/TPF Installation -------------------------------------- Prior to installing Software Profiler updates to your system, you will have obtained and unpacked the specific z/TPF product PUT level package(s) that you want to install. Installation instructions for z/TPF product updates recommend that you create a holding directory for the PUT tar files on your Linux for zSeriesŪ file system, such as /tmp/ztpfpkg. The installation instructions for z/TPF product updates also recommend that you create a root directory on your Linux system to unpack the source tar files. This directory name can be /ztpfPUTnn, where "nn" is the PUT number you are installing. For example, use nn=01 if you are installing PUT01, nn=02 for PUT02, and so on. Given the existence of the Linux directories just described, you can take two different approaches to apply Software Profiler updates. The choice you make depends on what PUT level your current system is at, and what PUT level you wish to install. The first approach is to apply all updates up to the most recent PUT, regardless of the PUT level your system is at currently. To do this, download the tar file associated with the "Software Profiler Cumulative Updates" link. The tar file is named zTPF.SoftwareProfiler.PUTall.source.tar.gz. It contains all changes to Software Profiler code from PUT 1 to the most recently released PUT. Use File Transfer Protocol (ftp) in binary mode to copy the zTPF.SoftwareProfiler.PUTall.source.tar.gz file to the /tmp/ztpfpkg directory on Linux. Unpack zTPF.SoftwareProfiler.PUTall.source.tar.gz to the same Linux file system (/ztpfPUTnn) where z/TPF product updates were unpacked. Use the folowing commands on Linux: cd /ztpfPUTnn tar -xzf /tmp/ztpfpkg/zTPF.SoftwareProfiler.PUTall.source.tar.gz The second approach is to apply PUT updates up to a particular PUT level that is not the latest PUT level. To do this, you must unpack one PUT tar file at a time. For example, if z/TPF has released 4 PUTs, and your system is at PUT 1, and you only want to install PUT 2 and PUT 3, you must download the separate tar file for each PUT, store these tar files on your Linux file system in /tmp/ztpfpkg, and then unpack each tar file in PUT order to obtain the Software Profiler source code up to PUT 3. Unpacking non-sequential combinations of PUT tar files is not supported. ******************** * 3.0 Installation * ******************** For detailed installation instructions, see z/TPF System Generation. *************** * 4.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. 4.1 Trademarks -------------- The following terms are trademarks of International Business Machines Corporation in the United States, other countries, or both: IBM zSeries Linux is a trademark of Linus Torvalds in the United States, other countries, or both. Other company, product, or 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.