Blame mibs/ietf/Job-Monitoring-MIB

Packit 022b05
Job-Monitoring-MIB DEFINITIONS ::= BEGIN
Packit 022b05
Packit 022b05
IMPORTS
Packit 022b05
    MODULE-IDENTITY, OBJECT-TYPE, enterprises,
Packit 022b05
    Integer32                                       FROM SNMPv2-SMI
Packit 022b05
    TEXTUAL-CONVENTION                              FROM SNMPv2-TC
Packit 022b05
    MODULE-COMPLIANCE, OBJECT-GROUP                 FROM SNMPv2-CONF;
Packit 022b05
    -- The following textual-conventions are needed to implement
Packit 022b05
    -- certain attributes, but are not needed to compile this MIB.
Packit 022b05
    -- They are provided here for convenience:
Packit 022b05
    -- hrDeviceIndex                        FROM HOST-RESOURCES-MIB
Packit 022b05
    -- DateAndTime                          FROM SNMPv2-TC
Packit 022b05
    -- PrtInterpreterLangFamilyTC,
Packit 022b05
    -- CodedCharSet                         FROM Printer-MIB
Packit 022b05
Packit 022b05
-- Use the enterprises arc assigned to the PWG which is pwg(2699).
Packit 022b05
-- Group all PWG mibs under mibs(1).
Packit 022b05
Packit 022b05
jobmonMIB MODULE-IDENTITY
Packit 022b05
    LAST-UPDATED "9902190000Z"
Packit 022b05
    ORGANIZATION "Printer Working Group (PWG)"
Packit 022b05
    CONTACT-INFO
Packit 022b05
        "Tom Hastings
Packit 022b05
        Postal:  Xerox Corp.
Packit 022b05
                 Mail stop ESAE-231
Packit 022b05
                 701 S. Aviation Blvd.
Packit 022b05
                 El Segundo, CA 90245
Packit 022b05
Packit 022b05
        Tel:     (301)333-6413
Packit 022b05
        Fax:     (301)333-5514
Packit 022b05
        E-mail:  hastings@cp10.es.xerox.com
Packit 022b05
Packit 022b05
        Send questions and comments to the Printer Working Group (PWG)
Packit 022b05
        using the Job Monitoring Project (JMP) Mailing List:
Packit 022b05
        jmp@pwg.org
Packit 022b05
Packit 022b05
        For further information, including how to subscribe to the
Packit 022b05
        jmp mailing list, access the PWG web page under 'JMP':
Packit 022b05
Packit 022b05
            http://www.pwg.org/
Packit 022b05
Packit 022b05
        Implementers of this specification are encouraged to join the
Packit 022b05
        jmp mailing list in order to participate in discussions on any
Packit 022b05
        clarifications needed and registration proposals being reviewed
Packit 022b05
        in order to achieve consensus."
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The MIB module for monitoring job in servers, printers, and
Packit 022b05
        other devices.
Packit 022b05
Packit 022b05
        Version: 1.0"
Packit 022b05
Packit 022b05
    -- revision history
Packit 022b05
    REVISION    "9902190000Z"
Packit 022b05
    DESCRIPTION " This version published as RFC 2707"
Packit 022b05
Packit 022b05
    ::= { enterprises pwg(2699)  mibs(1)  jobmonMIB(1) }
Packit 022b05
Packit 022b05
-- Textual conventions for this MIB module
Packit 022b05
Packit 022b05
JmUTF8StringTC ::= TEXTUAL-CONVENTION
Packit 022b05
    DISPLAY-HINT "255a"
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "To facilitate internationalization, this TC represents
Packit 022b05
        information taken from the ISO/IEC IS 10646-1 character set,
Packit 022b05
        encoded as an octet string using the UTF-8 character encoding
Packit 022b05
        scheme.
Packit 022b05
Packit 022b05
        See section 3.6.1, entitled: 'Text generated by the server or
Packit 022b05
        device'."
Packit 022b05
    SYNTAX      OCTET STRING (SIZE (0..63))
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
JmJobStringTC ::= TEXTUAL-CONVENTION
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "To facilitate internationalization, this TC represents
Packit 022b05
        information using any coded character set registered by IANA as
Packit 022b05
        specified in section 3.7.  While it is recommended that the
Packit 022b05
        coded character set be UTF-8 [UTF-8], the actual coded
Packit 022b05
        character set SHALL be indicated by the value of the
Packit 022b05
        jobCodedCharSet(8) attribute for the job.
Packit 022b05
Packit 022b05
        See section 3.6.2, entitled: 'Text supplied by the job
Packit 022b05
        submitter'."
Packit 022b05
    SYNTAX      OCTET STRING (SIZE (0..63))
Packit 022b05
Packit 022b05
JmNaturalLanguageTagTC  ::= TEXTUAL-CONVENTION
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "An IETF RFC 1766-compliant 'language tag', with zero or more
Packit 022b05
        sub-tags that identify a natural language.  While RFC 1766
Packit 022b05
        specifies that the US-ASCII values are case-insensitive, this
Packit 022b05
        MIB specification requires that all characters SHALL be lower
Packit 022b05
        case in order to simplify comparing by management applications.
Packit 022b05
Packit 022b05
        See section 3.6.1, entitled: 'Text generated by the server or
Packit 022b05
        device' and section 3.6.2, entitled: 'Text supplied by the job
Packit 022b05
        submitter'."
Packit 022b05
    SYNTAX      OCTET STRING (SIZE (0..63))
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
JmTimeStampTC ::= TEXTUAL-CONVENTION
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The simple time at which an event took place.  The units are
Packit 022b05
        in seconds since the system was booted.
Packit 022b05
Packit 022b05
        NOTE - JmTimeStampTC is defined in units of seconds, rather
Packit 022b05
        than 100ths of seconds, so as to be simpler for agents to
Packit 022b05
        implement (even if they have to implement the 100ths of a
Packit 022b05
        second to comply with implementing sysUpTime in MIB-II[mib-
Packit 022b05
        II].)
Packit 022b05
Packit 022b05
        NOTE - JmTimeStampTC is defined as an Integer32 so that it can
Packit 022b05
        be used as a value of an attribute, i.e., as a value of the
Packit 022b05
        jmAttributeValueAsInteger object.  The TimeStamp textual-
Packit 022b05
        convention defined in SNMPv2-TC [SMIv2-TC] is defined as an
Packit 022b05
        APPLICATION 3 IMPLICIT INTEGER tag, not an Integer32 which is
Packit 022b05
        defined in SNMPv2-SMI [SMIv2-TC] as UNIVERSAL 2 IMPLICIT
Packit 022b05
        INTEGER, so cannot be used in this MIB as one of the values of
Packit 022b05
        jmAttributeValueAsInteger."
Packit 022b05
    SYNTAX      INTEGER (0..2147483647)
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
JmJobSourcePlatformTypeTC ::= TEXTUAL-CONVENTION
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The source platform type that can submit jobs to servers or
Packit 022b05
        devices in any of the 3 configurations.
Packit 022b05
Packit 022b05
        This is a type 2 enumeration.  See Section 3.7.1.2.  See also
Packit 022b05
        IANA operating-system-names registry."
Packit 022b05
    SYNTAX      INTEGER {
Packit 022b05
        other(1),
Packit 022b05
        unknown(2),
Packit 022b05
        sptUNIX(3),           -- UNIX
Packit 022b05
        sptOS2(4),            -- OS/2
Packit 022b05
        sptPCDOS(5),          -- DOS
Packit 022b05
        sptNT(6),             -- NT
Packit 022b05
        sptMVS(7),            -- MVS
Packit 022b05
        sptVM(8),             -- VM
Packit 022b05
        sptOS400(9),          -- OS/400
Packit 022b05
        sptVMS(10),           -- VMS
Packit 022b05
        sptWindows(11),       -- Windows
Packit 022b05
        sptNetWare(12)        -- NetWare
Packit 022b05
    }
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
JmFinishingTC ::= TEXTUAL-CONVENTION
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The type of finishing operation.
Packit 022b05
Packit 022b05
        These values are the same as the enum values of the IPP
Packit 022b05
        'finishings' attribute.  See Section 3.7.1.2.
Packit 022b05
Packit 022b05
        other(1),
Packit 022b05
            Some other finishing operation besides one of the specified
Packit 022b05
            or registered values.
Packit 022b05
Packit 022b05
        unknown(2),
Packit 022b05
            The finishing is unknown.
Packit 022b05
Packit 022b05
        none(3),
Packit 022b05
            Perform no finishing.
Packit 022b05
Packit 022b05
        staple(4),
Packit 022b05
            Bind the document(s) with one or more staples. The exact
Packit 022b05
            number and placement of the staples is site-defined.
Packit 022b05
Packit 022b05
        punch(5),
Packit 022b05
            Holes are required in the finished document. The exact
Packit 022b05
            number and placement of the holes is site-defined.  The
Packit 022b05
            punch specification MAY be satisfied (in a site- and
Packit 022b05
            implementation-specific manner) either by
Packit 022b05
            drilling/punching, or by substituting pre-drilled media.
Packit 022b05
Packit 022b05
        cover(6),
Packit 022b05
            Select a non-printed (or pre-printed) cover for the
Packit 022b05
            document. This does not supplant the specification of a
Packit 022b05
            printed cover (on cover stock medium) by the document
Packit 022b05
            itself.
Packit 022b05
Packit 022b05
        bind(7)
Packit 022b05
            Binding is to be applied to the document; the type and
Packit 022b05
            placement of the binding is product-specific.
Packit 022b05
Packit 022b05
        This is a type 2 enumeration.  See Section 3.7.1.2."
Packit 022b05
    SYNTAX      INTEGER {
Packit 022b05
        other(1),
Packit 022b05
        unknown(2),
Packit 022b05
        none(3),
Packit 022b05
        staple(4),
Packit 022b05
        punch(5),
Packit 022b05
        cover(6),
Packit 022b05
        bind(7)
Packit 022b05
    }
Packit 022b05
Packit 022b05
Packit 022b05
JmPrintQualityTC ::= TEXTUAL-CONVENTION
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "Print quality settings.
Packit 022b05
Packit 022b05
        These values are the same as the enum values of the IPP 'print-
Packit 022b05
        quality' attribute.  See Section 3.7.1.2.
Packit 022b05
Packit 022b05
        This is a type 2 enumeration.  See Section 3.7.1.2."
Packit 022b05
    SYNTAX      INTEGER {
Packit 022b05
        other(1),    -- Not one of the specified or registered
Packit 022b05
                     -- values.
Packit 022b05
        unknown(2),  -- The actual value is unknown.
Packit 022b05
        draft(3),    -- Lowest quality available on the printer.
Packit 022b05
        normal(4),   -- Normal or intermediate quality on the
Packit 022b05
                     -- printer.
Packit 022b05
        high(5)      -- Highest quality available on the printer.
Packit 022b05
    }
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
JmPrinterResolutionTC ::= TEXTUAL-CONVENTION
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "Printer resolutions.
Packit 022b05
Packit 022b05
        Nine octets consisting of two 4-octet SIGNED-INTEGERs followed
