Find JSRs
Submit this Search

Ad Banner

JSRs: Java Specification Requests
JSR 285: Performance Management API

This JSR has been Dormant
Reason: The Executive Committee voted to list this JSR as dormant in June 2011.

Original Java Specification Request (JSR)

Identification | Request | Contributions | Additional Information

Section 1. Identification

Submitting Member: Motorola

Name of Contact Person: Dave Raymer

E-Mail Address:

Telephone Number: +1 817 245 6834

Fax Number: +1 817 245 8113

Specification Lead: Dave Raymer

E-Mail Address:

Telephone Number: +1 817 245 6834

Fax Number: +1 817 245 8113

Initial Expert Group Membership:


Supporting this JSR:

This JSR is supported by all the member companies of the OSS through Java Initiative. Please see the the current list of OSS/J member companies.

Section 2: Request

2.1 Please describe the proposed Specification:

The PM API specification is the network-facing API. The network-facing PM API will interface element managers, and/or system managers and/or or sub-network managers that provide performance information.

Within the APIs that have been defined by the OSS through Java Initiative, the performance management functionality is embedded within the OSS Quality of Service API. The PM JSR is the second of two JSRs (please see JSR 263) to separate the fault and performance management functionality from the OSS Quality of Service API. This JSR will provide for a standalone (without embedded FM functionality) performance measurement and thresholding API (Performance Management).

The specification that would be produced by this JSR would start by lifting the existing PM functionality for the OSS Quality of Service API, and then update that functionality based on requests received from the community since the first release of the OSS Quality of Service API as well as adding additional functionality to make the resulting API aligned with the 3GPP Release 6 Performance Management Reference Point (IRP) specifications. When (and if) existing operations within the PM interfaces from JSR 90 are identified as no longer being needed, such operations will be deprecated rather than removed.

2.2 What is the target Java platform? (i.e., desktop, server, personal, embedded, card, etc.)


The target Java platform is J2EE running in an OSS, NMS, or EMS. (Operations Support System, Network Management System and Element Management System respectively).

2.3 The Executive Committees would like to ensure JSR submitters think about how their proposed technology relates to all of the Java platform editions. Please provide details here for which platform editions are being targeted by this JSR, and how this JSR has considered the relationship with the other platform editions.

The target platform is Java 2 Platform, Enterprise Edition. The Performance Management API is developed consistently with JSR 144 and the other APIs developed by the OSS through Java Initiative and works smoothly with them.

This specification being requested by this JSR provides for performance management within an information/telecom communications network utilizing J2EE technology. There is no apparent overlap or impact on other platform editions.

2.4 Should this JSR be voted on by both Executive Committees?

The initiating companies do not believe that voting by both Executive Committees is required. A vote by the J2SE/J2EE EC is appropriate.

2.5 What need of the Java community will be addressed by the proposed specification?

Currently, if an OSS/NMS/EMS vendor wants to implement performance management functionality using the OSS/J APIs/Design Guidelines, they must implement some portion of the OSS Quality of Service alarm monitoring functionality in order to be OSS/J compliant/certified. This JSR will enable a vendor to only implement the functionality related to performance management and provide a more coherent component model for the OSS through Java API set. Current users/implementers of the existing JSR-90 OSS QoS API will be able to continue using the QoS API for as long as they wish. With the initiation of this JSR, those individuals or organizations using the QoS API will have a straight forward migration path to implement the newer FM and PM APIs, using their existing code bases. A complete rewrite will not be needed.

2.6 Why isn't this need met by existing specifications?

As noted above, the performance management functionality is currently embedded within the OSS Quality of Service API. For the developers of stand alone performance management applications, it will be more natural and straightforward to use only this JSR.

2.7 Please give a short description of the underlying technology or technologies:

The Performance Management API will be defined as a J2EE API that is compliant with the OSS through Java? Design Guidelines and implemented as an extension of the OSS Common API (JSR 144). The Key J2SE/J2EE platform APIs for the FM API will be the following:

  • CBE (Core Business Entities) Value object representing Events and Alarms will be modelled according to the CBE (included in JSR 144)
  • EJB (Enterprise JavaBeans): To facilitate the integration of OSS components, the expert group will define standard EJB interfaces.
  • JMS (Java Message Service): Besides the ability to execute synchronous (EJB) methods calls, there is also a need to send asynchronous messages. For this, JMS will be used.
  • JNDI (Java Naming and Directory Interface): The specification will include standards for JNDI names based on the CBE definitions
  • XML: There will be an XML over JMS binding for the API that enables clients to interact with an API implementation via the Java? Message Service
  • Web Services: There will be a Web Services binding for the API that enables web based applications to interact with an API implementation via Web Services.

2.8 Is there a proposed package name for the API Specification? (i.e., javapi.something, org.something, etc.)

The API will have one or several packages and the prefix for all packages will be "javax.oss". The remaining part of the package name will be defined according to a logical name for different parts of the API. Package names of all OSS JSRs will be coordinated to avoid ambiguous use.

