=========================================================================== * Utilization Reporting Tool * * Copyright IBM Corp. 2012 * IBM XL C for AIX, V12.1 (5765-J01; 5725-C71) * IBM XL C/C++ for AIX, V12.1 (5765-J02; 5725-C72) * IBM XL Fortran for AIX, V14.1 (5765-J04; 5725-C74) * Licensed Materials - Property of IBM * * US Government Users Restricted Rights - Use, duplication or * disclosure restricted by GSA ADP Schedule Contract with IBM Corp. * * AIX, IBM, the IBM logo, and ibm.com, are trademarks or registered * 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 in the Copyright and trademark information section * at www.ibm.com/legal/copytrade.shtml. * * Other company, product, or service names might be trademarks or service * marks of others. =========================================================================== This README file contains the latest information about the utilization reporting tool that is not available in the product documentation. By using the utilization reporting tool, you agree to the terms of the license as specified in the following files, which are located in the root directory of the distribution package: * LicenseAgreement.pdf * license.pdf You need a PDF viewer to view these files. This document contains the following sections: 1. Installation information 2. Enabling the utilization reporting tool manual pages 3. Known limitations 4. Documentation additions and corrections 5. Support information 6. Further updates 1. Installation information =========================== Operating system support ------------------------ The utilization reporting tool supports the same operating system levels as the following compilers that it is shipped with: * IBM XL C for AIX, V12.1 (5765-J01; 5725-C71) * IBM XL C/C++ for AIX, V12.1 (5765-J02; 5725-C72) * IBM XL Fortran for AIX, V14.1 (5765-J04; 5725-C74) Installing the utilization reporting tool ----------------------------------------- 1. Enter the directory that contains the tool and the associated filesets, which is the 'urt' sub-directory in the root directory of the CD-ROM or electronic download: cd urt/ 2. Run the installation command: installp -aXgd . all This command installs the utilization reporting tool and the minimum C++ runtime level required to run this tool (xlC.* version 9.0). Some of the message filesets (urt12.msg.* or xlC.msg.*) might fail to install because you have missing locale requisites (bos.loc.*). This is acceptable. The C++ runtime for AIX 6.1 or AIX 7.1 (xlC.aix61.rte) will fail to install if you are running AIX 5.3. Similarily, the C++ runtime for AIX 5.3 (xlC.aix50.rte) will fail to install if you are running AIX 6.1 or AIX 7.1. If you have a higher level of the C++ runtime filesets (xlC.*) installed, the C++ runtime filesets provided will fail to install with the following message: Already Installed ------------------ The following filesets that you selected are either already installed or installed through superseding filesets: * xlC.aix50.rte 12.1.0.0 # XL C/C++ Runtime for AIX 5.3 * xlC.rte 12.1.0.0 # XL C/C++ Runtime 3. To verify that the utilization reporting tool is installed correctly, run the following command: lslpp -l urt12 You can then see the following output: Fileset Level State Description ------------------------------- Path: /usr/lib/objrepos urt12 1.2.0.0 COMMITTED IBM utilization reporting tool for AIX Path: /etc/objrepos urt12 1.2.0.0 COMMITTED IBM utilization reporting tool for AIX 2. Enabling the utilization reporting tool manual pages ======================================================= Manual pages are provided for the utilization reporting tool. Before you can view the manual pages, you must add the manual page directory to the MANPATH environment variable by entering the following command line: export MANPATH=$MANPATH:/opt/ibmurt/1.2/man/LANG where LANG might be any one of the following language locales: * en_US * EN_US * ja_JP * JA_JP * Ja_JP * zh_CN * ZH_CN For example, to set the language of the manual pages to English, run this commands: MANPATH=$MANPATH:/opt/ibmurt/1.2/man/en_US export MANPATH Alternatively, to set the language of the manual pages to one of the other supported languages, run this command: MANPATH=$MANPATH:/opt/ibmurt/1.2/man/$LANG export MANPATH where $LANG is set to any of the language locales listed above. To test whether the manual pages have been successfully installed, run the following command: man urt 3. Known limitations for the utilization reporting tool ======================================================= Currently there are no known limitations. 4. Documentation additions and corrections ========================================== Documentation additions and corrections for this tool can be found in the README updates for XL C for AIX, V12.1, XL C/C++ for AIX, V12.1, and XL Fortran for AIX, V14.1. http://www.ibm.com/support/docview.wss?uid=swg21586147 http://www.ibm.com/support/docview.wss?uid=swg21586148 http://www.ibm.com/support/docview.wss?uid=swg21586154 5. Support information ====================== Support information for the utilization reporting too can be found at the support page of XL C for AIX, V12.1, XL C/C++ for AIX, V12.1, and XL Fortran for AIX, V14.1: http://www.ibm.com/software/awdtools/xlc/aix/support/ http://www.ibm.com/software/awdtools/xlcpp/aix/support/ http://www.ibm.com/software/awdtools/fortran/xlfortran/aix/support/ 6. Further updates ================== Additional information and documentation errata for all future utilization reporting tool updates can be found at the README updates for XL C for AIX, V12.1, XL C/C++ for AIX, V12.1, and XL Fortran for AIX, V14.1. http://www.ibm.com/support/docview.wss?uid=swg21586147 http://www.ibm.com/support/docview.wss?uid=swg21586148 http://www.ibm.com/support/docview.wss?uid=swg21586154