2.5.2.4 Query CIM Properties — WM Client
Goal: To retrieve the values of some set of properties of a CIM object.
Context of Use: This use case occurs whenever the WM user wants to determine the current status of a managed object.
Actors
WM client: The primary actor that triggers this use case. It is responsible for providing an interface to the CIM data for some set of computers. The primary interest of the WM client is to provide such functionality.
WM server: A supporting actor who implements a CIMOM and responds to network requests that the WM client initiates.
Authentication services: A supporting actor that provides authentication services through NTLM, Kerberos, Basic, and Digest authentication to secure communications. It also provides authentication services that support the client-to-server communication within and outside the Windows Management system components. For an overview of the Authentication Services protocols, see [MS-AUTHSOD].
Stakeholders
WM user: A person who or a management application that has to access or change some set of CIM data for some set of computers. The primary interest of the WM user is to query the required property values.
Preconditions
The queried properties have to exist.
The WM user has to know the class of the object.
The WM user has to know the schema of the object.
The WM user has to know the unique identifier of the object.
Main success scenario
Trigger: The WM client sends a request to the WM server by specifying the name of the CIM class, object identifier, and set of properties that are being queried.
The WM server queries for the properties of the particular object of the CIM class. This is a read-only operation.
The WM server successfully returns the values of the requested properties for the CIM object to the client.
Post condition
The requested data is retrieved successfully.
Extensions: If the communication channel cannot be established or becomes disconnected, it causes the protocol to tear down all related communications and update any necessary data structures to maintain the system state, as described in section 2.10.1. If the WM user refers to a nonexistent CIM object, the WM server notifies the client about the failure to perform the requested operation.