| Name | Data Type | Value |
| Description | string | Start a job to create a FileSystem on a StorageExtent. If the operation completes successfully and did not require a long-running ConcreteJob, it will return 0. If 4096/0x1000 is returned, a ConcreteJob will be started to create the element. A Reference to the ConcreteJob will be returned in the output parameter Job. If any other value is returned, the job will not be started, and no action will be taken.
This method MUST return a CIM_Error representing that a single named property of a setting (or other) parameter (either reference or embedded object) has an invalid value or that an invalid combination of named properties of a setting (or other) parameter (either reference or embedded object) has been requested.
The parameter TheElement will contain a Reference to the FileSystem if this operation completed successfully.
The StorageExtent to use is specified by the InExtent parameter. If this is NULL, a default StorageExtent will be created in a vendor-specific way and used. One way to create the default StorageExtent is to use one of the canned settings supported by the StorageConfigurationService hosted by the host hosting the FileSystemConfigurationService.
The desired settings for the FileSystem are specified by the Goal parameter. Goal is an element of class CIM_FileSystemSetting, or a derived class, encoded as a string-valued embedded object parameter; this allows the client to specify the properties desired for the file system. The Goal parameter includes information that can be used by the vendor to compute the size of the FileSystem. If the StorageExtent specified here cannot support the goal size, an appropriate error value will be returned, and no action will be taken.
A ResidesOnExtent association is created between the created FileSystem and the StorageExtent used for it. |
| ValueMap | string | 0, 1, 2, 3, 4, 5, 6, 7, .., 4096, 4098..32767, 32768..65535 |
| Values | string | Job Completed with No Error, Not Supported, Unknown, Timeout, Failed, Invalid Parameter, StorageExtent is not big enough to satisfy the request., StorageExtent specified by default cannot be created., DMTF Reserved, Method Parameters Checked - Job Started, Method Reserved, Vendor Specific |
| Name | Type | Qualifiers |
| Name | Data Type | Value |
| ElementName | string |
| Description | string | A end user relevant name for the FileSystem being created. If NULL, a system-supplied default name can be used. The value will be stored in the 'ElementName' property for the created element. |
| IN | boolean | true |
| Goal | string |
| Description | string | The requirements for the FileSystem element to maintain. This is an element of class CIM_FileSystemSetting, or a derived class, encoded as a string-valued embedded instance parameter; this allows the client to specify the properties desired for the file system. If NULL or the empty string, the FileSystemConfigurationService will use a vendor-specific default Goal obtained by using the FileSystemCapabilities element specified by the DefaultElementCapabilities association to obtain a default FileSystemSetting element. |
| EmbeddedInstance | string | CIM_FileSystemSetting |
| IN | boolean | true |
| InExtent |
REF
CIM_StorageExtent |
| Description | string | The StorageExtent on which the created FileSystem will reside. If this is NULL, a default StorageExtent will be created in a vendor-specific way and used. One way to create the default StorageExtent is to use one of the default settings supported by the StorageConfigurationService on the same hosting ComputerSystem as the FileSystemConfigurationService. |
| IN | boolean | true |
| Job |
REF
CIM_ConcreteJob |
| Description | string | Reference to the job (may be null if job completed). |
| IN | boolean | false |
| OUT | boolean | true |
| TheElement |
REF
CIM_FileSystem |
| Description | string | The newly created FileSystem. |
| IN | boolean | true |
| OUT | boolean | true |
| Name | Data Type | Value |
| Description | string | Start a job to modify a previously created FileSystem. If the operation completes successfully and did not require a long-running ConcreteJob, it will return 0. If 4096/0x1000 is returned, a ConcreteJob will be started to modify the element. A Reference to the ConcreteJob will be returned in the output parameter Job. If any other value is returned, either the job will not be started, or if started, no action will be taken.
This method MUST return a CIM_Error representing that a single named property of a setting (or other) parameter (either reference or embedded object) has an invalid value or that an invalid combination of named properties of a setting (or other) parameter (either reference or embedded object) has been requested.
The parameter TheElement specifies the FileSystem to be modified. This element MUST be associated via ElementSettingData with a FileSystemSetting which is in turn associated via SettingGeneratedByCapabilities to a FileSystemCapabilities supported by this FileSystemConfigurationService.
The desired settings for the FileSystem are specified by the Goal parameter. Goal is an element of class CIM_FileSystemSetting, or a derived class, encoded as a string-valued embedded instance parameter; this allows the client to specify the properties desired for the file system. The Goal parameter includes information that can be used by the vendor to compute the required size of the FileSystem. If the operation would result in a change in the size of the file system, the StorageExtent identified by the ResidesOnExtent association will be used to determine how to implement the change. If the StorageExtent cannot be expanded to support the goal size, an appropriate error value will be returned, and no action will be taken. If the operation succeeds, the ResidesOnExtent association might reference a different StorageExtent. |
| ValueMap | string | 0, 1, 2, 3, 4, 5, 6, 7, .., 4096, 4098..32767, 32768..65535 |
| Values | string | Job Completed with No Error, Not Supported, Unknown, Timeout, Failed, Invalid Parameter, FileSystem In Use, cannot Modify, Cannot satisfy new Goal., DMTF Reserved, Method Parameters Checked - Job Started, Method Reserved, Vendor Specific |
| Name | Type | Qualifiers |
| Name | Data Type | Value |
| ElementName | string |
| Description | string | A end user relevant name for the FileSystem being modified. If NULL, then the name will not be changed. If not NULL, this parameter will supply a new name for the FileSystem element. |
| IN | boolean | true |
| Goal | string |
| Description | string | The requirements for the FileSystem element to maintain. This is an element of class CIM_FileSystemSetting, or a derived class, encoded as a string-valued embedded instance parameter; this allows the client to specify the properties desired for the file system. If NULL or the empty string, the FileSystem service attributes will not be changed. If not NULL, this parameter will supply new settings that replace or are merged with the current settings of the FileSystem element. |
| EmbeddedInstance | string | CIM_FileSystemSetting |
| IN | boolean | true |
| InUseOptions | uint16 |
| Description | string | An enumerated integer that specifies the action to take if the FileSystem is still in use when this request is made. This option is only relevant if the FileSystem must be made unavailable while the request is being executed. |
| IN | boolean | true |
| ValueMap | string | 2, 3, 4, .., 0x1000..0xFFFF |
| Values | string | Do Not Execute Request, Wait for specified time, then Execute Request Immediately, Try to Quiesce for specified time, then Execute Request Immediately, DMTF Reserved, Vendor Defined |
| WaitTime | uint32 |
| Description | string | An integer that indicates the time (in seconds) that the provider must wait before performing the request on this FileSystem. If WaitTime is not zero, the method will create a job, if supported by the provider, and return immediately. If the provider does not support asynchronous jobs, there is a possibility that the client could time-out before the job is completed.
The combination of InUseOptions = '4' and WaitTime ='0' (the default) is interpreted as 'Wait (forever) until Quiescence, then Execute Request' and will be performed asynchronously if possible. |
| IN | boolean | true |
| PUnit | string | second |
| Units | string | seconds |
| Job |
REF
CIM_ConcreteJob |
| Description | string | Reference to the job (may be null if job completed). |
| IN | boolean | false |
| OUT | boolean | true |
| TheElement |
REF
CIM_FileSystem |
| Description | string | The FileSystem element to modify. |
| IN | boolean | true |
| Name | Data Type | Value |
| Description | string | DeleteFileSystem deletes a LocalFileSystem specified by the parameter TheElement and deletes any associated instances and associations that are no longer needed. A job is started if necessary. The deleted instances include the LogicalFile/Directory and FileStorage, if they were surfaced, the FileSystemSetting and its ElementSettingData association, the LocalAccessAvailable association, the LocallyAccessibleFileSystemSetting and its associations, ElementSettingData and HostedDependency, HostedFileSystem, ResidesOnExtent, and any other associations that might be orphaned by the delete. The LogicalDisk(s) that the LocalFileSystem is built on shall be released but may not be deleted. If the FileSystem cannot be deleted, no action will be taken. If necessary, a ConcreteJob will be started to delete the FileSystem. A reference to the ConcreteJob will be returned in the output parameter Job. |
| ValueMap | string | 0, 1, .., 0x1000, 0x1001..0x7FFF, 0x8000.. |
| Values | string | Job Completed with No Error, Failed, Unspecified Reasons, DMTF Reserved, Method Parameters Checked - Job Started, Method Reserved, Vendor Specific |
| Name | Type | Qualifiers |
| Name | Data Type | Value |
| InUseOptions | uint16 |
| Description | string | An enumerated integer that specifies the action to take if the FileSystem is still in use when this request is made. |
| IN | boolean | true |
| ValueMap | string | 2, 3, 4, .., 0x1000..0xFFFF |
| Values | string | Do Not Delete, Wait for specified time, then Delete Immediately, Attempt Quiescence for specified time, then Delete Immediately, DMTF Reserved, Vendor Defined |
| WaitTime | uint32 |
| Description | string | An integer that indicates the time (in seconds) that the provider must wait before deleting this FileSystem. If WaitTime is not zero, the method will create a job, if supported by the provider, and return immediately. If the provider does not support asynchronous jobs, there is a possibility that the client could time-out before the job is completed.
The combination of InUseOptions = '4' and WaitTime ='0' (the default) is interpreted as 'Wait (forever) until Quiescence, then Delete Filesystem' and will be performed asynchronously if possible. |
| IN | boolean | true |
| Units | string | seconds |
| Job |
REF
CIM_ConcreteJob |
| Description | string | Reference to the job (may be null if job completed). |
| IN | boolean | false |
| OUT | boolean | true |
| TheElement |
REF
CIM_ManagedElement |
| Description | string | An element or association that uniquely identifies the FileSystem to be deleted. |
| IN | boolean | true |
| Name | Data Type | Value |
| Description | string | CIM_CreateFileSystem creates a LocalFileSystem and returns a reference to it as the value of the parameter TheElement.Even if this operation does not complete but creates a ConcreteJob, an implementation may return a valid reference in TheElement. If the job fails subsequently, it is possible for this reference to become invalid.
The desired settings for the LocalFileSystem are specified by the Goal parameter (a string-valued EmbeddedInstance element of class FileSystemSetting).
A new FileSystemSetting element that represents the settings of the LocalFileSystem (either identical to the Goal or equivalent) shall be associated via ElementSettingData to the LocalFileSystem.
The LocalFileSystem shall be hosted on the same ComputerSystem as the FileSystemConfigurationService.
Filesystem vendors differ in their models for creating a filesystem. Some vendors require that the storage element already exist; others create the storage element at the same time as the filesystem. Some vendors require a local access point ("mount-point") that supports defining a pathname that allows a file server to access the filesystem; others do not require any such object (though it could be argued that they provide a mount-point by default).
The FileSystemConfigurationService is associated with a FileSystemConfigurationCapabilities whose properties, BlockStorageCreationSupport and LocalAccessibilitySupport, indicate support for variant mechanisms for specifying, at create time, if and how the storage element is to be created and the path by which a file server can access the filesystem locally.
The BlockStorageCreationSupport property indicates whether the storage used for creating the LocalFileSystem must consist of LogicalDisks elements and can be specified by the InExtents parameter only or by the pair of Pools and Settings parameters only, or by either mechanism.The details are discussed below. The LocalFileSystem will be associated to one of the LogicalDisk(s) via the ResidesOnExtent association.The distinguished LogicalDisk is extended by the other LogicalDisks (if any) using a class derived from BasedOn.
The LocalAccessibilitySupport property indicates whether this method provides support for setting up local access to the created LocalFileSystem from file server ComputerSystems. The values of the this property indicate how the FileServer, LocalAccessPoint, and LocalAccessSetting IN parameters are to be used and what is to be returned as the OUT value for these parameters. |
| ValueMap | string | 0, 1, .., 4096, 4098..32767, 32768..65535 |
| Values | string | Job Completed with No Error, Failed, DMTF Reserved, Method Parameters Checked - Job Started, Method Reserved, Vendor Specific |
| Name | Type | Qualifiers |
| Name | Data Type | Value |
| ElementName | string |
| Description | string | A end user relevant name for the FileSystem being created. The value will be stored in the TheElement.ElementName property.
If NULL, then the implementation may supply a default name. |
| IN | boolean | true |
| Goal | string |
| Description | string | The requirements for the FileSystem element to maintain. This is an element of class CIM_FileSystemSetting, or a derived class, encoded as a string-valued embedded instance parameter; this allows the client to specify the properties desired for the file system. If NULL or the empty string, the default configuration will be specified by the Capabilities associated with theFileSystemConfigurationService. |
| EmbeddedInstance | string | CIM_FileSystemSetting |
| IN | boolean | true |
| LocalAccessPoint | string |
| Description | string | An opaque string to use as a pathname in the name space of the ComputerSystem indicated by the FileServer parameter.
A vendor or profile could specify a format. For instance, in a Unix-bsed operating environment it could be a hierarchical fully-qualified name,or in a Windows operating environment it could be the drive letter of the underlying LogicalDisk.
If LocalAccessibilitySupport specifies "Local Access Required, Defaulted", and LocalAccessPoint is the empty string (not NULL), the implementation can provide a default LocalAccessPoint that will returned as the output value of the parameter. |
| IN | boolean | true |
| OUT | boolean | true |
| LocalAccessSetting | string |
| Description | string | An string containing an embedded LocallyAccessibleFileSystemSetting element that specifies the settings to use for making the filesystem locally accessible from the ComputerSystem indicated by FileServer.
This element will be used to create a LocalAccessAvailable association and will be cloned to create a LocallyAccessibleFileSystemSetting element that is scoped via HostedDependency to the FileServer and associated via ElementSettingData to the TheElement.The LocalAccessSetting actually used is returned as the output value of this parameter.
If the LocalAccessSetting is NULL or the empty string, the implementation shall use the default LocallyAccessibleFileSystemSetting for the associated LocallyAccessibleFileSystemCapabilities element -- this will be returned as the output value. |
| EmbeddedInstance | string | CIM_LocallyAccessibleFileSystemSetting |
| IN | boolean | true |
| OUT | boolean | true |
| ExtentSettings | string[] |
| ArrayType | string | Indexed |
| Description | string | An array of embedded StorageSetting elements that specify the settings to use for allocatingLogicalDisks from the corresponding entry in the Pools parameter. A NULL entry indicates that adefault setting appropriate for the specified StoragePool may be used. |
| EmbeddedInstance | string | CIM_StorageSetting |
| IN | boolean | true |
| OUT | boolean | true |
| Sizes | uint64[] |
| ArrayType | string | Indexed |
| Description | string | As an input parameter, Sizes specifies an array of thedesired size of a LogicalDisk storage element corresponding to an entry in the Pools parameter.An entry of '0' indicates that the LogicalDisk may be of a default size.
The achieved Sizes are returned as the output parameter. |
| IN | boolean | true |
| OUT | boolean | true |
| Units | string | bytes |
| InExtents | CIM_StorageExtent[] |
| Description | string | The LogicalDisk(s) on which the created FileSystem will reside.
If BlockStorageCreationSupport is 3 ("LogicalDisks Required"), it is an Error if this parameter is NULL.
If BlockStorageCreationSupport is 4 ("StoragePools or LogicalDisks, but not Mixed"), either this parameter isnot NULL or the Pools parameter is not NULL; it is an Errorif both are NULL or if both are not NULL.
On output, this parameter will contain the array of LogicalDisk(s) on which the created LocalFileSystem resides. |
| IN | boolean | true |
| OUT | boolean | true |
| Pools | CIM_StoragePool[] |
| Description | string | The concrete Storage Pools from which to create LogicalDisks on which the created FileSystem will reside.If the property BlockStorageCreationSupport of FileSystemConfigurationCapabilities is 2 ("StoragePools Required"), it is an Error if this parameter is not NULL.
If BlockStorageCreationSupport is 4 ("StoragePools or LogicalDisks, but not Mixed"), either this parameter isnot NULL or the InExtents parameter is not NULL; it is an Errorif both are NULL or if both are not NULL.
If this parameter is not NULL, it is an Error for any entry in it to be NULL.
Each Pool must be associated with a StorageConfigurationService that can deliver the required LogicalDisk.The LogicalDisk(s) to be used are allocated from the each StoragePool entry using the corresponding entry in the Sizes parameter and the ExtentSettings parameter. |
| IN | boolean | true |
| DirectoryServer |
REF
CIM_ComputerSystem |
| Description | string | The IN parameter indicates a ComputerSystem that has access to directory services and the newly created filesystem can use it support security principal information associated with filesystem objects, such as quotas for users and groups.
If DirectoryServerParameterSupported specifies "Not Used", or "Supported, Defaulted to FileServer", or "Supported, Defaulted to FileSystem host", it is an Error if DirectoryServer is not NULL.
Otherwise, (i.e., if DirectoryServerParameterSupported specifies "Supported"), and if the DirectoryServer is not NULL, the new filesystem will use the directory services made available by the specified DirectoryServer.If DirectoryServer is NULL, it will be defaulted to the FileServer parameter. If the FileServer parameteris also NULL, the DirectoryServer will be defaulted to the host of the newly created filesystem.
As an OUT parameter, this will be set to the value of the selected DirectoryServer, if one is used. |
| IN | boolean | true |
| OUT | boolean | true |
| FileServer |
REF
CIM_ComputerSystem |
| Description | string | This parameter indicates a ComputerSystem that will have local access to this LocalFileSystem and will be able to export shares from it.
If LocalAccessibilitySupport specifies "Local Access is Not Required", it is an Error if the FileServer is not NULL.
Otherwise, (i.e., if LocalAccessibilitySupport specifies either "Local Access Required, Defaulted" or "Local Access Required, Not Defaulted"), and FileServer is NULL, the implementation may leave the filesystem operationally inaccessible -- however, this can be corrected by calling the CIM_ModifyFileSystem method with the appropriate parameters. This is not an Error.
On the other hand, if FileServer is not NULL and LocalAccessPoint and LocalAccessSetting are not NULL, the new filesystem will be made locally accessible on the specified FileServer at the specified LocalAccessPoint with the specified LocalAccessSetting.
If FileServer is NULL, the LocalAccessPoint and LocalAccessSetting parameters may be ignored. |
| IN | boolean | true |
| Job |
REF
CIM_ConcreteJob |
| Description | string | Reference to the job (may be null if job completed). |
| IN | boolean | false |
| OUT | boolean | true |
| TheElement |
REF
CIM_LogicalElement |
| Description | string | The newly created FileSystem. |
| OUT | boolean | true |
| Name | Data Type | Value |
| Description | string | CIM_ModifyFileSystem modifies a LocalFileSystem specified by the input reference parameter TheElement.TheElement shall be associated with a FileSystemSetting whoseActualFileSystemType property is supported by the FileSystemConfigurationService (as specified by the SupportedActualFileSystemTypes property of the associated FileSystemConfigurationCapabilities).
The desired new settings for TheElement are specified by the Goal parameter (a string-valued EmbeddedInstance object of class FileSystemSetting).
The existing LogicalDisks used by TheElement cannot be released by this method, but this method may add storage as specified by the InExtents or the Pools array parameters.The BlockStorageCreationSupport property of the associated FileSystemConfigurationCapablilities element imposes some constraints. Within those limitations, five cases are possible:
1. If InExtents is not NULL and Pools is not NULL: This request is attempting to modify one or more of the LogicalDisks underlying TheElement. It is an Error if InExtents contains any LogicalDisk not already used for the filesystem and allocated from the corresponding Pools entry. The corresponding entries in the ExtentSettings array provides the new requested settings for these LogicalDisks. The corresponding entry in the Sizes array specifies the new desired size of these LogicalDisks. The entry in Pools may supply the required additional storage to satisfy the request.
2. If Pools is NULL, but InExtents is not NULL: InExtents is an array of LogicalDisks that are to be added to the existing set of LogicalDisks underlying TheElement (assuming that is permitted).
3. If Pools is NULL, but InExtents is not NULL and contains only LogicalDisks already in use by the FileSystem: InExtents is an array of LogicalDisks that are to be modified. Each LogicalDisk implicitly identifies it's allocating StoragePool. The corresponding entry in ExtentSettings provides the new requested settings for each LogicalDisk.
4. If Pools is not NULL, and InExtents is NULL: This indicates that a new set of LogicalDisks are to be created and added to the filesystem. The Pools parameter specifies an array of StoragePools, the ExtentSettings parameter specifies an array of corresponding StorageSettings, and the Sizes parameter specifies an array of corresponding sizes for allocating the new set of LogicalDisks from the Pools. These are added to the existing set of LogicalDisks of TheElement.
5. If both InExtents and Pools are NULL, there will be no change to the set of LogicalDisks, but this operation may change other properties of TheElement.
The modified TheElement will consume all the storage made available to it by the LogicalDisks, irrespective of what might be needed to satisfy the Goal.
If the new Goal is different from the old FileSystemSetting element, then the implementation must change the setting properties of TheElement. This may be accomplished by modifying the old FileSystemSetting element directly, or by deleting it and then re-creating a new FileSystemSetting element with the same InstanceId.Within the constraints of the LocalAccessibilitySupport property of the associated FileSystemConfigurationCapabilities element, this method can add a new local access point or modify or delete an existing local access point.The WaitTime and InUseOptions parameters specify the behavior if the file system is in use when this request is made. These parameters are supported if the FileSystemCapabilities.SupportedProperties includes the "RequireInUseOptions" option. |
| ValueMap | string | 0, 1, .., 4096, 4098..32767, 32768..65535 |
| Values | string | Job Completed with No Error, Failed, DMTF Reserved, Method Parameters Checked - Job Started, Method Reserved, Vendor Specific |
| Name | Type | Qualifiers |
| Name | Data Type | Value |
| ElementName | string |
| Description | string | A new end user relevant name for the FileSystem specified by TheElement. If NULL, then the previous name is not changed. |
| IN | boolean | true |
| Goal | string |
| Description | string | The requirements for the FileSystem element to maintain. This is an element of class CIM_FileSystemSetting, or a derived class, encoded as a string-valued embedded instance parameter; this allows the client to specify the properties desired for the file system. If NULL or the empty string, the current setting of the FileSystem specified by TheElement is used unchanged. |
| EmbeddedInstance | string | CIM_FileSystemSetting |
| IN | boolean | true |
| InUseOptions | uint16 |
| Description | string | An enumerated integer that specifies the action to take if the FileSystem is still in use when this request is made. This option is only relevant if the FileSystem needs to be made unavailable while the request is being executed. |
| IN | boolean | true |
| ValueMap | string | 2, 3, 4, .., 0x1000..0xFFFF |
| Values | string | Do Not Execute Request, Wait for specified time, then Execute Request Immediately, Try to Quiesce for specified time, then Execute Request Immediately, DMTF Reserved, Vendor Defined |
| LocalAccessPoint | string |
| Description | string | An opaque string to use as a pathname in the name space of the ComputerSystem indicated by the FileServer parameter.
A vendor or profile could specify a format. For instance, in a Unix-bsed operating environment it could be a hierarchical fully-qualified name,or in a Windows operating environment it could be the drive letter of the underlying LogicalDisk.
If LocalAccessibilitySupport specifies "Local Access Required, Defaulted", and LocalAccessPoint is the empty string (not NULL), the implementation can provide a default LocalAccessPoint that will returned as the output value of the parameter.
If the FileServer already has local access to TheElement, this parameter could be used to change the previously specified LocalAccessPoint.If LocalAccessPoint is NULL, it indicates that local access is being terminated at the specified FileServer. |
| IN | boolean | true |
| OUT | boolean | true |
| LocalAccessSetting | string |
| Description | string | An string containing an embedded LocallyAccessibleFileSystemSetting element that specifies the settings to use for making the filesystem locally accessible from the ComputerSystem indicated by FileServer.
This element will be used to create a LocalAccessAvailable association and will be cloned to create a LocallyAccessibleFileSystemSetting element that is scoped via HostedDependency to the FileServer and associated via ElementSettingData to the TheElement.The LocalAccessSetting actually used is returned as the output value of this parameter.
If the LocalAccessSetting is NULL or the empty string, the implementation shall use the default LocallyAccessibleFileSystemSetting for the associated LocallyAccessibleFileSystemCapabilities element -- this will be returned as the output value.
If the FileServer already has local access to TheElement, this parameter could be used to change the requirements established by the previously specified LocalAccessSetting. |
| EmbeddedInstance | string | CIM_LocallyAccessibleFileSystemSetting |
| IN | boolean | true |
| OUT | boolean | true |
| WaitTime | uint32 |
| Description | string | An integer that indicates the time (in seconds) that the provider must wait before modifying this FileSystem. If WaitTime is not zero, the method will create a job, if supported by the provider, and return immediately. If the provider does not support asynchronous jobs, there is a possibility that the client could time-out before the job is completed.
The combination of InUseOptions = '4' and WaitTime ='0' (the default) is interpreted as 'Wait (forever) until Quiescence, then Modify Filesystem' and will be performed asynchronously if possible. |
| IN | boolean | true |
| Units | string | seconds |
| ExtentSettings | string[] |
| ArrayType | string | Indexed |
| Description | string | An array of embedded StorageSetting structures that specify the settings to use for creating additional LogicalDisks (or modifying existing ones).These settings must be supported by the storage pools underlying the LogicalDisks being created or modified. |
| EmbeddedInstance | string | CIM_StorageSetting |
| IN | boolean | true |
| OUT | boolean | true |
| Sizes | uint64[] |
| ArrayType | string | Indexed |
| Description | string | As an input parameter, Sizes specifies an array of desired sizes corresponding to the entries in the ExtentSettings parameter. The Sizes of the InExtents array of LogicalDisks underlying TheElement are returned as the output parameter. |
| IN | boolean | true |
| OUT | boolean | true |
| Units | string | bytes |
| InExtents | CIM_StorageExtent[] |
| Description | string | An array of references to LogicalDisks. If these are already in use by TheElement, then this method is being called to modify their settings and this array should only contain such LogicalDisks. The corresponding entry in ExtentSettings will provide the new requirements for these LogicalDisks and the Pools parameter will be ignored.
If these LogicalDisks are not currently in use, they are being provided to extend the current set.
If both this parameter and the Pools parameter are NULL, the set of LogicalDisks underlying TheElement will not be modified.
On output, this parameter contains the full set of LogicalDisks used by TheElement. |
| IN | boolean | true |
| OUT | boolean | true |
| Pools | CIM_StoragePool[] |
| Description | string | An array of concrete Storage Pools from which to create new LogicalDisks. Only one of InExtents or Pools may be specified on input. The property BlockStorageCreationSupport of FileSystemConfigurationCapabilities must be 2 ("StoragePools Required") or 4 ("StoragePools or LogicalDisks, but not Mixed").
The corresponding entry in ExtentSettings specifies the requirements for the new LogicalDisks to be created. |
| IN | boolean | true |
| FileServer |
REF
CIM_ComputerSystem |
| Description | string | A ComputerSystem that has or will have local access to this LocalFileSystem and will be able to export shares from it.
The LocalAccessPoint parameter will specify the path to the file system relative to this ComputerSystem.The LocalAccessSetting parameter specifies the settings for local access from the specified FileServer.
If this FileServer already has local access to TheElement, this method is called to modify the settings for that access. If the LocalAccessPoint and LocalAccessSetting parameters are NULL, it indicates that local access at the specified FileServer is being stopped. If this results in all local access being terminated, it could leave the filesystem operationally inaccessible, but this is not an Error as it can be corrected by calling CIM_ModifyFileSystem.
If LocalAccessibilitySupport specifies "Local Access is Not Required", it is an Error if the FileServer is not NULL. |
| IN | boolean | true |
| Job |
REF
CIM_ConcreteJob |
| Description | string | Reference to the job (may be null if job completed). |
| IN | boolean | false |
| OUT | boolean | true |
| TheElement |
REF
CIM_LogicalElement |
| Description | string | The newly created FileSystem. |
| OUT | boolean | true |
| Name | Data Type | Value |
| Description | string | QuiesceFileSystem temporarily suspends write operationsto the underlying storage extents of a filesystem specified by TheElement.
The TimeOut parameter identifies how long the system is to hold the filesystem in a quiesced state. The default is 30 seconds.
If necessary, a ConcreteJob will be started to quiesce the FileSystem. A reference to the ConcreteJob will be returned in the output parameter Job. |
| ValueMap | string | 0, 1, 2, 3, 4, 5, 6, .., 4096, 4097..32767, 32768..65535 |
| Values | string | Job Completed with No Error, Not Supported, Unknown, Timeout, Failed, Invalid Parameter, In Use, DMTF Reserved, Method Parameters Checked - Job Started, Method Reserved, Vendor Specific |
| Name | Data Type | Value |
| Description | string | UnquiesceFileSystem resumes write operationsto the underlying storage extents of a filesystem specified by TheElement. |
| ValueMap | string | 0, 1, 2, 3, 4, 5, 6, .., 4097..32767, 32768..65535 |
| Values | string | Success, Not Supported, Unknown, Not Quiesced, Failed, Invalid Parameter, In Use, DMTF Reserved, Method Reserved, Vendor Specific |