Packit 022b05
        by a SIGNED-BYTE.  The values are the same as those specified
Packit 022b05
        in the Printer MIB [printmib]. The first SIGNED-INTEGER
Packit 022b05
        contains the value of prtMarkerAddressabilityXFeedDir.  The
Packit 022b05
        second SIGNED-INTEGER contains the value of
Packit 022b05
        prtMarkerAddressabilityFeedDir.  The SIGNED-BYTE contains the
Packit 022b05
        value of prtMarkerAddressabilityUnit.
Packit 022b05
Packit 022b05
        Note: the latter value is either 3 (tenThousandsOfInches) or 4
Packit 022b05
        (micrometers) and the addressability is in 10,000 units of
Packit 022b05
        measure. Thus the SIGNED-INTEGERs represent integral values in
Packit 022b05
        either dots-per-inch or dots-per-centimeter.
Packit 022b05
Packit 022b05
        The syntax is the same as the IPP 'printer-resolution'
Packit 022b05
        attribute.  See Section 3.7.1.2."
Packit 022b05
    SYNTAX      OCTET STRING (SIZE(9))
Packit 022b05
Packit 022b05
Packit 022b05
JmTonerEconomyTC ::= TEXTUAL-CONVENTION
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "Toner economy settings.
Packit 022b05
Packit 022b05
        This is a type 2 enumeration.  See Section 3.7.1.2."
Packit 022b05
    SYNTAX      INTEGER {
Packit 022b05
        unknown(2),    -- unknown.
Packit 022b05
        off(3),        -- Off.  Normal.  Use full toner.
Packit 022b05
        on(4)          -- On.  Use less toner than normal.
Packit 022b05
    }
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
JmBooleanTC ::= TEXTUAL-CONVENTION
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "Boolean true or false value.
Packit 022b05
Packit 022b05
        This is a type 2 enumeration.  See Section 3.7.1.2."
Packit 022b05
    SYNTAX      INTEGER {
Packit 022b05
        unknown(2),    -- unknown.
Packit 022b05
        false(3),      -- FALSE.
Packit 022b05
        true(4)        -- TRUE.
Packit 022b05
    }
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
JmMediumTypeTC ::= TEXTUAL-CONVENTION
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "Identifies the type of medium.
Packit 022b05
Packit 022b05
        other(1),
Packit 022b05
            The type is neither one of the values listed in this
Packit 022b05
            specification nor a registered value.
Packit 022b05
Packit 022b05
        unknown(2),
Packit 022b05
            The type is not known.
Packit 022b05
Packit 022b05
        stationery(3),
Packit 022b05
            Separately cut sheets of an opaque material.
Packit 022b05
Packit 022b05
        transparency(4),
Packit 022b05
            Separately cut sheets of a transparent material.
Packit 022b05
Packit 022b05
        envelope(5),
Packit 022b05
            Envelopes that can be used for conventional mailing
Packit 022b05
            purposes.
Packit 022b05
Packit 022b05
        envelopePlain(6),
Packit 022b05
            Envelopes that are not preprinted and have no windows.
Packit 022b05
Packit 022b05
        envelopeWindow(7),
Packit 022b05
            Envelopes that have windows for addressing purposes.
Packit 022b05
Packit 022b05
        continuousLong(8),
Packit 022b05
            Continuously connected sheets of an opaque material
Packit 022b05
            connected along the long edge.
Packit 022b05
Packit 022b05
        continuousShort(9),
Packit 022b05
            Continuously connected sheets of an opaque material
Packit 022b05
            connected along the short edge.
Packit 022b05
Packit 022b05
        tabStock(10),
Packit 022b05
            Media with tabs.
Packit 022b05
Packit 022b05
        multiPartForm(11),
Packit 022b05
            Form medium composed of multiple layers not pre-attached to
Packit 022b05
            one another;  each sheet MAY be drawn separately from an
Packit 022b05
            input source.
Packit 022b05
Packit 022b05
        labels(12),
Packit 022b05
            Label-stock.
Packit 022b05
Packit 022b05
        multiLayer(13)
Packit 022b05
            Form medium composed of multiple layers which are pre-
Packit 022b05
            attached to one another, e.g. for use with impact printers.
Packit 022b05
        This is a type 2 enumeration.  See Section 3.7.1.2.  These enum
Packit 022b05
        values correspond to the keyword name strings of the
Packit 022b05
        prtInputMediaType object in the Printer MIB [print-mib].  There
Packit 022b05
        is no printer description attribute in IPP/1.0 that represents
Packit 022b05
        these values."
Packit 022b05
    SYNTAX      INTEGER {
Packit 022b05
        other(1),
Packit 022b05
        unknown(2),
Packit 022b05
        stationery(3),
Packit 022b05
        transparency(4),
Packit 022b05
        envelope(5),
Packit 022b05
        envelopePlain(6),
Packit 022b05
        envelopeWindow(7),
Packit 022b05
        continuousLong(8),
Packit 022b05
        continuousShort(9),
Packit 022b05
        tabStock(10),
Packit 022b05
        multiPartForm(11),
Packit 022b05
        labels(12),
Packit 022b05
        multiLayer(13)
Packit 022b05
    }
Packit 022b05
Packit 022b05
Packit 022b05
JmJobCollationTypeTC ::= TEXTUAL-CONVENTION
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "This value is the type of job collation.  Implementations that
Packit 022b05
        don't support multiple documents or don't support multiple
Packit 022b05
        copies SHALL NOT support the uncollatedDocuments(5) value.
Packit 022b05
Packit 022b05
        This is a type 2 enumeration.  See Section 3.7.1.2. See also
Packit 022b05
        Section 3.4, entitled 'Monitoring Job Progress'."
Packit 022b05
    SYNTAX      INTEGER {
Packit 022b05
        other(1),
Packit 022b05
        unknown(2),
Packit 022b05
        uncollatedSheets(3),    -- sheets within each document copy
Packit 022b05
                                -- are not collated: 1 1 ..., 2 2 ...,
Packit 022b05
                                -- No corresponding value of IPP
Packit 022b05
                                -- "multiple-document-handling"
Packit 022b05
        collatedDocuments(4),   -- internal collated sheets,
Packit 022b05
                                -- documents: A, B, A, B, ...
Packit 022b05
                                -- Corresponds to IPP "multiple-
Packit 022b05
                                -- document-handling"='separate-
Packit 022b05
                                -- documents-collated-copies'
Packit 022b05
        uncollatedDocuments(5)  -- internal collated sheets,
Packit 022b05
                                -- documents: A, A, ..., B, B, ...
Packit 022b05
                                -- Corresponds to IPP "multiple-
Packit 022b05
                                -- document-handling"='separate-
Packit 022b05
                                -- documents-uncollated-copies'
Packit 022b05
    }
Packit 022b05
Packit 022b05
Packit 022b05
JmJobSubmissionIDTypeTC ::= TEXTUAL-CONVENTION
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "Identifies the format type of a job submission ID.
Packit 022b05
Packit 022b05
        Each job submission ID is a fixed-length, 48-octet printable
Packit 022b05
        US-ASCII [US-ASCII] coded character string containing no
Packit 022b05
        control characters, consisting of the fields defined in section
Packit 022b05
        3.5.1.
Packit 022b05
Packit 022b05
        This is like a type 2 enumeration.  See section 3.7.3."
Packit 022b05
    SYNTAX    OCTET STRING(SIZE(1)) -- ASCII '0'-'9', 'A'-'Z', 'a'-'z'
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
JmJobStateTC ::= TEXTUAL-CONVENTION
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The current state of the job (pending, processing, completed,
Packit 022b05
        etc.).  The following figure shows the normal job state
Packit 022b05
        transitions:
Packit 022b05
Packit 022b05
                                                    +----> canceled(7)
Packit 022b05
                                                   /
Packit 022b05
    +---> pending(3) -------> processing(5) ------+------> completed(9)
Packit 022b05
    |         ^                      ^             \
Packit 022b05
--->+         |                      |              +----> aborted(8)
Packit 022b05
    |         v                      v             /
Packit 022b05
    +---> pendingHeld(4)  processingStopped(6) ---+
Packit 022b05
Packit 022b05
Packit 022b05
                Figure 4 - Normal Job State Transitions
Packit 022b05
Packit 022b05
        Normally a job progresses from left to right.  Other state
Packit 022b05
        transitions are unlikely, but are not forbidden.  Not shown are
Packit 022b05
        the transitions to the canceled state from the pending,
Packit 022b05
        pendingHeld, and processingStopped states.
Packit 022b05
Packit 022b05
        Jobs in the pending, processing, and processingStopped states
Packit 022b05
        are called 'active', while jobs in the pendingHeld, canceled,
Packit 022b05
        aborted, and completed states are called 'inactive'.  Jobs
Packit 022b05
        reach one of the three terminal states: completed, canceled, or
Packit 022b05
        aborted, after the jobs have completed all activity, and all
Packit 022b05
        MIB objects and attributes have reached their final values for
Packit 022b05
        the job.
Packit 022b05
        These values are the same as the enum values of the IPP 'job-
Packit 022b05
        state' job attribute.  See Section 3.7.1.2.
Packit 022b05
Packit 022b05
        unknown(2),
Packit 022b05
            The job state is not known, or its state is indeterminate.
Packit 022b05
Packit 022b05
        pending(3),
Packit 022b05
            The job is a candidate to start processing, but is not yet
Packit 022b05
            processing.
Packit 022b05
Packit 022b05
        pendingHeld(4),
Packit 022b05
            The job is not a candidate for processing for any number of
Packit 022b05
            reasons but will return to the pending state as soon as the
Packit 022b05
            reasons are no longer present.  The job's
Packit 022b05
            jmJobStateReasons1 object and/or jobStateReasonsN (N=2..4)
Packit 022b05
            attributes SHALL indicate why the job is no longer a
Packit 022b05
            candidate for processing.  The reasons are represented as
Packit 022b05
            bits in the jmJobStateReasons1 object and/or
Packit 022b05
            jobStateReasonsN (N=2..4) attributes.  See the
Packit 022b05
            JmJobStateReasonsNTC (N=1..4) textual convention for the
Packit 022b05
            specification of each reason.
Packit 022b05
Packit 022b05
        processing(5),
Packit 022b05
            One or more of:
Packit 022b05
Packit 022b05
            1.  the job is using, or is attempting to use, one or
Packit 022b05
            more purely software processes that are analyzing,
Packit 022b05
            creating, or interpreting a PDL, etc.,
Packit 022b05
Packit 022b05
            2.  the job is using, or is attempting to use, one or
Packit 022b05
            more hardware devices that are interpreting a PDL,
Packit 022b05
            making mark on a medium, and/or performing finishing,
