B.80. PauseQueueMember()

Pauses a queue device so that it cannot take calls from the queue.
PauseQueueMember([queue],interface[,options])
Blocks calls for a queue member until expressly re-enabled, either with UnpauseQueueMember() or through the Manager interface. If no queue is specified, the device is paused in every queue in which it is a member. If a queue is specified but the device is not a member in it, or if no queue is specified and the device does not belong to any queues and option j is set, execution proceeds at priority n+101 if it exists.
Returns 0 on success, otherwise returns -1 if the interface cannot be found or the jump priority does not exist. Sets the channel variable PQMSTATUS to PAUSED or NOTFOUND.
; If we dial *111002, Agent/1002 is paused on all queues where she is a member:
exten => *11ZXXX,1,PauseQueueMember(,Agent/${EXTEN:3})

; Dialing *121002 unpauses Agent/1002 again:
exten => *12ZXXX,1,UnpauseQueueMember(,Agent/${EXTEN:3})

Note

Internal help for this application in Asterisk 1.4:
  -= Info about application 'PauseQueueMember' =- 

[Synopsis]
Pauses a queue member

[Description]
   PauseQueueMember([queuename]|interface[|options]):
Pauses (blocks calls for) a queue member.
The given interface will be paused in the given queue.  This prevents
any calls from being sent from the queue to the interface until it is
unpaused with UnpauseQueueMember or the manager interface.  If no
queuename is given, the interface is paused in every queue it is a
member of.  If the interface is not in the named queue, or if no queue
is given and the interface is not in any queue, it will jump to
priority n+101, if it exists and the appropriate options are set.
The application will fail if the interface is not found and no extension
to jump to exists.
The option string may contain zero or more of the following characters:
       'j' -- jump to +101 priority when appropriate.
  This application sets the following channel variable upon completion:
     PQMSTATUS      The status of the attempt to pause a queue member as a
                     text string, one of
           PAUSED | NOTFOUND
Example: PauseQueueMember(|SIP/3000)
diff output to internal help in Asterisk 1.2:
- none -