DMTF Change Request

DMTF Confidential

All changes to be submitted by the Working Group Chair (or designee) after approval by the working group.  

The Change Request sample (http://www.dmtf.org/members/zdata/CRTemplateSample.html) contains more detailed
information on how to complete the template.

DMTF Change Request Number   [sysdevCR006655]

CIMCoreCR00931

CR Owner Name, Email  [My Name, my.name@company.com]

Richard Landau, Richard_Landau@dell.com

Alliance Partner submitting CR request (if applicable)

Printer Working Group pwg.org

Alliance Partner vote history (e.g. SNIA XYZ Approved on 8/12/06)

 

Alliance Partner identifier/tracking number (if available)

n/a

Errata   [Yes/No]

No

Short Description

Add new value "Transitioning" to MSE.OperatingStatus

Spec, Document or Model(s) Being Changed   [Device Model]

[Core Model]

Spec, Document or Model Version Incorporating the Change  [V2.9 Final]

V2.16 Experimental

Filename(s) Incorporating the Change [Device_USB.mof]

CIM_ManagedSystemElement.mof

Date Originated  [mm/dd/yyyy]

05/02/2007

Date of Last Revision of the Change Request [mm/dd/yyyy]

05/11/2007

Dependencies   [smwgCR00567,sysdevCR00555]

CIMCoreCR00874

Terminology

The terminology used in this CR should conform to the "Rules for the structure and drafting of International Standards", 5th Edition, 2005 available at:

http://isotc.iso.org/livelink/livelink.exe/fetch/2000/2122/3146825/4229629/4230450/4230456/ISO_IEC_Directives__Part_2__Rules_for_the_structure_and_drafting_of_International_Standards__2004__5th_edition___pdf_format_.pdf?nodeid=4230517&vernum=0

Particular attention shall be paid to Annex H which lays out guidelines for the expression of provisions.

Background/Rationale (Explanation of the background and reason(s) for the requested change, and supporting documentation):

Add a value "Transitioning" to the OperatingStatus property to indicate that the element is transitioning from one state or status to another. 

 

Alliance Partner Status (tracking number, other key identifiers,  supporting documentation, etc.):

(insert text here)

Requested Change (Change information such as details before/after the change, readable/indented MOF, and/or references to "Uploaded" MOF and other documents if the changes are too lengthy to include inline):

 

   [Abstract, Version ( "2.1116.0" ),

       UMLPackagePath ( "CIM::Core::CoreElements" ), Description (

       "CIM_ManagedSystemElement is the base class for the System "

       "Element hierarchy. Any distinguishable component of a System "

       "is a candidate for inclusion in this class. Examples of system "

       "components include: \n"

       "- software components such as application servers, databases, "

       "and applications \n"

       "- operating system components such as files, processes, and "

       "threads \n"

       "- device components such as disk drives, controllers, "

       "processors, and printers \n"

       "- physical components such as chips and cards.")]

   class CIM_ManagedSystemElement : CIM_ManagedElement {

 

 

       [Experimental, Description (
          "OperatingStatus provides a current status value for the "
          "operational condition of the element and can be used for "
          "providing more detail with respect to the value of EnabledState. "
          "It can also provide the transitional states when an element "
          "is transitioning from one state to another, such as when an element "
          "is transitioning between EnabledState and RequestedState, as well as "
          "other transitional conditions.\n"
          "OperatingStatus consists of one of the following "
          "values:  Unknown, Not Available, In Service, Starting, Stopping, "
          "Stopped, Aborted, Dormant, Completed, Migrating, Emmigrating, "
          "Immigrating, Snapshotting. Shutting Down, In Test \n"
       "A Null return indicates the implementation (provider) does not "
          "implement this property. \n"
            "\"Unknown\" indicates the implementation is in general capable of "
          "returning this property, but is unable to do so at this time. \n"
           "\"None\" indicates that the implementation (provider) is capable "
          "of returning a value for this property, but not ever for this particular "
          "piece of hardware/software or the property is intentionally not used "
          "because it adds no meaningful information (as in the case of a property "
            "that is intended to add additional info to another property). \n"
          "\"In Service\" describes an element being configured, "
          "maintained, cleaned, or otherwise administered. \n"
          "\"Starting\" describes an element being initialized. \n"
          "\"Stopping\" describes an element being brought to an orderly stop. \n"
          "\"Stopped\" and \"Aborted\" are similar, although the "
          "former implies a clean and orderly stop, while the latter "
          "implies an abrupt stop where the state and configuration of "
          "the element might need to be updated. \n"
          "\"Dormant\" indicates that the element is inactive or "
          "quiesced. \n"  
          "\"Completed\" indicates that the element has completed its "
          "operation. This value should be combined with either OK, "
          "Error, or Degraded in the PrimaryStatus so that a client can "
          "tell if the complete operation Completed with OK (passed), "
          "Completed with Error (failed), or Completed with Degraded (the "
          "operation finished, but it did not complete OK or did not "
          "report an error). \n"
          "\"Migrating\" element is being moved between host elements. \n"
          "\"Immigrating\" element is being moved to new host element. \n"
          "\"Emigrating\" element is being moved away from host element. \n"
          "\"Shutting Down\" describes an element being brought to an abrupt stop. \n"
          "\"In Test\" element is performing test functions. \n"),
        ValueMap { "0", "1", "2", "3", "4", "5", "6", "7", "8", "9", 
                  "10", "11", "12", "13", "14", "15", "..", "0x8000.." }, 
         Values { "Unknown", "Not Available", "In Service", "Starting", 
            "Stopping", "Stopped", "Aborted", "Dormant", "Completed", 
            "Migrating", "Emigrating", "Immigrating", "Snapshotting",
            "Shutting Down", "In Test", "Transitioning", DMTF Reserved", 
            "Vendor Reserved" },
        ModelCorrespondence {"CIM_EnabledLogicalElement.EnabledState"}]
   uint16 OperatingStatus;
 
 

 

Discussion Points (Summary of decisions and discussions of the WG in creating this CR) :

(insert text here)

Change History (Mandatory after submission to the TC, May be used by the WGs):

Version

Date 

Short description of changes

 0.1

 2007/05/11

  Original version.

 0.2

 

 

Note that this document is labeled as "DMTF Confidential".  It is intended only for DMTF member companies and alliance partners.
This Change Request may be withdrawn or modified by subsequent Change Requests.

All submissions MUST comply with the DMTF Patent and Technology policy (http://www.dmtf.org/about/policies/patent-10-18-01.pdf)

Template Sample Version 2.0.0.d