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:   In service (Pack type and signalling: XPACK E1 CAS)
Channels:  total 30, alarms 4, active 18, blocked 3, idle 5
Trunk 2:   Available (Pack type and signalling: XPACK E1 ISDN)
Channels:  total 30, out-of-service 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