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]

CIMCoreCR00996

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

Errata   [Yes|No]

No

Short Description

Add class CIM_PrintInterpreter 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.17 Experimental

Filename(s) Incorporating the Change
[Core/CIM_Container.mof, DSP0204.pdf]

CIM_PrintInterpreter.mof

Date Originated  [mm/dd/yyyy]

08/29/2007

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

08/29/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_PrintInterpreter, is one of the several classes to be added.  A PrintInterpreter represents a printer language processor, such as PostScript or PCL, that is used to put marks on the page and/or to control job flow in the device. 

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_PrintInterpreter


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_PrintInterpreter
// ==================================================================

[Experimental, Version ( "2.17.0" ),
UMLPackagePath ( "CIM::Device::Printing" ), Description (
"This class represents the PrintInterpreter component of a "
"Printer (print device). It contains properties that describe "
"the PrintInterpreter, including language type, language level, "
"maximum resolution, default input character set, and status. "
"Note: A PrintInterpreter shall be associated with exactly one "
"Printer via an instance of the PrinterComponent class. A "
"PrintInterpreter may be associated with a PrintChannel (for "
"Job Control Language or Page Description Language defaults) "
"via an instance of AssociatedPrintInterpreter. See: Model in "
"section 2 of Printer MIB (RFC 3805)."),
MappingStrings { "MIB.IETF|Printer-MIB.prtInterpreterEntry" }]
class CIM_PrintInterpreter : CIM_PrinterElement {

[Description (
"A free-form text description of this PrintInterpreter in "
"the localization specified by "
"CIM_Printer.CurrentNaturalLanguage."),
MinLen ( 0 ), MaxLen ( 255 ),
MappingStrings {
"MIB.IETF|Printer-MIB.prtInterpreterDescription",
"MIB.IETF|Printer-MIB.PrtLocalizedDescriptionStringTC" }]
string LocalizedDescription;

[Description (
"The language type of a Page Description Language (PDL) or "
"Job Control Language (JCL) which this PrintInterpreter can "
"interpret or emulate."),
ValueMap { "1", "2", "3", "4", "5", "6", "7", "8", "9", "10",
"11", "12", "13", "14", "15", "16", "17", "18", "19", "20",
"21", "22", "23", "24", "25", "26", "27", "28", "29", "30",
"31", "32", "33", "34", "35", "36", "37", "38", "39", "40",
"41", "42", "43", "44", "45", "46", "47", "48", "49", "50",
"51", "52", "53", "54", "55", "56", "57", "58", "59", "60",
"61", "62", "63", "64", "65", ".." },
Values { "Other", "Unknown", "LangPCL", "LangHPGL", "LangPJL",
"LangPS", "LangIPDS", "LangPPDS", "LangEscapeP", "LangEpson",
"LangDDIF", "LangInterpress", "LangISO6429", "LangLineData",
"LangMODCA", "LangREGIS", "LangSCS", "LangSPDL",
"LangTEK4014", "LangPDS", "LangIGP", "LangCodeV",
"LangDSCDSE", "LangWPS", "LangLN03", "LangCCITT", "LangQUIC",
"LangCPAP", "LangDecPPL", "LangSimpleText", "LangNPAP",
"LangDOC", "LangimPress", "LangPinwriter", "LangNPDL",
"LangNEC201PL", "LangAutomatic", "LangPages", "LangLIPS",
"LangTIFF", "LangDiagnostic", "LangPSPrinter", "LangCaPSL",
"LangEXCL", "LangLCDS", "LangXES", "LangPCLXL", "LangART",
"LangTIPSI", "LangPrescribe", "LangLinePrinter", "LangIDP",
"LangXJCL", "LangPDF", "LangRPDL", "LangIntermecIPL",
"LangUBIFingerprint", "LangUBIDirectProtocol", "LangFujitsu",
"LangCGM", "LangJPEG", "LangCALS1", "LangCALS2", "LangNIRS",
"LangC4", "DMTF Reserved" },
MappingStrings {
"MIB.IETF|Printer-MIB.prtInterpreterLangFamily",
"MIB.IETF|IANA-PRINTER-MIB.PrtInterpreterLangFamilyTC" },
ModelCorrespondence {
"CIM_PrintInterpreter.OtherLangTypeDescription",
"CIM_PrintInterpreter.LangLevel" }]
uint32 LangType;

[Description (
"A free-form string that describes the type of language when "
"the value of the LangType property is equal to 1 (Other)."),
MinLen ( 0 ), MaxLen ( 255 ),
ModelCorrespondence { "CIM_PrintInterpreter.LangType",
"CIM_PrintInterpreter.LangLevel" }]
string OtherLangTypeDescription;

[Description (
"The level of the language which this PrintInterpreter is "
"interpreting or emulating. For example, this property might "
"contain: (a) a value of '5e' for a PrinterInterpreter which "
"is emulating level 5e of the PCL; (b) a value of '2' for a "
"PrinterInterpreter which is emulating level 2 of the "
"PostScript language; or (c) a value of '2' for a "
"PrinterInterpreter which is emulating level 2 of the HPGL "
"language."),
MinLen ( 0 ), MaxLen ( 31 ),
MappingStrings { "MIB.IETF|Printer-MIB.prtInterpreterLangLevel"
},
ModelCorrespondence { "CIM_PrintInterpreter.LangType",
"CIM_PrintInterpreter.OtherLangTypeDescription" }]
string LangLevel;

[Description (
"The basis for the limit properties FeedAddressability and "
"XFeedAddressability, that specifies whether meaningful "
"values are available. 1 (Other) means the PrintInterpreter "
"places no restrictions on addressability and "
"FeedAddressability and XFeedAddressability shall be null. 2 "
"(Unknown) means the PrintInterpreter does not have "
"meaningful values and FeedAddressability and "
"XFeedAddressability shall be null. 3 (Actual) means the "
"PrintInterpreter does have meaningful values and "
"FeedAddressability and XFeedAddressability shall be "
"present."),
ValueMap { "1", "2", "3", ".." },
Values { "Other", "Unknown", "Actual", "DMTF Reserved" },
MappingStrings {
"MIB.IETF|Printer-MIB.prtInterpreterFeedAddressability",
"MIB.IETF|Printer-MIB.prtInterpreterXFeedAddressability" },
ModelCorrespondence { "CIM_PrintInterpreter.FeedAddressability",
"CIM_PrintInterpreter.XFeedAddressability" }]
uint16 AddressabilityBasis;

[Description (
"The maximum addressability (often called resolution) of "
"this PrintInterpreter in dots per inch in the feed "
"direction, i.e., long-edge in portrait feed mode."),
Punit ( "dot / inch" ), MinValue ( 0 ), MaxValue ( 2147483647 ),
MappingStrings {
"MIB.IETF|Printer-MIB.prtInterpreterFeedAddressability" },
ModelCorrespondence {
"CIM_PrintInterpreter.AddressabilityBasis",
"CIM_PrintInterpreter.XFeedAddressability" }]
uint32 FeedAddressability;

[Description (
"The maximum addressability (often called resolution) of "
"this PrintInterpreter in dots per inch in the cross-feed "
"direction, i.e., short-edge in portrait feed mode."),
Punit ( "dot / inch" ), MinValue ( 0 ), MaxValue ( 2147483647 ),
MappingStrings {
"MIB.IETF|Printer-MIB.prtInterpreterXFeedAddressability" },
ModelCorrespondence {
"CIM_PrintInterpreter.AddressabilityBasis",
"CIM_PrintInterpreter.FeedAddressability" }]
uint32 XFeedAddressability;

[Description (
"The default character set for input octets encountered by "
"the PrintInterpreter outside of a context in which a Page "
"Description Language (PDL) has established the "
"interpretation of the octets, e.g., when the value of the "
"LangType property is equal to 30 (LangSimpleText)."),
MinLen ( 0 ), MaxLen ( 63 ),
MappingStrings {
"MIB.IETF|Printer-MIB.prtInterpreterDefaultCharSetIn",
"MIB.IETF|Printer-MIB.prtLocalizationCharacterSet",
"MIB.IETF|IANA-CHARSET-MIB.IANACharset" },
ModelCorrespondence { "CIM_PrintInterpreter.LangType" }]
string DefaultCharSetIn;

[Description (
"This property contains detailed availability information "
"for this PrintInterpreter, as follows: 1 (Other) means "
"other detailed availability information is present in the "
"OtherAvailabilityStatus property. 2 (Unknown) means "
"detailed availability information for this PrintInterpreter "
"is unknown. 3 (AvailableIdle) means this PrintInterpreter "
"is available and idle, i.e., not currently in use. 4 "
"(AvailableStandy) means this PrintInterpreter is available "
"but on standby, e.g., in a power saving mode. 5 "
"(AvailableActive) means this PrintInterpreter is available "
"and active, i.e., currently in use. 6 (AvailableBusy) means "
"this PrintInterpreter is available but busy, i.e., not "
"immediately available for its primary function. 7 "
"(UnavailableOnRequest) means this PrintInterpreter is not "
"available and is on request, i.e., needs human "
"intervention. 8 (UnavailableBroken) means this "
"PrintInterpreter is not available and is broken, e.g., "
"needs repair/replacement."),
ValueMap { "1", "2", "3", "4", "5", "6", "7", "8", ".." },
Values { "Other", "Unknown", "AvailableIdle",
"AvailableStandby", "AvailableActive", "AvailableBusy",
"UnavailableOnRequest", "UnavailableBroken",
"DMTF Reserved" },
MappingStrings { "MIB.IETF|Printer-MIB.PrtSubUnitStatusTC" },
ModelCorrespondence {
"CIM_ManagedSystemElement.OperatingStatus",
"CIM_PrintInterpreter.OtherAvailabilityStatus" }]
uint32 AvailabilityStatus;

[Description (
"A free-form string that describes the detailed availability "
"of this PrintInterpreter when the value of the "
"AvailabilityStatus property is equal to 1 (Other)."),
MinLen ( 0 ), MaxLen ( 255 ),
ModelCorrespondence { "CIM_PrintInterpreter.AvailabilityStatus"
}]
string OtherAvailabilityStatus;

[Description (
"If true, there are currently non-critical alerts on this "
"PrintInterpreter."),
MappingStrings { "MIB.IETF|Printer-MIB.PrtSubUnitStatusTC" },
ModelCorrespondence { "CIM_ManagedSystemElement.DetailedStatus"
}]
boolean NonCriticalAlertsPresent;

[Description (
"If true, there are currently critical alerts on this "
"PrintInterpreter."),
MappingStrings { "MIB.IETF|Printer-MIB.PrtSubUnitStatusTC" },
ModelCorrespondence { "CIM_ManagedSystemElement.DetailedStatus"
}]
boolean CriticalAlertsPresent;
};

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

01

2007/08/29

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 Version 2.0.1b
Copyright (C) 2007 Distributed Management Task Force, Inc. (DMTF). All rights reserved.