Client API Overview

WBEM client applications use the javax.wbem.client APIs to manipulate Common Information Model (CIM) objects. A client application uses the CIM API to construct an object and then to create an instance of that object. Examples of such an object include a class, an instance, or a name space. The application uses the client APIs to pass the object to the CIM Object Manager and request a WBEM operation. Examples of such an operation are creating a CIM class, creating an instance, or creating a name space.

Sequence of a Client Application

Client applications typically follow this sequence:

1. Connect to the CIMOM using CIMClient. A client application connects to the CIMOM each time the client needs to perform a WBEM operation. These operations might include creating a CIM class and updating a CIM instance. See Opening and Closing a Client Connection.

2. Use the client APIs to request operations and to perform programming tasks. The application's feature set determines which operations it needs to request. The tasks that most programs perform include:

   • Create, delete and update instances

   • Enumerate objects

   • Call methods

   • Retrieve class definitions

   • Handle errors

   Client programs can also create and delete classes, create and delete name spaces, and use qualifiers. See Performing Basic Client Operations.

3. Close the client connection to the CIM Object Manager using CIMClient, to free the server resources used by the client session. See Opening and Closing a Client Connection.