Tech-invite3GPPspaceIETFspace
96959493929190898887868584838281807978777675747372717069686766656463626160595857565554535251504948474645444342414039383736353433323130292827262524232221201918171615141312111009080706050403020100
in Index   Prev   Next

RFC 2707

Job Monitoring MIB - V1.0

Pages: 114
Informational
Part 2 of 5 – Pages 20 to 51
First   Prev   Next

Top   ToC   RFC2707 - Page 20   prevText

3.3 The Attribute Mechanism and the Attribute Table(s)

Attributes are similar to information objects, except that attributes are identified by an enum, instead of an OID, so that attributes may be registered without requiring a new MIB. Also an implementation that does not have the functionality represented by the attribute can omit the attribute entirely, rather than having to return a distinguished value. The agent is free to materialize an attribute in the jmAttributeTable as soon as the agent is aware of the value of the attribute. The agent materializes job attributes in a four-indexed jmAttributeTable: 1. jmGeneralJobSetIndex - which job set 2. jmJobIndex - which job in the job set 3. jmAttributeTypeIndex - which attribute 4. jmAttributeInstanceIndex - which attribute instance for those attributes that can have multiple values per job. Some attributes represent information about a job, such as a file- name, a document-name, a submission-time or a completion time. Other attributes represent resources required, e.g., a medium or a colorant, etc. to process the job before the job starts processing OR to indicate the amount of the resource consumed during and after processing, e.g., pages completed or impressions completed. If both a required and a consumed value of a resource is needed, this specification assigns two separate attribute enums in the textual convention. NOTE - The table of contents lists all the attributes in order. This order is the order of enum assignments which is the order that the SNMP GetNext operation returns attributes. Most attributes apply to all three configurations covered by this MIB specification (see
Top   ToC   RFC2707 - Page 21
   section 2.1 entitled "System Configurations for the Job Monitoring
   MIB").  Those attributes that apply to a particular configuration are
   indicated as 'Configuration n:' and SHALL NOT be used with other
   configurations.

3.3.1 Conformance of Attribute Implementation

An agent SHALL implement any attribute if (1) the server or device supports the functionality represented by the attribute and (2) the information is available to the agent. The agent MAY create the attribute row in the jmAttributeTable when the information is available or MAY create the row earlier with the designated 'unknown' value appropriate for that attribute. See next section. If the server or device does not implement or does not provide access to the information about an attribute, the agent SHOULD NOT create the corresponding row in the jmAttributeTable.

3.3.2 Useful, 'Unknown', and 'Other' Values for Objects and Attributes

Some attributes have a 'useful' Integer32 value, some have a 'useful' OCTET STRING value, some MAY have either or both depending on implementation, and some MUST have both. See the JmAttributeTypeTC textual convention for the specification of each attribute. SNMP requires that if an object cannot be implemented because its values cannot be accessed, then a compliant agent SHALL return an SNMP error in SNMPv1 or an exception value in SNMPv2. However, this MIB has been designed so that 'all' objects can and SHALL be implemented by an agent, so that neither the SNMPv1 error nor the SNMPv2 exception value SHALL be generated by the agent. This MIB has also been designed so that when an agent materializes an attribute, the agent SHALL materialize a row consisting of both the jmAttributeValueAsInteger and jmAttributeValueAsOctets objects. In general, values for objects and attributes have been chosen so that a management application will be able to determine whether a ' useful', 'unknown', or 'other' value is available. When a useful value is not available for an object, that agent SHALL return a zero-length string for octet strings, the value 'unknown(2)' for enums, a '0' value for an object that represents an index in another table, and a value '-2' for counting integers. Since each attribute is represented by a row consisting of both the jmAttributeValueAsInteger and jmAttributeValueAsOctets MANDATORY objects, SNMP requires that the agent SHALL always create an attribute row with both objects specified. However, for most attributes the agent SHALL return a "useful" value for one of the
Top   ToC   RFC2707 - Page 22
   objects and SHALL return the 'other' value for the other object.  For
   integer only attributes, the agent SHALL always return a zero-length
   string value for the jmAttributeValueAsOctets object.  For octet
   string only attributes, the agent SHALL always return a '-1' value
   for the jmAttributeValueAsInteger object.

3.3.3 Index Value Attributes

A number of attributes are indexes in other tables. Such attribute names end with the word 'Index'. If the agent has not (yet) assigned an index value for a particular index attribute for a job, the agent SHALL either: (1) return the value 0 or (2) not add this attribute to the jmAttributeTable until the index value is assigned. In the interests of brevity, the semantics for 0 is specified once here and is not repeated for each index attribute specification and a DEFVAL of 0 is implied, even though the DEFVAL for jmAttributeValueAsInteger is -2.

3.3.4 Data Sub-types and Attribute Naming Conventions

Many attributes are sub-typed to give a more specific data type than Integer32 or OCTET STRING. The data sub-type of each attribute is indicated on the first line(s) of the description. Some attributes have several different data sub-type representations. When an attribute has both an Integer32 data sub-type and an OCTET STRING data sub-type, the attribute can be represented in a single row in the jmAttributeTable. In this case, the data sub-type name is not included as the last part of the name of the attribute, e.g., documentFormat(38) which is both an enum and/or a name. When the data sub-types cannot be represented by a single row in the jmAttributeTable, each such representation is considered a separate attribute and is assigned a separate name and enum value. For these attributes, the name of the data sub-type is the last part of the name of the attribute: Name, Index, DateAndTime, TimeStamp, etc. For example, documentFormatIndex(37) is an index. NOTE: The Table of Contents also lists the data sub-type and/or data sub-types of each attribute, using the textual-convention name when such is defined. The following abbreviations are used in the Table of Contents as shown:
Top   ToC   RFC2707 - Page 23
     'Int32(-2..)'     Integer32 (-2..2147483647)
     'Int32(0..)'      Integer32 (0..2147483647)
     'Int32(1..)'      Integer32 (1..2147483647)
     'Int32(m..n)'     For all other Integer ranges, the lower
                       and upper bound of the range is
                       indicated.
     'UTF8String63'    JmUTF8StringTC (SIZE(0..63))
     'JobString63'     JmJobStringTC (SIZE(0..63))
     'Octets63'        OCTET STRING (SIZE(0..63))
     'Octets(m..n)'    For all other OCTET STRING ranges, the
                       exact range is indicated.

3.3.5 Single-Value (Row) Versus Multi-Value (MULTI-ROW) Attributes

Most attributes have only one row per job. However, a few attributes can have multiple values per job or even per document, where each value is a separate row in the jmAttributeTable. Unless indicated with 'MULTI-ROW:' in the JmAttributeTypeTC description, an agent SHALL ensure that each attribute occurs only once in the jmAttributeTable for a job. Most of the 'MULTI-ROW' attributes do not allow duplicate values, i.e., the agent SHALL ensure that each value occurs only once for a job. Only if the specification of the ' MULTI-ROW' attribute also says "There is no restriction on the same xxx occurring in multiple rows" can the agent allow duplicate values to occur for the job. NOTE - Duplicates are allowed for 'extensive' 'MULTI-ROW' attributes, such as fileName(34) or documentName(35) which are specified to be ' per-document' attributes, but are not allowed for 'intensive' ' MULTI-ROW' attributes, such as mediumConsumed(171) and documentFormat(38) which are specified to be 'per-job' attributes.

3.3.6 Requested Objects and Attributes

A number of objects and attributes record requirements for the job. Such object and attribute names end with the word 'Requested'. In the interests of brevity, the phrase 'requested' means: (1) requested by the client (or intervening server) in the job submission protocol and may also mean (2) embedded in the submitted document data, and/or (3) defaulted by the recipient device or server with the same semantics as if the requester had supplied, depending on implementation. Also if a value is supplied by the job submission client, and the server/device determines a better value, through processing or other means, the agent MAY return that better value for such object and attribute.
Top   ToC   RFC2707 - Page 24

3.3.7 Consumption Attributes

A number of objects and attributes record consumption. Such attribute names end with the word 'Completed' or 'Consumed'. If the job has not yet consumed what that resource is metering, the agent either: (1) SHALL return the value 0 or (2) SHALL not add this attribute to the jmAttributeTable until the consumption begins. In the interests of brevity, the semantics for 0 is specified once here and is not repeated for each consumption attribute specification and a DEFVAL of 0 is implied, even though the DEFVAL for jmAttributeValueAsInteger is -2.

3.3.8 Attribute Specifications

This section specifies the job attributes. In the following definitions of the attributes, each description indicates whether the useful value of the attribute SHALL be represented using the jmAttributeValueAsInteger or the jmAttributeValueAsOctets objects by the initial tag: 'INTEGER:' or ' OCTETS:', respectively. Some attributes allow the agent implementer a choice of useful values of either an integer, an octet string representation, or both, depending on implementation. These attributes are indicated with ' INTEGER:' AND/OR 'OCTETS:' tags. A very few attributes require both objects at the same time to represent a pair of useful values (see mediumConsumed(171)). These attributes are indicated with 'INTEGER:' AND 'OCTETS:' tags. See the jmAttributeGroup for the descriptions of these two MANDATORY objects. NOTE - The enum assignments are grouped logically with values assigned in groups of 20, so that additional values may be registered in the future and assigned a value that is part of their logical grouping. Values in the range 2**30 to 2**31-1 are reserved for private or experimental usage. This range corresponds to the same range reserved in IPP. Implementers are warned that use of such values may conflict with other implementations. Implementers are encouraged to request registration of enum values following the procedures in Section 3.7.1. NOTE: No attribute name exceeds 31 characters.
Top   ToC   RFC2707 - Page 25
   The standard attribute types are:

    jmAttributeTypeIndex              Datatype
    --------------------              --------

    other(1),                         Integer32 (-2..2147483647)
                                      AND/OR
                                      OCTET STRING(SIZE(0..63))
        INTEGER:  and/or  OCTETS:  An attribute that is not in the
        list and/or that has not been approved and registered with
        the PWG.

    +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
    + Job State attributes (3 - 19 decimal)
    +
    + The following attributes specify the state of a job.
    +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

    jobStateReasons2(3),              JmJobStateReasons2TC
        INTEGER:  Additional information about the job's current state
        that augments the jmJobState object.  See the description under
        the JmJobStateReasons1TC textual-convention.

    jobStateReasons3(4),              JmJobStateReasons3TC
        INTEGER:  Additional information about the job's current state
        that augments the jmJobState object.  See the description under
        JmJobStateReasons1TC textual-convention.

    jobStateReasons4(5),              JmJobStateReasons4TC
        INTEGER:  Additional information about the job's current state
        that augments the jmJobState object.  See the description under
        JmJobStateReasons1TC textual-convention.

    processingMessage(6),             JmUTF8StringTC (SIZE(0..63))
        OCTETS:  MULTI-ROW:  A coded character set message that is
        generated by the server or device during the processing of the
        job as a simple form of processing log to show progress and any
        problems.  The natural language of each value is specified by
        the corresponding processingMessageNaturalLangTag(7) value.

        NOTE - This attribute is intended for such conditions as
        interpreter messages, rather than being the printable form of
        the jmJobState and jmJobStateReasons1 objects and
        jobStateReasons2, jobStateReasons3, and jobStateReasons4
        attributes.  In order to produce a localized printable form of
        these job state objects/attribute, a management application
        SHOULD produce a message from their enum and bit values.
Top   ToC   RFC2707 - Page 26
        NOTE - There is no job description attribute in IPP/1.0 that
        corresponds to this attribute and this attribute does not
        correspond to the IPP/1.0 'job-state-message' job description
        attribute, which is just a printable form of the IPP 'job-state'
        and 'job-state-reasons' job attributes.

        There is no restriction for the same message occurring in
        multiple rows.

    processingMessageNaturalLangTag(7),   OCTET STRING(SIZE(0..63))
        OCTETS:  MULTI-ROW:  The natural language of the corresponding
        processingMessage(6) attribute value.  See section 3.6.1,
        entitled 'Text generated by the server or device'.

        If the agent does not know the natural language of the job
        processing message, the agent SHALL either (1) return a zero
        length string value for the processingMessageNaturalLangTag(7)
        attribute or (2) not return the
        processingMessageNaturalLangTag(7) attribute for the job.

        There is no restriction for the same tag occurring in multiple
        rows, since when this attribute is implemented, it SHOULD have a
        value row for each corresponding processingMessage(6) attribute
        value row.

    jobCodedCharSet(8),               CodedCharSet
        INTEGER:  The MIBenum identifier of the coded character set that
        the agent is using to represent coded character set objects and
        attributes of type 'JmJobStringTC'.  These coded character set
        objects and attributes are either: (1) supplied by the job
        submitting client or (2) defaulted by the server or device when
        omitted by the job submitting client.  The agent SHALL represent
        these objects and attributes in the MIB either (1) in the coded
        character set as they were submitted or (2) MAY convert the
        coded character set to another coded character set or encoding
        scheme as identified by the jobCodedCharSet(8) attribute.  See
        section 3.6.2, entitled 'Text supplied by the job submitter'.

        These MIBenum values are assigned by IANA [IANA-charsets] when
        the coded character sets are registered.  The coded character
        set SHALL be one of the ones registered with IANA [IANA] and the
        enum value uses the CodedCharSet textual-convention from the
        Printer MIB.  See the JmJobStringTC textual-convention.

        If the agent does not know what coded character set was used by
        the job submitting client, the agent SHALL either (1) return the
        'unknown(2)' value for the jobCodedCharSet(8) attribute or (2)
        not return the jobCodedCharSet(8) attribute for the job.
Top   ToC   RFC2707 - Page 27
    jobNaturalLanguageTag(9),         OCTET STRING(SIZE(0..63))
        OCTETS: The natural language of the job attributes supplied by
        the job submitter or defaulted by the server or device for the
        job, i.e., all objects and attributes represented by the '
        JmJobStringTC' textual-convention, such as jobName,
        mediumRequested, etc.  See Section 3.6.2, entitled 'Text
        supplied by the job submitter'.

        If the agent does not know what natural language was used by the
        job submitting client, the agent SHALL either (1) return a zero
        length string value for the jobNaturalLanguageTag(9) attribute
        or (2) not return jobNaturalLanguageTag(9)  attribute for the
        job.

    +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
    + Job Identification attributes (20 - 49 decimal)
    +
    + The following attributes help an end user, a system
    + operator, or an accounting program identify a job.
    +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

    jobURI(20),                       OCTET STRING(SIZE(0..63))
        OCTETS:  MULTI-ROW:  The job's Universal Resource
        Identifier (URI) [RFC1738].  See IPP [ipp-model] for
        example usage.

        NOTE - The agent may be able to generate this value on each
        SNMP Get operation from smaller values, rather than having
        to store the entire URI.

        If the URI exceeds 63 octets, the agent SHALL use multiple
        values, with the next 63 octets coming in the second value,
        etc.

        NOTE - IPP [ipp-model] has a 1023-octet maximum length for
        a URI, though the URI standard itself and HTTP/1.1 specify
        no maximum length.

    jobAccountName(21),               OCTET STRING(SIZE(0..63))
        OCTETS:  Arbitrary binary information which MAY be coded
        character set data or encrypted data supplied by the
        submitting user for use by accounting services to allocate
        or categorize charges for services provided, such as a
        customer account name or number.

        NOTE: This attribute NEED NOT be printable characters.
Top   ToC   RFC2707 - Page 28
    serverAssignedJobName(22),        JmJobStringTC (SIZE(0..63))
        OCTETS:  Configuration 3 only:  The human readable string
        name, number, or ID of the job as assigned by the server
        that submitted the job to the device that the agent is
        providing access to with this MIB.

        NOTE - This attribute is intended for enabling a user to
        find his/her job that a server submitted to a device when
        either the client does not support the jmJobSubmissionID or
        the server does not pass the jmJobSubmissionID through to
        the device.

    jobName(23),                      JmJobStringTC (SIZE(0..63))
        OCTETS:  The human readable string name of the job as
        assigned by the submitting user to help the user
        distinguish between his/her various jobs.  This name does
        not need to be unique.

        This attribute is intended for enabling a user or the
        user's application to convey a job name that MAY be printed
        on a start sheet, returned in a query result, or used in
        notification or logging messages.

        In order to assist users to find their jobs for job
        submission protocols that don't supply a jmJobSubmissionID,
        the agent SHOULD maintain the jobName attribute for the
        time specified by the jmGeneralJobPersistence object,
        rather than the (shorter) jmGeneralAttributePersistence
        object.

        If this attribute is not specified when the job is
        submitted, no job name is assumed, but implementation
        specific defaults are allowed, such as the value of the
        documentName attribute of the first document in the job or
        the fileName attribute of the first document in the job.

        The jobName attribute is distinguished from the jobComment
        attribute, in that the jobName attribute is intended to
        permit the submitting user to distinguish between different
        jobs that he/she has submitted.  The jobComment attribute
        is intended to be free form additional information that a
        user might wish to use to communicate with himself/herself,
        such as a reminder of what to do with the results or to
        indicate a different set of input parameters were tried in
        several different job submissions.
Top   ToC   RFC2707 - Page 29
    jobServiceTypes(24),              JmJobServiceTypesTC
        INTEGER:  Specifies the type(s) of service to which the job
        has been submitted (print, fax, scan, etc.).  The service
        type is bit encoded with each job service type so that more
        general and arbitrary services can be created, such as
        services with more than one destination type, or ones with
        only a source or only a destination.  For example, a job
        service might scan, faxOut, and print a single job.  In
        this case, three bits would be set in the jobServiceTypes
        attribute, corresponding to the hexadecimal values: 0x8 +
        0x20 + 0x4, respectively, yielding: 0x2C.

        Whether this attribute is set from a job attribute supplied
        by the job submission client or is set by the recipient job
        submission server or device depends on the job submission
        protocol.  This attribute SHALL be implemented if the
        server or device has other types in addition to or instead
        of printing.

        One of the purposes of this attribute is to permit a
        requester to filter out jobs that are not of interest.  For
        example, a printer operator may only be interested in jobs
        that include printing.

    jobSourceChannelIndex(25),        Integer32 (0..2147483647)
        INTEGER:  The index of the row in the associated Printer
        MIB [print-mib] of the channel which is the source of the
        print job.

    jobSourcePlatformType(26),        JmJobSourcePlatformTypeTC
        INTEGER:  The source platform type of the immediate
        upstream submitter that submitted the job to the server
        (configuration 2) or device (configuration 1 and 3) to
        which the agent is providing access.  For configuration 1,
        this is the type of the client that submitted the job to
        the device;  for configuration 2, this is the type of the
        client that submitted the job to the server; and for
        configuration 3, this is the type of the server that
        submitted the job to the device.

    submittingServerName(27),         JmJobStringTC (SIZE(0..63))
        OCTETS:  For configuration 3 only:  The administrative name
        of the server that submitted the job to the device.

    submittingApplicationName(28),    JmJobStringTC (SIZE(0..63))
        OCTETS:  The name of the client application (not the server
        in configuration 3) that submitted the job to the server or
        device.
Top   ToC   RFC2707 - Page 30
    jobOriginatingHost(29),           JmJobStringTC (SIZE(0..63))
        OCTETS:  The name of the client host (not the server host
        name in configuration 3) that submitted the job to the
        server or device.

    deviceNameRequested(30),          JmJobStringTC (SIZE(0..63))
        OCTETS:  The administratively defined coded character set
        name of the target device requested by the submitting user.
        For configuration 1, its value corresponds to the Printer
        MIB [print-mib]: prtGeneralPrinterName object.  For
        configuration 2 and 3, its value is the name of the logical
        or physical device that the user supplied to indicate to
        the server on which device(s) they wanted the job to be
        processed.

    queueNameRequested(31),           JmJobStringTC (SIZE(0..63))
        OCTETS:  The administratively defined coded character set
        name of the target queue requested by the submitting user.
        For configuration 1, its value corresponds to the queue in
        the device for which the agent is providing access.  For
        configuration 2 and 3, its value is the name of the queue
        that the user supplied to indicate to the server on which
        device(s) they wanted the job to be processed.

        NOTE - typically an implementation SHOULD support either
        the deviceNameRequested or queueNameRequested attribute,
        but not both.

    physicalDevice(32),               hrDeviceIndex
                                      AND/OR
                                      JmUTF8StringTC (SIZE(0..63))
        INTEGER:  MULTI-ROW:  The index of the physical device MIB
        instance requested/used, such as the Printer MIB [print-mib].
        This value is an hrDeviceIndex value.  See the Host
        Resources MIB [hr-mib].

        AND/OR

        OCTETS:  MULTI-ROW:  The name of the physical device to
        which the job is assigned.

    numberOfDocuments(33),            Integer32 (-2..2147483647)
        INTEGER:  The number of documents in this job.

        The agent SHOULD return this attribute if the job has more
        than one document.
Top   ToC   RFC2707 - Page 31
    fileName(34),                     JmJobStringTC (SIZE(0..63))
        OCTETS:  MULTI-ROW:  The coded character set file name or
        URI [URI-spec] of the document.

        There is no restriction on the same file name occurring in
        multiple rows.

    documentName(35),                 JmJobStringTC (SIZE(0..63))
        OCTETS:  MULTI-ROW:  The coded character set name of the
        document.

        There is no restriction on the same document name occurring
        in multiple rows.

    jobComment(36),                   JmJobStringTC (SIZE(0..63))
        OCTETS:  An arbitrary human-readable coded character text
        string supplied by the submitting user or the job
        submitting application program for any purpose.  For
        example, a user might indicate what he/she is going to do
        with the printed output or the job submitting application
        program might indicate how the document was produced.

        The jobComment attribute is not intended to be a name; see
        the jobName attribute.

    documentFormatIndex(37),          Integer32 (0..2147483647)
        INTEGER:  MULTI-ROW:  The index in the prtInterpreterTable
        in the Printer MIB [print-mib] of the page description
        language (PDL) or control language interpreter that this
        job requires/uses.  A document or a job MAY use more than
        one PDL or control language.

        NOTE - As with all intensive attributes where multiple rows
        are allowed, there SHALL be only one distinct row for each
        distinct interpreter; there SHALL be no duplicates.

        NOTE - This attribute type is intended to be used with an
        agent that implements the Printer MIB and SHALL not be used
        if the agent does not implement the Printer MIB.  Such an
        agent SHALL use the documentFormat attribute instead.
Top   ToC   RFC2707 - Page 32
    documentFormat(38),               PrtInterpreterLangFamilyTC
                                      AND/OR
                                      OCTET STRING(SIZE(0..63))
        INTEGER:  MULTI-ROW:  The interpreter language family
        corresponding to the Printer MIB [print-mib]
        prtInterpreterLangFamily object, that this job
        requires/uses.  A document or a job MAY use more than one
        PDL or control language.

        AND/OR

        OCTETS:  MULTI-ROW:  The document format registered as a
        media type [iana-media-types], i.e., the name of the MIME
        content-type/subtype.  Examples: 'application/postscript',
        'application/vnd.hp-PCL', 'application/pdf', 'text/plain'
        (US-ASCII SHALL be assumed), 'text/plain; charset=iso-8859-1',
        and 'application/octet-stream'.  The IPP 'document-format'
        job attribute uses these same values with the same semantics.
        See the IPP [ipp-model] 'mimeMediaType' attribute syntax and
        the document-format attribute for further examples and
        explanation.

    +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
    + Job Parameter attributes (50 - 67 decimal)
    +
    + The following attributes represent input parameters
    + supplied by the submitting client in the job submission
    + protocol.
    +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

    jobPriority(50),                  Integer32 (-2..100)
        INTEGER:  The priority for scheduling the job.  It is used by
        servers and devices that employ a priority-based scheduling
        algorithm.

        A higher value specifies a higher priority.  The value 1 is
        defined to indicate the lowest possible priority (a job which a
        priority-based scheduling algorithm SHALL pass over in favor of
        higher priority jobs).  The value 100 is defined to indicate the
        highest possible priority.  Priority is expected to be evenly or
        'normally' distributed across this range.  The mapping of
        vendor-defined priority over this range is implementation-
        specific.  -2 indicates unknown.

    jobProcessAfterDateAndTime(51),   DateAndTime (SNMPv2-TC)
        OCTETS:  The calendar date and time of day after which the job
        SHALL become a candidate to be scheduled for processing.  If the
        value of this attribute is in the future, the server SHALL set
Top   ToC   RFC2707 - Page 33
        the value of the job's jmJobState object to pendingHeld and add
        the jobProcessAfterSpecified bit value to the job's
        jmJobStateReasons1 object.  When the specified date and time
        arrives, the server SHALL remove the jobProcessAfterSpecified
        bit value from the job's jmJobStateReasons1 object and, if no
        other reasons remain, SHALL change the job's jmJobState object
        to pending.

    jobHold(52),                      JmBooleanTC
        INTEGER:  If the value is 'true(4)', a client has explicitly
        specified that the job is to be held until explicitly released.
        Until the job is explicitly released by a client, the job SHALL
        be in the pendingHeld state with the jobHoldSpecified value in
        the jmJobStateReasons1 attribute.

    jobHoldUntil(53),                 JmJobStringTC (SIZE(0..63))
        OCTETS:  The named time period during which the job SHALL become
        a candidate for processing, such as 'evening', 'night', '
        weekend', 'second-shift', 'third-shift', etc., (supported values
        configured by the system administrator).  See IPP [ipp-model]
        for the standard keyword values.  Until that time period
        arrives, the job SHALL be in the pendingHeld state with the
        jobHoldUntilSpecified value in the jmJobStateReasons1 object.
        The value 'no-hold' SHALL indicate explicitly that no time
        period has been specified; the absence of this attribute SHALL
        indicate implicitly that no time period has been specified.

    outputBin(54),                    Integer32 (0..2147483647)
                                      AND/OR
                                      JmJobStringTC (SIZE(0..63))
        INTEGER:  MULTI-ROW:  The output subunit index in the Printer
        MIB [print-mib]

        AND/OR

        OCTETS:  MULTI-ROW:  the name or number (represented as ASCII
        digits) of the output bin to which all or part of the job is
        placed in.

    sides(55),                        Integer32 (-2..2)
        INTEGER: MULTI-ROW: The number of sides, '1' or '2', that any
        document in this job requires/used.

    finishing(56),                    JmFinishingTC
        INTEGER:  MULTI-ROW:  Type of finishing that any document in
        this job requires/used.
