Business Group Line

The Business Group Line object defines a subscriber line within a Business Group.

Each Business Group Line object is a child of a Business Group Number Block object. Because there may be a large number of Business Group Line objects, the EMS System Explorer displays them in groups underneath the Business Group Number Block object. Underneath the Business Group Number Block object, the directory numbers assigned to the Business Group Number Block are split into groups of 200; expand these groups to display the Business Group Line objects within them.

To configure and enable a Business Group Line, you need to do the following:

When you first enable the Business Group Line, most of the subscriber services are disabled by default, except for a small number that can be enabled by default in the global Call Services configuration. You can then activate individual services for this subscriber as required.

The user of this Business Group Line can manage it using Web Self-Care. It can also be managed by a Web Self-Care user who is an administrator for the department specified in the Department field, or for a higher-level department of which this is a sub-department.

Object-Specific Actions
Generate diagnostics log Click this pushbutton to generate a log message that contains information about Line State Monitoring and Call Park Orbit monitoring for this Business Group Line. This message contains information about all other lines that this line is monitoring, all other lines that are monitoring this line, and (for a SIP line) all Call Park Orbits that the SIP device on this line is monitoring. To view this log message after you have generated it, use the go to log button next to the Diagnostics log correlator field.

Parameter

Access

Description
Directory number Create The directory number (full national telephone number including the leading zero) of this subscriber. (This is the actual number used on this exchange; the number that is presented to users may be different if the number has been ported.) This is used by the NE to identify a subscriber among all other subscribers. Either type in the number (noting that the directory number must be within the parent Business Group Number Block if you set the Number status to Normal, Ported from, or Non-geographic), or click on the ellipsis symbol at the end of the field to select from the list of numbers not currently in use. If you click on the ellipsis symbol, the dialog box that appears presents sub-ranges from the parent Business Group Number Block. Select the sub-range from which the number should be taken and click on Next. In the next dialog box, select a number and click on OK to accept this number. (If no number is shown, this indicates that there are no free numbers in the range; click on Back and select a different number range.) If you need to change the subscriber's directory number, you can do this using the Tasks interface; use one of the Configure Business Group Line tasks under Update Tasks.
Presentation number Change Inactive The presentation number of this subscriber (the number that is presented to users; the actual number used on this exchange may be different if the number has been ported). Specify the full national telephone number (including the leading zero).
Department Change The department within this Business Group, if any, to which this Business Group Line belongs. Select from the drop-down list of all Departments configured in this Business Group. The Business Group Line can be managed by a Web Self-Care user who is an administrator for this department, or for a higher-level department of which this is a sub-department. To specify that this line belongs to the top level of the Business Group and not to any department within it, select the entry None. The default is None. If this Business Group Line is an administrator line for Web Services, as specified in the Web Services child object, it must be within the department that it manages or a child department below this. You cannot move the line to a department for which it is not an administrator line.
Persistent Profile Change The Persistent Profile that is used as a basis for the configuration of this Business Group Line and its call services. The default values for many other fields in the Business Group Line's configuration are taken from the selected profile. Select from the list of Persistent Profiles that are configured for use by Business Group Lines, or select Persistent Profile "None" to use the default values derived from the parent Business Group's configuration instead of using a profile.
Intercom dialing code Read only If this subscriber's directory number is included within an Intercom Code Range defined for this Business Group, this field shows the intercom code that other subscribers within the group can use to call this subscriber.
Allow direct dialing Change Specifies whether this Business Group Line can be dialed directly or can be accessed only through its associated MADN. Values:
  • True (default)
    The Business Group Line can be dialed using its Directory Number.
  • False
    The Business Group Line cannot be dialed using its Directory Number; the dialing attempt is rejected as though the number is not recognized. The line can be accessed using its Intercom Dialing Code if one is defined, or by the MADN number if it is a MADN Member; otherwise it can be used only for outgoing calls.