Packit 022b05
            such as stapling, etc.,  OR
Packit 022b05
Packit 022b05
            3. (configuration 2) the server has made the job ready
Packit 022b05
            for printing, but the output device is not yet printing
Packit 022b05
            it, either because the job hasn't reached the output
Packit 022b05
            device or because the job is queued in the output
Packit 022b05
            device or some other spooler, awaiting the output
Packit 022b05
            device to print it.
Packit 022b05
Packit 022b05
            When the job is in the processing state, the entire job
Packit 022b05
            state includes the detailed status represented in the
Packit 022b05
            device MIB indicated by the hrDeviceIndex value of the
Packit 022b05
            job's physicalDevice attribute, if the agent implements
Packit 022b05
            such a device MIB.
Packit 022b05
Packit 022b05
            Implementations MAY, though they NEED NOT, include
Packit 022b05
            additional values in the job's jmJobStateReasons1 object
Packit 022b05
            to indicate the progress of the job, such as adding the
Packit 022b05
            jobPrinting value to indicate when the device is actually
Packit 022b05
            making marks on a medium and/or the processingToStopPoint
Packit 022b05
            value to indicate that the server or device is in the
Packit 022b05
            process of canceling or aborting the job.
Packit 022b05
Packit 022b05
        processingStopped(6),
Packit 022b05
            The job has stopped while processing for any number of
Packit 022b05
            reasons and will return to the processing state as soon
Packit 022b05
            as the reasons are no longer present.
Packit 022b05
Packit 022b05
            The job's jmJobStateReasons1 object and/or the job's
Packit 022b05
            jobStateReasonsN (N=2..4) attributes MAY indicate why the
Packit 022b05
            job has stopped processing.  For example, if the output
Packit 022b05
            device is stopped, the deviceStopped value MAY be
Packit 022b05
            included in the job's jmJobStateReasons1 object.
Packit 022b05
Packit 022b05
            NOTE - When an output device is stopped, the device
Packit 022b05
            usually indicates its condition in human readable form
Packit 022b05
            at the device.  The management application can obtain
Packit 022b05
             more complete device status remotely by querying the
Packit 022b05
            appropriate device MIB using the job's deviceIndex
Packit 022b05
            attribute(s), if the agent implements such a device MIB
Packit 022b05
Packit 022b05
        canceled(7),
Packit 022b05
            A client has canceled the job and the server or device
Packit 022b05
            has completed canceling the job AND all MIB objects and
Packit 022b05
            attributes have reached their final values for the job.
Packit 022b05
            While the server or device is canceling the job, the
Packit 022b05
            job's jmJobStateReasons1 object SHOULD contain the
Packit 022b05
            processingToStopPoint value and one of the
Packit 022b05
            canceledByUser, canceledByOperator, or canceledAtDevice
Packit 022b05
            values.  The canceledByUser, canceledByOperator, or
Packit 022b05
            canceledAtDevice values remain while the job is in the
Packit 022b05
            canceled state.
Packit 022b05
Packit 022b05
        aborted(8),
Packit 022b05
            The job has been aborted by the system, usually while the
Packit 022b05
            job was in the processing or processingStopped state and
Packit 022b05
            the server or device has completed aborting the job AND
Packit 022b05
            all MIB objects and attributes have reached their final
Packit 022b05
            values for the job.  While the server or device is
Packit 022b05
            aborting the job, the job's jmJobStateReasons1 object MAY
Packit 022b05
            contain the processingToStopPoint and abortedBySystem
Packit 022b05
            values.  If implemented, the abortedBySystem value SHALL
Packit 022b05
            remain while the job is in the aborted state.
Packit 022b05
        completed(9)
Packit 022b05
            The job has completed successfully or with warnings or
Packit 022b05
            errors after processing and all of the media have been
Packit 022b05
            successfully stacked in the appropriate output bin(s) AND
Packit 022b05
            all MIB objects and attributes have reached their final
Packit 022b05
            values for the job.  The job's jmJobStateReasons1 object
Packit 022b05
            SHOULD contain one of: completedSuccessfully,
Packit 022b05
            completedWithWarnings, or completedWithErrors values.
Packit 022b05
Packit 022b05
        This is a type 2 enumeration.  See Section 3.7.1.2."
Packit 022b05
    SYNTAX      INTEGER {
Packit 022b05
        unknown(2),
Packit 022b05
        pending(3),
Packit 022b05
        pendingHeld(4),
Packit 022b05
        processing(5),
Packit 022b05
        processingStopped(6),
Packit 022b05
        canceled(7),
Packit 022b05
        aborted(8),
Packit 022b05
        completed(9)
Packit 022b05
    }
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
JmAttributeTypeTC ::= TEXTUAL-CONVENTION
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The type of the attribute which identifies the attribute.
Packit 022b05
Packit 022b05
        NOTE - The enum assignments are grouped logically with values
Packit 022b05
        assigned in groups of 20, so that additional values may be
Packit 022b05
        registered in the future and assigned a value that is part of
Packit 022b05
        their logical grouping.
Packit 022b05
Packit 022b05
        Values in the range 2**30 to 2**31-1 are reserved for private
Packit 022b05
        or experimental usage.  This range corresponds to the same
Packit 022b05
        range reserved in IPP.  Implementers are warned that use of
Packit 022b05
        such values may conflict with other implementations.
Packit 022b05
        Implementers are encouraged to request registration of enum
Packit 022b05
        values following the procedures in Section 3.7.1.
Packit 022b05
Packit 022b05
        See Section 3.2 entitled 'The Attribute Mechanism' for a
Packit 022b05
        description of this textual-convention and its use in the
Packit 022b05
        jmAttributeTable.  See Section 3.3.8 for the specification of
Packit 022b05
        each attribute.  The comment(s) after each enum assignment
Packit 022b05
        specifies the data type(s) of the attribute.
Packit 022b05
Packit 022b05
        This is a type 2 enumeration.  See Section 3.7.1.2."
Packit 022b05
    SYNTAX      INTEGER {
Packit 022b05
        other(1),                       -- Integer32 (-2..2147483647)
Packit 022b05
                                        -- AND/OR
Packit 022b05
                                        -- OCTET STRING(SIZE(0..63))
Packit 022b05
Packit 022b05
        -- Job State attributes:
Packit 022b05
        jobStateReasons2(3),            -- JmJobStateReasons2TC
Packit 022b05
        jobStateReasons3(4),            -- JmJobStateReasons3TC
Packit 022b05
        jobStateReasons4(5),            -- JmJobStateReasons4TC
Packit 022b05
        processingMessage(6),           -- JmUTF8StringTC (SIZE(0..63))
Packit 022b05
        processingMessageNaturalLangTag(7),
Packit 022b05
                                        -- OCTET STRING(SIZE(0..63))
Packit 022b05
        jobCodedCharSet(8),             -- CodedCharSet
Packit 022b05
        jobNaturalLanguageTag(9),       -- OCTET STRING(SIZE(0..63))
Packit 022b05
Packit 022b05
Packit 022b05
        -- Job Identification attributes:
Packit 022b05
        jobURI(20),                     -- OCTET STRING(SIZE(0..63))
Packit 022b05
        jobAccountName(21),             -- OCTET STRING(SIZE(0..63))
Packit 022b05
        serverAssignedJobName(22),      -- JmJobStringTC (SIZE(0..63))
Packit 022b05
        jobName(23),                    -- JmJobStringTC (SIZE(0..63))
Packit 022b05
        jobServiceTypes(24),            -- JmJobServiceTypesTC
Packit 022b05
        jobSourceChannelIndex(25),      -- Integer32 (0..2147483647)
Packit 022b05
        jobSourcePlatformType(26),      -- JmJobSourcePlatformTypeTC
Packit 022b05
        submittingServerName(27),       -- JmJobStringTC (SIZE(0..63))
Packit 022b05
        submittingApplicationName(28),  -- JmJobStringTC (SIZE(0..63))
Packit 022b05
        jobOriginatingHost(29),         -- JmJobStringTC (SIZE(0..63))
Packit 022b05
        deviceNameRequested(30),        -- JmJobStringTC (SIZE(0..63))
Packit 022b05
        queueNameRequested(31),         -- JmJobStringTC (SIZE(0..63))
Packit 022b05
        physicalDevice(32),             -- hrDeviceIndex
Packit 022b05
                                        -- AND/OR
Packit 022b05
                                        -- JmUTF8StringTC (SIZE(0..63))
Packit 022b05
        numberOfDocuments(33),          -- Integer32 (-2..2147483647)
Packit 022b05
        fileName(34),                   -- JmJobStringTC (SIZE(0..63))
Packit 022b05
        documentName(35),               -- JmJobStringTC (SIZE(0..63))
Packit 022b05
        jobComment(36),                 -- JmJobStringTC (SIZE(0..63))
Packit 022b05
        documentFormatIndex(37),        -- Integer32 (0..2147483647)
Packit 022b05
        documentFormat(38),             -- PrtInterpreterLangFamilyTC
Packit 022b05
                                        -- AND/OR
Packit 022b05
                                        -- OCTET STRING(SIZE(0..63))
Packit 022b05
Packit 022b05
        -- Job Parameter attributes:
Packit 022b05
        jobPriority(50),                -- Integer32 (-2..100)
Packit 022b05
        jobProcessAfterDateAndTime(51), -- DateAndTime (SNMPv2-TC)
Packit 022b05
        jobHold(52),                    -- JmBooleanTC
Packit 022b05
        jobHoldUntil(53),               -- JmJobStringTC (SIZE(0..63))
Packit 022b05
        outputBin(54),                  -- Integer32 (0..2147483647)
Packit 022b05
                                        -- AND/OR
Packit 022b05
Packit 022b05
                                        -- JmJobStringTC (SIZE(0..63))
Packit 022b05
        sides(55),                      -- Integer32 (-2..2)
Packit 022b05
        finishing(56),                  -- JmFinishingTC
Packit 022b05
Packit 022b05
        -- Image Quality attributes:
Packit 022b05
        printQualityRequested(70),      -- JmPrintQualityTC
Packit 022b05
        printQualityUsed(71),           -- JmPrintQualityTC
Packit 022b05
        printerResolutionRequested(72), -- JmPrinterResolutionTC
Packit 022b05
        printerResolutionUsed(73),      -- JmPrinterResolutionTC
Packit 022b05
        tonerEcomonyRequested(74),      -- JmTonerEconomyTC
Packit 022b05
        tonerEcomonyUsed(75),           -- JmTonerEconomyTC
Packit 022b05
        tonerDensityRequested(76),      -- Integer32 (-2..100)
Packit 022b05
        tonerDensityUsed(77),           -- Integer32 (-2..100)
Packit 022b05
Packit 022b05
Packit 022b05
        -- Job Progress attributes:
Packit 022b05
        jobCopiesRequested(90),         -- Integer32 (-2..2147483647)
Packit 022b05
        jobCopiesCompleted(91),         -- Integer32 (-2..2147483647)
Packit 022b05
        documentCopiesRequested(92),    -- Integer32 (-2..2147483647)
Packit 022b05
        documentCopiesCompleted(93),    -- Integer32 (-2..2147483647)
Packit 022b05
        jobKOctetsTransferred(94),      -- Integer32 (-2..2147483647)
Packit 022b05
        sheetCompletedCopyNumber(95),   -- Integer32 (-2..2147483647)
Packit 022b05
        sheetCompletedDocumentNumber(96),
Packit 022b05
                                        -- Integer32 (-2..2147483647)
Packit 022b05
        jobCollationType(97),           -- JmJobCollationTypeTC
Packit 022b05
Packit 022b05
        -- Impression attributes:
Packit 022b05
        impressionsSpooled(110),        -- Integer32 (-2..2147483647)
Packit 022b05
        impressionsSentToDevice(111),   -- Integer32 (-2..2147483647)
Packit 022b05
        impressionsInterpreted(112),    -- Integer32 (-2..2147483647)
Packit 022b05
        impressionsCompletedCurrentCopy(113),
Packit 022b05
                                        -- Integer32 (-2..2147483647)
Packit 022b05
        fullColorImpressionsCompleted(114),
Packit 022b05
                                        -- Integer32 (-2..2147483647)
Packit 022b05
        highlightColorImpressionsCompleted(115),
Packit 022b05
                                        -- Integer32 (-2..2147483647)
Packit 022b05
Packit 022b05
        -- Page attributes:
Packit 022b05
        pagesRequested(130),            -- Integer32 (-2..2147483647)
Packit 022b05
        pagesCompleted(131),            -- Integer32 (-2..2147483647)
Packit 022b05
        pagesCompletedCurrentCopy(132), -- Integer32 (-2..2147483647)
Packit 022b05
Packit 022b05
        -- Sheet attributes:
Packit 022b05
        sheetsRequested(150),           -- Integer32 (-2..2147483647)
Packit 022b05
        sheetsCompleted(151),           -- Integer32 (-2..2147483647)
Packit 022b05
        sheetsCompletedCurrentCopy(152),-- Integer32 (-2..2147483647)
Packit 022b05
Packit 022b05
        -- Resource attributes:
Packit 022b05
        mediumRequested(170),           -- JmMediumTypeTC
Packit 022b05
                                        -- AND/OR
Packit 022b05
                                        -- JmJobStringTC (SIZE(0..63))
Packit 022b05
        mediumConsumed(171),            -- Integer32 (-2..2147483647)
Packit 022b05
                                        -- AND
Packit 022b05
                                        -- JmJobStringTC (SIZE(0..63))
Packit 022b05
        colorantRequested(172),         -- Integer32 (-2..2147483647)
Packit 022b05
                                        -- AND/OR
Packit 022b05
                                        -- JmJobStringTC (SIZE(0..63))
Packit 022b05
        colorantConsumed(173),          -- Integer32 (-2..2147483647)
Packit 022b05
                                        -- AND/OR
Packit 022b05
                                        -- JmJobStringTC (SIZE(0..63))
Packit 022b05
        mediumTypeConsumed(174),        -- Integer32 (-2..2147483647)
Packit 022b05
                                        -- AND
Packit 022b05
                                        -- JmJobStringTC (SIZE(0..63))
Packit 022b05
        mediumSizeConsumed(175),        -- Integer32 (-2..2147483647)
Packit 022b05
                                        -- AND
Packit 022b05
                                        -- JmJobStringTC (SIZE(0..63))
Packit 022b05
Packit 022b05
        -- Time attributes:
Packit 022b05
        jobSubmissionToServerTime(190), -- JmTimeStampTC
Packit 022b05
                                        -- AND/OR
Packit 022b05
                                        -- DateAndTime
Packit 022b05
        jobSubmissionTime(191),         -- JmTimeStampTC
Packit 022b05
                                        -- AND/OR
Packit 022b05
                                        -- DateAndTime
Packit 022b05
        jobStartedBeingHeldTime(192),   -- JmTimeStampTC
Packit 022b05
                                        -- AND/OR
Packit 022b05
                                        -- DateAndTime
Packit 022b05
        jobStartedProcessingTime(193),  -- JmTimeStampTC
Packit 022b05
                                        -- AND/OR
Packit 022b05
                                        -- DateAndTime
Packit 022b05
        jobCompletionTime(194),         -- JmTimeStampTC
Packit 022b05
                                        -- AND/OR
Packit 022b05
                                        -- DateAndTime
Packit 022b05
        jobProcessingCPUTime(195)       -- Integer32 (-2..2147483647)
Packit 022b05
    }
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
JmJobServiceTypesTC ::= TEXTUAL-CONVENTION
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "Specifies the type(s) of service to which the job has been
Packit 022b05
        submitted (print, fax, scan, etc.).  The service type is
