MTAS Cell Announcement Management Guide
MTAS

Contents

1Introduction
1.1Prerequisites

2
Overview
2.1Subfunctions

3
Configure SSC Cell Announcement Service
3.1Configure SSC for Cell Announcement Service
3.2Configure Cell Announcement Configurations
3.3Configure Cell (Not) Served Announcement
3.4Service Data Management
3.5Operator Subscription Level Service Configuration
3.6Subscriber Subscription Level Service Configuration

4
Performance Management

5
Fault Management

6
Additional Information
6.1MtasGaAnn and Related MOs Configuration Examples
6.2mtasSscCellAnn and Related MOs Configuration Example
6.3MTAS SSC Cell Ann MOC Model
6.4Cell ID Extraction from PANI Header

1   Introduction

This document describes how to configure the Cell Announcement service in MTAS to enable users to receive announcements about originating locations of their mobile equipment by using Supplementary Service Codes (SSC) commands.

For more information about the SSCs, refer to MTAS Supplementary Service Codes Management Guide.

1.1   Prerequisites

It is assumed that the user of this document is familiar with the Operation and Maintenance (O&M) area, in general.

1.1.1   Licenses

To enable basic services in the MTAS, the Multimedia Telephony (MMTel) license must be installed. For more information about the MMTel license, refer to MTAS Licenses.

1.1.2   Documents

Before starting any procedure in this document, ensure that the following documents are available:

1.1.3   Conditions

Before starting any procedure in this document, ensure that the following condition is met:

2   Overview

The Cell Announcement feature allows a subscriber to dial a feature code and receive a dynamic announcement providing the identification of the serving femtocell. To simplify services that use originating location information, the Proxy Call Session Control Function (P-CSCF) maps the femtocell ID received in the utran-cell-id-3gpp access-info of the PANI header to the associated macrocell ID using mapping tables. The P-CSCF then sets the utran-cell-id-3gpp access-info to the macrocell ID in the PANI header of the INVITE that it sends over the IP Multimedia Service Control (ISC) interface to other IMS core network elements including MTAS. The P-CSCF provides the femtocell information in a new location parameter, called femto-utran-cell-id-3gpp, added to the PANI header:

P-Access-Network-Info:3GPP-E-UTRAN-FDD;utran-cell-id-3gpp=<macro>;femto-utran-cell-id-3gpp=<femto>

MTAS plays a location-dependent announcement to the calling user, triggered by an SSC command. This SSC service is performed on the Originating MTAS MMTel Telephony Application Server (AS).

The location-dependent announcement service identifies the radio access cell that the user is being served by, so it can tell that in communication with the customer care of the operator

When the user dials an SSC command for Cell Announcement service, MTAS plays a cell served announcement if a matching PANI header is found. The following apply:

When the user dials an SSC command for the Cell Announcement service, MTAS plays a cell not served announcement if matching PANI header is not found. The following apply:

When the user dials an SSC command for the Cell Announcement service, MTAS plays an SSC negative announcement in error scenarios like no PANI header received in INVITE request. Playing of negative announcement is as per legacy SSC service behavior. A charging message is generated after successful announcement.

In IMS, PANI header is responsible for conveying the user mobile location in terms of Global Cell ID. Cell ID defines the mobile location.

2.1   Subfunctions

The subfunctions included in the Cell Announcement service are described in this section.

2.1.1   Cell Announcement Interrogation

The Cell Announcement service adds a new system-defined SSC command to the MTAS MMTel Telephony AS with only interrogation activity. Activation, deactivation, and invocation commands are not applicable for this service.

2.1.2   FemtoCell Identification

2.1.3   Play Announcement

Generic announcements provide flexibility to the operator to play Announcements with dynamic mobile location content. Generic announcement service utilizes MRFP/MRF to play the announcement. The operator must configure the generic announcement to play a segmented cell served announcement with provisioned and variable part. The operator must also configure the generic announcement to play a segmented cell not served announcement with provisioned part. No variable part can be defined.

2.1.4   Configure Service

2.1.5   Generate Charging Message

Multimedia Telephony (MMTel) sessions that use the Cell Announcement service support charging. The Credit Control Request (CCR), Initial Request, and Accounting Request (ACR) start generated by the originating MTAS on which Cell Announcement service was started, include the following Attribute-Value Pairs (AVPs) within the MMT Information AVP:

2.1.6   Provisioning of Service

Provisioning of service is responsible for Service Data Management. The subscriber must be provisioned with the SSC service to utilize cell announcement service.

2.1.7   Get Subscriber Data

This subfunction is called whenever the subscriber service data is to be read from the HSS.

3   Configure SSC Cell Announcement Service