Customer information Change A text field that can be used to store information about the Business Group Line, for example the address of the customer associated with it. This field is optional; you can supply up to 64 characters of free-form text. (This text can include accented / international characters as defined in ISO 8859-1.) The text wraps to the width of the field on screen, or you can use the Enter key to force linebreaks. The total contents of all six Customer information fields must not exceed 164 characters.
Customer information 2 Change A text field that can be used to store additional information about the Business Group Line. This field is optional; you can supply up to 32 characters of free-form text. (This text can include accented / international characters as defined in ISO 8859-1.) The total contents of all six Customer information fields must not exceed 164 characters.
Customer information 3 Change A text field that can be used to store additional information about the Business Group Line. This field is optional; you can supply up to 32 characters of free-form text. (This text can include accented / international characters as defined in ISO 8859-1.) The total contents of all six Customer information fields must not exceed 164 characters.
Customer information 4 Change A text field that can be used to store additional information about the Business Group Line. This field is optional; you can supply up to 32 characters of free-form text. (This text can include accented / international characters as defined in ISO 8859-1.) The total contents of all six Customer information fields must not exceed 164 characters.
Customer information 5 Change A text field that can be used to store additional information about the Business Group Line. This field is optional; you can supply up to 32 characters of free-form text. (This text can include accented / international characters as defined in ISO 8859-1.) The total contents of all six Customer information fields must not exceed 164 characters.
Customer information 6 Change A text field that can be used to store a name for the user of this Business Group Line, which is displayed in the Web Self-Care interface. You can set this field in the EMS, or the Business Group administrator can set it using Web Self-Care. (This text can include accented / international characters as defined in ISO 8859-1.) The total contents of all six Customer information fields must not exceed 164 characters.
Subscriber Group Change Inactive The Subscriber Group to which this Business Group Line belongs. This field appears only if Number status is set to Normal, Ported to, or Non-geographic. Choose Use default to use the setting from the parent Business Group Number Block, or select a specific entry from the list of all configured Subscriber Groups. As a short-cut to select the Subscriber Group, 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.
Number status Change Inactive Specifies the status of this number. Values:
  • Normal (default)
    Normal number on this exchange.
  • Ported to
    Number from a different exchange that has been ported to this exchange (for use by a subscriber connected to this exchange).
  • Ported from (UK only)
    Number ported from this exchange to a different exchange (for use by a subscriber connected to that exchange).
  • Ported out (North America only)
    Number ported from this exchange to a different exchange (for use by a subscriber connected to that exchange).
  • Reserved - ported in (North America only)
    Number from a different exchange that has been ported to this exchange, but is not yet in use by a subscriber connected to this exchange.
  • Recently moved
    Number that a subscriber has recently stopped using, to change to another exchange or to another number on this exchange. When someone calls this number, the NE plays an announcement about the change.
  • Reserved - old number
    Number that has previously been used and is being kept for a period of time before re-use.
  • Reserved for future use
    Number that has been reserved for future use.
  • Non-geographic
    Non-geographic number owned by this switch. This number status is used when there is a requirement to define a subscriber with a non-geographic Directory Number. Calls to this subscriber will only succeed if this switch and adjacent switches are configured to route calls directly to this number without performing AIN non-geographic number lookups.
Recently moved from old number Change Inactive Specifies whether this subscriber has recently moved to this directory number from a different number. This field appears only if Number status is set to Normal, Ported to, or Non-geographic. Values:
  • True
  • False (default)
Moved from directory number Change The old directory number from which this subscriber has moved. This field appears only if Recently moved from old number is set to True. Specify the number as a full national telephone number including the leading zero.
Connect call after announcement Change Inactive This field appears only if Number status is set to Recently moved. Specifies whether a caller who calls the old number should be connected to the new number after an announcement. Values:
  • True
    The caller hears an announcement about the number change, and is then connected to the new number. The field Moved to directory number must specify a number configured on this MetaSwitch NE.
  • False (default)
    The caller hears an announcement that the number has changed, but is not automatically connected.
