Trunk Route Verification Test

The Trunk Route Verification Test object is a child of a Route Verification Test Group object.

Each Trunk Route Verification Test simulates the validation and routing of an incoming call received over a trunk from a remote exchange.

Most of the modifiable fields in this object are also included in the parent RVT Group object, and the default values are taken from the settings in the parent object. You do not need to set these fields explicitly unless you want to use different values from those in the parent RVT Group. The only parameters that you need to set are the parameters specific to a particular test, such as the telephone number to be tested.

The Test result field and subsequent fields, which report the outcome of the test, are valid only after the test has been run. To run the test, click on the 'Run test' pushbutton.

The Expected result fields allow you to specify the results that you expect to get when running this test. If you configure an expected result, the operational status symbol next to this object in the EMS Tree View provides a quick view of whether the last run of the test was as expected:


You can change the values of parameters in this object at any time. However, if the test is running, and you change a parameter that could affect the results, the test is canceled.

Object-Specific Actions
Run test To run a Trunk Route Verification Test, click on the 'Run test' pushbutton. Note that this action is not available when the object is disabled.

Parameter

Access

Description
Test name Change Unique user-friendly name identifying the test. Specify a name of up to 64 characters.
Called number Change The called number to set on messages used in this test. This field can include digits 0 - 9 and/or the characters # and *. Specify the full national telephone number, without the leading zero.
Called address scope Change The called address scope to set on messages used in this test. Values:
  • Unknown (default)
  • International
  • National
  • Network specified
  • Subscriber
  • Abbreviated
  • Reserved 1
  • 950 Plus
  • No number
  • UK specific
Trunk Routing Config Set Change Config Set over which the test should be run. Choose Use default to use the default value specified in the parent RVT Group, or choose Specify value and select from the list of active Config Sets.
Remote media channel Change Remote media channel to be used as a match attribute in routing tables. Click on the ellipsis symbol to the right of this field to choose ISUP or SIP, then follow the dialogs to select the appropriate channel or trunk from the list. Media channels that support only outgoing calls cannot be used to match this action and do not appear in the list.
SIP type Change This field appears only if Remote media channel specifies a SIP trunk. Set this field to indicate whether the trunk supports Basic SIP or SIP-T (to match the configuration of the selected trunk). Values:
  • Basic SIP (default)
  • SIP-T
Operator hold allowed Change This field does not appear if the Remote media channel and SIP type fields specify a Basic SIP Trunk. Specifies whether operator hold is allowed on the call. Values:
  • True
  • False
Priority call Change This field does not appear if the Remote media channel and SIP type fields specify a Basic SIP Trunk. Indicates whether the call requires priority handling. Values:
  • True
  • False
Ignore Terminating Application Server Change Specifies whether the call setup request should ignore the subscriber's Terminating Application Server, if one is configured, or should include routing to it. Values:
  • True
    Generate the call setup request without routing to the server.
  • False
    Include routing to the server as part of the generated call setup request.
Calling party number Change The calling number on the signaling message associated with the Routing request. Specify the number as a string of digits 0-9, or leave this field blank to indicate that no number is to be provided.
Calling number scope Change The area within which the calling number is unique. Values:
  • Unknown
  • International
  • National
  • Subscriber
Calling number presentation restricted Change Specifies any restrictions on presenting the calling number to the called subscriber. Values:
  • Allowed
  • Restricted
  • Number not available
  • No indication
Required retry routing Change Specifies whether alternative or continuous retry routing is required. Values:
  • Alternate routing allowed, continuous routing allowed
  • Alternate routing barred, continuous routing allowed
  • Alternate routing allowed, continuous routing barred
  • Alternate routing barred, continuous routing barred
  • Alternate routing allowed once, continuous routing allowed
  • Alternate routing allowed once, continuous routing barred
Test call Change This field does not appear if the Remote media channel and SIP type fields specify a Basic SIP Trunk. Indicates whether the call is a test call. Values:
  • True
  • False
