Logging a comment on a queue control command

When you open, close, activate, or deactivate a queue, add a comment to give more information about the queue control action.

Procedure

  1. Use the -C option of badmin queue commands qclose, qopen, qact, and qinact to log an administrator comment in lsb.events.
    badmin qclose -C "change configuration" normal
    

    The comment text change configuration is recorded in lsb.events.

    A new event record is recorded for each queue event. For example, the following commands generate records in lsb.events:
    badmin qclose -C "add user" normal
    badmin qclose -C "add user user1" normal
    

    The following records are generated:

    "QUEUE_CTRL" "10.1.0 1050082373 1 "normal" 32185 "lsfadmin" "add user"
    "QUEUE_CTRL" "10.1.0 1050082380 1 "normal" 32185 "lsfadmin" "add user user1"
  2. Use badmin hist or badmin qhist to display administrator comments for closing and opening hosts.
    badmin qhist
    Fri Apr  4 10:50:36: Queue <normal> closed by administrator <lsfadmin> change configuration.

    bqueues -l also displays the comment text:

    bqueues -l normal
    QUEUE: normal
     -- For normal low priority jobs, running only if hosts are lightly loaded.  Th is is the default queue.
     
    PARAMETERS/STATISTICS
    PRIO NICE STATUS          MAX JL/U JL/P JL/H NJOBS  PEND   RUN SSUSP USUSP  RSV
     30   20  Closed:Active     -    -    -    -     0     0     0     0     0    0 
    Interval for a host to accept two jobs is 0 seconds
     THREADLIMIT
           7 
     
    SCHEDULING PARAMETERS
                r15s   r1m  r15m   ut      pg    io   ls    it    tmp    swp    mem 
    loadSched   -     -     -     -       -     -    -     -     -      -      - 
    loadStop    -     -     -     -       -     -    -     -     -      -      -
     
                  cpuspeed    bandwidth  
    loadSched          -            -  
    loadStop           -            -  
     
    JOB EXCEPTION PARAMETERS
                  OVERRUN(min) UNDERRUN(min) IDLE(cputime/runtime)
    Threshold         -         2             -       
    Jobs              -         0             - 
     
    USERS:  all users 
    HOSTS:  all 
    RES_REQ:  select[type==any] 
     
    ADMIN ACTION COMMENT: "change configuration"