The metrics of SWRAllocationStatistics describe the allocation of the software resource. The allocation is basically the size of the software resource in terms of technical units (e.g., kB) or domain-specific units (e.g., the number of items (e.g., the number of messages if the software resource is of the type 'queue'). The operational parameters regarding the allocation limits are surfaced also. Further details can be found in the description of the base class SWRStatistics. The metrics found in this statistics are raw values that describe the allocation behavior of the software resource as simple as possible. Thus, the metric values can be used most flexibly (e.g., cumulative, averaged, etc.). The drawback of the flexibility is that the likelyhood of required calculations - subsequent to retrieval of the values - increases in order to result in rates or statistical data needed for monitoring and reporting. | Qualifiers:Version ( "2.8.1000" ) Experimental UMLPackagePath ( "CIM::Application::SWResources" ) | Parameters (local in grey) | | ModelCorrespondence { "CIM_SWRStatistics.Unit" , "CIM_SWRAllocationStatistics.AllocationHighWaterMark" } uint32 AllocationHighWaterMark ; AllocationHighWaterMark describes allocation peak (highest allocation level) reached throughout the sample interval. The unit depends on the type of the statistics. The timestamp that corresponds to the high water mark is not presented since the sample interval is small enough that the exact point in time is not significant. The metric is targeted to quantify errors like the violation of the upper limit or any capacity problems. A value of null indicates that no allocation level is available. The initial value is 0. | ModelCorrespondence { "CIM_SWRStatistics.Unit" } uint32 AllocationLevel ; AllocationLevel describes the current size of the software resource in units corresponding to the type of the statistics (e.g., technical based on Kilobytes). The unit can be found at the CIM_SWRStatistics.Unit. The metric is a point metric and applies to the point in time of the end of the sample interval. A value of null indicates that no allocation level is available. The initial value is 0. | uint32 DroppedAllocationQuantity ; DroppedAllocationQuantity allows to further quantify the error of the software resource is over-used and upper limits are reached. In such a case, aging algorithms or other priorization algorithms implemented by the software resource may enforce the deletion of items. DroppedAllocationQuantity counts the items dropped due the resolution of such an overload. The metric's unit depends on the type of the statistics. If no items have been dropped, the value is 0. The property value is null if no numeric value can be provided. The initial value is 0. | ModelCorrespondence { "CIM_SWRAllocationStatistics.AllocationHighWaterMark" } datetime HighWaterMarkTimeStamp ; HighWaterMarkTimeStamp is the point in time at which the high water mark was detected. The initial value is 0. | ModelCorrespondence { "CIM_SWRStatistics.OtherUnit" , "CIM_SWRAllocationStatistics.AllocationLevel" } uint32 OtherAllocationLevel ; OtherAllocationLevel describes the current size of the software resource in complementary units compared to AllocationLevel (e.g., domain-specific units like the number of items: buffered objects or pooled connections). The unit can be found at CIM_SWRStatistics.OtherUnit. The metric is a point metric and applies to the point in time of the end of the sample interval. A value of null indicates that no allocation level is available. The initial value is 0. | datetime AverageItemResidenceTime ; AverageItemResidenceTime describes the average period of time that items reside in the software resource. This is particular interesting for blocked or (volatile) storage software resources. The average takes all items into account that are output from the software resource (i.e., the items' residence time ends). A value of null indicates that no average is available. The initial value is 0. | uint32 ErrorCount ; ErrorCount is the count of errors that have been detected throughout the sample interval. | uint32 OtherLowerLimit ; This property is not null, if the operational lower limit parameter of the software resource can be calculated from the property LowerLimit. If LowerLimit is described by technical units (i.e., InputUnit applies to the technical domain), OtherLowerLimit is described by domain-specific units. | ValueMap { "0" , "2" , "3" , "4" , "5" , "6" , "7..32767" , "32768..65535" } Values { "Unspecified Error" , "Violate Upper Limit" , "Violate Lower Limit" , "Erroneous Transfer" , "Erroneous Item" , "Access to Software Resource Denied" , "DMTF Reserved" , "Vendor Reserved" } uint16 FirstError ; This is the error code of the first error that occurs during the sample interval. It is assumed that the first error, detected throughout the sample interval, is the first symptom of the root cause and therefore closer than the last error. Unrelated, subsequent errors during the sample interval of the statistics do not show up. Such a behavior is tolerable compared to the relatively short length of the sample interval. Values: Unspecified Error: No error code can be determined. Violate Upper Limit: The upper limit of the behavior characteristic (allocation, input, output) was exceeded. Violate Lower Limit: The lower limit was underrun. Erroneous Transfer: The transfer had to be aborted. This message does not overlap with 'Erroneous Item'. Erroneous Item: The handling of at least one item was problematic and the item had to be dropped, suspended or rejected. Access to Software Resource Denied: The access control of software resource refused the use of the it. | Write ModelCorrespondence { "CIM_SWRLimitSetting.UpperInputLimit" , "CIM_SWRLimitSetting.UpperOutputLimit" , "CIM_SWRLimitSetting.UpperAllocationLimit" } uint32 UpperLimit ; This is an operational upper limit parameter of the software resource. The limit applies to input, output or allocation according to the statistics type. The corresponding unit is found at the property Unit. A null value indicates that no upper limit exists. The property value can be modified. Whether changes are persisted on saving the modification depends on the implementation of the software resource. The default behavior is no persistence. | uint32 OtherUpperLimit ; This property is not null, if the operational upper limit parameter of the software resource can be calculated from the property UpperLimit. If UpperLimit is described by technical units (i.e., InputUnit applies to the technical domain), OtherUpperLimit is described by domain-specific units. | datetime FirstErrorTimeStamp ; FirstErrorTimeStamp is the point in time at which FirstError was detected. | string OtherUnit ; This is the complementary unit of the operational limit parameters. If Unit is a unit of the technical domain, OtherUnit is a domain-specific unit. | Write ModelCorrespondence { "CIM_SWRLimitSetting.LowerInputLimit" , "CIM_SWRLimitSetting.LowerOutputLimit" , "CIM_SWRLimitSetting.LowerAllocationLimit" } uint32 LowerLimit ; This is an operational lower limit parameter of the software resource. The limit applies to input, output or allocation according to the statistics type. The corresponding unit is found at the property Unit. A null value indicates that no lower limit exists. The property value can be modified. Whether changes are persisted on saving the modification depends on the implementation of the software resource. The default behavior is no persistence. | ValueMap { "0" , "2" , "3" , "4" , "5" , "6" , "7..32767" , "32768..65535" } Values { "Unspecified Error" , "Violate Upper Limit" , "Violate Lower Limit" , "Erroneous Transfer" , "Erroneous Item" , "Access to Software Resource Denied" , "DMTF Reserved" , "Vendor Reserved" } uint16 LastError ; This is the error code of the last error that occured. The value of LastError remains from one sample interval to the next even if a sample interval is error-free. Values: Unspecified Error: No error code can be determined. Violate Upper Limit: The upper limit of the behavior characteristic (allocation, input, output) was exceeded. Violate Lower Limit: The lower limit was underrun. Erroneous Transfer: The transfer had to be aborted. This message does not overlap with 'Erroneous Item'. Erroneous Item: The handling of at least one item was problematic and the item had to be dropped, suspended or rejected. Access to Software Resource Denied: The access control of software resource refused the use of the it. | datetime LastErrorTimeStamp ; LastErrorTimeStamp is the point in time at which FirstError was detected. | ValueMap { "0" , "2" , "3" , "4" , "5..32767" , "32768..65535" } Values { "Unknown" , "Allocation" , "Input" , "Output" , "DMTF Reserved" , "Vendor Reserved" } uint16 Characteristic ; Characteristic allows for the distinction of the software resource behavior characteristics. This is either the allocation, input and output. Values: Allocation: Statistics about the size of the software resource. Input: Statistics about the data transfer into the software resource. Output: Statistics about the data transfer from the software resource. | ModelCorrespondence { "CIM_SWRLimitSetting.InputUnit" , "CIM_SWRLimitSetting.OutputUnit" , "CIM_SWRLimitSetting.AllocationUnit" } string Unit = "kB" ; This is the unit of the numeric metrics and the set of upper and lower limits of the software resource. The property should always have a value, null should not appear.The property value is read-only and assumed to correspond to the implementation of the software resource to which the operational parameters and metrics apply. The default value is of the technical domain (Kilobytes). | ValueMap { "0" , "2" , "3" , "4..32767" , "32768..65535" } Values { "Unknown" , "Technical" , "Domain-Specific" , "DMTF Reserved" , "Vendor Reserved" } uint16 StatisticsType = 2 ; StatisticsType describes whether the statistics is specified in terms of technical units or domain-specific units. Domain-specific is meant to be the items unit or 'business' unit of the usage the software resource. It may range from objects or tables (in a buffer) to orders in a queue. It depends on the implementation and usage context of the software resource. The default is the technical domain. Values: Technical: The writable operational parameters and the affected metrics are assigned a technical unit e.g Kilobytes. Domain-Specific: The writable operational parameters and the affected metrics are assigned a business-like, item-oriented unit e.g messages, objects, orders, etc.. | Required Override ( "ElementName" ) string ElementName ; The user friendly name for this instance of StatisticalData. In addition, the user friendly name can be used as a index property for a search of query. (Note: Name does not have to be unique within a namespace.) | datetime SampleInterval = "00000000000000.000000:000" ; Some statistics are sampled at consistent time intervals. This property provides the sample interval so that client applications can determine the minimum time that new statistics should be pulled. If the statistics are not sampled at consistent time intervals, this property must be set to a zero time interval. | datetime StartStatisticTime ; The time, relative to managed element where the statistic was collected, when the first measurement was taken. If the statistic is reset, the StartStatisticTime is the time when the reset was performed. | datetime StatisticTime ; The time the most recent measurement was taken, relative to the managed element where the statistic was collected. | Key string InstanceID ; Within the scope of the instantiating Namespace, InstanceID opaquely and uniquely identifies an instance of this class. In order to ensure uniqueness within the NameSpace, the value of InstanceID SHOULD be constructed using the following 'preferred' algorithm: <OrgID>:<LocalID> Where <OrgID> and <LocalID> are separated by a colon ':', and where <OrgID> MUST include a copyrighted, trademarked or otherwise unique name that is owned by the business entity creating/defining the InstanceID, or is a registered ID that is assigned to the business entity by a recognized global authority (This is similar to the <Schema Name>_<Class Name> structure of Schema class names.) In addition, to ensure uniqueness <OrgID> MUST NOT contain a colon (':'). When using this algorithm, the first colon to appear in InstanceID MUST appear between <OrgID> and <LocalID>. <LocalID> is chosen by the business entity and SHOULD not be re-used to identify different underlying (real-world) elements. If the above 'preferred' algorithm is not used, the defining entity MUST assure that the resultant InstanceID is not re-used across any InstanceIDs produced by this or other providers for this instance's NameSpace. For DMTF defined instances, the 'preferred' algorithm MUST be used with the <OrgID> set to 'CIM'. | uint32ResetSelectedStats( | | Array of strings indicating which statistics to reset. Qualifiers:IN
| | string SelectedStatistics [ ] | ) Method to reset one or more of the instance's statistics. The method takes one parameter as input - an array of strings indicating which statistics to reset. If all the statistics in the instance should be reset, the first element of the array MUST be set to 'All' or 'ALL'. If one or more individual statistics should be reset, the corresponding property names are entered into the elements of the array. The method returns 0 if successful, 1 if not supported, and any other value if an error occurred. A method is specified so that the StatisticalInformation's provider/ instrumentation, which calculates the statistics, can reset its internal processing, counters, etc. 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. | MaxLen ( 64 ) string Caption ; The Caption property is a short textual description (one- line string) of the object. | string Description ; The Description property provides a textual description of the object. |
| | | | |
|