qconf(1)

NAME
qconf - DQS QueueCONFiguration

SYNTAX
qconf -options

DESCRIPTION

Qconf provides the user interface for adding, deleting and modifying a DQS queue. qconf also provides a means for showing the current queue configuration.

Options

-ac <add complex>
                        Adds a complex to the DQS complex
                        hash tables. The complex entries
                        conform to one of the following:
                        string
                        string=string
                        string=integer
                        Requires root/manager privileges.

-acons consumable_name <add complex>
                       Add a consumable to DQS environment. Each
                       is described by a four line entry.
                        Consumbale consumable_name
                        Available = <amount of resource available>
                        Consume_by = <quantum by which resource reduced>
                        Current = <currently available resource>

                       This option requires root/manager priviledges.

-ah hostname_list <add host>
                       Adds a host to the DQS host list.
                       A host must reside in the DQS host
                       list to execute any of the DQS
                       commands. (The sole exception to
                       this rule being the execution of
                       qconf on the qmaster node.)

                       The hostname_list will be in the
                       following form:

                        hostname[,hostname,...]
                        Requires root/manager privileges.

-am user_list <add a manager>
                       adds a user to the manager list.
                       User_list will be of the following
                       form:

                       usr[,user...]
                       Requires root/manager privileges.

-ao user_list <add an operator>
                       Adds a user to the operator list.
                       User_list will be of the following
                       form:

                       usr[,user...]

                       Requires root/manager privileges.

-aq [q_template] <add new queue>
                       Qconf retrieves the default queue
                       configuration and execs vi (or
                       $EDITOR if EDITOR is set) to
                       allow the customization of the
                       queue configuration. Upon exit
                       from the editor the queue is
                       registered with the qmaster. A
                       minimal configuration requires
                       only that the Qname and Qhostname
                       be set.

                       Requires root/manager privileges.

-au user_list list_name_list
                       Adds a user to a DQS ACLs. The
                       user list is used for queue usage
                       authentication. Multiple user lists
                       are allowed. A null user list
                       indicates that all users with a valid
                       account have access to the associated
                       queue.
                       Requires root/manager/operator
                       privileges.

-Aq fname <add new queue>
                       Allows the queue described in fname
                       to be added.
                       Requires root/manager privileges.

-cell cell_name The cell to which the request is
                       forwarded.

-cq destination_id_list

                       <clean queue>
                       Cleans queue from jobs which haven't
                       been reaped. Primarily a development
                       tool. The destination_id_list
                       conforms to the following:
                        dest_id[,dest_id,...]
                       Requires root/manager/operator
                       privileges.

-dc complex_name <delete named complex>
                      Deletes named Complex
                      Requires root/manager/operator
                      privileges.

-dcons consumable_name <delete a consumable>
                       Deletes the named consumable.

                       Requires root/manager/operator
                       privileges.

-dh server_list
                      <delete host>
                       Deletes a host from the DQS
                       host list. The server_list
                       option conforms to the following:
                        host_name[,host_name,...]
                       Requires root/manager privileges.

-dm user_list <delete a manager>
                       Deletes a manager from the manager
                       list. User_list will be of the
                       following form:

                       usr[,user...]
                       Requires root/manager privileges.

-do user_list <delete an operator>
                       Deletes an operator from the operator
                       list. User_list will be of the
                       following form:
                       usr[,user...]

                       Requires root/manager privileges.

-dq destination_id_list
                       <delete queue>
                       Removes the specified queue(s).
                       Active jobs will be allowed to
                       run to completion. The
                       destination_id_list conforms to
                       the following:
                        dest_id[,dest_id,...]

                       Requires root/manager privileges.

-du user_list list_name_list
                       <delete user>
                       Deletes one or more users from one
                       or more DQS ACLs. The user_list
                       option conforms to the following:
                       usr[,user...]
                       The list_name_list option arguments
                       conform to the following:
                       list_name[,list_name,...]
                       Requires root/manager/operator
                       privileges.

-help Prints a listing of all options.

-mc complex_name <modify complex>
                       Invokes DQS editor and displays named complex. When
                       editor closed, complex is updated with qmaster.
                       This option requires root/manager privileges.

-mcons consumable_name <modify consumable>
                       Invokes editor which displays entry for consumable.
                       When editor is closed consumable values are updated.
                       No running jobs will be affected.
                       This option requires root/manager privileges.

-sc complex_list
                       <show complexes>
                       The complex list conforms to the
                       following:

                       complex_name[,complex_name,...]

-scl <show complex list names>

-sconf [cell] <show master configuration for
                        a cell>

-scons consumable_name <show the named consumbale entry>

-sconsl <shown the consumable>

-sh <show hosts>
                       Displays the DQS host list.

-sm <show managers>
                       Displays the managers list.

-sh <show hosts>
                       Displays the DQS host list.

-sm <show managers>
                       Displays the manager list. -so <show operators>
                       Displays the operator list. -su [list_name] <show users>
                       Displays a DQS user list. -sul <show user lists>
                       Displays all DQS user lists. -sq [dest_id_list] <show queues>
                       Displays a queue(s). -srl <show resolver list>
                       Displays the resolver list. Enviornmental Variables:

    DQS_CELL If set, specifies the default DQS cell.
    DQS_DEBUG If set, specifies that debug information
                    should be written to stderr.
    DQS_EXT_DEBUG If set, specifies that extended debug
                    information should be written to stderr.

SEE ALSO
qmod(l), qdel(l), qstat(l), qmon(l), qidle(l), qsub(l), qrls(l)