The configuration of the Cell Announcement service can be broken down into the following steps:

  1. Setting the MOs that define the SSC for the Cell Announcement service.
  2. Setting the MOs that define cell announcement configurations.
  3. Setting the MOs that define the generic announcement for cell announcement.

3.1   Configure SSC for Cell Announcement Service

This section describes how to configure SSC for the Cell Announcement service.

3.1.1   Configure MtasSscCellAnn MO

The MtasSscCellAnn MO is the main MO responsible for the SSC Cell Announcement service. It is a system-created MO under the existing MtasSSC MO.

Configure the following attributes properly for the SSC Cell Announcement service.

3.1.1.1   Configure MtasSscCellAnnComSyntInt Attribute

The mtasSscCellAnnComSyntInt attribute defines the command syntax to parse the SSC code dialed by user to avail the Cell Announcement service.

The cell announcement interrogation command syntax must be configured so it only allows dialing of telephone numbers that consist of *, #, and digits 0–9.

For more information about the command syntax configuration, refer to MTAS Supplementary Service Codes Management Guide.

A list of 10 different command syntaxes can be configured by the operator to play different cell announcements. For example, as follows:

3.1.1.2   Configure MtasSscCellAnnConfigs Attribute

To play cell announcements for each valid SSC code, the operator must configure this attribute with a value that matches the dialed string.

Maximum 20 instances of this attribute with different values can be configured inside the MtasSscCellAnn Managed Object Class (MOC).

It is up to the operator to configure MtasSscCellAnnConfigs for all possible dialed strings as per command syntax or only for few combinations. For undefined combination, no announcement is played to the user. Proper error messages are generated and the Performance Management (PM) counter is incremented for statistics.

