Business Group

The Business Group object defines a group of telephone lines (Business Group Lines), typically associated with a small business organization, for which the MetaSwitch NE provides services as though they were connected to a PBX (Private Branch Exchange) rather than directly to the exchange. It is a child of the Business Groups object.

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

Note that the EMS currently includes Tasks to simplify the processes of adding and configuring Business Groups and their child objects. See the MetaSwitch Class 5 Softswitch Tasks Guide for more information.

Object-Specific Actions
Export To export the configuration of this Business Group to a text file, click on the 'Export' pushbutton. See MetaSwitch Class 5 Softswitch Operations Manual: Overview for more details of exporting configuration information.

If you delete a Business Group's child Dialing Plan object, the users within the Business Group will be unable to make outgoing calls or calls within the Business Group (although incoming calls will still be accepted).



If you delete a Business Group that has one or more Business Group Lines allocated, the Business Group Lines will also be deleted.


Parameter

Access

Description
Business Group name Change Unique user-friendly name identifying the Business Group. Specify a name of up to 64 characters. If a name is not specified, the EMS displays a default.
Persistent Profile Change The Persistent Profile that is used as a basis for the configuration of this Business Group and its call services. The default values for many other fields in the Business Group's configuration are taken from the selected profile. If necessary, you can override these defaults for a specific Business Group Line, either by specifying a different profile on the Business Group Line or by setting explicit values. Select from the list of Persistent Profiles that are configured for use by Business Groups, or select Persistent Profile "None" to use the system defaults instead of using a profile.
Synchronization with profile in progress Read only Specifies whether Business Group Line, MADN and MLHG configurations are currently being updated as a result of a recent change to the profile used by this Business Group. Values:
  • Yes
    The profile has recently been changed, and the NE is in the process of applying the change to Business Group Lines, MADNs and MLHGs in the group. Some lines may still be using the previous settings from before the change.
  • No
    All Business Group Lines, MADNs and MLHGs in the group are using the current settings as specified in the profile, except where the subscriber configuration overrides it.
Local CNAM name Change A name used to identify this Business Group when providing Calling Name Delivery information on a call from this Business Group to another local subscriber. You can override this setting in the Caller ID Services object for each Business Group Line in the group if necessary. Specify a name of 1 - 15 characters, or leave the field blank if you do not want to specify a calling name.
Long distance carrier Change The long distance carrier ID (PIC1) used by default for subscribers in this business group. You can override this for a particular Business Group Line in the group if necessary. Choose Use default or specify the carrier ID as a 4-digit number. If the Business Group includes lines from two or more Rate Centers, you must set this to your own long-distance carrier ID. Some services specific to Business Groups (such as internal Caller ID, distinctive alerting, or flat rate billing for intercom calls) may not work correctly if calls within the Business Group are routed over other carriers.
Local carrier Change The local carrier ID (PIC2) used by default for subscribers in this business group. You can override this for a particular Business Group Line in the group if necessary. Choose Use default or specify the carrier ID as a 4-digit number. If the Business Group includes lines from two or more Rate Centers, you must set this to your own local carrier ID. Some services specific to Business Groups (such as internal Caller ID, distinctive alerting, or flat rate billing for intercom calls) may not work correctly if calls within the Business Group are routed over other carriers.
International carrier Change The international carrier ID (PIC3) used by default for subscribers in this business group. You can override this for a particular Business Group Line in the group if necessary. Choose Use default or specify the carrier ID as a 4-digit number.
Locale Change The language variant used for voice announcements played to subscribers in this business group. Values:
  • English (US) (default)
  • English (UK)
  • English (Canadian)
  • User Defined 1
  • User Defined 2
Billing type Change The type of billing used for calls within the local area. Choose Use default or specify a value:
  • Flat rate (default)
    The subscriber pays a fixed fee that covers all local calls.
  • Message rate
    The subscriber is billed for each call.
Billing type - intercom calls Change The type of billing used for intercom calls within the business group (which may not be local calls if the business group spans two or more local areas). Values:
  • All flat rate
    The subscriber pays a fixed fee that covers all intercom calls.
  • All message rate
    The subscriber is billed for each call.
  • Local calls flat rate (default)
    The subscriber pays a fixed fee that covers all local intercom calls, and is billed for each non-local intercom call.
Number Validation and routing attributes Change Attributes used to determine how a call made by the subscriber is routed to the network. You can override this setting for each Business Group Line in the group if necessary. 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 subscribers in this business group are prevented from using any call services that are configured with usage sensitive billing. 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.
Distinctive alerting Change Specifies whether a distinctive ring tone is used for incoming calls to lines in this Business Group, to identify either internal calls (from within the Business Group) or external calls. Distinctive alerting applies both to ring tones when the called number is not busy and to Call Waiting tones when the called number is busy. The distinctive ring tone used is different from that used for the Priority Call service. If both services are in use and an incoming call is from a number in the subscriber's own Priority Call list, the Priority Call ring tone is used in preference to the business group's distinctive alerting ring tone. Values:
  • None
    Distinctive alerting is not used.
  • External
    A distinctive ring tone is used for incoming calls from external numbers.
  • Internal
    A distinctive ring tone is used for incoming calls from internal numbers.