Operator call Change This field does not appear if the Remote media channel and SIP type fields specify a Basic SIP Trunk. Specifies whether the routing request is for an operator call. Values:
  • True
  • False
Echo cancellation Change Specifies the echo cancellation requirements associated with the Routing request. Values:
  • None
  • Required
  • Preferred
User defined MF call type Change This field is valid only in the US.
Calling category Change This field appears only if the Remote media channel field specifies an ISUP Media Channel, or if the Remote media channel and SIP type fields specify a SIP-T Trunk. The type of call as indicated by the Calling Party Category parameter in the ISUP signaling flows. Values:
  • Unknown
    This value indicates that the ISUP signaling parameter explicitly states the category as unknown.
  • Ordinary calling subscriber
  • Calling subscriber with priority
  • Operator
  • Payphone
  • Test call
  • Emergency
  • High priority emergency
  • National Security and Emergency Preparedness (NS/EP)
  • OSS operator (UK only)
  • Admin Diversion - ordinary (UK only)
  • Admin Diversion - ordinary with priority (UK only)
  • Admin Diversion - payphone (UK only)
  • Admin Diversion - payphone with priority (UK only)
  • Other
    This value indicates a calling category that the MetaSwitch NE does not recognize.
Bearer capability Change This field does not appear if the Remote media channel and SIP type fields specify a Basic SIP Trunk . Specifies the bearer capability associated with the Routing request. Values:
  • Speech
  • 3.1kHz audio
  • 64kbps data
  • 64kbps restricted
  • 56kbps data
Originating exchange address Change This field does not appear if the Remote media channel and SIP type fields specify a Basic SIP Trunk. Specifies the originating exchange address (a 10-digit numeric string) associated with the Routing request. The use of this parameter depends on the Media Channel type:
  • For ISUP or SIP-T, this corresponds to the Jurisdiction parameter.
The default is no address present.
Ported number Change This field appears only if the Remote media channel and SIP type fields specify a SIP-T Trunk, or if the Remote media channel field specifies an ISUP Media Channel. Specifies the ported number associated with the Routing request. This is a 10-digit string of digits 0 - 9.
LNP lookup performed Change This field does not apply in the UK.
Release control mode Change This field does not apply in the UK.
Included media channels - media channels included Change Specifies whether to run the test as though not all of the configured media channels are available. Values:
  • All (default)
    Any configured media channel can be used in the test.
  • Specified
    Only the media channels specified in the following Included media channels - media channel fields can be used in the test.
  • All except specified
    Any media channel can be used in the test except for those specified in the following Included media channels - media channel fields.
  • None
    No media channel can be used in the test. It will complete successfully only if it is to a number on this switch and does not require trunk routing.
