Asterisk: The Future of Telephony

Name

CheckGroup() — Checks the number of channels in a particular group

Synopsis

    CheckGroup(max[@category])

Checks to see if the total number of channels in the current channel’s group exceeds the max argument. If the number does not exceed max, the application continues to the next priority. If the number of channels in the group is higher than max, and priority n+101 exists (where n is the current priority), execution continues at that priority. Otherwise, the application terminates and -1 is returned.

When the optional category argument is passed, this application checks the total number of channels in the group category. See SetGroup() for more information about categories.

    exten => 123,1,SetGroup(support)
    exten => 123,2,CheckGroup(5)
    ; if there are less than five calls in the support group
    exten => 123,3,Dial(${SUPPORT})
    ; if there are more than five calls in the support group
    exten => 123,103,Playback(im-sorry)

See Also

SetGroup(), GetGroupCount(), GetGroupMatchCount()