Top   ToC   RFC2707 - Page 34
    +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
    + Image Quality attributes (requested and consumed) (70 - 87)
    +
    + For devices that can vary the image quality.
    +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

    printQualityRequested(70),        JmPrintQualityTC
        INTEGER:  MULTI-ROW:  The print quality selection requested for
        a document in the job for printers that allow quality
        differentiation.

    printQualityUsed(71),             JmPrintQualityTC
        INTEGER:  MULTI-ROW:  The print quality selection actually used
        by a document in the job for printers that allow quality
        differentiation.

    printerResolutionRequested(72),   JmPrinterResolutionTC
        OCTETS:  MULTI-ROW:  The printer resolution requested for a
        document in the job for printers that support resolution
        selection.

    printerResolutionUsed(73),        JmPrinterResolutionTC
        OCTETS:  MULTI-ROW:  The printer resolution actually used by a
        document in the job for printers that support resolution
        selection.

    tonerEcomonyRequested(74),        JmTonerEconomyTC
        INTEGER:  MULTI-ROW:  The toner economy selection requested for
        documents in the job for printers that allow toner economy
        differentiation.

    tonerEcomonyUsed(75),             JmTonerEconomyTC
        INTEGER:  MULTI-ROW:  The toner economy selection actually used
        by documents in the job for printers that allow toner economy
        differentiation.

    tonerDensityRequested(76)         Integer32 (-2..100)
        INTEGER:  MULTI-ROW:  The toner density requested for a document
        in this job for devices that can vary toner density levels.
        Level 1 is the lowest density and level 100 is the highest
        density level.  Devices with a smaller range, SHALL map the
        1-100 range evenly onto the implemented range.

    tonerDensityUsed(77),             Integer32 (-2..100)
        INTEGER:  MULTI-ROW:  The toner density used by documents in
        this job for devices that can vary toner density levels.  Level
