MTAS Generic Announcement Management Guide

MTAS

1	Introduction
1.1	Prerequisites
2	Overview
2.1	Subfunctions
2.2	Play Generic Announcement
2.3	Interaction with Other Services
3	Generic Announcement Configuration
3.1	Configuration Activities
3.2	Wholesale for Generic Announcement Configuration
3.3	Service Data Configuration
4	Performance Management

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:

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.

Figure 1 Generic Announcement MO Structure

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.

4 Performance Management

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