SBLIM CIM Client - 1.3.3 - Public API Specification
The SBLIM CIM Client is a class library that provides access to CIM servers
using the CIM Operations over HTTP protocol defined by the DMTF.
The SBLIM CIM Client is a class library that provides access to CIM servers
using the CIM Operations over HTTP protocol defined by the DMTF.
The package contains an IETF RFC 2614 compliant SLP client for CIM service discovery.
Backward Compatibility
Run Time Requirements
Build Time Requirements
Getting Started
Related Documentation on the web
SBLIM Development Process Documentation
Documentation Conventions
Terminology
Backward Compatibility
The public API of the CIM&SLP Clients (see the tables above)
will be downward compatible across minor version changes (i.e. when the second
version number changes). There is no downward compatibility guarantee for the
internal implementation packages for any version change.
Run Time Requirements
- SUN/IBM JRE 1.4.x/1.5.x or GCJ 4.1
Build Time Requirements
- SUN/IBM JDK 1.4.x/1.5.x or GCJ 4.1
- javadoc 1.4.2 or higher
- ant 1.6.2 or higher
Getting Started
Related Documentation on the web
- DMTF DSP0004:2005, CIM Infrastructure Specification, version 2.3 (final), available at:
http://www.dmtf.org/standards/published_documents/DSP0004V2.3_final.pdf - DMTF DSP0200:2005, CIM Operations over HTTP, version 1.2 (preliminary), available at:
http://www.dmtf.org/standards/published_documents/DSP200.pdf - DMTF DSP0201:2005, Representation of CIM in XML, version 2.2 (preliminary), available at:
http://www.dmtf.org/standards/published_documents/DSP201.pdf - IETF RFC 2614, An API for Service Location, available at:
http://tools.ietf.org/html/rfc2614 - IETF RFC 2608, Service Location Protocol, Version 2, available at:
http://tools.ietf.org/html/rfc2608 - IETF RFC 2609, Service Templates and Service: Schemes, available at:
http://tools.ietf.org/html/rfc2609 - IETF RFC 3224, Vendor Extensions for Service Location Protocol, Version 2, available at:
http://tools.ietf.org/html/rfc3224
SBLIM Development Process Documentation
see
here
Documentation Conventions
- This documentation only describes public entities in the Java classes.
- It provides an API specification, not a comprehensive progamming
guide.
- It is written from a perspective of the consumer of the API. For example,
the phrase "must" is used to indicate an obligation of the consumer, not of the
implementor of the CIM Client class library, or the CIM server/provider.
- If preconditions stated in method descriptions are not satisfied, Java
exceptions should be expected to be thrown. Note that satisfying the
preconditions does not guarantee that no exceptions are thrown (for example,
unsuccessful CIM status codes returned by the CIM server may result in Java
exceptions, plus there are some exceptions that can always be thrown such as
NullPointerException).
- Method descriptions list all Java exceptions that are explicitly thrown
by the code of the SBLIM CIM Client. There may be additional exceptions
that are thrown by the JRE or underlying class libraries.
The specific exception
CIMException
contains a CIM status code.
Method descriptions that list CIMException
list the CIM status
code identifiers that can happen. If these identifiers are just listed without
further description, their semantics is the standard semantics as documented in
class CIMException
. If the semantics used by the method differs
from the standard semantics, this is described specifically in the method
description.
Terminology
The following terminology is used in the documentation of the SBLIM CIM
Client. As a DMTF Glossary document evolves, this terminology will be drawn
from there, over time.
CIM object related terms
Terms denoting specific kinds of CIM
classes:
Phrases denoting whether the objects
are the objects in the CIM server or their local copies:
Note: These phrases can be used with all
the object related terms above.
CIM object naming related terms
Terms for specific kinds of CIM object
paths:
Phrases describing the uniqueness scope of
object paths:
Note: These phrases can be used with all
the path related terms above.
CIM class/instance member related terms
Phrases defining the set of elements in a class
or instance:
Note: These phrases are stated for properties
but are equally valid for references and methods.
Other terms
Copyright © 2005, 2007 IBM Corporation. All Rights Reserved.