// Copyright (c) 2013 DMTF.  All rights reserved.
   [Experimental, Version ( "2.42.0" ), 
    UMLPackagePath ( "CIM::Device::Storage Media Library" ), 
    Description ( 
       "CIM_MediaMovementService is a class containing the methods "
       "necessary to support CIM controlled media movement within a "
       "Storage Library." )]
class CIM_MediaMovementService : CIM_Service {


      [Experimental, Description ( 
          "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." )]
   uint32 MoveMedia(
         [OUT, Description ( 
             "Reference to the job (may be null if job completed.)"
              )]
      CIM_ConcreteJob REF MoveMediaJob, 
         [IN, Description ( "The piece of media to be moved" )]
      CIM_PhysicalMedia REF MediaToMove, 
         [IN, Description ( "The destination location" )]
      CIM_StorageMediaLocation REF Destination, 
         [IN, Description ( 
             "Optional parameter instructing the storage library "
             "to first unload the media if it is loaded in a "
             "MediaAccessDevice." )]
      boolean ForceUnload, 
         [IN, Description ( "The timeout time in seconds" )]
      uint32 Timeout);

};