Moved to directory number Change Inactive The new directory number to which this subscriber has now moved. This field appears only if Number status is set to Recently moved, and is required if Connect call after announcement is set to True. Specify the number as a full national telephone number including the leading zero.
Ported exchange ID Change Inactive The ID of the exchange to which calls for this subscriber should be redirected. This is a 5-digit number, allocated by the OFTEL Numbering Unit. When redirecting the call, the MetaSwitch NE identifies the target exchange by adding a 6-digit prefix to the called number; the prefix consists of the digit 5 followed by this exchange ID. This field appears, and must be supplied, only if the Number status field is set to Ported from.
Call Agent signaling type Change Inactive The type of signaling used by this subscriber's telephone to connect to the NE. This field appears only if Number status is set to Normal, Ported to, or Non-geographic. Values:
  • Analog line/T1 CAS
  • ISDN PRI (not valid for a Business Group Line)
  • SIP
Flash-hook call services provided by Change This field is visible only if Call Agent signaling type is set to SIP. Specifies whether this SIP subscriber can flash-hook, and use Call Services provided by the MetaSwitch NE that require a flash-hook (such as Call Waiting). Values:
  • MetaSwitch
    The subscriber's SIP device supports flash-hooking, and can use these call services. The subscriber cannot use multiple SIP registrations; the value of Maximum simultaneous registrations is ignored and only one registration is permitted.
  • Endpoint
    The subscriber's SIP device does not support flash-hooking. (SIP devices may support these call services natively.)
Gateway Create The Trunk / Access Gateway or Subscriber Gateway that owns the Access Device that this line uses to connect to the NE. This field appears only if Call Agent signaling type is set to Analog line/T1 CAS. Click on the search button at the end of the field to choose from access devices on Trunk / Access Gateways or access devices on Subscriber Gateways. Then select from the displayed list of gateways of the specified type. As a short-cut to select the gateway, 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*, or a range such as CA-FL. For more details, refer to the description of the Details panel in Operations Manual: Overview.
Access Device Create The Access Device that this line uses to connect to the NE. This field appears only if Call Agent signaling type is set to Analog line/T1 CAS. Click on the search button at the end of the field to choose from Access Devices on the gateway specified in the Gateway field. If the gateway contains only one Access Device, this device is selected automatically and there is no need to change it. As a short-cut to select the Access Device, 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*, or a range such as CA-FL. For more details, refer to the description of the Details panel in Operations Manual: Overview. If you have not selected a gateway in the Gateway field, the match details are used to match against all Access Devices that are children of Trunk / Access Gateways.
Access Line number Create The Access Line number on the specified Access Device that this subscriber uses. This field appears only if Number status is set to Normal, Ported to, or Non-geographic and Call Agent signaling type is set to Analog line/T1 CAS. Either type in the number (which must not match the access line number used by any other subscriber on this access device), or click on the ellipsis symbol at the end of the field to select from the list of numbers not currently in use. The highest line number that you can specify depends on the access device type: for an IAD it is the number of voice ports configured, and for other devices it is a configured parameter on the access device. If you click on the ellipsis symbol, the dialog box that appears offers 'manual selection' or 'automatic selection'.
  • If you select 'automatic selection', the EMS will assign the subscriber the next free access line number for this device.
  • If you select 'manual selection', the following dialog box presents sub-ranges of access line numbers. Select the sub-range from which the number should be taken and click on Next. In the next dialog box, select a number and click on OK to accept this number. (If no number is shown, this indicates that there are no free numbers in the range; click on Back and select a different number range.)