To define the MtasSscCellAnnConfigs attribute value from dialed string, replace star (*) with s and replace hash (#) with h.

Example 1

SSC command syntax mtasSscCellAnnComSyntInt : *48# is configured as follows:

Example 2

SSC command syntax mtasSscCellAnnComSyntInt: *48N# is configured as follows:

Before configuring this attribute, the operator must configure the MtasSscCellAnnConfig MO with the same instance name as the attribute value, see Section 3.2.2 Configure MtasSscCellAnnConfig MO.

3.2   Configure Cell Announcement Configurations

Cell announcement is played based on its configuration. The following section defines how it can be configured to play different announcements for different SSC codes. See Section 6.2 mtasSscCellAnn and Related MOs Configuration Example for an MO configuration example.

3.2.1   MtasSscCellAnnouncementConfigs MO

The MtasSscCellAnnouncementConfigs MO serves as a structural MO under which all the configured MtasSscCellAnnConfig MOs are collected. MtasSscCellAnnouncementConfigs is part of the mtasSscCellAnn MO.

This MO must list at least all the MtasSscCellAnnConfig MOs whose instance name is the same as the value of the mtasSscCellAnnConfigs attributes in the mtasSscCellAnn MO.

It is possible that the MtasSscCellAnnouncementConfigs MO has some MtasSscCellAnnConfig MO whose corresponding mtasSscCellAnnConfigs attribute in the mtasSscCellAnn MO does not exist.

Note:  
The MtasSscCellAnnConfig MO can only be deleted if its instance name is not referred as value of the mtasSscCellAnnConfigs attribute in the mtasSscCellAnn MO.

Example:

For the Cell Announcement service, define the MtasSscCellAnnConfig MO with instance name MtasSscCellAnnConfig : s48h.

3.2.2   Configure MtasSscCellAnnConfig MO

The MtasSscCellAnnConfig MO is the main MO that controls the fetching of cell ID from the PANI header and which generic announcement to be played for dialed SSC code.

3.2.2.1   Configure mtasSscCellAnnConfigServAnn Attribute

The mtasSscCellAnnConfigServAnn attribute value defines the MTAS generic announcement instance name that is played to the user as cell served announcement, with CellID as variable part when a matching PANI header is found.

Before setting this attribute, it is important that the operator configures mtasGaAnn with the same instance name, see Section 3.3.1 Configure MtasGaAnn MO.

Note:  
The variable announcement instance name must be set to CellID. Wrong or missing instance name is indicated by playing only fixed part of the cell served announcement.

Sometimes, the cell served announcement is played with variable set to 0000000. If variable part of the cell served announcement consist of any characters other than 0–9, the cell served announcement is played with variable part set to zero, which is 0000000. See Section 6.4 Cell ID Extraction from PANI Header for more examples.

Example:

For the Cell Announcement service, define the attribute as mtasSscCellAnnConfigServAnn : CellServedAnnouncement.

3.2.2.2   Configure MtasSscCellAnnConfigNotServAnn Attribute

The mtasSscCellAnnConfigNotServAnn attribute value defines the MTAS generic announcement instance name that is played to the user as cell not served announcement. No variable part exists.

Before setting this attribute, the operator must configure mtasGaAnn with the same instance name, see Section 3.3.1 Configure MtasGaAnn MO.

Example:

For the Cell Announcement service, define the attribute as mtasSscCellAnnConfigNotServAnn : CellNotServedAnnouncement.

3.2.2.3   Configure MtasSscCellAnnConfigOpt Attribute

The mtasSscCellAnnConfigOpt attribute defines the Cell Announcement configuration, which is in the following format. Three name-value pairs (NVPs), which are comma-separated. All NVPs are case-insensitive except the "rule" value.

parameter=param,np=true|false,rule=/expression/substitution/

The default value of the mtasSscCellAnnConfigOpt attribute is parameter=femto-utran-cell-id-3gpp,np=false,rule=/^.*([0-9a-fA-F]{7})$/H'\1'/.

If the operator does not want to change the default configuration, configure the mtasSscCellAnnConfigOpt attribute value to default value only, which is parameter=femto-utran-cell-id-3gpp,np=false,rule=/^.*([0-9a-fA-F]{7})$/H'\1'/.

Note:  
If the operator misses specifying any NVP when modifying the attribute, at the end of modification, the default value is considered for missing NVP.

The following describes the NVP syntax:

For more examples, see Section 6.4 Cell ID Extraction from PANI Header.

3.3   Configure Cell (Not) Served Announcement

The MTAS Generic announcement feature is used to play segmented announcements. For more information, refer to MTAS Generic Announcement Management Guide.

The Cell Announcement service has the following two types of segmented announcement:

For an MO configuration example for the Cell Announcement service, see Section 6.1 MtasGaAnn and Related MOs Configuration Examples.

3.3.1   Configure MtasGaAnn MO

The MtasGaAnn MO allows the operator to configure the segmented announcements.

Before defining the mtasSscCellAnnServAnn and mtasSscCellAnnNotServAnn attributes in the MtasSscCellAnnConfig MO, the operator must ensure that the mtasGaAnn instance name exists with the same key attribute value.

If many MtasSscCellAnnConfig MOs are defined, then mtasGaAnn is to have those many instances of the mtasSscCellAnnServAnn and mtasSscCellAnnNotServAnn attributes defined in each MtasSscCellAnnConfig MO.

The operator can reuse the same mtasGaAnn instance in more than one MtasSscCellAnnConfig MO. In that case, one instance of mtasGaAnn is enough, which is referred in more than one MtasSscCellAnnConfig MO.

Example:

For cell announcement, define two mtasGaAnn instances with names as follows:

3.3.2   Configure MtasSegmentVector MO

The mtasSegmentVector is a set of announcement segments. It defines the order of segmented announcement play out.

Note:  
The standalone voice variable announcement segment name must be set to CellID (case sensitive) only in the cell served announcement. If it is not set to CellID, only the provisioned part of the segmented cell served announcement is played. No Variable part announcement. Proper error messages are generated and the PM counter is incremented for statistics.

Example:

For the Cell Announcement service, define two mtasSegmentVector instances with names as follows:

3.3.3   Configure MtasAnnouncementSegment MO

The MtasAnnouncementSegment MO defines the announcement segment that is referred in the mtasSegmentVector MO.

Announcement segment is of two types: provisioned (fixed voice content) or variable (dynamic voice content).

Example:

For the Cell Announcement service, define three instances of the MtasAnnouncementSegment MO, as follows:

3.3.4   Configure MtasAnnouncementVariable MO

Create the MtasAnnouncementVariable MO instance for each mtasAnnouncementSegment MO of type standalone voice variable type. The instance name of both MOs must be the same.

For the Cell Announcement service, the operator must define the MtasAnnouncementVariable MO with instance name as CellID.

Set the mtasAnnouncementVariableType attribute to T_digits. T-digits type is already defined in MTAS.

Example:

3.4   Service Data Management

This section describes how to configure the service data.

3.5   Operator Subscription Level Service Configuration

Provisioning specified in this section pertains to the data set through the EMA using CAI3G protocol. The <ssc-operator-configuration> must be activated for the subscriber.

<mc:supplemenary-service-codes>
		<mc:ssc-operator-configuration>
			<mc:activated>true</mc:activated>
		</mc:ssc-operator-configuration>
	</mc:supplementary-service-codes>

For more information, refer to MTAS Supplementary Service Codes Management Guideand MTAS CAI3G Interface.

3.6   Subscriber Subscription Level Service Configuration

No service data for the Cell announcement service is configured in the subscriber part of the subscriber data.

4   Performance Management

For measurements related to the Cell Announcement service, refer to Managed Object Model (MOM).

The following three new PM counters are introduced for the Cell Announcement service performance measurement:

5   Fault Management

Not applicable.

6   Additional Information

This section contains some additional information regarding cell announcements.

6.1   MtasGaAnn and Related MOs Configuration Examples

The examples in this section show the configuration of mtasGaAnn and related MOs.

Example 1   MtasGaAnn = CellServedAnnouncement

MtasGaAnn                       CellServedAnnouncement
mtasGaAnnPlayVideoAnnouncement  0
mtasGaAnnAVAudioCode            0
mtasGaAnnPlayAudioAnnouncement  1
mtasGaAnnAVVideoCode            0
mtasGaAnnAudioCode              0
mtasGaAnnSegmentVectors         CellAnnVector_01
mtasGaAnnVideoCode              0

Example 2   MtasGaAnn = CellNotServedAnnouncement

MtasGaAnn                       CellNotServedAnnouncement
mtasGaAnnPlayVideoAnnouncement  0
mtasGaAnnAVAudioCode            0
mtasGaAnnPlayAudioAnnouncement  1
mtasGaAnnAVVideoCode            0
mtasGaAnnAudioCode              0
mtasGaAnnSegmentVectors         CellAnnVector_02
mtasGaAnnVideoCode              0

Example 3   MtasSegmentedAnnouncements=0

MtasSegmentedAnnouncements=0
MtasSegmentVectors=0

MtasSegmentVector=CellAnnVector_01
(
- mtasSegmentVectorSegments=[cell_served_ann, CellID]
)

MtasSegmentVector=CellAnnVector_02
(
- mtasSegmentVectorSegments=[cell_not_served_ann]
)
MtasAnnouncementSegments=0

MtasAnnouncementSegment=cell_served_ann
(
- mtasAnnouncementSegmentType=Provisioned
)

MtasAnnouncementSegment=cell_not_served_ann
(
- mtasAnnouncementSegmentType=Provisioned
)

MtasAnnouncementSegment=CellID
(
- mtasAnnouncementSegmentType=StandAloneVoiceVariable
)
MtasAnnouncementVariables=0

MtasAnnouncementVariable=CellID
(
- mtasAnnouncementVariableType=T_digits
)

6.2   mtasSscCellAnn and Related MOs Configuration Example

The following example shows configuration of mtasSscCellAnn and related MOs.

Example 4   MtasSscCellAnn=0

mtasSscCellAnn=0
(
- mtasSscCellAnnComSyntInt= *48#,*48N#
- mtasSscCellAnnConfigs=s48h
- mtasSscCellAnnConfigs=s481h
)
mtasSscCellAnnouncementConfigs = 0
mtasSscCellAnnConfig=s48h
(
- mtasSscCellAnnConfigServAnn = CellServedAnnouncement
- mtasSscCellAnnConfigNotServAnn = CellNotServedAnnouncement
- mtasSscCellAnnConfigOpt= 
parameter=femto-utran-cell-id-3gpp,np=false,
rule=/^.*([0-9a-fA-F]{7})$/H'\1'/
)

mtasSscCellAnnouncementConfigs = 0
mtasSscCellAnnConfig=s481h
(
- mtasSscCellAnnConfigServAnn = CellServedAnnouncement
- mtasSscCellAnnConfigNotServAnn = CellNotServedAnnouncement
- mtasSscCellAnnConfigOpt=
parameter=femto-utran-cell-id-3gpp,np=false,
rule=/^.*([0-9a-fA-F]{7})$/H'\1'/
)

6.3   MTAS SSC Cell Ann MOC Model

Configuration of the new MTAS SSC Cell Announcement service including wholesale support.

Figure 1   MTAS SSC Cell Ann MOC Model

6.4   Cell ID Extraction from PANI Header

This section shows examples of cell ID extraction from the PANI header.

6.4.1   Example 1: Default Configuration

6.4.2   Example 2: Configuration Fault

6.4.3   Example 3: PANI Header with no femto-utran-cell-id-3gpp ID Value

6.4.4   Example 4: ‘rule’ Configuration Fault

6.4.5   Example 5: ‘rule’ Configuration Fault



Copyright

© Ericsson AB 2016. All rights reserved. No part of this document may be reproduced in any form without the written permission of the copyright owner.

Disclaimer

The contents of this document are subject to revision without notice due to continued progress in methodology, design and manufacturing. Ericsson shall have no liability for any error or damage of any kind resulting from the use of this document.

Trademark List
All trademarks mentioned herein are the property of their respective owners. These are shown in the document Trademark Information.

    MTAS Cell Announcement Management Guide         MTAS