Class CIM_PrintQueue
extends CIM_JobDestination

Capabilities and management of a Printer Queue. A PrintQueue holds PrintJobs that are placed on the Queue by a Print Service. Jobs can move from Queue to Queue. The ABNF for CIM references to PWG Standards and MIBs is in the directory 'ftp://ftp.pwg.org/pub/pwg/general/process' in the file 'pwg-cim-references-format-20060309.txt'. An example for a MappingStrings reference to a PWG Standard is 'PWG5101-1.PWG|Section 4 Media Color Names'. An example for a MappingStrings reference to a PWG MIB is 'MIB.PWG|PWG-IMAGING-COUNTER-MIB.icMonitorCompletedJobs'.

Table of Contents
Hierarchy
Direct Known Subclasses
Class Qualifiers
Class Properties
Class Methods


Class Hierarchy

CIM_ManagedElement
   |
   +--CIM_ManagedSystemElement
   |
   +--CIM_LogicalElement
   |
   +--CIM_EnabledLogicalElement
   |
   +--CIM_JobDestination
   |
   +--CIM_PrintQueue

Direct Known Subclasses

Class Qualifiers

NameData TypeValue
DescriptionstringCapabilities and management of a Printer Queue. A PrintQueue holds PrintJobs that are placed on the Queue by a Print Service. Jobs can move from Queue to Queue. The ABNF for CIM references to PWG Standards and MIBs is in the directory 'ftp://ftp.pwg.org/pub/pwg/general/process' in the file 'pwg-cim-references-format-20060309.txt'. An example for a MappingStrings reference to a PWG Standard is 'PWG5101-1.PWG|Section 4 Media Color Names'. An example for a MappingStrings reference to a PWG MIB is 'MIB.PWG|PWG-IMAGING-COUNTER-MIB.icMonitorCompletedJobs'.
UMLPackagePathstringCIM::Device::Printing
Versionstring2.14.0

Class Properties

Local Class Properties

