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]

 CIMCoreCR00901

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 class  CIM_PrintOutputTray to enhanced printer device model.

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

 [Core Model]

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

 V2.15 Experimental

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

CIM_PrintOutputTray.mof

Date Originated  [mm/dd/yyyy]

 02/07/2007

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

 02/08/2007

Dependencies   [smwgCR00567,sysdevCR00555]

 n/a

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 dated 2005/05/12, the Printer Working Group (PWG, see http://www.pwg.org/) is updating the printing-related classes in the CIM data model.  PWG is submitting a series of Change Requests to update the CIM model to align with the current model developed in the PWG. 

 

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.  If these properties are to be visible to CIM-based management applications, then they must appear in the CIM model. 

 

The current PWG printer device model, as embodied in the SNMP Printer MIB v2, RFC3805, contains many properties Some examples:

•        Printer console displays and lights, and cover and other interlocks

•        Printer input and output trays containing media

•        Printer media paths that control the layout of page images on physical sheets

•        Printer toners, colorants, and other supplies

•        Printer communication channels and language interpreters

•        Printer counters for pages and sheets printed in various operational modes

 

The CIM model will be extended to include these important management objects.  This will require extensions to the CIM_Printer class and the addition of other CIM classes to represent the capabilities, settings, and counters required. 

 

The current new class, CIM_PrintOutputTray, is the first of several classes to be added. 

 

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

//add the new class CIM_PrintOutputTray as CIM_PrintOutputTray.mof

 

 

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

// ==================================================================

// CIM_PrintOutputTray

// ==================================================================

 

   [Experimental, Version ( "2.15.0" ), Description (

       "Subunit: Output tray on a printer (print device). Properties "

       "of a device capable of receiving media delivered from the "

       "printing process.") ,

    UMLPackagePath ( "CIM::Device::Printing" )]

class CIM_PrintOutputTray : CIM_ManagedElement {

 

      [Description (

          "A unique value used by this printer to identify this output "

          "subunit. Although these values may change due to a major "

          "reconfiguration of the subunit (e.g., the addition of new "

          "output devices to the printer), values SHOULD remain stable "

          "across successive printer power cycles."),

       MinValue ( 1 ), MaxValue ( 65535 ),

       MappingStrings { "MIB.IETF|Printer-MIB.prtOutputIndex" }]

   uint32 Id;

 

      [Description (

          "The type of technology supported by this output tray "

          "subunit."),

       ValueMap { "1",

          // Other

          "2",

          // Unknown

          "3",

          // RemovableBin

          "4",

          // UnRemovableBin

          "5",

          // ContinuousRollDevice

          "6",

          // MailBox

          "7" },

       Values { "Other",

          // 1

          "Unknown",

          // 2

          "RemovableBin",

          // 3

          "UnRemovableBin",

          // 4

          "ContinuousRollDevice",

          // 5

          "MailBox",

          // 6

          "ContinuousFanFold" },

       MappingStrings { "MIB.IETF|Printer-MIB.prtOutputType",

          "MIB.IETF|IANA-PRINTER-MIB.PrtOutputTypeTC" }]

   uint32 OutputType;

 

      [Description (

          "The unit of measurement for use in calculating and relaying "

          "capacity values for this output tray subunit."),

       ValueMap { "1",

          // Other

          "2",

          // Unknown

          "3",

          // TenThousandthsOfInches

          "4",

          // Micrometers

          "8",

          // Sheets

          "16",

          // Feet

          "17",

          // Meters

          "18",

          // Items

          "19" },

       Values { "Other",

          // 1

          "Unknown",

          // 2

          "TenThousandthsOfInches",

          // 3

          "Micrometers",

          // 4

          "Sheets",

          // 8

          "Feet",

          // 16

          "Meters",

          // 17

          "Items",

          // 18

          "Percent" },

       MappingStrings { "MIB.IETF|Printer-MIB.prtOutputCapacityUnit",

          "MIB.IETF|Printer-MIB.PrtCapacityUnitTC" }]

   uint32 CapacityUnit;

 

      [Write, Description (

          "The maximum capacity of this output tray subunit. There is "

          "no convention associated with the media itself so this "

          "value essentially reflects claimed capacity. If this output "

          "tray subunit can reliably sense this value, the value is "

          "sensed by the printer and may not be changed by management "

          "requests; otherwise, the value may be written (by a Remote "

          "Control Panel or a Management Application). The value (-1) "

          "means other and specifically indicates that the subunit "

          "places no restrictions on this parameter. The value (-2) "

          "means unknown."),

       MinValue ( -2 ), MaxValue ( 2147483647 ),

       MappingStrings { "MIB.IETF|Printer-MIB.prtOutputMaxCapacity",

          "MIB.IETF|Printer-MIB.prtOutputCapacityUnit",

          "MIB.IETF|Printer-MIB.PrtCapacityUnitTC" }]

   sint32 MaxCapacity;

 

      [Write, Description (

          "The remaining capacity of this output tray subunit. If this "

          "output tray subunit can reliably sense this value, the "

          "value is sensed by the printer and may not be modified by "

          "management requests; otherwise, the value may be written "

          "(by a Remote Control Panel or a Management Application). "

          "The value (-1) means other and specifically indicates that "

          "the subunit places no restrictions on this parameter. The "

          "value (-2) means unknown. The value (-3) means that the "

          "printer knows that there remains capacity for at least one "

          "unit."),

       MinValue ( -3 ), MaxValue ( 2147483647 ),

       MappingStrings {

          "MIB.IETF|Printer-MIB.prtOutputRemainingCapacity",

          "MIB.IETF|Printer-MIB.prtOutputCapacityUnit",

          "MIB.IETF|Printer-MIB.PrtCapacityUnitTC" }]

   sint32 RemainingCapacity;

 

      [Description (

          "Status: Assessment of the availability of this printer "

          "subunit."),

       ValueMap { "1", "2", "3", "4", "5", "6", "7" },

       Values { "Unknown", "AvailableIdle", "AvailableStandby",

          "AvailableActive", "AvailableBusy", "UnavailableOnRequest",

          "UnavailableBroken" },

       MappingStrings { "MIB.IETF|Printer-MIB.prtOutputStatus",

          "MIB.IETF|Printer-MIB.PrtSubUnitStatusTC" }]

   uint32 StatusAvailability;

 

      [Description (

          "Status: If true, there are currently Non-critical alerts on "

          "this printer subunit."),

       MappingStrings { "MIB.IETF|Printer-MIB.prtOutputStatus",

          "MIB.IETF|Printer-MIB.PrtSubUnitStatusTC" }]

   boolean StatusNonCriticalAlerts;

 

      [Description (

          "Status: If true, there are currently Critical alerts on "

          "this printer subunit."),

       MappingStrings { "MIB.IETF|Printer-MIB.prtOutputStatus",

          "MIB.IETF|Printer-MIB.PrtSubUnitStatusTC" }]

   boolean StatusCriticalAlerts;

 

      [Description (

          "Status: If true, the current state is offline on this "

          "printer subunit."),

       MappingStrings { "MIB.IETF|Printer-MIB.prtOutputStatus",

          "MIB.IETF|Printer-MIB.PrtSubUnitStatusTC" }]

   boolean StatusOffline;

 

      [Description (

          "Status: If true, the current state is transitioning from "

          "one value to another on this printer subunit."),

       MappingStrings { "MIB.IETF|Printer-MIB.prtOutputStatus",

          "MIB.IETF|Printer-MIB.PrtSubUnitStatusTC" }]

   boolean StatusTransitioning;

 

      [Write, Description (

          "The name assigned to this output tray subunit."),

       MinLen ( 0 ), MaxLen ( 63 ),

       MappingStrings { "MIB.IETF|Printer-MIB.prtOutputName" }]

   string Name;

 

      [Description (

          "A free-form text description of this output tray subunit in "

          "the localization specified by CIM_Printer.CurrentCharSet "

          "and CIM_Printer.CurrentNaturalLanguage."),

       MinLen ( 0 ), MaxLen ( 255 ),

       MappingStrings { "MIB.IETF|Printer-MIB.prtOutputDescription",

          "MIB.IETF|Printer-MIB.PrtLocalizedDescriptionStringTC" }]

   string Description;

 

      [Description (

          "The current state of the stacking order for the associated "

          "output tray subunit. 'FirstToLast' means that as pages are "

          "output the front of the next page is placed against the "

          "back of the previous page. 'LasttoFirst' means that as "

          "pages are output the back of the next page is placed "

          "against the front of the previous page."),

       ValueMap { "2",

          // Unknown

          "3",

          // FirstToLast

          "4" },

       Values { "Unknown",

          // 2

          "FirstToLast",

          // 3

          "LastToFirst" },

       MappingStrings { "MIB.IETF|Printer-MIB.prtOutputStackingOrder",

          "MIB.IETF|Printer-MIB.PrtOutputStackingOrderTC" }]

   uint32 StackingOrder;

 

      [Description (

          "The reading surface that will be 'up' when pages are "

          "delivered to the associated output tray subunit. Values are "

          "faceUp and faceDown. (Note: interpretation of these values "

          "is in general context-dependent based on locale; "

          "presentation of these values to an end-user should be "

          "normalized to the expectations of the user)."),

       ValueMap { "3",

          // FaceUp

          "4" },

       Values { "FaceUp",

          // 3

          "FaceDown" },

       MappingStrings {

          "MIB.IETF|Printer-MIB.prtOutputPageDeliveryOrientation",

          "MIB.IETF|Printer-MIB.PrtOutputPageDeliveryOrientationTC" }]

   uint32 PageDeliveryOrientation;

 

      [Write, Description (

          "This property indicates that the output tray supports "

          "offset stacking,and if so, whether the feature is enabled. "

          "See RFC 3805 Appendix A, Glossary Of Terms, for how Offset "

          "Stacking is defined by this document."),

       ValueMap { "1",

          // Other

          "3",

          // On

          "4",

          // Off

          "5" },

       Values { "Other",

          // 1

          "On",

          // 3

          "Off",

          // 4

          "NotPresent" },

       MappingStrings { "MIB.IETF|Printer-MIB.prtOutputOffsetStacking",

          "MIB.IETF|Printer-MIB.PresentOnOff" }]

   uint32 OffsetStacking;

};

 

 

// end of class 

 

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

2007/02/08 

Original version

 

 

 

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