Top   ToC   RFC2707 - Page 35
        1 is the lowest density and level 100 is the highest density
        level.  Devices with a smaller range, SHALL map the 1-100 range
        evenly onto the implemented range.

    +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
    + Job Progress attributes (requested and consumed) (90-109)
    +
    + Pairs of these attributes can be used by monitoring
    + applications to show an indication of relative progress
    + to users.  See section 3.4, entitled:
    + 'Monitoring Job Progress'.
    +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

    jobCopiesRequested(90),           Integer32 (-2..2147483647)
        INTEGER:  The number of copies of the entire job that are to be
        produced.

    jobCopiesCompleted(91),           Integer32 (-2..2147483647)
        INTEGER:  The number of copies of the entire job that have been
        completed so far.

    documentCopiesRequested(92),      Integer32 (-2..2147483647)
        INTEGER:  The total count of the number of document copies
        requested for the job as a whole.  If there are documents A, B,
        and C, and document B is specified to produce 4 copies, the
        number of document copies requested is 6 for the job.

        This attribute SHALL be used only when a job has multiple
        documents.  The jobCopiesRequested attribute SHALL be used when
        the job has only one document.

    documentCopiesCompleted(93),      Integer32 (-2..2147483647)
        INTEGER:  The total count of the number of document copies
        completed so far for the job as a whole.  If there are documents
        A, B, and C, and document B is specified to produce 4 copies,
        the number of document copies starts a 0 and runs up to 6 for
        the job as the job processes.

        This attribute SHALL be used only when a job has multiple
        documents.  The jobCopiesCompleted attribute SHALL be used when
        the job has only one document.

    jobKOctetsTransferred(94),        Integer32 (-2..2147483647)
        INTEGER:  The number of K (1024) octets transferred to the
        server or device to which the agent is providing access.  This
        count is independent of the number of copies of the job or
        documents that will be produced, but it is only a measure of the
        number of bytes transferred to the server or device.
