Contents

1   Introduction

This document describes how to configure the Generic Announcement service in the MTAS.

1.1   Prerequisites

It is assumed that the user of this document is familiar with the O&M area, in general.

1.1.1   Licenses

To enable basic services in the MTAS, the MMTel license must be installed.

For more information about licensing, refer to MTAS Licenses

1.1.2   Documents

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

• Ericsson Command-Line Interface User Guide
• Managed Object Model (MOM)

1.1.3   Conditions

The following condition must apply:

An Ericsson Command-Line Interface (ECLI) session in Exec mode is in progress.

2   Overview

The Generic Announcement service allows the operator to associate a name with a combination of announcement parameters, so that the name can be used in other services to control the playing of an announcement.

A subfunction of the Generic Announcement service, called Segmented Announcement, also enables the controlling services to pass several voice variables. In turn, the Generic Announcement service is embedding these variables into the announcement.

2.1   Subfunctions

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

2.1.1   Segmented Announcement

The concept of segmented announcement is derived from the Basic Announcement Syntax package, as defined in ITU-T H.248.9 specification. The syntax defined by the package allows announcements to be described as a series of audio or multimedia segments, each of which has either been provisioned or is dynamically specified by the announcement description itself. The dynamically specified segments are referred as standalone voice variable segments.

For more information about ITU-T H.248.9, refer to ITU-T H.248.9: Gateway control protocol: Advanced media server packages

2.2   Play Generic Announcement

A service specified to use a Generic Announcement contains the name of that Generic Announcement either in some CM attribute or somewhere in the served XML document of the user.

In the served XML document of the user, the name of the Generic Announcement is either specified as simple character values inside the play-announcement action or in the "announcement-name" attribute of the play-segmented-announcement action.

For more information about the services, which use Generic Announcement service, refer to MTAS Announcement Management Guide

The service uses the attributes from the instance of MtasGaAnn with the specified name to play the announcement.

If there is no instance of MtasGaAnn with the specified name, no announcement is played.

2.3   Interaction with Other Services

The Generic Announcement service has no interaction with other services.

3   Generic Announcement Configuration

The Generic Announcement service is controlled by the MtasGaAnn Managed Object (MO).

An overview of the Generic Announcement MO structure is shown in Figure 1.

For configurable MOs and attributes, related to the Generic Announcement services, refer to Managed Object Model (MOM).

3.1   Configuration Activities

Configuration activities are listed in Table 1.

Table 1    Configuration Activities

Activity	Attribute
Defining whether this Generic Announcement plays an audio announcement, if support is available in the Session Description Protocol (SDP).	mtasGaAnnPlayAudioAnnouncement
Defining whether this Generic Announcement plays an audio-video announcement or a video announcement, if support is available in the SDP.	mtasGaAnnPlayVideoAnnouncement
Defining which audio-only announcement is to be played by this Generic Announcement.	mtasGaAnnAudioCode
Defining which video-only announcement is to be played by this Generic Announcement.	mtasGaAnnVideoCode
Defining which announcement is to be played as the audio component of an audio-video announcement by this Generic Announcement.	mtasGaAnnAVAudioCode
Defining which announcement is to be played as the video component of an audio-video announcement by this Generic Announcement.	mtasGaAnnAVVideoCode
Defining the Q.850 cause value which is to be included in the 183 Progress provisional response used to initiate this Generic Announcement.	mtasGaAnnCauseValue

For more information about the Generic Announcement attributes, refer to Managed Object Model (MOM).

3.2   Wholesale for Generic Announcement Configuration

The Generic Announcement service supports Wholesale. Generic Announcement is configurable on Virtual Telephony Provider level.

For every announcement attribute in the MtasGaAnn MO, shown in Table 1, there exists a corresponding attribute in the VtasGaAnn MO. To activate Wholesale for the Generic Announcement service, announcement attributes in the VtasGaAnn MO need to configure and the vtasGaDropBack attribute set to 0 (Use own VTP values).

For more information about the Wholesale service, refer to MTAS Wholesale Support Management Guide.

3.3   Service Data Configuration

This section describes how to configure the service data.

3.3.1   Operator Subscription Level Service Configuration

No service data for the Generic Announcement service is configured in the operator part of the subscriber data.

3.3.2   Subscriber Subscription Level Service Configuration

No service data for the Generic Announcement service is configured in the subscriber part of the subscriber data.

3.4   Segmented Announcement Configuration Example

In this example, definition descriptions may contain base dn entries. They are locally defined for each definition sections. They are there to improve the readability of this example. The reader should read as the given string is provided for each [base dn] entry.

Text with italic font is there to comment or explain specific values. These texts are not part of the settings.

In this example, an imaginary announcement is defined for a phone number change in the future.

Two options for this announcement are defined:

• One is for users calling from the United States.
• One is an international version.

Two differences are set:

• American supports en-US language tag, international supports fi (Finland) and sv (Sweden) language tags.
• The international version provides an extra Country Code; the American version has no such option.

The announcement provides information about the phone number (different for US and International versions) and the date of the change.

3.4.1   Generic Announcement Definition

dn: MtasGaAnn= TestGaAnnouncement, MtasGa=0, MtasMmt=0, MtasServices=0, applicationName=MtasFunction, nodeName=jambala
Attribute	Value
mtasGaAnnDescription:
MtasGaAnn:	ChangedPhoneGaAnnouncement
mtasGaAnnPlayAudioAnnouncement:	1
mtasGaAnnPlayVideoAnnouncement:	0
mtasGaAnnAudioCode:	0
mtasGaAnnVideoCode:	0
mtasGaAnnAVAudioCode:	0
mtasGaAnnAVVideoCode:	0
mtasGaAnnCauseValue:	0
mtasGaAnnTone:
mtasGaAnnSegmentVectors:	ChangedPhoneNumber_US
mtasGaAnnSegmentVectors:	ChangedPhoneNumber_Int

