Systems Management: Application Response Measurement (ARM) API
Copyright © 1998 The Open Group


Open Group Technical Standard
Systems Management: Application Response Measurement (ARM) API
Document Number: C807
ISBN: 1-85912-211-6

©July 1998, 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.

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
Berkshire, RG1 1AX
United Kingdom
or by electronic mail to:


The Open Group

The Open Group is the leading vendor-neutral, international consortium for buyers and suppliers of technology. Its mission is to cause the development of a viable global information infrastructure that is ubiquitous, trusted, reliable, and as easy-to-use as the telephone. The essential functionality embedded in this infrastructure is what we term the IT DialTone. The Open Group creates an environment where all elements involved in technology development can cooperate to deliver less costly and more flexible IT solutions.

Formed in 1996 by the merger of the X/Open Company Ltd. (founded in 1984) and the Open Software Foundation (founded in 1988), The Open Group is supported by most of the world's largest user organizations, information systems vendors, and software suppliers. By combining the strengths of open systems specifications and a proven branding scheme with collaborative technology development and advanced research, The Open Group is well positioned to meet its new mission, as well as to assist user organizations, vendors, and suppliers in the development and implementation of products supporting the adoption and proliferation of systems which conform to standard specifications.

With more than 200 member companies, The Open Group helps the IT industry to advance technologically while managing the change caused by innovation. It does this by:

The Open Group operates in all phases of the open systems technology lifecycle including innovation, market adoption, product development, and proliferation. Presently, it focuses on seven strategic areas: open systems application platform development, architecture, distributed systems management, interoperability, distributed computing environment, security, and the information superhighway. The Open Group is also responsible for the management of the UNIX trademark on behalf of the industry.

Development of Product Standards

This process includes the identification of requirements for open systems and, now, the IT DialTone, development of Technical Standards (formerly CAE and Preliminary Specifications) through an industry consensus review and adoption procedure (in parallel with formal standards work), and the development of tests and conformance criteria.

This leads to the preparation of a Product Standard which is the name used for the documentation that records the conformance requirements (and other information) to which a vendor may register a product.

The "X" Device is used by vendors to demonstrate that their products conform to the relevant Product Standard. By use of the Open Brand they guarantee, through the Open Brand Trade Mark License Agreement (TMLA), to maintain their products in conformance with the Product Standard so that the product works, will continue to work, and that any problems will be fixed by the vendor.

Open Group Publications

The Open Group publishes a wide range of technical documentation, the main part of which is focused on development of Technical Standards and product documentation, but which also includes Guides, Snapshots, Technical Studies, Branding and Testing documentation, industry surveys, and business titles.

There are several types of specification:

In addition, The Open Group publishes:

Versions and Issues of Specifications

As with all live documents, Technical Standards and Specifications require revision to align with new developments and associated international standards. To distinguish between revised specifications which are fully backwards compatible and those which are not:


Readers should note that Corrigenda may apply to any publication. Corrigenda information is published on the World-Wide Web at

Ordering Information

Full catalogue and ordering information on all Open Group publications is available on the World-Wide Web at

This Document
This document is an Open Group Technical Standard. It defines the Application Response Measurement (ARM) API function calls which can be used to instrument an application or other software for transaction monitoring. The ARM API provides a way to monitor business transactions, by embedding simple calls in the software which can be captured by an agent supporting the ARM API. The calls are used to capture data that allows software to be monitored for availability, service levels, and capacity.

The API can be used by programmers who want to collect performance information by instrumenting the business logic of their applications or on other software in their domain. This approach may be used by customers who have access to the source code of the business logic on their systems in such a way that instrumentation is possible or by the use of non-invasive techniques that may supply some of the data without instrumention. Neither the collection or presentation mechanism of the ARM data returned from the API is covered in this standard.

Collection of ARM related data from the software components which surround the business logic is often very desirable, and may in many cases be possible by using ARM 2.0, but more work is needed in this area to encourage the software components to use the ARM API. This will take the form of the expansion of future versions of the ARM API, or definition of other mechanisms which can support these very diverse software environments.

It should further be noted that the applications (and other components) must normally be running within the reach of the enterprise management domain in order to allow for collection and presentation of performance data from agents, through some vendor specific mechanisms.

This Technical Standard is the formally adopted Open Group publication of the ARM API version 2.0 specification.

The Application Response Measurement (ARM) working group of the Computer Measurement Group (CMG) published its ARM version 1.0 API specification in June 1996. It then issued its ARM version 2.0 API specification in November 1997. Then, in March 1998, it submitted the ARM version 2 API to The Open Group, which approved it for publication as an Open Group Technical Standard.
Typographical Conventions
The following typographical conventions are used throughout this document:


Motif®, OSF/1®, UNIX®, and the "X Device"® are registered trademarks and IT DialToneTM; and The Open GroupTM; are trademarks of The Open Group in the U.S. and other countries.

Microsoft®, Microsoft Windows NT®, and Microsoft Windows 95® are U.S. registered trademarks of Microsoft Corporation.

RISC System/6000TM; is a trademark, and AIX® and OS/2® are registered trademarks, of International Business Machines Corporation.

Sun® and Solaris® are registered trademarks of Sun Microsystems, Inc.

Other third party logos and product/trade names are registered trademarks or trademarks of their respective companies.


This Technical Standard is the formally adopted Open Group publication of the ARM API version 2.0 specification.

The Open Group acknowledges the work of the ARM Working Group, under the sponsorship of the Computer Measurement Group (CMG), in developing the ARM version 2.0 API specification, which provides the technical source material for this Open Group Technical Standard. The following CMG ARM Working Group member companies assisted in the development of the ARM version 2.0 API:

System Management Database and Tools Application End Users
Vendors Vendors Vendors  
    Wells Fargo

Referenced Documents

Further information on performance measurement agents that use the data generated by the ARM API function calls, and additional information on ARM, such as White Papers and slides, is available via the World Wide Web. The pointer to this information can be found from the on-line version of this publication, which is available at:

On completion of the request to enter your identity, the table at the start of this on-line document shows the URL where further information may be found.

Why not acquire a nicely bound hard copy?
Click here to return to the publication details or order a copy of this publication.

Contents Next section Index