ANI Screening Entry

The ANI Screening Entry object defines an ANI value, or a range of ANI values identified by a prefix, for which long-distance calls are permitted or denied.

Most of the fields in this object (except for the Export fields) provide subscriber configuration parameters that are used for subscribers making long-distance calls (overriding the codes defined for on-switch subscribers if applicable). These fields do not appear if Entry type is set to Denied.

The ANI Screening Entry object is a child of the ANI Screening Table object.


Parameter

Access

Description
ANI Create A digit string specifying the ANI that matches this entry. If the parent ANI Screening Table specifies a fixed number of ANI digits, the length of this digit string must match the specified length. The digit string can be one of the following.
  • An exact match entry, consisting of a string of digits 0-9 and A-D identifying a valid ANI.
  • A prefix entry, containing one or more digits 0-9 and A-D followed by one or more of the wildcard digit X (which can match any of these digits). The total length of the digit string must be the same as the length of a valid ANI, so that the specific digits at the start act as a prefix for numbers of the specified length.
Entry type Change Specifies whether an ANI matching this entry is allowed or denied long-distance service. Values:
  • Allowed (default)
  • Denied
Charge number Change The 10-digit directory number to which calls matching this entry are billed. If this field is left blank, calls are billed to the subscriber's charge number or directory number (for a call originating on this switch), or to the charge number that was signaled on the incoming call. Note that this parameter is used only in billing records for the call; it does not change the charge number parameter, if any, sent on signaling messages for outgoing calls.
Description Change An optional text string of up to 64 characters describing this ANI Screening Entry.
Long Distance Service Class Change The Long Distance Service Class that applies to calls matching this entry. Click on the ellipsis symbol at the end of the field to select from the configured Long Distance Service Classes.
Service suspended Change Specifies whether long-distance service for subscribers matching this entry is currently suspended (the subscribers are prevented from making or receiving calls). You can use this field to suspend service temporarily without removing the ANI Screening Entry. Values:
  • True
  • False (default)
Locale Change The language variant used for voice announcements played to subscribers matching this entry. When you create a new ANI Screening Entry, this defaults to the locale specified in the parent ANI Screening Table, but you can override this setting if required. Values:
  • English (US)
  • English (UK)
  • English (Canadian)
  • French (Canadian)
  • User Defined 1
  • User Defined 2
Number Validation and routing attributes Change Attributes used to determine how a call made by the subscriber is routed to the network. If required, select one or more of the following values:
  • Pre-paid / off-switch calling card subscriber
    The subscriber uses a pre-paid or off-switch calling card service. The NE must check with an external pre-paid billing platform before routing the call, to ensure that the subscriber is permitted to make this type of call.
  • Fax / modem subscriber
    The subscriber can make fax or modem calls (for which compression should not be used) in addition to standard voice calls. This attribute is typically used to route calls for this subscriber over TDM trunks (such as ISUP) in preference to SIP trunks.
Mandatory Account Codes - Subscribed Change Specifies whether subscribers matching this entry are subscribed to Mandatory Account Codes. (This service requires the use of account codes on outgoing calls, to provide information on how call charges should be allocated.) Values:
  • True
  • False (default)
Mandatory Account Codes - table Change This field appears only if Mandatory Account Codes - Subscribed is True. The Mandatory Account Code Table used by subscribers matching this entry. Select from the list of configured tables, or type in the index of the required table.
Mandatory Account Codes - blocked Change This field appears only for an exact match entry (not a prefix), and only if Mandatory Account Codes - Subscribed is True. Specifies whether the subscriber matching this entry is currently blocked from making outgoing calls that require account codes because he or she has made too many incorrect attempts to enter an account code. Values:
  • True
  • False
If this field is set to True, the NE has automatically blocked the subscriber from making any further outgoing calls that require account codes. To remove the block and allow the subscriber to make calls again, set the field to False.
Export - number of objects exported Read only The total number of objects (including child objects) written to the export file so far in the current or most recent export operation.
Export - status Read only The status of the current or most recent export operation, if any. Values:
  • None
    No export has been attempted. Use the export pushbutton to start it.
  • In progress
    Export is in progress. Do not attempt to access the export file until the status has changed to Succeeded.
  • Succeeded
    Export completed successfully.
  • Failed
    Export failed. Check the Export - log correlator field for more details.
  • Partially failed
    A field in the configuration of the exported object or one of its child objects was not valid. Typically this is because a referenced object has been deleted. Either check and correct the configuration before retrying the export, or correct the error in the exported file before attempting to re-import it.
Export - file Change The name of the text file (in the EMS User's home directory on the EMS Server) to which configuration information for this object will be exported. The maximum length of the filename is 32 characters.
Export - log correlator Read only If the export status is Failed, this field contains a correlator for the log message that contains details of the failure. Click on the 'go to log' button next to this field to jump to this message in the EMS log viewer window.
Export - correlator metaswitch Read only If the export status is Failed, this field contains the name of the EMS Server or MetaSwitch Network Element that generated the failure log. You may need this information to find the log in the EMS log viewer window.
Actual status Read only Specifies the current status of the ANI Screening Entry. Values:
  • Waiting For Parent
    The object cannot be used because its parent object is not active.
  • Enabled
    The object has been enabled.