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 DCI specification define the UMA system:

• UMA Measurement Layer Interface (MLI) specification (see Part 2 of this specification).
  This defines the functional characteristics of the MLI, and the underlying semantics and function calls that implement them. It also defines a format for headers appended to measurement data captured through the DCI.

• 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 - provides a high level overview of the requirements

• Chapter 2, DCI Architectural Description - describes the overall architecture of the Data Capture Interface, presenting in tutorial style a general description of the problem being solved and the requirements for a solution

• Chapter 3, Overview of the DCI Specification - describes the metrics name space, metric attributes and data types, and a summary of the groups of routines decribed in the following chapters. In the case of any conflicts between the material presented in DCI Architectural Description or Overview of the DCI Specification the reader should consider Overview of the DCI Specification to be authoritative.

• Chapter 4, DCI Routines Overview - provides an overview of the DCI routines described in more detail in the subsequent chapter

• Chapter 5, Metrics Consumer Routines - describes the interfaces used by Metrics Consumers

• Chapter 6, Metrics Provider Routines - describes the interfaces used by Metrics Providers

• Chapter 7, Event Routines - describes the interfaces which handle events

• Appendix A, C Language Header Files - presents the <dci.h> header file.

Trademarks

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 (PMWG). The PMWG was originally part of UNIX International, and is now part of the Computer Measurement Group.

the Open Group 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 Data Capture Interface specification include:

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

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).

MLI

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

UMA

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

Footnotes

&#167;

Editor

&#167;&#167;

Past Editor