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]	CIMCoreCR01180
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_ImagingMediaUsedStatisticalData_00.html
Errata [Yes\|No]	No
Short Description	Create class CIM_ImagingMediaUsedStatisticalData
Spec, Document or Model(s) Being Changed [Application\|Core\|Database\|Device\|Event\|Interop\| Network\|Physical\|Policy\|Support\|System\|User ]	Core
Spec, Document or Model Version Incorporating the Change [2.16.0 Experimental \| Final]	2.20 Experimental
Filename(s) Incorporating the Change [Core/CIM_Container.mof, DSP0204.pdf]	Core/CIM_ImagingMediaUsedStatisticalData.mof
Date Originated [mm/dd/yyyy]	08/13/2008
Date of Last Revision of the Change Request [mm/dd/yyyy]	09/18/2008
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):

The concrete class CIM_ImagingMediaUsedStatisticalData defines media used (for accounting and billing) counters for imaging devices, services, jobs, and systems.

The structure and properties of this family of classes derive directly from the Imaging State and Counter MIB, PWG Candidate Standard 5106.3-2008. Early implementations are expected to be SNMP proxy providers using this MIB.

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

// Create the class CIM_ImagingMediaUsedStatisticalData.

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) 2008 DMTF.  All rights reserved.
// ==================================================================
// CIM_ImagingMediaUsedStatisticalData
// ==================================================================
   [Experimental, Version ( "2.20.0" ),
       UMLPackagePath ( "CIM::Core::Statistics" ), Description (
       "This class defines media used (for accounting and billing) "
       "ImagingStatisticalData associated with an imaging system "
       "(e.g., ComputerSystem), imaging service (e.g., PrintService), "
       "imaging device (e.g., Printer), imaging job (e.g., PrintJob), "
       "or any other imaging element. \n"
       "See: Section 4 Overview in PWG Counter MIB v2 (PWG 5106.3).")]

class CIM_ImagingMediaUsedStatisticalData : CIM_ImagingStatisticalData {

      [Description (
          "A unique value used by the scoping imaging element (e.g., "
          "PrintService) to identify this instance of specific media. "
          "Note: This property is necessary to correlate counter and "
          "event information between CIM and SNMP interfaces."), 
       MinValue ( 1 ), MaxValue ( 2147483647 ), 
       MappingStrings { 
          "MIB.PWG|PWG-IMAGING-COUNTER-MIB.icMediaUsedIndex" }]
   uint32 SNMPRowId;

      [Description (
          "Total sheets of this specific media printed by this managed "
          "element (e.g., PrintService or PrintMarker)."), 
       MappingStrings { 
          "MIB.PWG|PWG-IMAGING-COUNTER-MIB.icMediaUsedTotalSheets" }]
   uint32 TotalSheets;

      [Description (
          "Monochrome sheets of this specific media printed by this "
          "managed element (e.g., PrintService or PrintMarker)."), 
       MappingStrings { 
          "MIB.PWG|PWG-IMAGING-COUNTER-MIB.icMediaUsedMonochromeSheets" 
          }]
   uint32 MonochromeSheets;


      [Description (
          "Blank sheets of this specific media printed by this managed "
          "element (e.g., PrintService or PrintMarker)."), 
       MappingStrings { 
          "MIB.PWG|PWG-IMAGING-COUNTER-MIB.icMediaUsedBlankSheets" }]
   uint32 BlankSheets;

      [Description (
          "Full color sheets of this specific media printed by this "
          "managed element (e.g., PrintService or PrintMarker)."), 
       MappingStrings { 
          "MIB.PWG|PWG-IMAGING-COUNTER-MIB.icMediaUsedFullColorSheets" 
          }]
   uint32 FullColorSheets;

      [Description (
          "Highlight color sheets of this specific media printed by "
          "this managed element (e.g., PrintService or PrintMarker)."), 
       MappingStrings { 
          "MIB.PWG|PWG-IMAGING-COUNTER-MIB.icMediaUsedHighlightColorSheets" 
          }]
   uint32 HighlightColorSheets;

      [Description (
          "The media size self-describing name for this specific "
          "media, for use with remote network management scripts and "
          "GUIs, specified as a visible US-ASCII string (ANSI "
          "X.3-1968) that shall not contain any US-ASCII control "
          "characters (0x00 to 0x1F inclusive, or 0x7F). This media "
          "size name shall not be localized. For example: "
          "na_letter_8.5x11in."), 
       MinLen ( 0 ), MaxLen ( 255 ), 
       MappingStrings { 
          "MIB.PWG|PWG-IMAGING-COUNTER-MIB.icMediaUsedMediaSizeName" }]
   string MediaSizeName;

      [Description (
          "The localized description of this specific media, for use "
          "with remote network management scripts and GUIs, specified "
          "as a Unicode string in the locale of the scoping managed "
          "element (e.g., CIM_Printer.CurrentNaturalLanguage). For "
          "example: Light blue deckle-edge letter stock. This media "
          "description should clearly distinguish different instances "
          "of the same media size (for example, by including specific "
          "media color, weight, etc.)."), 
       MinLen ( 0 ), MaxLen ( 255 ), 
       MappingStrings { 
          "MIB.PWG|PWG-IMAGING-COUNTER-MIB.icMediaUsedMediaInfo" }]
   string MediaInfo;

      [Description (
          "The friendly locally unique name for this specific media, "
          "for use with remote network management scripts and GUIs, "
          "specified as a Unicode string. This locally unique media "
          "name may be specified in any natural language, but shall "
          "not be localized. For example: customer-reply or "
          "na-letter-colored. \n"
          "Note: PWG Media Standardized Names (PWG 5101.1) restricts "
          "even custom media names to use US-ASCII strings (ANSI "
          "X.3-1968), although they may be specified in any natural "
          "language that can be represented in or transliterated into "
          "a US-ASCII string. On the other hand, IPP/1.1 (RFC 2911) "
          "and Job Mon MIB (RFC 2707) allow custom media names to use "
          "UTF-8 strings (RFC 3629)."), 
       MinLen ( 0 ), MaxLen ( 255 ), 
       MappingStrings { 
          "MIB.PWG|PWG-IMAGING-COUNTER-MIB.icMediaUsedMediaName" }]
   string MediaName;

      [Description (
          "The locally unique accounting key for this specific media, "
          "for use with remote accounting systems, network management "
          "systems, fleet management based on SLAs (service level "
          "agreements), etc., specified as a visible US-ASCII string "
          "(ANSI X.3-1968) that shall not contain any US-ASCII control "
          "characters (0x00 to 0x1F inclusive, or 0x7F). This locally "
          "unique media accounting key may be specified in any natural "
          "language that can be represented in or transliterated into "
          "US-ASCII, but shall not be localized. \n"
          "This media accounting key should conform to the ABNF in "
          "Appendix A Media Accounting Key Format of PWG 5106.3 for "
          "interoperability. \n"
          "This media accounting key may contain characters not "
          "permitted in IPP keyword or name datatypes, unlike the "
          "corresponding (but more restricted) IPP media-key attribute "
          "defined in IPP Production Printing Set1 (IEEE/ISTO PWG "
          "5100.3)."), 
       MinLen ( 0 ), MaxLen ( 255 ), 
       MappingStrings { 
          "MIB.PWG|PWG-IMAGING-COUNTER-MIB.icMediaUsedMediaAccountingKey" 
          }]
   string MediaAccountingKey;
};

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
000	08/13/2008	Original version.
001	09/18/2008	Corrected MappingStrings from IETF to PWG. Updated schema version number.

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)