Top   ToC   RFC2707 - Page 36
        The agent SHALL round the actual number of octets transferred up
        to the next higher K.  Thus 0 octets SHALL be represented as '
        0', 1-1024 octets SHALL BE represented as '1', 1025-2048 SHALL
        be '2', etc.  When the job completes, the values of the
        jmJobKOctetsPerCopyRequested object and the
        jobKOctetsTransferred attribute SHALL be equal.

        NOTE - The jobKOctetsTransferred can be used with the
        jmJobKOctetsPerCopyRequested object in order to produce a
        relative indication of the progress of the job for agents that
        do not implement the jmJobKOctetsProcessed object.

    sheetCompletedCopyNumber(95),     Integer32 (-2..2147483647)
        INTEGER:  The number of the copy being stacked for the current
        document.  This number starts at 0, is set to 1 when the first
        sheet of the first copy for each document is being stacked and
        is equal to n where n is the nth sheet stacked in the current
        document copy.  See section 3.4 , entitled 'Monitoring Job
        Progress'.

    sheetCompletedDocumentNumber(96), Integer32 (-2..2147483647)
        INTEGER:  The ordinal number of the document in the job that is
        currently being stacked.  This number starts at 0, increments to
        1 when the first sheet of the first document in the job is being
        stacked, and is equal to n where n is the nth document in the
        job, starting with 1.

        Implementations that only support one document jobs SHOULD NOT
        implement this attribute.

    jobCollationType(97),             JmJobCollationTypeTC
        INTEGER:  The type of job collation. See also Section 3.4,
        entitled 'Monitoring Job Progress'.

   ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
   + Impression attributes (110 - 129 decimal)
   +
   + See the definition of the terms 'impression', 'sheet',
   + and 'page' in Section 2.
   +
   + See also jmJobImpressionsPerCopyRequested and
   + jmJobImpressionsCompleted objects in the jmJobTable.
   ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

   impressionsSpooled(110),          Integer32 (-2..2147483647)
        INTEGER:  The number of impressions spooled to the server or
        device for the job so far.