If this field is set to Specified or All except specified, you must set at least one of the following Included media channels - media channel fields to indicate one or more channels to be included or excluded. If you run this test and routing cannot be completed using the media channels that are permitted by the setting of these fields, the test will be marked as failed.
Included media channels - media channel 1 Change This field appears only if Included media channels - media channels included is set to Specified or All except specified. A media channel to be included or excluded when running this test. Click on the ellipsis symbol to the right of this field to choose whether to select from a list of ISUP Media Channels or SIP Trunks, then select the appropriate channel or trunk from the list. To remove the selected channel or trunk so that it is no longer included or excluded, select None.
Included media channels - media channel 2 Change This field appears only if Included media channels - media channels included is set to Specified or All except specified. A media channel to be included or excluded when running this test. If you need to select additional media channels to include or exclude, set this field as for Included media channels - media channel 1.
Included media channels - media channel 3 Change This field appears only if Included media channels - media channels included is set to Specified or All except specified. A media channel to be included or excluded when running this test. If you need to select additional media channels to include or exclude, set this field as for Included media channels - media channel 1.
Included media channels - media channel 4 Change This field appears only if Included media channels - media channels included is set to Specified or All except specified. A media channel to be included or excluded when running this test. If you need to select additional media channels to include or exclude, set this field as for Included media channels - media channel 1.
Included media channels - media channel 5 Change This field appears only if Included media channels - media channels included is set to Specified or All except specified. A media channel to be included or excluded when running this test. If you need to select additional media channels to include or exclude, set this field as for Included media channels - media channel 1.
Included media channels - media channel 6 Change This field appears only if Included media channels - media channels included is set to Specified or All except specified. A media channel to be included or excluded when running this test. If you need to select additional media channels to include or exclude, set this field as for Included media channels - media channel 1.
Included media channels - media channel 7 Change This field appears only if Included media channels - media channels included is set to Specified or All except specified. A media channel to be included or excluded when running this test. If you need to select additional media channels to include or exclude, set this field as for Included media channels - media channel 1.
Included media channels - media channel 8 Change This field appears only if Included media channels - media channels included is set to Specified or All except specified. A media channel to be included or excluded when running this test. If you need to select additional media channels to include or exclude, set this field as for Included media channels - media channel 1.
Included media channels - media channel 9 Change This field appears only if Included media channels - media channels included is set to Specified or All except specified. A media channel to be included or excluded when running this test. If you need to select additional media channels to include or exclude, set this field as for Included media channels - media channel 1.
Included media channels - media channel 10 Change This field appears only if Included media channels - media channels included is set to Specified or All except specified. A media channel to be included or excluded when running this test. If you need to select additional media channels to include or exclude, set this field as for Included media channels - media channel 1.
Included media channels - simulated incoming release cause Change Specifies whether to run the test as though it is a re-routing attempt because an earlier attempt to route the call over an ISUP trunk failed. In general you should use this field in conjunction with the earlier Included media channels fields to exclude the trunk on which the earlier routing attempt would have failed. The valid values for this field, except for None and Use values on Test Group, are a subset of those defined in Q.850; the other values defined in Q.850 identify release causes for which re-routing is not appropriate, or are not appropriate to ISUP trunks. Values:
  • None
    Run the test as though there is no release cause specified (for example on the first pass through routing).
  • 2 No route to specified transit network (national use)
  • 3 No route to destination
  • 34 No circuit / channel available
  • 41 Temporary failure
  • 42 Switching equipment congestion
  • 43 Access information discarded
  • 44 Requested circuit / channel not available
  • 46 Precedence call blocked
  • 47 Resource unavailable, unspecified
  • 58 Bearer capacity not presently available
  • 62 Inconsistency in outgoing information element
  • 63 Service or option not available, unspecified
  • 65 Bearer capability not implemented
  • 69 Requested facility not implemented
  • 70 Only restricted digital info bearer capability available
  • 79 Service option not implemented, unspecified
  • 88 Incompatible destination
  • 95 Invalid message, unspecified
  • 97 Message type non-existent or not implemented
  • 99 Info element / parameter non-existent or not implemented
  • 102 Recovery on timer expiry
  • 103 Parameter non-existent or not implemented - passed on
  • 111 Protocol error, unspecified
  • 127 Interworking, unspecified
  • Use values on Test Group
    Use the simulated incoming release cause, if any, specified on the parent Route Verification Test Group.
Test result Read only This field is valid only after the test has been run. To run the test, click on the 'Run test' pushbutton. This field indicates the status of the last test run. Note that if any of the previous fields have been modified since the last test was run, this field will be set to Not yet run. Values:
  • Not yet run
    The test has not been run yet, or one of more of the previous fields has changed since the test was last run.
  • Result pending
    The test is in progress.
  • Succeeded
    The test has run, and both the number validation and the routing succeeded.
  • Identified Call Service access code
    The test has run, and the routing component has identified the number dialed as a call service access code.
  • Not able to run
    The test was not able to run because the routing component is not in a suitable state to route requests.
  • Failed - number validation
    The test was run and number validation failed.
  • Failed - routing
    The test was run and routing failed.
  • Called number not found
    The routing component has determined that the call should be routed to a subscriber on this switch, but the subscriber does not exist.
  • System not fully active
    The test cannot be run because the system is not fully set up.
  • Canceling
    The test is in the process of being canceled, either because an administrator used the "Cancel all tests" action in the parent Route Verification Test Group object or because one or more test values were changed.
  • Canceled
    The test was canceled.
