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 [CIMCoreCR006655]	CIMCoreCR01030
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, www.pwg.org
Alliance Partner vote history (e.g. SNIA XYZ Approved on 8/12/06)	n/a
Alliance Partner identifier/tracking number (if available)	CIMCoreCR_PrintInterlock_00.htm
Errata [Yes\|No]	No
Short Description	Add class CIM_PrintInterlock to enhanced printer device model.
Spec, Document or Model(s) Being Changed [Application\|Core\|Database\|Device\|Event\|Interop\| Network\|Physical\|Policy\|Support\|System\|User ]	Device
Spec, Document or Model Version Incorporating the Change [2.16.0 Experimental \| Final]	2.18 Experimental
Filename(s) Incorporating the Change [Core/CIM_Container.mof, DSP0204.pdf]	CIM_PrintInterlock.mof
Date Originated [mm/dd/yyyy]	10/12/2007
Date of Last Revision of the Change Request [mm/dd/yyyy]	10/12/2007
Dependencies [CIMCoreCR00555,CIMCoreCR00600,...]

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):

As part of the PWG/DMTF Work Register, PWG is updating the printing-related classes in the CIM data model. The PWG models for printing related devices and services include many properties that need to be managed but are not currently represented in CIM at all. The CIM model is being extended to include these important management objects. This requires extensions to the CIM_Printer class and the addition of other CIM classes to represent the capabilities, settings, and counters required.

Many early implementers of this class are expected to be proxy providers for SNMP-capable printers. A few properties in this class are included to permit software and users to correlate status and event information between CIM and legacy SNMP access paths. It is expected that such properties will be deprecated when they are no longer needed for this purpose.

The current new class, CIM_PrintInterlock, is one of the several classes to be added.

The class CIM_PrintInterlock represents covers and operational interlocks in a Printer device. If the operation of the device is impaired by opening a cover or tripping an interlock, by removing a toner cartridge for instance, then the status of the cover or interlock should change to reflect this condition.

The distinction between covers and interlocks is present for historical reasons: the existing Printer model distinguishes the two types of interlocks.

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 and/or references documents (other then MOF) if the changes are too lengthy to include inline):

// Add the new class CIM_PrintInterlock

MOF Changes (The complete CIM Class (ASCII) using blue text for new, red text for removed and black text for no change, only one CIM Class can be changed per CR):




// Copyright (c) 2007 DMTF.  All rights reserved.
// ==================================================================
// CIM_PrintInterlock
// ==================================================================

   [Experimental, Version ( "2.18.0" ),
       UMLPackagePath ( "CIM::Device::Printing" ), Description (
       "This class represents the PrintInterlock (cover, access panel, "
       "or other interlock) component of a Printer (print device). It "
       "contains properties that describe the PrintInterlock component "
       "and the component status. Note: A PrintInterlock shall be "
       "associated with exactly one Printer via an instance of the "
       "ConcreteComponent class. See: Model in section 2 of Printer "
       "MIB (RFC 3805)."), 
    MappingStrings { "MIB.IETF|Printer-MIB.prtCoverEntry" }]
class CIM_PrintInterlock : CIM_PrinterElement {

      [Description (
          "A free-form text description of this PrintInterlock (cover, "
          "access panel, or other interlock) in the localization "
          "specified by CIM_Printer.CurrentNaturalLanguage."), 
       MinLen ( 0 ), MaxLen ( 255 ), 
       MappingStrings { "MIB.IETF|Printer-MIB.prtCoverDescription",
          "MIB.IETF|Printer-MIB.PrtLocalizedDescriptionStringTC" }]
   string LocalizedDescription;

      [Description (
          "This property contains detailed status information for this "
          "PrintInterlock (cover, access panel, or other interlock), "
          "as follows: 1 (Other) means other detailed status "
          "information for this PrintInterlock is present in the "
          "OtherInterlockStatus property. 2 (Unknown) means detailed "
          "status information for this PrintInterlock is unknown. 3 "
          "(CoverOpen) means this PrintInterlock is a cover that is "
          "open (typically an exception condition). 4 (CoverClosed) "
          "means this PrintInterlock is a cover that is closed "
          "(typically a normal condition). 5 (InterlockOpen) means "
          "this PrintInterlock is an access panel or other interlock "
          "that is open (typically an exception condition). 6 "
          "(InterlockClosed) means this PrintInterlock is an access "
          "panel or other interlock that is closed (typically a normal "
          "condition)."), 
       ValueMap { "1", "2", "3", "4", "5", "6", ".." }, 
       Values { "Other", "Unknown", "CoverOpen", "CoverClosed",
          "InterlockOpen", "InterlockClosed", "DMTF Reserved" }, 
       MappingStrings { "MIB.IETF|Printer-MIB.prtCoverStatus",
          "MIB.IETF|IANA-PRINTER-MIB.PrtCoverStatusTC" }, 
       ModelCorrespondence { "CIM_ManagedSystemElement.DetailedStatus",
          "CIM_PrintInterlock.OtherInterlockStatus" }]
   uint32 InterlockStatus;

      [Description (
          "A free-form string that describes the detailed status of "
          "this PrintInterlock (cover, access panel, or other "
          "interlock) when the value of the InterlockStatus property "
          "is equal to 1 (Other)."), 
       MinLen ( 0 ), MaxLen ( 255 ), 
       ModelCorrespondence { "CIM_PrintInterlock.InterlockStatus" }]
   string OtherInterlockStatus;
};

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

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

Version	Date	Short description of changes
00	10/12/2007	Original version.
01	10/12/2007	Change target version to 2.18.

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)