Service suspended Change Specifies whether service for this Business Group is currently suspended (subscribers in the group are prevented from making or receiving calls). You can override this setting for each Business Group Line in the group if necessary. Values:
  • None (default)
    Service is not suspended: the subscriber 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 operator.
  • Incoming and outgoing calls
    The subscriber is prevented from making or receiving any calls, except for emergency and operator calls.
Line Class Code 1 Change A default code used as a match attribute in number validation and/or routing to provide additional options for routing calls originating from this Business Group. (You can override this value for a specific Business Group Line within the group if required.) 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 default code used as a match attribute in number validation and/or routing to provide additional options for routing calls originating from this Business Group. (You can override this value for a specific Business Group Line within the group if required.) 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 default code used as a match attribute in number validation and/or routing to provide additional options for routing calls originating from this Business Group. (You can override this value for a specific Business Group Line within the group if required.) 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 default code used as a match attribute in number validation and/or routing to provide additional options for routing calls originating from this Business Group. (You can override this value for a specific Business Group Line within the group if required.) 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 default code used as a match attribute in number validation and/or routing to provide additional options for routing calls originating from this Business Group. (You can override this value for a specific Business Group Line within the group if required.) 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.
Number of directory numbers Read only Number of directory numbers that are allocated for use by this Business Group (as part of Business Group Number Blocks).
Number of free directory numbers Read only Number of directory numbers that are allocated for use by this Business Group (as part of Business Group Number Blocks) but not assigned to Business Group Lines.
Facility Group Limits - external calls Change Specifies whether or not limits are placed on the total number of external calls that can be made to or from this Business Group at the same time. Values:
  • Not permitted
  • Unlimited (default)
  • Limited
Facility Group Limits - maximum external calls Change This field is visible only if Facility Group Limits - External calls is set to Limited. Specifies the maximum number of external calls that can be made to or from this Business Group at the same time. Range: 1 - 2147483647. The default is 16.
Facility Group Limits - terminating calls Change This field is visible only if Facility Group Limits - External calls is set to Limited or Unlimited. Specifies whether or not limits are placed on the number of external calls that can be made to this Business Group at the same time. Values:
  • Not permitted
  • Unlimited (default)
  • Limited
Facility Group Limits - maximum terminating calls Change This field is visible only if Facility Group Limits - Terminating calls is set to Limited. Specifies the maximum number of incoming external calls that can be made to this Business Group at the same time. If Facility Group Limits - External calls has been set to Limited, this value cannot be greater than the value specified in Facility Group Limits - Maximum external calls. Range: 1 - 2147483647. The default is 16.
Facility Group Limits - originating calls Change This field is visible only if Facility Group Limits - External calls is set to Limited or Unlimited. Specifies whether or not limits are placed on the number of external calls that can be made from this Business Group at the same time. Values:
  • Not permitted
  • Unlimited (default)
  • Limited
Facility Group Limits - maximum originating calls Change This field is visible only if Facility Group Limits - Originating calls is set to Limited. Specifies the maximum number of external calls that can be made from this Business Group. If Facility Group Limits - External calls has been set to Limited, this value cannot be greater than the value specified in Facility Group Limits - Maximum external calls. Note that this includes calls forwarded from a Business Group Line or three-way calls set up by a Business Group Line within the group. Range: 1 - 2147483647. The default is 16.
Business Group Line Attention Required alarms Read only The total number of Business Group Line objects (and their child objects) associated with this object that are in Attention Required state.
Business Group Line Attention Required alarm events Read only / Reset The total number of times that the alarm state for a Business Group Line child object has gone to Attention Required.
Business Group Line Attend To Dependent alarms Read only The total number of Business Group Line objects (and their child objects) associated with this object that are in Attend To Dependent state.
Business Group Line Attend To Dependent alarm events Read only / Reset The total number of times that the alarm state for a Business Group Line child object has gone to Attend To Dependent.
Multiple Appearance Directory Number Attention Required alarms Read only The total number of Multiple Appearance Directory Number objects (and their child objects) associated with this object that are in Attention Required state.
Multiple Appearance Directory Number Attention Required alarm events Read only / Reset The total number of times that the alarm state for a Multiple Appearance Directory Number child object has gone to Attention Required.
Multiple Appearance Directory Number Attend To Dependent alarms Read only The total number of Multiple Appearance Directory Number objects (and their child objects) associated with this object that are in Attend To Dependent state.
Multiple Appearance Directory Number Attend To Dependent alarm events Read only / Reset The total number of times that the alarm state for a Multiple Appearance Directory Number child object has gone to Attend To Dependent.
Multi Line Hunt Group Attention Required alarms Read only The total number of Multi Line Hunt Group objects (and their child objects) associated with this object that are in Attention Required state.
Multi Line Hunt Group Attention Required alarm events Read only / Reset The total number of times that the alarm state for a Multi Line Hunt Group child object has gone to Attention Required.
Multi Line Hunt Group Attend To Dependent alarms Read only The total number of Multi Line Hunt Group objects (and their child objects) associated with this object that are in Attend To Dependent state.
Multi Line Hunt Group Attend To Dependent alarm events Read only / Reset The total number of times that the alarm state for a Multi Line Hunt Group 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.