Maintenance Commands                                  lmshare(1m)

NAME
     lmshare - manipulates a share file without server  interven-
     tion.

SYNOPSIS
     lmshare [ -I instance ] [options][sharename]

DESCRIPTION
     The lmshare command manipulates the set of shared  resources
     without  server  intervention.   It  performs  a  variety of
     operations, including adding  a  new  share  (with  optional
     non-encryption  password),  deleting  a  share,  setting the
     banner page, and setting a queue start time.

OPTIONS
  -I instance
     Specifies the PCNL instance name  or  number.  In  a  multi-
     instance environment instance may be specified either on the
     command line or by the environment  variable  PCNL_INSTANCE.
     If  there  is only one instance configured, it is not neces-
     sary to specify this argument.

  -a [-e] [-i [filename]]
     Adds a new share prompting the user  for  share  name,  type
     (d|p|c|i),  local  path, remark, permissions, maximum users,
     and password.

     The -e option means  that  password  encryption  is  already
     active.

     The -i option reads new share information from filename.  If
     -i  is  used  without filename, standard input will be read.
     Use "" for default string fields and 0 for  default  numeric
     fields.  Each line of the input file provides parameters for
     one new share.  If reading from an input  file,  each  share
     parameter  may  delimited  by  a colon, as well as by double
     quotes.

     The parameter  fields  are  read  in  the  following  order:
     sharename,  type,  remark,  permission,  maxusers,  physical
     name, password, command string,  precnt,  preset  sequence.,
     postcnt,  postset  sequence, prprio, queue start time, queue
     stop time, separator, queue parameters, queue remark.

     The output of the "-l" option can be used as  input  to  the
     "-i" option.

  -b  
     Sets the printer banner page.

  -d 
     Deletes share name.

  -f  
     Gets a specific field from the share.

  -g  
     Sets queue start time between 0 to 1439 minutes (24 hour - 1
     min).  If the start time is not specified, the default value
     0 will be used.

  -h  
     Sets queue stop time between 0 to 1439 minutes (24 hour -  1
     min).   If the stop time is not specified, the default value
     1439 will be used.

  -l
     Lists share.

  -m  
     Sets queue parameters.

  -n
     Creates a new share list.

  -o 
     Re-shares an unshared print queue.

  -p  
     Modifies a printer command string.

  -q [queuename]
     Lists printer shares.

  -r  [preset sequence]
     Sets printer preset sequence. Clears  existing  sequence  if
     preset sequence is not specified.

  -s  [post-set sequence]
     Sets printer post-set sequence. Clears existing sequence  if
     post-set sequence is not specified.

  -v
     Debugging on; if required must be first option.

EXAMPLES
     To add a new share, type the following command:

          lmshare -a

     To list shares, type the following command:

          lmshare -l

     To obtain a specific field from a share, for  example  field
     2, type the following command:

          lmshare -f share 2

     To restore a share list from a file, say "sharelist",  which
     was  generated  from the output of lmshare -l, type the fol-
     lowing:

          lmshare -a -e -i sharelist