XEROX-JOB-MONITORING-MIB

        
File:     41jobmon.dfm, .mib, .txt, .pdf
Version:  4.03.pub
        
This MIB specifies job and document objects for
monitoring print jobs, including accounting, of print
jobs.  This MIB does not provide for management and
control of print jobs, such as cancelling or modifying
them.  If job control is desired, another MIB that
augments this one should be developed.
        
The groups in this MIB are arranged so that an
additional MIB may be developed that supports monitoring
of multifunction jobs (print, scan, FAX, etc.),
including scan-only jobs.  Such a MIB is intended to
augment this MIB.  See the companion Job Monitoring MIB
textual conventions module: XEROX-JOB-MONITORING-TC for
the textual conventions and for an explanation of the
use of this MIB (see file 40jobtc.txt).
        
The specification for many of the objects in this MIB is
taken directly from the ISO 10175 Document Printing
Application (DPA) standard, clause 9.2, Job Attributes
and clause 9.3, Document Attributes.  Such direct
inclusions are explicitly indicated.  However, this MIB
is intended to be used with non-DPA implementations, so
only a small set of general DPA attributes have been
included in the Job Monitoring MIB.  In addition, a
single print-centric group is included.  Finally, some
of the ISO DPA specifications have been generalized so
that they may be used with non-print job services.  For
example, changing the names and descriptions from
'printer' to 'device'.  All such changes to ISO DPA text
        
        
are indicated inside square brackets to make it clear
how this Job Monitoring MIB differs from ISO DPA.
        
Copyright 1996-2002 Xerox Corporation. All Rights Reserved.
REFERENCES
See 40jobtc.txt for the conformance requirements and
textual conventions for use with this MIB module.
    

Imported Objects

InternationalDisplayString, ProductID, hrDeviceIndexHOST-RESOURCES-MIB
OBJECT-GROUP, MODULE-COMPLIANCESNMPv2-CONF
OBJECT-TYPE, MODULE-IDENTITY, Integer32, Counter32, OBJECT-IDENTITY, NOTIFICATION-TYPESNMPv2-SMI
RowStatus, DisplayString, DateAndTimeSNMPv2-TC
xeroxCommonMIBXEROX-COMMON-MIB
Cardinal16, zeroDotZero, Cardinal64Low, Cardinal64High, Cardinal32, Ordinal32, Ordinal16, CodeIndexedStringIndexXEROX-GENERAL-TC
XcmHrDevInfoXStatus, XcmHrDevTrafficUnitXEROX-HOST-RESOURCES-EXT-TC
XcmJMDocOutputMethod, XcmJMDocState, XcmJMDocType, XcmJMDocFileNameType, XcmJMMediumType, XcmJMImpsCountType, XcmJMGroupSupport, XcmJMJobServiceTypeOID, XcmJMJobX2StateReasons, XcmJMJobXStateReasons, XcmJMJobStateReasons, XcmJMJobStateXEROX-JOB-MONITORING-TC
XcmPrtInterpreterLangFamily, XcmPrtPrintQuality, XcmPrtMediumSize, XcmPrtChannelTypeXEROX-PRINTER-EXT-TC

Objects

