# Class CIM_MediaMovementService
extends CIM_Service

CIM_MediaMovementService is a class containing the methods necessary to support CIM controlled media movement within a Storage Library.

### Table of Contents
Hierarchy
Direct Known Subclasses
Class Qualifiers
Class Properties
Class Methods

## Class Hierarchy

CIM_ManagedElement
|
+--CIM_ManagedSystemElement
|
+--CIM_LogicalElement
|
+--CIM_EnabledLogicalElement
|
+--CIM_Service
|
+--CIM_MediaMovementService

## Direct Known Subclasses

## Class Qualifiers

Name | Data Type | Value
--- | --- | ---
Description | string | CIM_MediaMovementService is a class containing the methods necessary to support CIM controlled media movement within a Storage Library.
Experimental | boolean | true
UMLPackagePath | string | CIM::Device::Storage Media Library
Version | string | 2.42.0

## Class Properties

### Inherited Properties

Name | Data Type | Class Origin
--- | --- | ---
Caption | string | CIM_ManagedElement
CommunicationStatus | uint16 | CIM_ManagedSystemElement
CreationClassName | string | CIM_Service
Description | string | CIM_ManagedElement
DetailedStatus | uint16 | CIM_ManagedSystemElement
ElementName | string | CIM_ManagedElement
EnabledDefault | uint16 | CIM_EnabledLogicalElement
EnabledState | uint16 | CIM_EnabledLogicalElement
Generation | uint64 | CIM_ManagedElement
HealthState | uint16 | CIM_ManagedSystemElement
InstallDate | datetime | CIM_ManagedSystemElement
InstanceID | string | CIM_ManagedElement
LoSID | string | CIM_Service
LoSOrgID | string | CIM_Service
Name | string | CIM_Service
OperatingStatus | uint16 | CIM_ManagedSystemElement
OtherEnabledState | string | CIM_EnabledLogicalElement
PrimaryOwnerContact | string | CIM_Service
PrimaryOwnerName | string | CIM_Service
PrimaryStatus | uint16 | CIM_ManagedSystemElement
RequestedState | uint16 | CIM_EnabledLogicalElement
Started | boolean | CIM_Service
StartMode | string | CIM_Service
Status | string | CIM_ManagedSystemElement
SystemCreationClassName | string | CIM_Service
SystemName | string | CIM_Service
TimeOfLastStateChange | datetime | CIM_EnabledLogicalElement
TransitioningToState | uint16 | CIM_EnabledLogicalElement
AvailableRequestedStates | uint16[] | CIM_EnabledLogicalElement
OperationalStatus | uint16[] | CIM_ManagedSystemElement
StatusDescriptions | string[] | CIM_ManagedSystemElement

## Class Methods

### Local Class Methods

#### MoveMedia (uint32)

#### Method Qualifiers (MoveMedia)

Name | Data Type | Value
--- | --- | ---
Description | string | An asynchronous method to move a piece of PhysicalMedia from its current location within a Storage Library to the location indicated by the method's Destination input parameter. The method returns an integer return code and a reference to an instance of CIM_ConcreteJob. The return code indicates any errors encountered during the construction of the job. All other errors, such as those encountered while the job executes, are reported in a CIM_Error object returned by the CIM_ConcreteJob's GetError() method.The optional ForceUnload parameter instructs the library to first unload the PhysicalMedia if it is loaded in a MediaAccessDevice. If the ForceUnload parameter is set to "false" and the PhysicalMedia is loaded in a MediaAccessDevice, the CIM_ConcreteJob's GetError method shall return an instance of CIM_Error indicating a "Command Sequence Error". If the ForceUnload parameter is omitted (set to "null"), the method shall use the library's default behavior, which may be vendor or library specific.
Experimental | boolean | true

#### Method Parameters (MoveMedia)

Name | Type | Qualifiers
--- | --- | ---
Name | Data Type | Value
ForceUnload | boolean
Description | string | Optional parameter instructing the storage library to first unload the media if it is loaded in a MediaAccessDevice.
IN | boolean | true
Timeout | uint32
Description | string | The timeout time in seconds
IN | boolean | true
Destination | REF CIM_StorageMediaLocation
Description | string | The destination location
IN | boolean | true
MediaToMove | REF CIM_PhysicalMedia
Description | string | The piece of media to be moved
IN | boolean | true
MoveMediaJob | REF CIM_ConcreteJob
Description | string | Reference to the job (may be null if job completed.)
OUT | boolean | true

### Inherited Class Methods

Name | Return Type | Class Origin
--- | --- | ---
ChangeAffectedElementsAssignedSequence | uint32 | CIM_Service
RequestStateChange | uint32 | CIM_EnabledLogicalElement
StartService | uint32 | CIM_Service
StopService | uint32 | CIM_Service