lpmove

lpmove

The lpmove program moves requests from one destination to another. The requests leave the queue for the former destination and join the queue for the new destination. This command is useful when a printer must be taken out of service and another printer is available that can print the requests queued for the printer being removed from service. The lpmove runstring is as follows:

CI> lpmove id [id ...] todest

or

CI> lpmove fromdest todest

where:

id

A request ID, as reported by •lpstat -o".

fromdest Names of destinations, either printer names or class names. todest

The first usage above moves one or more requests by request ID to a new destination.

The second usage above moves all requests for a destination to a new destination. The original destination (fromdest) is then set to reject any new requests with the reason •all requests moved to todest". To reenable the original destination, use the ACCEPT command; for example, ACCEPT fromdest.

A request that is moved is assigned a new request ID that names the new destination but retains the same sequence number. For example, if request ID •epoc220" is moved to destination •rtelj" then the new request ID is •rtelj220".

If a request to be moved is actively printing, the print operation is aborted before the request is moved.

Requests may be moved to a destination that is rejecting new submissions; lpmove prints a warning in this case.

You must be a superuser to move requests that do not belong to you, or to move all requests for a destination.

Examples

CI> lpmove levee chicago

Move all requests with destination •levee" to new destination •chicago". Destination •levee" will now reject new submissions.

CI> lpmove lj-5 lj-7 pjxl

Move requests •lj5" and •lj7" to destination •pjxl". The new request IDs are •pjxl5" and •pjxl7".

226 LP Spool System