# 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

Name | Data Type | Value
--- | --- | ---

Description

string

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'.

UMLPackagePath | string | CIM::Device::Printing
Version | string | 2.14.0

## Class Properties

### Local Class Properties

Name | Data Type | Default Value | Qualifiers
--- | --- | --- | ---
Name | Data Type | Value
DefaultJobPriority | uint32 |
Description | string | Specifies 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.
MappingStrings | string | RFC2911.IETF|Printer.job-priority-default
ModelCorrespondence | string | CIM_PrintQueue.JobPriorityHigh, CIM_PrintQueue.JobPriorityLow
JobPriorityHigh | uint32 |

Description

string

Specifies 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].

MappingStrings | string | RFC2911.IETF|Printer.job-priority-supported
ModelCorrespondence | string | CIM_PrintQueue.JobPriorityLow, CIM_Job.Priority
JobPriorityLow | uint32 |

Description

string

Specifies 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].

MappingStrings | string | RFC2911.IETF|Printer.job-priority-supported
ModelCorrespondence | string | CIM_PrintQueue.JobPriorityHigh, CIM_Job.Priority
MaxJobSize | uint32 |
Description | string | Specifies 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.
MappingStrings | string | RFC2911.IETF|Section 4.4.33 job-k-octets-supported
ModelCorrespondence | string | CIM_PrintJob.JobSize
PUnit | string | byte * 10^3
Units | string | KiloBytes
NumberOnQueue | uint32 |
Description | string | The current number of Jobs on the Queue.
Gauge | boolean | true
MappingStrings | string | MIB.IETF|Job-Monitoring-MIB.jmGeneralNumberOfActiveJobs, RFC2911.IETF|Printer.queued-job-count
QueueAccepting | boolean |
Deprecated | string | CIM_EnabledLogicalElement.EnabledState

Description

string

Note: 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").

QueueEnabled | boolean |
Deprecated | string | CIM_EnabledLogicalElement.EnabledState

Description

string

Note: 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").

QueueStatus | uint16 |
Description | string | Gives 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).
MappingStrings | string | RFC2911.IETF|Printer.printer-state-reasons
ValueMap | string | 0, 1, 2, 3
Values | string | Other, Unknown, No Additional Status, QueueSpoolAreaFull
QueueStatusInfo | string |
Description | string | Provides 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.
MappingStrings | string | RFC2911.IETF|Printer.printer-state-message
AvailableJobSheets | string[] |

Description

string

Specifies 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.

MappingStrings | string | MIB.IETF|Printer-MIB.prtAuxiliarySheetStartupPage, MIB.IETF|Printer-MIB.prtAuxiliarySheetBannerPage, RFC2911.IETF|Printer.job-sheets-supported
ModelCorrespondence | string | CIM_PrintJob.RequiredJobSheets

### Inherited Properties

Name | Data Type | Class Origin
--- | --- | ---
Caption | string | CIM_ManagedElement
CommunicationStatus | uint16 | CIM_ManagedSystemElement
CreationClassName | string | CIM_JobDestination
Description | string | CIM_ManagedElement
DetailedStatus | uint16 | CIM_ManagedSystemElement
ElementName | string | CIM_ManagedElement
EnabledDefault | uint16 | CIM_EnabledLogicalElement
EnabledState | uint16 | CIM_EnabledLogicalElement
HealthState | uint16 | CIM_ManagedSystemElement
InstallDate | datetime | CIM_ManagedSystemElement
InstanceID | string | CIM_ManagedElement
Name | string | CIM_JobDestination
OperatingStatus | uint16 | CIM_ManagedSystemElement
OtherEnabledState | string | CIM_EnabledLogicalElement
PrimaryStatus | uint16 | CIM_ManagedSystemElement
RequestedState | uint16 | CIM_EnabledLogicalElement
Status | string | CIM_ManagedSystemElement
SystemCreationClassName | string | CIM_JobDestination
SystemName | string | CIM_JobDestination
TimeOfLastStateChange | datetime | CIM_EnabledLogicalElement
TransitioningToState | uint16 | CIM_EnabledLogicalElement
AvailableRequestedStates | uint16[] | CIM_EnabledLogicalElement
OperationalStatus | uint16[] | CIM_ManagedSystemElement
StatusDescriptions | string[] | CIM_ManagedSystemElement

## Class Methods

### Inherited Class Methods

Name | Return Type | Class Origin
--- | --- | ---
RequestStateChange | uint32 | CIM_EnabledLogicalElement