IBM Systems Group IBM Enterprise Workload Manager Virtualization

IBM Systems Group IBM Enterprise Workload Manager Virtualization V 2 R 1 Education: Serviceability Nicholas Amon September 2005 v 3. 04 © 2004 IBM Corporation This presentation is intended for the education of IBM and Business Partner sales personnel. It should not be distributed to customers.

IBM Systems Group Learning Objectives At the conclusion of this material, you should be able to: – Describe the functionality provided by the EWLM Arm Serviceability Adapter and how it is deployed. – Describe the JNI Trace and what information it provides. Template Version 3. 05 IBM Systems Group Field Skills & Education 2 © 2004 IBM Corporation

IBM Systems Group EWLM Arm Serviceability Adapter § Purpose – To capture and record ARM classification data. – To capture and record ARM transaction data. § Supported Platforms – – – Linux AIX Solaris HPUX OS 400 z/OS Template Version 3. 05 IBM Systems Group Field Skills & Education 3 © 2004 IBM Corporation

IBM Systems Group EWLM Arm Serviceability Adapter Cont. § Example Scenario – Customer has EJB installed on Web. Sphere that provides bank account services for a variety of users. – Customer would like to group all transactions involving this ejb with username beginning with the character ‘a’ into service class A and every other transaction in service class B. – The domain policy and service policy reflecting these goals are created, deployed, and activated. – From the EWLM Control Center the customer is seeing that there are no transactions being classified into service class A. Everything is being classified into service class B. – This problem is reported to IBM Service. – Where to start? The ARM Serviceability Adapter. Template Version 3. 05 IBM Systems Group Field Skills & Education 4 © 2004 IBM Corporation

IBM Systems Group Deploying the EWLM ARM Serviceability Adapter § Consists of a shared library and 2 executables. § The shared library containing the adapter code needs to be deployed to the /usr/lib folder of the system. § The executable, ewlmarmsrv is used to enable the arm serviceability logging. –. /ewlmarmsrv –on –f /tmp/armoutput. dat –l 4 § Applications which are being traced should be restarted. § Generate transactions for these applications. § Alert the serviceability adapter to flush all captured data to file on the next arm transaction by issuing the command, –. /ewlmarmsrv –fb § Generate one more transaction for each application being traced Template Version 3. 05 IBM Systems Group Field Skills & Education 5 © 2004 IBM Corporation

IBM Systems Group Deploying the EWLM ARM Serviceability Adapter Cont. § Disable the serviceability tracing with ewlmarmsrv command, –. /ewlmarmsrv –off § Convert the captured arm serviceability data contained in /tmp/armoutput. dat from binary format to text, by using the second command ewlmarmsrvconv –. /ewlmarmsrvconv /tmp/armoutput. dat /tmp/armoutput. txt § Text file contains the captured data in UTF-8 encoding. Template Version 3. 05 IBM Systems Group Field Skills & Education 6 © 2004 IBM Corporation

IBM Systems Group Generated Output from ARM Serviceability Adapter Template Version 3. 05 IBM

IBM Systems Group JNI Trace § Purpose – Records interactions between components of the EWLM Managed Server environment with the underlying operating system platform. § Externals – Outputted as a new trace table in the trace tables section of a diagnostic dump. – Enabled by default. Template Version 3. 05 IBM Systems Group Field Skills & Education 9 © 2004 IBM Corporation

IBM Systems Group JNI Trace Screenshot Template Version 3. 05 IBM Systems Group Field

IBM Systems Group JNI Trace In Serviceability Viewer Template Version 3. 05 IBM Systems

IBM Systems Group Notices Produced in the United States of America, 08/04, All Rights Reserved IBM, IBM e. Server logo, IBM logo, e-business on demand, DB 2 Connect, DB 2 Universal Database, Hiper. Sockets, Enterprise Storage Server, Performance Toolkit for VM, Tivoli, Total. Storage, VM/ESA, Web. Sphere, z/OS, z/VM and z. Series are trademarks or registered trademarks of International Business Machines Corporation in the United States, other countries or both. Java and all Java-based trademarks and logos are trademarks of Sun Microsystems, Inc. in the United States, other countries or both. UNIX is a registered trademark of The Open Group in the United States and other countries. Intel is a trademark of Intel Corporation in the United States, other countries or both. Linux is a trademark of Linus Torvalds in the United States, other countries, or both. Microsoft, Windows and Windows NT are registered trademarks of Microsoft Corporation Other company, product and service names may be trademarks or service marks of others. Template Version 3. 05 IBM Systems Group Field Skills & Education 12 © 2004 IBM Corporation

IBM Systems Group Notices – cont’d Information concerning non-IBM products was obtained from the suppliers of their products or their published announcements. Questions on the capabilities of the non-IBM products should be addressed with the suppliers. IBM hardware products are manufactured from new parts, or new and serviceable used parts. Regardless, our warranty terms apply. IBM may not offer the products, services or features discussed in this document in other countries, and the information may be subject to change without notice. Consult your local IBM business contact for information on the product or services available in your area. All statements regarding IBM’s future direction and intent are subject to change or withdrawal without notice, and represent goals and objectives only. Performance is in Internal Throughput Rate (ITR) ratio based on measurements and projections using standard IBM benchmarks in a controlled environment. The actual throughput that any user will experience will vary depending upon considerations such as the amount of multiprogramming in the user’s job stream, the I/O configuration, the storage configuration, and the workload processed. Therefore, no assurance can be given that an individual user will achieve throughput improvements equivalent to the performance ratios Template Version 3. 05 IBM Systems Group Field Skills & Education 13 © 2004 IBM Corporation