diff options
Diffstat (limited to 'doc/rfc/rfc3806.txt')
-rw-r--r-- | doc/rfc/rfc3806.txt | 2971 |
1 files changed, 2971 insertions, 0 deletions
diff --git a/doc/rfc/rfc3806.txt b/doc/rfc/rfc3806.txt new file mode 100644 index 0000000..0bbb074 --- /dev/null +++ b/doc/rfc/rfc3806.txt @@ -0,0 +1,2971 @@ + + + + + + +Network Working Group R. Bergman +Request for Comments: 3806 Hitachi Printing Solutions +Category: Informational H. Lewis + IBM Corporation + I. McDonald + High North Inc. + June 2004 + + + Printer Finishing MIB + +Status of this Memo + + This memo provides information for the Internet community. It does + not specify an Internet standard of any kind. Distribution of this + memo is unlimited. + +Copyright Notice + + Copyright (C) The Internet Society (2004). + +Abstract + + This document defines a MIB module for the management of printer + finishing device subunits. The finishing device subunits applicable + to this MIB are an integral part of the Printer System. This MIB + applies only to a Finisher Device that is connected to a Printer + System. + + + + + + + + + + + + + + + + + + + + + + + +Bergman, et al. Informational [Page 1] + +RFC 3806 Printer Finishing MIB June 2004 + + +Table of Contents + + 1. Introduction. . . . . . . . . . . . . . . . . . . . . . . . . 3 + 1.1. Scope . . . . . . . . . . . . . . . . . . . . . . . . . 3 + 1.2. Rational. . . . . . . . . . . . . . . . . . . . . . . . 4 + 1.3. The Internet-Standard Management Framework. . . . . . . 4 + 1.4. Read-Write Objects. . . . . . . . . . . . . . . . . . . 4 + 2. Terminology . . . . . . . . . . . . . . . . . . . . . . . . . 5 + 2.1. General Terminology . . . . . . . . . . . . . . . . . . 5 + 2.2. Process Specific Terminology. . . . . . . . . . . . . . 9 + 3. Finisher Subunits Integrated into the Printer Model . . . . . 12 + 4. Finishing Specifications. . . . . . . . . . . . . . . . . . . 12 + 4.1. Multiple finDeviceTable Entries . . . . . . . . . . . . 13 + 4.2. Implicit Parameters . . . . . . . . . . . . . . . . . . 13 + 4.2.1. FinPunchPatternTC . . . . . . . . . . . . . . . 14 + 4.2.2. FinPunchHoleTypeTC, punchHoleSizeMaxDim, + punchHoleSizeMinDim . . . . . . . . . . . . . . 15 + 5. The Attribute Mechanism . . . . . . . . . . . . . . . . . . . 15 + 5.1. Conformance of Attribute Implementation . . . . . . . . 16 + 5.2. Useful, 'Unknown', and 'Other' Values for Objects + and Attributes. . . . . . . . . . . . . . . . . . . . . 16 + 5.3. Data Sub-types and Attribute Naming Conventions . . . . 17 + 5.4. Single-Value (Row) Versus Multi-Value (MULTI-ROW) + Attributes. . . . . . . . . . . . . . . . . . . . . . . 17 + 5.5. Linked MUTI-ROW Values. . . . . . . . . . . . . . . . . 17 + 5.6. Index Value Attributes. . . . . . . . . . . . . . . . . 17 + 5.7. Attribute Specifications. . . . . . . . . . . . . . . . 18 + 6. Enumerations. . . . . . . . . . . . . . . . . . . . . . . . . 23 + 6.1. Registering Additional Enumerated Values. . . . . . . . 23 + 7. IANA Printer Finishing MIB Specification. . . . . . . . . . . 24 + 8. Printer Finishing MIB Specification . . . . . . . . . . . . . 30 + 9. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 48 + 10. Internationalization Considerations . . . . . . . . . . . . . 48 + 11. References. . . . . . . . . . . . . . . . . . . . . . . . . . 48 + 11.1. Normative References. . . . . . . . . . . . . . . . . . 48 + 11.2. Informative References. . . . . . . . . . . . . . . . . 49 + 12. Security Considerations . . . . . . . . . . . . . . . . . . . 49 + 13. Acknowledgements. . . . . . . . . . . . . . . . . . . . . . . 51 + 14. Authors' Addresses. . . . . . . . . . . . . . . . . . . . . . 52 + 15. Full Copyright Statement. . . . . . . . . . . . . . . . . . . 53 + + + + + + + + + + + +Bergman, et al. Informational [Page 2] + +RFC 3806 Printer Finishing MIB June 2004 + + +1. Introduction + + This document describes an SNMP Management Information Base (MIB) to + provide for the management of in-line post-processing in a fashion + that is currently provided for printers, using the Printer MIB + [RFC3805]. The Printer Finishing MIB includes the following + features: + + - Provides the status of the finishing device. + - Queries and controls the features and configuration of the + finishing device. + - Enables and disables the finishing processes. + - Allows unsolicited status from the finishing device. + + The Finisher MIB is defined as an extension of the Printer MIB + [RFC3805] and it is expected that the information defined in this + document will be incorporated into a future update of the Printer + MIB. + +1.1. Scope + + This document provides a robust set of finishing devices, features, + and functions, based upon today's state of the art of in-line + finishing. Since finishing typically accompanies higher speed + network printers and copiers, in contrast to simple desktop devices, + no attempt is made to limit the scope to "bare minimum". On the + other hand, the Printer Finishing MIB does not duplicate the + production mail preparation, custom insertion, franking, and reprints + that are covered by the DMTF Large Mailing Operations standard [LMO]. + + Information supplied by the Printer Finishing MIB may be utilized by + printer and finisher management applications engaged in monitoring + status and managing configuration, and also used by print and + finishing submission applications which are engaged in: + + - print-job-level finishing processes that are applied to a complete + print job, + + - document-level finishing processes that are applied individually + to each document in the print job, + + - document-level finishing processes that are applied to a selected + document in the print job. + + Note that not all combinations of finishing processes are permitted. + Compatible combinations of finishing processes are implementation + specific. The MIB allows invalid combinations to be identified. + + + + +Bergman, et al. Informational [Page 3] + +RFC 3806 Printer Finishing MIB June 2004 + + + The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", + "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this + document are to be interpreted as described in [RFC2119]. + +1.2. Rational + + The Printer MIB [RFC3805] is now successfully deployed in a large + segment of the network printer market. SNMP and/or HTTP enabled + printers and software management applications are growing in numbers. + + There is an increase in the availability of network printers and + copiers that include in-line finishing processes. Thus a well + defined and ordered set of finishing objects is now necessary for + printer management. + + The printer model defined in the Printer MIB includes finishing + processes and the MIB was designed to later incorporate finisher + objects or to be referenced by a future Finisher MIB. + +1.3. The Internet-Standard Management Framework + + For a detailed overview of the documents that describe the current + Internet-Standard Management Framework, please refer to section 7 of + RFC 3410 [RFC3410]. + + Managed objects are accessed via a virtual information store, termed + the Management Information Base or MIB. MIB objects are generally + accessed through the Simple Network Management Protocol (SNMP). + Objects in the MIB are defined using the mechanisms defined in the + Structure of Management Information (SMI). This memo specifies a MIB + module that is compliant to the SMIv2, which is described in STD 58, + RFC 2578 [RFC2578], STD 58, RFC 2579 [RFC2579] and STD 58, RFC 2580 + [RFC2580]. + +1.4. Read-Write Objects + + Some objects in the Finisher MIB reflect the existence or amount of a + given resource within the finisher. Some examples of such resources + are the size and number of sheets in an inserter tray or the + existence of certain finisher options. Some finishers have automatic + sensors for these resources. Most finishers lack sensors for every + property of every resource. The management application is allowed to + write into objects that hold descriptive or existence values for + finishers that cannot sense these values. The ability to change the + value of a read-write object may depend on the implementation of the + agent. Many objects in the MIB are given read-write access, but an + implementation might only permit a management application to change + + + + +Bergman, et al. Informational [Page 4] + +RFC 3806 Printer Finishing MIB June 2004 + + + the value if the finisher can not sense the value itself. Note that + even though some objects explicitly state the behavior of conditional + ability to change values, any read-write object may act this way. + + Generally, an object is given read-write access in the Finisher MIB + specification if: + + 1. The object involves installation of a resource that some finishers + cannot themselves detect. Therefore, external means are needed to + inform the device of the installation. (Here external means + include using the operator console, or remote management + application) and + + 2. The finisher will behave differently if the installation of the + resource is reported than if the installation were not reported; + that is, the object is not to be used as a place to put + information not used by the finisher, i.e., not a "sticky-note". + Another way of saying this is that the finisher believes that + information given it and acts as if the information were true. + + 3. The finisher may get hints that it may not know about the + existence or properties of certain resources. For example, a + paper tray may be removed and re-inserted. When this removal and + insertion happens, the finisher may either assume that a property, + such as the size of paper in the tray, has not changed or the + finisher may change the value of the associated object to + "unknown", as might be done for the amount of paper in the tray. + As long as the finisher acts according to the value in the object + either strategy is acceptable. + + 4. It is an implementation-specific matter as to whether or not MIB + object values are persistent across power cycles or cold starts. + +2. Terminology + + Where appropriate, the Printer Finishing MIB will conform to the + terminology, syntax, and semantics from the DMTF Large Mailing + Operations standard [LMO], the Internet Printing Protocol [RFC2911], + and/or the ISO Document Printing Application [DPA]. + +2.1. General Terminology + + Finisher Input: An input tray on the finisher and not otherwise + associated with the printer. An example of a finisher input is a + tray that holds finishing "inserts". + + + + + + +Bergman, et al. Informational [Page 5] + +RFC 3806 Printer Finishing MIB June 2004 + + + ^ Y + | + |<---- Reference Edge + | + | |<--- Finishing Process Axis + | | + --->| |<--- Finishing Process Offset + | | + Head +=========================+ (X2,Y4) + Locations # | # + +-----#----+ # + -----Y3--|-----#--O | <--+- Head # + ^ +-----#----+ | Mechanisms # + | # | | # + | # | | # + | # | | # + | # | | # + | +-----#----+ | # + | ---Y2--|-----#--O | <--+ # + | ^ +-----#----+ | # + | | # | | # + | | # | | # + | | # | | # + | | # | | # + | | +-----#----+ | # + | | -Y1--|-----#--O | <--+ # + | | ^ +-----#----+ bottom right # + | | | # | corner # X + --------------- +==+======================+ ----> + (0,0) (X1,0) + + Figure 1 - Finishing Process Axis Parallel to Y Axis + + + + + + + + + + + + + + + + + + + +Bergman, et al. Informational [Page 6] + +RFC 3806 Printer Finishing MIB June 2004 + + + ^ Y + | Head Locations + |<---------------->|---X2 + |<---->|---X1 | + | | | + | +-|-+ +-|-+ + | | | | | | | (X3,Y2) + +======|===========|======+ + # | | | | | | # Finishing Process Axis + #----| O |-------| O |----#----- Y1 + # +---+ +---+ # ^ + # ^ ^ # | + # | | # | + # +-----------+ # | + # | # | + # Head # | + # Mechanisms # | + # # | + # # Finishing Process Offset + # # | + # # | + # # | + # # | + # # | + # # | + # bottom right # | + # corner # v X + +=========================+ ------> + (0,0) Reference Edge + + Figure 2 - Finishing Process Axis Parallel to X Axis + + Finisher Output: The output of the finisher. Because processing is + in-line, the finisher outputs are a direct extension of the set of + printer outputs. + + Media Orientation: All Finishing Processes are defined relative to a + portrait orientation of the medium, regardless of the orientation of + the printed image or the direction of feed. The 'X' and 'Y' axis, + therefore, will always reference the medium as shown in figures 1 + and 2, with the 'X' axis always along the short edge of the medium. + All edges and corners are also defined with the medium orientation + as shown using the syntax top, bottom, left, and right. Thus the + bottom edge of the medium is at Y = 0, the left edge is at X = 0, + and the bottom right corner is at (X2,0) as shown in the figure 1 + and at (X3,0) as shown in figure 2. + + + + + +Bergman, et al. Informational [Page 7] + +RFC 3806 Printer Finishing MIB June 2004 + + + Finishing: Defined by DPA as an operation on a document following + the completion of the image process. Finishing processes defined + within this document are those applied to one or more instances of + rectangular paper sheet media. + + Finishing Process: Defined by DPA as an operation applied by a + machine such as trimming a document, folding the sheets in a + document, and applying a binding to a document. + + Finishing Specification: Defined by DPA as the specific sequence of + operations for a serial combination of finishing processes. The + exact sequential order of the processes, in many cases, is critical + to the obtaining the desired result. For example, a folding + operation followed by trimming could provide a very different result + than if the trimming was followed by the folding. + + Finishing Process Parameters: This parameter set is used to create a + detailed definition of the finishing process. Generic Finishing + Process Parameters are applicable to any Finishing Specification. + + - Head Mechanism: Defined by DPA as the physical mechanism that is + used to perform a finishing process. The head position may be + fixed or variable depending upon the capabilities of the device. + + - Reference Edge: Defined by DPA as the edge of the document + relative to the axis to which the finishing process is applied. + The edge of the medium defined to be the Reference Edge may be + either the 'X' or the 'Y' axis, depending upon the finishing + process to be performed. + + Note that the Reference Edge may change from one finishing process + to another for one of two reasons. First, a subsequent process + may require a different Reference Edge. Second, the actual + dimensions of the document may change, for example as a result of + a folding or a trimming operation. + + - Jog Edge: Defined by DPA as one of the two edges that is + perpendicular to the Reference Edge. Specifying the Jog Edge + parameter indicates the edges of all sheets which correspond to + the Jog Edge are aligned. + + - Finishing Process Axis: Defined by DPA as the axis which some + finishing processes are applied to or referenced from by the Head + Mechanism. Examples are the axis for a fold process or the axis + for a punch process. + + - Head Locations: Defined by DPA as the position of the Heads on + the Finishing Process Axis. + + + +Bergman, et al. Informational [Page 8] + +RFC 3806 Printer Finishing MIB June 2004 + + + - Finishing Process Offset: The offset from the Reference Edge to + the Finishing Process Axis at which the finishing process takes + place or is applied. + +2.2. Process Specific Terminology + + FOLDING: + + Z Fold: A fold in which two folds are placed in the sheet in + opposite directions. The first fold is located at 25% of the sheet + length, and the second is located at 50% of the sheet length (i.e., + the center of the sheet). Z Folding is often used on 11x17 inch or + A3 size sheets, when they are included in sets containing 8.5x11 + inch or A4 size sheets. + + Half Fold: To fold a sheet in half so that one of the resulting + dimensions are exactly half the original sheet. Often used for + signatures or booklets. + + Letter Fold: Folding a sheet roughly in thirds. Usually performed + on 8.5x11 inch or A4 size sheets for insertion into an envelope. + + Signature: The process by which images are placed on a large sheet + of paper in correct panel areas and in the proper orientation such + that when the sheet is folded it will produce a booklet with each + page in the proper order and orientation. + + BINDING: + + Adhesive Binding: A method of attaching sheets together to form a + book or booklet using glue or adhesive. Some adhesive binding + methods apply the glue to sheets individually, before merging them + together for form a book, but most methods involve the application + of adhesive to an entire book of sheets. + + Comb Binding: A method of binding in which a series of small + rectangular holes is placed along the bind edge of the sheets. The + sheets are then held together using a tube shaped plastic binding + strip with comb like fingers that fit through the holes in the + sheets. + + Spiral Binding: Sometimes referred to as wire binding, this binding + method is a mechanical bind in which the individual leaves are held + together by a wire or plastic spiral that is fed through small + holes in the paper binding edge. + + + + + + +Bergman, et al. Informational [Page 9] + +RFC 3806 Printer Finishing MIB June 2004 + + + Padding: Applying a non-penetrating adhesive to the edge of a stack + of sheets such that the sheets can be easily peeled off one at a + time. Frequently used for forms. + + Velo Binding: A bind formed by punching holes into the edge of the + sheets, placing a two piece plastic strip (one side formed with + plastic pins that pass through the holes) along the edge and then + staking the two pieces together. + + Perfect Binding: A method of binding in which all pages are cut and + roughed up at the back or binding edge and held together by an + adhesive. + + Tape Binding: The act of placing tape over the bind edge of a set. + Sometimes contains adhesive to provide a functional bind to the + set, and sometimes done for decorative purposes on a set that has + been edge stapled. + + SLITTING/CUTTING/TRIMMING: + + Trim: To cut the edges of a sheet or set of sheets. + + Face Trim: To cut the edges of a set of sheets on a booklet of + sheets that have been folded to eliminate the "creep" or edge + shingling that results from the folding process. + + Gutter Trim: To cut a larger sheet into smaller sheets eliminating + the gutter between adjacent images. This operation requires a + minimum of two cuts for each gutter. + + Tab Cutting: The act of cutting the edge of a sheet to form an index + tab, thereby allowing quick identification and access. The + external tabs are sequentially placed along the book edge for + visibility and ease of grasping. + + Perforating: The act of cutting a series of very small, closely + spaced holes or slots into a sheet to allow for ease of separation + of a portion of the sheet. Sometimes also used to ease + bending/hinging of heavy weight papers. + + Scoring: A means of applying small linear grooves or impressions + along a sheet to allow easy folding. Often used on heavy weight + sheets and book covers. + + Slitting: The action of cutting apart a large sheet to form smaller + sheets. Usually done using a sharp circular roll system. + + + + + +Bergman, et al. Informational [Page 10] + +RFC 3806 Printer Finishing MIB June 2004 + + + STITCHING/STAPLING: + + Staple: The process of binding a set of sheets together using a 'U' + shaped piece of metal wire that is punched through the set. The + ends of the metal staple are then bent over, or 'clinched' to hold + the staple in place. Technically the term 'stapler' refers to + devices that use pre-cut metal staples, but the term is also + commonly used to refer to devices that use wire spools and then + cut/form the staple. (see the definition of Stitch) + + Stitch: The process of binding a set of sheets together using a 'U' + shaped piece of metal wire that is punched through the set. The + wire used to form the staple is cut and formed into a 'U' shape in + the stitcher head, and the staple 'leg' length is often varied + depending on the number of sheets to be bound together. The ends + of the metal staple are bent over, or 'clinched' to hold the staple + in place. + + Stitching can also refer to the process of sewing the edges of the + signatures of a book together. + + Saddle Stitch: The process of stapling a set along its center line + as part of a booklet making process. Usually 2 or 3 staples are + used. + + Dual Stapling: The process of placing 2 staples along the bind edge + of a set. The staples are typically located at 25% and 75% of the + length of the bind edge. Although dual stapling is often performed + on the long edge of a set, legal documents are frequently dual + stapled along the top, or short edge of the set. + + Triple Stapling: Same as above, but using 3 staples along the bind + edge, and usually applies to the long edge only. + + WRAPPING: + + Shrink Wrap: A wrap of thin plastic which when heated will shrink + and wrap tightly around the stack thus preparing it for shipment. + + BANDING: + + Band Wrap: Bundling a finished stack to prepare for shipment. Also + known as Strap Wrap. + + ROTATING: + + Sheet Rotator: A device that rotates each sheet as received from the + Media Path to the proper orientation for the finisher processing. + + + +Bergman, et al. Informational [Page 11] + +RFC 3806 Printer Finishing MIB June 2004 + + +3. Finisher Subunits Integrated Into The Printer Model + + The Printer Finisher Device subunits receive media from one or more + Printer Media Path subunits and deliver the media to one or more + Printer Output subunits after the completion of the finishing + processes. The Printer Model, as described in the Printer MIB + [RFC3805], is modified adding the finisher subunit(s) and finisher + supplies between the media path and output subunits as follows: + + +----------+ + +----------+ | + | Marker | | + | Supplies |-+ + +----------+ + \ + +-----+ \ +------+ +--------+ +------+ + | | \| | | | | | ++-----+ | +-----+ +------+ | +------+ +--------+ | +------+ | +|Input|-+ +------+| |Marker|-+ +------+| |Finisher|-+ |Output|-+ +| |===>| |+<==>| |<==>| |+==>| |===>| | ++-----+ +-+ +-+ +------+ +-+ +-+ +--------+ +------+ + \ | || | || \ + \ | || | || \ + \ | || | || +----------+ + +-------+ | |+--------------------| || | Finisher |-+ + | | | +---------------------+ || | Supplies | | ++-------+ | | Media Path |+ +----------+ | +| Media |-+ +---------------------------+ | | +|(opt.) | +----------+ ++-------+ + +4. Finishing Specifications + + The Finisher MIB is able to provide most of the information that is + required to generate a Finishing Specification. This includes; + + 1. Finishing operations that can be performed on media that are + associated with a specific printer media path and output subunit. + + 2. Combinations of operations that cannot be performed. + + 3. The location of the operation on the medium, if applicable. + + 4. The physical characteristics of the result of the operation. For + example, the size and shape of a punched hole, or if a fold + operation creates a letter fold or a "Z" fold. + + + + + +Bergman, et al. Informational [Page 12] + +RFC 3806 Printer Finishing MIB June 2004 + + + The Finisher MIB permits an agent to describe the order that + operations can be performed. + +4.1. Multiple finDeviceTable Entries + + Each finishing operation supported by the printer is represented by + one or more entries in the finDeviceTable. Each entry in this table + defines a "logical" finishing device, since the function of several + table entries may be performed by a single finisher mechanism. + Multiple entries may also exist in the table as a result of the + existence of multiple finisher mechanisms that perform the same type + of operation. + + One example of possible multiple entries for a single finisher + device, is a hole punch operation that creates more than one hole. + This could be performed using a single die punch that moves to each + required position or a multi-die punch that simultaneously creates + all holes. In either case, each defined hole position may be defined + as a separate table entry. + + In both cases, if the punch positions can be individually selected, a + table entry for each position would be necessary. + + For the multi-die punch, each head mechanism may have a different + hole pattern or size. If these differences are to be properly + disclosed, a table entry for each head mechanism would be required. + +4.2. Implicit Parameters + + Finishing operations that are specified by an enum define a standard + operation and in many cases an implicit set of physical + characteristics is to be included when specifying the enum. If + explicit values for these characteristics are not provided in the + attributes table, the values defined in this section are to be + implied. + + + + + + + + + + + + + + + + +Bergman, et al. Informational [Page 13] + +RFC 3806 Printer Finishing MIB June 2004 + + +4.2.1. FinPunchPatternTC + + enum pattern |Reference| Reference | Hole spacing + | Edge |Axis Offset| (see note 1) + -------------------+---------+-----------+--------------------------- + twoHoleUSTop(4) | topEdge | note 2 | 2.75 inches + threeHoleUS(5) | note 3 | note 2 | 4.25 inches + twoHoleDIN(6) | note 4 | note 5 | 80 mm + fourHoleDIN(7) | note 4 | note 5 | 80 mm + twentyTwoHoleUS(8) | note 3 | note 2 | .5 inches + nineteenHoleUS(9) | note 3 | note 9 | .5625 inches + twoHoleMetric(10) | note 6 | note 5 | 80 mm + swedish4Hole(11) | note 4 | note 5 | 21, 70, 21 mm + twoHoleUSSide(12) | note 3 | note 2 | 2.75 inches + fiveHoleUS(13) | note 3 | note 2 | 2, 2.25, 2.25, 2 in + sevenHoleUS(14) | note 3 | note 2 | 1, 1, 2.25, 2.25, 1, 1 in + mixed7H4S(15) | note 4 | note 5 | note 7 + norweg6Hole(16) | note 4 | note 5 | note 8 + metric26Hole(17) | note 6 | note 5 | 9.5 mm + metric30Hole(18) | note 4 | note 5 | 9.5 mm + + Notes: + + 1. All hole to hole patterns are centered along the process edge. + + 2. Offset is 0.18 inches to 0.51 inches. + + 3. Reference edge is leftEdge(5) for letter and topEdge(3) for + ledger. + + 4. Reference edge is leftEdge(5) for A4 and topEdge(3) for A3. + + 5. Offset is 4.5 mm to 13 mm. + + 6. Reference edge is leftEdge(5) for B5 and topEdge(3) for B4. + + 7. 7 holes and 4 slots are punched in a H-S-H-H-S-H-S-H-H-S-H pattern + with 15, 25, 23, 20, 37, 37, 20, 23, 25, 15 mm spacing. + + 8. 4 holes and 2 slots are punched in a H-H-S-S-H-H pattern with a + 64, 18.5, 75, 18.5, 64 mm spacing. + + 9. Offset is .188 inches. + + + + + + + + +Bergman, et al. Informational [Page 14] + +RFC 3806 Printer Finishing MIB June 2004 + + +4.2.2 FinPunchHoleTypeTC, punchHoleSizeMaxDim, punchHoleSizeMinDim + + enum pattern | Hole Description + -------------------+---------------------------------------- + twoHoleUSTop(4) | round(3), .2 - .32 inch diameter + threeHoleUS(5) | round(3), .2 - .32 inch diameter + twoHoleDIN(6) | round(3), 5 - 8 mm diameter + fourHoleDIN(7) | round(3), 5 - 8 mm diameter + twentyTwoHoleUS(8) | round(3), .2 - .32 inch diameter + nineteenHoleUS(9) | rectang(6), .313 inches X .125 inches + twoHoleMetric(10) | round(3), 5 - 8 mm diameter + swedish4Hole(11) | round(3), 5 - 8 mm diameter + twoHoleUSSide(12) | round(3), .2 - .32 inch diameter + fiveHoleUS(13) | round(3), .2 - .32 inch diameter + sevenHoleUS(14) | round(3), .2 - .32 inch diameter + mixed7H4S(15) | round(3), 5 - 8 mm diameter + | rectang(6), 12 mm X 6 mm + norweg6Hole(16) | round(3), 5 - 8 mm diameter + | rectang(6), 10 mm X 5.5 mm + metric26Hole(17) | round(3), 5 - 8 mm + metric30Hole(18) | round(3), 5 - 8 mm + + Note: Hole size ranges are typical and are provided as a reference + only. Exact tolerances should be site defined. + +5. The Attribute Mechanism + + Attributes provide a function similar to information objects, except + that attributes are identified by an enum, instead of an OID. Thus + new attributes may be registered without requiring a change to the + MIB. In addition, an implementation that does not have the + functionality represented by the attribute can omit the attribute + entirely, rather than having to return a distinguished value. The + agent is free to create an attribute in the Attribute Table as soon + as the agent is aware of the value of the attribute. + + The agent materializes finishing subunit attributes in a four-indexed + finDeviceAttributeTable: + + 1. hrDeviceIndex - which device in the host + + 2. finDeviceIndex - which finisher subunit in the printer device + + 3. finDeviceAttributeTypeIndex - which attribute + + 4. finDeviceAttributeInstanceIndex - which attribute instance for + those attributes that can have multiple values per finishing + subunit. + + + +Bergman, et al. Informational [Page 15] + +RFC 3806 Printer Finishing MIB June 2004 + + +5.1. Conformance of Attribute Implementation + + An agent SHALL implement any attribute if (1) the device supports the + functionality represented by the attribute and (2) the information is + available to the agent. The agent MAY create the attribute row in + the finDeviceAttributeTable when the information is available or MAY + create the row earlier with the designated 'unknown' value + appropriate for that attribute. See next section. + + If the device does not implement or does not provide access to the + information about an attribute, the agent SHOULD NOT create the + corresponding row in the finDeviceAttributeTable. + +5.2. Useful, 'Unknown', and 'Other' Values for Objects and Attributes + + Some attributes have a 'useful' Integer32 value, some have a 'useful' + OCTET STRING value, some MAY have either or both depending on + implementation, and some MUST have both. See the + finDeviceAttributeTypeTC textual convention for the specification of + each attribute. + + NOTE: In some instances, objects with a MAX-ACCESS of read-write will + result in an SNMPv1 error or SNMPv2 exception during a write + operation. The administrative security policy may restrict a class + of users to read-only or, more importantly, the implementation may + implement a subset of read-write objects as read-only. This should + be expected to be the case for a device that can properly sense the + value of an object and does not want the value to be externally + modified. + + In general, values for objects and attributes have been chosen so + that a management application will be able to determine whether a + 'useful', 'unknown', or 'other' value is available. When a useful + value is not available for an object that agent SHALL return a zero- + length string for octet strings, the value 'unknown(2)' for enums, a + '0' value for an object that represents an index in another table, + and a value '-2' for counting integers. + + Since each attribute is represented by a row consisting of both the + finDeviceAttributeValueAsInteger and finDeviceAttributeValueAsOctets + MANDATORY objects, SNMP requires that the agent SHALL always create + an attribute row with both objects specified. However, for most + attributes the agent SHALL return a "useful" value for one of the + objects and SHALL return the 'other' value for the other object. For + integer only attributes, the agent SHALL always return a zero-length + string value for the finDeviceAttributeValueAsOctets object. For + octet string only attributes, the agent SHALL always return a '-1' + value for the finDeviceAttributeValueAsInteger object. + + + +Bergman, et al. Informational [Page 16] + +RFC 3806 Printer Finishing MIB June 2004 + + +5.3. Data Sub-types and Attribute Naming Conventions + + Many attributes are sub-typed to give a more specific data type than + Integer32 or OCTET STRING. The data sub-type of each attribute is + indicated on the first line(s) of the description. Some attributes + have several different data sub-type representations. When an + attribute has both an Integer32 data sub-type and an OCTET STRING + data sub-type, the attribute can be represented in a single row in + the finDeviceAttributeTable. In this case, the data sub-type name is + not included as the last part of the name of the attribute. When the + data sub-types cannot be represented by a single row in the + finDeviceAttributeTable, each such representation is considered a + separate attribute and is assigned a separate name and enum value. + For these attributes, the name of the data sub-type is the last part + of the name of the attribute. + +5.4. Single-Value (Row) Versus Multi-Value (MULTI-ROW) Attributes + + Most attributes shall have only one row per finishing subunit. + However, a few attributes can have multiple values per finishing + subunit, where each value is a separate row in the + finDeviceAttributeTable. Unless indicated with 'MULTI-ROW:' in the + finDeviceAttributeTypeTC description, an agent SHALL ensure that each + attribute occurs only once in the finDeviceAttributeTable for a + finishing subunit. Most of the 'MULTI-ROW' attributes do not allow + duplicate values, i.e., the agent SHALL ensure that each value occurs + only once for a finishing subunit. Only if the specification of the + 'MULTI-ROW' attribute also says "There is no restriction on the same + xxx occurring in multiple rows" can the agent allow duplicate values + to occur for a single finishing subunit. + +5.5. Linked MUTI-ROW Values + + Some MULTI-ROW attributes are intended to go together. Thus a set of + value instances represent a single instance. For example, the + puncher attributes indicate the location, maximum size, minimum size + and shape of the various holes that the puncher can produce. So the + first set of values could represent one kind of hole, and the second + set another kind of hole, etc. + +5.6. Index Value Attributes + + A number of attributes are indexes in other tables. Such attribute + names end with the word 'Index'. If the agent has not (yet) assigned + an index value for a particular index attribute for a finishing + subunit, the agent shall either: (1) return the value 0 or (2) not + add this attribute to the finDeviceAttributeTable until the index + + + + +Bergman, et al. Informational [Page 17] + +RFC 3806 Printer Finishing MIB June 2004 + + + value is assigned. In the interests of brevity, the semantics for 0 + is specified once here and is not repeated for each index attribute + specification and a DEFVAL of 0 is indicated. + +5.7. Attribute Specifications + + This section specifies the set of attributes that are enumerated in + finAttributeTypeTC. The data type tag definitions 'INTEGER:' or + 'OCTETS', indicate if the attribute can be represented using the + object finDeviceAttributeAsInteger or the object + finDeviceAttributeAsOctets, respectively. In some cases, a choice + between the two data types is possible and for a few attributes both + objects may be required at the same time to properly present the + value. + + NOTE - The enum assignments are grouped logically with values + assigned in groups of 10, so that additional values may be registered + in the future and assigned a value that is part of their logical + grouping. + + Values in the range 2**30 to 2**31-1 are reserved for private or + experimental usage. This range corresponds to the same range + reserved in IPP. Implementers are warned that use of such values may + conflict with other implementations. Implementers are encouraged to + request registration of enum values following the procedures in + Section 6.1. + + The attribute types defined at the time of completion of this + specification are: + + finAttributeTypeIndex Data type + --------------------- --------- + other(1), Integer32 + AND/OR + OCTET STRING (SIZE(0..63)) + INTEGER: and/or OCTETS: An attribute that is not currently + approved and registered. + + A. Generic finisher subunit attributes that apply to all finisher + subunit types. (3..) + + deviceName(3), OCTET STRING (SIZE(0..63)) + OCTETS: The name assigned to this finisher device subunit. + + deviceVendorName(4), OCTET STRING (SIZE(0..63)) + OCTETS: The name of the vendor of this finisher device + subunit. + + + + +Bergman, et al. Informational [Page 18] + +RFC 3806 Printer Finishing MIB June 2004 + + + deviceModel(5), OCTET STRING (SIZE(0..63)) + OCTETS: The model name of this finisher device subunit. + + deviceVersion(6), OCTET STRING (SIZE(0..63)) + OCTETS: The version string for this finisher device + subunit. + + deviceSerialNumber(7), OCTET STRING (SIZE(0..63)) + OCTETS: The serial number assigned to this finisher device + subunit. + + maximumSheets(8), Integer32 (-2..32767) + INTEGER: Defines the maximum number of media sheets that a + finisher device is able to process. + + finProcessOffsetUnits(9), PrtMediaUnitTC + INTEGER: An enumeration which defines the units of measure + for the attributes finAxisOffset, finHeadLocation, + punchHoleSizeLongDim, and punchHoleSizeShortDim. + + finReferenceEdge(10), FinEdgeTC + INTEGER: An enumeration which defines which edge of the + form is the reference for this finishing process. The + Finishing Process Axis will be parallel to this axis. + + finAxisOffset(11), Integer32 (-2..2147483647) + INTEGER: Defines the offset of the Finishing Process + Axis from the parallel Reference Edge. For a value of + finEdgeTC equal to TopEdge or RightEdge, the value + given is to interpreted as a negative offset from the + reference edge. The units of measure are defined by the + attribute finProcessOffsetUnits. + + finJogEdge(12), FinEdgeTC + INTEGER: An enumeration which defines a second edge of the + document to which the media is aligned. The jog edge must + be perpendicular to the edge defined by finReferenceEdge. + + finHeadLocation(13), Integer32 (-2..2147483647) + INTEGER: MULTI-ROW: Defines the position of the Head + Mechanism relative to the axis, 'X' or 'Y', that is + perpendicular to the Process Axis. The units of measure + are defined by the attribute finProcessOffsetUnits. + + finOperationRestrictions(14), Integer32 (0..65535) + INTEGER: MULTI-ROW: Defines the finDeviceIndex of a + finishing process which cannot be combined with the + process defined by the finDeviceIndex for this + + + +Bergman, et al. Informational [Page 19] + +RFC 3806 Printer Finishing MIB June 2004 + + + finDeviceAttributeTable instance. When this condition + occurs this attribute SHALL be presented in the + attribute tables for both finishing processes that cannot + be combined. + + finNumberOfPositions(15), Integer32 (0..65535) + INTEGER: Defines the total number of head positions for + this finishing process. Each position many be realized by + a unique head mechanism or a single head mechanism may be + automatically moved to each position. + + namedConfiguration(16), OCTET STRING (SIZE(0..63)) + OCTETS: Contains an administratively define name to define + the finishing specification configured for this device. + + finMediaTypeRestriction(17), OCTET STRING (SIZE(0..63)) + OCTETS: MULTI-ROW: Defines the media type which cannot be + combined with the process defined by the finDeviceIndex + for this finDeviceAttributeTable instance. Values are the + same as defined for finSupplyMediaInputMediaName. + + finPrinterInputTraySupported(18), Integer32 (0..65535) + INTEGER: MULTI-ROW: Defines the value of prtInputIndex + corresponding to the printer input tray that can be used + with the process defined by the finDeviceIndex for this + finDeviceAttributeTable instance. If this attribute is + not present, this process can be used with any input tray + in the printer. For example, this attribute can indicate + the current stapling capabilities for a stapler device + for the input trays that depend upon the size and feed + orientation. So if there were two letter trays, one with + A size and the other with B size, a two position stapler + might specify in one row: upper-left and upper-right for + the input tray with A size, but only upper-left for the + one with B size. + + finPreviousFinishingOperation(19), Integer32 (0..65535) + INTEGER: Defines the finDeviceIndex of the previous + finishing process for implementations in which the + finishing processes are performed in a prescribed order. + Each finishing process in the fixed sequence is either + performed or not performed according to the finishing + instructions submitted with the job. A value of 0 + indicates that this finishing process is the first in a + sequence. Finishing processes which are not part of a + fixed sequence SHALL NOT have this attribute. + + + + + +Bergman, et al. Informational [Page 20] + +RFC 3806 Printer Finishing MIB June 2004 + + + finNextFinishingOperation(20), Integer32 (0..65535) + INTEGER: Defines the finDeviceIndex of the next finishing + process for implementations in which the finishing + processes are performed in a prescribed order. Each + finishing process in the fixed sequence is either + performed or not performed according to the finishing + instructions submitted with the job. A value of 0 + indicates that this finishing process is the last in a + sequence. Finishing processes which are not part of a + fixed sequence SHALL NOT have this attribute. + + B. Stitcher type-specific attributes (30..) + + stitchingType(30), FinStitchingTypeTC + INTEGER: MULTI-ROW: Provides additional information + regarding the stitching operation. + + stitchingDirection(31), FinStitchingDirTypeTC + INTEGER: Defines the orientation of the stitching + process. + + stitchingAngle(32), FinStitchingAngleTypeTC + INTEGER: Defines enumerations that describe the angular + orientation of the stitching process relative to the 'X' + axis. + + C. Folder type-specific attributes (40..) + + foldingType(40), FinFoldingTypeTC + INTEGER: Provides additional information regarding the + folding process. + + D. Binder type-specific attributes (50..) + + bindingType(50), FinBindingTypeTC + INTEGER: Provides additional information regarding the + binding process. + + E. Trimmer type-specific attributes (60..) + + F. Die cutter type-specific attributes (70..) + + G. Puncher type-specific attributes (80..) + + punchHoleType(80), FinPunchHoleTypeTC + INTEGER: Provides information regarding the shape of the + punched hole. + + + + +Bergman, et al. Informational [Page 21] + +RFC 3806 Printer Finishing MIB June 2004 + + + punchHoleSizeLongDim(81), Integer32 (-2..2147483647) + INTEGER: Defines the size of the punched hole in the + longest dimension. This dimension is typically measured + parallel to either the long edge or the short edge of the + media and the longest dimension will always be measured 90 + degrees from the shortest dimension. For a symmetrical + hole, such as a round or square hole, the shortest and + longest dimensions will be identical. The units of measure + are defined by the attribute finProcessOffsetUnits. + + punchHoleSizeShortDim(82), Integer32 (-2..2147483647) + INTEGER: Defines the size of the punched hole in the + shortest dimension. This dimension is typically measured + parallel to either the long edge or the short edge of the + media and the shortest dimension will always be measured + 90 degrees from the longest dimension. For a symmetrical + hole, such as a round or square hole, the shortest and + longest dimensions will be identical. The units of measure + are defined by the attribute finProcessOffsetUnits. + + punchPattern(83), FinPunchPatternTC + INTEGER: Defines the hole pattern produced by the punch + process. + + H. Perforator type-specific attributes (90..) + + I. Slitter type-specific attributes (100..) + + slittingType(100), FinSlittingTypeTC + INTEGER: Provides additional information regarding the + slitting process. + + J. Separation cutter type-specific attributes (110..) + + K. Imprinter type-specific attributes (120..) + + L. Wrapper type-specific attributes (130..) + + wrappingType(130), FinWrappingTypeTC + INTEGER: Provides additional information regarding the + wrapping process. + + M. Bander type-specific attributes (140..) + + N. Make Envelopes type-specific attributes (150..) + + O. Stacker type-specific attributes (160..) + + + + +Bergman, et al. Informational [Page 22] + +RFC 3806 Printer Finishing MIB June 2004 + + + stackOutputType(160) FinStackOutputTypeTC + INTEGER: Defines the job-to-job orientation produced by + the stacker. + + stackOffset(161) Integer32 (-2..2147483647) + INTEGER: Defines the copy-to-copy output stack offset as + a positive offset distance. The units of measure are + defined by finProcessOffsetUnits. + + stackRotation(162) Integer32 (-2..180) + INTEGER: Defines the copy-to-copy output stack rotation + measured in degrees. The value is the positive + copy-to-copy rotation." + +6. Enumerations + + Enumerations (enums) are sets of symbolic values defined for use with + one or more objects. Commonly used enumeration sets are assigned a + symbolic data type name (textual convention), rather than being + specified in the SYNTAX clause of each individual object definition. + + Textual conventions defined in the Finisher MIB or the companion IANA + Finisher MIB are extensible by RFC publication or Designated Expert + Review (see 'IANA Considerations' section of this Finisher MIB and + the DESCRIPTION clause in MODULE-IDENTITY of IANA Finisher MIB). All + of these textual conventions are: + + a) used more than once in the Finisher MIB itself; or + + b) imported and used in any other, including vendor private, MIB + modules. + + The Finisher MIB has also defined the following special values for + use with objects of the syntax "Integer32" to define conditions that + are outside of the normal numeric range: other(-1), unknown(-2), and + partial(-3). The 'partial' value means that there is some supply + remaining (but the amount is indeterminate) or there is some capacity + remaining (but the amount is indeterminate). The Integer32 range + field indicates in which objects these special values are valid. + +6.1. Registering Additional Enumerated Values + + The Finisher MIB and the companion IANA Finisher MIB each defines one + category of textual convention, according to the process employed to + control the addition of new enumerations: + + + + + + +Bergman, et al. Informational [Page 23] + +RFC 3806 Printer Finishing MIB June 2004 + + + Type 1 - All of the legal values are defined in the Finisher MIB. + Additional enumerated values require the publication of a new + Finisher MIB. + + Type 2 - All of the legal values are registered in the IANA + Finisher MIB. Additional enumerated values require a Designated + Expert Review defined in "Guidelines for Writing an IANA + Considerations Section in RFCs" [RFC2434]. The Designated Expert + will be selected by the IETF Area Director(s) of the Applications + Area. + +7. IANA Printer Finishing MIB Specification + +IANA-FINISHER-MIB DEFINITIONS ::= BEGIN + -- http://www.iana.org/assignments/ianafinisher-mib + +IMPORTS + MODULE-IDENTITY, + mib-2 + FROM SNMPv2-SMI -- [RFC2578] + TEXTUAL-CONVENTION + FROM SNMPv2-TC; -- [RFC2579] + +ianafinisherMIB MODULE-IDENTITY + LAST-UPDATED "200406020000Z" -- June 2, 2004 + ORGANIZATION "IANA" + CONTACT-INFO "Internet Assigned Numbers Authority + + Postal: ICANN + 4676 Admiralty Way, Suite 330 + Marina del Rey, CA 90292 + + Tel: +1 310 823 9358 + E-Mail: iana@iana.org" + + DESCRIPTION "This MIB module defines a set of finishing-related + TEXTUAL-CONVENTIONs for use in Finisher MIB (RFC 3806) + and other MIBs which need to specify finishing + mechanism details. + + Any additions or changes to the contents of this MIB + module require either publication of an RFC, or + Designated Expert Review as defined in RFC 2434, + Guidelines for Writing an IANA Considerations Section + in RFCs. The Designated Expert will be selected by + the IESG Area Director(s) of the Applications Area. + + Copyright (C) The Internet Society (2004). The + + + +Bergman, et al. Informational [Page 24] + +RFC 3806 Printer Finishing MIB June 2004 + + + initial version of this MIB module was published + in RFC 3806. For full legal notices see the RFC + itself or see: + http://www.ietf.org/copyrights/ianamib.html" + + REVISION "200406020000Z" -- June 2, 2004 + DESCRIPTION "Original version, published in coordination + with Finisher MIB (RFC 3806)." + + ::= { mib-2 110 } + +-- TEXTUAL-CONVENTIONs for this MIB module + +FinDeviceTypeTC ::= TEXTUAL-CONVENTION + STATUS current + DESCRIPTION + "The defined finishing device subunit process + enumerations." + SYNTAX INTEGER { + other(1), + unknown(2), + stitcher(3), + folder(4), + binder(5), + trimmer(6), + dieCutter(7), + puncher(8), + perforater(9), + slitter(10), + separationCutter(11), + imprinter(12), + wrapper(13), + bander(14), + makeEnvelope(15), + stacker(16), + sheetRotator(17), + inserter(18) + } + +FinAttributeTypeTC ::= TEXTUAL-CONVENTION + STATUS current + DESCRIPTION + "This TEXTUAL-CONVENTION defines the set of enums for use in + the finDeviceAttributeTable. See section 5.7 for the complete + specification of each attribute." + SYNTAX INTEGER { + other(1), + deviceName(3), + + + +Bergman, et al. Informational [Page 25] + +RFC 3806 Printer Finishing MIB June 2004 + + + deviceVendorName(4), + deviceModel(5), + deviceVersion(6), + deviceSerialNumber(7), + maximumSheets(8), + finProcessOffsetUnits(9), + finReferenceEdge(10), + finAxisOffset(11), + finJogEdge(12), + finHeadLocation(13), + finOperationRestrictions(14), + finNumberOfPositions(15), + namedConfiguration(16), + finMediaTypeRestriction(17), + finPrinterInputTraySupported(18), + finPreviousFinishingOperation(19), + finNextFinishingOperation(20), + stitchingType(30), + stitchingDirection(31), + foldingType(40), + bindingType(50), + punchHoleType(80), + punchHoleSizeLongDim(81), + punchHoleSizeShortDim(82), + punchPattern(83), + slittingType(100), + wrappingType(130), + stackOutputType(160), + stackOffset(161), + stackRotation(162) + } + +FinEdgeTC ::= TEXTUAL-CONVENTION + STATUS current + DESCRIPTION + "Specifies an edge for a Finishing Process." + SYNTAX INTEGER { + topEdge(3), + bottomEdge(4), + leftEdge(5), + rightEdge(6) + } + +FinStitchingTypeTC ::= TEXTUAL-CONVENTION + STATUS current + DESCRIPTION + "The defined stitching type enumerations. For the edgeStitch and + stapleDual enums, the finReferenceEdge attribute is recommended + + + +Bergman, et al. Informational [Page 26] + +RFC 3806 Printer Finishing MIB June 2004 + + + to define the edge to which the operation applies." + SYNTAX INTEGER { + other(1), -- More information in other attributes + unknown(2), + stapleTopLeft(4), + stapleBottomLeft(5), + stapleTopRight(6), + stapleBottomRight(7), + saddleStitch(8), + edgeStitch(9), + stapleDual(10) + } + +FinStitchingDirTypeTC ::= TEXTUAL-CONVENTION + STATUS current + DESCRIPTION + "Defines the direction, relative to the top sheet in the output + subunit, that the stitching operation was performed. For a + topDown(3) process, the staple will be clinched on the bottom + of the stack. This parameter can be used to determine what + order the pages of a booklet are to be printed such that the + staple clinch will be on the inside of the resulting booklet." + SYNTAX INTEGER { + unknown(2), + topDown(3), + bottomUp(4) + } + +FinStitchingAngleTypeTC ::= TEXTUAL-CONVENTION + STATUS current + DESCRIPTION + "This enumeration provides a description of the angular + orientation of each stitch in a single or multiple stitching + operation, relative to the 'X' axis. As with all finishing + operations, the 'X' axis is always relative to the portrait + orientation of the document regardless of the orientation + of the printed image. This enum is primarily applicable to + corner stitching operations." + SYNTAX INTEGER { + unknown(2), + horizontal(3), + vertical(4), + slanted(5) + } + +FinFoldingTypeTC ::= TEXTUAL-CONVENTION + STATUS current + DESCRIPTION + + + +Bergman, et al. Informational [Page 27] + +RFC 3806 Printer Finishing MIB June 2004 + + + "The defined folding device process enumerations." + SYNTAX INTEGER { + other(1), -- More information in other attributes + unknown(2), + zFold(3), + halfFold(4), + letterFold(5) + } + +FinBindingTypeTC ::= TEXTUAL-CONVENTION + STATUS current + DESCRIPTION + "The defined binding type enumerations." + SYNTAX INTEGER { + other(1), -- More information in other attributes + unknown(2), + tape(4), + plastic(5), + velo(6), + perfect(7), + spiral(8), + adhesive(9), + comb(10), + padding(11) + } + +FinPunchHoleTypeTC ::= TEXTUAL-CONVENTION + STATUS current + DESCRIPTION + "The defined hole type punch process enumerations." + SYNTAX INTEGER { + other(1), -- More information in other attributes + unknown(2), + round(3), + oblong(4), + square(5), + rectangular(6), + star(7) + } + +FinPunchPatternTC ::= TEXTUAL-CONVENTION + STATUS current + DESCRIPTION + "The defined hole pattern punch process enumerations." + SYNTAX INTEGER { + other(1), --Pattern to be defined in other attributes + unknown(2), + twoHoleUSTop(4), --Letter/legal, 8.5 inch edge + + + +Bergman, et al. Informational [Page 28] + +RFC 3806 Printer Finishing MIB June 2004 + + + threeHoleUS(5), --Letter/ledger, 11 inch edge + twoHoleDIN(6), --A4/A3, 297 mm edge + fourHoleDIN(7), --A4/A3, 297 mm edge + twentyTwoHoleUS(8), --Letter/ledger, 11 inch edge + nineteenHoleUS(9), --Letter/ledger, 11 inch edge + twoHoleMetric(10), --B5/B4, 257 mm edge + swedish4Hole(11), --A4/A3, 297 mm edge + twoHoleUSSide(12), --Letter/ledger, 11 inch edge + fiveHoleUS(13), --Letter/ledger, 11 inch edge + sevenHoleUS(14), --Letter/ledger, 11 inch edge + mixed7H4S(15), --A4/A3, 297 mm edge + norweg6Hole(16), --A4/A3, 297 mm edge + metric26Hole(17), --B5/B4, 257 mm edge + metric30Hole(18) --A4/A3, 297 mm edge + } + +FinSlittingTypeTC ::= TEXTUAL-CONVENTION + STATUS current + DESCRIPTION + "The defined slitting type enumerations." + SYNTAX INTEGER { + other(1), -- More information in other attributes + unknown(2), + slitAndSeparate(4), + slitAndMerge(5) + } + +FinWrappingTypeTC ::= TEXTUAL-CONVENTION + STATUS current + DESCRIPTION + "The defined wrapping device process enumerations." + SYNTAX INTEGER { + other(1), -- More information in other attributes + unknown(2), + shrinkWrap(4), + paperWrap(5) + } + +FinStackOutputTypeTC ::= TEXTUAL-CONVENTION + STATUS current + DESCRIPTION + "The defined stack output type enumerations." + SYNTAX INTEGER { + other(1), -- More information in other attributes + unknown(2), + straight(4), -- No offset, one on top of another + offset(5), + crissCross(6) -- Rotated + + + +Bergman, et al. Informational [Page 29] + +RFC 3806 Printer Finishing MIB June 2004 + + + } +END + +8. Printer Finishing MIB Specification + +Finisher-MIB DEFINITIONS ::= BEGIN + +IMPORTS + MODULE-IDENTITY, OBJECT-TYPE, Integer32, mib-2 + FROM SNMPv2-SMI -- [RFC2578] + MODULE-COMPLIANCE, OBJECT-GROUP + FROM SNMPv2-CONF -- [RFC2580] + hrDeviceIndex + FROM HOST-RESOURCES-MIB -- [RFC2790] + PrtInputTypeTC, PrtMarkerSuppliesTypeTC + FROM IANA-PRINTER-MIB -- [RFC3805] + printmib, PrtSubUnitStatusTC, PrtLocalizedDescriptionStringTC, + PrtMarkerSuppliesSupplyUnitTC, PrtMediaUnitTC, + PrtCapacityUnitTC, PrtMarkerSuppliesClassTC, + PresentOnOff, prtMIBConformance + FROM Printer-MIB -- [RFC3805] + FinDeviceTypeTC, FinAttributeTypeTC + FROM IANA-FINISHER-MIB; + +finisherMIB MODULE-IDENTITY + LAST-UPDATED "200406020000Z" + ORGANIZATION "PWG IEEE/ISTO Printer Working Group" + CONTACT-INFO + + "Harry Lewis + IBM + Phone (303) 924-5337 + Email: harryl@us.ibm.com + + Send comments to the printmib WG using the Finisher MIB + Project (FIN) Mailing List: fin@pwg.org + + For further information, access the PWG web page under 'Finisher + MIB': http://www.pwg.org/ + + Implementers of this specification are encouraged to join the + fin mailing list in order to participate in discussions on any + clarifications needed and registration proposals being reviewed + in order to achieve consensus." + DESCRIPTION + "The MIB module for management of printers. + Copyright (C) The Internet Society (2004). This + version of this MIB module was published + + + +Bergman, et al. Informational [Page 30] + +RFC 3806 Printer Finishing MIB June 2004 + + + in RFC 3806. For full legal notices see the RFC itself." + REVISION "200406020000Z" + DESCRIPTION + "The original version of this MIB." + ::= { mib-2 111 } + + -- Finisher Device Group (Mandatory) +-- +-- A printer may support zero or more finishing subunits. A +-- finishing device subunit may be associated with one or more +-- output subunits and one or more media path subunits. + +finDevice OBJECT IDENTIFIER ::= { printmib 30 } + +finDeviceTable OBJECT-TYPE + SYNTAX SEQUENCE OF FinDeviceEntry + MAX-ACCESS not-accessible + STATUS current + DESCRIPTION + "This table defines the finishing device subunits, + including information regarding possible configuration + options and the status for each finisher device subunit." + ::= { finDevice 1 } + +finDeviceEntry OBJECT-TYPE + SYNTAX FinDeviceEntry + MAX-ACCESS not-accessible + STATUS current + DESCRIPTION + "There is an entry in the finishing device table for each + possible finisher process. Each individual finisher process is + implemented by a finishing device represented in this table." + INDEX { hrDeviceIndex, finDeviceIndex } + ::= { finDeviceTable 1 } + +FinDeviceEntry ::= SEQUENCE { + finDeviceIndex Integer32, + finDeviceType FinDeviceTypeTC, + finDevicePresentOnOff PresentOnOff, + finDeviceCapacityUnit PrtCapacityUnitTC, + finDeviceMaxCapacity Integer32, + finDeviceCurrentCapacity Integer32, + finDeviceAssociatedMediaPaths OCTET STRING, + finDeviceAssociatedOutputs OCTET STRING, + finDeviceStatus PrtSubUnitStatusTC, + finDeviceDescription PrtLocalizedDescriptionStringTC + } + + + + +Bergman, et al. Informational [Page 31] + +RFC 3806 Printer Finishing MIB June 2004 + + +finDeviceIndex OBJECT-TYPE + SYNTAX Integer32 (1..65535) + MAX-ACCESS not-accessible + STATUS current + DESCRIPTION + "A unique value used to identify a finisher process. + Although these values may change due to a major + reconfiguration of the printer system (e.g., the addition + of new finishing processes), the values are normally + expected to remain stable across successive power cycles." + ::= { finDeviceEntry 1 } + +finDeviceType OBJECT-TYPE + SYNTAX FinDeviceTypeTC + MAX-ACCESS read-only + STATUS current + DESCRIPTION + "Defines the type of finishing process associated with this + table row entry." + ::= { finDeviceEntry 2 } + +finDevicePresentOnOff OBJECT-TYPE + SYNTAX PresentOnOff + MAX-ACCESS read-write + STATUS current + DESCRIPTION + "Indicates if this finishing device subunit is available + and whether the device subunit is enabled." + DEFVAL { notPresent } + ::= { finDeviceEntry 3 } + +finDeviceCapacityUnit OBJECT-TYPE + SYNTAX PrtCapacityUnitTC + MAX-ACCESS read-only + STATUS current + DESCRIPTION + "The unit of measure for specifying the capacity of this + finisher device subunit." + ::= { finDeviceEntry 4 } + +finDeviceMaxCapacity OBJECT-TYPE + SYNTAX Integer32 (-2..2147483647) + MAX-ACCESS read-write + STATUS current + DESCRIPTION + "The maximum capacity of this finisher device subunit in + finDeviceCapacityUnits. If the device can reliably sense + this value, the value is sensed by the finisher device + + + +Bergman, et al. Informational [Page 32] + +RFC 3806 Printer Finishing MIB June 2004 + + + and is read-only: otherwise the value may be written by a + management or control console application. The value (-1) + means other and specifically indicates that the device + places no restrictions on this parameter. The value (-2) + means unknown." + DEFVAL { -2 } -- unknown + ::= { finDeviceEntry 5 } + +finDeviceCurrentCapacity OBJECT-TYPE + SYNTAX Integer32 (-2..2147483647) + MAX-ACCESS read-write + STATUS current + DESCRIPTION + "The current capacity of this finisher device subunit in + finDeviceCapacityUnits. If the device can reliably sense + this value, the value is sensed by the finisher and is + read-only: otherwise the value may be written by a + management or control console application. The value (-1) + means other and specifically indicates that the device + places no restrictions on this parameter. The value (-2) + means unknown." + DEFVAL { -2 } -- unknown + ::= { finDeviceEntry 6 } + +finDeviceAssociatedMediaPaths OBJECT-TYPE + SYNTAX OCTET STRING (SIZE(1..63)) + MAX-ACCESS read-only + STATUS current + DESCRIPTION + "Indicates the media paths which can supply media for this + finisher device. The value of this object is a bit map in an + octet string with each position representing the value of a + prtMediaPathIndex. For a media path that can be a source + for this finisher device subunit, the bit position equal + to one less than the value of prtMediaPathIndex will be set. + The bits are numbered starting with the most significant bit of + the first byte being bit 0, the least significant bit of the + first byte being bit 7, the most significant of the second byte + being bit 8, and so on." + ::= { finDeviceEntry 7 } + +finDeviceAssociatedOutputs OBJECT-TYPE + SYNTAX OCTET STRING (SIZE(1..63)) + MAX-ACCESS read-only + STATUS current + DESCRIPTION + "Indicates the printer output subunits this finisher device + subunit services. The value of this object is a bit map in an + + + +Bergman, et al. Informational [Page 33] + +RFC 3806 Printer Finishing MIB June 2004 + + + octet string with each position representing the value of a + prtOutputIndex. For an output subunit that is serviced + by this finisher device subunit, the bit position equal + to one less than the value of prtOutputIndex will be set. + The bits are numbered starting with the most significant bit of + the first byte being bit 0, the least significant bit of the + first byte being bit 7, the most significant of the second byte + being bit 8, and so on." + ::= { finDeviceEntry 8 } + +finDeviceStatus OBJECT-TYPE + SYNTAX PrtSubUnitStatusTC + MAX-ACCESS read-only + STATUS current + DESCRIPTION + "Indicates the current status of this finisher device + subunit." + DEFVAL { 5 } -- unknown + ::= { finDeviceEntry 9 } + +finDeviceDescription OBJECT-TYPE + SYNTAX PrtLocalizedDescriptionStringTC + MAX-ACCESS read-only + STATUS current + DESCRIPTION + "A free form text description of this device subunit in the + localization specified by prtGeneralCurrentLocalization." + ::= { finDeviceEntry 10 } + + +-- Finisher Supply Group (Mandatory) +-- +-- A finisher device, but not all finisher devices, may have one or more +-- supplies associated with it. For example a finisher may use both +-- binding tape and stitching wire supplies. A finisher may also have +-- more than one source for a given type of supply e.g., multiple supply +-- sources of ink for imprinters. + +finSupply OBJECT IDENTIFIER ::= { printmib 31 } + +finSupplyTable OBJECT-TYPE + SYNTAX SEQUENCE OF FinSupplyEntry + MAX-ACCESS not-accessible + STATUS current + DESCRIPTION + "Each unique source of supply is an entry in the finisher + supply table. Each supply entry has its own + characteristics associated with it such as colorant and + + + +Bergman, et al. Informational [Page 34] + +RFC 3806 Printer Finishing MIB June 2004 + + + current supply level." + ::= { finSupply 1 } + +finSupplyEntry OBJECT-TYPE + SYNTAX FinSupplyEntry + MAX-ACCESS not-accessible + STATUS current + DESCRIPTION + "A list of finisher devices, with their associated + supplies and supplies characteristics." + INDEX { hrDeviceIndex, finSupplyIndex } + ::= { finSupplyTable 1 } + +FinSupplyEntry ::= SEQUENCE { + finSupplyIndex Integer32, + finSupplyDeviceIndex Integer32, + finSupplyClass PrtMarkerSuppliesClassTC, + finSupplyType PrtMarkerSuppliesTypeTC, + finSupplyDescription PrtLocalizedDescriptionStringTC, + finSupplyUnit PrtMarkerSuppliesSupplyUnitTC, + finSupplyMaxCapacity Integer32, + finSupplyCurrentLevel Integer32, + finSupplyColorName OCTET STRING + } + +finSupplyIndex OBJECT-TYPE + SYNTAX Integer32 (1..65535) + MAX-ACCESS not-accessible + STATUS current + DESCRIPTION + "A unique value used by a finisher to identify this supply + container/receptacle. Although these values may change + due to a major reconfiguration of the finisher (e.g., the + addition of new supply sources to the finisher), values + are normally expected to remain stable across successive + power cycles." + ::= { finSupplyEntry 1 } + +finSupplyDeviceIndex OBJECT-TYPE + SYNTAX Integer32 (0..65535) + MAX-ACCESS read-only + STATUS current + DESCRIPTION + "The value of finDeviceIndex corresponding to the finishing + device subunit with which this finisher supply is associated. + The value zero indicates the associated finishing device is + Unknown." + ::= { finSupplyEntry 2 } + + + +Bergman, et al. Informational [Page 35] + +RFC 3806 Printer Finishing MIB June 2004 + + +finSupplyClass OBJECT-TYPE + SYNTAX PrtMarkerSuppliesClassTC + MAX-ACCESS read-only + STATUS current + DESCRIPTION + "This value indicates whether this supply entity + represents a supply that is consumed or a container that + is filled." + ::= { finSupplyEntry 3 } + +finSupplyType OBJECT-TYPE + SYNTAX PrtMarkerSuppliesTypeTC + MAX-ACCESS read-only + STATUS current + DESCRIPTION + "The type of this supply." + ::= { finSupplyEntry 4 } + +finSupplyDescription OBJECT-TYPE + SYNTAX PrtLocalizedDescriptionStringTC + MAX-ACCESS read-only + STATUS current + DESCRIPTION + "The description of this supply/receptacle in text useful + for operators and management applications and in the + localization specified by prtGeneralCurrentLocalization." + ::= { finSupplyEntry 5 } + +finSupplyUnit OBJECT-TYPE + SYNTAX PrtMarkerSuppliesSupplyUnitTC + MAX-ACCESS read-only + STATUS current + DESCRIPTION + "Unit of measure of this finisher supply container or + receptacle." + ::= { finSupplyEntry 6 } + +finSupplyMaxCapacity OBJECT-TYPE + SYNTAX Integer32 (-2..2147483647) + MAX-ACCESS read-write + STATUS current + DESCRIPTION + "The maximum capacity of this supply container/receptacle + expressed in Supply Units. If this supply container/ + receptacle can reliably sense this value, the value is + sensed and is read-only; otherwise the value may be + written by a control panel or management application. The + value (-1) means other and places no restrictions on this + + + +Bergman, et al. Informational [Page 36] + +RFC 3806 Printer Finishing MIB June 2004 + + + parameter. The value (-2) means unknown." + DEFVAL { -2 } -- unknown + ::= { finSupplyEntry 7 } + +finSupplyCurrentLevel OBJECT-TYPE + SYNTAX Integer32 (-3..2147483647) + MAX-ACCESS read-write + STATUS current + DESCRIPTION + "The current level if this supply is a container; the + remaining space if this supply is a receptacle. If this + supply container/receptacle can reliably sense this value, + the value is sensed and is read-only; otherwise the value + may be written by a control panel or management + application. The value (-1) means other and places no + restrictions on this parameter. The value (-2) means + unknown. A value of (-3) means that the printer knows there + is some supply or remaining space." + DEFVAL { -2 } -- unknown + ::= { finSupplyEntry 8 } + + +-- Capacity Attribute Relationships +-- +-- MEDIA INPUT MEASUREMENT +-- +-- _______ | | +-- | | | +-- | | | | +-- | |_ _ _ _ _ _ _ _ _ _| ________________ |direction +-- | | | | v +-- MaxCapacity | | | +-- | | Sheets remaining | CurrentLevel +-- | | | | +-- v | | v +-- _______ +___________________+ _______ + + +finSupplyColorName OBJECT-TYPE + SYNTAX OCTET STRING (SIZE(0..63)) + MAX-ACCESS read-only + STATUS current + DESCRIPTION + "The name of the color associated with this supply." + + REFERENCE + "The PWG Standardized Media Names specification [PWGMEDIA], + section 4 Media Color Names, contains the recommended values + + + +Bergman, et al. Informational [Page 37] + +RFC 3806 Printer Finishing MIB June 2004 + + + for this object. Implementers may add additional string values. + The naming conventions in ISO 9070 are recommended in order to + avoid potential name clashes." + ::= { finSupplyEntry 9 } + + +-- Finisher Supply, Media Input Group (Conditionally Mandatory) +-- +-- A finisher device may have one or more associated supply media +-- inputs. Each entry in this table defines an input for a +-- supply media type such as inserts, covers, etc. +-- +-- This group is mandatory only if the printer system contains a +-- finisher device that requires a media supply used exclusively by a +-- finishing process. Examples are inserts or covers that are not +-- supplied by an input subunit that provides media to the marker. + +finSupplyMediaInput OBJECT IDENTIFIER ::= { printmib 32 } + +finSupplyMediaInputTable OBJECT-TYPE + SYNTAX SEQUENCE OF FinSupplyMediaInputEntry + MAX-ACCESS not-accessible + STATUS current + DESCRIPTION + "The input subunits associated with a finisher supply media + are each represented by an entry in this table." +::= { finSupplyMediaInput 1 } + +finSupplyMediaInputEntry OBJECT-TYPE + SYNTAX FinSupplyMediaInputEntry + MAX-ACCESS not-accessible + STATUS current + DESCRIPTION + "A list of finisher supply media input subunit features and + characteristics." + INDEX { hrDeviceIndex, finSupplyMediaInputIndex } + ::= { finSupplyMediaInputTable 1 } + +FinSupplyMediaInputEntry ::= SEQUENCE { + finSupplyMediaInputIndex Integer32, + finSupplyMediaInputDeviceIndex Integer32, + finSupplyMediaInputSupplyIndex Integer32, + finSupplyMediaInputType PrtInputTypeTC, + finSupplyMediaInputDimUnit PrtMediaUnitTC, + finSupplyMediaInputMediaDimFeedDir Integer32, + finSupplyMediaInputMediaDimXFeedDir Integer32, + finSupplyMediaInputStatus PrtSubUnitStatusTC, + finSupplyMediaInputMediaName OCTET STRING, + + + +Bergman, et al. Informational [Page 38] + +RFC 3806 Printer Finishing MIB June 2004 + + + finSupplyMediaInputName OCTET STRING, + finSupplyMediaInputDescription PrtLocalizedDescriptionStringTC, + finSupplyMediaInputSecurity PresentOnOff, + finSupplyMediaInputMediaWeight Integer32, + finSupplyMediaInputMediaThickness Integer32, + finSupplyMediaInputMediaType OCTET STRING + } + +finSupplyMediaInputIndex OBJECT-TYPE + SYNTAX Integer32 (1..65535) + MAX-ACCESS not-accessible + STATUS current + DESCRIPTION + "A unique value used by a finisher to identify this supply + media input subunit. Although these values may change + due to a major reconfiguration of the finisher (e.g., the + addition of new supply media input sources to the + finisher), values are normally expected to remain stable + across successive power cycles." + ::= { finSupplyMediaInputEntry 1 } + +finSupplyMediaInputDeviceIndex OBJECT-TYPE + SYNTAX Integer32 (0..65535) + MAX-ACCESS read-only + STATUS current + DESCRIPTION + "The value of finDeviceIndex corresponding to the finishing + device subunit with which this finisher media supply is + associated. The value zero indicates the associated device + is unknown." + ::= { finSupplyMediaInputEntry 2 } + +finSupplyMediaInputSupplyIndex OBJECT-TYPE + SYNTAX Integer32 (0..65535) + MAX-ACCESS read-only + STATUS current + DESCRIPTION + "The value of finSupplyIndex corresponding to the finishing + supply subunit with which this finisher media supply is + associated. The value zero indicates the associated finishing + supply is unknown or there is no applicable finisher supply + table entry." + ::= { finSupplyMediaInputEntry 3 } + +finSupplyMediaInputType OBJECT-TYPE + SYNTAX PrtInputTypeTC + MAX-ACCESS read-only + STATUS current + + + +Bergman, et al. Informational [Page 39] + +RFC 3806 Printer Finishing MIB June 2004 + + + DESCRIPTION + "The type of technology (discriminated primarily according + to the feeder mechanism type) employed by the input + subunit." + ::= { finSupplyMediaInputEntry 4 } + +finSupplyMediaInputDimUnit OBJECT-TYPE + SYNTAX PrtMediaUnitTC + MAX-ACCESS read-only + STATUS current + DESCRIPTION + "The unit of measure for specifying dimensional values for + this input device." + ::= { finSupplyMediaInputEntry 5 } + +finSupplyMediaInputMediaDimFeedDir OBJECT-TYPE + SYNTAX Integer32 (-2..2147483647) + MAX-ACCESS read-write + STATUS current + DESCRIPTION + "This object provides the value of the dimension in the + feed direction of the media that is placed or will be + placed in this input device. Feed dimension measurements + are taken parallel to the feed direction of the device and + measured in finSupplyMediaInputDimUnits. If this input + device can reliably sense this value, the value is sensed + and is read-only access. Otherwise the value is read-write + access and may be written by management or control panel + applications. The value (-1) means other and specifically + indicates that this device places no restrictions on this + parameter. The value (-2) indicates unknown. " + ::= { finSupplyMediaInputEntry 6 } + +finSupplyMediaInputMediaDimXFeedDir OBJECT-TYPE + SYNTAX Integer32 (-2..2147483647) + MAX-ACCESS read-write + STATUS current + DESCRIPTION + "This object provides the value of the dimension across the + feed direction of the media that is placed or will be + placed in this input device. The cross feed direction is + ninety degrees relative to the feed direction on this + device and measured in finSupplyMediaInputDimUnits. If + this input device can reliably sense this value, the value + is sensed and is read-only access. Otherwise the value is + read-write access and may be written by management or + control panel applications. The value (-1) means other and + specifically indicates that this device places no + + + +Bergman, et al. Informational [Page 40] + +RFC 3806 Printer Finishing MIB June 2004 + + + restrictions on this parameter. The value (-2) indicates + unknown. " + ::= { finSupplyMediaInputEntry 7 } + +finSupplyMediaInputStatus OBJECT-TYPE + SYNTAX PrtSubUnitStatusTC + MAX-ACCESS read-only + STATUS current + DESCRIPTION + "This value indicates the current status of this input + device." + DEFVAL { 5 } -- unknown + ::= { finSupplyMediaInputEntry 8 } + +finSupplyMediaInputMediaName OBJECT-TYPE + SYNTAX OCTET STRING (SIZE(0..63)) + MAX-ACCESS read-write + STATUS current + DESCRIPTION + "The name of the current media contained in this input + device. Examples are Engineering Manual Cover, Section A Tab + Divider or any ISO standard names." + ::= { finSupplyMediaInputEntry 9 } + +finSupplyMediaInputName OBJECT-TYPE + SYNTAX OCTET STRING (SIZE(0..63)) + MAX-ACCESS read-write + STATUS current + DESCRIPTION + "The name assigned to this input subunit." + ::= { finSupplyMediaInputEntry 10 } + +finSupplyMediaInputDescription OBJECT-TYPE + SYNTAX PrtLocalizedDescriptionStringTC + MAX-ACCESS read-only + STATUS current + DESCRIPTION + "A free form text description of this input subunit in the + localization specified by prtGeneralCurrentLocalization." + ::= { finSupplyMediaInputEntry 11 } + +finSupplyMediaInputSecurity OBJECT-TYPE + SYNTAX PresentOnOff + MAX-ACCESS read-write + STATUS current + DESCRIPTION + "Indicates if this subunit has some security associated + with it." + + + +Bergman, et al. Informational [Page 41] + +RFC 3806 Printer Finishing MIB June 2004 + + + ::= { finSupplyMediaInputEntry 12 } + +finSupplyMediaInputMediaWeight OBJECT-TYPE + SYNTAX Integer32 + MAX-ACCESS read-write + STATUS current + DESCRIPTION + "The weight of the media associated with this Input device + in grams per meter squared. The value (-1) means other + and specifically indicates that the device places no + restriction on this parameter. The value (-2) means + unknown. This object can be used to calculate the weight + of individual pages processed by the document finisher. + This value, when multiplied by the number of pages in a + finished set, can be used to calculate the weight of a set + before it is inserted into a mailing envelope." + ::= { finSupplyMediaInputEntry 13 } + +finSupplyMediaInputMediaThickness OBJECT-TYPE + SYNTAX Integer32 (-2..2147483647) + MAX-ACCESS read-write + STATUS current + DESCRIPTION + "This object identifies the thickness of the input media + processed by this document input subunit measured in + micrometers. This value may be used by devices (or + operators) to set up proper machine tolerances for the + feeder operation. The value (-2) indicates that the media + thickness is unknown or not used in the setup for this + input subunit." + ::= { finSupplyMediaInputEntry 14 } + +finSupplyMediaInputMediaType OBJECT-TYPE + SYNTAX OCTET STRING (SIZE(0..63)) + MAX-ACCESS read-write + STATUS current + DESCRIPTION + "The name of the type of medium associated with this input + subunit. " + + REFERENCE + "The PWG Standardized Media Names specification [PWGMEDIA], + section 3 Media Type Names, contains the recommended values + for this object. Implementers may add additional string values. + The naming conventions in ISO 9070 are recommended in order to + avoid potential name clashes." + ::= { finSupplyMediaInputEntry 15 } + + + + +Bergman, et al. Informational [Page 42] + +RFC 3806 Printer Finishing MIB June 2004 + + +-- Finisher Device Attribute Group (Mandatory) +-- +-- A finisher device subunit may have one or more parameters that +-- cannot be specified by any other objects in the MIB. The +-- Device Attribute group facilitates the definition of these +-- parameters. The objects which define the attributes are +-- read-write, to allow both Set and Get operations. +-- +-- At least one table entry must exist for each finisher device defined +-- by the MIB. If no other entry is possible for a finisher device, the +-- deviceName(3) attribute MUST be returned. + +finDeviceAttribute OBJECT IDENTIFIER ::= { printmib 33 } + +finDeviceAttributeTable OBJECT-TYPE + SYNTAX SEQUENCE OF FinDeviceAttributeEntry + MAX-ACCESS not-accessible + STATUS current + DESCRIPTION + "The attribute table defines special parameters that are + applicable only to a minority of the finisher devices. + An attribute table entry is used, rather than unique + objects, to minimize the number of MIB objects and to + allow for expansion without the addition of MIB objects. + Each finisher device is represented by a separate row + in the device subunit attribute table." +::= { finDeviceAttribute 1 } + +finDeviceAttributeEntry OBJECT-TYPE + SYNTAX FinDeviceAttributeEntry + MAX-ACCESS not-accessible + STATUS current + DESCRIPTION + "Each entry defines a finisher function parameter that + cannot be represented by an object in the finisher + device subunit table." + INDEX { hrDeviceIndex, finDeviceIndex, + finDeviceAttributeTypeIndex, + finDeviceAttributeInstanceIndex } +::= { finDeviceAttributeTable 1 } + +FinDeviceAttributeEntry ::= SEQUENCE { + finDeviceAttributeTypeIndex FinAttributeTypeTC, + finDeviceAttributeInstanceIndex Integer32, + finDeviceAttributeValueAsInteger Integer32, + finDeviceAttributeValueAsOctets OCTET STRING + } + + + + +Bergman, et al. Informational [Page 43] + +RFC 3806 Printer Finishing MIB June 2004 + + +finDeviceAttributeTypeIndex OBJECT-TYPE + SYNTAX FinAttributeTypeTC + MAX-ACCESS not-accessible + STATUS current + DESCRIPTION + "Defines the attribute type represented by this row." + ::= { finDeviceAttributeEntry 1 } + +finDeviceAttributeInstanceIndex OBJECT-TYPE + SYNTAX Integer32 (1..65535) + MAX-ACCESS not-accessible + STATUS current + DESCRIPTION + "An index that allows the discrimination of an attribute + instance when the same attribute occurs multiple times for + a specific instance of a finisher function. The value of + this index shall be 1 if only a single instance of the + attribute occurs for the specific finisher function. + Additional values shall be assigned in a contiguous manner." + ::= { finDeviceAttributeEntry 2 } + +finDeviceAttributeValueAsInteger OBJECT-TYPE + SYNTAX Integer32 (-2..2147483647) + MAX-ACCESS read-write + STATUS current + DESCRIPTION + "Defines the integer value of the attribute. The value of + the attribute is represented as an integer if the + finAttributeTypeTC description for the attribute has the + tag 'INTEGER:'. + + Depending upon the attribute enum definition, this object + may be either an integer, a counter, an index, or an enum. + Attributes for which the concept of an integer value is + not meaningful SHALL return a value of -1 for this + attribute." + DEFVAL { -2 } -- unknown + ::= { finDeviceAttributeEntry 3 } + +finDeviceAttributeValueAsOctets OBJECT-TYPE + SYNTAX OCTET STRING (SIZE(0..63)) + MAX-ACCESS read-write + STATUS current + DESCRIPTION + "Contains the octet string value of the attribute. The + value of the attribute is represented as a string if the + finAttributeTypeTC description for the attribute has the + tag 'OCTETS:'. + + + +Bergman, et al. Informational [Page 44] + +RFC 3806 Printer Finishing MIB June 2004 + + + Depending upon the attribute enum definition, this object + may be either a coded character set string (text) or a + binary octet string. Attributes for which the concept of + an octet string value is not meaningful SHALL contain a + zero length string." + DEFVAL { ''H } -- empty string + ::= { finDeviceAttributeEntry 4 } + + +-- Conformance Information + +-- compliance statements + +finMIBCompliance MODULE-COMPLIANCE + STATUS current + DESCRIPTION + "The compliance statement for agents that implement the + finisher MIB." + MODULE -- this module + MANDATORY-GROUPS { finDeviceGroup, finSupplyGroup, + finDeviceAttributeGroup } + + OBJECT finDevicePresentOnOff + MIN-ACCESS read-only + DESCRIPTION + "It is conformant to implement this object as read-only." + + OBJECT finDeviceMaxCapacity + MIN-ACCESS read-only + DESCRIPTION + "It is conformant to implement this object as read-only." + + OBJECT finDeviceCurrentCapacity + MIN-ACCESS read-only + DESCRIPTION + "It is conformant to implement this object as read-only." + + OBJECT finSupplyMaxCapacity + MIN-ACCESS read-only + DESCRIPTION + "It is conformant to implement this object as read-only." + + OBJECT finSupplyCurrentLevel + MIN-ACCESS read-only + DESCRIPTION + "It is conformant to implement this object as read-only." + + OBJECT finSupplyMediaInputMediaDimFeedDir + + + +Bergman, et al. Informational [Page 45] + +RFC 3806 Printer Finishing MIB June 2004 + + + MIN-ACCESS read-only + DESCRIPTION + "It is conformant to implement this object as read-only." + + OBJECT finSupplyMediaInputMediaDimXFeedDir + MIN-ACCESS read-only + DESCRIPTION + "It is conformant to implement this object as read-only." + + OBJECT finSupplyMediaInputMediaName + MIN-ACCESS read-only + DESCRIPTION + "It is conformant to implement this object as read-only." + + OBJECT finSupplyMediaInputName + MIN-ACCESS read-only + DESCRIPTION + "It is conformant to implement this object as read-only." + + OBJECT finSupplyMediaInputSecurity + MIN-ACCESS read-only + DESCRIPTION + "It is conformant to implement this object as read-only." + + OBJECT finSupplyMediaInputMediaWeight + MIN-ACCESS read-only + DESCRIPTION + "It is conformant to implement this object as read-only." + + OBJECT finSupplyMediaInputMediaThickness + MIN-ACCESS read-only + DESCRIPTION + "It is conformant to implement this object as read-only." + + OBJECT finSupplyMediaInputMediaType + MIN-ACCESS read-only + DESCRIPTION + "It is conformant to implement this object as read-only." + + OBJECT finDeviceAttributeValueAsInteger + MIN-ACCESS read-only + DESCRIPTION + "It is conformant to implement this object as read-only." + + OBJECT finDeviceAttributeValueAsOctets + MIN-ACCESS read-only + DESCRIPTION + "It is conformant to implement this object as read-only." + + + +Bergman, et al. Informational [Page 46] + +RFC 3806 Printer Finishing MIB June 2004 + + + GROUP finSupplyMediaInputGroup + DESCRIPTION + "This group is conditionally mandatory and must be included + if a finisher device requires a media supply that is used + exclusively by a finishing process." + + ::= { prtMIBConformance 5 } + + +finMIBGroups OBJECT IDENTIFIER ::= { prtMIBConformance 6 } + +finDeviceGroup OBJECT-GROUP + OBJECTS { finDeviceType, finDevicePresentOnOff, + finDeviceCapacityUnit, finDeviceMaxCapacity, + finDeviceCurrentCapacity, finDeviceAssociatedMediaPaths, + finDeviceAssociatedOutputs, finDeviceStatus, + finDeviceDescription } + STATUS current + DESCRIPTION + "The finisher device group." + ::= { finMIBGroups 1 } + +finSupplyGroup OBJECT-GROUP + OBJECTS { finSupplyDeviceIndex, finSupplyClass, finSupplyType, + finSupplyDescription, finSupplyUnit, finSupplyMaxCapacity, + finSupplyCurrentLevel, finSupplyColorName } + STATUS current + DESCRIPTION + "The finisher supply group." + ::= { finMIBGroups 2 } + +finSupplyMediaInputGroup OBJECT-GROUP + OBJECTS { finSupplyMediaInputDeviceIndex, + finSupplyMediaInputSupplyIndex, finSupplyMediaInputType, + finSupplyMediaInputDimUnit, + finSupplyMediaInputMediaDimFeedDir, + finSupplyMediaInputMediaDimXFeedDir, + finSupplyMediaInputStatus, finSupplyMediaInputMediaName, + finSupplyMediaInputName, finSupplyMediaInputDescription, + finSupplyMediaInputSecurity, + finSupplyMediaInputMediaWeight, + finSupplyMediaInputMediaThickness, + finSupplyMediaInputMediaType } + STATUS current + DESCRIPTION + "The finisher supply, media input group." + ::= { finMIBGroups 3 } + + + + +Bergman, et al. Informational [Page 47] + +RFC 3806 Printer Finishing MIB June 2004 + + +finDeviceAttributeGroup OBJECT-GROUP + OBJECTS { finDeviceAttributeValueAsInteger, + finDeviceAttributeValueAsOctets } + STATUS current + DESCRIPTION + "The finisher device attribute group. This group is mandatory + for a finisher device that contains an inserter subunit." + ::= { finMIBGroups 4 } + +END + +9. IANA Considerations + + The initial version of the IANA Finisher MIB defined in section 7 of + this document is to be archived by IANA and subsequently maintained + according to the Process specified in section 6.1 of this document. + The most current and authoritative version of the IANA Finisher MIB + is available at: + + http://www.iana.org/assignments/ianafinisher-mib + +10. Internationalization Considerations + + See the Printer MIB [RFC3805] section 2.2.1.1, 'International + Considerations'. + +11. References + +11.1. Normative References + + [DPA] ISO/IEC 10175 Document Printing Application (DPA). See + ftp://ftp.pwg.org/pub/pwg/dpa/ + + [LMO] Large Mailing Operations Specification, DMTF. See + http://www.dmtf.org/tech/apps.html + + [PWGMEDIA] IEEE-ISTO PWG "The Printer Working Group Standard for + Media Standardized Names", IEEE-ISTO PWG 5101.1-2002. + + [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate + Requirement Levels", BCP 14, RFC 2119, March 1997. + + + + + + + + + + +Bergman, et al. Informational [Page 48] + +RFC 3806 Printer Finishing MIB June 2004 + + + [RFC2434] Narten, T. and H. Alvestrand, "Guidelines for Writing an + IANA Considerations Section in RFCs", BCP 26, RFC 2434, + October 1998. + + [RFC2578] McCloghrie, K., Perkins, D., and J. Schoenwaelder, + "Structure of Management Information Version 2 (SMIv2)", + STD 58, RFC 2578, April 1999. + + [RFC2579] McCloghrie, K., Perkins, D., and J. Schoenwaelder, + "Textual Conventions for SMIv2", STD 58, RFC 2579, April + 1999. + + [RFC2580] McCloghrie, K., Perkins, D., and J. Schoenwaelder, + "Conformance Statements for SMIv2", STD 58, RFC 2580, + April 1999. + + [RFC2790] Waldbusser, S. and P. Grillo, "Host Resources MIB", RFC + 2790, March 2000. + + [RFC3805] Bergman, R., Lewis, H., and I. McDonald, "The Printer MIB + v2", RFC 3805, June 2004. + +11.2. Informative References + + [RFC2911] Hastings, T. Ed., Herriot, R., deBry, R., Issacson, S., + and P. Powell, "Internet Printing Protocol/1.1: Model and + Semantics", RFC 2911, September 2000. + + [RFC3410] Case, J., Mundy, R., Partain, D., and B. Stewart, + "Introduction and Applicability Statements for Internet- + Standard Management Framework", RFC 3410, December 2002. + +12. Security Considerations + + There are a number of management objects defined in this MIB module + with a MAX-ACCESS clause of read-write and/or read-create. Such + objects may be considered sensitive or vulnerable in some network + environments. The support for SET operations in a non-secure + environment without proper protection can have a negative effect on + network operations. These are the tables and objects and their + sensitivity/vulnerability: + + finDeviceTable: + finDevicePresentOnOff -Possible severe inconvenience + finDeviceMaxCapacity -Possible minor inconvenience + finDeviceCurrentCapacity -Possible minor inconvenience + finSupplyTable: + finSupplyMaxCapacity -Possible minor inconvenience + + + +Bergman, et al. Informational [Page 49] + +RFC 3806 Printer Finishing MIB June 2004 + + + finSupplyCurrentLevel -Possible minor inconvenience + finSupplyMediaInputTable + finSupplyMediaInputMediaDimFeedDir -Possible severe inconvenience + finSupplyMediaInputMediaDimXFeedDir -Possible severe inconvenience + finSupplyMediaInputMediaName -Possible Minor inconvenience + finSupplyMediaInputName -Possible Minor inconvenience + finSupplyMediaInputSecurity -Possible Minor inconvenience + finSupplyMediaInputMediaWeight -Possible Minor inconvenience + finSupplyMediaInputMediaThickness -Possible Minor inconvenience + finSupplyMediaInputMediaType -Possible Minor inconvenience + finDeviceAttributeTable + finDeviceAttributeValueAsInteger -Possible Minor inconvenience + finDeviceAttributeValueAsOctets -Possible Minor inconvenience + + SNMP versions prior to SNMPv3 did not include adequate security. + Even if the network itself is secure (for example by using IPSec), + even then, there is no control as to who on the secure network is + allowed to access and GET/SET (read/change/create/delete) the objects + in this MIB module. + + It is RECOMMENDED that implementers consider the security features as + provided by the SNMPv3 framework (see [RFC3410], section 8), + including full support for the SNMPv3 cryptographic mechanisms (for + authentication and privacy). + + Further, deployment of SNMP versions prior to SNMPv3 is NOT + RECOMMENDED. Instead, it is RECOMMENDED to deploy SNMPv3 and to + enable cryptographic security. It is then a customer/operator + responsibility to ensure that the SNMP entity giving access to an + instance of this MIB module is properly configured to give access to + the objects only to those principals (users) that have legitimate + rights to indeed GET or SET (change/create/delete) them. + + Where the operational capability of the printing device are + especially vulnerable or difficult to administer, certain objects + within this MIB have been tagged as READ-ONLY, preventing + modification. Further, for all READ-WRITE objects within the MIB, the + working group has included specific conformance guidelines stating + that vendors are free to implement certain objects as READ-ONLY. This + conformance allowance should cover cases where specific vendor + vulnerabilities may differ from product to product. (See conformance + section with regards to MIN-ACCESS clauses). + + + + + + + + + +Bergman, et al. Informational [Page 50] + +RFC 3806 Printer Finishing MIB June 2004 + + +13. Acknowledgements + + The Printer MIB Working Group would like to extend a special thank + you to the following individuals that put forth a significant effort + to review this document and provide numerous suggestions for + improvement. + + David Harrington - Enterasys Networks + Juergen Schoenwaelder - TU Braunschweig + Bert Wijnen - Lucent Technologies and IETF Op & Mngmt, Area Director + + Other Participants: + + Chuck Adams - Tektronix + Carlos Becerra - HP + Andy Davidson - Tektronix + Mabry Dozier - QMS + Lee Farrell - Canon + Jennifer Gattis - Duplo USA + Paul Gloger - Xerox + Richard Hart - Digital + Tom Hastings - Xerox + Scott Isaacson - Novell + David Kellerman - Northlake Software + Henrik Holst - i-data International + Rick Landau - Digital + Jay Martin - Underscore + Gary Padlipski - Xerox + Kevin Palmer - Duplo USA + Bob Pentecost - HP + Stuart Rowley - Kyocera + Yuki Sacchi - Japan Computer Industry + Philip Thambidunai - Okidata + William Wagner - DPI/Osicom + Chris Wellens - Interworking Labs + Don Wright - Lexmark + Lloyd Young - Lexmark + + + + + + + + + + + + + + +Bergman, et al. Informational [Page 51] + +RFC 3806 Printer Finishing MIB June 2004 + + +14. Authors' Addresses + + Ron Bergman (Editor) + Hitachi Printing Solutions America + 2635 Park Center Drive + Simi Valley, CA 93065-6209 + + Phone: 805-578-4421 + Fax: 805-578-4001 + EMail: Ron.Bergman@hitachi-ps.us + + + Harry Lewis (Chairman) + IBM Corporation + 6300 Diagonal Hwy + Boulder, CO 80301 + + Phone: (303) 924-5337 + EMail: harryl@us.ibm.com + + + Ira McDonald + High North Inc. + P.O. Box 221 + Grand Marais, MI 49839 + + Phone: (906) 494-2434 or (906) 494-2697 + EMail: imcdonald@sharplabs.com + + Send comments to the Printer Working Group (PWG) using the Finisher + MIB Project (FIN) Mailing List: fin@pwg.org + + Implementers of this specification are encouraged to join this email + distribution list in order to participate in any discussions of + clarification issues and review registration proposals for + additional attributes and enum values. + + For further information, access the PWG web page under "FIN": + http://www.pwg.org/ + + + + + + + + + + + + +Bergman, et al. Informational [Page 52] + +RFC 3806 Printer Finishing MIB June 2004 + + +15. Full Copyright Statement + + Copyright (C) The Internet Society (2004). This document is subject + to the rights, licenses and restrictions contained in BCP 78, and + except as set forth therein, the authors retain all their rights. + + This document and the information contained herein are provided on an + "AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE REPRESENTS + OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY AND THE INTERNET + ENGINEERING TASK FORCE DISCLAIM ALL WARRANTIES, EXPRESS OR IMPLIED, + INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE + INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED + WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. + +Intellectual Property + + The IETF takes no position regarding the validity or scope of any + Intellectual Property Rights or other rights that might be claimed to + pertain to the implementation or use of the technology described in + this document or the extent to which any license under such rights + might or might not be available; nor does it represent that it has + made any independent effort to identify any such rights. Information + on the procedures with respect to rights in RFC documents can be + found in BCP 78 and BCP 79. + + Copies of IPR disclosures made to the IETF Secretariat and any + assurances of licenses to be made available, or the result of an + attempt made to obtain a general license or permission for the use of + such proprietary rights by implementers or users of this + specification can be obtained from the IETF on-line IPR repository at + http://www.ietf.org/ipr. + + The IETF invites any interested party to bring to its attention any + copyrights, patents or patent applications, or other proprietary + rights that may cover technology that may be required to implement + this standard. Please address the information to the IETF at ietf- + ipr@ietf.org. + +Acknowledgement + + Funding for the RFC Editor function is currently provided by the + Internet Society. + + + + + + + + + +Bergman, et al. Informational [Page 53] + |