Adding a user share to a fair share queue

Use the bconf addmember command to add a user share to a fair share queue.

About this task

You can add a member and share to a fair share queue in the lsb.queues file by using live reconfiguration.

Procedure

Run the bconf addmember command.

bconf addmember queue=queue_name "fair share=USER_SHARES[[user_name, share]]"

For example, if you have the following existing configuration in the lsb.queues file:

...
Begin queue
QUEUE_NAME=my_queue
fair share=USER_SHARES[[tina, 10] [default, 3]]
End Queue
...

Add a user group and share:

bconf addmember queue=my_queue "fair share=USER_SHARES[[ug1, 10]]"
bconf: Request for queue <my_queue> accepted

After it is accepted by the bconf command, the new share definition appears in the bqueue -l command output:

bqueues -l my_queue
...
USER_SHARES: [tina, 10] [ug1, 10] [default, 3]
...
Important: If USER_SHARES=[] is defined for the fair share queue and a share value is added to the USER_SHARES parameter, the value [default,1] is also added automatically.

For example, if you have the following configuration in the lsb.queues file:

...
Begin Queue
QUEUE_NAME=queue16
fair share=USER_SHARES[]
End Queue
...

Add a share value:

bconf addmember queue=queue16 "fair share=USER_SHARES[[user3, 10]]"
bconf: Request for queue <queue16> accepted

After it is accepted by the bconf command, the new share definition appears in the bqueue -l command output:

bqueues -l queue16
...
USER_SHARES: [user3, 10] [default, 1]
...