Document Number: XMP1000

Date: 2013-08-09

Version: 1.1.0a

Development Version: 1.1.0

Development Edit Date: 2013-08-09

MRP Template Profile

Document Type: Specification

Document Status: In Development

Document Language: en-US

## Copyright notice

Copyright © 2011 Distributed Management Task Force, Inc. (DMTF). All rights reserved.

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.

# CONTENTS

## Figures

[Insert table of figures here ...]

## Tables

[Insert table of tables here ...]

# Foreword

This document was prepared by the DMTF {Xyz} Working Group

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.

## Acknowledgements

DMTF acknowledges the following individuals for their contributions to this document:

- Joe Smith, ACME (editor)

# Introduction

{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.

## Document conventions

### Typographical conventions

The following typographical conventions are used in this document:

- Document titles are marked in italics.
- Important terms that are used for the first time are marked in italics.
- Terms include a link to the term definition in the "Terms and definitions" clause, enabling easy navigation to the term definition.

### OCL usage conventions

Constraints in this document are specified using OCL (see OCL 2.0).

OCL statements are in monospaced font.

# MRP Template Profile

# Scope

{The Xyz profile extends the management capabilities of referencing profiles by adding ...}

# Normative references

The following referenced documents are indispensable for the application of this document. For dated or versioned references, only the edition cited (including any corrigenda or DMTF update versions) applies. For references without a date or version, the latest published edition of the referenced document (including any corrigenda or DMTF update versions) applies.

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

# Terms and definitions

In this document, some terms have a specific meaning beyond the normal English meaning. Those terms are defined in this clause.

## General

The terms "shall" ("required"), "shall not", "should" ("recommended"), "should not" ("not recommended"), "may", "need not" ("not required"), "can" and "cannot" in this document are to be interpreted as described in ISO/IEC Directives, Part2, Annex H. The terms in parenthesis are alternatives for the preceding term, for use in exceptional cases when the preceding term cannot be used for linguistic reasons. Note that ISO/IEC Directives, Part2, Annex H specifies additional alternatives. Occurrences of such additional alternatives shall be interpreted in their normal English meaning in this document.

The terms "clause", "subclause", "paragraph", "annex" in this document are to be interpreted as described in ISO/IEC Directives, Part2, Clause 5.

The terms "normative" and "informative" in this document are to be interpreted as described in ISO/IEC Directives, Part2, Clause 3. In this document, clauses, subclauses or annexes indicated with "(informative)" as well as notes and examples do not contain normative content.

The terms defined in DSP0004, DSP0223, and DSP1001 apply to this document.

The following additional terms are defined in this document.

##

network port

A network port ...

# Symbols and abbreviated terms

The abbreviations defined in DSP0004, DSP0223, and DSP1001 apply to this document.

This document does not define any additional abbreviations.

# Synopsis

Profile name: MRP Template

Version: 1.1.0

Organization: DMTF

Abstract: No

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 ...}

identifies the profile references defined in this profile.

Profile references
Profile reference name | Profile name | Organi-​zation | Version | Relation-​ship | Description
--- | --- | --- | --- | --- | ---
ProfileRegistration | Profile Registration | DMTF | 1.0 | Mandatory | Used to represent the version of this profile that is implemented.

identifies the features defined in this profile.

Features
Feature | Requirement | Description
--- | --- | ---
NetworkPortStateManagement | Optional | See subclause "Feature: NetworkPortStateManagement".

identifies the class adaptations defined in this profile.

Adaptations
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.

identifies the use cases and state descriptions defined in this profile.

Use cases and state descriptions
Name | Description
--- | ---
State description: SimpleObjectDiagram | See subclause "State description: SimpleObjectDiagram".

# Description

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 ...

# Implementation

## Features

### Feature: NetworkPortStateManagement

Requirement level: Optional

Implementing this feature provides support for client management of the state of a network port by means of the RequestStateChange( ) method.

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.

## Adaptations

### Conventions

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 subclause Adaptations.

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:

- In: indicates that the parameter is an input parameter
- Out: indicates that the parameter is an output parameter
- Key: indicates that the property is a key (that is, its value is part of the instance path)
- Required: indicates that the element value shall be non-Null
- Null OK: indicates explicitly that the element value may be Null for mandatory, conditional or conditional exclusive properties. This information is not specified as a qualifier in the schema but as an indicator in the profile.