Packit 022b05
        represented as an enum that is bit encoded with each job
Packit 022b05
        service type so that more general and arbitrary services can be
Packit 022b05
        created, such as services with more than one destination type,
Packit 022b05
        or ones with only a source or only a destination.  For example,
Packit 022b05
        a job service might scan, faxOut, and print a single job.  In
Packit 022b05
        this case, three bits would be set in the jobServiceTypes
Packit 022b05
        attribute, corresponding to the hexadecimal values: 0x8 + 0x20
Packit 022b05
        + 0x4, respectively, yielding: 0x2C.
Packit 022b05
Packit 022b05
        Whether this attribute is set from a job attribute supplied by
Packit 022b05
        the job submission client or is set by the recipient job
Packit 022b05
        submission server or device depends on the job submission
Packit 022b05
        protocol.  With either implementation, the agent SHALL return a
Packit 022b05
        non-zero value for this attribute indicating the type of the
Packit 022b05
        job.
Packit 022b05
Packit 022b05
        One of the purposes of this attribute is to permit a requester
Packit 022b05
        to filter out jobs that are not of interest.  For example, a
Packit 022b05
        printer operator MAY only be interested in jobs that include
Packit 022b05
        printing.  That is why the attribute is in the job
Packit 022b05
        identification category.
Packit 022b05
Packit 022b05
        The following service component types are defined (in
Packit 022b05
        hexadecimal) and are assigned a separate bit value for use with
Packit 022b05
        the jobServiceTypes attribute:
Packit 022b05
Packit 022b05
        other                             0x1
Packit 022b05
            The job contains some instructions that are not one of the
Packit 022b05
            identified types.
Packit 022b05
Packit 022b05
        unknown                           0x2
Packit 022b05
            The job contains some instructions whose type is unknown to
Packit 022b05
            the agent.
Packit 022b05
Packit 022b05
        print                             0x4
Packit 022b05
            The job contains some instructions that specify printing
Packit 022b05
Packit 022b05
        scan                              0x8
Packit 022b05
            The job contains some instructions that specify scanning
Packit 022b05
Packit 022b05
        faxIn                             0x10
Packit 022b05
            The job contains some instructions that specify receive fax
Packit 022b05
Packit 022b05
        faxOut                            0x20
Packit 022b05
            The job contains some instructions that specify sending fax
Packit 022b05
Packit 022b05
        getFile                           0x40
Packit 022b05
            The job contains some instructions that specify accessing
Packit 022b05
            files or documents
Packit 022b05
Packit 022b05
        putFile                           0x80
Packit 022b05
            The job contains some instructions that specify storing
Packit 022b05
            files or documents
Packit 022b05
Packit 022b05
        mailList                          0x100
Packit 022b05
            The job contains some instructions that specify
Packit 022b05
            distribution of documents using an electronic mail system.
Packit 022b05
Packit 022b05
        These bit definitions are the equivalent of a type 2 enum
Packit 022b05
        except that combinations of them MAY be used together.  See
Packit 022b05
        section 3.7.1.2."
Packit 022b05
    SYNTAX      INTEGER (0..2147483647)   -- 31 bits, all but sign bit
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
JmJobStateReasons1TC ::= TEXTUAL-CONVENTION
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The JmJobStateReasonsNTC (N=1..4) textual-conventions are used
Packit 022b05
        with the jmJobStateReasons1 object and jobStateReasonsN
Packit 022b05
        (N=2..4), respectively, to provide additional information
Packit 022b05
        regarding the current jmJobState object value.  These values
Packit 022b05
        MAY be used with any job state or states for which the reason
Packit 022b05
        makes sense.  See section 3.3.9.1 for the specification of each
Packit 022b05
        bit value defined for use with the JmJobStateReasons1TC.
Packit 022b05
Packit 022b05
        These bit definitions are the equivalent of a type 2 enum
Packit 022b05
        except that combinations of bits may be used together.  See
Packit 022b05
        section 3.7.1.2."
Packit 022b05
    SYNTAX      INTEGER (0..2147483647)   -- 31 bits, all but sign bit
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
JmJobStateReasons2TC ::= TEXTUAL-CONVENTION
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "This textual-convention is used with the jobStateReasons2
Packit 022b05
        attribute to provides additional information regarding the
Packit 022b05
        jmJobState object.  See section 3.3.9.2 for the specification
Packit 022b05
        of JmJobStateReasons2TC.  See section 3.3.9.1 for the
Packit 022b05
        description under JmJobStateReasons1TC for additional
Packit 022b05
        information that applies to all reasons.
Packit 022b05
Packit 022b05
        These bit definitions are the equivalent of a type 2 enum
Packit 022b05
        except that combinations of them may be used together.  See
Packit 022b05
        section 3.7.1.2."
Packit 022b05
    SYNTAX      INTEGER (0..2147483647)   -- 31 bits, all but sign bit
Packit 022b05
Packit 022b05
JmJobStateReasons3TC ::= TEXTUAL-CONVENTION
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "This textual-convention is used with the jobStateReasons3
Packit 022b05
        attribute to provides additional information regarding the
Packit 022b05
        jmJobState object.  See section 3.3.9.3 for the specification
Packit 022b05
        of JmJobStateReasons3TC.  See section 3.3.9.1 for the
Packit 022b05
        description under JmJobStateReasons1TC for additional
Packit 022b05
        information that applies to all reasons.
Packit 022b05
Packit 022b05
        These bit definitions are the equivalent of a type 2 enum
Packit 022b05
        except that combinations of them may be used together.  See
Packit 022b05
        section 3.7.1.2.  "
Packit 022b05
    SYNTAX      INTEGER (0..2147483647)   -- 31 bits, all but sign bit
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
JmJobStateReasons4TC ::= TEXTUAL-CONVENTION
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "This textual-convention is used in the jobStateReasons4
Packit 022b05
        attribute to provides additional information regarding the
Packit 022b05
        jmJobState object.  See section 3.3.9.4 for the specification
Packit 022b05
        of JmJobStateReasons4TC.  See section 3.3.9.1 for the
Packit 022b05
        description under JmJobStateReasons1TC for additional