ISDN Interface Change Inactive This field appears only if the Call Agent signaling type field is set to ISDN PRI; it is not valid for a Business Group Line.
ISDN default bearer capabilities Change Inactive This field appears only if the Call Agent signaling type field is set to ISDN PRI; it is not valid for a Business Group Line.
Use DN for identification Change Inactive Specifies whether the subscriber registers using their directory number instead of a textual user name. This field appears only if Call Agent signaling type is set to SIP and Number status is set to Normal, Ported to, or Non-geographic. If this field is set to True, the SIP user name field will be hidden. If you change the value of this field and SIP authentication required is True, you must reenter the value in the New SIP password and Confirm new SIP password fields. Values:
  • True
  • False (default)
SIP user name Change Inactive The SIP subscriber's user name. This field appears, and must be supplied, only if Call Agent signaling type is set to SIP and Number status is Normal, Ported to, or Non-geographic. Set this field to the user part of the SIP URI, not including the prefix or domain name. This is a string of 1 - 32 characters, which must not match any other SIP user name with the same domain name; the first character must be a letter (either uppercase or lowercase). Alternatively, if SIP authentication required is True, it can be the subscriber's directory number; specify this as a numeric string that exactly matches the contents of the Directory number field.
SIP domain name Change Inactive The SIP subscriber's domain name. This field appears, and must be supplied, only if Call Agent signaling type is set to SIP and Number status is Normal, Ported to, or Non-geographic. Set this field to match the domain name configured on the SIP device; typically this is a DNS hostname that resolves to the MetaSwitch NE's virtual IP address, or the IP address of a Session Border Controller through which the device accesses the NE.
Maximum simultaneous registrations Change This field appears only if Call Agent signaling type is set to SIP. The maximum number of SIP devices that can register at the same time using this subscriber's details. See the description of SIP Call Forking in the Call Services Manual for more information. Choose Use default or specify a value in the range 1 - 32. A value of 1 means that the subscriber can have only one device registered at a time. If you allow multiple registrations, by specifying a value greater than 1, the subscriber must not use the Personal Communication Manager service (specified in the child Personal Communication Manager Service object) or flash-hook call services provided by MetaSwitch (specified in the field Flash-hook call services provided by).
Current number of registrations Read only This field appears only if Call Agent signaling type is set to SIP. The number of SIP devices currently registered using this subscriber's details.
Media Gateway Model Change The Media Gateway Model used by this subscriber. This field appears, and must be supplied, only if Call Agent signaling type is set to SIP and Number status is set to Normal, Ported to, or Non-geographic. Choose Use default or select from the displayed list of SIP Media Gateway Models. To indicate that the Media Gateway Model should be selected by matching against the SIP User Agent string provided when the SIP device registers with the MetaSwitch NE, select Derived from SIP User Agent from the list. If you change the Media Gateway Model for a subscriber who is already in a call, this call continues using the existing model. The new model is used from the start of the subscriber's next call.
Use static NAT mapping Change Inactive Specifies whether the NE should perform Network Address Translation on the contents of messages sent to this subscriber. This field appears only if Call Agent signaling type is set to SIP and Number status is Normal, Ported to, or Non-geographic. Values:
  • True
    Select this value if the subscriber is on a separate IP network from the NE and there is no Session Border Controller to provide the translation.
  • False
    Select this value if the subscriber is on the same IP network as the NE, or if they are on separate networks and there is a Session Border Controller associated with the firewall between the networks.
SIP authentication required Change Inactive Specifies whether this subscriber uses SIP authentication (and must supply authentication parameters in SIP signaling messages). This field appears, and must be supplied, only if Call Agent signaling type is set to SIP and Number status is set to Normal, Ported to, or Non-geographic. Values:
  • True (default)
  • False
