Number Validation Entry

Each Number Validation Entry object is a child of a Number Validation Table object.

Each Number Validation Entry specifies a (wildcard) number and a series of attribute values against which the current routing request is matched. If the Number Validation Entry is determined to be the best match, other fields specify how the routing request should be manipulated and the next step in the number validation process.


Note that when the grandparent Config Set is active, this object cannot be modified; all fields are read only and all actions are disabled. You must deactivate the grandparent Config Set before you can modify the object.


Parameter

Access

Description
Number Validation Entry name Change Unique user-friendly name identifying the Number Validation Entry. Specify a name of up to 64 characters. If a name is not specified, the EMS displays a default.
Number Change String of explicit and wildcard digits expressing the form of a matching dialed number (or a matching calling number if the parent Number Validation Table has Address match type set to Source). Specify a string of up to 32 characters. Note that the . (period) character is not a valid wildcard character in this string; it is used only in digit maps.
Minimum match length Change Minimum number of digits in the dialed number (or calling number) that must be matched before this entry in the validation table can be matched. Note that a unique match within the table is always required. The default is 0. Range: 0 - 32
Routing Attribute Set Change Attribute Set specifying attributes to append to the routing request if this Number Validation Entry has been matched. Select from the displayed list of currently enabled Attribute Sets in the same Config Set as this Number Validation Entry. If you select Default, the value specified in the Default Routing Attribute Set field of the parent Number Validation Table is used. As a short-cut to select the Attribute Set, you can type match details into the field and click on the search button to select from a list of items that match these details. Match details can be a text string, a wildcard string such as B*, a range such as CA-FL, an index value such as =3, or an index range such as =1-20. For more details, refer to the description of the Details panel in Operations Manual: Overview.
Next action Change Action to be taken when this Number Validation Entry is matched. If you select Use default, the value specified in the Default match action field of the parent Number Validation Table is used. Values:
  • Use default (default)
  • Complete validation
    Complete number validation processing.
  • Look up
    After applying the number actions and updating any attributes, look up the number in another validation table (specified in the following field.)
  • Reject and announce
    Stop number validation processing and play the appropriate error announcement.
  • Store carrier ID and restart
    Store the supplied Carrier ID and restart number validation.
  • Store carrier ID and look up
    Store the supplied Carrier ID. Then, after applying the number actions and updating any attributes, look up the number in another validation table (specified in the following field.)
  • Handle as SAC
    Mark as a call to a service access code and finish routing.
  • Fail ANI screening (North America only)
    Reject the call with an announcement that the carrier code is not valid.
Next Number Validation Table Change This field appears only if Next action is set to Look up or Store carrier ID and look up. Specifies the next Number Validation Table to process; select from the displayed list. As a short-cut to select the Number Validation Table, you can type match details into the field and click on the search button to select from a list of items that match these details. Match details can be a text string, a wildcard string such as B*, a range such as CA-FL, an index value such as =3, or an index range such as =1-20. For more details, refer to the description of the Details panel in Operations Manual: Overview.
Use number for billing Change Specifies whether the current number, as was used to matched this Number Validation Entry, should be used as the telephone number in billing records for this call (truncated or padded to 10 digits to suit the billing record format). This ensures that the call is billed to the current number, even if the number associated with the call is subsequently changed by a Number action (in either this Number Validation Entry or a later one) or by an AIN query. Values:
  • True
  • False (default)
Number action - called number action Change This field appears only if the Address match type field in the parent Number Validation Table is set to Destination. A character string specifying the editing actions to be applied to the dialed number when this row is matched. The syntax of this string is described in Number Actions below. Specify a string of up to 32 characters.
Number action - calling party number action Change This field appears only if the Address match type field in the parent Number Validation Table is set to Source. A character string specifying the editing actions to be applied to the calling party number when this row is matched. The syntax of this string is described in Number Actions below. Specify a string of up to 32 characters.
Number action - charge number action Change This field appears only if the Address match type field in the parent Number Validation Table is set to Source. A character string specifying the editing actions to be applied to the charge number when this row is matched. The syntax of this string is described in Number Actions below. Specify a string of up to 32 characters.
Attribute value - billing type match Change This field appears only if one of the Match attribute fields of the parent Number Validation Table is set to Billing type. Specifies how to match on the billing type attribute. Values:
  • Exact
  • Match any if present (default)
  • Match even if not present
  • Only match if absent
