job-state-reasons (Job Only)
Identifies the reasons that a job is in the held, terminating, or retained state. If this attribute value is blank, the job is not in one of these states.
GUI label
Reasons
DSS
All
Type
Non-settable, multi-valued
Input Synonyms
You can use the synonym state-reasons or reasons.
Allowed Values
InfoPrint sets this value to any of these fixed values:
Fixed Value | Explanation |
---|---|
aborted-by-system | The server aborted the job. |
cancelled-by-operator | An operator or system administrator cancelled the job. |
cancelled-by-user | The person who submitted the job cancelled the job. |
completed | The job completed without any errors or warnings that InfoPrint could detect. This does not guarantee that there were no errors of any kind. |
completed-successfully | The job completed without any errors or warnings. |
completed-with-errors | The job completed with errors. Based on the dss-job-message-disposition actual destination attribute, the messages associated with the errors either print at the end of the job or in a message log. See dss-job-message-disposition. |
deadline-in-jeopardy | The value of the estimated-completion-time attribute for the job is later than the time specified by the job-deadline-time attribute; or the time specified by the job-deadline-time attribute is past. |
job-hold-set | The job is in a queue and the job-hold job attribute of the job has a true value. |
job-print-after-specified | The job is in a queue and the time specified by the job-print-after job attribute has not yet occurred. |
pull-print | The job is in a queue destined for an actual destination with pull-print-printer set to true or in an Anyplace queue and the time period specified by the pull-print-job-timeout server attribute has not yet past. |
required-resource-not-ready | The job is in a queue but InfoPrint cannot schedule it because one or more of the resources required by the job (such as media, fonts, and so on) are not ready on any of the actual destinations that can accept the job. The job's required-resource-not-ready attribute identifies the resources that need to be made ready. |
required-resource-not-supported | The job is in a queue but InfoPrint cannot schedule it because none of the actual destinations that can accept the job support one or more of the resources required by the job (such as media, fonts, and so on). The job's required-resource-not-supported attribute identifies the resources that are not supported. |
retained-immediately | The job is not put on a queue or scheduled when it is received by the InfoPrint server. The job is immediately processed according to the values of its retention period attributes. |
rip-and-hold-completed | The RIP has successfully converted the job. The job has not been scheduled because the value of the job-rip-action attribute is rip-and-hold or is rip-and-hold-ignore-ready. |
rip-completed | A job with job-rip-action=rip-and-print-ignore-ready has been RIPped, but InfoPrint cannot schedule it because one or more of the resources required by the job are not ready on any of the actual destinations that can accept the job. Jobs held for this reason are released automatically when the required resources become ready. |
rip-failed | The RIP failed to convert the job.
Note: You will see this reason only if the job is retained or if the value of the requeue-failed-jobs queue attribute is true. When neither of these conditions is true, jobs that fail to rip are discarded.
|
Default Value
No default value