Packit 022b05
        information that applies to all reasons.
Packit 022b05
Packit 022b05
        These bit definitions are the equivalent of a type 2 enum
Packit 022b05
        except that combinations of them may be used together.  See
Packit 022b05
        section 3.7.1.2."
Packit 022b05
    SYNTAX      INTEGER (0..2147483647)   -- 31 bits, all but sign bit
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
jobmonMIBObjects  OBJECT IDENTIFIER  ::= { jobmonMIB 1 }
Packit 022b05
Packit 022b05
-- The General Group (MANDATORY)
Packit 022b05
Packit 022b05
-- The jmGeneralGroup consists entirely of the jmGeneralTable.
Packit 022b05
Packit 022b05
jmGeneral  OBJECT IDENTIFIER ::= { jobmonMIBObjects 1 }
Packit 022b05
Packit 022b05
jmGeneralTable  OBJECT-TYPE
Packit 022b05
    SYNTAX      SEQUENCE OF JmGeneralEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The jmGeneralTable consists of information of a general nature
Packit 022b05
        that are per-job-set, but are not per-job.  See Section 2
Packit 022b05
        entitled 'Terminology and Job Model' for the definition of a
Packit 022b05
        job set.
Packit 022b05
Packit 022b05
        The MANDATORY-GROUP macro specifies that this group is
Packit 022b05
        MANDATORY."
Packit 022b05
    ::= { jmGeneral 1 }
Packit 022b05
Packit 022b05
Packit 022b05
jmGeneralEntry  OBJECT-TYPE
Packit 022b05
    SYNTAX      JmGeneralEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "Information about a job set (queue).
Packit 022b05
Packit 022b05
        An entry SHALL exist in this table for each job set."
Packit 022b05
    INDEX  { jmGeneralJobSetIndex }
Packit 022b05
    ::= { jmGeneralTable 1 }
Packit 022b05
Packit 022b05
Packit 022b05
JmGeneralEntry ::= SEQUENCE {
Packit 022b05
    jmGeneralJobSetIndex                  Integer32,
Packit 022b05
    jmGeneralNumberOfActiveJobs           Integer32,
Packit 022b05
    jmGeneralOldestActiveJobIndex         Integer32,
Packit 022b05
    jmGeneralNewestActiveJobIndex         Integer32,
Packit 022b05
    jmGeneralJobPersistence               Integer32,
Packit 022b05
    jmGeneralAttributePersistence         Integer32,
Packit 022b05
    jmGeneralJobSetName                   JmUTF8StringTC
Packit 022b05
}
Packit 022b05
Packit 022b05
Packit 022b05
jmGeneralJobSetIndex OBJECT-TYPE
Packit 022b05
    SYNTAX      Integer32 (1..32767)
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A unique value for each job set in this MIB.  The jmJobTable
Packit 022b05
        and jmAttributeTable tables have this same index as their
Packit 022b05
        primary index.
Packit 022b05
Packit 022b05
        The value(s) of the jmGeneralJobSetIndex SHALL be persistent
Packit 022b05
        across power cycles, so that clients that have retained
Packit 022b05
        jmGeneralJobSetIndex values will access the same job sets upon
Packit 022b05
        subsequent power-up.
Packit 022b05
Packit 022b05
        An implementation that has only one job set, such as a printer
Packit 022b05
        with a single queue, SHALL hard code this object with the value
Packit 022b05
        1.
Packit 022b05
Packit 022b05
        See Section 2 entitled 'Terminology and Job Model' for the
Packit 022b05
        definition of a job set.
Packit 022b05
        Corresponds to the first index in jmJobTable and
Packit 022b05
        jmAttributeTable."
Packit 022b05
    ::= { jmGeneralEntry 1 }
Packit 022b05
Packit 022b05
Packit 022b05
jmGeneralNumberOfActiveJobs OBJECT-TYPE
Packit 022b05
    SYNTAX      Integer32 (0..2147483647)
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The current number of 'active' jobs in the jmJobIDTable,
Packit 022b05
        jmJobTable, and jmAttributeTable, i.e., the total number of
Packit 022b05
        jobs that are in the pending, processing, or processingStopped
Packit 022b05
        states.  See the JmJobStateTC textual-convention for the exact
Packit 022b05
        specification of the semantics of the job states."
Packit 022b05
    DEFVAL      { 0 }      -- no jobs
Packit 022b05
    ::= { jmGeneralEntry 2 }
Packit 022b05
Packit 022b05
Packit 022b05
jmGeneralOldestActiveJobIndex  OBJECT-TYPE
Packit 022b05
    SYNTAX      Integer32 (0..2147483647)
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The jmJobIndex of the oldest job that is still in one of the
Packit 022b05
        'active' states (pending, processing, or processingStopped).
Packit 022b05
        In other words, the index of the 'active' job that has been in
Packit 022b05
        the job tables the longest.
Packit 022b05
Packit 022b05
        If there are no active jobs, the agent SHALL set the value of
Packit 022b05
        this object to 0.
Packit 022b05
Packit 022b05
        See Section 3.2 entitled 'The Job Tables and the Oldest Active
Packit 022b05
        and Newest Active Indexes' for a description of the usage of
Packit 022b05
        this object."
Packit 022b05
    DEFVAL      { 0 }      -- no active jobs
Packit 022b05
    ::= { jmGeneralEntry 3 }
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
jmGeneralNewestActiveJobIndex  OBJECT-TYPE
Packit 022b05
    SYNTAX      Integer32 (0..2147483647)
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The jmJobIndex of the newest job that is in one of the
Packit 022b05
        'active' states (pending, processing, or processingStopped).
Packit 022b05
        In other words, the index of the 'active' job that has been
Packit 022b05
        most recently added to the job tables.
Packit 022b05
Packit 022b05
        When all jobs become 'inactive', i.e., enter the pendingHeld,
Packit 022b05
        completed, canceled, or aborted states, the agent SHALL set the
Packit 022b05
        value of this object to 0.
Packit 022b05
Packit 022b05
        See Section 3.2 entitled 'The Job Tables and the Oldest Active
Packit 022b05
        and Newest Active Indexes' for a description of the usage of
Packit 022b05
        this object."
Packit 022b05
    DEFVAL      { 0 }      -- no active jobs
Packit 022b05
    ::= { jmGeneralEntry 4 }
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
jmGeneralJobPersistence OBJECT-TYPE
Packit 022b05
    SYNTAX      Integer32 (15..2147483647)
Packit 022b05
    UNITS       "seconds"
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The minimum time in seconds for this instance of the Job Set
Packit 022b05
        that an entry SHALL remain in the jmJobIDTable and jmJobTable
Packit 022b05
        after processing has completed, i.e., the minimum time in
Packit 022b05
        seconds starting when the job enters the completed, canceled,
Packit 022b05
        or aborted state.
Packit 022b05
Packit 022b05
        Configuring this object is implementation-dependent.
Packit 022b05
Packit 022b05
        This value SHALL be equal to or greater than the value of
Packit 022b05
        jmGeneralAttributePersistence.  This value SHOULD be at least
Packit 022b05
        60 which gives a monitoring or accounting application one
Packit 022b05
        minute in which to poll for job data."
Packit 022b05
    DEFVAL      { 60 }          -- one minute
Packit 022b05
    ::= { jmGeneralEntry 5 }
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
jmGeneralAttributePersistence OBJECT-TYPE
Packit 022b05
    SYNTAX      Integer32 (15..2147483647)
Packit 022b05
    UNITS       "seconds"
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The minimum time in seconds for this instance of the Job Set
Packit 022b05
        that an entry SHALL remain in the jmAttributeTable after
Packit 022b05
        processing has completed , i.e., the time in seconds starting
Packit 022b05
        when the job enters the completed, canceled, or aborted state.
Packit 022b05
Packit 022b05
        Configuring this object is implementation-dependent.
Packit 022b05
Packit 022b05
        This value SHOULD be at least 60 which gives a monitoring or
Packit 022b05
        accounting application one minute in which to poll for job
Packit 022b05
        data."
Packit 022b05
    DEFVAL      { 60 }          -- one minute
Packit 022b05
    ::= { jmGeneralEntry 6 }
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
jmGeneralJobSetName OBJECT-TYPE
Packit 022b05
    SYNTAX      JmUTF8StringTC (SIZE(0..63))
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The human readable name of this job set assigned by the system
Packit 022b05
        administrator (by means outside of this MIB).  Typically, this
Packit 022b05
        name SHOULD be the name of the job queue.  If a server or
Packit 022b05
        device has only a single job set, this object can be the
Packit 022b05
        administratively assigned name of the server or device itself.
Packit 022b05
        This name does not need to be unique, though each job set in a
Packit 022b05
        single Job Monitoring MIB SHOULD have distinct names.
Packit 022b05
Packit 022b05
        NOTE - If the job set corresponds to a single printer and the
Packit 022b05
        Printer MIB is implemented, this value SHOULD be the same as
Packit 022b05
        the prtGeneralPrinterName object in the draft Printer MIB
Packit 022b05
        [print-mib-draft].  If the job set corresponds to an IPP
Packit 022b05
        Printer, this value SHOULD be the same as the IPP 'printer-
Packit 022b05
        name' Printer attribute.
Packit 022b05
Packit 022b05
        NOTE - The purpose of this object is to help the user of the
Packit 022b05
        job monitoring application distinguish between several job sets
Packit 022b05
        in implementations that support more than one job set.
Packit 022b05
Packit 022b05
        See the OBJECT compliance macro for the minimum maximum length
Packit 022b05
        required for conformance."
Packit 022b05
    DEFVAL      { ''H }      -- empty string
Packit 022b05
    ::= { jmGeneralEntry 7 }
Packit 022b05
Packit 022b05
Packit 022b05
-- The Job ID Group (MANDATORY)
Packit 022b05
Packit 022b05
-- The jmJobIDGroup consists entirely of the jmJobIDTable.
Packit 022b05
jmJobID  OBJECT IDENTIFIER ::= { jobmonMIBObjects 2 }
Packit 022b05
Packit 022b05
jmJobIDTable  OBJECT-TYPE
Packit 022b05
    SYNTAX      SEQUENCE OF JmJobIDEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The jmJobIDTable provides a correspondence map (1) between the
Packit 022b05
        job submission ID that a client uses to refer to a job and (2)
Packit 022b05
        the jmGeneralJobSetIndex and jmJobIndex that the Job Monitoring
Packit 022b05
        MIB agent assigned to the job and that are used to access the
Packit 022b05
        job in all of the other tables in the MIB.  If a monitoring
Packit 022b05
        application already knows the jmGeneralJobSetIndex and the
Packit 022b05
        jmJobIndex of the job it is querying, that application NEED NOT
Packit 022b05
        use the jmJobIDTable.
Packit 022b05
Packit 022b05
        The MANDATORY-GROUP macro specifies that this group is