Cause of failure Read only This field is valid only if Test result is set to Failed - number validation or Failed - routing. This field specifies the cause for either the number validation or routing failure. Values:
  • None
  • Incomplete digits
  • Address incomplete
  • Configuration inconsistent
  • Incomplete digit map
  • Number validation failed
  • Routing failed
  • Address not valid
  • Transit not valid
  • No route to address
  • No route to transit
  • Maximum number of routes tried
  • No route to address (congestion)
  • No route to transit (congestion)
  • LNP call misrouted
  • Unallocated number
  • Internal routing error
  • Temporary failure
  • Resource shortage
  • Call rejected
Expected result - expected result Change Specifies whether you expect this test to succeed or fail, and the failure mode if appropriate. Values:
  • Use values on Test Group (default)
    Use the default Expected results values specified on the parent Route Verification Test Group.
  • None
  • Succeeded
  • Identified Call Service access code
  • Failed - number validation
  • Failed - routing
  • Called number not found
  • Query failed
Expected result - expected destination Change This field appears only if Expected result - expected result is Succeeded. Specifies the destination or range of destinations to which you expect this test to route. Values:
  • Any media channel or on-switch subscriber (default)
    The test should be regarded as passed regardless of the chosen destination.
  • One of specified media channels
    The test should be regarded as passed only if it routes to a media channel specified in the following Expected results - media channel fields.
  • Any media channel except specified
    The test should be regarded as passed if it does not to a media channel specified in the following Expected results - media channel fields.
  • On-switch subscriber
    The test should be regarded as passed only if it routes to a subscriber on this switch.
Expected result - media channel 1 Change This field appears only if Expected results - expected destination is One of specified media channels or Any media channel except specified. A media channel considered to be valid or not valid for this test. Click on the ellipsis symbol to the right of this field to choose whether to select from a list of ISUP Media Channels or SIP Trunks, then select the appropriate channel or trunk from the list. To remove the selected channel or trunk so that it is no longer considered to be valid or not valid, select None.
Expected result - media channel 2 Change This field appears only if Expected result - expected destination is One of specified media channels or Any media channel except specified. A media channel considered to be valid or not valid for this test. If you need to select additional media channels considered to be valid or not valid for tests in this group, set this field as for Expected result - media channel 1.
Expected result - media channel 3 Change This field appears only if Expected result - expected destination is One of specified media channels or Any media channel except specified. A media channel considered to be valid or not valid for this test. If you need to select additional media channels considered to be valid or not valid for this test, set this field as for Expected result - media channel 1.
Expected result - media channel 4 Change This field appears only if Expected result - expected destination is One of specified media channels or Any media channel except specified. A media channel considered to be valid or not valid for this test. If you need to select additional media channels considered to be valid or not valid for this test, set this field as for Expected result - media channel 1.
Expected result - media channel 5 Change This field appears only if Expected result - expected destination is One of specified media channels or Any media channel except specified. A media channel considered to be valid or not valid for this test. If you need to select additional media channels considered to be valid or not valid for this test, set this field as for Expected result - media channel 1.
Expected result - media channel 6 Change This field appears only if Expected result - expected destination is One of specified media channels or Any media channel except specified. A media channel considered to be valid or not valid for this test. If you need to select additional media channels considered to be valid or not valid for this test, set this field as for Expected result - media channel 1.
Expected result - media channel 7 Change This field appears only if Expected result - expected destination is One of specified media channels or Any media channel except specified. A media channel considered to be valid or not valid for this test. If you need to select additional media channels considered to be valid or not valid for this test, set this field as for Expected result - media channel 1.
Expected result - media channel 8 Change This field appears only if Expected result - expected destination is One of specified media channels or Any media channel except specified. A media channel considered to be valid or not valid for this test. If you need to select additional media channels considered to be valid or not valid for this test, set this field as for Expected result - media channel 1.
Expected result - media channel 9 Change This field appears only if Expected result - expected destination is One of specified media channels or Any media channel except specified. A media channel considered to be valid or not valid for this test. If you need to select additional media channels considered to be valid or not valid for this test, set this field as for Expected result - media channel 1.
Expected result - media channel 10 Change This field appears only if Expected result - expected destination is One of specified media channels or Any media channel except specified. A media channel considered to be valid or not valid for this test. If you need to select additional media channels considered to be valid or not valid for this test, set this field as for Expected result - media channel 1.
Expected result - cause of failure Change This field appears only if Expected result - expected result is Failed - number validation or Failed - routing. The expected cause for either the number validation or routing failure. Values:
  • None
  • Incomplete digits
  • Address incomplete
  • Configuration inconsistent
  • Incomplete digit map
  • Number validation failed
  • Routing failed
  • Address not valid
  • Transit not valid
  • No route to address
  • No route to transit
  • Maximum number of routes tried
  • No route to address (congestion)
  • No route to transit (congestion)
  • LNP call misrouted
  • Unallocated number
  • Internal routing error
  • Temporary failure
  • Resource shortage
  • Call rejected