Top   ToC   RFC2707 - Page 37
    impressionsSentToDevice(111),     Integer32 (-2..2147483647)
        INTEGER:  The number of impressions sent to the device for the
        job so far.

    impressionsInterpreted(112),      Integer32 (-2..2147483647)
        INTEGER:  The number of impressions interpreted for the job so
        far.

    impressionsCompletedCurrentCopy(113),
                                      Integer32 (-2..2147483647)
        INTEGER:  The number of impressions completed by the device for
        the current copy of the current document so far.  For printing,
        the impressions completed includes interpreting, marking, and
        stacking the output.  For other types of job services, the
        number of impressions completed includes the number of
        impressions processed.

        This value SHALL be reset to 0 for each document in the job and
        for each document copy.

    fullColorImpressionsCompleted(114), Integer32 (-2..2147483647)
        INTEGER:  The number of full color impressions completed by the
        device for this job so far.  For printing, the impressions
        completed includes interpreting, marking, and stacking the
        output.  For other types of job services, the number of
        impressions completed includes the number of impressions
        processed. Full color impressions are typically defined as those
        requiring 3 or more colorants, but this MAY vary by
        implementation.  In any case, the value of this attribute counts
        by 1 for each side that has full color, not by the number of
        colors per side (and the other impression counters are
        incremented, except highlightColorImpressionsCompleted(115)).

    highlightColorImpressionsCompleted(115),
                                      Integer32 (-2..2147483647)
        INTEGER:  The number of highlight color impressions
        completed by the device for this job so far.  For printing,
        the impressions completed includes interpreting, marking,
        and stacking the output.  For other types of job services,
        the number of impressions completed includes the number of
        impressions processed.  Highlight color impressions are
        typically defined as those requiring black plus one other
        colorant, but this MAY vary by implementation.  In any
        case, the value of this attribute counts by 1 for each side
        that has highlight color (and the other impression counters
        are incremented, except
        fullColorImpressionsCompleted(114)).