Packit 022b05
        MANDATORY."
Packit 022b05
    ::= { jmJobID 1 }
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
jmJobIDEntry  OBJECT-TYPE
Packit 022b05
    SYNTAX      JmJobIDEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The map from (1) the jmJobSubmissionID to (2) the
Packit 022b05
        jmGeneralJobSetIndex and jmJobIndex.
Packit 022b05
Packit 022b05
        An entry SHALL exist in this table for each job currently known
Packit 022b05
        to the agent for all job sets and job states.  There MAY be
Packit 022b05
        more than one jmJobIDEntry that maps to a single job.  This
Packit 022b05
        many to one mapping can occur when more than one network entity
Packit 022b05
        along the job submission path supplies a job submission ID.
Packit 022b05
        See Section 3.5.  However, each job SHALL appear once and in
Packit 022b05
        one and only one job set."
Packit 022b05
    INDEX  { jmJobSubmissionID }
Packit 022b05
    ::= { jmJobIDTable 1 }
Packit 022b05
Packit 022b05
JmJobIDEntry ::= SEQUENCE {
Packit 022b05
    jmJobSubmissionID                     OCTET STRING,
Packit 022b05
    jmJobIDJobSetIndex                    Integer32,
Packit 022b05
    jmJobIDJobIndex                       Integer32
Packit 022b05
}
Packit 022b05
Packit 022b05
Packit 022b05
jmJobSubmissionID OBJECT-TYPE
Packit 022b05
    SYNTAX      OCTET STRING(SIZE(48))
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A quasi-unique 48-octet fixed-length string ID which
Packit 022b05
        identifies the job within a particular client-server
Packit 022b05
        environment.  There are multiple formats for the
Packit 022b05
        jmJobSubmissionID.  Each format SHALL be uniquely identified.
Packit 022b05
        See the JmJobSubmissionIDTypeTC textual convention.  Each
Packit 022b05
        format SHALL be registered using the procedures of a type 2
Packit 022b05
        enum.  See section 3.7.3 entitled: 'PWG Registration of Job
Packit 022b05
        Submission Id Formats'.
Packit 022b05
Packit 022b05
        If the requester (client or server) does not supply a job
Packit 022b05
        submission ID in the job submission protocol, then the
Packit 022b05
        recipient (server or device) SHALL assign a job submission ID
Packit 022b05
        using any of the standard formats that have been reserved for
Packit 022b05
        agents and adding the final 8 octets to distinguish the ID from
Packit 022b05
        others submitted from the same requester.
Packit 022b05
Packit 022b05
        The monitoring application, whether in the client or running
Packit 022b05
        separately, MAY use the job submission ID to help identify
Packit 022b05
        which jmJobIndex was assigned by the agent, i.e., in which row
Packit 022b05
        the job information is in the other tables.
Packit 022b05
Packit 022b05
        NOTE - fixed-length is used so that a management application
Packit 022b05
        can use a shortened GetNext varbind (in SNMPv1 and SNMPv2) in
Packit 022b05
        order to get the next submission ID, disregarding the remainder
Packit 022b05
        of the ID in order to access jobs independent of the trailing
Packit 022b05
        identifier part, e.g., to get all jobs submitted by a
Packit 022b05
        particular jmJobOwner or submitted from a particular MAC
Packit 022b05
        address.
Packit 022b05
Packit 022b05
        See the JmJobSubmissionIDTypeTC textual convention.
Packit 022b05
        See APPENDIX B - Support of Job Submission Protocols."
Packit 022b05
    ::= { jmJobIDEntry 1 }
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
jmJobIDJobSetIndex OBJECT-TYPE
Packit 022b05
    SYNTAX      Integer32 (0..32767)
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "This object contains the value of the jmGeneralJobSetIndex for
Packit 022b05
        the job with the jmJobSubmissionID value, i.e., the job set
Packit 022b05
        index of the job set in which the job was placed when that
Packit 022b05
        server or device accepted the job.  This 16-bit value in
Packit 022b05
        combination with the jmJobIDJobIndex value permits the
Packit 022b05
        management application to access the other tables to obtain the
Packit 022b05
        job-specific objects for this job.
Packit 022b05
Packit 022b05
        See jmGeneralJobSetIndex in the jmGeneralTable."
Packit 022b05
    DEFVAL      { 0 }      -- 0 indicates no job set index
Packit 022b05
    ::= { jmJobIDEntry 2 }
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
jmJobIDJobIndex OBJECT-TYPE
Packit 022b05
    SYNTAX      Integer32 (0..2147483647)
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "This object contains the value of the jmJobIndex for the job
Packit 022b05
        with the jmJobSubmissionID value, i.e., the job index for the
Packit 022b05
        job when the server or device accepted the job.  This value, in
Packit 022b05
        combination with the jmJobIDJobSetIndex value, permits the
Packit 022b05
        management application to access the other tables to obtain the
Packit 022b05
        job-specific objects for this job.
Packit 022b05
Packit 022b05
        See jmJobIndex in the jmJobTable."
Packit 022b05
    DEFVAL      { 0 }      -- 0 indicates no jmJobIndex value.
Packit 022b05
    ::= { jmJobIDEntry 3 }
Packit 022b05
Packit 022b05
Packit 022b05
-- The Job Group (MANDATORY)
Packit 022b05
Packit 022b05
-- The jmJobGroup consists entirely of the jmJobTable.
Packit 022b05
Packit 022b05
jmJob  OBJECT IDENTIFIER ::= { jobmonMIBObjects 3 }
Packit 022b05
Packit 022b05
jmJobTable  OBJECT-TYPE
Packit 022b05
    SYNTAX      SEQUENCE OF JmJobEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The jmJobTable consists of basic job state and status
Packit 022b05
        information for each job in a job set that (1) monitoring
Packit 022b05
        applications need to be able to access in a single SNMP Get
Packit 022b05
        operation, (2) that have a single value per job, and (3) that
Packit 022b05
        SHALL always be implemented.
Packit 022b05
Packit 022b05
        The MANDATORY-GROUP macro specifies that this group is
Packit 022b05
        MANDATORY."
Packit 022b05
    ::= { jmJob 1 }
Packit 022b05
Packit 022b05
jmJobEntry  OBJECT-TYPE
Packit 022b05
    SYNTAX      JmJobEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "Basic per-job state and status information.
Packit 022b05
Packit 022b05
        An entry SHALL exist in this table for each job, no matter what
Packit 022b05
        the state of the job is.  Each job SHALL appear in one and only
Packit 022b05
        one job set.
Packit 022b05
Packit 022b05
        See Section 3.2 entitled 'The Job Tables'."
Packit 022b05
    INDEX  { jmGeneralJobSetIndex, jmJobIndex }
Packit 022b05
    ::= { jmJobTable 1 }
Packit 022b05
Packit 022b05
JmJobEntry ::= SEQUENCE {
Packit 022b05
    jmJobIndex                            Integer32,
Packit 022b05
    jmJobState                            JmJobStateTC,
Packit 022b05
    jmJobStateReasons1                    JmJobStateReasons1TC,
Packit 022b05
    jmNumberOfInterveningJobs             Integer32,
Packit 022b05
    jmJobKOctetsPerCopyRequested          Integer32,
Packit 022b05
    jmJobKOctetsProcessed                 Integer32,
Packit 022b05
    jmJobImpressionsPerCopyRequested      Integer32,
Packit 022b05
    jmJobImpressionsCompleted             Integer32,
Packit 022b05
    jmJobOwner                            JmJobStringTC
Packit 022b05
}
Packit 022b05
Packit 022b05
Packit 022b05
jmJobIndex OBJECT-TYPE
Packit 022b05
    SYNTAX      Integer32 (1..2147483647)
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The sequential, monatonically increasing identifier index for
Packit 022b05
        the job generated by the server or device when that server or
Packit 022b05
        device accepted the job.  This index value permits the
Packit 022b05
        management application to access the other tables to obtain the
Packit 022b05
        job-specific row entries.
Packit 022b05
Packit 022b05
        See Section 3.2 entitled 'The Job Tables and the Oldest Active
Packit 022b05
        and Newest Active Indexes'.
Packit 022b05
        See Section 3.5 entitled 'Job Identification'.
Packit 022b05
        See also jmGeneralNewestActiveJobIndex for the largest value of
Packit 022b05
        jmJobIndex.
Packit 022b05
        See JmJobSubmissionIDTypeTC for a limit on the size of this
Packit 022b05
        index if the agent represents it as an 8-digit decimal number."
Packit 022b05
    ::= { jmJobEntry 1 }
Packit 022b05
Packit 022b05
jmJobState OBJECT-TYPE
Packit 022b05
    SYNTAX      JmJobStateTC
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The current state of the job (pending, processing, completed,
Packit 022b05
        etc.).  Agents SHALL implement only those states which are
Packit 022b05
        appropriate for the particular implementation.  However,
Packit 022b05
        management applications SHALL be prepared to receive all the
Packit 022b05
        standard job states.
Packit 022b05
Packit 022b05
        The final value for this object SHALL be one of: completed,
Packit 022b05
        canceled, or aborted.  The minimum length of time that the
Packit 022b05
        agent SHALL maintain MIB data for a job in the completed,
Packit 022b05
        canceled, or aborted state before removing the job data from
Packit 022b05
        the jmJobIDTable and jmJobTable is specified by the value of
Packit 022b05
        the jmGeneralJobPersistence object."
Packit 022b05
    DEFVAL      { unknown }      -- default is unknown
Packit 022b05
    ::= { jmJobEntry 2 }
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
jmJobStateReasons1 OBJECT-TYPE
Packit 022b05
    SYNTAX      JmJobStateReasons1TC
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "Additional information about the job's current state, i.e.,
Packit 022b05
        information that augments the value of the job's jmJobState
Packit 022b05
        object.
Packit 022b05
Packit 022b05
        Implementation of any reason values is OPTIONAL, but an agent
Packit 022b05
        SHOULD return any reason information available.  These values
Packit 022b05
        MAY be used with any job state or states for which the reason
Packit 022b05
        makes sense.  Since the Job State Reasons will be more dynamic
Packit 022b05
        than the Job State, it is recommended that a job monitoring
Packit 022b05
        application read this object every time jmJobState is read.
Packit 022b05
        When the agent cannot provide a reason for the current state of
Packit 022b05
        the job, the value of the jmJobStateReasons1 object and
Packit 022b05
        jobStateReasonsN attributes SHALL be 0.
Packit 022b05
Packit 022b05
        The jobStateReasonsN (N=2..4) attributes provide further
Packit 022b05
        additional information about the job's current state."
Packit 022b05
    DEFVAL      { 0 }      -- no reasons
Packit 022b05
    ::= { jmJobEntry 3 }
Packit 022b05
Packit 022b05
jmNumberOfInterveningJobs OBJECT-TYPE
Packit 022b05
    SYNTAX      Integer32 (-2..2147483647)
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of jobs that are expected to complete processing
Packit 022b05
        before this job has completed processing according to the
