Use this object to configure H.323 trunk group parameters.

Note

As a best practice, always use UPPERCASE for trunk group names.


Command Syntax

% set addressContext <name> zone <name> h323TrunkGroup <TG name>
	action <dryUp | force | undefined>
	cac 
		bandwidthLimit <0-2147483647, or unlimited>
		bandwidthLimitThreshold <0-100>
		callLimit <0-2147483647, or unlimited>
		callLimitThreshold <0-100>
		egress 
			callBurstMax <1-200> (SBC 7000 range is 1-2700)
			callLimit <0-2147483647>
        	callRateMax <1-450> (SBC 7000 range is 1-1350)
		ingress 
			callBurstMax <1-200> (SBC 7000 range is 1-2700)
			callRateMax <1-450> (SBC 7000 range is 1-1350)
	callReservationgroup
		inbound <1-100>
		incomingCallMinimum <0-128>
		outgoingCallMinimum <0-100>
		priorityCallMinimum <0-100>
		silc 
			MC1Percent <0-100>
			MC2Percent <0-100>
			state <disabled | enabled>
		state <disabled | enabled>
callRouting 
		ansSupervisionTimeout <0-1000>
		crankBackProfile <name>
		respectBearerCapability <disabled | enabled>
	dryUpTimeout <1-1440>
	ingressIpPrefix <IP address>
	media 
		directMediaAllowed <disabled | enabled>
		directMediaGroupId <#>
		mediaIpAddress <IPv4 address>
		mediaIpInterfaceGroupName <name>
		mediaPortRange
			baseUdpPort <1024-65534, or "none">
			maxUdpPort <1024-65534, or "none">
		preAllocateResPad <disabled | enabled>
		slowStart <convert | passthru>
		sourceAddressFiltering <disabled | enabled>
	mode <inService | outOfService>
 packetOutage 
		bandwidthLimitReduction <0-100>
		detectionInterval <5-1440>
		detectionState <disabled | enabled>
		minimumCalls <0-65535>
		minimumDuration <0-65535>
	parentSharedCacLimitsPoolName <name>
	policy
		callRouting elementRoutingPriority <ERP profile name>
		carrier <serving carrier code>
		country <country code>
		digitParameterHandling 
			egressDmPmRule <rule>
			ingressDmPmRule <rule>
			numberingPlan <numbering plan>
		localizationVariant <generic | japan | northAmerica>
		media <packetServiceProfile | toneAndAnnouncementProfile>
		services classOfService <COS profile name>
		signaling ipSignalingProfile <profile name>
	qoe
		asr
			criticalQosAsrLimit <0-70>
			defaultQosAsr <0-100>
			majorQosAsrLimit <0-90>
		clu 
			criticalQosCluLimit <80-100>
		minTimeToProceed <60-3600>
		pgrd 
			criticalQosPgrdLimit <50-10000>
			defaultPgrdFactor <50-10000>
		rfactor
			criticalQosRfactorLimit <0-100>
			majorQosRfactorLimit <0-100>
		scru 
			criticalQosScruLimit <80-100>
	sendingCompleteEnbloc <disabled | enabled>
	services 
		longDurationCall 
			ldcAction <noAction | release | trap | trapAndRelease>
			ldcEmergencyCalls <exclude | include>
			ldcRelCause <Q.850 release value>
			ldcTimeout <0, 60-2880>
		overlapDialing 
			minDigitsForquery <integer>
			overlapState <disabled | egressOnly | enabled | ingressOnly>
	state <disabled | enabled>


// Mandatory parameters:

h323TrunkGroup
action
dryUpTimeout
ingressIpPrefix
mode
sendingCompleteEnbloc
state

// Non-mandatory parameters:

cac
callReservation
callRouting 
media
packetOutage
parentSharedCacLimitsPoolName
policy
qoe
services 

Command Parameters

Zone H.323 Trunk Group Parameters

Parameter

Description

action

Action when putting this H.323 trunk group outOfService. This object controls whether calls are forced off or allowed to dryup upon a mode out-of-service.

  • dryup (default)
  • force
  • undefined
cac 