Top   ToC   RFC2707 - Page 38
    +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
    + Page attributes (130 - 149 decimal)
    +
    + See the definition of 'impression', 'sheet', and 'page'
    + in Section 2.
    +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

    pagesRequested(130),              Integer32 (-2..2147483647)
        INTEGER:  The number of logical pages requested by the job
        to be processed.

    pagesCompleted(131),              Integer32 (-2..2147483647)
        INTEGER:  The number of logical pages completed for this
        job so far.

        For implementations where multiple copies are produced by
        the interpreter with only a single pass over the data, the
        final value SHALL be equal to the value of the
        pagesRequested object.  For implementations where multiple
        copies are produced by the interpreter by processing the
        data for each copy, the final value SHALL be a multiple of
        the value of the pagesRequested object.

        NOTE - See the impressionsCompletedCurrentCopy and
        pagesCompletedCurrentCopy attributes for attributes that
        are reset on each document copy.

        NOTE - The pagesCompleted object can be used with the
        pagesRequested object to provide an indication of the
        relative progress of the job, provided that the
        multiplicative factor is taken into account for some
        implementations of multiple copies.

    pagesCompletedCurrentCopy(132),   Integer32 (-2..2147483647)
        INTEGER:  The number of logical pages completed for the
        current copy of the document so far.  This value SHALL be
        reset to 0 for each document in the job and for each
        document copy.

    +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
    + Sheet attributes (150 - 169 decimal)
    +
    + See the definition of 'impression', 'sheet', and 'page'
    + in Section 2.
    +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Top   ToC   RFC2707 - Page 39
    sheetsRequested(150),             Integer32 (-2..2147483647)
        INTEGER:  The total number of medium sheets requested to be
        produced for this job.

        Unlike the jmJobKOctetsPerCopyRequested and
        jmJobImpressionsPerCopyRequested attributes, the
        sheetsRequested(150) attribute SHALL include the
        multiplicative factor contributed by the number of copies
        and so is the total number of sheets to be produced by the
        job, as opposed to the size of the document(s) submitted.

    sheetsCompleted(151),             Integer32 (-2..2147483647)
        INTEGER:  The total number of medium sheets that have
        completed marking and stacking for the entire job so far
        whether those sheets have been processed on one side or on
        both.

    sheetsCompletedCurrentCopy(152),  Integer32 (-2..2147483647)
        INTEGER:  The number of medium sheets that have completed
        marking and stacking for the current copy of a document in
        the job so far whether those sheets have been processed on
        one side or on both.

        The value of this attribute SHALL be 0 before the job
        starts processing and SHALL be reset to 1 after the first
        sheet of each document and document copy in the job is
        processed and stacked.

    ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
    + Resources attributes (requested and consumed) (170 - 189)
    +
    + Pairs of these attributes can be used by monitoring
    + applications to show an indication of relative usage to
    + users, i.e., a 'thermometer'.
    ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

    mediumRequested(170),             JmMediumTypeTC
                                      AND/OR
                                      JmJobStringTC (SIZE(0..63))
        INTEGER:  MULTI-ROW:  The type
        AND/OR
        OCTETS:  MULTI-ROW:  the name of the medium that is
        required by the job.

        NOTE - The name (JmJobStringTC) values correspond to the
        name values of the prtInputMediaName object in the Printer
        MIB [print-mib] and the name, size, and input tray values
        of the IPP 'media' attribute [ipp-model].
Top   ToC   RFC2707 - Page 40
    mediumConsumed(171),              Integer32 (-2..2147483647)
                                      AND
                                      JmJobStringTC (SIZE(0..63))
        INTEGER:  MULTI-ROW:  The number of sheets
        AND
        OCTETS:  MULTI-ROW:  the name of the medium that has been
        consumed so far whether those sheets have been processed on
        one side or on both.

        This attribute SHALL have both Integer32 and OCTET STRING
        (represented as  JmJobStringTC) values.

        NOTE - The name (JmJobStringTC) values correspond to the
        name values of the prtInputMediaName object in the Printer
        MIB [print-mib] and the name, size, and input tray values
        of the IPP 'media' attribute [ipp-model].

    colorantRequested(172),           Integer32 (-2..2147483647)
                                      AND/OR
                                      JmJobStringTC (SIZE(0..63))
        INTEGER:  MULTI-ROW:  The index (prtMarkerColorantIndex) in
        the Printer MIB [print-mib]
        AND/OR
        OCTETS:  MULTI-ROW:  the name of the colorant requested.

        NOTE - The name (JmJobStringTC) values correspond to the
        name values of the prtMarkerColorantValue object in the
        Printer MIB.  Examples are: red, blue.

    colorantConsumed(173),            Integer32 (-2..2147483647)
                                      AND/OR
                                      JmJobStringTC (SIZE(0..63))
        INTEGER:  MULTI-ROW:  The index (prtMarkerColorantIndex) in
        the Printer MIB [print-mib]
        AND/OR
        OCTETS:  MULTI-ROW:  the name of the colorant consumed.

        NOTE - The name (JmJobStringTC) values correspond to the
        name values of the prtMarkerColorantValue object in the
        Printer MIB.  Examples are: red, blue
Top   ToC   RFC2707 - Page 41
    mediumTypeConsumed(174),          Integer32 (-2..2147483647)
                                      AND
                                      JmJobStringTC (SIZE(0..63))
        INTEGER:  MULTI-ROW:  The number of sheets of the indicated
        medium type that has been consumed so far whether those
        sheets have been processed on one side or on both
        AND
        OCTETS:  MULTI-ROW:  the name of that medium type.

        This attribute SHALL have both Integer32 and OCTET STRING
        (represented as JmJobStringTC) values.

        NOTE - The type name (JmJobStringTC) values correspond to
        the type name values of the prtInputMediaType object in the
        Printer MIB [print-mib].  Values are: 'stationery',
        'transparency', 'envelope', etc. These medium type names
        correspond to the enum values of JmMediumTypeTC used in the
        mediumRequested attribute.

    mediumSizeConsumed(175),          Integer32 (-2..2147483647)
                                      AND
                                      JmJobStringTC (SIZE(0..63))
        INTEGER:  MULTI-ROW:  The number of sheets of the indicated
        medium size that has been consumed so far whether those
        sheets have been processed on one side or on both
        AND
        OCTETS:  MULTI-ROW:  the name of that medium size.

        This attribute SHALL have both Integer32 and OCTET STRING
        (represented as JmJobStringTC) values.

        NOTE - The size name (JmJobStringTC) values correspond to
        the size name values in the Printer MIB [print-mib]
        Appendix B.  These size name values are also a subset of
        the keyword values defined by [ipp-model] for the 'media'
        Job Template attribute.  Values are:  'letter', 'a', 'iso-
        a4', 'jis-b4', etc.
Top   ToC   RFC2707 - Page 42
    +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
    + Time attributes (set by server or device) (190 - 209 decimal)
    +
    + This section of attributes are ones that are set by the
    + server or device that accepts jobs.  Two forms of time are
    + provided.  Each form is represented in a separate attribute.
    + See section 3.1.2 and section 3.1.3 for the
    + conformance requirements for time attribute for agents and
    + monitoring applications, respectively.  The two forms are:
    +
    + 'DateAndTime' is an 8 or 11 octet binary encoded year,
    + month, day, hour, minute, second, deci-second with
    + optional offset from UTC.  See SNMPv2-TC [SMIv2-TC].
    +
    + NOTE: 'DateAndTime' is not printable characters; it is
    + binary.
    +
    + 'JmTimeStampTC' is the time of day measured in the number of
    + seconds since the system was booted.
    +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

    jobSubmissionToServerTime(190),   JmTimeStampTC
                                      AND/OR
                                      DateAndTime
        INTEGER:  Configuration 3 only:  The time
        AND/OR
        OCTETS:  the date and time that the job was submitted to
        the server (as distinguished from the device which uses
        jobSubmissionTime).

    jobSubmissionTime(191),           JmTimeStampTC
                                      AND/OR
                                      DateAndTime
        INTEGER:  Configurations 1, 2, and 3:  The time
        AND/OR
        OCTETS:  the date and time that the job was submitted to
        the server or device to which the agent is providing
        access.

    jobStartedBeingHeldTime(192),     JmTimeStampTC
                                      AND/OR
                                      DateAndTime
        INTEGER:  The time
        AND/OR
        OCTETS:  the date and time that the job last entered the
        pendingHeld state.  If the job has never entered the
        pendingHeld state, then the value SHALL be '0' or the
        attribute SHALL not be present in the table.
