admuser(1M)                    DG/UX R4.11MU05                   admuser(1M)


NAME
       admlpsched - manage multiple lp schedulers

SYNOPSIS
       admlpsched -o create lpsched ...

       admlpsched -o remove [ -q ] lpsched ...

       admlpsched -o start [ -v ] lpsched ...

       admlpsched -o stop [ -v ] lpsched ...

       admlpsched -o list [ -q ] [ lpsched ... ]

       admlpsched -o status [ -q ] [ lpsched ... ]

DESCRIPTION
       The admlpsched command manages multiple line printer schedulers
       (lpscheds).  It provides operations for creating, deleting, starting,
       stopping and listing the status of multiple lpscheds.

   Operations
       create    This operation will create one or more lpscheds by making a
                 new directory under /var/dg_lpsched/<lpsched> for each
                 lpsched name.  The new directory provides a place holder
                 for the lpsched configuration files and data files.

       remove    This operation will remove one or more lpscheds by deleting
                 the directory structure under /var/dg_lpsched/<lpsched> for
                 each lpsched name.  The user will be prompted for a
                 confirmation before each directory structure is removed.

       start     This operation will start one or more lpscheds.  If the
                 lpsched name is all, then all currently defined lpscheds
                 will be started.  To start the default lpsched, use the
                 name default.

       stop      This operation will stop one or more lpscheds.  If the
                 lpsched name is all, then all currently defined lpscheds
                 will be stopped.  To stop the default lpsched, use the name
                 default.

       list      This operation will list the lpscheds that are currently
                 defined.  The output will include a heading.

       status    This operation will display the running status for each
                 lpsched.  The output will include a heading.

   Options
       -q        If the -q (quiet) option is provided with the remove
                 operation, then the confirmation prompt will be skipped.
                 If the -q option is given for the list or status
                 operations, then the heading will be suppressed.

       -v        If the -v (verbose) option is provided with the start or
                 stop operations, then a message will be printed if the
                 operation is successful.

EXAMPLES
       In the following example, 2 lpscheds named warehouse1 and warehouse2
       are created and then all currently defined lpscheds are started.

           admlpsched -o create warehouse1
           admlpsched -o create warehouse2
           admlpsched -o start all

DIAGNOSTICS
   Errors
       The create operation could not make the directory
       /var/dg_lpsched/<lpsched>.

       The remove operation could not delete the directory structure under
       /var/dg_lpsched/<lpsched>.

       A bad lpsched name was given for the start, stop, remove, list, or
       status operations.

   Exit Codes
       This section lists the possible exit codes and what they mean.

        0     The operation was successful.

        1     The operation was unsuccessful.

        255   There was an error in the command line.

FILES
       /var/dg_lpsched/<lpsched>
              The directory containing the configuration files and data
              files for a secondary lpsched.

NOTES
       When more than one lpsched is defined, each scheduler will appear as
       an independent spooler with it's own set of printer queues, lp forms,
       classes and user definitions.  The lp subsystem commands (e.g. lp,
       lpstat) operate with only one lpsched at a time.  To "target" a
       specific lpsched, the environment variable DG_LPSCHED should be set
       to the desired lpsched name before executing the lp subsystem
       command.  If the DG_LPSCHED variable is unset, then the default
       lpsched will be targeted.

SEE ALSO
       lpadmin(1M).  lp(1).


Licensed material--property of copyright holder(s)