Class JobStateReason is a printing attribute class, an enumeration,
that provides additional information about the job's current state, i.e.,
information that augments the value of the job's JobState
attribute. Class JobStateReason defines standard job state reason
values. A Print Service implementation only needs to report those job state
reasons which are appropriate for the particular implementation; it does not
have to report every defined job state reason.
Instances of JobStateReason do not appear in a Print Job's attribute
set directly. Rather, a JobStateReasons attribute
appears in the Print Job's attribute set. The
JobStateReasons attribute contains zero, one, or more
than one JobStateReason objects which pertain to the Print Job's
status. The printer adds a JobStateReason object to the Print Job's
JobStateReasons attribute when the corresponding
condition becomes true of the Print Job, and the printer removes the
JobStateReason object again when the corresponding condition becomes
false, regardless of whether the Print Job's overall
JobState also changed.
IPP Compatibility: The category name returned by getName() is
the IPP attribute name. The enumeration's integer value is the IPP enum
value. The toString() method returns the IPP string representation of
the attribute value.
extends