Operation void getInventory (InventoryFilter filter = NA, CIS GeneralizedTime diffDateAndTime = NA, whereAndHowToReply, InventoryData inventoryData = NA), in Class OperationsSystem

Documentation
This operation returns a specified portion of the inventory data from the OS to which the request is directed (i.e., the target OS). The target OS returns all objects (in batches) satisfying the scope and filter constraints of the requesting OS that have a modification date equal to or later than the Diff Date and Time.
The operation can only be directed to a top-level OS and not to a subordinate OS.
Operation Exceptions:
1. INTERNAL_ERROR - Raised in case of non-specific OS internal failure.
2. NOT_IMPLEMENTED - Raised when the OS does not support this operation.
3. INVALID_INPUT - Raised when any input parameter is syntactically incorrect (e.g., invalid filter syntax).
4. COMM_FAILURE - Raised when communication to an entity (needed to help fulfill the request) is lost.

Protocol |  | Qualification |
Exceptions |  | Size |
Time |  | Concurrency | Sequential
Export Control | PublicAccess |  |

Preconditions
None
Postconditions
No change in the system.
Semantics

Arguments

filter
/* in */ Defines the subset of the total inventory to be returned to the requesting OS.
diffDateAndTime
/* in */ All objects with a modification date equal to or greater than this value are in scope of this operation.
whereAndHowToReply
/* in */ The parameter contains the necessary information (including where and how) the target OS needs to send the response. The information provided in this parameter depends on the scenario (i.e., type of communication style) used for retrieving the network inventory. The individual information to be provided by the requesting OS is described in the following Use Cases of the MTOSI Business Agreement:
- UC_MTOSI_13: Bulk Inventory Retrieval - Scenario 1: Coarse grained approach, batched response, message communication style
- UC_MTOSI_14: Bulk Inventory Retrieval - Scenario 2: Coarse grained approach, RPC communication style
- UC_MTOSI_15: Bulk Inventory Retrieval - Scenario 3: Coarse grained approach, file transfer.
inventoryData
/* out */ The parameter contains the inventory data that are returned on a getInventory operation.