If you enable SIP authentication for an existing subscriber, you must also specify the SIP user's password in the New SIP password and Confirm new SIP password fields. Either ask for the user's preferred password, or specify a new password and provide it to the user for future use. If the SIP user name matches the subscriber's directory number, SIP authentication must be enabled.
New SIP password Change Inactive The password that this subscriber uses with his or her SIP phone to register. The password is not displayed in the EMS and you cannot view it, although you can change it to a new value if necessary. This field appears, and must be supplied, only if Call Agent signaling type is set to SIP and Number status is set to Normal, Ported to, or Non-geographic. Specify a text string of 6 - 15 characters. If you use the Refresh pushbutton to refresh the object's status, any characters you have typed will be discarded without changing the password.
Confirm new SIP password Change Inactive This field appears, and must be supplied, only if Call Agent signaling type is set to SIP and Number status is set to Normal, Ported to, or Non-geographic. To confirm that you have typed the new password correctly, type it again in this field. The characters you type must exactly match the characters you typed in the New SIP password field. If you use the Refresh pushbutton to refresh the object's status, any characters you have typed will be discarded without changing the password.
Preferred location of Trunk Gateway Change Inactive This field appears only if Call Agent signaling type is set to SIP. Specifies the location for Trunk / Access Gateways that should be used to route calls for this object where possible (to reduce unnecessary long-distance traffic when a call can be routed on the switch). Select from the displayed list of available Location objects or None (no location). The value defaults to None.
Maximum call appearances Change Inactive The maximum number of simultaneous call branches in which the subscriber can participate. This field appears, and must be supplied, only if Call Agent signaling type is set to SIP. 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 The maximum time for which a SIP registration from this subscriber remains valid. This field appears, and must be supplied, only if Call Agent signaling type is set to SIP. 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.
Signal function code Change Inactive The subscriber's signal function code which is used for CAS signaling. This field appears only if Call Agent signaling type is set to Analog line/T1 CAS and Number status is set to Normal, Ported to, or Non-geographic. Values:
  • Loop start (default)
  • Ground start
  • E and M wink start
  • E and M wink start (Originating), delay start (Terminating)
  • E and M wink start (Originating only)
  • E and M immediate start (Originating only)
  • E and M wink start (Terminating only)
  • E and M delay start (Terminating only)
  • LRB wink start
    The abbreviation LRB indicates Loop Reverse Battery.
  • LRB wink start (Originating only)
  • LRB wink start (Terminating only)
  • Reversed LRB wink start (Originating only)
  • LRB delay start (Terminating only)
  • LRB wink start (Originating), delay start (Terminating)
If the Business Group Line uses an Access Device on a Subscriber Gateway that is controlled using MGCP (as specified in its Remote Media Gateway Model), the values Loop start and Ground start are equivalent. All of the E & M and LRB values are also equivalent, except that the Originating only and Terminating only values mean that the line can be used only for outgoing calls or only for incoming calls.
Line usage Change Inactive Specifies whether the subscriber intends to use this line for voice, fax and/or modem calls, or exclusively for fax and modem. This controls the use of data encoding and compression on the line. Note that support for T.38 fax encoding depends on the Remote Media Gateway Model being used, and on the T.38 support setting in the Call Agent. This field appears only if Number status is set to Normal, Ported to, or Non-geographic. Values:
  • Voice and fax (default)
    Use this setting if the line can be used for voice calls. The line normally uses 32kbps ADPCM compression (G.726), which is appropriate for voice lines. On detecting a fax tone, it switches automatically to T.38 fax encoding if this is supported, or to uncompressed 64kbps PCM (G.711) otherwise; on detecting a modem tone, it switches to G.711.
  • Fax only
    Use this setting only if the line is used exclusively for fax or modem calls. The line uses uncompressed 64kbps PCM (G.711), but switches to T.38 fax encoding for fax calls if this is supported. Note that G.711 does not provide echo suppression, so there may be problems with echo if the line is used for voice calls.
FSK format Change Inactive The type of FSK tones used to pass Caller ID messages to this subscriber. This field appears only if Call Agent signaling type is set to Analog line/T1 CAS and Number status is set to Normal, Ported to, or Non-geographic, and does not appear if the subscriber uses an access device on a Subscriber Gateway. Values:
  • UK
    Standard UK format
  • Bellcore
    Standard North American format
