.
Document Number: XMP1000
Date: 2011-08-31
Version: 1.0.0a
Development Version: 0.1.0
Development Edit Date: 2011-08-31
MRP Template Profile
Document Type: Specification
Document Status: In Development
Document Language: en-US
DMTF is a not-for-profit association of industry members dedicated to promoting enterprise and systems management and interoperability. Members and non-members may reproduce DMTF specifications and documents, provided that correct attribution is given. As DMTF specifications may be revised from time to time, the particular version and release date should always be noted.
Implementation of certain elements of this standard or proposed standard may be subject to third party patent rights, including provisional patent rights (herein "patent rights"). DMTF makes no representations to users of the standard as to the existence of such rights, and is not responsible to recognize, disclose, or identify any or all such third party patent right, owners or claimants, nor for any incomplete or inaccurate identification or disclosure of such rights, owners or claimants. DMTF shall have no liability to any party, in any manner or circumstance, under any legal theory whatsoever, for failure to recognize, disclose, or identify any such third party patent rights, or for such party’s reliance on the standard or incorporation thereof in its product, protocols or testing procedures. DMTF shall have no liability to any party implementing such standard, whether such implementation is foreseeable or not, nor to any patent owner or claimant, and shall have no liability or responsibility for costs or losses incurred if a standard is withdrawn or modified after publication, and shall be indemnified and held harmless by any party implementing the standard from any and all claims of infringement by a patent owner for such implementations.
For information about patents held by third-parties which have notified the DMTF that, in their opinion, such patent may relate to or impact implementations of DMTF standards, visit http://www.dmtf.org/about/policies/disclosures.php.
DMTF is a not-for-profit association of industry members dedicated to promoting enterprise and systems management and interoperability. For information about the DMTF, see http://www.dmtf.org.
{This document defines the usage of CIM classes used to represent and manage ... } The information in this document is intended to be sufficient for a provider or consumer of this data to identify unambiguously the classes, properties, methods, and values that need to be instantiated and manipulated.
The target audience for this specification is implementers who are writing CIM-based providers or consumers of management interfaces that represent the components described in this document.
The following typographical conventions are used in this document:
Constraints in this document are specified using OCL (see OCL 2.0).
OCL statements are in monospaced font.
{The Xyz profile extends the management capabilities of referencing profiles by adding ...}
DMTF DSP0004, CIM Infrastructure Specification 2.6,
http://www.dmtf.org/standards/published_documents/DSP0004_2.6.pdf
DMTF DSP0223, Generic Operations 1.0,
http://www.dmtf.org/standards/published_documents/DSP0223_1.0.pdf
DMTF DSP1001, Management Profile Specification Usage Guide 1.1,
http://www.dmtf.org/standards/published_documents/DSP1001_1.1.pdf
DMTF DSP1033, Profile Registration Profile 1.1,
http://schemas.dmtf.org/wbem/mgmtprofile/dsp1033_1.1.mrp.xml
OMG formal/06-05-01, Object Constraint Language 2.0,
http://www.omg.org/spec/OCL/2.0/
ISO/IEC Directives, Part 2, Rules for the structure and drafting of International Standards,
http://isotc.iso.org/livelink/livelink?func=ll&objId=4230456&objAction=browse&sort=subtype
The following additional terms are defined in this document.
network port
The abbreviations defined in DSP0004, DSP0223, and DSP1001 apply to this document.
This document does not define any additional abbreviations.
Profile name: MRP Template
Version: 1.0.0
Organization: DMTF
Abstract indicator: False
Profile type: Component
Schema: DMTF CIM 2.22
Central class adaptation: NetworkPort
Scoping class adaptation: ComputerSystem
Scoping path: SystemDevice
{The Xyz profile extends the management capabilities of referencing profiles by ...}
The following table identifies the profile references defined in this profile.
Profile reference name | Profile name | Organization | Version | Relationship | Description |
---|---|---|---|---|---|
ProfileRegistration | Profile Registration | DMTF | 1.0 | Mandatory | Used to represent the version of this profile that is implemented. |
The following table identifies the features defined in this profile.
Feature | Requirement | Description |
---|---|---|
NetworkPortStateManagement | Optional | See subclause "Feature: NetworkPortStateManagement". |
The following table identifies the class adaptations defined in this profile.
Adaptation | Elements | Requirement | Description |
---|---|---|---|
Instantiated, embedded and abstract adaptations | |||
RegisteredProfile | CIM_RegisteredProfile | Mandatory | See subclause "Adaptation: RegisteredProfile". |
ComputerSystem | CIM_ComputerSystem | Mandatory | See subclause "Adaptation: ComputerSystem". |
SystemDevice | CIM_SystemDevice | Mandatory | See subclause "Adaptation: SystemDevice". |
NetworkPort | CIM_NetworkPort | Mandatory | See subclause "Adaptation: NetworkPort". |
Indications and exceptions | |||
This profile does not define any such adaptations. |
The following table identifies the use cases and state descriptions defined in this profile.
Name | Description |
---|---|
State description SimpleObjectDiagram | See subclause "State description: SimpleObjectDiagram". |
The following DMTF collaboration structure diagram show all class adaptations defined in this profile, and all profiles referenced by this profile.
Description of the diagram ...
Implementing this feature provides support for client management of the state of a network port by means of the RequestStateChange( ) method.
The requirement level for this feature is optional.
This feature can be made available to clients at the granularity of NetworkPort instances.
It can be concluded that the feature is available for a NetworkPort instance if:
The following OCL derivation constraint evaluates to a Boolean value of True.
OCL context: A NetworkPort instance.
derive: self.ElementCapabilities::Capabilities. RequestedStatesSupported->notEmpty() |
Otherwise, it can be concluded that the feature is not available.
The following profile elements are conditional or conditional exclusive on the implementation of this feature:
This profile defines operation requirements based on DSP0223.
For adaptations of ordinary classes and of associations the requirements for operations are defined in adaptation-specific subclauses of the "Adaptations" clause.
For association traversal operation requirements that are specified only in the elements table of an adaptation (i.e. without operation-specific subclauses), the names of the association adaptations to be traversed are listed in the elements table.
The default initialization requirement level for property requirements is optional.
The default modification requirement level for property requirements is optional.
This profile repeats the effective values of certain Boolean qualifiers as part of property, method parameter, or method return value requirements. The following convention is established: If the name of a qualifier is listed, its effective value is True; if the qualifier name is not listed, its effective value is False. The convention is applied in the following cases:
The implementation type of this adaptation is instantiated ordinary adaptation.
The requirement level for this adaptation is mandatory.
The following table identifies the element requirements for this adaptation.
Element | Requirement | Description |
---|---|---|
Base adaptations | ||
ProfileRegistration::RegisteredProfile | Optional | See ProfileRegistration::RegisteredProfile. |
Properties | ||
RegisteredName | Mandatory | Required, see subclause "Property: RegisteredName". |
RegisteredOrganization | Mandatory | Required, see subclause "Property: RegisteredOrganization". |
RegisteredVersion | Mandatory | Required, see subclause "Property: RegisteredVersion". |
The presentation requirement level for this property is mandatory.
The implementation shall satisfy the following constraint for this property:
OCL constraint with context of a RegisteredProfile instance:
inv: self.RegisteredName = 'MRP Template' |
The presentation requirement level for this property is mandatory.
The implementation shall satisfy the following constraint for this property:
OCL constraint with context of a RegisteredProfile instance:
inv: self.RegisteredOrganization = 2 /* DMTF */ |
The presentation requirement level for this property is mandatory.
The implementation shall satisfy the following constraint for this property:
OCL constraint with context of a RegisteredProfile instance:
inv: self.RegisteredVersion = '1.0.0' |
The implementation type of this adaptation is instantiated ordinary adaptation.
The requirement level for this adaptation is mandatory.
The following table identifies the element requirements for this adaptation.
Element | Requirement | Description |
---|---|---|
Base adaptations | ||
ProfileRegistration::ScopingElement | Optional | See ProfileRegistration::ScopingElement. |
Operations | ||
GetAssociatedInstancesWithPath( ) for SystemDevice | Mandatory | See DSP0223. |
GetAssociatedInstancePaths( ) for SystemDevice | Mandatory | See DSP0223. |
GetReferencingInstancesWithPath( ) for SystemDevice | Mandatory | See DSP0223. |
GetReferencingInstancePaths( ) for SystemDevice | Mandatory | See DSP0223. |
The implementation type of this adaptation is instantiated association adaptation.
The requirement level for this adaptation is mandatory.
The following table identifies the element requirements for this adaptation.
Element | Requirement | Description |
---|---|---|
Properties | ||
GroupComponent | Mandatory | Key, see subclause "Property: GroupComponent". |
PartComponent | Mandatory | Key, see subclause "Property: PartComponent". |
Operations | ||
GetInstance( ) | Mandatory | See DSP0223. |
The presentation requirement level for this property is mandatory.
The implementation shall satisfy the following constraints for this reference property:
The presentation requirement level for this property is mandatory.
The implementation shall satisfy the following constraints for this reference property:
The implementation type of this adaptation is instantiated ordinary adaptation.
The requirement level for this adaptation is mandatory.
The following table identifies the element requirements for this adaptation.
Element | Requirement | Description |
---|---|---|
Properties | ||
SystemCreationClassName | Mandatory | Key, see schema definition. |
SystemName | Mandatory | Key, see schema definition. |
CreationClassName | Mandatory | Key, see schema definition. |
DeviceID | Mandatory | Key, see schema definition. |
EnabledState | Mandatory | See schema definition. |
RequestedState | Mandatory | See schema definition. |
Methods | ||
RequestStateChange( ) | Conditional | See subclause "Method: RequestStateChange( )". |
Operations | ||
GetInstance( ) | Mandatory | See DSP0223. |
GetClassInstancesWithPath( ) | Mandatory | See DSP0223. |
GetClassInstancePaths( ) | Mandatory | See DSP0223. |
GetAssociatedInstancesWithPath( ) for SystemDevice | Mandatory | See DSP0223. |
GetAssociatedInstancePaths( ) for SystemDevice | Mandatory | See DSP0223. |
GetReferencingInstancesWithPath( ) for SystemDevice | Optional | See DSP0223. |
GetReferencingInstancePaths( ) for SystemDevice | Optional | See DSP0223. |
The requirement level for this method is conditional, with the following condition:
Successful execution of this method on an instance of this adaptation shall change the instance's state to the value specified in the RequestedState parameter.
Invoking this method multiple times may result in earlier requests being overwritten or lost.
The implementation shall satisfy the following constraints for this method:
OCL constraint with context of a NetworkPort instance:
pre: self.ElementCapabilities::Capabilities. RequestedStatesSupported->contains(RequestedState) |
OCL constraint with context of a NetworkPort instance:
post: self.RequestedState = RequestedState |
The following table identifies the parameter and return value requirements of the method.
Parameter | Description |
---|---|
RequestedState | In, see schema definition. |
ReturnValue | See subclause "Return value". |
The following figure shows a simple object diagram that represents ...
Version | Date | Description |
---|---|---|
1.0.0a | 2011-08-31 | Released as a Work in Progress |