3.4.2   Segment Vector Definition

base dn: MtasSegmentVectors=0, MtasSegmentedAnnouncements=0, MtasMediaFramework=0, applicationName=MtasFunction, nodeName=jambala

dn: MtasSegmentVector=ChangedPhoneNumber_US, [base dn]
Attribute	Value
MtasSegmentVector:	ChangedPhoneNumber_US
mtasSegmentVectorLanguages:	undefined
mtasSegmentVectorLanguages:	en-US
mtasSegmentVectorSegments:	new_code_is
mtasSegmentVectorSegments:	NewAreaCode
mtasSegmentVectorSegments:	new_number_is
mtasSegmentVectorSegments:	NewNumber
mtasSegmentVectorSegments:	available_from
mtasSegmentVectorSegments:	Available

dn: MtasSegmentVector= ChangedPhoneNumber_Int, [base dn]
Attribute	Value
MtasSegmentVector:	ChangedPhoneNumber_Int
mtasSegmentVectorLanguages:	fi
mtasSegmentVectorLanguages:	sv
mtasSegmentVectorLanguages:	new_country_code_is
mtasSegmentVectorLanguages:	NewCountryCode
mtasSegmentVectorLanguages:	new_area_code_is
mtasSegmentVectorLanguages:	NewAreaCode
mtasSegmentVectorLanguages:	new_number_is
mtasSegmentVectorLanguages:	NewNumber
mtasSegmentVectorLanguages:	available_from
mtasSegmentVectorLanguages:	Available

3.4.3   Segment Definition

base dn: MtasAnnouncementSegments=0, MtasSegmentedAnnouncements=0, MtasMediaFramework=0, applicationName=MtasFunction, nodeName=jambala

dn: MtasAnnouncementSegment= new_country_code_is, [base dn]
Attribute	Value
mtasAnnouncementSegmentType:	0 [provisioned]
MtasAnnouncementSegment:	new_country_code_is

dn: MtasAnnouncementSegment= NewCountryCode, [base dn]
Attribute	Value
mtasAnnouncementSegmentType:	1 [mandatory standalone voice variable]
MtasAnnouncementSegment:	NewCountryCode

dn: MtasAnnouncementSegment=new_code_is, [base dn]
Attribute	Value
mtasAnnouncementSegmentType:	0 [provisioned]
MtasAnnouncementSegment:	new_code_is

dn: MtasAnnouncementSegment=NewAreaCode, [base dn]
Attribute	Value
mtasAnnouncementSegmentType:	1 [mandatory standalone voice variable]
MtasAnnouncementSegment:	NewAreaCode

dn: MtasAnnouncementSegment=new_number_is, [base dn]
Attribute	Value
mtasAnnouncementSegmentType:	0 [provisioned]
MtasAnnouncementSegment:	new_number_is

dn: MtasAnnouncementSegment=NewNumber, [base dn]
Attribute	Value
mtasAnnouncementSegmentType:	1 [mandatory standalone voice variable]
MtasAnnouncementSegment:	NewNumber

dn: MtasAnnouncementSegment=available_from, [base dn]
Attribute	Value
mtasAnnouncementSegmentType:	0 [provisioned]
MtasAnnouncementSegment:	available_from

dn: MtasAnnouncementSegment= Available, [base dn]
Attribute	Value
mtasAnnouncementSegmentType:	1 [mandatory standalone voice variable]
MtasAnnouncementSegment:	Available

3.4.4   Type Definition of Voice Variable Segments

base dn: MtasAnnouncementVariable=NewAreaCode,MtasAnnouncementVariables=0, MtasSegmentedAnnouncements=0, MtasMediaFramework=0,
applicationName=MtasFunction, nodeName=jambala

dn: MtasAnnouncementVariable= NewCountryCode, [base dn]
Attribute	Value
MtasAnnouncementVariable:	NewCountryCode
mtasAnnouncementVariableType:	T_digits

dn: MtasAnnouncementVariable=NewAreaCode, [base dn]
Attribute	Value
MtasAnnouncementVariable:	NewAreaCode
mtasAnnouncementVariableType:	T_digits

dn: MtasAnnouncementVariable= NewNumber, [base dn]
Attribute	Value
MtasAnnouncementVariable:	NewNumber
mtasAnnouncementVariableType:	T_digits

dn: MtasAnnouncementVariable= Available, [base dn]
Attribute	Value
MtasAnnouncementVariable:	Available
mtasAnnouncementVariableType:	T_date

3.4.5   Definition of String Representation of Variable Types

base dn: MtasBuiltInVariableTypes=0, MtasSegmentedAnnouncements=0, MtasMediaFramework=0, applicationName=MtasFunction, nodeName=jambala

dn: MtasBuiltInVariableType=T_digits, [base dn]
Attribute	Value
MtasBuiltInVariableType:	T_digits
mtasBuiltInVariableTypeTypeString:	digits
mtasBuiltInVariableTypeSubtypeString:	[empty]

dn: MtasBuiltInVariableType= T_date, [base dn]
Attribute	Value
MtasBuiltInVariableType:	T_date
mtasBuiltInVariableTypeTypeString:	date
mtasBuiltInVariableTypeSubtypeString:	dmy [options: dmy/mdy]

4   Performance Management

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