PIN Change The personal identification number (PIN) that this subscriber should use to access services related to their phone line. This field appears only if Number status is set to Normal, Ported to, or Non-geographic. You must specify a valid PIN before the subscriber can access any services that require a PIN. Specify a 4-digit number. (This field defaults to 0000, which is not a valid PIN, so you are forced to enter a specific value.)
Number Validation and routing attributes Change Attributes used to determine how a call made by the subscriber is routed to the network. Choose Use default or, 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 (local, long-distance, international etc.)
  • 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 in preference to SIP trunks.
  • Nomadic subscriber
    This attribute can be used to provide additional routing control not covered by the other attributes.
Line side answer supervision supported Change Inactive Specifies whether Line Side Answer Supervision is supported for this subscriber. This field appears only if Call Agent signaling type is set to Analog line/T1 CAS and Number status is set to Normal, Ported to, or Non-geographic. Values:
  • True
  • False (default)
Service suspended Change Specifies whether service for this subscriber is currently suspended (the subscriber is prevented from making or receiving calls). This field appears only if Number status is set to Normal, Ported to, or Non-geographic. Choose Use default to use the setting from the parent Business Group, or specify a value:
  • None
    Service is not suspended: the customer can make and receive calls as normal.
  • Incoming calls
    The subscriber is prevented from receiving incoming calls, except that he or she can still receive calls from the operator.
  • Outgoing calls
    The subscriber is prevented from making calls, except that he or she can still make calls to emergency services or to the designated suspended service access number.
  • Incoming and outgoing calls
    The subscriber is prevented from making or receiving any calls, except for calls to emergency services or to the designated suspended service access number.
Digit masking required Change Flag set to indicate that this subscriber's line requires digit masking. Values:
  • True
    Digit masking is required: calls to this subscriber's line will be rejected unless a network look-up has been performed before routing. This may be required for a subscriber running a premium rate service.
  • False (default)
    Digit masking is not required.
Tariff group Change The subscriber's tariff group. The values that this field can take are network specific, with codes agreed between the PNOs concerned. Choose Use default or specify a value in the range 0 - 63.
Originating facility marks - disabled Change Indicates whether this subscriber line is disabled. This information is required for Subscriber's Originating Facility Marks. Values:
  • True
  • False (default)
Originating facility marks - AD&C Change Indicates whether this subscriber requires Advice of Duration and Charge (AD&C). This information is required for Subscriber's Originating Facility Marks. Values:
  • True
  • False (default)
Terminating facility marks - service interception Change Indicates whether this subscriber has Service Interception applied. This information is required for Subscriber's Terminating Facility Marks. Values:
  • True
  • False (default)
Terminating facility marks - fixed destination service Change Indicates whether this subscriber has Fixed Destination Service applied. This information is required for Subscriber's Terminating Facility Marks. Values:
  • True
  • False (default)
Timezone Change Specifies the timezone for this Business Group Line. 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 1am (local time) on the last Sunday in March, and back one hour at 1am (local time) on the last Sunday in October. Choose Use default or specify a value:
  • True
  • False (default)
If Timezone is set to Unknown (so this field is hidden), this field is treated as being set to False.
Line Traffic Study Change Specifies whether this line should have statistics for line traffic usage recorded. Values:
  • True
  • False (default)