Attribute value - billing type Change This field appears only if Attribute value - billing type match is visible and set to Exact. Specifies the value of the billing type (determined from the originating subscriber's configuration) that matches this entry. Values:
  • Flat rate (default)
  • Message rate
  • FX rate
Attribute value - called address complete match Change This field appears only if one of the Match attribute fields of the parent Number Validation Table is set to Called address complete. Specifies how to match on the called address complete attribute. Values:
  • Exact
  • Match any if present (default)
  • Match even if not present
  • Only match if absent
Attribute value - called address complete Change This field appears only if Attribute value - called address complete match is visible and set to Exact. Specifies the value of the called address complete attribute that matches this entry. Values:
  • No
  • Yes (default)
Attribute value - called address scope match Change This field appears only if one of the Match attribute fields of the parent Number Validation Table is set to Called address scope. Specifies how to match on the called address scope attribute. Values:
  • Exact
  • Match any if present (default)
  • Match even if not present
  • Only match if absent
Attribute value - called address scope Change This field appears only if Attribute value - called address scope match is visible and set to Exact. Specifies the value of the called address scope attribute that matches this entry. Values:
  • Unknown (default)
  • International
  • National
  • Subscriber
  • No number
  • UK specific
Attribute value - FGD prefix dialed match Change This field appears only if one of the Match attribute fields of the parent Number Validation Table is set to FGD prefix dialed. Specifies how to match on the FGD prefix dialed attribute. Values:
  • Exact
  • Match any if present (default)
  • Match even if not present
  • Only match if absent
Attribute value - FGD prefix dialed Change This field appears only if Attribute value - FGD prefix dialed match is visible and set to Exact. Specifies the value of the FGD prefix dialed attribute (whether an FGD carrier ID has been prefixed to the number) that matches this entry. Values:
  • No (default)
  • Yes
Attribute value - operator call match Change This field appears only if one of the Match attribute fields of the parent Number Validation Table is set to Operator call. Specifies how to match on the operator call attribute. Values:
  • Exact
  • Match any if present (default)
  • Match even if not present
  • Only match if absent
Attribute value - operator call Change This field appears only if Attribute value - operator call match is visible and set to Exact. Specifies the value of the operator call attribute (whether or not the call should be treated as an operator call) that matches this entry. Values:
  • No (default)
  • Yes
Attribute value - Subscriber Group match Change This field appears only if one of the Match attribute fields of the parent Number Validation Table is set to Subscriber Group. Specifies how to match on the subscriber group attribute. Values:
  • Exact
  • Match any if present (default)
  • Match even if not present
  • Only match if absent
Attribute value - Subscriber Group Change This field appears only if Attribute value - Subscriber Group match is visible and set to Exact. Specifies the value of the Subscriber Group attribute that matches this entry.
  • For calls originating on the switch, this indicates the Subscriber Group with which the calling party is associated.
  • For calls originating at a different exchange, this attribute is set to zero.
The value of this attribute determines which Digit Map is used, and may be involved in number validation and routing decisions. Select from the list of configured Subscriber Groups.
Attribute value - CIP match Change This field appears only if one of the Match attribute fields of the parent Number Validation Table is set to CIP. Specifies how to match on the Carrier Identification Parameter (CIP) attribute. Values:
  • Exact
  • Match even if not present (default)
  • Match any if present
  • Only match if absent
Attribute value - CIP Change This field appears only if Attribute value - CIP match is visible and set to Exact. Specifies the value of the CIP attribute that matches this entry. Specify the CIP as a 4-digit number (with leading zeros if necessary).
Attribute value - Incoming Media - Signaling Stack match Change This field appears only if one of the Match attribute fields of the parent Number Validation Table is set to Incoming Media. Specifies how to match on the Incoming Media - Signaling Stack attribute. Values:
  • Exact
  • Match any if present (default)
  • Match even if not present
  • Only match if absent
Attribute value - Incoming Media - Signaling Stack Change This field appears only if Attribute value - Incoming Media - Signaling Stack match is visible and set to Exact. Specifies the value of the Incoming Media - Signaling Stack attribute that matches this entry. Values:
  • ISUP
  • MF
  • ISDN
  • SIP
Attribute value - Incoming Media - ISUP Local Signaling Destination Change This field appears only if Attribute value - Incoming Media - Signaling Stack is visible and set to ISUP. Specifies the value of the Incoming Media - ISUP Local Signaling Destination attribute that matches this entry. Select from the list of ISUP Local Signaling Destinations that are associated with a valid Signaling Gateway.
Attribute value - Incoming Media - Adjacent Exchange match Change This field appears only if Attribute value - Incoming Media - Signaling Stack match is visible and set to MF or ISUP. Specifies how to match on the Incoming Media - Adjacent Exchange attribute. Values:
  • Exact
  • Match any if present (default)
  • Match even if not present
  • Only match if absent
Attribute value - Incoming Media - Adjacent Exchange Change This field appears only if Attribute value - Incoming Media - Adjacent Exchange match is visible and set to Exact. Specifies the value of the Incoming Media - Adjacent Exchange attribute that matches this entry. Select from the list of configured MF Remote Exchanges or ISUP Remote Signaling Destinations.
Attribute value - Incoming Media - Media Channel match Change This field appears only if Attribute value - Incoming Media - Signaling Stack is visible and set to ISDN or SIP, or if Attribute value - Incoming Media - Adjacent Exchange is visible. Specifies how to match on the Incoming Media - Media Channel attribute. Values:
  • Exact
  • Match any if present (default)
  • Match even if not present
  • Only match if absent
Attribute value - Incoming Media - Media Channel Change This field appears only if Attribute value - Incoming Media - Media Channel match is visible and set to Exact. Specifies the value of the Media Channel attribute that matches this entry. Select from the list of Media Channels configured for the selected ISUP Remote Signaling Destination, Media Channels configured for the selected MF Remote Exchange, ISDN trunk PRIs, or SIP Trunks (depending on the value of Attribute value - Incoming Media - Signaling Stack). Media channels and ISDN PRIs that support only outgoing calls cannot be used for matching on this attribute and do not appear in the list.
Attribute value - originating Signaling Gateway match Change This field appears only if one of the Match attribute fields of the parent Number Validation Table is set to Originating Signaling Gateway. Specifies how to match on the Incoming Media - originating Signaling Gateway attribute. Values:
  • Exact
  • Match any if present (default)
  • Match even if not present
  • Only match if absent
Attribute value - originating Signaling Gateway Change This field appears only if Attribute value - originating Signaling Gateway match is visible and set to Exact. Specifies the value of the Signaling Gateway attribute that matches this entry. This attribute specifies the MetaSwitch Signaling Gateway at which the call originated (in the case where the MetaSwitch NE includes two or more Signaling Gateways to support different point codes).
  • For calls from subscribers on the switch, the value is taken from the Subscriber Group configuration.
  • For calls received over SS7, the value is taken from the signaling gateway on which the ISUP IAM was received.
  • For other calls, the signaling gateway is not initially specified. If required, you can set it during number validation using the Signaling Gateway attribute.
Select from the list of configured Signaling Gateways.
Attribute value - ANI II digits match Change This field appears only if one of the Match attribute fields of the parent Number Validation Table is set to ANI II digits. Specifies how to match on the ANI II digits attribute. Values:
  • Exact
  • Match any if present (default)
  • Match even if not present
  • Only match if absent
Attribute value - ANI II digits Change This field appears only if Attribute value - ANI II digits match is visible and set to Exact. Specifies the value of the ANI II digits attribute that matches this entry. Specify a value in the range 0 - 99. The default is 0.
Attribute value - US Call Type match Change This field appears only if one of the Match attribute fields of the parent Number Validation Table is set to US Call Type. Specifies how to match on the US Call Type attribute. Values:
  • Exact
  • Match any if present (default)
  • Match even if not present
  • Only match if absent
Attribute value - US Call Type Change This field appears only if Attribute value - US Call Type match is visible and set to Exact. Specifies the value of the US Call Type attribute that matches this entry. Values:
  • Unknown (default)
  • Operator
  • Emergency
  • Local
  • IntraLata
  • IntraLata national
  • IntraLata international
  • Toll Free
  • Premium
  • Other non-geographic
  • Operator Service
  • Directory Assist
  • FGD cut through
  • FGB
  • International toll free
  • Other N11
  • International
  • Other
Attribute value - UK Call Type match Change This field is valid only in the UK.
Attribute value - UK Call Type Change This field is valid only in the UK.
Attribute value - Dialed Prefix match Change This field appears only if one of the Match attribute fields of the parent Number Validation Table is set to Dialed Prefix. Specifies how to match on the Dialed Prefix attribute. Values:
  • Exact
  • Match any if present (default)
  • Match even if not present
  • Only match if absent
Attribute value - Dialed Prefix Change This field appears only if Attribute value - Dialed Prefix match is visible and set to Exact. Specifies the value of the Dialed Prefix attribute that matches this entry. Values:
  • Unknown (default)
  • 1+
  • 0-
  • 0+
  • None
Attribute value - Dialing Pattern match Change This field appears only if one of the Match attribute fields of the parent Number Validation Table is set to Dialing Pattern. Specifies how to match on the Dialing Pattern attribute. Values:
  • Exact
  • Match any if present (default)
  • Match even if not present
  • Only match if absent
Attribute value - Dialing Pattern Change This field appears only if Attribute value - Dialing Pattern match is visible and set to Exact. Specifies the value of the Dialing Pattern attribute that matches this entry. Values:
  • 7 digits (default)
  • 10 digits
  • 0+10 digits
  • 1+10 digits
  • Other
Attribute value - User Defined 1 - 20 match Change This field appears only if one of the Match attribute fields of the parent Number Validation Table is set to one of the values User Defined 1 - User Defined 20. If you have selected two or more User Defined Attributes as match attributes, this field appears once for each selected attribute. Indicates how to match on a User Defined Attribute. Select one of the following values.
  • Exact
  • Match any if present (default)
  • Match even if not present
  • Only match if absent
Attribute value - User Defined 1 - 20 Change This field appears only if Attribute value - User Defined 1 - 20 match is set to Exact. If you have selected two or more User Defined Attributes as match attributes, this field appears once for each selected attribute. Specifies the value of the User Defined Attribute that matches this entry. Specify an integer value in the range 0 - 2147483646.
Attribute value - Line Class Code 1 - 20 match Change This field appears only if one of the Match attribute fields of the parent Number Validation Table is set to one of the values Line Class Code 1 - Line Class Code 20. The field name indicates LCC n - description (showing the index value in the range 1-20 and the configured description, if any). Indicates how to match on a Line Class Code value defined for the subscriber associated with the Routing request. Select one of the following values.
  • Exact
  • Match any if present (default)
  • Match even if not present
  • Only match if absent
Attribute value - Line Class Code 1 - 20 Change This field appears only if Attribute value - Line Class Code 1 - 20 match is set to Exact. The field name indicates LCC n - description (showing the index value in the range 1-20 and the configured description, if any). Indicates the Line Class Code associated with the Routing request. Specify the Line Class Code as an integer value in the range 0 - 2147483646. Alternatively, if one or more valid values have been configured in the Line Class Code object, you can select one of these values by clicking on the ellipsis symbol at the end of the field. Either scroll down the alphabetic list of code value descriptions to select the value you want, or type the first few letters of the code's description so that the alphabetic list scrolls to select the entry you want.
Attribute value - User defined MF call type match Change This field appears only if one of the Match attribute fields of the parent Number Validation Table is set to User defined MF call type. Indicates how to match on the User defined MF call type value associated with the Routing request (which is available only for calls that came into the NE over MF, and is set up in the MF Incoming Call Profile). Select one of the following values.
  • Exact
  • Match any if present (default)
  • Match even if not present
  • Only match if absent
Attribute value - User defined MF call type Change This field appears only if Attribute value - User defined MF call type match is set to Exact. Indicates the User defined MF call type associated with the Routing request. Specify the call type as an integer value in the range 0 - 4294967295.
Attribute value - ANI Screening Entry match Change This field appears only if one of the Match attribute fields of the parent Number Validation Table is set to ANI Screening Entry. Indicates how to match on the ANI Screening Entry associated with the Routing request. Select one of the following values.
  • Exact
  • Match any if present (default)
  • Match even if not present
  • Only match if absent
Attribute value - ANI Screening Entry Change This field appears only if Attribute value - ANI Screening Entry match is set to Exact. Indicates the type of ANI Screening Entry, if any, associated with the Routing request. Values:
  • Not matched (default)
  • Allowed
  • Denied
Attribute value - ANI Screening Lookup match Change This field appears only if one of the Match attribute fields of the parent Number Validation Table is set to ANI Screening Lookup. Indicates how to match on the ANI Screening Lookup type associated with the Routing request. Select one of the following values.
  • Exact
  • Match any if present (default)
  • Match even if not present
  • Only match if absent
Attribute value - ANI Screening Lookup Change This field appears only if Attribute value - ANI Screening Lookup match is set to Exact. Indicates the type of ANI Screening Lookup, if any, associated with the Routing request. Values:
  • None (default)
  • Lookup on carrier code (North America only)
  • Lookup in specific table
Attribute value - Transit Network ID match Change This field appears only if one of the Match attribute fields of the parent Number Validation Table is set to Transit Network ID. Indicates how to match on the Transit Network ID associated with the Routing request. Select one of the following values.
  • Exact
  • Match any if present (default)
  • Match even if not present
  • Only match if absent
Attribute value - Transit Network ID Change This field appears only if Attribute value - Transit Network ID match is set to Exact. Indicates the Transit Network ID associated with the Routing request. Specify a value in the range 0 - 9999.
Attribute value - ESA Status match Change This field appears only if one of the Match attribute fields of the parent Number Validation Table is set to ESA Status. Indicates how to match on the Emergency Standalone (ESA) status associated with the Routing request. This allows you to perform number validation and routing differently during ESA operation; for example, you could reject calls to numbers that cannot be contacted using ESA, or reroute calls to use only the trunks that are available during ESA operation. Select one of the following values.
  • Specific ESA in control
  • Any ESA in control (default)
  • Any
  • Main Call Agent in control
Attribute value - controlling ESA Protection Domain Change This field appears only if Attribute value - ESA Status match is set to Specific ESA in control. Indicates the ESA Protection Domain associated with the Routing request. Select from the drop-down list of configured ESA Protection Domains.
Attribute value - subscriber NV and routing attributes match Change This field appears only if one of the Match attribute fields of the parent Number Validation Table is set to Subscriber NV and routing attributes. Specifies how to match on the subscriber routing attributes. Values:
  • Exact
  • Match any if present (default)
  • Match even if not present
  • Only match if absent
Attribute value - subscriber NV and routing attributes Change This field appears only if Attribute value - Subscriber NV and routing attributes match is visible and set to Exact. Specifies the values of the subscriber routing attributes that match this entry. Select one or more of the following values:
  • Pre-paid / off-switch calling card subscriber
  • Fax / modem subscriber
  • Nomadic subscriber
Requested status Read only Specifies whether an administrator has attempted to enable the Number Validation Entry. 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 Number Validation Entry. Values:
  • Enabled
    The object has been enabled.
  • Disabled
    The object has not been enabled or has been disabled.

Number Actions

The Number action - called number action, Number action - calling party number action and Number action - charge number parameters in the Number Validation Entry object provides a mechanism for editing the specified number.

The parameter consists of a character string specifying one or more edit actions to be applied to the number. Valid edit actions are:

PAdigits Add a prefix to the number. The characters PA are followed immediately by the digit(s) to be added as a prefix.
PDcount Delete a prefix from the number. The characters PD are followed immediately by the count of digits to be deleted from the start of the number.
SDcount Delete a suffix from the number. The characters SD are followed immediately by the count of digits to be deleted from the end of the number.
SD# Delete a trailing # character from the number, if present. No action if the last character of the number is not #.
Rdigits Replace the complete number. The character R is followed immediately by the new digit string to replace the number.

The action string can contain two or more actions, which are executed in the order specified, so that the second acts on the modified number resulting from the first. Note that the Replace action cannot follow any other action because this would destroy the effect of the earlier action.

Examples of changes to the called number: