cim_controllerconfigurationservice.mof

Pegasus is an open-source implementationof the DMTF CIM and WBEM standards. It is designed to be por

          "CIM_ProtocolControllerMaskingCapabilities. If "
          "SPCAllowsNoLUs is false, the caller MUST specify a list of "
          "LUNames. If it is true, the caller MAY specify a list of "
          "LUNames or MAY pass in null. If SPCAllowsNoTargets is false "
          "and PortsPerView is not 'All Ports share the same view' the "
          "caller MUST specify a list of TargetPortIDs. If it is true, "
          "the caller MAY specify a list of TargetPortIDs or MAY pass "
          "in null. If SPCAllowsNoInitiators is false, the caller MUST "
          "specify a list of InitiatorPortIDs. If it is true, the "
          "caller MAY specify a list of InitiatorPortIDs or MAY pass "
          "in null. If LUNames is not null, the caller MUST specify "
          "DeviceAccesses for each logical unit. If the "
          "instrumentation's CIM_ProtocolControllerMaskingCapabilities "
          "ClientSelectableDeviceNumbers property is TRUE then the "
          "client MAY provide a list of device numbers (LUNs) to use "
          "for the paths to be created. If is false, the client MUST "
          "pass in NULL for this parameter. \n"
          "\n"
          "The LUNames, DeviceNumbers, and DeviceAccesses parameters "
          "are mutually indexed arrays - any element in DeviceNumbers "
          "or DeviceAccesses will set a property relative to the "
          "LogicalDevice instance named in the corresponding element "
          "of LUNames. LUNames and DeviceAccesses MUST have the same "
          "number of elements. DeviceNumbers MUST be null (asking the "
          "instrumentation to assign numbers) or have the same number "
          "of elements as LUNames. If these conditions are not met, "
          "the instrumentation MUST return a 'Invalid Parameter' "
          "status or a CIM_Error. \n"
          "\n"
          "For modifying an SPC, there are three specific use cases "
          "identified. The instrumentation MUST support these use "
          "cases. Other permutations are allowed, but are "
          "vendor-specific. The use cases are: Add LUs to a view, Add "
          "initiator IDs to a view, and Add target port IDs to a view. "
          "Add LUs to a view requires that the LUNames parameter not "
          "be null and that the InitiatorIDs and TargetPortIDs "
          "parameters be null. DeviceNumbers MAY be null if "
          "ClientSelectableDeviceNumbers is false. DeviceAccesses MUST "
          "be specified. Add initiator IDs to a view requires that the "
          "LUNames parameter be null, that the InitiatorIDs not be "
          "null, and that the TargetPortIDs parameters be null. "
          "DeviceNumbers and DeviceAccesses MUST be null. Add target "
          "port IDs to a view requires that the LUNames and "
          "InitiatorPortIDs parameters be null and is only possible is "
          "PortsPerView is 'Multiple Ports Per View'. DeviceNumbers "
          "and DeviceAccesses MUST also be null \n"
          "\n"
          "The relevant rules of SCSI semantics are: \n"
          "- an SPC MAY NOT be exposed through a particular "
          "host/target port pair that is in use by another SPC. (In "
          "other words, an SPC and its associated logical units and "
          "ports together correspond to the logical unit inventory "
          "provided by SCSI REPORT LUNS and INQUIRY commands) \n"
          "- each LogicalDevice associated to an SPC MUST have a "
          "unique ProtocolControllerForUnit DeviceNumber (logical unit "
          "number) \n"
          "The instrumentation MUST report an error if the client "
          "request would violate one of these rules. \n"
          "\n"
          "If the instrumentation provides PrivilegeManagementService, "
          "the results of setting DeviceAccesses MUST be synchronized "
          "with PrivilegeManagementService as described in the "
          "ProtocolControllerForUnit DeviceAccess description."), 
       ValueMap { "0", "1", "2", "3", "4", "5", "6..4095", "4096",
          "4097", "4098", "4099", "4100", "4101", "4102", "4103",
          "4104..32767", "32768..65535" }, 
       Values { "Success", "Not Supported", "Unspecified Error",
          "Timeout", "Failed", "Invalid Parameter", "DMTF Reserved",
          "Method Parameters Checked - Job Started",
          "Invalid logical unit ID", "Invalid initiator port ID",
          "Invalid target port ID", "Invalid permission",
          "Target/initiator combination already exposed",
          "Requested logical unit number in use",
          "Maximum Map Count Exceeded", "Method Reserved",
          "Vendor Specific" }]
   uint32 ExposePaths ( 
         [IN ( false ), OUT, Description (
             "Reference to the job if 'Method Parameters Checked - Job "
             "Started' is returned (MAY be null if job completed).")]
      CIM_ConcreteJob REF Job, 
         [Required, IN, Description (
             "An array of IDs of logical unit instances. The LU "
             "instances MUST already exist. The members of this array "
             "MUST match the Name property of LogicalDevice instances "
             "that represent SCSI logical units. See the method "
             "description for conditions where this MAY be null."), 
          ArrayType ( "Indexed" ), 
          ModelCorrespondence { "CIM_LogicalDevice.Name",
             "CIM_ControllerConfigurationService.ExposePaths.DeviceNumbers",
             "CIM_ControllerConfigurationService.ExposePaths.DeviceAccesses" 
             }]
      string LUNames[], 
         [IN, Description (
             "IDs of initiator ports. If existing StorageHardwareID "
             "instances exist, they MUST be used. If no "
             "StorageHardwareID instance matches, then one is "
             "implicitly created. See the method description for "
             "conditions where this MAY be null."), 
          ModelCorrespondence { "CIM_StorageHardwareID.StorageID" }]
      string InitiatorPortIDs[], 
         [IN, Description (
             "IDs of target ports. See the method description for "
             "conditions where this MAY be null."), 
          ModelCorrespondence { "CIM_SCSIProtocolEndpoint.Name" }]
      string TargetPortIDs[],
      
         [IN, Description (
             "A list of logical unit numbers to assign to the "
             "corresponding logical unit in the LUNames parameter. "
             "(within the context of the elements specified in the "
             "other parameters). If the LUNames parameter is null, "
             "then this parameter MUST be null. Otherwise, if this "
             "parameter is null, all LU numbers are assigned by the "
             "hardware or instrumentation."), 
          ArrayType ( "Indexed" ), 
          ModelCorrespondence { 
             "CIM_ProtocolControllerForUnit.DeviceNumber" 
             "CIM_ControllerConfigurationService.ExposePaths.LUNames",
             "CIM_ControllerConfigurationService.ExposePaths.DeviceAccesses" 
             }]
      string DeviceNumbers[],
      
         [IN, Description (
             "A list of permissions to assign to the corresponding "
             "logical unit in the LUNames parameter. This specifies "
             "the permission to assign within the context of the "
             "elements specified in the other parameters. Setting this "
             "to 'No Access' assigns the DeviceNumber for the "
             "associated initiators, but does not grant read or write "
             "access. If the LUNames parameter is not null then this "
             "parameter MUST be specified."), 
          ValueMap { "0", "2", "3", "4", "5..15999", "16000.." }, 
          Values { "Unknown", "Read Write", "Read-Only", "No Access",
             "DMTF Reserved", "Vendor Reserved" },
             ArrayType ( "Indexed" ), 
          ModelCorrespondence { 
             "CIM_ProtocolControllerForUnit.DeviceAccess" 
             "CIM_ControllerConfigurationService.ExposePaths.DeviceNumbers",
             "CIM_ControllerConfigurationService.ExposePaths.LUNames" }]
      uint16 DeviceAccesses[],
      
         [IN, OUT, Description (
             "An array of references to SCSIProtocolControllers "
             "(SPCs). On input, this can be null, or contain exactly "
             "one element; there MAY be multiple references on output. "
             "If null on input, the instrumentation will create one or "
             "more new SPC instances. If an SPC is specified, the "
             "instrumentation will attempt to add associations to one "
             "or more existing SPCs. If the first array element is a "
             "valid SPC reference and SCSI semantics can be preserved, "
             "the instrumentation MUST attach associations to the "
             "specified SPC. If multiple elements are non-null on "
             "input, the instrumentation MUST report an invalid "
             "parameter. On output, this is an array of references to "
             "SPCs created or modified as the result of processing the "
             "request.")]
      CIM_SCSIProtocolController REF ProtocolControllers[]); 

      [Description (
          "Hide a list of SCSI logical units (such as a RAID volume or "
          "tape drive) from a list of initiators and/or target ports "
          "on a SCSIProtocolController (SPC). \n"
          "\n"
          "The parameters for this method are: Job - null if no job "
          "created, otherwise this is a reference to the job. LUNames "
          "- the list of names of the logical units to use. "
          "InitiatorPortIDs - the names of the initiator ports to use. "
          "TargetPortIDs - the names of the target ports to use. "
          "ProtocolControllers - SPCs involved in this operation. \n"
          "\n"
          "When hiding logical units, there are three specific use "
          "cases identified. The instrumentation MUST support these "
          "use cases. Other permutations are allowed, but are "
          "vendor-specific. The use cases are: Remove LUs from a view, "
          "Remove initiator IDs from a view, and Remove target port "
          "IDs from a view. Remove LUs from a view requires that the "
          "LUNames parameter not be null and that the InitiatorIDs and "
          "TargetPortIDs parameters be null. Remove initiator IDs from "
          "a view requires that the LUNames parameter be null, that "
          "the InitiatorIDs not be null, and that the TargetPortIDs "
          "parameters be null. Remove target port IDs from a view "
          "requires that the LUNames and InitiatorPortIDs parameters "
          "be null. \n"
          "\n"
          "The disposition of the SPC when the last logical unit, "
          "initiator ID, or target port ID is removed depends upon the "
          "CIM_ProtocolControllerMaskingCapabilites SPCAllowsNo* "
          "properties. If SPCAllowsNoLUs is false, then the SPC is "
          "automatically deleted when the last logical unit is "
          "removed. If SPCAllowsNoTargets is false, then the SPC is "
          "automatically deleted when the last target port ID is "
          "removed. If SPCAllowsNoInitiators is false, then the SPC is "
          "automatically deleted when the last initiator port ID is "
          "removed. In all other cases, the SPC MUST be explicitly "
          "deleted via the DeleteInstance intrinsic function."), 
       ValueMap { "0", "1", "2", "3", "4", "5", "6..4095", "4096",
          "4097", "4098", "4099", "4100", "4101..32767",
       "32768..65535" }, 
       Values { "Success", "Not Supported", "Unspecified Error",
          "Timeout", "Failed", "Invalid Parameter", "DMTF Reserved",
          "Method Parameters Checked - Job Started",
          "Invalid logical unit ID", "Invalid initiator port ID",
          "Invalid target port ID",
          "Target/initiator combination not exposed",
          "Method Reserved", "Vendor Specific" }]
   uint32 HidePaths ( 
         [IN ( false ), OUT, Description (
             "Reference to the job if 'Method Parameters Checked - Job "
             "Started' is returned (MAY be null if job completed).")]
      CIM_ConcreteJob REF Job,
      
         [Required, IN, Description (
             "A list of IDs of logical units. Each LU instance MUST "
             "already exist. See the method description for conditions "
             "where this MAY be null."), 
          ModelCorrespondence { "CIM_LogicalDevice.Name" }]
      string LUNames[],
      
         [IN, Description (
             "IDs of initiator ports. See the method description for "
             "conditions where this MAY be null."), 
          ModelCorrespondence { "CIM_StorageHardwareID.StorageID" }]
      string InitiatorPortIDs[],
      
         [IN, Description (
             "IDs of target ports. See the method description for "
             "conditions where this MAY be null."), 
          ModelCorrespondence { "CIM_SCSIProtocolEndpoint.Name" }]
      string TargetPortIDs[],
      
         [IN, OUT, Description (
             "An array of references to SCSIProtocolControllers "
             "(SPCs). On input, this MUST contain exactly one element; "
             "there MAY be multiple references on output. The "
             "instrumentation will attempt to remove associations "
             "(LUNames, InitiatorPortIDs, or TargetPortIDs) from this "
             "SPC. Depending upon the specific implementation, the "
             "instrumentation MAY need to create new SPCs with a "
             "subset of the remaining associations. On output, this is "
             "an array of references to SPCs created or modified as "
             "the result of processing the request.")]
      CIM_SCSIProtocolController REF ProtocolControllers[]); 

};