Call admission control parameters for this H.323 trunk group. Specify the following CAC parameters:

  • bandwidthLimit – Total media bandwidth limit (in K bits/sec). (range: 0-2147483647, or unlimited / default is ‘unlimited’).
  • bandwidthLimitThreshold – Bandwidth limit notification threshold, as a percentage. (range: 0-100 / default = 0)
  • callLimit – Total number of either ingress or egress concurrent calls allowed. (range: 0-2147483647, or unlimited).
  • callLimitThreshold – Call limit notification threshold, as a percentage. (range: 0-100 / default = 0)
  • egress– Egress-specific call admission control configuration.
    • callBurstMax – (Default is 'unlimited') Maximum allowed burst (above the allowed sustained rate) for egress call attempts. (range: 1-200, or unlimited. SBC 7000 range is 1-2700, or unlimited).
    • callLimit – Total number of concurrent calls (either ingress or egress) allowed on egress. (range: 0-2147483647, or unlimited / default is “unlimited”).
    • callRateMax – (Default is 'unlimited') Maximum allowed call rate (above the allowed sustained rate) for egress call attempts in calls/second. (range: 1-450, or unlimited. SBC 7000 range is 1-1350, or unlimited).

  • ingress– Specifies the ingress-specific call admission control configuration. Specify the following ingress parameters:
    • callBurstMax(Default is 'unlimited') Maximum allowed burst (above the allowed sustained rate) for ingress calls. (range: 1-200, or unlimited. SBC 7000 range is 1-2700, or unlimited).
    • callRateMax(Default is 'unlimited') Maximum sustained ingress call rate allowed in calls/second. (range: 1-450, or unlimited. SBC 7000 range is 1-1350, or unlimited).

NOTE: You can set both “callBurstMax” and “CallRateMax” as unlimited; however, if you assign a value to one parameter, the other must also be assigned a value.

NOTE: Cal policing using callRateMax and callBurstMax is applicable only to normal and emergency calls, not to high priority calls (HPC).

callReservation 

Parameters for reserving a portion of the resources for specific call direction or type for this H.323 trunk group.

  • inbound – Percentage of callLimit reserved for handling inbound calls. This is the percentage of channels reserved for handling inbound calls. Default is 0%. Percentage selection allowed in 5% increments. Enter value in 5% increments. (range: 0-100).
  • incomingCallMinimum – Minimum number of incoming call allowed when reservations are enabled for this trunk group. Enter value in range of 0-128. Default is 1.
  • outgoingCallMinimum – Minimum percent of outgoing call allowed when reservations are enabled for this trunk group. Enter value in range of 0-100. Default is 10.
  • priorityCallMinimum – Minimum number of priority call allowed when reservations are enabled for this trunk group. Enter value in range of 0-100. Default is 1.
  • silc – The SILC traffic control configuration.
    • MC1Percent – Percentage of calls to accept when the machine congestion level is 1. (range: 0-100 / default = 75).
    • MC2Percent – Percentage of calls to accept when the machine congestion level is 2. (range: 0-100 / default = 25).
    • state – Administrative state to enable/disable the SILC traffic control. Select any one of the option: disabled or enabled.
  • state – Administrative state to disable or enable the call reservation feature on a H.323 trunk group.
callRouting Call routing parameters are listed below.
  • ansSupervisionTimeout – Configure this parameter on the ingress trunk group specifying the timeout period (in seconds) for the egress trunk group to receive the first backwards message from the called party exchange (SIP 180 - “Ringing" and SIP 183 - “Progress") until the call is answered. If the timeout period expires, the answer supervision action specified is triggered. A value of "0" disables this timer (range: 0-1000 / default = 300).
  • crankBackProfile – Name of the crank back profile.
  • respectBearerCapability– Enable flag to accept the Bearer Capability Information element values unchanged from H.225 SETUP.
    • disabled (default)
    • enabled
dryUpTimeout  Timeout value (in minutes) for the dry up action. (range: 1-1440 / default = 5).
ingressIpPrefixIngress peers matching these ingress IP prefixes are assigned to this H.323 trunk group. Up to 128 ingressIpPrefix entries may be assigned to a H.323 trunk group. Enter IPv4 or IPv6 address in the following format:
  • <IPv4 or IPv6 address> – The V4 IP address is in dotted decimal form (for example, 128.127.50.224).  The V6 IP address is in hexadecimal/colon form (for example, 1280:1276:3350:2224:2222:3333:8888:1245 or ffd00:21:445:128::7880). (default is 0:0:0:0:0:0:0:0).
  • <prefixLength> – The number of bits of address which form the network part of the IPv6 address. Rest of the bits (128 – prefix length) specify the host part of the IPv6 address. Must be 0-128.