The base package will be "javax.oss.performance".

2.9 Does the proposed specification have any dependencies on specific operating systems, CPUs, or I/O devices that you know of?

There are no known dependencies on specific devices, operating systems, etc within the specification.

2.10 Are there any security issues that cannot be addressed by the current security model?

The existing J2EE platform security model is sufficient for the proposed API and implementations of that API.

2.11 Are there any internationalization or localization issues?

There are no known internationalisation or localization issues within the API itself. The RI will provide a resource bundle for exception messages in the English language. The TCK will be delivered in English language only.

2.12 Are there any existing specifications that might be rendered obsolete, deprecated, or in need of revision as a result of this work?

Not directly; however the JSR 90: OSS Quality of Service API will be deprecated once the second related JSR (Performance Measurement and Thresholding) is completed. Even in light of the second API the existing OSS Quality of Service API can continue to be used.

2.13 Please describe the anticipated schedule for the development of this specification.

  • 2006-01 Expert Group Formation and Expansion
  • 2006-04 Early Draft Review
  • 2006-06 Public Review
  • 2006-09 Proposed Final Draft
  • 2006-12 Final Release

2.14 Please describe the anticipated working model for the Expert Group working on developing this specification.

In the past, OSS through Java Expert Groups have had membership from a geographically diverse set community members. In order to facilitate communications and minimize travel expenses for participants, the expert group will accomplish the vast majority of its work via conference calls and a dedicated mailing list.

The Expert Group will start work from the existing OSS Quality of Service API specification, the release 6 3GPP Performance Management IRP, the latest version of the OSS Common API (including the OSS CBE) and the OSS through Java Design Guidelines.

The Expert Group will work via consensus, and where consensus cannot be reached a formal vote via email will be taken with a simple majority needed to carry the vote.

The Performance Management project plan is accountable to OSS/J project plan, which is currently maintained by the OSS/J Product Team.

2.15 It is important to the success of the community and each JSR that the work of the Expert Group be handled in a manner which provides the community and the public with insight into the work the Expert Group is doing, and the decisions that the Expert Group has made. The Executive Committees would like to ensure Spec Leads understand the value of this transparency and ask that each JSR have an operating plan in place for how their JSR will address the involvement of the community and the public. Please provide your plan here, and refer to the Spec Lead Guide for a more detailed description and a set of example questions you may wish to answer in your plan.

Progress updates will be provided on the OSS/J main web site. The OSS/J leads have initiated efforts to provide more information to the public through projects on Performance Management will follow the policies and practices of the OSS/J Initiative.

In May 2004, the OSS/J technology has been formally endorsed by the TeleManagement Forum () has the first technology specific implementation of NGOSS standards. Some elements of the NGOSS standards are themselves referenced by the International Telecommunications Union (ITU) as de-jure ITU recommendations. The scope and progress of this JSR will therefore also be reported to the telecommunication industry through TMF, ITU and other standard bodies such as 3GPP, OMA, OMG. In addition the OSS/J Initiative reports progress of its work at various industry conferences and with its own public seminars, on line seminars and workshops. The progress of the API will be kept current on the JSR specific web page(s) provided by and hosted on the Java Community Process Website.

2.16 Please describe how the RI and TCK will de delivered, i.e. as part of a profile or platform edition, or stand-alone, or both. Include version information for the profile or platform in your answer.

The Performance Management RI and TCK will be delivered as stand alone packages, under the same licensing model and certification model as all other OSS/J APIs. If, by the time of release, a decision is made to include OSS/J APIs as part of the J2SE/J2EE platform, the RI and TCK may be delivered as part of the J2SE/J2EE platform edition, with the agreement of the OSS through Java TM membership and the expert group membership.

2.17 Please state the rationale if previous versions are available stand-alone and you are now proposing in 2.13 to only deliver RI and TCK as part of a profile or platform edition (See sections 1.1.5 and 1.1.6 of the JCP 2 document).

Not applicable.

2.18 Please provide a description of the business terms for the Specification, RI and TCK that will apply when this JSR is final.

The Performance Management API will be made available to the public under the same terms and conditions as all other OSS/J APIs, which is called the OSS/J Harmonized Licensing and Certification Model. The agreements for the Specifications, the Reference Implementations and the TCKs can be viewed by downloading any OSS/J API.

Section 3: Contributions

3.1 Please list any existing documents, specifications, or implementations that describe the technology. Please include links to the documents if they are publicly available.

3.2 Explanation of how these items might be used as a starting point for the work.

As explained above, this JSR intends to separate the performance management functionality from the JSR90: OSS QoS API into a standalone API therefore the existing QoS API specification will be used as the basis for the work. This JSR will also examine the 3GPP Release 6 Performance Management IRPs and make any necessary changes to ensure compatibility.

Section 4: Additional Information (Optional)

4.1 This section contains any additional information that the submitting Member wishes to include in the JSR.

At this time there is no additional information for this JSR proposal.