Persistent Profile

The Persistent Profile object is a child of the Persistent Profiles object. It defines a standard set of configuration parameters that can be used by one or more subscribers (individual lines, business groups, business group lines, MADNs, or PBXs). Child objects of this object define the Call Services parameters used by the same subscribers.

For each field in the persistent profile, you can either specify an explicit value or choose Use default. The default value for each field is normally the same as the system-defined default for the equivalent field if you are configuring a subscriber without using a persistent profile. The only exception to this is that, if you are using the profile to configure a Business Group Line or a MADN, the default value is derived from the overall Business Group configuration (which may in turn be derived from a profile used by the Business Group).


If you modify a profile that is used by a large number of subscribers, it may take some time for the NE to apply the change to all of the subscribers. For example, if there are 10,000 subscribers using the profile, it may be up to 5 minutes before all of these subscribers are updated. You can check whether such an update is in progress by checking the field Synchronization of subscribers in progress in the Persistent Profile object (which is set to Yes when the profile has been updated and the NE is in the process of updating all the subscribers using this profile), or the field Synchronization with profile in progress in the Business Group object (which is set to Yes when the Business Group's profile has been updated and the NE is in the process of updating the Business Group Lines within the group).

Object-Specific Actions
Export To export the configuration of this Persistent Profile (and its child objects) to a text file, click on the 'Export' pushbutton. See MetaSwitch Class 5 Softswitch Operations Manual: Overview for more details of exporting configuration information.

Parameter

Access

Description
Name Change A name to identify this Persistent Profile in the EMS. This is a text string of 1 - 45 characters, which must not match the name of any other Persistent Profile configured on this Call Agent.
Valid subscriber types Change Specifies the types of subscriber for which this persistent profile can be used. Select one or more of the following values:
  • Individual Line
  • PBX
  • Business Group
  • Business Group Line
  • Multiple Appearance Directory Number
  • MLHG Pilot Directory Number
Synchronization of subscribers in progress Read only Specifies whether subscriber configurations are currently being updated as a result of a recent change to this profile. Values:
  • Yes
    The profile has recently been changed, and the NE is in the process of applying the change to subscribers using this profile. Some subscribers may still be using the previous settings from before the change.
  • No
    All subscribers using this profile are using the current settings as specified in the profile, except where the subscriber configuration overrides it.
MADN call limit algorithm Change This field applies only when the profile is used by a MADN. Specifies how the NE should limit the total number of concurrent incoming calls to the MADN. When this limit is reached, any further incoming call attempts will receive a busy indication. Choose Use default or specify a value:
  • Total calls cannot exceed number of members
    The total number of concurrent incoming calls to the MADN, including both calls connected to MADN members and queued calls, cannot exceed the number of lines configured as MADN Members. Note that some calls may be queued if one or more lines are busy with outgoing calls or direct-dialed incoming calls to a MADN Member.
  • Total calls cannot exceed specified value
    The total number of concurrent incoming calls to the MADN, including both calls connected to MADN members and queued calls, cannot exceed the number specified in the MADN call limit value field.
  • Queued calls cannot exceed specified value
    The total number of queued incoming calls to the MADN cannot exceed the number specified in the MADN call limit value field.
MADN call limit value Change This field applies only when the profile is used by a MADN. It appears only if MADN call limit algorithm is set to Total calls cannot exceed specified value or Queued calls cannot exceed specified value. Choose Use default or specify the maximum total number of incoming calls (minimum 1) or the maximum number of queued calls (zero indicates that calls will never be queued).
Maximum call appearances Change Inactive This field applies only when the profile is used by a SIP subscriber. The maximum number of simultaneous call branches in which the subscriber can participate. Choose Use default or specify a value. When the subscriber's SIP phone registers with the NE, creating a Registered SIP Binding object, this value determines the number of SIP Call Appearance child objects of the Registered SIP Binding.
Maximum permitted contact refresh interval Change Inactive This field applies only when the profile is used by a SIP subscriber. The maximum time for which a SIP registration from this subscriber remains valid. Choose Use default or specify a value. This time corresponds to the Expires header on the SIP request; the SIP phone will be disconnected if the user does not re-register within this time. The SIP phone may specify a shorter interval when registering, but if it specifies a longer interval or does not specify one, the value in this field is used in the SIP response. If the SIP phone specifies an interval lower than 3600 seconds (1 hour), this field must be set to the exact value specified by the SIP phone; otherwise the registration attempt is rejected and the SIP phone is disconnected.
Long distance carrier Change The long distance carrier ID (PIC1) used by default for this subscriber. This field appears only if the subscriber's Number status is set to Normal, Ported to, or Non-geographic. Choose Use default or specify the carrier ID as a 4-digit number.
Local carrier Change The local carrier ID (PIC2) used by default for this subscriber. This field appears only if the subscriber's Number status is set to Normal, Ported to, or Non-geographic. Choose Use default or specify the carrier ID as a 4-digit number.
International carrier Change The international carrier ID (PIC3) used by default for this subscriber. This field appears only if the subscriber's Number status is set to Normal, Ported to, or Non-geographic. Choose Use default or specify the carrier ID as a 4-digit number.
Billing type Change The type of billing used for calls within this subscriber's local area. Choose Use default or specify a value:
  • Flat rate
    The subscriber pays a fixed fee that covers all local calls.
  • Message rate
    The subscriber is billed for each call.
  • FX rate
    The line is served by an exchange in a different location from the subscriber (a foreign exchange). A Message Billing Index (MBI) is recorded for each call, and can be used to provide detailed control over billing.
Number Validation and routing attributes Change Attributes used to determine how a call made by the subscriber is routed to the network. This field appears only if the subscriber's Number status is set to Normal, Ported to, or Non-geographic. Choose Use default or, if required, select the following value:
  • Pre-paid / calling card subscriber
    The subscriber uses a pre-paid or 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 (local, long-distance, international etc.)
Deny all usage sensitive features Change Specifies whether the subscriber is prevented from using any call services that are configured with usage sensitive billing. This field appears only if Number status is set to Normal, Ported to, or Non-geographic. Choose Use default or specify a value:
  • True
    The subscriber is not permitted to use any call service that is configured with usage sensitive billing; this may be configured explicitly in the subscriber configuration or by default from a Persistent Profile or the global setting.
  • False
    The subscriber can use all call services that are configured, regardless of the billing type.
Force LNP lookup Change This field is used to force an LNP lookup for a particular subscriber. This is typically only used when a ported subscriber is moving. During the period where the subscriber number is configured as active on two switches, the number portability database is the definitive reference for which number is active. The typical sequence used for porting a subscriber is as follows.
  • Set force LNP lookup flag on original subscriber record
  • Create new subscriber record on recipient switch, also setting force LNP lookup flag
  • Update LNP database at time when line is to be moved.
  • Clear force LNP lookup flag on new subscriber record.
  • Delete old subscriber record or mark it as "Reserved, ported out" as required.
This field is valid only when the subscriber's Number Status is set to Normal, Ported to, or Non-geographic. Choose Use default or specify a value:
  • True
  • False
Timezone Change Specifies the timezone for this subscriber. Note that you cannot explicitly set this field to Unknown. Choose Use default or specify a value:
  • Unknown
  • EEST (+2)
  • CET (+1)
  • GMT (+0)
  • WET (-1)
  • GMT-2 (-2)
  • GMT-3 (-3)
  • AST (-4)
  • EST (-5)
  • CST (-6)
  • MST (-7)
  • PST (-8)
  • ALST (-9)
  • HST (-10)
  • SST (-11)
Adjust for Daylight Savings Change This field appears only if Timezone is not set to Unknown. This specifies whether the time for this line should be automatically adjusted for daylight savings time. This moves the subscriber's time forward one hour at 2am (local time) on the first Sunday in April, and back one hour at 2am (local time) on the last Sunday in October. Choose Use default or specify a value:
  • True
  • False
If Timezone is set to Unknown (so this field is hidden), this field is treated as being set to False.
Line Class Code 1 Change A code used as a match attribute in number validation and/or routing to provide additional options for routing calls originating from this subscriber. Choose Use default or specify any integer value in the range 0 - 2147483646. If you need to perform specific routing for this subscriber's calls, set this code to a value used as a match value for Line Class Code 1 in the appropriate Number Validation Entry or Routing Action.
Line Class Code 2 Change A code used as a match attribute in number validation and/or routing to provide additional options for routing calls originating from this subscriber. Choose Use default or specify any integer value in the range 0 - 2147483646. If you need to perform specific routing for this subscriber's calls, set this code to a value used as a match value for Line Class Code 2 in the appropriate Number Validation Entry or Routing Action.
Line Class Code 3 Change A code used as a match attribute in number validation and/or routing to provide additional options for routing calls originating from this subscriber. Choose Use default or specify any integer value in the range 0 - 2147483646. If you need to perform specific routing for this subscriber's calls, set this code to a value used as a match value for Line Class Code 3 in the appropriate Number Validation Entry or Routing Action.
Line Class Code 4 Change A code used as a match attribute in number validation and/or routing to provide additional options for routing calls originating from this subscriber. Choose Use default or specify any integer value in the range 0 - 2147483646. If you need to perform specific routing for this subscriber's calls, set this code to a value used as a match value for Line Class Code 4 in the appropriate Number Validation Entry or Routing Action.
Line Class Code 5 Change A code used as a match attribute in number validation and/or routing to provide additional options for routing calls originating from this subscriber. Choose Use default or specify any integer value in the range 0 - 2147483646. If you need to perform specific routing for this subscriber's calls, set this code to a value used as a match value for Line Class Code 5 in the appropriate Number Validation Entry or Routing Action.
Child Call Service Attention Required alarms Read only The total number of child objects of this object that are in Attention Required state.
Child Call Service Attention Required alarm events Read only / Reset The total number of times that the alarm state for a child object has gone to Attention Required.
Child Call Service Attend To Dependent alarms Read only The total number of child objects of this object that are in Attend To Dependent state.
Child Call Service Attend To Dependent alarm events Read only / Reset The total number of times that the alarm state for a child object has gone to Attend To Dependent.
Summary child alarm state Read only Summarizes the alarm status for all children of this object. Values:
  • Clear
    No alarms are currently raised.
  • Attention Required
    Attention Required - one or more child objects are not operating normally, and need operator intervention.
  • Attend To Dependent
    Attention Required elsewhere - another object on which one or more child objects depend is not operating normally.
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
  • In progress
  • Succeeded
  • Failed
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.