xcmJobZeroDummy .0.0.59
xcmJobMonMIB .1.3.6.1.4.1.253.8.59
xcmJobMonBase .1.3.6.1.4.1.253.8.59.1
xcmJobMonBaseTable .1.3.6.1.4.1.253.8.59.1.2
xcmJobMonBaseEntry .1.3.6.1.4.1.253.8.59.1.2.1
xcmJobMonBaseIndex .1.3.6.1.4.1.253.8.59.1.2.1.1
xcmJobMonBaseRowStatus
.1.3.6.1.4.1.253.8.59.1.2.1.2
xcmJobMonBaseVersionID .1.3.6.1.4.1.253.8.59.1.2.1.3
xcmJobMonBaseVersionDate
.1.3.6.1.4.1.253.8.59.1.2.1.4
xcmJobMonBaseGroupSupport
.1.3.6.1.4.1.253.8.59.1.2.1.5
xcmJobMonBaseCreateSupport
.1.3.6.1.4.1.253.8.59.1.2.1.6
xcmJobMonBaseUpdateSupport
.1.3.6.1.4.1.253.8.59.1.2.1.7
xcmJobGenExt .1.3.6.1.4.1.253.8.59.10
xcmJobGenExtTable .1.3.6.1.4.1.253.8.59.10.1
xcmJobGenExtEntry .1.3.6.1.4.1.253.8.59.10.1.1
xcmJobOriginator
.1.3.6.1.4.1.253.8.59.10.1.1.1
xcmJobSubmissionTime
.1.3.6.1.4.1.253.8.59.10.1.1.10
xcmJobPagesCompleted
.1.3.6.1.4.1.253.8.59.10.1.1.11
xcmJobOctetsCompletedHigh
.1.3.6.1.4.1.253.8.59.10.1.1.12
xcmJobOctetsCompletedLow
.1.3.6.1.4.1.253.8.59.10.1.1.13
xcmJobErrorCount
.1.3.6.1.4.1.253.8.59.10.1.1.14
xcmJobWarningCount
.1.3.6.1.4.1.253.8.59.10.1.1.15
xcmJobProcessingTime
.1.3.6.1.4.1.253.8.59.10.1.1.16
xcmJobNumberOfDocuments .1.3.6.1.4.1.253.8.59.10.1.1.17
xcmJobAuthorizationUserName
.1.3.6.1.4.1.253.8.59.10.1.1.18
xcmJobSubmittingApplication
.1.3.6.1.4.1.253.8.59.10.1.1.2
xcmJobComment
.1.3.6.1.4.1.253.8.59.10.1.1.3
xcmJobCopies .1.3.6.1.4.1.253.8.59.10.1.1.4
xcmJobCopiesCompleted
.1.3.6.1.4.1.253.8.59.10.1.1.5
xcmJobOutputBinIndex .1.3.6.1.4.1.253.8.59.10.1.1.6
xcmJobServiceNameRequested
.1.3.6.1.4.1.253.8.59.10.1.1.7
xcmJobPreviousState .1.3.6.1.4.1.253.8.59.10.1.1.8
xcmJobEstimatedCompletionTime
.1.3.6.1.4.1.253.8.59.10.1.1.9
xcmDocGenBasic .1.3.6.1.4.1.253.8.59.12
xcmDocGenBasicTable .1.3.6.1.4.1.253.8.59.12.1
xcmDocGenBasicEntry
.1.3.6.1.4.1.253.8.59.12.1.1
xcmDocSequenceNumber .1.3.6.1.4.1.253.8.59.12.1.1.1
xcmDocState .1.3.6.1.4.1.253.8.59.12.1.1.10
xcmDocName
.1.3.6.1.4.1.253.8.59.12.1.1.2
xcmDocFileName
.1.3.6.1.4.1.253.8.59.12.1.1.3
xcmDocFileNameType
.1.3.6.1.4.1.253.8.59.12.1.1.4
xcmDocType .1.3.6.1.4.1.253.8.59.12.1.1.5
xcmDocFormat
.1.3.6.1.4.1.253.8.59.12.1.1.6
xcmDocFormatVariants
.1.3.6.1.4.1.253.8.59.12.1.1.7
xcmDocFormatVersion
.1.3.6.1.4.1.253.8.59.12.1.1.8
xcmDocOctetCount .1.3.6.1.4.1.253.8.59.12.1.1.9
xcmDocPrintExt .1.3.6.1.4.1.253.8.59.13
xcmDocPrintExtTable .1.3.6.1.4.1.253.8.59.13.1
xcmDocPrintExtEntry
.1.3.6.1.4.1.253.8.59.13.1.1
xcmDocPrintDefaultMediumName .1.3.6.1.4.1.253.8.59.13.1.1.1
xcmDocPrintDefaultInputIndex .1.3.6.1.4.1.253.8.59.13.1.1.2
xcmDocPrintFinishing .1.3.6.1.4.1.253.8.59.13.1.1.3
xcmDocPrintOutputMethod
.1.3.6.1.4.1.253.8.59.13.1.1.4
xcmDocPrintNumberUp .1.3.6.1.4.1.253.8.59.13.1.1.5
xcmDocPrintSides .1.3.6.1.4.1.253.8.59.13.1.1.6
xcmDocPrintCopyCount .1.3.6.1.4.1.253.8.59.13.1.1.7
xcmDocPrintCopiesCompleted
.1.3.6.1.4.1.253.8.59.13.1.1.8
xcmJobGenSpoolingBasic .1.3.6.1.4.1.253.8.59.14
xcmJobGenSpoolingBasicTable .1.3.6.1.4.1.253.8.59.14.1
xcmJobGenSpoolingBasicEntry .1.3.6.1.4.1.253.8.59.14.1.1
xcmJobNumberOfJobResultSets .1.3.6.1.4.1.253.8.59.14.1.1.1
xcmJobPriority .1.3.6.1.4.1.253.8.59.14.1.1.2
xcmJobTotalOctetsHigh
.1.3.6.1.4.1.253.8.59.14.1.1.3
xcmJobTotalOctetsLow
.1.3.6.1.4.1.253.8.59.14.1.1.4
xcmJobInterveningJobs .1.3.6.1.4.1.253.8.59.14.1.1.5
xcmJobGenSpoolingExt .1.3.6.1.4.1.253.8.59.15
xcmJobGenSpoolingExtTable .1.3.6.1.4.1.253.8.59.15.1
xcmJobGenSpoolingExtEntry .1.3.6.1.4.1.253.8.59.15.1.1
xcmJobProcessAfter
.1.3.6.1.4.1.253.8.59.15.1.1.1
xcmJobDeadlineTime
.1.3.6.1.4.1.253.8.59.15.1.1.3
xcmJobDiscardTime
.1.3.6.1.4.1.253.8.59.15.1.1.4
xcmJobRetentionPeriod .1.3.6.1.4.1.253.8.59.15.1.1.5
xcmJobMessageToOperator
.1.3.6.1.4.1.253.8.59.15.1.1.6
xcmJobMessageFromOperator
.1.3.6.1.4.1.253.8.59.15.1.1.7
xcmJobMessageFromAdministrator
.1.3.6.1.4.1.253.8.59.15.1.1.8
xcmJobPageCount .1.3.6.1.4.1.253.8.59.15.1.1.9
xcmJobGenAccountingBasic .1.3.6.1.4.1.253.8.59.16
xcmJobGenAccountingBasicTable .1.3.6.1.4.1.253.8.59.16.1
xcmJobGenAccountingBasicEntry .1.3.6.1.4.1.253.8.59.16.1.1
xcmJobAccountingBasicRowStatus
.1.3.6.1.4.1.253.8.59.16.1.1.1
xcmJobAccountingUserName
.1.3.6.1.4.1.253.8.59.16.1.1.2
xcmJobAccountingInformation .1.3.6.1.4.1.253.8.59.16.1.1.3
xcmJobStartedProcessingTime
.1.3.6.1.4.1.253.8.59.16.1.1.4
xcmJobImpressionsCompleted
.1.3.6.1.4.1.253.8.59.16.1.1.5
xcmJobMediaSheetsCompleted
.1.3.6.1.4.1.253.8.59.16.1.1.6
xcmJobCompletionTime
.1.3.6.1.4.1.253.8.59.16.1.1.7
xcmJobWorkUnitType
.1.3.6.1.4.1.253.8.59.16.1.1.8
xcmJobUnitsOfWorkCompleted
.1.3.6.1.4.1.253.8.59.16.1.1.9
xcmMediaConsumed .1.3.6.1.4.1.253.8.59.17
xcmMediaConsumedTable .1.3.6.1.4.1.253.8.59.17.1
xcmMediaConsumedEntry
.1.3.6.1.4.1.253.8.59.17.1.1
xcmMediaConsumedIndex .1.3.6.1.4.1.253.8.59.17.1.1.1
xcmMediaConsumedRowStatus
.1.3.6.1.4.1.253.8.59.17.1.1.2
xcmMediaConsumedType .1.3.6.1.4.1.253.8.59.17.1.1.3
xcmMediaConsumedName
.1.3.6.1.4.1.253.8.59.17.1.1.4
xcmMediaConsumedSheetCount
.1.3.6.1.4.1.253.8.59.17.1.1.5
xcmColorImpsConsumed .1.3.6.1.4.1.253.8.59.18
xcmColorImpsConsumedTable .1.3.6.1.4.1.253.8.59.18.1
xcmColorImpsConsumedEntry
.1.3.6.1.4.1.253.8.59.18.1.1
xcmColorImpsConsumedIndex .1.3.6.1.4.1.253.8.59.18.1.1.1
xcmColorImpsConsumedRowStatus
.1.3.6.1.4.1.253.8.59.18.1.1.2
xcmColorImpsConsumedTypeIndex .1.3.6.1.4.1.253.8.59.18.1.1.3
xcmColorImpsConsumedCount
.1.3.6.1.4.1.253.8.59.18.1.1.4
xcmJobAlert .1.3.6.1.4.1.253.8.59.19
xcmJobV1AlertNew .1.3.6.1.4.1.253.8.59.19.4
xcmJobV2AlertPrefixNew .1.3.6.1.4.1.253.8.59.19.4.0
xcmJobMonMIBConformance .1.3.6.1.4.1.253.8.59.2
xcmJobMonMIBGroups .1.3.6.1.4.1.253.8.59.2.3
xcmDocAlert .1.3.6.1.4.1.253.8.59.20
xcmDocV1AlertNew .1.3.6.1.4.1.253.8.59.20.4
xcmDocV2AlertPrefixNew .1.3.6.1.4.1.253.8.59.20.4.0
xcmJobImpsByMediumSize .1.3.6.1.4.1.253.8.59.21
xcmJobImpsByMediumSizeTable .1.3.6.1.4.1.253.8.59.21.1
xcmJobImpsByMediumSizeEntry
.1.3.6.1.4.1.253.8.59.21.1.1
xcmJobImpsByMediumSizeIndex .1.3.6.1.4.1.253.8.59.21.1.1.1
xcmJobImpsByMediumSizeRowStatus
.1.3.6.1.4.1.253.8.59.21.1.1.2
xcmJobImpsByMediumSizeMediumSize
.1.3.6.1.4.1.253.8.59.21.1.1.3
xcmJobImpsByMediumSizeCountType
.1.3.6.1.4.1.253.8.59.21.1.1.4
xcmJobImpsByMediumSizeCount
.1.3.6.1.4.1.253.8.59.21.1.1.5
xcmJobImpsByMediumSizeCountQuality
.1.3.6.1.4.1.253.8.59.21.1.1.6
xcmJobGenBasic .1.3.6.1.4.1.253.8.59.6
xcmJobGenBasicTable .1.3.6.1.4.1.253.8.59.6.1
xcmJobGenBasicEntry
.1.3.6.1.4.1.253.8.59.6.1.1
xcmJobIdentifierOnSystem .1.3.6.1.4.1.253.8.59.6.1.1.1
xcmJobStateReasons
.1.3.6.1.4.1.253.8.59.6.1.1.10
xcmJobXStateReasons
.1.3.6.1.4.1.253.8.59.6.1.1.11
xcmJobX2StateReasons
.1.3.6.1.4.1.253.8.59.6.1.1.12
xcmJobIdentifierUpstream .1.3.6.1.4.1.253.8.59.6.1.1.2
xcmJobClientId .1.3.6.1.4.1.253.8.59.6.1.1.3
xcmJobServiceType
.1.3.6.1.4.1.253.8.59.6.1.1.4
xcmJobName
.1.3.6.1.4.1.253.8.59.6.1.1.5
xcmJobOwner
.1.3.6.1.4.1.253.8.59.6.1.1.6
xcmJobSourceChannelType
.1.3.6.1.4.1.253.8.59.6.1.1.7
xcmJobSubmittedLocaleIndex .1.3.6.1.4.1.253.8.59.6.1.1.8
xcmJobCurrentState .1.3.6.1.4.1.253.8.59.6.1.1.9
xcmDevicesAssigned .1.3.6.1.4.1.253.8.59.7
xcmDevicesAssignedTable .1.3.6.1.4.1.253.8.59.7.1
xcmDevicesAssignedEntry
.1.3.6.1.4.1.253.8.59.7.1.1
xcmDevicesAssignedHrDeviceIndex .1.3.6.1.4.1.253.8.59.7.1.1.1
xcmDeviceStateOfDevicesAssigned
.1.3.6.1.4.1.253.8.59.7.1.1.2
xcmJobIdentifierDownstream .1.3.6.1.4.1.253.8.59.7.1.1.3
xcmClientIdMap .1.3.6.1.4.1.253.8.59.8
xcmClientIdMapTable .1.3.6.1.4.1.253.8.59.8.1
xcmClientIdMapEntry .1.3.6.1.4.1.253.8.59.8.1.1
xcmClientIdMapHrDeviceIndex .1.3.6.1.4.1.253.8.59.8.1.1.2