media
Specifies the parameters associated with media features for this H.323 trunk group. Specify the following media parameters: 
  • directMediaAllowed– Enable flag to set up a direct-media path so that media flows directly between endpoints in the same direct-media group.
    • disabled (default)
    • enabled
  • directMediaGroupId – Direct media group to which this trunk group belongs. (range: 0-65535 / default = 0).
  • mediaIpAddress – The IPv4 media IP address assigned to this H.323 trunk group. Any IP address configured must belong to the ipInterfaceGroup configured as the mediaIpInterfaceGroup for the trunk group (default = 0.0.0.0).
  • mediaIpInterfaceGroupName – Specifies the interface group to be used for media.
  • mediaPortRange – Use this media control to set the baseUdpPort and maxUdpPort RTP/RTCP ranges for the specified SIP trunk group.

    • baseUdpPort – The starting (base) port number for the range of UDP ports to use for RTP/RTCP media (inclusive). This value must be within the system-wide media port range. The baseUdpPort range is 1024-65534, or "none" (the default value which indicates SBC does not apply this SIP trunk group control, and instead uses the mediaPortRange specified by system-wide settings).
    • maxUdpPort – The maximum UDP port number for the range of UDP ports to use for RTP/RTCP media (inclusive). This value must be greater than the baseUdpPort and within the system-wide media port range. The maxUdpPort range is 1024-65534, or "none" (the default value which indicates SBC does not apply this SIP trunk group control, and instead uses the mediaPortRange specified by system-wide settings.

NOTE: When provisioning a UDP media port range, set the range slightly larger than the actual number of ports needed to support maximum simultaneous calls.

  • preAllocateResPad– This indicates if a resource pad is pre-allocated or not during an incoming fast start call procedure that results in G.711 codec selected for the call.
    • disabled (default)
    • enabled
  • slowStart– Use this flag to determine whether an ingress H.245 Slow Start is converted to a forward offer (Fast Start) at egress, or passed through as a reverse offer (Slow Start).
    • convert (default)
    • passthru

  • sourceAddressFiltering – Enable flag to filter out incoming media packets which do not match expected source IP address and UDP port.

    • disabled (default)
    • enabled

NOTE: Because video is only supported for H.323-H.323 Slow Start calls, use passthru option in this scenario.

mode

Specifies the operational mode of this H.323 trunk group.

  • inService
  • outOfService (default)
packetOutage

Packet outage detection parameters for this H.323 trunk group.

  • bandwidthLimitReduction – Amount to reduce the bandwidth limit (as a percentage of configured limit) when a packet outage is detected. (range: 0-100 / default =50.
  • detectionInterval – The size of the packet outage detection interval in minutes. (range: 5-1440 / default = 15).
  • detectionState– Enable this flag to perform automatic bandwidth reduction when a packet outage is detected.
    • disabled (default)
    • enabled
  • minimumCalls – The number of calls with outages required within the current interval to declare a packet outage event (range: 0-65535 / default = 1000).
  • minimumDuration – Minimum outage (in milliseconds) on a call for that call to be counted as part of the packet outage detection algorithm. (range: 0-65535 / default = 6000).
parentSharedCacLimitsPoolNameName of existing shared CAC pool.
policy

Specifies the policy data for this H.323 trunk group.

  • callRouting– Specifies the parameters and controls used for routing a call or request to the next-hop entity.
    • elementRoutingPriority – The Element Routing Priority table indicates what Call Processing Elements types (including "none") should be used to determine matching routing table entries. Routing table lookups are attempted in priority order for all matching Call Processing Element types until a match is found. Different Element Routing Priority profiles can be associated with different (ingress) trunk groups. If no Element Routing Priority table is explicitly associated with a trunk group, the DEFAULT_IP Element Routing Priority profile is used.
  • carrier – Specifies the parameters and controls used for carrier for this trunk group for this H.323 trunk group.
  • country – Specifies the parameters and controls used for country for this H.323 trunk group.
  • digitParameterHandling – Specifies the parameters and controls used for digit parameter handling for this trunk group for this H.323 trunk group. Options are:
    • egressDmPmRule – The name of the Digit Manipulation/Parameter Manipulation profile applied at the egress.
      • PAI_AND_FROM_HEADER
      • PAI_DISPLAY_NAMES_1_NTL
      • PAI_SIP_DSPNAME_CLG_NAM
      • PAI_TEL_DSPNAME_GN_CPN
      • PRFX_TO_HEADER_CDPN_NTL
      • PRFX_TO_HEADER_GDPN_NTL
      • PRFX_TO_HEADER_OCN_NTL
      • SIP_ADD_PLUS
      • SIP_REMOVE_CLG81
      • SIP_REMOVE_PLUS1
      • SIP_REMOVE_PLUS39
      • SIP_REMOVE_PLUS44
      • SIP_REMOVE_PLUS49
      • SIP_REMOVE_PLUS52
      • SIP_REMOVE_PLUS81
      • SIP_REMOVE_PLUS86
      • SIP_REMOVE_PLUS91
    • ingressDmPmRule– The name of Digit Manipulation/Parameter Manipulation profile applied at the ingress.
      • PAI_AND_FROM_HEADER   
      • PAI_DISPLAY_NAMES_1_NTL
      • PAI_SIP_DSPNAME_CLG_NAM 
      • PAI_TEL_DSPNAME_GN_CPN 
      • PRFX_TO_HEADER_CDPN_NTL
      • PRFX_TO_HEADER_GDPN_NTL
      • PRFX_TO_HEADER_OCN_NTL 
      • SIP_ADD_PLUS 
      • SIP_REMOVE_CLG81
      • SIP_REMOVE_PLUS1
      • SIP_REMOVE_PLUS39
      • SIP_REMOVE_PLUS44
      • SIP_REMOVE_PLUS49
      • SIP_REMOVE_PLUS52 
      • SIP_REMOVE_PLUS81
      • SIP_REMOVE_PLUS86 
      • SIP_REMOVE_PLUS9
    • numberingPlan– The name of the Numbering Plan profile.
      • CHINA_NUM_PLAN
      • GENERIC_NUM_PLAN
      • GERMANY_NUM_PLAN
      • INDIA_NUM_PLAN
      • ITALY_NUM_PLAN
      • JAPAN_NUM_PLAN
      • MEXICO_NUM_PLAN
      • NANP_ACCESS 
      • UK_NUM_PLAN
  • localizationVariant– Localization variant options for this H.323   trunk group.
    • generic
    • japan
    • northAmerica
  • media– Parameters associated with media policy for   this H.323 trunk group.
    • packetServiceProfile – Packet service profile name.
    • toneAndAnnouncementProfile – Tone and announcement profile name.
  • services– Identifies enhanced services and features for   this H.323 trunk group. Current option:
    • classOfService <CoS name>.
  • signaling– SIP signaling for this H.323 trunk group.
    • ipSignalingProfile <IPSP name> 
qoe

Signaling and media Quality of Experience configuration.

  • asr– ASR signaling quality measurement.
    • criticalQosAsrLimit – The critical ASR limit below which call   admission is stopped. (range: 0-70 / default = 40).
    • defaultQosAsr – Default value used by ASR when no calls are   made during a sampling period (rnage: 0-100 / default = 90).
    • majorQosAsrLimit – The major ASR limit below which call admission   is reduced. (range: 0-90 / default = 70).
  • clu– Call Limit Utilization (CLI) signaling quality   measurement.
    • criticalQosCluLimit – Critical limit (in percentage) above which all   calls are dropped on specified peer/trunk group. (range: 80-100 / default =   80).
  • minTimeToProceed – The minimum time period (in seconds) before   call admission starts after any trunk group KPI falls below the critical   threshold. (range: 60-3600 / default = 60).
  • pgrd– Post Gateway Ringing Delay (PGRD) signaling   quality measurement. Options:
    • criticalQosPgrdLimit – The critical PGRD limit (in milliseconds) above which the call   admission is stopped. (range: 50-10000 / default = 1000).
    • defaultPgrdFactor – Default value to be used as PGRD when no calls   are made for a sampling period.  (range: 50-10000 / default = 1000).
  • rfactor– R-Factor signaling quality measurement.
    • criticalQosRfactorLimit – The critical R-Factor limit below which call admission is stopped. (range: 0-100 / default = 50).
    • majorQosRfactorLimit – The major R-Factor limit below which call admission is reduced. (range: 0-100 / default = 70).
  • scru– Sustained Call Rate Utilization signaling   quality measurement.
    • criticalQosScruLimit – Critical limit (in percentage) above which all   calls are dropped on specified peer/trunk group. (range: 80-100 / default =   80)
sendingCompleteEnbloc

Use this flag to disable/enable sending a   complete called party number in a single enbloc SETUP message.

  • disabled (default)
  • enabled
services

Parameters associated with advanced services and features for this H.323 trunk group.

  • longDurationCall– Defines long duration call supervision. Parameters include:
    • ldcAction – Action to take if the long duration call timer expires: noAction | release | trap | trapAndRelease
    •  ldcEmergencyCalls– Flag to include/exclude Emergency Calls in/from Long Duration Call Disconnect procedures.
      • exclude (default)
      • include
    • ldcRelCause – Q.850 release value to use should the call be  released due to long duration call timer expiry. (default = 41).
    • ldcTimeout– Timeout value (in minutes) of the long duration  call timer. Options:
      • 0 – Use to disable the timer (default).
      • 60-2880 – Sets timer to specified value.
  • overlapDialing– Specifies the   Overlap dialing parameters.
    • minDigitsForQuery – Controls the number of called address digits to collect before performing the first policy query during overlap receiving. If set to “0”, this parameter is irrelevant in controlling policy query. (Range: 0-30 / default = 0)
    • overlapState– Control to determine if Overlap Dialing is supported.
      • disabled (default)
      • egressOnly – Select to enable egress overlap dialing only for a trunk group +both egress and ingress.
      • enabled – Select to enable overlap dialing. If the trunk group is being used for both ingress and egress, then both directions are enabled.
      • ingressOnly – Select to enable ingress overlap dialing only for a trunk group using both egress and ingress.
state

The administrative state of the H.323 trunk group.

  • disabled (default)
  • enabled