Expected result - result as expected Read only This field does not appear if Expected result - expected result is None, or if it is Use values on Test Group and the parent Test Group's value is None. Indicates whether the result of the last run of this test matched the expected result. Values:
  • Yes
  • No
  • Not yet run to completion
    The test has not been run to completion since its configuration parameters were last changed.
Number validation - modified called number Read only The modified called number specified on the output from number validation.
Number validation - modified calling party number Read only The modified calling party number specified on the output from number validation.
Number validation - call hold allowed Read only Whether the output from number validation specifies that holding the call is allowed. Values:
  • True
  • False
Number validation - release control mode Read only The release control mode for the call specified on the output from number validation. Values: Values:
  • Calling party
  • Called party
  • Last party
Number validation - test call Read only Whether the output from number validation specifies that the call is a test call. Values:
  • True
  • False
Number validation - tone or announcement ID Read only The tone or announcement ID specified on the output from number validation.
Number validation - tone or announcement parameter 1 Read only The tone or announcement parameter 1 specified on the output from number validation.
Number validation - tone or announcement parameter 2 Read only The tone or announcement parameter 2 specified on the output from number validation.
Number validation - echo cancellation Read only Whether the output from number validation specifies that echo cancellation is required for the call. Values:
  • None
  • Preferred
  • Required
Number validation - user defined attribute 1 - 20 Read only This field appears once for each User Defined Attribute that you have configured below the Trunk Routing and Policy Services object. The user defined attributes specified on the output from number validation.
Number validation - message billing index Read only The message billing index specified on the output from number validation.
Number validation - billing call type Read only The billing call type attribute, if any, specified on the output from number validation. Values:
  • 1
  • 5
  • 6
  • 9
  • 33
  • 47
  • 88
  • 110
  • 119
  • 131
  • 132
  • 134
  • 141
  • 142
  • 710
  • 711
  • 720
  • 721
  • 800 - 999
Number validation - billing structure code Read only The billing structure code attribute, if any, specified on the output from number validation. Values:
  • 1
  • 20
  • 28
  • 79
  • 220
  • 360
  • 364
  • 500
  • 625
  • 653
Number validation - calling category Read only The calling category, if any, specified on the output from number validation. Values:
  • Unknown
    This value indicates that the ISUP signaling parameter explicitly states the category as unknown.
  • Ordinary calling subscriber
  • Calling subscriber with priority
  • Operator
  • Payphone
  • Test call
  • Emergency
  • High priority emergency
  • National Security and Emergency Preparedness (NS/EP)
  • OSS operator (UK only)
  • Admin Diversion - ordinary (UK only)
  • Admin Diversion - ordinary with priority (UK only)
  • Admin Diversion - payphone (UK only)
  • Admin Diversion - payphone with priority (UK only)
  • Other
    This value indicates a calling category that the MetaSwitch NE does not recognize.