Notifications/Traps

NameOIDDescription
xcmJobV2AlertNew


.1.3.6.1.4.1.253.8.59.19.4.0.1
This trap is sent whenever the state of a job changes.  The
'state of a job' is comprised by the aggregate values of the
xcmJobCurrentState, xcmJobPriority, xcmJobStateReasons,
xcmJobXStateReasons, xcmJobX2StateReasons,
xcmDevicesAssigned and xcmDeviceStateOfDevicesAssigned
fields of the job's table entries:  This notification is
sent whenever any of these values changes with the following
exceptions:
          
1. Changes in xcmDeviceStateOfDevicesAssigned shall only
generate traps when the job is in the processing state
(NOTE - xcmJMDevicesAssignedGroup is deprecated)
          
2. Changes in xcmJobStateReasons, xcmJobXStateReasons, and
xcmJobX2StateReasons shall only generate traps when the job is
in the processing state (rare).  The normal polling cycle will
pick up any changes while the job is not in the processing
state.  Since most changes in reasons also accompany a job state
change, the chances that a change in a reason will have to wait
for the normal polling cycle is very small.  For example, a
requester further modifies a held job adding more reasons for it
to be held will have to wait for the polling cycle, since the
job does not change state (remaining in the held state).
          
          
NOTE - the hrDeviceIndex is included for convenience, even
though the Printer MIB (RFC 1759) doesn't include hrDeviceIndex
in its traps.  Then the management station doesn't have to parse
the received varBind OIDs on a trap in order to discover which
device trapped.
          