Packit 022b05
        implementation's queuing algorithm, if no other jobs were to be
Packit 022b05
        submitted.  In other words, this value is the job's queue
Packit 022b05
        position.  The agent SHALL return a value of 0 for this
Packit 022b05
        attribute when the job is the next job to complete processing
Packit 022b05
        (or has completed processing)."
Packit 022b05
    DEFVAL      { 0 }      -- default is no intervening jobs.
Packit 022b05
    ::= { jmJobEntry 4 }
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
jmJobKOctetsPerCopyRequested OBJECT-TYPE
Packit 022b05
    SYNTAX      Integer32 (-2..2147483647)
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The total size in K (1024) octets of the document(s) being
Packit 022b05
        requested to be processed in the job.  The agent SHALL round
Packit 022b05
        the actual number of octets up to the next highest K.  Thus 0
Packit 022b05
        octets is represented as '0', 1-1024 octets is represented as
Packit 022b05
        '1', 1025-2048 is represented as '2', etc.
Packit 022b05
Packit 022b05
        In computing this value, the server/device SHALL NOT include
Packit 022b05
        the multiplicative factors contributed by (1) the number of
Packit 022b05
        document copies, and (2) the number of job copies, independent
Packit 022b05
        of whether the device can process multiple copies of the job or
Packit 022b05
        document without making multiple passes over the job or
Packit 022b05
        document data and independent of whether the output is collated
Packit 022b05
        or not.  Thus the server/device computation is independent of
Packit 022b05
        the implementation and indicates the size of the document(s)
Packit 022b05
        measured in K octets independent of the number of copies."
Packit 022b05
    DEFVAL      { -2 }      -- the default is unknown(-2)
Packit 022b05
    ::= { jmJobEntry 5 }
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
jmJobKOctetsProcessed OBJECT-TYPE
Packit 022b05
    SYNTAX      Integer32 (-2..2147483647)
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The total number of octets processed by the server or device
Packit 022b05
        measured in units of K (1024) octets so far.  The agent SHALL
Packit 022b05
        round the actual number of octets processed up to the next
Packit 022b05
        higher K.  Thus 0 octets is represented as '0', 1-1024 octets
Packit 022b05
        is represented as '1', 1025-2048 octets is '2', etc.  For
Packit 022b05
        printing devices, this value is the number interpreted by the
Packit 022b05
        page description language interpreter rather than what has been
Packit 022b05
        marked on media.
Packit 022b05
Packit 022b05
        For implementations where multiple copies are produced by the
Packit 022b05
        interpreter with only a single pass over the data, the final
Packit 022b05
        value SHALL be equal to the value of the
Packit 022b05
        jmJobKOctetsPerCopyRequested object.  For implementations where
Packit 022b05
        multiple copies are produced by the interpreter by processing
Packit 022b05
        the data for each copy, the final value SHALL be a multiple of
Packit 022b05
        the value of the jmJobKOctetsPerCopyRequested object.
Packit 022b05
Packit 022b05
        NOTE - See the impressionsCompletedCurrentCopy and
Packit 022b05
        pagesCompletedCurrentCopy attributes for attributes that are
Packit 022b05
        reset on each document copy.
Packit 022b05
Packit 022b05
        NOTE - The jmJobKOctetsProcessed object can be used with the
Packit 022b05
        jmJobKOctetsPerCopyRequested object to provide an indication of
Packit 022b05
        the relative progress of the job, provided that the
Packit 022b05
        multiplicative factor is taken into account for some
Packit 022b05
        implementations of multiple copies."
Packit 022b05
    DEFVAL      { 0 }      -- default is no octets processed.
Packit 022b05
    ::= { jmJobEntry 6 }
Packit 022b05
Packit 022b05
Packit 022b05
jmJobImpressionsPerCopyRequested OBJECT-TYPE
Packit 022b05
    SYNTAX      Integer32 (-2..2147483647)
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The total size in number of impressions of the document(s)
Packit 022b05
        submitted.
Packit 022b05
Packit 022b05
        In computing this value, the server/device SHALL NOT include
Packit 022b05
        the multiplicative factors contributed by (1) the number of
Packit 022b05
        document copies, and (2) the number of job copies, independent
Packit 022b05
        of whether the device can process multiple copies of the job or
Packit 022b05
        document without making multiple passes over the job or
Packit 022b05
        document data and independent of whether the output is collated
Packit 022b05
        or not.  Thus the server/device computation is independent of
Packit 022b05
        the implementation and reflects the size of the document(s)
Packit 022b05
        measured in impressions independent of the number of copies.
Packit 022b05
Packit 022b05
        See the definition of the term 'impression' in Section 2."
Packit 022b05
    DEFVAL      { -2 }      -- default is unknown(-2)
Packit 022b05
    ::= { jmJobEntry 7 }
Packit 022b05
Packit 022b05
Packit 022b05
jmJobImpressionsCompleted OBJECT-TYPE
Packit 022b05
    SYNTAX      Integer32 (-2..2147483647)
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The total number of impressions completed for this job so far.
Packit 022b05
        For printing devices, the impressions completed includes
Packit 022b05
        interpreting, marking, and stacking the output.  For other
Packit 022b05
        types of job services, the number of impressions completed
Packit 022b05
        includes the number of impressions processed.
Packit 022b05
Packit 022b05
        NOTE - See the impressionsCompletedCurrentCopy and
Packit 022b05
        pagesCompletedCurrentCopy attributes for attributes that are
Packit 022b05
        reset on each document copy.
Packit 022b05
Packit 022b05
        NOTE - The jmJobImpressionsCompleted object can be used with
Packit 022b05
        the jmJobImpressionsPerCopyRequested object to provide an
Packit 022b05
        indication of the relative progress of the job, provided that
Packit 022b05
        the multiplicative factor is taken into account for some
Packit 022b05
        implementations of multiple copies.
Packit 022b05
Packit 022b05
        See the definition of the term 'impression' in Section 2 and
Packit 022b05
        the counting example in Section 3.4 entitled 'Monitoring Job
Packit 022b05
        Progress'."
Packit 022b05
    DEFVAL      { 0 }      -- default is no octets
Packit 022b05
    ::= { jmJobEntry 8 }
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
jmJobOwner OBJECT-TYPE
Packit 022b05
    SYNTAX      JmJobStringTC (SIZE(0..63))
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The coded character set name of the user that submitted the
Packit 022b05
        job.  The method of assigning this user name will be system
Packit 022b05
        and/or site specific but the method MUST ensure that the name
Packit 022b05
        is unique to the network that is visible to the client and
Packit 022b05
        target device.
Packit 022b05
Packit 022b05
        This value SHOULD be the most authenticated name of the user
Packit 022b05
        submitting the job.
Packit 022b05
Packit 022b05
        See the OBJECT compliance macro for the minimum maximum length
Packit 022b05
        required for conformance."
Packit 022b05
    DEFVAL      { ''H }      -- default is empty string
Packit 022b05
    ::= { jmJobEntry 9 }
Packit 022b05
Packit 022b05
Packit 022b05
-- The Attribute Group (MANDATORY)
Packit 022b05
Packit 022b05
-- The jmAttributeGroup consists entirely of the jmAttributeTable.
Packit 022b05
--
Packit 022b05
-- Implementation of the objects in this group is MANDATORY.
Packit 022b05
-- See Section 3.1 entitled 'Conformance Considerations'.
Packit 022b05
-- An agent SHALL implement any attribute if (1) the server or device
Packit 022b05
-- supports the functionality represented by the attribute and (2) the
Packit 022b05
-- information is available to the agent.
Packit 022b05
Packit 022b05
jmAttribute  OBJECT IDENTIFIER ::= { jobmonMIBObjects 4 }
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
jmAttributeTable  OBJECT-TYPE
Packit 022b05
    SYNTAX      SEQUENCE OF JmAttributeEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The jmAttributeTable SHALL contain attributes of the job and
Packit 022b05
        document(s) for each job in a job set.  Instead of allocating
Packit 022b05
        distinct objects for each attribute, each attribute is
Packit 022b05
        represented as a separate row in the jmAttributeTable.
Packit 022b05
Packit 022b05
        The MANDATORY-GROUP macro specifies that this group is
Packit 022b05
        MANDATORY.  An agent SHALL implement any attribute if (1) the
Packit 022b05
        server or device supports the functionality represented by the
Packit 022b05
        attribute and (2) the information is available to the agent. "
Packit 022b05
    ::= { jmAttribute 1 }
Packit 022b05
Packit 022b05
Packit 022b05
jmAttributeEntry  OBJECT-TYPE
Packit 022b05
    SYNTAX      JmAttributeEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "Attributes representing information about the job and
Packit 022b05
        document(s) or resources required and/or consumed.
Packit 022b05
Packit 022b05
        Each entry in the jmAttributeTable is a per-job entry with an
Packit 022b05
        extra index for each type of attribute (jmAttributeTypeIndex)
Packit 022b05
        that a job can have and an additional index
Packit 022b05
        (jmAttributeInstanceIndex) for those attributes that can have
Packit 022b05
        multiple instances per job.  The jmAttributeTypeIndex object
Packit 022b05
        SHALL contain an enum type that indicates the type of attribute
Packit 022b05
        (see the JmAttributeTypeTC textual-convention).  The value of
Packit 022b05
        the attribute SHALL be represented in either the
Packit 022b05
        jmAttributeValueAsInteger or jmAttributeValueAsOctets objects,
Packit 022b05
        and/or both, as specified in the JmAttributeTypeTC textual-
Packit 022b05
        convention.
Packit 022b05
Packit 022b05
        The agent SHALL create rows in the jmAttributeTable as the
Packit 022b05
        server or device is able to discover the attributes either from
Packit 022b05
        the job submission protocol itself or from the document PDL.
Packit 022b05
        As the documents are interpreted, the interpreter MAY discover
Packit 022b05
        additional attributes and so the agent adds additional rows to
Packit 022b05
        this table.  As the attributes that represent resources are
Packit 022b05
        actually consumed, the usage counter contained in the
Packit 022b05
        jmAttributeValueAsInteger object is incremented according to
Packit 022b05
        the units indicated in the description of the JmAttributeTypeTC
Packit 022b05
        enum.
Packit 022b05
Packit 022b05
        The agent SHALL maintain each row in the jmAttributeTable for
Packit 022b05
        at least the minimum time after a job completes as specified by
Packit 022b05
        the jmGeneralAttributePersistence object.
Packit 022b05
Packit 022b05
        Zero or more entries SHALL exist in this table for each job in
Packit 022b05
        a job set.
Packit 022b05
Packit 022b05
        See Section 3.3 entitled 'The Attribute Mechanism' for a
Packit 022b05
        description of the jmAttributeTable."
