System Administration Commands                         lpmove(1M)



NAME
     lpmove - move print requests

SYNOPSIS
     lpmove [request-ID] destination


     lpmove source destination


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
     within  an  instance of a print service, not between a local
     and a remote queues or local queues on  different  instances
     of  a print service. Requests can only be moved if the print
     service or protocol supports it. The LP print server and IP
     print  protocol both support moving requests between queues.
     The BSD print protocol does not.


     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 associ-
                    ated 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



SunOS 5.11           Last change: 6 Jun 2006                    1






System Administration Commands                         lpmove(1M)



                    using  atomic, URI-style (scheme:/endpoint),
                    POSIX-style (server:destination) syntax.


     source         The name of the destination from which lpmove
                    moves all print requests. Specify destination
                    using atomic, URI-style  (scheme:/endpoint),
                    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
     /etc/printers.conf      System printer  configuration  data-
                             base


     $HOME/.printers         User-configurable printer database


     ou=printers             LDAP version of /etc/printers.conf


     printers.conf.byname    NIS version of /etc/printers.conf


     printers.orgdir        NIS] version of /etc/printers.conf


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











SunOS 5.11           Last change: 6 Jun 2006                    2






System Administration Commands                         lpmove(1M)



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Availability                 SUNWlp-cmds                 
    
     Interface Stability          Obsolete                    
    


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


     System Administration Guide: Solaris Printing

NOTES
     When IP is in use, the user is prompted for  a  passphsrase
     if the remote print service is configured to require authen-
     tication.



































SunOS 5.11           Last change: 6 Jun 2006                    3