Frontmatter

©January 1997, The Open Group All rights reserved. No part of this publication may be reproduced, stored in a retrieval system, or transmitted, in any form or by any means, electronic, mechanical, photocopying, recording or otherwise, without the prior permission of the copyright owners.

Portions of this document are derived from a document produced by UNIX International which contained the following copyright notice:

Copyright © 1996, Computer Measurement Group
Permission to use, copy, modify, and distribute this documentation for any purpose and without fee is hereby granted, provided that the above copyright notice appears in all copies and that both that copyright notice and this permission notice appear in supporting documentation, and that the name Computer Measurement Group (CMG) not be used in advertising or publicity pertaining to distribution of the software without specific, written prior permission. CMG makes no representations about the suitability of this documentation for any purpose. It is provided "as is" without express or implied warranty.

Any comments relating to the material contained in this document may be submitted to The Open Group at:

The Open Group
Apex Plaza
Forbury Road
Reading
Berkshire, RG1 1AX
United Kingdom

OGSpecs@opengroup.org

Preface

This Document

There are two associated UMA specifications which, along with the MLI specification, define the UMA system:

• UMA Data Capture Interface (DCI) specification (see Part 3 of this specification).

  This is the interface between the data capture layer and the measurement control layer of the UMA architecture.

• UMA Data Pool Definitions (see Part 4 of this specification).

  The data pool defines a set of performance metrics which may be accessed by the two UMA interfaces.

The UMA Guide (see Part 1 of this specification). reviews the issues surrounding performance measurement in Open Systems, describes the general UMA architecture, and discusses user considerations in adopting the UMA.

Audience

Structure

• Chapter 1, Introduction - defines the objectives of this specification and defines terms and acronyms.

• Chapter 2, UMA Reference Model - defines the layers and interfaces of the UMA Reference Model.

• Chapter 3, UMA Sessions - describes the characteristics of UMA sessions, introduces MLI calls, and gives an overview of the messages used for communication between Measurement Application Programs (MAPs) and UMA.

• Chapter 4, Data Collection, Reporting, and Recording - introduces the concepts used by UMA in data collection and reporting to a MAP, and discusses the UMA Data Storage (UMADS) data recording facility.

• Chapter 5, MLI Application Programming Interface - defines the MLI calls used to manage UMA sessions, and to specify and access reported data.

• Chapter 6, UMA Message and Header Formats - defines control and data segments formats.

• Chapter 7, Distributed UMA - defines specifications that allow multiple UMA implementations to interoperate in a distributed environment.

• Chapter 8, The UMA Configuration Class - defines the messages that describe the parameters pertainin to a specific UMA implementation and data providers.

• Appendix A, C Language Header Files - presents the <mli.h> and <uma.h> header files.

• Appendix B, Future Directions - describes a generalized command interface for the MLI that is currently undergoing development.

Trade Marks

UNIX® is a registered trademark in the United States and other countries, licensed exclusively through X/Open Company Limited.

X/Open® is a registered trademark, and the "X" device is a trademark, of X/Open Company Limited.

Acknowledgements

This specification was developed by the Performance Management Working Group. The PMWG was originally part of UNIX International, and is now part of the Computer Measurement Group.

X/Open gratefully acknowledges the work of the PMWG in the development of this specification and in the review process for this publication.

Major contributors to the Measurement Layer Interface specification include:

Peter Benoit	Digital Equipment Corp.		Ansgar Erlenkoetter	Tandem Computers, Inc.
Paul Farr	Aim Technology		Lewis T. Flynn	Amdahl Corporation
Tony Gaseor	AT&T Bell Laboratories		Javad Habibi	Amdahl Corporation
Jim Richard	Amdahl Corporation		Leon Traister§	Amdahl Corporation
Neal Wyse	Sequent Computer Systems, Inc.		Seung Yoo	Amdahl Corporation

Participants who have made contributions to the process of developing these specifications are listed below along with their corporate affiliation at the time of their contribution. Our sincere apologies to anyone whom we may have missed.

Referenced Documents

ASN.1

ISO 8824:1990, Information Technology - Open Systems Interconnection - Specification of Abstract Syntax Notation One (ASN.1).

BER

ISO/IEC 8825:1990 (ITU-T Recommendation X.209 (1988)), Information Technology - Open Systems Interconnection - Specification of Basic Encoding Rules for Abstract Syntax Notation One (ASN.1).

DCI

CAE Specification, January 1997 - Systems Management: UMA Data Capture Interface, Part 3 of "Universal Measurement Architecture (UMA)" CAE Specification (ISBN 1-85912-117-9, C427).

DMI

ISO/IEC 10165-2:1992, Information Technology - Open Systems Interconnection - Structure of Management Information - Part 2: Definition of Management Information.

DPD

CAE Specification, January 1997 - Systems Management: UMA Data Pool Definitions, Part 4 of "Universal Measurement Architecture (UMA)" CAE Specification (ISBN 1-85912-117-9, C427).

GDMO

ISO/IEC 10165-4:1992, Information Technology - Open Systems Interconnection - Structure of Management Information - Part 4: Guidelines for the Definition of Managed Objects. of Managed Objects, July 1991.

GSS

X/Open CAE Specification, 1995, Generic Security Service API (GSS-API) Base (ISBN:1-85912-131-4).

NMF Strategy for Migration to GDMO

OSI/NM Forum Strategy for Migration to GDMO; Forum 010, Issue 1.0, January 1991.

SMF

ISO/IEC 10164:1992 Information Technology - Open Systems Interconnection - Systems Management (Parts 1 to 13 inclusive).

UMA

Guide, December 1994, Systems Management: Guide to the Universal Measurement Architecture (ISBN 1-85912-073-3, G414).

XMP

CAE Specification, March 1994, Systems Management: Management Protocol API (ISBN 1-85912-027-X, C306).

XOM, Issue 2

CAE Specification, February 1994, OSI-Abstract-Data Manipulation API (XOM), Issue 2 (ISBN: 1-85912-008-3, C315).

XSH, Issue 5

CAE Specification, January 1997, System Interfaces and Headers, Issue 5 (ISBN: 1-85912-181-0, C606).

Footnotes

&#167;

Editor