Configuring Trunk Access Codes (TACs)

Configure trunk access codes (TACs) properties to specify how specific dial strings are processed.

To provide flexibility of paging support, you can specify global defaults that affect how Vocera SIP Telephony Gateway handles paging, or you can configure trunk access codes (or TACs) to specify how specific dial strings are processed. Each TAC is compared as a prefix to a dialed number, so you can use it to override entire classes of dialed numbers.

The TAC property values are entered into a matrix, with each value delimited by a forward slash (/) as a separator character. The first column contains the default value for each property. After the default value in each row, you can specify up to 64 TAC values, each delimited with a slash. White space characters (such as space or tab) are ignored.

When you specify more than one value for any of these properties, the order is important. If two or more TACs begin with the same sequence of characters, list them in descending order of length when you specify values for the VTGTrunkAccessCode property.

Vocera's parser processes a dial string from left to right, and when it finds a sequence of digits that matches a value specified for VTGTrunkAccessCode, it interprets that sequence as the TAC portion of the dial string. Therefore, given a dial string of 1234914087904100 and two VTGTrunkAccessCode property values listed in the order 12/1234, the parser interprets the first match, 12, as the TAC. However, when the same property values are listed in the order 1234/12, the first match is 1234.

The following table describes the TAC properties:

Property

Description

VTGTrunkAccessCode

Specifies a trunk access code (TAC) to identify a number dialed that passes through the Vocera SIP Telephony Gateway to the IP PBX to communicate with a Vocera device. The first value is "DEFAULTS", which cannot be changed. It is used to identify the first column in the matrix as default values. To add a TAC, type a forward slash ("/") followed by the access code. You can add up to 64 TACs.

VTGHangupMacro

Specifies a sequence to dial when a Vocera device ends a call initiated using the callback option in response to a VMI message or a page. The required sequence varies depending on the device. For example, nurse call systems and paging systems from different vendors require different hang-up sequences. Consult the device documentation for details.

By default, this property value is not defined.

VTGPagingCommaDuration

Specifies the pause duration (in milliseconds) of each comma in the paging dial string. The default is 2000 ms, or 2 seconds.

VTGPagingSemicolonDuration

Specifies the pause duration (in milliseconds) of each semicolon in the paging dial string. The default is 3000 ms, or 3 seconds.

VTGPagingAddPrimaryExtOnSDPNegComplete

Whether to add the Primary Extension to the DTMF queue when SIP SDP offer/answer negotiation is complete. The default is TRUE.

VTGPagingAddPrimaryExtOnCONFIRMED

Whether to add the Primary Extension to the DTMF queue after the call is connected and the ACK is confirmed. The default is FALSE.

The Primary Extension will be added to the DTMF queue at the first event that causes it to be added based on Vocera SIP Telephony Gateway properties. Consequently, if VTGPagingAddPrimaryExtOnSDPNegComplete is set to TRUE for a particular TAC, it takes precedence over the VTGPagingAddPrimaryExtOnCONFIRMED property if it is also set to TRUE.

VTGPagingAddSecondaryOnCONFIRMED

Whether to add the Secondary Dial String to the DTMF queue after the call is connected and the ACK is confirmed. The default is TRUE.

The Primary Extension will be added to the DTMF queue at the first event that causes it to be added based on Vocera SIP Telephony Gateway properties. Consequently, if VTGPagingAddPrimaryExtOnSDPNegComplete is set to TRUE for a particular TAC, it takes precedence over the VTGPagingAddPrimaryExtOnCONFIRMED property if it is also set to TRUE.

VTGPagingAddSecondaryAfterPrimaryExt

Whether to add the Secondary Dial String to the DTMF queue immediately after the Primary Extension. The default is FALSE. In some cases, a call may not be explicitly answered (that is, it does not transition to CONNECTING and then CONFIRMED) until more digits are sent. If so, set the value of this property to TRUE.

VTGPagingAppendPoundToPageString

Whether to append a pound key (#) pound key to the end of the page dial string. The default is TRUE.

VTGGainVoceraToSIP

Adjusts the volume of audio sent from a Vocera device to a telephone. By increasing or decreasing this value, you increase or decrease the volume of the call in 3 dB increments.

For example, a value of 3 increases the volume by 9 dB (3 * 3 = 9). Valid values range from -6 to 6, inclusive. The default is 0. The gain is removed when the call ends.

VTGGainSIPToVocera

Adjusts the volume of audio sent from a telephone to a Vocera device. By increasing or decreasing this value, you increase or decrease the volume of the call in 3 dB increments.

For example, a value of 3 increases the volume by 9 dB (3 * 3 = 9). Valid values range from -6 to 6, inclusive. The default is 0. The gain is removed when the call ends.