NameData TypeDefault ValueQualifiers
NameData TypeValue
DefaultJobPriorityuint32
DescriptionstringSpecifies the priority that will be assigned to a new Job that is submitted to this Queue, if the Job does not explicitly specify a priority. The range of valid priorities and the interpretation of priorities can be determined from the JobPriorityHigh and JobPriorityLow properties.
MappingStringsstringRFC2911.IETF|Printer.job-priority-default
ModelCorrespondencestringCIM_PrintQueue.JobPriorityHigh, CIM_PrintQueue.JobPriorityLow
JobPriorityHighuint32
DescriptionstringSpecifies the numeric value that is used to represent the highest priority Jobs that are submitted to this Queue. The range of numeric values for priority can be inverted, for example, a high priority job is represented by a low integer value. This value is indicated by JobPriorityLow being greater than JobPriorityHigh. If both values (PriorityLow and PriorityHigh) are assigned to 0, then the Queue does not support Job priorities. The values and usage of the property SHOULD conform to the semantics of the 'job-priority-supported' attribute of the Printer object defined in IPP/1.1 [RFC2911].
MappingStringsstringRFC2911.IETF|Printer.job-priority-supported
ModelCorrespondencestringCIM_PrintQueue.JobPriorityLow, CIM_Job.Priority
JobPriorityLowuint32
DescriptionstringSpecifies the numeric value that is used to represent the lowest priority Jobs that are submitted to this Queue. The range of numeric values for priority can be inverted, for example, a low priority job is represented by a high integer value. This value is indicated by JobPriorityLow being greater than JobPriorityHigh. If both values (PriorityLow and PriorityHigh) are assigned to 0, then the Queue does not support Job priorities. The values and usage of the property SHOULD conform to the semantics of the 'job-priority-supported' attribute of the Printer object defined in IPP/1.1 [RFC2911].
MappingStringsstringRFC2911.IETF|Printer.job-priority-supported
ModelCorrespondencestringCIM_PrintQueue.JobPriorityHigh, CIM_Job.Priority
MaxJobSizeuint32
DescriptionstringSpecifies the largest possible Job (in terms of a single byte stream) that can be submitted to this Queue. A value of 0 indicates that no limit has been set. Units are Kbytes.
MappingStringsstringRFC2911.IETF|Section 4.4.33 job-k-octets-supported
ModelCorrespondencestringCIM_PrintJob.JobSize
PUnitstringbyte * 10^3
UnitsstringKiloBytes
NumberOnQueueuint32
DescriptionstringThe current number of Jobs on the Queue.
Gaugebooleantrue
MappingStringsstringMIB.IETF|Job-Monitoring-MIB.jmGeneralNumberOfActiveJobs, RFC2911.IETF|Printer.queued-job-count
QueueAcceptingboolean
DeprecatedstringCIM_EnabledLogicalElement.EnabledState
DescriptionstringNote: Both this property and QueueEnabled are deprecated in lieu of EnabledState. Deprecated description: When false, no PrintService can place PrintJobs on the PrintQueue. The ability of an individual PrintService to place a Job on the Queue can be specified using the QueueAcceptingFromService property in the QueueForPrint Service association. This property, coupled with the information in QueueEnabled, aligns with various values of the inherited EnabledState property: - When both QueueEnabled and QueueAccepting are true, then EnabledState is set to 2 ("Enabled") - When both QueueEnabled and QueueAccepting are false, then EnabledState is set to 3 ("Disabled") - When QueueEnabled is true and QueueAccepting is false (for instance, when the Queue outputs jobs to the printer, but does not accept new jobs), then EnabledState is set to 6 ("Enabled but Offline") - When QueueEnabled is false and QueueAccepting is true (for instance, when the Queue accepts print jobs but does not send them to a printer), then EnabledState is set to 8 ("Deferred").
QueueEnabledboolean
DeprecatedstringCIM_EnabledLogicalElement.EnabledState
DescriptionstringNote: Both this property and QueueAccepting are deprecated in lieu of EnabledState. Deprecated description: Indicates that Jobs on the Queue will be passed to a Printer. When false, a Job will remain on the Queue and will not be passed to a Printer for output. This property, coupled with the information in QueueAccepting, aligns with various values of the inherited EnabledState property: - When both QueueEnabled and QueueAccepting are true, then EnabledState is set to 2 ("Enabled") - When both QueueEnabled and QueueAccepting are false, then EnabledState is set to 3 ("Disabled") - When QueueEnabled is true and QueueAccepting is false (for instance, when the Queue outputs jobs to the printer, but does not accept new jobs), then EnabledState is set to 6 ("Enabled but Offline") - When QueueEnabled is false and QueueAccepting is true (for instance, when the Queue accepts print jobs but does not send them to a printer), then EnabledState is set to 8 ("Deferred").
QueueStatusuint16
DescriptionstringGives Queue-specific status information, beyond the ManagedSystemElement.Status property. This method can be used to provide further qualification as to the status of the Queue or to indicate a secondary condition (for example, spool area is full).
MappingStringsstringRFC2911.IETF|Printer.printer-state-reasons
ValueMapstring0, 1, 2, 3
ValuesstringOther, Unknown, No Additional Status, QueueSpoolAreaFull
QueueStatusInfostring
DescriptionstringProvides a textual explanation for the status of the Queue. The settings of both QueueStatus and the Status property that are inherited from ManagedSystemElement can be described by QueueStatusInfo. For example, if "Stopping" is the value that is assigned to Status, then this property might contain an explanation as to why the Queue is being stopped.
MappingStringsstringRFC2911.IETF|Printer.printer-state-message
AvailableJobSheetsstring[]
DescriptionstringSpecifies the job sheets that are supported by this Queue. Typically the job sheets that are provided by a Queue will be the union or aggregation of those provided by all the Printers that it supports. However, a system administrator can choose to restrict access to some job sheets on a particular Queue. A Queue can also support additional job sheets through the use of a filter that adds a banner or some other page when a Job is taken from the Queue.
MappingStringsstringMIB.IETF|Printer-MIB.prtAuxiliarySheetStartupPage, MIB.IETF|Printer-MIB.prtAuxiliarySheetBannerPage, RFC2911.IETF|Printer.job-sheets-supported
ModelCorrespondencestringCIM_PrintJob.RequiredJobSheets

Inherited Properties

NameData TypeClass Origin
CaptionstringCIM_ManagedElement
CommunicationStatusuint16CIM_ManagedSystemElement
CreationClassNamestringCIM_JobDestination
DescriptionstringCIM_ManagedElement
DetailedStatusuint16CIM_ManagedSystemElement
ElementNamestringCIM_ManagedElement
EnabledDefaultuint16CIM_EnabledLogicalElement
EnabledStateuint16CIM_EnabledLogicalElement
Generationuint64CIM_ManagedElement
HealthStateuint16CIM_ManagedSystemElement
InstallDatedatetimeCIM_ManagedSystemElement
InstanceIDstringCIM_ManagedElement
NamestringCIM_JobDestination
OperatingStatusuint16CIM_ManagedSystemElement
OtherEnabledStatestringCIM_EnabledLogicalElement
PrimaryStatusuint16CIM_ManagedSystemElement
RequestedStateuint16CIM_EnabledLogicalElement
StatusstringCIM_ManagedSystemElement
SystemCreationClassNamestringCIM_JobDestination
SystemNamestringCIM_JobDestination
TimeOfLastStateChangedatetimeCIM_EnabledLogicalElement
TransitioningToStateuint16CIM_EnabledLogicalElement
AvailableRequestedStatesuint16[]CIM_EnabledLogicalElement
OperationalStatusuint16[]CIM_ManagedSystemElement
StatusDescriptionsstring[]CIM_ManagedSystemElement

Class Methods

Inherited Class Methods

NameReturn TypeClass Origin
RequestStateChangeuint32CIM_EnabledLogicalElement