// Copyright (c) 2005 DMTF.  All rights reserved.
// <change cr="SysDevCR00678" type = "deprecate"> (CIM V2.9.1 Final) Deprecate CIM_StorageMediaLibrary in Device model </change>
// <change cr="ArchCR00066.004" type="add">Add UmlPackagePath
// qualifier values to CIM Schema.</change>
// <change cr="ArchCR00089.003" type="add">Add PUnit qualifier values
// to Units qualifier values.</change>
// ===================================================================
// StorageLibrary
// ===================================================================
   [Deprecated { "CIM_ComputerSystem", "CIM_StorageLibraryCapabilities" }, 
    Version ( "2.9.0" ), 
    UMLPackagePath ( "CIM::Device::StorageLib" ), 
    Description ( 
       "A StorageLibrary is a collection of ManagedSystemElements that "
       "operate together to provide cartridge library capabilities. "
       "This object serves as an aggregation point to group the "
       "following elements: MediaTransferDevices, a Label Reader, a "
       "library Door, MediaAccessDevices, and other Library "
       "components. \n"
       "The use of this class is deprecated in favor of "
       "CIM_ComputerSystem. Originally it was felt that a media "
       "library could be purely mechanical and thus not a "
       "ComputerSystem. However all manageable libraries are "
       "ComputerSystems. This change simplifies the use of the model "
       "by client software." )]
class CIM_StorageLibrary : CIM_System {

      [Deprecated { "CIM_StorageLibraryCapabilities.Capabilities" }, 
       Description ( 
          "Capabilities of the StorageLibrary. For example, it can "
          "be indicated that the Library can perform automatic "
          "cleaning of the MediaAccessDevices contained in it "
          "(value=1) or that the Library provides physical door "
          "access for an operator (value=2)." ), 
       ValueMap { "0", "2", "3", "4" }, 
       Values { "Unknown", "Automatic Cleaning", "Manual Operation", 
          "Front Panel Lockable" }]
   uint16 Capabilities[];

      [Deprecated { "CIM_ComputerSystem.OperationalStatus" }, 
       Description ( 
          "This property is deprecated in favour of an "
          "OperationalStatus value of 4 (\'stressed\').\n"
          "Boolean set to TRUE if there are more PhysicalMedia in a "
          "Library than there are StorageMediaLocations to contain "
          "them. For instance, if all MediaAccessDevices have a "
          "Media loaded in them, and all StorageMediaLocations are "
          "loaded by an operator, then an Overfilled condition "
          "exists." )]
   boolean Overfilled;

      [Deprecated { "CIM_ComputerSystem.OperationalStatus" }, 
       Description ( 
          "This property is deprecated in favour of an "
          "OperationalStatus value of 0 (\'Unknown\').\n"
          "Boolean set to TRUE if the Library can not currently "
          "report the correct state of each PhysicalMedia within "
          "its proper StorageMediaLocation." )]
   boolean AuditNeeded;

      [Deprecated { "CIM_ComputerSystem.OperationalStatus" }, 
       Description ( 
          "This property is deprecated in favour of an "
          "OperationalStatus value of 11 (\'In Service\').\n"
          "Boolean set to TRUE if an audit of the location of some "
          "or all of the Library\'s PhysicalMedia is currently "
          "being performed. That an individual Changer is currently "
          "doing an audit is indicated by a similar AuditInProgress "
          "boolean property on the Changer object." )]
   boolean AuditInProgress;

      [Deprecated { "CIM_StorageLibraryCapabilities.MaxAuditTime" }, 
       Description ( 
          "Maximum time in seconds that it takes for the Storage "
          "Library to perform a complete audit of each StorageMedia "
          "Location, to determine the absence or presence of a "
          "Physical Media. If automated support is not provided, "
          "then this property\'s value is undefined." ), 
       Units ( "Seconds" ), 
       PUnit ( "second" )]
   uint64 MaxAuditTime;

      [Deprecated { "No value" }, 
       Description ( 
          "This property is deprecated since all managed libraries "
          "willbe automated.\n"
          "Boolean set to TRUE if the Library includes a robotics "
          "mechanism that can be controlled by a ComputerSystem, to "
          "automatically load and unload PhysicalMedia to/from "
          "MediaAccessDevices and StorageMediaLocations. The "
          "property is set to FALSE if the Library represents a "
          "repository of Media that are inaccessible to a "
          "MediaAccess Device without human intervention. An "
          "example of a non- automated Library is a \'shelf\' or "
          "\'vault\' where Physical Media are kept for extended "
          "periods of time." )]
   boolean Automated;

      [Deprecated { "CIM_ComputerSystem.OperationalStatus" }, 
       Description ( 
          "This property is deprecated in favour of an "
          "OperationalStatus value of 10 (\'Stopped\').\n"
          "Boolean indicating whether the Library\'s robotics are "
          "currently active/enabled. If TRUE, then the Library may "
          "not be safe for a human to enter." )]
   boolean RoboticsEnabled;


      [Deprecated { "CIM_ComputerSystem.RequestStateChange" }, 
       Description ( 
          "Requests that the Library robotics be enabled for "
          "automated operation (input parameter, Enabled, set to "
          "TRUE), or disabled for manual operation (input parameter "
          "set to FALSE). The return value should be 0 if the "
          "request was successfully executed, 1 if the request is "
          "not supported and some other value if an error occurred. "
          "In a subclass, the set of possible return codes could be "
          "specified, using a ValueMap qualifier on the method. The "
          "strings to which the ValueMap contents are \'translated\' "
          "may also be specified in the subclass as a Values array "
          "qualifier." )]
   uint32 EnableRobotics(
         [IN, Description ( "Set TRUE to enable." )]
      boolean Enable);

};