Expand setinterfacevar option to also set a variable, MEMBERNAME, which contains...
[asterisk/asterisk.git] / configs / queues.conf.sample
index ab88d18..85064ae 100644 (file)
@@ -3,11 +3,16 @@
 ; Global settings for call queues
 ;
 ; Persistent Members
-;    Store each dynamic agent in each queue in the astdb so that
-;    when asterisk is restarted, each agent will be automatically
+;    Store each dynamic member in each queue in the astdb so that
+;    when asterisk is restarted, each member will be automatically
 ;    read into their recorded queues. Default is 'yes'.
 ;
 persistentmembers = yes
+;
+; Keep Stats
+;    Keep queue statistics during a reload. Default is 'no'
+;
+keepstats = no
 ; 
 ; AutoFill Behavior
 ;    The old/current behavior of the queue has a serial type behavior 
@@ -24,7 +29,7 @@ persistentmembers = yes
 ;    probably more along the lines of how a queue should work and 
 ;    in most cases, you will want to enable this behavior. If you 
 ;    do not specify or comment out this option, it will default to no
-;    to keep backward compatability with the old behavior.
+;    to keep backward compatibility with the old behavior.
 ;
 autofill = yes
 ;
@@ -35,7 +40,7 @@ autofill = yes
 ;    the concept of "joining/mixing" the in/out files now goes away
 ;    when this is enabled. You can set the default type for all queues
 ;    here, and then also change monitor-type for individual queues within
-;    queue by using the same configuation parameter within a queue 
+;    queue by using the same configuration parameter within a queue 
 ;    configuration block. If you do not specify or comment out this option,
 ;    it will default to the old 'Monitor' behavior to keep backward
 ;    compatibility. 
@@ -51,10 +56,12 @@ monitor-type = MixMonitor
 ;
 ; A sample call queue
 ;
-; Musiconhold sets which music applies for this particular
-; call queue (configure classes in musiconhold.conf)
+; Musicclass sets which music applies for this particular call queue.
+; The only class which can override this one is if the MOH class is set
+; directly on the channel using Set(CHANNEL(musicclass)=whatever) in the
+; dialplan.
 ;
-;musiconhold = default
+;musicclass = default
 ;
 ; An announcement may be specified which is played for the member as
 ; soon as they answer a call, typically to indicate to them which queue
@@ -122,6 +129,7 @@ monitor-type = MixMonitor
 ;
 ; If set to yes, just prior to the caller being bridged with a queue member 
 ; the MEMBERINTERFACE variable will be set with the interface name (eg. Agent/1234)
+; and the MEMBERNAME variable will be set with the member name (eg. Joe Soap)
 ; of the queue member that was chosen and is now connected to be bridged with
 ; the caller
 ;
@@ -250,16 +258,17 @@ monitor-type = MixMonitor
 ;
 ;
 ; If this is set to yes, the following manager events will be generated:
-; AgentCalled, AgentDump, AgentConnect, AgentComplete
+; AgentCalled, AgentDump, AgentConnect, AgentComplete; setting this to
+; vars also sends all channel variables with the event.
 ; (may generate some extra manager events, but probably ones you want)
 ;
-; eventwhencalled = yes
+; eventwhencalled = yes|no|vars
 ;
-; If this is set to no, the following manager events will be generated:
+; If this is set to yes, the following manager events will be generated:
 ; QueueMemberStatus
 ; (may generate a WHOLE LOT of extra manager events)
 ;
-; eventmemberstatusoff = no
+; eventmemberstatus = no
 ;
 ; If you wish to report the caller's hold time to the member before they are
 ; connected to the caller, set this to yes.
@@ -288,10 +297,14 @@ monitor-type = MixMonitor
 ; Each member of this call queue is listed on a separate line in
 ; the form technology/dialstring.  "member" means a normal member of a
 ; queue.  An optional penalty may be specified after a comma, such that
-; entries with higher penalties are considered last.
+; entries with higher penalties are considered last.  An optional member
+; name may also be specified after a second comma, which is used in log
+; messages as a "friendly name".  Multiple interfaces may share a single
+; member name.
 ;
 ;member => Zap/1
-;member => Zap/2
+;member => Zap/2,10
+;member => Zap/3,10,Bob Johnson
 ;member => Agent/1001
 ;member => Agent/1002