Packit 022b05
    INDEX  { jmGeneralJobSetIndex, jmJobIndex, jmAttributeTypeIndex,
Packit 022b05
    jmAttributeInstanceIndex }
Packit 022b05
    ::= { jmAttributeTable 1 }
Packit 022b05
Packit 022b05
JmAttributeEntry ::= SEQUENCE {
Packit 022b05
    jmAttributeTypeIndex                  JmAttributeTypeTC,
Packit 022b05
    jmAttributeInstanceIndex              Integer32,
Packit 022b05
    jmAttributeValueAsInteger             Integer32,
Packit 022b05
    jmAttributeValueAsOctets              OCTET STRING
Packit 022b05
}
Packit 022b05
Packit 022b05
Packit 022b05
jmAttributeTypeIndex OBJECT-TYPE
Packit 022b05
    SYNTAX      JmAttributeTypeTC
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The type of attribute that this row entry represents.
Packit 022b05
Packit 022b05
        The type MAY identify information about the job or document(s)
Packit 022b05
        or MAY identify a resource required to process the job before
Packit 022b05
        the job start processing and/or consumed by the job as the job
Packit 022b05
        is processed.
Packit 022b05
Packit 022b05
        Examples of job attributes (i.e., apply to the job as a whole)
Packit 022b05
        that have only one instance per job include:
Packit 022b05
        jobCopiesRequested(90), documentCopiesRequested(92),
Packit 022b05
        jobCopiesCompleted(91), documentCopiesCompleted(93), while
Packit 022b05
        examples of job attributes that may have more than one instance
Packit 022b05
        per job include:  documentFormatIndex(37), and
Packit 022b05
        documentFormat(38).
Packit 022b05
Packit 022b05
        Examples of document attributes (one instance per document)
Packit 022b05
        include: fileName(34), and documentName(35).
Packit 022b05
Packit 022b05
        Examples of required and consumed resource attributes include:
Packit 022b05
        pagesRequested(130), mediumRequested(170), pagesCompleted(131),
Packit 022b05
        and mediumConsumed(171), respectively."
Packit 022b05
    ::= { jmAttributeEntry 1 }
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
jmAttributeInstanceIndex OBJECT-TYPE
Packit 022b05
    SYNTAX      Integer32 (1..32767)
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A running 16-bit index of the attributes of the same type for
Packit 022b05
        each job.  For those attributes with only a single instance per
Packit 022b05
        job, this index value SHALL be 1.  For those attributes that
Packit 022b05
        are a single value per document, the index value SHALL be the
Packit 022b05
        document number, starting with 1 for the first document in the
Packit 022b05
        job.  Jobs with only a single document SHALL use the index
Packit 022b05
        value of 1.  For those attributes that can have multiple values
Packit 022b05
        per job or per document, such as documentFormatIndex(37) or
Packit 022b05
        documentFormat(38), the index SHALL be a running index for the
Packit 022b05
        job as a whole, starting at 1."
Packit 022b05
    ::= { jmAttributeEntry 2 }
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
jmAttributeValueAsInteger OBJECT-TYPE
Packit 022b05
    SYNTAX      Integer32 (-2..2147483647)
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The integer value of the attribute.  The value of the
Packit 022b05
        attribute SHALL be represented as an integer if the enum
Packit 022b05
        description in the JmAttributeTypeTC textual-convention
Packit 022b05
        definition has the tag: 'INTEGER:'.
Packit 022b05
Packit 022b05
        Depending on the enum definition, this object value MAY be an
Packit 022b05
        integer, a counter, an index, or an enum, depending on the
Packit 022b05
        jmAttributeTypeIndex value.  The units of this value are
Packit 022b05
        specified in the enum description.
Packit 022b05
Packit 022b05
        For those attributes that are accumulating job consumption as
Packit 022b05
        the job is processed as specified in the JmAttributeTypeTC
Packit 022b05
        textual-convention, SHALL contain the final value after the job
Packit 022b05
        completes processing, i.e., this value SHALL indicate the total
Packit 022b05
        usage of this resource made by the job.
Packit 022b05
Packit 022b05
        A monitoring application is able to copy this value to a
Packit 022b05
        suitable longer term storage for later processing as part of an
Packit 022b05
        accounting system.
Packit 022b05
Packit 022b05
        Since the agent MAY add attributes representing resources to
Packit 022b05
        this table while the job is waiting to be processed or being
Packit 022b05
        processed, which can be a long time before any of the resources
Packit 022b05
        are actually used, the agent SHALL set the value of the
Packit 022b05
        jmAttributeValueAsInteger object to 0 for resources that the
Packit 022b05
        job has not yet consumed.
Packit 022b05
Packit 022b05
        Attributes for which the concept of an integer value is
Packit 022b05
        meaningless, such as fileName(34), jobName, and
Packit 022b05
        processingMessage, do not have the 'INTEGER:' tag in the
Packit 022b05
        JmAttributeTypeTC definition and so an agent SHALL always
Packit 022b05
        return a value of '-1' to indicate 'other' for the value of the
Packit 022b05
        jmAttributeValueAsInteger object for these attributes.
Packit 022b05
Packit 022b05
        For attributes which do have the 'INTEGER:' tag in the
Packit 022b05
        JmAttributeTypeTC definition, if the integer value is not (yet)
Packit 022b05
        known, the agent either (1) SHALL not materialize the row in
Packit 022b05
        the jmAttributeTable until the value is known or (2) SHALL
Packit 022b05
        return a '-2' to represent an 'unknown' counting integer value,
Packit 022b05
        a '0' to represent an 'unknown' index value, and a '2' to
Packit 022b05
        represent an 'unknown(2)' enum value."
Packit 022b05
    DEFVAL      { -2 }      -- default value is unknown(-2)
Packit 022b05
    ::= { jmAttributeEntry 3 }
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
jmAttributeValueAsOctets OBJECT-TYPE
Packit 022b05
    SYNTAX      OCTET STRING(SIZE(0..63))
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The octet string value of the attribute.  The value of the
Packit 022b05
        attribute SHALL be represented as an OCTET STRING if the enum
Packit 022b05
        description in the JmAttributeTypeTC textual-convention
Packit 022b05
        definition has the tag: 'OCTETS:'.
Packit 022b05
Packit 022b05
        Depending on the enum definition, this object value MAY be a
Packit 022b05
        coded character set string (text), such as 'JmUTF8StringTC', or
Packit 022b05
        a binary octet string, such as 'DateAndTime'.
Packit 022b05
Packit 022b05
        Attributes for which the concept of an octet string value is
Packit 022b05
        meaningless, such as pagesCompleted, do not have the tag
Packit 022b05
        'OCTETS:' in the JmAttributeTypeTC definition and so the agent
Packit 022b05
        SHALL always return a zero length string for the value of the
Packit 022b05
        jmAttributeValueAsOctets object.
Packit 022b05
Packit 022b05
        For attributes which do have the 'OCTETS:' tag in the
Packit 022b05
        JmAttributeTypeTC definition, if the OCTET STRING value is not
Packit 022b05
        (yet) known, the agent either SHALL NOT materialize the row in
Packit 022b05
        the jmAttributeTable until the value is known or SHALL return a
Packit 022b05
        zero-length string."
Packit 022b05
    DEFVAL      { ''H }      -- empty string
Packit 022b05
    ::= { jmAttributeEntry 4 }
Packit 022b05
Packit 022b05
Packit 022b05
-- Notifications and Trapping
Packit 022b05
-- Reserved for the future
Packit 022b05
Packit 022b05
jobmonMIBNotifications  OBJECT IDENTIFIER  ::= { jobmonMIB 2 }
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
-- Conformance Information
Packit 022b05
Packit 022b05
jmMIBConformance OBJECT IDENTIFIER ::= { jobmonMIB 3 }
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
-- compliance statements
Packit 022b05
jmMIBCompliance MODULE-COMPLIANCE
Packit 022b05
    STATUS  current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The compliance statement for agents that implement the
Packit 022b05
        job monitoring MIB."
Packit 022b05
    MODULE -- this module
Packit 022b05
    MANDATORY-GROUPS {
Packit 022b05
        jmGeneralGroup, jmJobIDGroup, jmJobGroup, jmAttributeGroup }
Packit 022b05
    OBJECT   jmGeneralJobSetName
Packit 022b05
    SYNTAX   JmUTF8StringTC (SIZE(0..8))
Packit 022b05
    DESCRIPTION
Packit 022b05
        "Only 8 octets maximum string length NEED be supported by the
Packit 022b05
        agent."
Packit 022b05
Packit 022b05
    OBJECT   jmJobOwner
Packit 022b05
    SYNTAX   JmJobStringTC (SIZE(0..16))
Packit 022b05
    DESCRIPTION
Packit 022b05
        "Only 16 octets maximum string length NEED be supported by the
Packit 022b05
        agent."
Packit 022b05
Packit 022b05
-- There are no CONDITIONALLY MANDATORY or OPTIONAL groups.
Packit 022b05
Packit 022b05
    ::= { jmMIBConformance 1 }
Packit 022b05
Packit 022b05
Packit 022b05
jmMIBGroups      OBJECT IDENTIFIER ::= { jmMIBConformance 2 }
Packit 022b05
Packit 022b05
jmGeneralGroup OBJECT-GROUP
Packit 022b05
    OBJECTS {
Packit 022b05
        jmGeneralNumberOfActiveJobs,   jmGeneralOldestActiveJobIndex,
Packit 022b05
        jmGeneralNewestActiveJobIndex, jmGeneralJobPersistence,
Packit 022b05
        jmGeneralAttributePersistence, jmGeneralJobSetName}
Packit 022b05
    STATUS  current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The general group."
Packit 022b05
    ::= { jmMIBGroups 1 }
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
jmJobIDGroup OBJECT-GROUP
Packit 022b05
    OBJECTS {
Packit 022b05
        jmJobIDJobSetIndex, jmJobIDJobIndex }
Packit 022b05
    STATUS  current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The job ID group."
Packit 022b05
    ::= { jmMIBGroups 2 }
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
jmJobGroup OBJECT-GROUP
Packit 022b05
    OBJECTS {
Packit 022b05
        jmJobState, jmJobStateReasons1, jmNumberOfInterveningJobs,
Packit 022b05
        jmJobKOctetsPerCopyRequested, jmJobKOctetsProcessed,
Packit 022b05
        jmJobImpressionsPerCopyRequested, jmJobImpressionsCompleted,
Packit 022b05
        jmJobOwner }
Packit 022b05
    STATUS  current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The job group."
Packit 022b05
    ::= { jmMIBGroups 3 }
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
jmAttributeGroup OBJECT-GROUP
Packit 022b05
    OBJECTS {
Packit 022b05
        jmAttributeValueAsInteger, jmAttributeValueAsOctets }
Packit 022b05
    STATUS  current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The attribute group."
Packit 022b05
    ::= { jmMIBGroups 4 }
Packit 022b05
Packit 022b05
Packit 022b05
END