Number validation - called address scope Read only The called address scope, if any, specified on the output from number validation. Values:
  • Unknown
  • International
  • National
  • Network specified
  • Subscriber
  • Abbreviated
  • Reserved 1
  • 950 Plus
  • No number
  • UK specific
Number validation - maximum call duration Read only The maximum call duration, if any, specified on the output from number validation.
Number validation - outgoing release cause Read only The outgoing release cause, if any, specified on the output from number validation. For a full list of the valid values, see the Attribute value - outgoing ISUP/ISDN release cause field in the Attribute Entry object.
Routing - test call Read only Whether the output from the routing step specifies that the call is a test call. Values:
  • True
  • False
Routing - modified called number Read only The modified called number specified on the output from the routing step.
Routing - modified calling party number Read only The modified calling party number specified on the output from the routing step.
Routing - operator call Read only Whether the output from the routing step specifies that the call is an operator call. Values:
  • True
  • False
Routing - routing control Read only Whether the output from the routing step specifies that alternative or continuous retry routing is required. Values:
  • Alternate routing allowed, continuous routing allowed
  • Alternate routing barred, continuous routing allowed
  • Alternate routing allowed, continuous routing barred
  • Alternate routing barred, continuous routing barred
  • Alternate routing allowed once, continuous routing allowed
  • Alternate routing allowed once, continuous routing barred
Routing - tone or announcement ID Read only The tone or announcement ID specified on the output from the routing step.
Routing - tone or announcement parameter 1 Read only The tone or announcement parameter 1 specified on the output from the routing step.
Routing - tone or announcement parameter 2 Read only The tone or announcement parameter 2 specified on the output from the routing step.
Routing - media channel Read only This field is valid only if the routing step was successful. Specifies the media channel over which the call is to be routed.
Routing - on-switch subscriber type Read only This field is valid only if the routing step was successful and the Routing - media channel field indicates that the call is routed to another subscriber on this switch. Specifies the type of subscriber to which the call is to be routed. Values:
  • Individual Line
  • Business Group
  • Voicemail System
  • PBX
Routing - on-switch subscriber number Read only This field is valid only if the routing step was successful and the Routing - media channel field indicates that the call is routed to another subscriber on this switch. Specifies the directory number to which the call is to be routed.
Routing - echo cancellation Read only Whether the output from the routing step specifies that echo cancellation is required for the call. Values:
  • None
  • Preferred
  • Required
Routing - maximum call duration Read only The maximum call duration, if any, specified on the output from the routing step.
Diagnostics - logging - log level Change Specifies the level of logs recorded for this object. Logs with a priority equal to or greater than the priority specified are recorded. Set to Default level to use the system-wide default level. Values:
  • Level 10 (diagnostics)
  • Level 20 (verbose statistics)
  • Level 30 (verbose operational)
  • Level 40 (statistics)
  • Level 50 (audit)
  • Level 60 (operational)
  • Level 70 (unexpected)
  • Level 80 (error)
  • Level 90 (fatal)
  • Default level (default)
Diagnostics - API trace - trace tag Change An optional diagnostics tag inserted into API tracing and PD logging for this object. This tag may include any ASCII characters. However, if you want to filter on this tag in the craft interface, do not include spaces or any of the characters ^ \ $ * + ? | ( ) , . ` ' " [ ] { }.
Requested status Read only Specifies whether an administrator has attempted to enable the Trunk Route Verification Test. Values:
  • Enabled
    The object has been enabled.
  • Disabled
    The object has not been enabled or has been disabled.
Actual status Read only Specifies the current status of the Trunk Route Verification Test object. Values:
  • Enabled
    The object is enabled.
  • Disabled
    The object has not been enabled or has been disabled.