attachment-0001
Hi folks, Monday (28 March 2011)<br><br>Below are proposed new JPS3 sections for the IPP attribute mapping of<br>prtMarkerSuppliesTable and prtMarkerColorantTable (flattened into one<br>
table just like we did in the earlier DMTF CIM Print mapping).<br><br>Choices for IPP "printer-supply" element datatypes (String or Integer)<br>follow the same logic as we used in "printer-alert" in PWG 5100.9<br>
(i.e., enumerations map to the equivalant *labels* from the textual<br>conventions, for human readability).<br><br>Comments?<br><br>Cheers,<br>- Ira<br><br>------------------------------------------------------------------------<br>
<br>5.5.21 printer-supply (1setOf octetString(MAX))<br><br>The RECOMMENDED "printer-supply" Printer attribute provides current<br>supply details mapped from the SNMP prtMarkerSuppliesTable and<br>prtMarkerColorantTable defined in IETF Printer MIB v2 [RFC3805].<br>
<br><br>5.5.21.1 Keywords for printer-supply<br><br>The table below defines the IPP datatypes and keywords for encoding<br>"printer-supply" from all of the machine-readable (non-localized)<br>columnar objects in prtMarkerSuppliesTable and prtMarkerColorantTable<br>
[RFC3805].<br><br>Notes:<br><br>(1) prtMarkerSuppliesIndex is RECOMMENDED in "printer-supply"<br>in order to aid in correlation.<br><br>(2) prtMarkerSuppliesMarkerIndex is OPTIONAL in "printer-supply"<br>
because most Printers don't have multiple markers.<br><br>(3) prtMarkerSuppliesColorantIndex is omitted in "printer-supply"<br>because it is redundant with prtMarkerColorantIndex for the rows that<br>include colorant information.<br>
<br> Table 6 - Keywords for printer-supply<br><br><span style="font-family: courier new,monospace;">SNMP Supply Object IPP Datatype IPP Keyword Conformance</span><br style="font-family: courier new,monospace;">
<span style="font-family: courier new,monospace;">------------------ ------------ ----------- -----------</span><br style="font-family: courier new,monospace;"><span style="font-family: courier new,monospace;">prtMarkerSupplies...</span><br style="font-family: courier new,monospace;">
<span style="font-family: courier new,monospace;">Index (note 1) Integer index RECOMMENDED</span><br style="font-family: courier new,monospace;"><span style="font-family: courier new,monospace;">MarkerIndex (note 2) Integer markerindex OPTIONAL</span><br style="font-family: courier new,monospace;">
<span style="font-family: courier new,monospace;">ColorantIndex (note 3) Integer --- ---</span><br style="font-family: courier new,monospace;"><span style="font-family: courier new,monospace;">Class String class RECOMMENDED</span><br style="font-family: courier new,monospace;">
<span style="font-family: courier new,monospace;">Type String type REQUIRED</span><br style="font-family: courier new,monospace;"><span style="font-family: courier new,monospace;">SupplyUnit String unit RECOMMENDED</span><br style="font-family: courier new,monospace;">
<span style="font-family: courier new,monospace;">MaxCapacity Integer maxcapacity RECOMMENDED</span><br style="font-family: courier new,monospace;"><span style="font-family: courier new,monospace;">Level Integer level REQUIRED</span><br style="font-family: courier new,monospace;">
<br style="font-family: courier new,monospace;"><span style="font-family: courier new,monospace;">prtMarkerColorant...</span><br style="font-family: courier new,monospace;"><span style="font-family: courier new,monospace;">Index Integer colorantindex OPTIONAL</span><br style="font-family: courier new,monospace;">
<span style="font-family: courier new,monospace;">Role String colorantrole OPTIONAL</span><br style="font-family: courier new,monospace;"><span style="font-family: courier new,monospace;">Value String colorantname OPTIONAL</span><br style="font-family: courier new,monospace;">
<span style="font-family: courier new,monospace;">Tonality Integer coloranttonality OPTIONAL</span><br><br><br>5.5.21.2 Encoding of printer-supply<br><br>Values of "printer-supply" MUST be encoded using a visible subset of the<br>
[US-ASCII] charset. Control codes (0x00 to 0x1F and 0x7F) MUST NOT be<br>used. The ABNF [RFC5234] below defines the standard encoding in<br>"printer-supply" for all the machine-readable (non-localized) columnar<br>
objects in prtMarkerSuppliesTable and prtMarkerColorantTable [RFC3805].<br><br>printer-supply = supply-type ";" supply-level *[";" supply-element]<br> ; set of supply elements encoded into one value<br>
<br>supply-type = "code" "=" 1*ALPHA<br> ; enumerated value as an alpha string (e.g., 'toner') of<br> ; prtMarkerSuppliesType in [RFC3805] mapped indirectly from<br> ; the *label* in PrtMarkerSuppliesTypeTC in [IANAPRT]<br>
<br>supply-level = "level" "=" 1*[DIGIT / "-"]<br> ; integer value as a numeric string mapped directly from<br> ; prtMarkerSuppliesLevel in [RFC3805]<br><br>supply-element = supply-index /<br>
marker-index /<br> supply-class /<br> supply-unit /<br> supply-max-capacity /<br> colorant-index /<br> colorant-role /<br>
colorant-name /<br> colorant-tonality<br><br>supply-index = "index" "=" 1*DIGIT<br> ; integer value as a numeric string mapped directly from<br> ; prtMarkerSuppliesIndex in [RFC3805]<br>
<br>marker-index = "markerindex" "=" 1*DIGIT<br> ; integer value as a numeric string mapped directly from<br> ; prtMarkerSuppliesMarkerIndex in [RFC3805]<br><br>supply-class = "class" "=" 1*ALPHA<br>
; enumerated value as an alpha string (e.g., 'other') of<br> ; prtMarkerSuppliesClass in [RFC3805] mapped indirectly from<br> ; the *label* in PrtMarkerSuppliesClassTC in [RFC3805]<br><br>supply-unit = "unit" "=" 1*ALPHA<br>
; enumerated value as an alpha string (e.g., 'other') of<br> ; prtMarkerSuppliesSupplUnit in [RFC3805] mapped indirectly from<br> ; the *label* in PrtMarkerSuppliesSupplyUnitTC in [RFC3805]<br><br>supply-max-capacity = "maxcapacity" "=" 1*[DIGIT / "-"]<br>
; integer value as a numeric string mapped directly from<br> ; prtMarkerSuppliesMaxCapacity in [RFC3805]<br><br>colorant-index = "colorantindex" "=" 1*DIGIT<br> ; integer value as a numeric string mapped directly from<br>
; prtMarkerColorantIndex in [RFC3805]<br><br>colorant-role = "colorantrole" "=" 1*ALPHA<br> ; enumerated value as an alpha string (e.g., 'other') of<br> ; prtMarkerColorantRole in [RFC3805] mapped indirectly from<br>
; the *label* in PrtMarkerColorantRoleTC in [RFC3805]<br><br>colorant-name = "colorantname" "=" 1*ALPHA<br> ; string value as an alpha string mapped directly from<br> ; prtMarkerColorantValue in [RFC3805]<br>
<br>colorant-tonality = "coloranttonality" "=" 1*DIGIT<br> ; integer value as a numeric string mapped directly from<br> ; prtMarkerColorantTonality in [RFC3805]<br><br><br>5.5.21.3 Example of printer-supply<br>
<br>The following example shows two rows of the machine-readable<br>(non-localized) columnar objects from prtMarkerSuppliesTable and<br>prtMarkerColorantTable encoded into corresponding values of<br>"printer-supply".<br>
<br>Note: Line breaks are shown below for readability of this example.<br>Line breaks MUST NOT be encoded into actual values of "printer-supply".<br><br><span style="font-family: courier new,monospace;">printer-supply[1] =</span><br style="font-family: courier new,monospace;">
<span style="font-family: courier new,monospace;"> type=toner;level=75;index=1;markerindex=1;</span><br style="font-family: courier new,monospace;"><span style="font-family: courier new,monospace;"> class=supplyThatIsConsumed;unit=percent;maxcapacity=100;</span><br style="font-family: courier new,monospace;">
<span style="font-family: courier new,monospace;"> colorantindex=4;colorantrole=process;colorantname=cyan;</span><br style="font-family: courier new,monospace;"><span style="font-family: courier new,monospace;"> coloranttonality=128</span><br style="font-family: courier new,monospace;">
<br style="font-family: courier new,monospace;"><span style="font-family: courier new,monospace;">printer-supply[2] =</span><br style="font-family: courier new,monospace;"><span style="font-family: courier new,monospace;"> type=toner;level=72;index=2;markerindex=1;</span><br style="font-family: courier new,monospace;">
<span style="font-family: courier new,monospace;"> class=supplyThatIsConsumed;unit=percent;maxcapacity=100;</span><br style="font-family: courier new,monospace;"><span style="font-family: courier new,monospace;"> colorantindex=4;colorantrole=process;colorantname=magenta;</span><br style="font-family: courier new,monospace;">
<span style="font-family: courier new,monospace;"> coloranttonality=128</span><br><br><br>5.5.22 printer-supply-description (1setOf text(MAX))<br><br>The RECOMMENDED "printer-supply-description" Printer attribute provides<br>
current supply descriptions mapped from the SNMP<br>prtMarkerSuppliesDescription object in the prtMarkerSuppliesTable<br>defined in IETF Printer MIB v2 [RFC3805].<br><br><br>5.5.22.1 Encoding of printer-supply-description<br>
<br>Values of the "printer-supply-description" attribute MUST be mapped from<br>the corresponding human-readable (localized) values of<br>prtMarkerSuppliesDescription, exactly as follows:<br><br>(a) Each value of prtMarkerSuppliesDescription MUST be converted<br>
from the charset [RFC3808] specified by prtGeneralCurrentLocalization<br>and prtLocalizationCharacterSet into the charset specified by<br>"charset-configured" and then copied into a text value of<br>"printer-supply-description";<br>
<br>(b) Each value of "printer-supply-description" MUST be tagged with the<br>natural language [RFC5646] specified by prtGeneralCurrentLocalization,<br>prtLocalizationLanguage, and prtLocalizationCountry;<br><br>
(c) Each value of "printer-supply-description" MUST be in the same order<br>as the corresponding value of "printer-supply" (i.e., strictly ascending<br>order according to prtMarkerSuppliesIndex).<br><br>
<br>5.5.22.2 Example of printer-supply-description<br><br>The following example shows two instances of the human-readable<br>(localized) columnar object prtMarkerSuppliesDescription in the<br>prtMarkerSuppliesTable encoded into corresponding values of<br>
"printer-supply-description".<br><br><span style="font-family: courier new,monospace;">printer-supply-description[1] =</span><br style="font-family: courier new,monospace;"><span style="font-family: courier new,monospace;"> Cyan Toner Cartridge S/N:CRUM-09111141087</span><br style="font-family: courier new,monospace;">
<br style="font-family: courier new,monospace;"><span style="font-family: courier new,monospace;">printer-supply-description[2] =</span><br style="font-family: courier new,monospace;"><span style="font-family: courier new,monospace;"> Magenta Toner Cartridge S/N:CRUM-08561031091</span><br>
<br>------------------------------------------------------------------------<br><br>
<br />--
<br />This message has been scanned for viruses and
<br />dangerous content by
<a href="http://www.mailscanner.info/"><b>MailScanner</b></a>, and is
<br />believed to be clean.