### Adaptation: RegisteredProfile: CIM_RegisteredProfile

#### General

Adaptation type: Ordinary class

Implementation type: Instantiated

Requirement level: Mandatory

This adaptation models the version of this profile that was implemented.

RegisteredProfile: Element requirements
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"

#### Property: RegisteredName

Requirement level: Mandatory

Constraint:

OCL constraint in the context of a RegisteredProfile instance:

    inv: self.RegisteredName = 'MRP Template'

#### Property: RegisteredOrganization

Requirement level: Mandatory

Constraint:

OCL constraint in the context of a RegisteredProfile instance:

    inv: self.RegisteredOrganization = 2 /* DMTF */

#### Property: RegisteredVersion

Requirement level: Mandatory

Constraint:

OCL constraint in the context of a RegisteredProfile instance:

    inv: self.RegisteredVersion = '1.0.0'

### Adaptation: ComputerSystem: CIM_ComputerSystem

This adaptation models systems hosting network ports .

Adaptation type: Ordinary class

Implementation type: Instantiated

Requirement level: Mandatory

ComputerSystem: Element requirements
Element | Requirement | Description
--- | --- | ---
Base adaptations
ProfileRegistration::ScopingElement | Optional | See ProfileRegistration::ScopingElement.
Operations
Associators( ) | Mandatory |
AssociatorNames( ) | Mandatory |
References( ) | Mandatory |
ReferenceNames( ) | Mandatory |

### Adaptation: SystemDevice: CIM_SystemDevice

#### General

Adaptation type: Association class

Implementation type: Instantiated

Requirement level: Mandatory

This adaptation models the relationship between netwpork ports that are represented by NetworkPort instances and the systems hosting these network ports that are represented by ComputerSystem instances.

SystemDevice: Element requirements
Element | Requirement | Description
--- | --- | ---
Properties
GroupComponent | Mandatory | Key, see subclause "Property: GroupComponent"
PartComponent | Mandatory | Key, see subclause "Property: PartComponent"
Operations
GetInstance( ) | Mandatory |

#### Property: GroupComponent

Requirement level: Mandatory

Reference kind: REF-typed

Constraints:

- Referenced instances shall be of class adaptation ComputerSystem.
- The multiplicity of this association end is 1 .. 1

#### Property: PartComponent

Requirement level: Mandatory

Reference kind: REF-typed

Constraints:

- Referenced instances shall be of class adaptation NetworkPort.
- The multiplicity of this association end is 0 .. *

### Adaptation: NetworkPort: CIM_NetworkPort

#### General

Adaptation type: Ordinary class

Implementation type: Instantiated

Requirement level: Mandatory

This adaptation models network ports .

NetworkPort: Element requirements
Element | Requirement | Description
--- | --- | ---
Properties
SystemCreationClassName | Mandatory | Key
SystemName | Mandatory | Key
CreationClassName | Mandatory | Key
DeviceID | Mandatory | Key
EnabledState | Mandatory |
RequestedState | Mandatory |
Methods
RequestStateChange( ) | Conditional | See subclause "Method: RequestStateChange( )"
Operations
GetInstance( ) | Mandatory |
EnumerateInstances( ) | Mandatory |
EnumerateInstanceNames( ) | Mandatory |
Associators( ) | Mandatory |
AssociatorNames( ) | Mandatory |
References( ) | Optional |
ReferenceNames( ) | Optional |

#### Method: RequestStateChange( )

Requirement level: Conditional

Condition:

The NetworkPortStateManagement feature is implemented.
Only if the NetworkPortStateManagement feature is implemented for an instance of this adaptation, this method shall be implemented and shall not return a value of 1 (Not Supported).

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.

Constraints:

- OCL constraint in the context of a NetworkPort instance:

      pre: self.ElementCapabilities::Capabilities.
          RequestedStatesSupported->contains(RequestedState)

- OCL constraint in the context of a NetworkPort instance:

      post: self.RequestedState = RequestedState

RequestStateChange( ): Parameter requirements
Parameter | Description
--- | ---
RequestedState | In
Return value | ...

##### Return value

...

# Use cases and state descriptions

## State description: SimpleObjectDiagram

The following figure shows a simple object diagram that represents ...

#
(informative)
Change log

Version | Date | Description
--- | --- | ---
1.1.0a | 2013-08-09 | Released as a Work in Progress

Internal Error: The tocgen.js script failed (or did not run at all).