NOTE - the addition of an entire row to the job tables
corresponds to the acceptance of another job by the server.  The
state of the job changes from unknown to a specific value
(usually pending).  Therefore, the agent shall generate a trap
when a job is accepted (so that the management station can
display the newly arrived job in a timely fashion).
          
Similarly when the server removes a job because the job has been
in the completed state for a sufficient time or the job has been
deleted by a Delete operation, the SNMP agent shall reflect
that removal by removing the row from the job tables, and shall
generate a trap (since the state of the job has changed to
non-existent).
          
The IETF Printer MIB maintains a table which serves as a sort
of 'audit-trail' of recent alerts.  There is no need for such
a table here, since the job's tables will serve virtually the
same purpose.
          
As with all SNMP notifications, critical applications cannot
completely rely upon delivery:  some amount of polling is
recommended.
          
The variable-bindings of this trap have been chosen to give the
minimum of information:  the xcmJobIdentifierOnSystem
value and hrDeviceIndex are provided.  With these an application
is able to obtain the full job table entry.  An application has
to look at the job tables anyway.  The time of the alert is
returned as part of any SNMP trap.
          
The hrDeviceIndex maps one-to-one with the PWG Job Mon
jmGeneralJobSetIndex.  (The PWG Job Mon does not require the
Host Resources MIB, so the name of the primary index for all PWG
Job Mon tables is not hrDeviceIndex, but serves the same
purpose of allowing multiple instances in a single device or
server.
          
The Job Alert's special semantics is covered by U.S. patent
5778183.
This notification has the following special semantics:
          
    o  If the job's xcmJobClientId field is not empty,
       its value will also be appended to trap object ID.
          
       NOTE: If the format of the xcmJobClientId is dotted
       decimal representation, then it will be encoded as a BER
       binary OID appended to the trap object ID.
          
          
       NOTE: The BER binary OID shall not include the ASN.1/BER
       tag of 6 indicating an OID and shall not include the
       ASN.1/BER length field in octets of the OID.
          
This trap OID qualifier allows job-submission and monitoring
applications to limit the alerts they receive to ones generated
by jobs which they have submitted.
          
NOTE: The sum of the trap var bind values must be less than can
fit into a PDU on any transport, roughly 540 octets on some
transports.  Thus implementers are warned to minimize the length
of the xcmJobClientId and xcmJobIdentifierOnSystem objects.
xcmDocV2AlertNew



.1.3.6.1.4.1.253.8.59.20.4.0.1
This trap is sent whenever the state of one of the documents in
a job changes.  The state of a single document is represented in
the xcmDocGenBasicTable column: xcmDocState.
          
The job's xcmJobIdentifierOnSystem and the document's
xcmDocSequenceNumber are included in the trap's variable
bindings; these can be used to reference the document's
xcmDocGenBasicTable entry.
          
NOTE - the addition of an entire row to the document tables
corresponds to the acceptance of another document (in a job) by
the server.  The state of the document changes from unknown to a
specific value (usually transfer pending).  Therefore, the agent
generates a trap when a document (within a job) is accepted (so
that the management station can display the newly arrived
document in a timely fashion).
          
This notification has the following special semantics:
          
    1  The agent shall append the document's job's
       xcmJobClientId to the trap object ID, if the document's
       job's xcmJobClientId field is not empty.
       NOTE: If the format of the xcmJobClientId is dotted
          
          
       decimal representation, then it will be encoded as a BER
       binary OID appended to the trap object ID.
          
       NOTE: The BER binary OID shall not include the ASN.1/BER
       tag of 6 indicating an OID and shall not include the
       ASN.1/BER length field in octets of the OID.
          
    2  The agent shall append the value of the document's
       xcmDocSequenceNumber field to the trap object ID.
          
These trap OID qualifiers allow job-submission and monitoring
applications to specify exactly which alerts they are interested
in and to limit the alerts they receive to ones generated by
jobs or jobs and documents that they have submitted.
          
NOTE: The sum of the trap var bind values must be less than can
fit into a PDU on any transport, roughly 540 octets on some
transports.  Thus implementers are warned to minimize the length
of the xcmJobClientId and xcmJobIdentifierOnSystem objects.