Note that if the maximum allowed number of currently active studies has been met, setting this field to True will be rejected when you apply the change.
Enabled date Read only The date and time at which this object was enabled in the EMS.
Line Class Code 1 - 20 Change / Change Inactive This field appears once for each Line Class Code that you have configured below the Trunk Routing and Policy Services object. The field name for each code appears as LCC n - description (showing the index value in the range 1-20 and the configured description, if any). The access to this field (Change or Change Inactive) depends on the configuration of the Line Class Code. A Line Class Code is used as a match attribute in number validation and/or routing to provide additional options for routing calls originating from this subscriber. If you need to perform specific routing for this subscriber's calls, set this field to a value used as a match value for the Line Class Code in the appropriate Number Validation Entry or Routing Action. Select Use default, or specify the Line Class Code as an integer value in the range 0 - 2147483646. You cannot select Use default if the corresponding Line Class Code object has Allow inheritance set to False; you will have to specify a value. Alternatively, if one or more valid values have been configured in the Line Class Code object, you can select a specific value from the list of valid 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.
Call Lists - missed calls Read only This field appears only if the Call Lists service is enabled in the Global General Call Service Controls object and Number status is set to Normal, Ported to or Non-geographic. A list of the most recent calls to this Business Group Line, that were not answered or were forwarded to another line, starting with the most recent call. For each call, the display shows the date and time (in the subscriber's local timezone) at which the call was made, and the calling number (if available). For more details of the call list format, see Call list format.
Call Lists - answered calls Read only This field appears only if the Call Lists service is enabled in the Global General Call Service Controls object and Number status is set to Normal, Ported to or Non-geographic. A list of the most recent calls to this Business Group Line that were answered, starting with the most recent call. For each call, the display shows the date and time (in the subscriber's local timezone) at which the call was made, the calling number (if available), and the call duration if the call has completed. For more details of the call list format, see Call list format.
Call Lists - dialed calls Read only This field appears only if the Call Lists service is enabled in the Global General Call Service Controls object and Number status is set to Normal, Ported to or Non-geographic. A list of the most recent calls dialed from this Business Group Line (or created using 3-Way Calling or Call Transfer), starting with the most recent call. For each call, the display shows the date and time (in the subscriber's local timezone) at which the call was made, the calling number, and the call duration if the call has completed. For more details of the call list format, see Call list format.
Last incoming call - calling type Read only The type of the last calling number. Values:
  • Not available
  • Ordinary
  • Pay phone
  • Withheld - ordinary
  • Withheld - pay phone
The following values indicate that only the presentation number of the last call (and not the actual calling number) is available:
  • Ordinary (presentation number only)
  • Pay phone (presentation number only)
  • Withheld - ordinary (presentation number only)
  • Withheld - pay phone (presentation number only)
Last incoming call - calling number Read only This field is visible only if the Last incoming call - calling type field is set to Ordinary or Pay phone. The directory number of the calling party for the last call made to this subscriber.
Last incoming call - calling presentation number Read only The presentation number of the calling party for the last call made to this subscriber. This field is visible only if the Last incoming call - calling type field is set to Ordinary, Pay phone, Ordinary (presentation number only), or Pay phone (presentation number only).
Last incoming call - time of call Read only The date and time of the last call made to this subscriber.
Last incoming call - caller waited Read only Indicates whether the last caller was subjected to call waiting. Values:
  • True
  • False
Last incoming call - call answered Read only Indicates whether the last incoming call was answered by the subscriber. Values:
  • True
  • False
Last incoming call - call traced Read only Indicates whether the last incoming call has been traced by the subscriber. Values:
  • True
  • False
Last outgoing call - called type Read only The type of the last called number (in the following field). Values:
  • Not available
  • Ordinary
  • Pay phone
  • Withheld - ordinary
  • Withheld - pay phone
The following values indicate that only the presentation number of the last called number (and not the actual called number) is available:
  • Ordinary (presentation number only)
  • Pay phone (presentation number only)
  • Withheld - ordinary (presentation number only)
  • Withheld - pay phone (presentation number only)
Last outgoing call - called number Read only This field is visible only if the Last outgoing call - called type field is set to Ordinary or Pay phone. The last number called by this subscriber.
Last outgoing call - number presentation Read only Indicates whether the calling number was presented or withheld on the last outgoing call. Values:
  • Not available
  • Ordinary
  • Withheld - ordinary
Fault monitoring level Change Specifies whether to suppress alarms raised for this subscriber, so that the EMS does not display them or send them to SNMP alarm notification destinations. You may want to do this if you expect alarms from this subscriber (for example if the object is currently being provisioned or undergoing maintenance), so that it is easier to see unexpected alarms from other objects. Values:
  • Normal (level 10) (default)
    Alarms for this subscriber appear in the EMS and are sent to SNMP alarm notification destinations as usual.
  • Suppress alarms (level 5)
    Alarms for this subscriber do not appear in the EMS and are not sent to SNMP alarm notification destinations.
Alarm state Read only Specifies whether any alarms are currently raised for this subscriber. Values:
  • Clear
    No alarms are currently raised.
  • Attention Required
    Attention Required - the object is not operating normally, and needs operator intervention.
  • Attend To Dependent
    Attention Required elsewhere - another object on which this object depends is not operating normally.
Alarm log correlator Read only Identifier of the log message that was generated when this subscriber last entered Attention Required or Attend To Dependent alarm state. This field is reset when the Attention Required alarm events and the Attend To Dependent alarm events are reset to zero.
Additional alarm log correlator Read only If available, the identifier of the log message for the original event that caused the last Attention Required or Attend To Dependent alarm state for this object. This field is reset when the Attention Required alarm events and the Attend To Dependent alarm events are reset to zero.
Attention Required alarm events Read only / Reset Number of times (since the alarm count was reset) that this object's alarm state has gone to Attention Required.
Attend To Dependent alarm events Read only / Reset Number of times (since the alarm count was reset) that this object's alarm state has gone to Attend To Dependent.
Alarm state changed timestamp Read only The time at which the Alarm state last changed.
Child Call Service Attention Required alarms Read only The total number of Call Service children 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 Call Service child object has gone to Attention Required.
Child Call Service Attend To Dependent alarms Read only The total number of Call Service children 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 Call Service 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.
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 - enabled Change Specifies whether API tracing is enabled for this object. Values:
  • True
  • False (default)
Diagnostics - API trace - trace tag Change An optional text string inserted into API tracing and PD logging for this object. (This string can include accented / international characters as defined in ISO 8859-1.) If you want to filter on this tag in the craft interface, do not include spaces or any of the characters ^ \ $ * + ? | ( ) , . ' ' " [ ] { }.
Diagnostics - API trace - trace remote number Change The remote directory number that should be API traced. Outgoing calls made to this number or incoming calls received from this number should be API traced. If a directory number is not specified, all calls made by and received by this subscriber will be API traced.
Diagnostic log correlator Read only A correlator for the most recent diagnostic log message that was created using the generate diagnostics log pushbutton. Click on the go to log button next to this field to jump to this message in the EMS log viewer window.
VQM call logging Change This field appears only if VQM call logging is enabled on the Call Agent (in the Call Logging object). Specifies whether Voice Quality Management (VQM) data, if available, should be recorded for calls to or from this Business Group Line. You can view this data using the Call Logs function in the NE craft interface, as described in the IS, CA and MG Craft Interface Guide. Choose Use default to use the value specified on the parent Business Group, or specify a value:
  • True
  • 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.
Requested status Read only Specifies whether an administrator has attempted to enable the subscriber. 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 subscriber. Values:
  • Enabled
    The object has been enabled.
  • Disabled
    The object has not been enabled or has been disabled.

Call list format

If the Call Lists service is enabled in the Global General Call Service Controls object, the Call Lists fields in this object provide a record of the most recent calls to and from this Business Group Line.

Missed calls, Answered calls

The following information is displayed for missed calls (calls to this Business Group Line that were not answered or were forwarded to another line), and for answered calls:

An example answered call list is shown below. The missed call list is similar except that the call duration is not shown.

If the called subscriber does not have Calling Number Delivery, the entry appears as in the following example.

Dialed calls

The following information is displayed for calls dialed from this Business Group Line (or created using 3-Way Calling or Call Transfer):

An example dialed call list is shown below.