Top   ToC   RFC2707 - Page 43
    jobStartedProcessingTime(193),    JmTimeStampTC
                                      AND/OR
                                      DateAndTime
        INTEGER:  The time
        AND/OR
        OCTETS:  the date and time that the job started processing.

    jobCompletionTime(194),           JmTimeStampTC
                                      AND/OR
                                      DateAndTime
        INTEGER:  The time
        AND/OR
        OCTETS:  the date and time that the job entered the
        completed, canceled, or aborted state.

    jobProcessingCPUTime(195)         Integer32 (-2..2147483647)
        UNITS     'seconds'
        INTEGER:  The amount of CPU time in seconds that the job
        has been in the processing state.  If the job enters the
        processingStopped state, that elapsed time SHALL not be
        included.  In other words, the jobProcessingCPUTime value
        SHOULD be relatively repeatable when the same job is
        processed again on the same device.

3.3.9 Job State Reason bit definitions

The JmJobStateReasonsNTC (N=1..4) textual-conventions are used with the jmJobStateReasons1 object and jobStateReasonsN (N=2..4), respectively, to provide additional information regarding the current jmJobState object value. These values MAY be used with any job state or states for which the reason makes sense. NOTE - While values cannot be added to the jmJobState object without impacting deployed clients that take actions upon receiving jmJobState values, it is the intent that additional JmJobStateReasonsNTC enums can be defined and registered without impacting such deployed clients. In other words, the jmJobStateReasons1 object and jobStateReasonsN attributes are intended to be extensible. NOTE - The Job Monitoring MIB contains a superset of the IPP values [ipp-model] for the IPP 'job-state-reasons' attribute, since the Job Monitoring MIB is intended to cover other job submission protocols as well. Also some of the names of the reasons have been changed from ' printer' to 'device', since the Job Monitoring MIB is intended to cover additional types of devices, including input devices, such as scanners.
Top   ToC   RFC2707 - Page 44
3.3.9.1 JmJobStateReasons1TC specification
The following standard values are defined (in hexadecimal) as powers of two, since multiple values MAY be used at the same time. For ease of understanding, the JmJobStateReasons1TC reasons are presented in the order in which the reasons are likely to occur (if implemented), starting with the 'jobIncoming' value and ending with the ' jobCompletedWithErrors' value. other 0x1 The job state reason is not one of the standardized or registered reasons. unknown 0x2 The job state reason is not known to the agent or is indeterminent. jobIncoming 0x4 The job has been accepted by the server or device, but the server or device is expecting (1) additional operations from the client to finish creating the job and/or (2) is accessing/accepting document data. submissionInterrupted 0x8 The job was not completely submitted for some unforeseen reason, such as: (1) the server has crashed before the job was closed by the client, (2) the server or the document transfer method has crashed in some non-recoverable way before the document data was entirely transferred to the server, (3) the client crashed or failed to close the job before the time-out period. jobOutgoing 0x10 Configuration 2 only: The server is transmitting the job to the device. jobHoldSpecified 0x20 The value of the job's jobHold(52) attribute is TRUE. The job SHALL NOT be a candidate for processing until this reason is removed and there are no other reasons to hold the job. jobHoldUntilSpecified 0x40 The value of the job's jobHoldUntil(53) attribute specifies a time period that is still in the future. The job SHALL NOT be a candidate for processing until this reason is removed and there are no other reasons to hold the job.
Top   ToC   RFC2707 - Page 45
    jobProcessAfterSpecified          0x80
        The value of the job's jobProcessAfterDateAndTime(51) attribute
        specifies a time that is still in the future.  The job SHALL NOT
        be a candidate for processing until this reason is removed and
        there are no other reasons to hold the job.

    resourcesAreNotReady              0x100
        At least one of the resources needed by the job, such as media,
        fonts, resource objects, etc., is not ready on any of the
        physical devices for which the job is a candidate.  This
        condition MAY be detected when the job is accepted, or
        subsequently while the job is pending or processing, depending
        on implementation.

    deviceStoppedPartly               0x200
        One or more, but not all, of the devices to which the job is
        assigned are stopped.  If all of the devices are stopped (or the
        only device is stopped), the deviceStopped reason SHALL be used.

    deviceStopped                     0x400
        The device(s) to which the job is assigned is (are all) stopped.

    jobInterpreting                   0x800
        The device to which the job is assigned is interpreting the
        document data.

    jobPrinting                       0x1000
        The output device to which the job is assigned is marking media.
        This value is useful for servers and output devices which spend
        a great deal of time processing (1) when no marking is happening
        and then want to show that marking is now happening or (2) when
        the job is in the process of being canceled or aborted while the
        job remains in the processing state, but the marking has not yet
        stopped so that impression or sheet counts are still increasing
        for the job.

    jobCanceledByUser                 0x2000
        The job was canceled by the owner of the job, i.e., by a user
        whose name is the same as the value of the job's jmJobOwner
        object, or by some other authorized end-user, such as a member
        of the job owner's security group.

    jobCanceledByOperator             0x4000
        The job was canceled by the operator, i.e., by a user who has
        been authenticated as having operator privileges (whether local
        or remote).
Top   ToC   RFC2707 - Page 46
    jobCanceledAtDevice               0x8000
        The job was canceled by an unidentified local user, i.e., a user
        at a console at the device.

    abortedBySystem                   0x10000
        The job (1) is in the process of being aborted, (2) has been
        aborted by the system and placed in the 'aborted' state, or (3)
        has been aborted by the system and placed in the 'pendingHeld'
        state, so that a user or operator can manually try the job
        again.

    processingToStopPoint             0x20000
        The requester has issued an operation to cancel or interrupt the
        job or the server/device has aborted the job, but the
        server/device is still performing some actions on the job until
        a specified stop point occurs or job termination/cleanup is
        completed.

        This reason is recommended to be used in conjunction with the
        processing job state to indicate that the server/device is still
        performing some actions on the job while the job remains in the
        processing state.  After all the job's resources consumed
        counters  have stopped incrementing, the server/device moves the
        job from the processing state to the canceled or aborted job
        states.

    serviceOffLine                    0x40000
        The service or document transform is off-line and accepting no
        jobs.  All pending jobs are put into the pendingHeld state.
        This situation could be true if the service's or document
        transform's input is impaired or broken.

    jobCompletedSuccessfully          0x80000
        The job completed successfully.

    jobCompletedWithWarnings          0x100000
        The job completed with warnings.

    jobCompletedWithErrors            0x200000
        The job completed with errors (and possibly warnings too).


   The following additional job state reasons have been added to
   represent job states that are in ISO DPA [iso-dpa] and other job
   submission protocols:
Top   ToC   RFC2707 - Page 47
    jobPaused                         0x400000
        The job has been indefinitely suspended by a client issuing an
        operation to suspend the job so that other jobs may proceed
        using the same devices.  The client MAY issue an operation to
        resume the paused job at any time, in which case the agent SHALL
        remove the jobPaused values from the job's jmJobStateReasons1
        object and the job is eventually resumed at or near the point
        where the job was paused.

    jobInterrupted                    0x800000 The job has been
        interrupted while processing by a client
        issuing an operation that specifies another job to be run
        instead of the current job.  The server or device will
        automatically resume the interrupted job when the interrupting
        job completes.

    jobRetained                       0x1000000
        The job is being retained by the server or device with all of
        the job's document data (and submitted resources, such as fonts,
        logos, and forms, if any).  Thus a client could issue an
        operation to the server or device to either (1) re-do the job
        (or a copy of the job) on the same server or device or (2)
        resubmit the job to another server or device.  When a client
        could no longer re-do/resubmit the job, such as after the
        document data has been discarded, the agent SHALL remove the
        jobRetained value from the jmJobStateReasons1 object.

        These bit definitions are the equivalent of a type 2 enum except
        that combinations of bits may be used together.  See section
        3.7.1.2.  The remaining bits are reserved for future
        standardization and/or registration.

3.3.9.2 JmJobStateReasons2TC specification
The following standard values are defined (in hexadecimal) as powers of two, since multiple values MAY be used at the same time. cascaded 0x1 An outbound gateway has transmitted all of the job's job and document attributes and data to another spooling system. deletedByAdministrator 0x2 The administrator has deleted the job. discardTimeArrived 0x4 The job has been deleted due to the fact that the time specified by the job's job-discard-time attribute has arrived.
Top   ToC   RFC2707 - Page 48
    postProcessingFailed              0x8
        The post-processing agent failed while trying to log accounting
        attributes for the job; therefore the job has been placed into
        the completed state with the jobRetained jmJobStateReasons1
        object value for a system-defined period of time, so the
        administrator can examine it, resubmit it, etc.

    jobTransforming                   0x10
        The server/device is interpreting document data and producing
        another electronic representation.

    maxJobFaultCountExceeded          0x20
        The job has faulted several times and has exceeded the
        administratively defined fault count limit.

    devicesNeedAttentionTimeOut       0x40
        One or more document transforms that the job is using needs
        human intervention in order for the job to make progress, but
        the human intervention did not occur within the site-settable
        time-out value.

    needsKeyOperatorTimeOut           0x80
        One or more devices or document transforms that the job is using
        need a specially trained operator (who may need a key to unlock
        the device and gain access) in order for the job to make
        progress, but the key operator intervention did not occur within
        the site-settable time-out value.

    jobStartWaitTimeOut               0x100
        The server/device has stopped the job at the beginning of
        processing to await human action, such as installing a special
        cartridge or special non-standard media, but the job was not
        resumed within the site-settable time-out value and the
        server/device has transitioned the job to the pendingHeld state.

    jobEndWaitTimeOut                 0x200
        The server/device has stopped the job at the end of processing
        to await human action, such as removing a special cartridge or
        restoring standard media, but the job was not resumed within the
        site-settable time-out value and the server/device has
        transitioned the job to the completed state.

    jobPasswordWaitTimeOut            0x400
        The server/device has stopped the job at the beginning of
        processing to await input of the job's password, but the
        password was not received within the site-settable time-out
        value.
Top   ToC   RFC2707 - Page 49
    deviceTimedOut                    0x800
        A device that the job was using has not responded in a period
        specified by the device's site-settable attribute.

    connectingToDeviceTimeOut         0x1000
        The server is attempting to connect to one or more devices which
        may be dial-up, polled, or queued, and so may be busy with
        traffic from other systems, but server was unable to connect to
        the device within the site-settable time-out value.

    transferring                      0x2000
        The job is being transferred to a down stream server or
        downstream device.

    queuedInDevice                    0x4000
        The server/device has queued the job in a down stream server or
        downstream device.

    jobQueued                         0x8000
        The server/device has queued the document data.

    jobCleanup                        0x10000
        The server/device is performing cleanup activity as part of
        ending normal processing.

    jobPasswordWait                   0x20000
        The server/device has selected the job to be next to process,
        but instead of assigning resources and starting the job
        processing, the server/device has transitioned the job to the
        pendingHeld state to await entry of a password (and dispatched
        another job, if there is one).

    validating                        0x40000
        The server/device is validating the job after accepting the job.

    queueHeld                         0x80000
        The operator has held the entire job set or queue.

    jobProofWait                      0x100000
        The job has produced a single proof copy and is in the
        pendingHeld state waiting for the requester to issue an
        operation to release the job to print normally, obeying any job
        and document copy attributes that were originally submitted.

    heldForDiagnostics                0x200000
        The system is running intrusive diagnostics, so that all jobs
        are being held.
Top   ToC   RFC2707 - Page 50
    noSpaceOnServer                   0x800000
        There is no room on the server to store all of the job.

    pinRequired                       0x1000000
        The System Administrator settable device policy is (1) to
        require PINs, and (2) to hold jobs that do not have a pin
        supplied as an input parameter when the job was created.

    exceededAccountLimit              0x2000000
        The account for which this job is drawn has exceeded its limit.
        This condition SHOULD be detected before the job is scheduled so
        that the user does not wait until his/her job is scheduled only
        to find that the account is overdrawn.  This condition MAY also
        occur while the job is processing either as processing begins or
        part way through processing.

    heldForRetry                      0x4000000
        The job encountered some errors that the server/device could not
        recover from with its normal retry procedures, but the error
        might not be encountered if the job is processed again in the
        future.  Example cases are phone number busy or remote file
        system in-accessible.  For such a situation, the server/device
        SHALL transition the job from the processing to the pendingHeld,
        rather than to the aborted state.

    The following values are from the X/Open PSIS draft standard:

    canceledByShutdown                0x8000000
        The job was canceled because the server or device was shutdown
        before completing the job.

    deviceUnavailable                 0x10000000
        This job was aborted by the system because the device is
        currently unable to accept jobs.

    wrongDevice                       0x20000000
        This job was aborted by the system because the device is unable
        to handle this particular job; the spooler SHOULD try another
        device or the user should submit the job to another device.

    badJob                            0x40000000
        This job was aborted by the system because this job has a major
        problem, such as an ill-formed PDL; the spooler SHOULD not even
        try another device.

   These bit definitions are the equivalent of a type 2 enum except that
   combinations of them may be used together.  See section 3.7.1.2.
Top   ToC   RFC2707 - Page 51
3.3.9.3 JmJobStateReasons3TC specification
This textual-convention is used with the jobStateReasons3 attribute to provides additional information regarding the jmJobState object. The following standard values are defined (in hexadecimal) as powers of two, since multiple values may be used at the same time: jobInterruptedByDeviceFailure 0x1 A device or the print system software that the job was using has failed while the job was processing. The server or device is keeping the job in the pendingHeld state until an operator can determine what to do with the job. These bit definitions are the equivalent of a type 2 enum except that combinations of them may be used together. See section 3.7.1.2. The remaining bits are reserved for future standardization and/or registration.
3.3.9.4 JmJobStateReasons4TC specification
This textual-convention is used with the jobStateReasons4 attribute to provides additional information regarding the jmJobState object. The following standard values are defined (in hexadecimal) as powers of two, since multiple values MAY be used at the same time. None defined at this time. These bit definitions are the equivalent of a type 2 enum except that combinations of them may be used together. See section 3.7.1.2. The remaining bits are reserved for future standardization and/or registration.


(page 51 continued on part 3)

Next Section