wvrtrunk command

Purpose

Enable, disable, or query the status of one or more trunks and their channels. For background information, see Introduction.

Syntax

wvrtrunk

{ -d [-F] | -e [-w milliseconds] | -q | -h | -? 
}

[-t { trunk_id | start_of_range-end_of_range | all }

    [-c { channel_id | start_of_range-end_of_range | all | none} ] ]

Flags

-d

Disable the trunks specified in the -t flag or the channels specified in the -c flag, waiting for all calls to finish. If the -F flag is specified do not wait for calls to finish. The -t flag is mandatory. The -c flag is optional.

-c

Specifies the channels to be put into service with the -e flag, disabled with the -d flag, or queried with the -q flag. Parameters: all, none, channel_id or a range of channel_ids. Valid only when the -t flag is specified. To enable trunks but not put the channels in service, use -c none.

-e

Enable the trunks specified in the -t flag. By default this puts all the channels in service, unless you use the -c flag to restrict the channels to be put into service, or -c none to put no channels in service. The -t flag is mandatory. The -c flag is optional.

-F

Force the disablement of the trunks or channels. Do not wait for calls to finish.

-h

Display help for the command.

-t

Specifies the trunks to be enabled, disabled, or queried. Parameters: all, trunk_id or a range of trunk_ids.

-q

Query the status of trunks and channels. Specify the -t flag to display trunk status with a summary of channel status. If you also specify -c, you get the channel status of each specified channel. The -t and -c flags are optional: without either, the channel status of all channels on the system is displayed.

-w

Wait for the specified number of milliseconds between enabling each channel.

-?

Display the syntax of the command.

Trunk status output example

Trunk status includes the status of the trunk together with a summary of the channels status. (If there are no channels in a particular state, that state is not mentioned.)

Enter wvrtrunk -q -t 1-2 to display:

Trunk 1: InService (Pack type and signalling: NPACK T1 VoIP - SIP)

Channels: total 30, Idle 30

Trunk 2: Available (Pack type and signalling: NPACK T1 VoIP - SIP)

Channels: total 30, Not Available 30

Channel status output example

Channel status output is simply the status of each channel, one per line.

Enter wvrtrunk -q -t 1 -c 20-25 to display:

Trunk 1: 

Channel 20: alarm  

Channel 21: active

Channel 22: active

Channel 23: idle

Channel 24: idle

Channel 25: blocked

Examples

Query trunk status of all trunks:

wvrtrunk -q -t all

Query trunk status of one trunk:

wvrtrunk -q -t 1

Query channel status of all channels on all trunks:

wvrtrunk -q

Query channel status of all channels on one trunk:

wvrtrunk -q -t 1 -c all

Query channel status of a range of channels on one trunk:

wvrtrunk -q -t 1 -c 20-25

Query channel status of the 24th channel on all trunks:

wvrtrunk -q -t all -c 24

Enable all trunks, putting all channels in service:

wvrtrunk -e -t all

Enable all trunks, putting no channels in service:

wvrtrunk -e -t all -c none

Enable a range of trunks, putting all channels in service:

wvrtrunk -e -t 1-5

Enable a range of trunks, putting no channels in service

wvrtrunk -e -t 1-5 -c none

Enable a trunk, putting all channels in service:

wvrtrunk -e -t 1

Enable a trunk, putting a range of channels in service:

wvrtrunk -e -t 1 -c 15-20

Enable a trunk, putting no channels in service:

wvrtrunk -e -t 1 -c none

Disable all trunks, waiting for all calls to finish:

wvrtrunk -d -t all

Disable a range of trunks, waiting for all calls to finish:

wvrtrunk -d -t 1-5

Disable all trunks, without waiting for calls to finish:

wvrtrunk -d -t all -F

Disable a range of trunks, without waiting for calls to finish:

wvrtrunk -d -t 1-5 -F

Disable a trunk, waiting for all calls to finish:

wvrtrunk -d -t 1

Disable a trunk, without waiting for calls to finish:

wvrtrunk -d -t 1 -F

Disable a channel, waiting for all calls to finish:

wvrtrunk -d -t 1 -c 20

Disable a range of channels, without waiting for all calls to finish:

wvrtrunk -d -t 1 -c 1-6 -F