172 Chapter 10 Working with the Print Service
The following is an example of a queue array parameter block:
print:queuesArray:_array_id:my_printer:quotasEnforced = no
print:queuesArray:_array_id:my_printer:sharingList:_array_index:0:service =
"LPR"
print:queuesArray:_array_id:my_printer:sharingList:_array_index:0:sharingEna
ble = no
print:queuesArray:_array_id:my_printer:sharingList:_array_index:1:service =
"SMB"
print:queuesArray:_array_id:my_printer:sharingList:_array_index:1:sharingEna
ble = no
print:queuesArray:_array_id:my_printer:sharingList:_array_index:2:service =
"AppleTalk"
print:queuesArray:_array_id:my_printer:sharingList:_array_index:2:sharingEna
ble = no
print:queuesArray:_array_id:my_printer:shareable = yes
print:queuesArray:_array_id:my_printer:printerName = "Room 3 Printer"
print:queuesArray:_array_id:my_printer:printerURI = "pap://*/
Room%203%20Printer/LaserWriter"
print:queuesArray:_array_id:my_printer:registerRendezvous = yes
print:queuesArray:_array_id:my_printer:printerKind = "Lexmark_Optra_E310"
print:queuesArray:_array_id:my_printer:sharingName = "Room 3 Printer"
Note: In the example above, “my_printer” refers to the CUPS queue id.
Managing Print Service
To modify and manage Print service, use the serveradmin tool and the following
commands that interact with CUPS.
Command (print:command=) Description
getJobs Lists information about jobs in a queue. The name required for this
command is the sharing name given to the queue by the
administrator, as previously described. See “Listing Jobs and Job
Information” on page 173.
getLogPaths Finds the locations of Print service and job logs. See “Viewing Print
Service Log Files and Log Paths” on page 175.
getQueues Lists Print service queues. See “Listing Queues” on page 173.
setJobState Holds or releases a job. The name required for this command is the
sharing name given to the queue by the administrator, as
previously described. See “Holding and Releasing a Job” on
page 174.
setQueueState Pauses or releases a queue. The queue name required for this
command is the sharing name given to the queue by the
administrator, not the original printer name or the CUPS queue
identifier. See “Pausing and Releasing a Queue” on this page.
writeSettings Equivalent to the standard serveradmin settings command,
but also returns a setting indicating whether the service must be
restarted. See “Using the serveradmin Tool” on page 50.
Comments to this Manuals