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 &quot;printer-supply&quot; element datatypes (String or Integer)<br>follow the same logic as we used in &quot;printer-alert&quot; 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 &quot;printer-supply&quot; 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>&quot;printer-supply&quot; 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 &quot;printer-supply&quot;<br>in order to aid in correlation.<br><br>(2) prtMarkerSuppliesMarkerIndex is OPTIONAL in &quot;printer-supply&quot;<br>
because most Printers don&#39;t have multiple markers.<br><br>(3) prtMarkerSuppliesColorantIndex is omitted in &quot;printer-supply&quot;<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 &quot;printer-supply&quot; 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>&quot;printer-supply&quot; for all the machine-readable (non-localized) columnar<br>
objects in prtMarkerSuppliesTable and prtMarkerColorantTable [RFC3805].<br><br>printer-supply      = supply-type &quot;;&quot; supply-level *[&quot;;&quot; supply-element]<br>    ; set of supply elements encoded into one value<br>
<br>supply-type         = &quot;code&quot; &quot;=&quot; 1*ALPHA<br>    ; enumerated value as an alpha string (e.g., &#39;toner&#39;) of<br>    ; prtMarkerSuppliesType in [RFC3805] mapped indirectly from<br>    ; the *label* in PrtMarkerSuppliesTypeTC in [IANAPRT]<br>
<br>supply-level        = &quot;level&quot; &quot;=&quot; 1*[DIGIT / &quot;-&quot;]<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        = &quot;index&quot; &quot;=&quot; 1*DIGIT<br>    ; integer value as a numeric string mapped directly from<br>    ; prtMarkerSuppliesIndex in [RFC3805]<br>
<br>marker-index        = &quot;markerindex&quot; &quot;=&quot; 1*DIGIT<br>    ; integer value as a numeric string mapped directly from<br>    ; prtMarkerSuppliesMarkerIndex in [RFC3805]<br><br>supply-class        = &quot;class&quot; &quot;=&quot; 1*ALPHA<br>
    ; enumerated value as an alpha string (e.g., &#39;other&#39;) of<br>    ; prtMarkerSuppliesClass in [RFC3805] mapped indirectly from<br>    ; the *label* in PrtMarkerSuppliesClassTC in [RFC3805]<br><br>supply-unit         = &quot;unit&quot; &quot;=&quot; 1*ALPHA<br>
    ; enumerated value as an alpha string (e.g., &#39;other&#39;) of<br>    ; prtMarkerSuppliesSupplUnit in [RFC3805] mapped indirectly from<br>    ; the *label* in PrtMarkerSuppliesSupplyUnitTC in [RFC3805]<br><br>supply-max-capacity = &quot;maxcapacity&quot; &quot;=&quot; 1*[DIGIT / &quot;-&quot;]<br>
    ; integer value as a numeric string mapped directly from<br>    ; prtMarkerSuppliesMaxCapacity in [RFC3805]<br><br>colorant-index      = &quot;colorantindex&quot; &quot;=&quot; 1*DIGIT<br>    ; integer value as a numeric string mapped directly from<br>
    ; prtMarkerColorantIndex in [RFC3805]<br><br>colorant-role       = &quot;colorantrole&quot; &quot;=&quot; 1*ALPHA<br>    ; enumerated value as an alpha string (e.g., &#39;other&#39;) of<br>    ; prtMarkerColorantRole in [RFC3805] mapped indirectly from<br>
    ; the *label* in PrtMarkerColorantRoleTC in [RFC3805]<br><br>colorant-name       = &quot;colorantname&quot; &quot;=&quot; 1*ALPHA<br>    ; string value as an alpha string mapped directly from<br>    ; prtMarkerColorantValue in [RFC3805]<br>
<br>colorant-tonality   = &quot;coloranttonality&quot; &quot;=&quot; 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>&quot;printer-supply&quot;.<br>
<br>Note:  Line breaks are shown below for readability of this example.<br>Line breaks MUST NOT be encoded into actual values of &quot;printer-supply&quot;.<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 &quot;printer-supply-description&quot; 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 &quot;printer-supply-description&quot; 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>&quot;charset-configured&quot; and then copied into a text value of<br>&quot;printer-supply-description&quot;;<br>
<br>(b) Each value of &quot;printer-supply-description&quot; MUST be tagged with the<br>natural language [RFC5646] specified by prtGeneralCurrentLocalization,<br>prtLocalizationLanguage, and prtLocalizationCountry;<br><br>
(c) Each value of &quot;printer-supply-description&quot; MUST be in the same order<br>as the corresponding value of &quot;printer-supply&quot; (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>
&quot;printer-supply-description&quot;.<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.