lpmove(1M)

NAME

     lpmove - move print requests

SYNOPSIS

     lpmove [request-ID] destination

     lpmove destination1 destination2

DESCRIPTION

     The lpmove command moves print requests queued by  lp(1)  or
     lpr(1B) between destinations.

     The first form  of  lpmove  moves  specific  print  requests
     (request-ID) to a specific destination.

     The second form  of  the  lpmove  command  moves  all  print
     requests  from  one  destination  (destination1)  to another
     (destination2). This form of lpmove also rejects  new  print
     requests for destination1.

     lpmove moves  individual  requests  or  entire  queues  only
     between  local  printers  or  between  remote  printers, not
     between a local and a remote  printer.  You  can  move  only
     requests that were not previously transferred to the server.

     When moving requests, lpmove does not check  the  acceptance
     status  of  the  destination to which the print requests are
     being moved (see accept(1M)). lpmove does not move  requests
     that  have options (for example, content type or requiring a
     special form) that cannot be handled by the new destination.

OPERANDS

     The following operands are supported:

     request-ID
           The  specific  print  request  to  be  moved.  Specify
           request-ID  as  the identifier associated with a print
           request as reported by lpstat. See lpstat(1).

     destination
           The name of the printer  or  class  of  printers  (see
           lpadmin(1M))  to  which lpmove moves a specified print
           request. Specify destination using atomic, POSIX-style
           (server:destination) syntax.

     destination1
           The name of the destination from  which  lpmove  moves
           all  print requests. Specify destination using atomic,
           POSIX-style (server:destination) syntax.

     destination2
           The name of the destination to which lpmove moves  all
           print  requests.  Specify  destination  using  atomic,
           POSIX-style (server:destination) syntax.

     See printers.conf(4) for information  regarding  the  naming
     conventions  for  atomic names and standards(5) for informa-
     tion regarding POSIX.

EXIT STATUS

     The following exit values are returned:

     0     Successful completion.

     non-zero
           An error occurred.

FILES

     /var/spool/print/*
           LP print queue.

ATTRIBUTES

     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWpcu                     |
    |_____________________________|_____________________________|

SEE ALSO

     lp(1),   lpr(1B),   lpstat(1),   accept(1M),    lpadmin(1M),
     lpsched(1M), printers.conf(4), attributes(5), standards(5)

     System Administration Guide: Advanced Administration