Вы находитесь на странице: 1из 378

Lucent Gateway Platform

Billing and Traffic Collection Guide

Part Number 255-400-403R3.8


Issue 5, January 9, 2004
Software Version 3.8

Copyright 2005 Lucent Technologies


All Rights Reserved

Copyright 2005 by Lucent Technologies. All Rights Reserved.


This material is protected by the copyright laws of the United States and other countries. It may not be reproduced, distributed, or altered in any fashion by any
entity (either internal or external to Lucent Technologies), except in accordance with applicable agreements, contracts, or licensing, without the express written
consent of the Customer Training and Information Products organization and the business management owner of the material.
For permission to reproduce or distribute, please contact the following:
Product Development Manager 1 888-LTINFO6 (domestic)
1-317-322-6848 (international)

Notice
Every effort has been made to ensure that the information in this document was complete and accurate at the time of printing. However,
information is subject to change.
Mandatory customer information

Trademarks
All trademarks and service marks specified herein are owned by their respective companies.
Ordering information
The order number of this document is 255-400-403R3.8.
Support
Technical support
Please contact your Lucent Technologies Local Customer Support Team (LCS) for technical questions about the information in this document.
Information product support
To comment on this information product online, go to http://www.lucent-info.com/comments or email your comments to comments@lucent.com.

Billing and Traffic Collection Guide

Issue 5, January 9, 2004

Manual Contents
1. Contents of this Manual
This volume contains descriptions of the applications for capturing billing and traffic
statistical information as well as procedures for installing and updating these
applications.
Release Notes can be obtained by contacting Telica Technical Services at 888-4408354 or 888-440-TELI.
Following is a listing of the tabs and documents of this manual. Documents are
listed by name followed with its section number and its issue number and date on the
same line.
Contents
About This Guide

150-050-100
150-100-000

Issue 5, Jan. 9, 2004


Issue 2, May 13, 2003

1. Pro Billing
PlexView Pro Billing System

150-200-100

Issue 2, May 13, 2003

2. ASCII Billing
PlexView ASCII Billing Server

150-200-200

Issue 2, Dec. 19, 2003

3. AMA Lite
AMA Lite Billing Servers

150-200-300

Issue 2, Oct. 10, 2003

4. Traffic Collection
PlexView Traffic Collection Application

150-200-400

Issue 3, Dec. 12, 2003

5. Billing and Traffic System


PlexView Billing and Traffic System

150-200-500

Issue 4, Jan. 9, 2004

6. ASCII Billing Reports


ASCII Billing Reports

150-300-100

Issue 5, Jan. 9, 2004

7. AMA Lite Reports


AMA Lite Reports

150-300-200

Issue 2, Jan. 9, 2004

8. Traffic Statistics Reports


Traffic Statistics Reports

150-300-300

Issue 3, Jan. 9, 2004

Telica, Inc.

9. Procedures
Task Oriented Practices (TOPS)
Procedures Checklist
Provisioning Task Index List
Detailed Level Procedures

150-500-100
150-500-200
150-500-300
150-500-400

Issue 2, May 13, 2003


Issue 4, Jan. 9, 2004
Issue 2, Jan. 9, 2004

10. Acronyms
Acronyms

150-800-000

Issue 3, Nov. 14, 2003

Appendix
Appendix A Release Causes

150-900-000

Issue 1, Mar. 28, 2003

Index
Index

150-900-900

Issue 3, Jan. 9, 2004

Telica, Inc.

Contents

1.

PlexView Pro Billing System ........................................................1-1


1.1
1.2
1.3
1.4
1.5

2.

PlexView ASCII Billing Server (ABS).........................................2-1


2.1
2.2
2.3
2.4

3.

Introduction ..............................................................................................3-1
Features ....................................................................................................3-2
How the Transfer Works ..........................................................................3-3

PlexView Traffic Collection Application (TCA).........................4-1


4.1
4.2
4.3
4.4

5.

Introduction ..............................................................................................2-1
Features ....................................................................................................2-2
How the Transfer Works ..........................................................................2-2
Configuration and Operation....................................................................2-8

PlexView AMA Lite.......................................................................3-1


3.1
3.2
3.3

4.

Scope ........................................................................................................1-1
Overview ..................................................................................................1-1
PlexView Pro Billing System Requirements ...........................................1-2
Automatic Message Accounting Data Networking System.....................1-2
PlexView AMA Billing Module ..............................................................1-2

Introduction ..............................................................................................4-1
Features ....................................................................................................4-2
How Statistical Information is Generated ................................................4-3
Installation and Configuration................................................................4-14

PlexView Billing and Traffic System ...........................................5-1


5.1
5.2
5.3
5.4

Introduction ..............................................................................................5-2
Features ....................................................................................................5-3
How the Transfer Works ..........................................................................5-4
Provisioning for the Billing and Traffic System ......................................5-6

Contents

6.

ASCII Billing Reports .....................................................................6-1


6.1
6.2
6.3
6.4
6.5
6.6
6.7

7.

Introduction ..............................................................................................7-2
CDR and AMA Lite Formats ...................................................................7-2
Module Inclusion Rules ...........................................................................7-8
Module Number 164 ..............................................................................7-16
Call Types, Structure Codes, and Modules ............................................7-19
Configuration and Operation..................................................................7-20

Traffic Statistics Reports ................................................................8-1


8.1
8.2
8.3

9.

Introduction ..............................................................................................6-2
CDR and ABS Formats ............................................................................6-2
ASCII-Format Master Record Field Descriptions ...................................6-9
Module Inclusion Rules .........................................................................6-60
Module Number 164 ..............................................................................6-69
Call Types, Structure Codes, and Modules ............................................6-72
Configuration and Operation..................................................................6-73

AMA Lite Reports ...........................................................................7-1


7.1
7.2
7.3
7.4
7.5
7.6

8.

Issue 5, January 9, 2004

Introduction ..............................................................................................8-1
Types of Statistics and Reports ................................................................8-2
Installation and Configuration................................................................8-29

TOP Procedures...............................................................................9-1
9.1
9.2
9.3

Task Oriented Practices (TOPS) ..............................................................9-1


Procedures Checklist ................................................................................9-3
Provisioning Task Index List ...................................................................9-5

Telica, Inc

ii

List of Figures
Figure 1-1.
Figure 1-2.
Figure 2-1.
Figure 3-1.
Figure 4-1.
Figure 5-1.
Figure 5-2.
Figure 6-1.
Figure 7-1.
Figure 9-1.

AMADNS Architecture................................................................................1-2
PlexView AMA Billing................................................................................1-3
PlexView ASCII Billing Conversion Details ...............................................2-3
PlexView AMA Billing Conversion Details ................................................3-3
PlexView TCA Statistics Retrieval Process .................................................4-4
The Plexus and the Billing and Traffic System............................................5-4
Traffic Collection Application .....................................................................5-5
Long Duration Call Sample........................................................................6-63
Long Duration Call Sample........................................................................7-10
Craft-port Login Screen..............................................................................9-43

List of Tables
Table 2-A. Sample abs.conf File.....................................................................................2-4
Table 3-A. Sample ama.conf File....................................................................................3-4
Table 4-A. Sample tsds.conf File ....................................................................................4-5
Table 4-B. Sample tsaa_<prefix>.conf File ...................................................................4-8
Table 5-A. plexusDc.ini File ...........................................................................................5-7
Table 5-B. Sample tsaa_<prefix>.conf File ...............................................................5-27
Table 6-A. ABS-supported AMA Call Types.................................................................6-3
Table 6-B. List of Fields in the Master Record...............................................................6-4
Table 6-C. Call Types Supported by the Plexus 9000 ..................................................6-10
Table 6-D. Structure Codes...........................................................................................6-11
Table 6-E. Module Numbers and Descriptions.............................................................6-60
Table 6-F. Call Forwarding Module 164 Population Chart ..........................................6-71
Table 6-G. Call Types, Modules and Structure Code 0625 .........................................6-74
Table 7-A. Call Types Supported by the Plexus 9000 ....................................................7-3
Table 7-B. Structure Codes .............................................................................................7-4
Table 7-C. Header of AMA Lite Record.........................................................................7-5
Table 7-D. Fields in the AMA Lite Record ....................................................................7-5
Table 7-E. List of Fields in the Master Record ...............................................................7-6
Table 7-F. Module Numbers and Descriptions ...............................................................7-8
Table 7-G. Call Types, Modules and Structure Code 0625 .........................................7-21
Table 7-H. Plexus 9000 AMA Record Mapping to Telcordia GR-1100 ......................7-25
Table 9-A. Sample abs.conf File.....................................................................................9-9
Table 9-B. abs.conf File ................................................................................................9-14
Table 9-C. Sample abs.conf File ...................................................................................9-19
Table 9-D. Sample ama.conf File..................................................................................9-23
Table 9-E . ama.conf File ..............................................................................................9-28
Table-9-F. ama.conf File...............................................................................................9-34
Table 9-G. Sample tsds.conf File ..................................................................................9-61
Table 9-H. Sample tsaa_<prefix>.conf File.................................................................9-62

iii

Telica, Inc

Contents

Issue 5, January 9, 2004

Table 9-I. S99PLXStats File ..........................................................................................9-63


Table 9-J. Display of Package Add ...............................................................................9-63
Table 9-K. tsds.conf File ...............................................................................................9-68
Table 9-L. tsaa.conf File ...............................................................................................9-69
Table 9-M. tsds.conf File...............................................................................................9-79
Table 9-N. tsaa.conf File...............................................................................................9-80
Table 9-O. Display of Package Add..............................................................................9-81
Table 9-P. MAIN Entity Configuration Section of PlexusDC.ini File .........................9-92
Table 9-Q. Receiver Entity Configuration Section of PlexusDC.ini File .....................9-93
Table 9-R. Billing Entity Configuration Section of PlexusDC.ini File ........................9-93
Table 9-S. Output Options Section of PlexusDC.ini File ............................................9-95
Table 9-T. ASCII/BAF (AMA Lite) File Parameters Section of PlexusDC.ini File ....9-96
Table 9-U. PlexView Pro Parameters Section of PlexusDC.ini File ............................9-96
Table 9-V. ASCII and BAF Push Configuration ..........................................................9-97
Table 9-W. Statistics Entity Configuration Section of PlexusDC.ini File....................9-98
Table 9-X. S99PlexDC File (partial).............................................................................9-99
Table 9-Y. PlexusDc.ini File.......................................................................................9-104
Table 9-Z. S99PlexDC File (partial) ...........................................................................9-108
Table 9-AA. Display of Package Add.........................................................................9-108
Table 9-BB. S99PlexDC File (partial) ..........................................................................9-76
Table 9-CC. PlexusDc.ini File ......................................................................................9-81
Table 9-DD. S99PlexDC File (partial)..........................................................................9-86
Table 9-EE. Display of Package Add............................................................................9-87

Telica, Inc

iv

Billing and Traffic Collection Guide

Section 150-100-000

About This Guide


The Billing and Traffic Collection Guide describes PlexView Pro Billing,
ASCII Billing Server (ABS), AMA Lite and the Traffic Collection
Application (TCA) as well the Billing and Traffic System (BTS). It also
provides procedures to install and upgrade these applications on a Sun
server.
Architecture Prior to System Software Version 3.8
The Plexus handles billing and traffic collection differently depending
upon the system software version running on the switch. For a Plexus
with a version of software earlier than version 3.8 (i.e., 1.4 (aka 3.1.1.4),
3.5, 4.3 (aka 3.4.3)) two raw call detail records (CDRs) are generated for
every call and formatted in AMA like objects and written to a circular
buffer for billing on the switch. Traffic CDRs are formatted into their own
version and written to another circular buffer. On the Plexus, Generating
system to Data server Interface (GDI) transmitters are running. They read
the circular files and transmit the data over a TCP/IP connection to the
appropriate server (ABS, AMA Lite or PlexView Pro Billing and TCA)
where the data is collected by a GDI receiver and formatted into billing or
traffic data. Billing information could only be used by one server.
Architecture for System Software Version 3.8 or Higher
For a Plexus with software version 3.8 or greater, one CDR will be
generated for both billing and traffic and formatting of the CDR is not
done on the Plexus. Raw CDRs are transmitted in real time if the
connection to Billing and Traffic System (BTS) server is available. If a
BTS is not available, the CDRs are written to a circular buffer on the
Plexus.
At the BTS, a GDI receiver collects the data from the Plexus and
multiplexes the same CDR into a traffic collection handler and a billing
handler. Traffic collection CDRs will be formatted and maintained in
memory or disk file depending on the nature of the stats data. Billing
CDRs are formatted into AMA like objects. For ASCII billing, CDRs are
formatted and written by the billing handler and for PlexView Pro Billing,
data is written to a circular buffer and then sent to the Pro Billing Data
Server.

Telica, Inc

Introduction

Issue 2, May 13, 2003

Audience
This document is for system administrators, craft personnel, and operators
responsible for gathering billing and/or traffic statistics on one or more
associated servers and Plexus 9000 switches. It is assumed that you have
a working knowledge Unix and of the operations of a Sun server.
Part Number
The part number for the guide is PN-79-6021.
Related Documentation
Table A provides a listing and a description of all documentation, printed
and CD-ROM, available for the Plexus 9000.

Part
Number
79-6002
79-6003

Manual Title

Table A. Documentation
Description

Plexus 9000 Installation and


Operations Manual
Plexus 9000 TL1 Commands
Reference Guide

79-6004

Plexus 9000 Planning and


Engineering Guide

79-6005

Plexus 9000 Core


Documentation Set

79-6006

Plexus 9000 Install and TL1


Documentation Set

79-6007

Plexus 9000 Customer


Documentation CD-ROM

Telica, Inc

Contains Plexus 9000 installation and


provisioning procedures.
Provides a listing and description of all
the TL1 commands needed to provision
the Plexus 9000.
Provides information regarding the items
necessary for designing a Plexus 9000
installation site. These include such
things as: hardware specifications,
cabling requirements, cabling
schematics, floor plan requirements,
environmental requirements, and power
requirements. It also includes hardware
descriptions of chassis and modules.
Consists of the Installation and
Operations Manual (79-6002); the TL1
Commands Reference Guide (79-6003);
and the Planning and Engineering Guide
(79-6004).
Consists of the Installation and
Operations Manual (79-6002) and the
TL1 Commands Reference Guide
(79-6003).
Contains the manuals and release notes
of the core documentation set in Adobe
Acrobat PDF format.

vi

Billing and Traffic Collection Guide

Section 150-100-000

Part
Number
79-6008

Manual Title

Description

PlexView Pro Billing System


User Guide

79-6009

PlexView Pro Billing System


User Guide CD-ROM
PlexView Element
Management System (EMS)
User Guide
PlexView Element
Management System
Installation Guide

Explains the procedures necessary to


operate, administer, and maintain the
Billing System.
Contains the Billing System manual in
Adobe Acrobat PDF format.
Explains how to use the EMS to
provision and control the Plexus 9000.

79-6010

79-6011

79-6012

PlexView EMS Documentation


CD-ROM

79-6014

Plexus 9000 Media Gateway


Installation and Operations
Manual
Plexus 9000 Media Gateway
Planning and Engineering
Guide

79-6015

79-6016

79-6017

79-6018

vii

Plexus 9000 Media Gateway


TL1 Commands Reference
Guide
Plexus 9000 Media Gateway
Customer Documentation CDROM
Plexus 9000 Media Gateway
Core Documentation Set

Provides procedures for installing the


EMS software on a Sun workstation. In
printed form, is bound with the
PlexView EMS User Guide.
Consists of the PlexView EMS User
Guide (79-6010), the PlexView EMS
Installation Guide (79-6011), and the
PlexView EMS Release Notes.
Contains installation and provisioning
procedures.
Provides information regarding the items
necessary for designing a Plexus 9000
Media Gateway installation site. These
include such things as: hardware
specifications, cabling requirements,
cabling schematics, floor plan
requirements, environmental
requirements, and power requirements.
It also includes hardware descriptions of
chassis and modules.
Provides a listing and description of all
the TL1 commands needed to provision
the Plexus 9000 Media Gateway.
Contains the Plexus 9000 Media
Gateway manuals and release notes of
core documentation set in Adobe
Acrobat PDF format.
Consists of the Media Gateway
Installation and Operations Manual
(79-6014), the Media Gateway Planning
and Engineering Guide(79-6015), and
the Media Gateway TL1 Commands
Reference Guide (79-6016).

Telica, Inc

Introduction
Part
Number
79-6022

79-6026

Issue 2, May 13, 2003


Manual Title

Description

Maintenance and
Troubleshooting Guide

Provides information about maintaining


a Plexus, alarm tables and procedures for
maintaining and troubleshooting alarms.
Contains the Billing and Traffic
Collection Guide and release notes in
Adobe Acrobat PDF format.

Billing and Traffic Collection


CD-ROM

Manual Organization
The title page of this guide displays the part number, issue number and
date, and release number. The Manual Contents follow the title page, and
list the various sections in the manual, and the issue number and date for
each document in a section. Comparing manual contents from one version
to the next enables you to quickly identify what has changed and what has
remained the same.
This Billing and Traffic Statistics Guide contains information about billing
and traffic applications. Billing and Traffic System (BTS), Traffic
Collection Application (TCA), ASCII Billing System (ABS) and AMA
Lite release notes can be obtained by contacting your sales engineer or
technical services personnel. Release notes contain a list of changes and
enhancements since the previous version.
This guide is organized into the following sections:

Telica, Inc

The Introduction contains a description of this guide.

PlexView Pro Billing System

PlexView ASCII Billing Server

PlexView AMA Lite

PlexView Traffic Collection Application (TCA)

PlexView Billing and Traffic System (BTS)

TOP Procedures

Acronyms

Appendix Release Causes

Index

viii

Billing and Traffic Collection Guide

Section 150-100-000

Using the CD-ROM


Like many manuals today, this one has a CD-ROM that may be inserted in
a pocket on the back of the binder cover or it may also be part of the
CD-ROM inserted in the Installation and Operation Manual. When
inserted into a drive, the CD-ROM will automatically open to the main
menu page. From this page, you can select the Guide.
When using the Guide you can move to different areas using the
bookmarks on the left side of the page. Clicking on the + sign in front of a
topic will expand it, clicking on the sign will minimize it. Table of
Contents information in blue font will also move you to that identified
topic. Titles in blue font will return to the first page of the Guide.
Clicking on the title of the first page will return you to the Main Menu
page.
Conventions Used in This Guide
This guide uses the following conventions, when appropriate:
Convention
Courier new
Italics
Angle brackets < >
Square brackes [ ]

ix

Indicates
Command syntax
Book titles, new terms, file names, emphasized
text
Parameter delimiters
Optional parameters

Telica, Inc

Introduction

Issue 2, May 13, 2003

NOTES:

Telica, Inc

1.
1.1
1.2
1.3
1.4
1.5

PlexView Pro Billing System


Scope ....................................................................................................................1-1
Overview ..............................................................................................................1-1
PlexView Pro Billing System Requirements .......................................................1-2
Automatic Message Accounting Data Networking System.................................1-2
PlexView AMA Billing Module ..........................................................................1-2
1.5.1 Plexus 9000 Generating System...............................................................1-3
1.5.2 Data Server...............................................................................................1-4
1.5.3 Data Processing and Management System (DPMS) ...............................1-4

Note: To avoid local time synchronization problems, Telica strongly


recommends setting the Plexus system clock to use GMT.

1.1 Scope
This section describes the PlexView Pro Billing System (PPBS) available
from Telica to generate accurate call detail records (CDRs) in critical
revenue-generating environments. The PlexView ASCII Billing Server
(ABS), which also runs on a Sun computer platform, is described in
PlexView ASCII Billing Server (ABS), Section 110-220-150, of this
manual.

1.2 Overview
The PlexView Pro Billing System (PPBS) is a software package available
from Telica to work as an extension of the Plexus 9000 to generate
accurate call detail records (CDR) in critical revenue-generating
environments with non-stop, non-drop performance. It interoperates with
third party billing management systems from Lucent and others, and
supports the verification and viewing of historical records and files. The
PlexView Pro Billing System supports the AMADNS (automatic message
accounting data networking system) architecture.

PlexView
Pro Billing System

Issue 2, May 13, 2003

1.3 PlexView Pro Billing System Requirements


The PlexView Pro Billing System is available either as a standalone
application, as a branch of the PlexView Billing and Traffic System (BTS)
or with the PlexView Element Management System (EMS) and requires
the following:

Sun Solaris 7 or 8 System with 256MB memory and a 10/100


Ethernet card. The minimum recommended system is the
Sun Ultra 10.
Plexus 9000 running software version Release 2.1 or greater.
Procedures to operate, administer and maintain the PlexView Pro Billing
System are available in PlexView Pro Billing System Installation and
Operation Manual. Procedures allow customization to meet many billing
configuration options and support new AMA structure codes and module
formats.

1.4 Automatic Message Accounting Data Networking System


Automatic Message Accounting (AMA) is the process of measuring and
accounting for the use of switch network resources by customers and
carriers. The AMADNS architecture is illustrated in Figure 1-1. Data that
is generated during the process must be moved from generation points
(e.g., Plexus 9000) to application points (e.g., Billing Systems). During
the transfer the data must be processed and managed. This is done by the
Data Server and the Data Processing and Management System (DPMS).

Generating
System

Data
Server

Data Processing
and Management
System

Application
System

P269-AA
01-08-01

Figure 1-1. AMADNS Architecture

1.5 PlexView AMA Billing Module


The PlexView Pro Billing System is the intermediary between the Plexus
9000 and the Data Processing and Management System (DPMS). It acts
as the Data Server that receives generates call detail records (CDRs) and
formats them into Bellcore AMA Format (BAF) records for the DPMS.
Figure 1-2 illustrates the PlexView Pro Billing architecture.

1-2

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-200-300

Sun
Work
Station

BAF Files

CDRs

Plexus 9000

FTP

TCP/IP
Active
Standby

Data Processing
and Management
System

PlexView Billing
Module

Billing
Application

Sun Server

Switch
Interface

Data
Collection

Formatter
Interface

File
Storage

DDI_Client

Pri
ma
ry
Se
co
nd
ar
y

Circular
Buffer
Memory

P345-AA
01-08-01

Figure 1-2. PlexView AMA Billing

1.5.1 Plexus 9000 Generating System


The generating system is the Plexus 9000 that generates CDRs and
transmits them to the data server through the Ethernet ports and network
using TCP/IP every 5 seconds. The generating system may also be
referred to as a billing source, a network element or a switch.
If the Plexus fails over to the standby System Processor, it immediately
begins transmitting records. If communication between the Plexus and the
PlexView Billing Module and Sun workstation is lost, the Plexus keeps
records in a circular buffer while continually trying to reestablish
communication. When communication is restored, the Plexus will request
the last sequence number from the billing module workstation and then it
will send all stored records.

Telica, Inc.

1-3

PlexView
Pro Billing System

Issue 2, May 13, 2003

1.5.2 Data Server


The data server receives CDRs from the Plexus 9000 and completes the
following:

1.5.3

Formats the CDRs in the Automatic Message Accounting Data


Network System (AMADNS) format so they can be sent to the
Data Processing and Management System (DPMS).
Stores the formatted AMADNS records until they are transmitted
to the DPMS.
Sends the primary AMADNS records when scheduled or as soon
as they are formatted and ready and stores a copy as a secondary
file.
Transmits secondary AMADNS billing records when requested.

Data Processing and Management System (DPMS)


The DPMS is any system that processes AMADNS billing records. It
might also be referred to as a billing entity, a host collector or a client or
billing application. The Plexview Billing Module can communicate with
DPMSs available from Lucent, TeleSciences, CGI, AceComm, MetaPath
and Ericson/HP.

1-4

Telica, Inc.

2.
2.1
2.2
2.3

2.4

PlexView ASCII Billing Server (ABS)


Introduction ..........................................................................................................2-1
Features ................................................................................................................2-2
How the Transfer Works ......................................................................................2-2
2.3.1 ABS Verification of Plexus 9000 IP Address ..........................................2-3
2.3.2 Fields of the abs.conf File ........................................................................2-5
2.3.3 Plexus 9000 and ABS Connection ...........................................................2-7
2.3.4 ABS Receipt of CDR ...............................................................................2-7
2.3.5 Transfer of Information............................................................................2-8
Configuration and Operation................................................................................2-8

Note: To avoid local time synchronization problems, Telica strongly


recommends setting the Plexus system clock to use GMT.

2.1 Introduction
The PlexView ASCII Billing Server (ABS), which runs on a Sun
computer platform, works with the Plexus 9000 switch to convert Call
Detail Records (CDRs) to an ASCII record format. The Plexus 9000
sends a CDR for each attempted call over TCP/IP to the ABS. The ABS
then extracts the information from the CDR and writes it to a master
ASCII record format, storing the record on the Sun server. Each record is
appended to an active file over a previously configured amount of time not
exceeding 24 hours. At the expiration of the configured time period, the
active file with its collection of call records is saved on the Sun server, and
a new active file for storing records is opened. The customer can retrieve
the stored file and, because of comma-delimited fields, import it into
another application, such as Excel, for post-processing and bill creation.
Note: When importing stored file into an Excel spreadsheet, leading zeros
and tenths of seconds may be truncated.
For a description of the master ASCII record and its fields, refer to ASCII
Billing Reports section of this manual.

PlexView ASCII Billing Server

Issue 2, December 19, 2003

2.2 Features
The PlexView ABS offers these features:

Ability to capture CDRs and convert them to ASCII format.

Accurate and continuous capturing and storing of ASCII


records in the event of failover. The ABS supports the ability of
the Plexus 9000 to fail over to the standby system processor by
maintaining a standby connection and continuing to add records to
the appropriate data files. This ensures accurate and continuous
capturing and storing of ASCII billing records on an external Sun
platform even in the event of a Plexus 9000 system processor
failure.

Maintains statistical information. The ABS maintains various


statistics for each connected client; specifically, total number of
received octets, number of received CDRs, number of out-of-order
sequence numbers, number of header errors, number of transmitted
octets, number of transmitted last-sequence records, number of
times reached wrap-around, number of times write failed, and
number of times read failed. These statistics are outputted to the
prefix.log file when the connection drops between the ABS and the
Plexus 9000.

No loss of records in the event of a short-term communications


failure. The Plexus also has a 616 MB circular buffer that holds
up to 4.5 million records, or calls, ensuring that you lose no
records should there be a short-term communications failure.

2.3 How the Transfer Works


The Plexus 9000, in conjunction with the ABS, completes the following
steps to successfully transfer a CDR to the ABS:

2-2

Plexus 9000 attempts to send a CDR for a completed call to the


ABS
ABS verifies the authenticity of the Plexus 9000 IP address
from which the CDR is being sent
ABS accepts the connection and creates a connection control
block
ABS opens an ASCII CDR file
ABS sends the Plexus 9000 the last received sequence number,
thus beginning the transfer of information
ABS receives CDRs and converts them to an ASCII-format
master record

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-200-200

Refer to Figure 2-1 for an illustrated example of the ABS conversion


process.
Signaling
Process
GDI (CDRs)
TCP/IP
Active
PlexView
ASCII Billing
Module

Standby
Call
Detail
Records

Sun Server
TM

Circular
Buffer

Allows ASCII files to be written


once a day, hourly, or every x
minutes (configurable).

Memory

The customer is responsible for


managing file space and for any
postprocessing of ASCII records.
GDI

616MB
Disk
Buffer

Switch
Interface
Master
Record
ASCII
Converter

P505-AA
12-12-02

ASCII
File
Storage

Figure 2-1. PlexView ASCII Billing Conversion Details

2.3.1

ABS Verification of Plexus 9000 IP Address


The Plexus 9000 uses the TCP/IP connection between the ABS and the
Plexus 9000 switches to send CDRs to the ABS. In order to make this
connection, the Plexus 9000 IP address or name needs to be previously
configured into the ABS configuration file (abs.conf). Refer to Table 2-A
for a sample of the abs.conf file. The fields that may require changes are
shown in boldface type. Refer to the procedures section of this manual
and DLP-502 for instructions to edit this file. The procedures for
provisioning the Plexus 9000 for the ASCII Billing application are found
in the Plexus 9000 Installation and Operation Manual and NTP-018.
The ABS can then listen on the configured port (defaults to port 1983),
verifying a match between the Plexus 9000 IP address and the IP address
contained within the abs.conf file. When the IP addresses match, the
connection is made.

Telica, Inc.

2-3

PlexView ASCII Billing Server

Issue 2, December 19, 2003

Table 2-A. Sample abs.conf File


#
#
#
#

FileName: abs.conf
Telica ASCII Billing Server configuration environment
Server TCP listen Port number and working directory
SERVER_PORT
1983

Working Directory - contains data, connection info and log files


DATA_DIR
data

#
#
#
#
#

ASCII Billing file writing/creation frequency in minutes


Must be integer interval of minutes within 24 hours. Intervals are
always based on an initial start time of Midnight.
Defaults to 24 Hours (60min * 24hr = 1440 min)
Valid values = 5-1440
FREQUENCY
1440

#
#
#
#
#
#
#

Uncomment the following line to have raw CDR records from the switch
archived with the same frequency as AMA data files. The archive
files use the same name, but the extension is .dat
The value define the number of days an archive file is left on the
system before it is automatically deleted.
WARNING: This may require a VERY large disk!
ARCHIVE
31

#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#

Client switches (usually SPA/SPB pairs use the same prefix but it is
not a requirement)
Prefix may be followed by TZ and/or SensorID/OfficeID.
TZ specifies the client's time zone.Clients which have the
same prefix should be in the same time zone. Time zone is used to
calculate the time in the file names.
For detailed description of the rules for defining TZ,
See environ(5) for a description of the TZ environment variable.
TZ values used in US:
EST5EDT
(Eastern Time, Daylight Savings Time applies)
CST6CDT
(Central Time, Daylight Savings Time applies)
PST8PDT
(Pacific Time, Daylight Savings Time applies)
MST7MDT
(Mountain Time, Daylight Savings Time applies)
If the configured TZ is invalid, then GMT, if no TZ is provided
then server's time zone is used for time calculations.
SensorID/OfficeID will override
the AMA Sensor ID and/or Recording Office ID sent from the switch.
Valid SensorID/OfficeID values = 000000-999999
Plexus-9000 host processors (name or doted IP address)
CLIENT name or IP
File Prefix
------ -------------------CLIENT bostonSPA
Boston
TZ=EST5EDT
CLIENT bostonSPB
Boston
TZ=EST5EDT
CLIENT
CLIENT

2-4

sfoSPA
sfoSPB

SanFrancisco
SanFrancisco

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-200-200

CLIENT
CLIENT

denverSPA
denverSPB

DenverA
DenverB

TZ=MST7MDT
TZ=MST7MDT

SensorID=123456
OfficeID=789012

CLIENT

10.0.0.26

Marlboro

SensorID=345678:OfficeID=901234

CLIENT

10.0.0.27

Marlboro

Note: There can be up to sixteen (16) CLIENT entries for connection to up to eight (8)
Plexus 9000 switches. Delete extra CLIENT entries.
2.3.2

Fields of the abs.conf File


SERVER_PORT
The TCP server port is 1983 and does not need to be changed. This is the
port of the server that receives the CDRs.
DATA_DIR
The working directory for data, connection information and log files is
data and does not need to be changed. In the sample, it is set to data
which is the default.
FREQUENCY
The frequency that files are sent to the server may be changed. The
default is 1440 minutes, which is the maximum interval and is equal to
one day or 24-hours. The start time is midnight. The smallest interval is
five minutes.
ARCHIVE
The ARCHIVE field (new as of version 2-0-0-5) defines the number of
days raw (binary) CDR files are available on the server before they are
deleted. The maximum number of days is 62. The larger the number, the
more disk space is required.
To use the ARCHIVE field, it first must be uncommented by removing the
# at the beginning of the ARCHIVE line and then the value for the
number of days to keep file must be entered. If ARCHIVE is set to 0, then
files are not archived. The file name of the archived file is the same as the
ASCII Billing file, but has an extension of .dat.
The archived files can be formatted as ASCII Billing files by running
TelicaAbsSrvr in formatter mode. This allows regeneration of ASCII
billing files by using the archived files, in case of a corruption of the
Billing files. To run the TelicaAbsSrvr in formatter mode , it must be
started with -F flag. The abs.conf file is not used while running in
formatter mode so all the necessary parameters must be given from the
command line. The format of the command is as follows:

Telica, Inc.

2-5

PlexView ASCII Billing Server

Issue 2, December 19, 2003

TelicaAbsSrvr -F <prefix> <input_dir> <output_dir> [<start_datetime>]


The prefix, input_dir and output_dir parameters are all mandatory. Prefix
is the prefix as defined in the abs.conf file. The input_dir parameter is the
directory where the .dat files are stored. The output_dir parameter is the
directory where the output files are written.
The start_datetime parameter is optional and if it is not entered, the
formatter starts with the oldest .dat file in the input directory. This
parameter is the date/time as contained in the file name of the first file to
be formatted and is in the format of yyyymmdd_hhmm.
CLIENT
Client names or IP addresses of the switch must also be entered. The
client can be IP address or the name, obtained from DNS lookup. The IP
addresses are the addresses of the Plexus SPs that were assigned with the
ED-CHASSIS-EQPT TL1 command. Each SP must have a client entry.
File Prefix
The prefix field is set to a prefix name for the files of CDRs. Each pair of
SPs from a switch should share the same prefix.
Time Zone
This field is the time zone of the switch. The time stamp in the billing
record file name reflects the time zone of the switch. Configuring the time
zone, however, is optional; if it is not configured, the servers local time
zone is used for that switch. Validation of the time zone is not done by the
Billing Server, but rather by the system time functions (localtime, ctime,
for example). If the configured time zone is invalid, then the results are
calculated in GMT. Switches using the same prefixes must be in the same
time zone.
When switching from Standard Time to Daylight savings (moving the
clock ahead), the 12:00 PM file is written out as 1:00 PM, so that it looks
like a gap in the files. When switching between Daylight Savings Time
and Standard Time, one minute is added to the time stamp of the file name
to create a unique file name during that one-hour period. Date and time
must be set up correctly on both the Sun server and the switch for this
feature to work correctly.
Time Zone values used in US are as follows:
EST5EDT
(Eastern Time, Daylight Savings Time applies)
CST6CDT
(Central Time, Daylight Savings Time applies)
PST8PDT
(Pacific Time, Daylight Savings Time applies)
MST7MDT (Mountain Time, Daylight Savings Time applies)

2-6

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-200-200

SensorID and OfficeID


The prefix or time zone may be followed by the SensorID and/or OfficeID
fields. These are optional fields that will override the AMA Sensor ID
and/or Recording Office ID sent from the switch. Valid values are
between 000000 and 999999 Plexus.
2.3.3

Plexus 9000 and ABS Connection


After the Plexus 9000 IP address is verified by the ABS, the ABS accepts
the connection and creates a connection control block. The connection
control block keeps the clients information, such as IP address, name, and
connection statistics, for example.

2.3.4 ABS Receipt of CDR


The ABS opens the ASCII CDR file once the control block is established.
The file naming convention for the opened CDR file is
prefix_yyyymmdd_hhmm.txt where prefix is obtained from the ABS
configuration file (abs.conf), and yyyymmdd_hhmm represents the file
creation date and time.
The prefix enables you to associate a single data file with multiple clients,
such as SP-A or SP-B, where SP-B is a standby for SP-A. This means that
you can configure two platforms for redundancy. This then enables you to
put CDR data into the files with the same prefix in case of failover.
Prefix_Data Directory Files
All CDRs, when renamed according to the prefix_yyyymmdd_hhmm.txt
convention, are stored in a configured directory, DATA_DIR specified in
abs.conf file, on the ABS. Refer to Table 2-A for a sample of the abs.conf
file.
When the CDRs are received, a maintenance file, abs.conn, is also created
in the DATA_DIR directory specified in abs.conf file. The maintenance
file contains the Plexus 9000 connection information, such as last received
sequence number and SP-A/SP-B IP addresses.
The abs.log file contains log information, such as which client has
established a connection, what time the server started, and error
information. The file is limited to 700K. When the file reaches the limit,
it renames the file to abs.log_old and opens a new log file.

Telica, Inc.

2-7

PlexView ASCII Billing Server

Issue 2, December 19, 2003

2.3.5 Transfer of Information


When the ABS verifies the IP address and responds to the Plexus 9000, it
sends a single packet containing the last received sequence number. The
first time this process takes place, the number used in the packet is
designed to force the Plexus 9000 to begin the sequencing with the
number 0 (zero). Thereafter, the ABS checks the sequence numbers,
discarding the record and dropping the TCP connection if a non-sequential
number is detected. This causes the Plexus 9000 to experience a
resynchronization, thus re-establishing the connection. The ABS then
sends the last successfully received sequence number, and expects the
Plexus 9000 to retransmit based on the last received sequence number. If
the Plexus is unable to retransmit, the ABS accepts the record and logs an
error, indicating the number of lost records, in the abs.log file.

2.4 Configuration and Operation


To use the ABS successfully with the Plexus 9000, you must first meet
specific ABS server platform requirements and then configure the ABS on
the Sun server to communicate with the Plexus 9000, and configure the
Plexus 9000 to communicate with the ABS. The procedures for installing
and configuring the ABS application on an ASCII Billing Server are found
in the Procedures section of this guide. Procedures for provisioning the
Plexus 9000 for ASCII Billing are found in the Plexus 9000 Installation
and Operation Manual.

2-8

Telica, Inc.

3.
3.1

3.2
3.3

PlexView AMA Lite


Introduction ..........................................................................................................3-1
3.1.1 PlexView AMA Lite Server Requirements..............................................3-2
3.1.2 Plexus 9000 Software Requirements........................................................3-2
Features ................................................................................................................3-2
How the Transfer Works ......................................................................................3-3
3.3.1 AMA Lite Verification of Plexus 9000 IP Address .................................3-4
3.3.2 Fields of the ama.conf File.......................................................................3-5
3.3.3 Plexus 9000 and AMA Lite Connection ..................................................3-8
3.3.4 AMA Lite Receipt of CDR ......................................................................3-8
3.3.5 Transfer of Information............................................................................3-9
3.3.6 AMA Lite Reports....................................................................................3-9

To avoid local time synchronization problems, Telica strongly recommends


setting the Plexus system clock to use GMT.

3.1

Introduction
The PlexView Automatic Message Accounting (AMA) Lite application,
which runs on a Sun computer platform, works with the Plexus 9000
switch to convert Call Detail Records (CDRs) from Billing Automatic
Message Accounting (AMA) Format (BAF) records to an AMA record
format.
The Plexus 9000 sends a CDR for each attempted call over TCP/IP to the
AMA Lite server. AMA Lite then extracts the information from the CDR
and writes it to a master AMA record format, storing the record on the Sun
server. Each record is appended to an active file over a previously
configured amount of time not exceeding 24 hours. At the expiration of
the configured time period, the active file with its collection of call records
is saved on the Sun server, and a new active file for storing records is
opened.
For a description of the master AMA record and its fields, refer to the
AMA Lite Reports section of this manual

PlexView AMA Lite

Issue 2, October 10, 2003

3.1.1 PlexView AMA Lite Server Requirements


AMA Lite is designed to run on a Sun Solaris platform. The minimum
recommended hardware configuration for PlexView is a Sun Solaris
platform with a 400 MHz CPU, 512 Mbytes of memory, 20 Gbytes of
hard disk space (SCSI disk drives are recommended) and a 100 MB
Ethernet connection. Since AMA Lite is capturing critical billing data, to
avoid the loss of data due to a disk crash, Telica recommends having
multiple disk drives and configuring disk mirroring software, such as Sun
Solstice and Veritas.
3.1.2 Plexus 9000 Software Requirements
Contact Telica Technical Services at 1-888-440-8354 regarding the
specifics of managing Plexus switches running versions of Plexus 9000
software. Information provided in this document may not apply to some
versions of AMA Lite.

3.2

Features
The AMA Lite application offers these features:

3-2

Ability to capture CDRs and convert them to AMA Lite


format.

Accurate and continuous capturing and storing of AMA Lite


records in the event of failover. AMA Lite supports the ability of
the Plexus 9000 to fail over to the standby system processor by
maintaining a standby connection and continuing to add records to
the appropriate data files. This ensures accurate and continuous
capturing and storing of AMA Lite billing records on an external
Sun platform even in the event of a Plexus 9000 system processor
failure.

Maintenance of statistical information. AMA Lite maintains


various statistics for each connected client; specifically, total
number of received octets, number of received CDRs, number of
out-of-order sequence numbers, number of header errors, number
of transmitted octets, number of transmitted last-sequence records,
number of times reached wrap-around, number of times write
failed, and number of times read failed. These statistics are
outputted to the prefix.log file when the connection drops between
the AMA Lite and the Plexus 9000.

No loss of records in the event of a communications failure. If


there is a loss of communication between the Plexus 9000 and the
AMA Lite server, the Plexus processor will switch to the standby
processor. The Plexus also has a 500 MB circular buffer that holds
up to 2.5 million records, or calls, ensuring that you lose no
records should there be a communications failure.

Telica, Inc.

Billing and Traffic Collection Guide

3.3

Section 150-200-300

How the Transfer Works


The Plexus 9000, in conjunction with the AMA Lite, completes the
following steps to successfully transfer a CDR to the AMA Lite server:
Plexus 9000 attempts to send a CDR for a completed call to the
AMA Lite server
AMA Lite verifies the authenticity of the Plexus 9000 IP address
from which the CDR is being sent
AMA Lite accepts the connection and creates a connection control
block
AMA Lite opens an AMA CDR file
AMA Lite sends the Plexus 9000 the last received sequence
number, thus beginning the transfer of information
AMA Lite receives CDRs and converts them to an AMA-format
master record
Refer to Figure 3-1 for an illustrated example of the AMA Lite conversion
process.

Signaling
Process
GDI (CDRs)
TCP/IP
Active
PlexView
AMA Lite
Application

Standby
Call
Detail
Records

Sun Server
TM

Allows AMA Lite files to be


written once a day,
hourly, or every x minutes
(configurable).

Circular
Buffer
Memory
GDI
500MB
Disk
Buffer

The customer is responsible for


managing file space and for any
postprocessing of records.
Switch
Interface
Master
Record
AMA Lite
Formatter

File
Storage

P924-AA
09-24-02

Figure 3-1. PlexView AMA Billing Conversion Details

Telica, Inc.

3-3

PlexView AMA Lite

Issue 2, October 10, 2003

3.3.1 AMA Lite Verification of Plexus 9000 IP Address


The Plexus 9000 uses the TCP/IP connection between the AMA Lite and
the Plexus 9000 switches to send CDRs to the AMA Lite server. In order
to make this connection, the Plexus 9000 IP address or name needs to be
previously configured into the AMA Lite configuration file (ama.conf).
Refer to Table 3-A for a sample of the ama.conf file. Refer to the
Procedures section of this guide to configure the AMA server. Procedures
for provisioning the Plexus 9000 for billing and AMA Lite are found in
the Plexus 9000 Installation and Operation Manual.
The AMA Lite application can then listen on the configured port (or
defaults to port 1983), verifying a match between the Plexus 9000 IP
address and the IP address contained within the ama.conf file. When the
IP addresses match, the connection is made.
Table 3-A. Sample ama.conf File
#
#
#
#

FileName: ama.conf
Telica AMA Billing Server configuration environment

Working Directory - contains data, connection info and log files


DATA_DIR
ama_data

#
#
#
#
#

AMA Billing file writing/creation frequency in minutes


Must be integer interval of minutes within 24 hours. Intervals are
always based on an initial start time of Midnight.
Defaults to 24 Hours (60min * 24hr = 1440 min)
Valid values = 5-1440
FREQUENCY
1440

#
#
#

Uncomment the following line to have AMA data file that have
accumulated zero records deleted when we rotate filenames to
the next collection interval every FREQUENCY minutes.
PURGENULLDATA True

#
#
#
#
#
#
#

Uncomment the following line to have raw CDR records from the switch
archived with the same frequency as AMA data files. The archive
files use the same name, but the extension is .dat
The value define the number of days an archive file is left on the
system before it is automatically deleted.
WARNING: This may require a VERY large disk!
ARCHIVE
31

#
#
#
#
#
#

Client switches (usually SPA/SPB pairs use the same prefix but it is
not a requirement)
Prefix may be followed by TZ and/or SensorID/OfficeID.

3-4

Server TCP listen Port number and working directory


SERVER_PORT
1983

TZ specifies the client's time zone.Clients which have the


same prefix should be in the same time zone.Time zone is used to

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-200-300

#
#
#
#
#
#
#
#
#

calculate the time in the header records and in the file names.
For detailed description of the rules for defining TZ,
See environ(5) for a description of the TZ environment variable.
TZ values used in US:
EST5EDT (Eastern Time, Daylight Savings Time applies)
CST6CDT (Central Time, Daylight Savings Time applies)
PST8PDT (Pacific Time, Daylight Savings Time applies)
MST7MDT (Mountain Time, Daylight Savings Time applies)

#
#
#
#
#
#
#

If the configured TZ is invalid, then GMT, if no TZ is provided


then server's time zone is used for time calculations.

#
#

CLIENT
-----CLIENT
CLIENT

name or IP File Prefix


---------- ----------bostonSPA Boston
bostonSPB Boston

CLIENT
CLIENT

sfoSPA
sfoSPB

SanFrancisco
SanFrancisco

CLIENT
CLIENT

denverSPA
denverSPB

DenverA
DenverB

TZ=MST7MDT
TZ=MST7MDT

CLIENT
CLIENT

10.0.0.26
10.0.0.27

Marlboro
Marlboro

SensorID=345678:OfficeID=901234

SensorID/OfficeID will override


the AMA Sensor ID and/or Recording Office ID sent from the switch.
Valid SensorID/OfficeID values = 000000-999999
Plexus-9000 host processors (name or dotted IP address)

TZ=EST5EDT
TZ=EST5EDT

SensorID=123456
OfficeID=789012

3.3.2 Fields of the ama.conf File


SERVER_PORT
The TCP server port is 1983 and does not need to be changed. This is the
port of the server that receives the CDRs.
DATA_DIR
The working directory for data, connection information and log files must
be established. In the sample, it is set to data which is the default.
FREQUENCY
The frequency that files are sent to the server must also be established.
The default is 1440 minutes, which is the maximum interval and is equal
to one day or 24-hours. The start time is midnight. The smallest interval is
five minutes.

Telica, Inc.

3-5

PlexView AMA Lite

Issue 2, October 10, 2003

PURGENULLDATA True
The PURGENULLDATA True field allows files with zero (0) records to
be deleted when the line is uncommented by removing the # at the
beginning of the line. Files that are saved then have at least one record.
ARCHIVE
The ARCHIVE field defines the number of days an archived file is
available on the server before it is deleted. The maximum number of days
is 62 and the default is 0. The larger the number, the more disk space is
required.
To use the ARCHIVE field, it first must be uncommented by removing the
# at the beginning of the line and then the value for the number of days
to keep file must be entered. If ARCHIVE is set to 0, then files are not
archived. If ARCHIVE is set a value other than 0, then CDR records from
the switch are archived at the same frequency as the AMA Billing files
and for the number of days specified. The file name of the archived file is
the same as the AMA Billing file, but has an extension of .dat.
The archived files can be formatted as AMA Billing files by running
TelicaAMASrvr in formatter mode. This allows regeneration of AMA
billing files by using the archived files, in case of a corruption of the
Billing files. To run the TelicaAMASrvr in formatter mode , it must be
started with -F flag. The ama.conf file is not used while running in
formatter mode so all the necessary parameters must be given from the
command line. The format of the command is as follows:
TelicaAMASrvr -F <prefix> <input_dir> <output_dir>
[<start_datetime>]
The prefix, input_dir and output_dir parameters are all mandatory. Prefix
is the prefix or name of the .dat files. The input_dir parameter is the
directory where the .dat files are stored. The output_dir parameter is the
directory where the output files are written.
The start_datetime parameter is optional and if it is entered, the formatter
starts with the oldest .dat file. This parameter is the date and time of the
first file to be formatted and is in the format of yyyymmdd_hhmm.
To read the AMA files you must have an application for viewing AMA
files. If you do not have an application, please call Telica Technical
Services at 888-440-8354 or 508-485-5739 for assistance.

3-6

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-200-300

CLIENT
Client names or IP addresses of the switch must also be entered. The
client can be IP address or the name, obtained from DNS lookup. The IP
address is the addresses of the Plexus SPs that were assigned with the
ED-CHASSIS-EQPT TL1 command.
File Prefix
The prefix field is set to a prefix name for the files of CDRs.
Time Zone
The time stamp in the billing record file names and header records reflects
the time zone of the switch. Configuring the time zone, however, is
optional; if it is not configured, the servers local time zone is used for that
switch. Validation of the time zone is not done by the Billing Server, but
rather by the system time functions (localtime, ctime, for example). If the
configured time zone is invalid, then the results are calculated in GMT.
Switches using the same prefixes must be in the same time zone.
When switching from Standard Time to Daylight savings (moving the
clock ahead), the 12:00 PM file is written out as 1:00 PM, so that it looks
like a gap in the files. When switching between Daylight Savings Time
and Standard Time, one minute is added to the time stamp of the file name
to create a unique file name during that one-hour period. Date and time
must be set up correctly on both the Sun server and the switch for this
feature to work correctly. Below are some of the Time Zone values used in
US:
EST5EDT
(Eastern Time, Daylight Savings Time applies)
CST6CDT
(Central Time, Daylight Savings Time applies)
PST8PDT
(Pacific Time, Daylight Savings Time applies)
MST7MDT (Mountain Time, Daylight Savings Time applies)

SensorID and OfficeID


The prefix may be followed by an the SensorID and OfficeID fields which
are optional fields that will override the AMA Sensor ID and/or Recording
Office ID sent from the switch. Valid values are between 000000 and
999999 Plexus.

Telica, Inc.

3-7

PlexView AMA Lite


3.3.3

Issue 2, October 10, 2003

Plexus 9000 and AMA Lite Connection


After the AMA Lite server verifies the Plexus 9000 IP address, the AMA
Lite server accepts the connection and creates a connection control block.
The connection control block keeps the clients information, such as IP
address, name, and connection statistics, for example.

3.3.4 AMA Lite Receipt of CDR


The AMA Lite application opens the AMA CDR file once the control
block is established. The file naming convention for the opened CDR file
is prefix_yyyymmdd_hhmm.ama where prefix is obtained from the AMA
Lite configuration file (ama.conf), and yyyymmdd_hhmm represents the
file creation date and time
The prefix enables you to associate a single data file with multiple clients,
such as SP-A or SP-B, where SP-B is a standby for SP-A. This means that
you can configure two platforms for redundancy. This then enables you to
put CDR data into the same file in case of failover.
All CDRs, when renamed according to the prefix_yyyymmdd_hhmm.ama
convention, are stored in a pre-configured directory, prefix_data, on the
AMA Lite server. These can be converted to a readable format with the
dump_dms_ama tool which is shipped the the AMA Lite software.
When the CDRs are received, a maintenance file, prefix_conn.info, is also
created in the prefix_data directory. The maintenance file contains the
Plexus 9000 connection information, such as last received sequence
number and SP-A/SP-B IP addresses.
The prefix.log file contains log information, such as which client has
established a connection, what time the server started, and error
information. The file is limited to 700K. When the file reaches the limit,
it renames the file to prefix.old and opens a new log file.
Refer to Table 3-A for a sample of the ama.conf file.

3-8

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-200-300

3.3.5 Transfer of Information


When the AMA Lite verifies the IP address and responds to the Plexus
9000, it sends a single packet containing the last received sequence
number. The first time this process takes place, the number used in the
packet is designed to force the Plexus 9000 to begin the sequencing with
the number 0 (zero). Thereafter, the AMA Lite checks the sequence
numbers, discarding the record and dropping the TCP connection if a nonsequential number is detected. This causes the Plexus 9000 to experience
a resynchronization, thus re-establishing the connection. The AMA Lite
then sends the last successfully received sequence number, and expects the
Plexus 9000 to retransmit based on the last received sequence number. If
the Plexus is unable to retransmit, the AMA Lite accepts the record and
generates an alarm indicating the number of lost records. The alarm is
sent to the prefix.log file.
3.3.6 AMA Lite Reports
For details regarding AMA Lite reporting, refer to the AMA Lite Reports
section of this manual.

Telica, Inc.

3-9

PlexView AMA Lite

Issue 2, October 10, 2003

NOTES:

3-10

Telica, Inc.

4.
4.1
4.2
4.3

4.4

4.1

PlexView Traffic Collection Application (TCA)


Introduction ..........................................................................................................4-1
Features ................................................................................................................4-2
How Statistical Information is Generated ............................................................4-3
4.3.1 Telica Statistical Data Server (TSDS) Application..................................4-4
4.3.2 Telica Statistical Analysis Application (TSAA) ......................................4-6
4.3.2.1 The tsaa.conf File.........................................................................4-7
4.3.2.2 The tsaa_<pid>.log File ............................................................4-13
4.3.2.3 Erlang B......................................................................................4-13
4.3.3 Reporting................................................................................................4-14
Installation and Configuration............................................................................4-14
4.4.1 TCA Server Platform Requirements ......................................................4-14
4.4.2 Configuration Procedure ........................................................................4-14

Introduction
The PlexView Traffic Collection Application (TCA) works in
conjunction with the Plexus 9000 to capture information about every call,
and to process that information into statistical data. The statistical data is
tracked for busy hour information, peg counts, trunk group hold time, and
traffic Centum Call Seconds (CCS).
Up to eight Plexus 9000 switches can use the TCP/IP protocol to send a
Call Detail Record (CDR) for each attempted call to the TCA via the
Telica Statistical Data Server (TSDS). The TSDS stores this information
in binary format on the TCA server.
Note: For more information regarding the TSDS, refer to 4.3.1 in this
document.
The Telica Statistical Analysis Application (TSAA) then extracts the
necessary information from the CDR and updates the call statistics and
traffic measurements accordingly, writing it to output text files, and
storing it on the TCA (Sun) server.
Note: For more information regarding the TSAA, refer to 4.3.2 in this
document.

PlexView Traffic Collection Application (TCA)

Issue 3, December 12, 2003

Because of comma-delimited fields, you can retrieve the stored files and
import them into another application, such as Excel, for post-processing
and report creation.
The PlexView TCA runs on a Sun computer platform and is available as a
stand-alone application or with the PlexView Element Management
System (EMS).
Note: The server on which you plan to run the TCA can also be the same
server on which you run the PlexView EMS and/or the PlexView ASCII
Billing Server (ABS), although this is not the recommended
architecture. In any case, the server on which you choose to run the TCA
is referred to as the TCA server.

4.2

Features
The PlexView TCA offers these features:

4-2

Ability to extract call statistics and traffic measurements from


CDRs and convert them to ASCII format.

Accurate and continuous capturing and storing of statistical


information in the event of SP failover. The TCA supports the
ability of the Plexus 9000 to fail over to the standby system
processor by maintaining a standby connection and continuing to
add records to the appropriate data files. This ensures accurate and
continuous capturing and storing of traffic statistics on an external
Sun platform.

Captures statistics into various types. The TCA captures the


statistics into five file types: busy hour data, peg counts, traffic
Centum Call Seconds (CCS), trunk group hold time reports, and
Call Detail Records (CDRs). The busy hour statistics file captures
the busiest hour information on a daily basis. The peg counts
statistics file contains summarized statistical call data in 5-minute,
1-hour, and 24-hour records. The traffic report captures CCS data
and call peg counts per trunk group (SS7, BICC, CAS) and per
isdn interface on a configurable time (15 minute, 30 minute, or 1
hour) basis. The trunk group hold time report displays the average
hold time for each trunk group on a 5-minute basis. The CDR files
are produced every 5 minutes and contain a record for each call or
call attempt.

Telica, Inc.

Billing and Traffic Collection Guide

4.3

Section 150-200-400

No loss of records in the event of a short duration


communications failure. Not only does the TCA continue
working in standby mode, but it also has a circular buffer that
holds up to 3.0 million records, ensuring that you lose no records
(over a period of time and depending on call volume) should there
be a communications failure.

TCA automatic restart. TCA will automatically restart when the


Sun server is rebooted if the S99PLXStats file is installed in the
/etc/rc3.d directory.

Multiple tsaa.conf files can be started. This requires copying the


tsaa.conf file with multiple names and modifying a line in the
S99PLXStats file.

Dates in file names have been changed from MMDDYY to


YYYYMMDD to allow easier sorting.

How Statistical Information is Generated


The Plexus 9000, in conjunction with the TCA, completes the following
steps to retrieve statistical information from a call record:
1. On the Plexus 9000, call control generates a call record under one
of these conditions:
-

Call ends after being successfully established

Call cannot be established (not answered, busy, no route)

Call has been established for more than 15 minutes (long call
duration)

2. The Statistics client filters unnecessary information from the call


record, producing a record containing only pertinent information.
3. On the Sun server side, the Sun workstation is configured to
request the call record to be sent to the statistics client module,
using the TCP/IP protocol.
4. The TelicaStatsSrvr application on the client module retrieves and
stores the call records in local binary files, accessible on the
network.
5. The tsaa application reads the binary files and performs all the
statistical calculations, depending on the needs of the customer.
6. The result of the analysis application is stored in user-readable text
files (ASCII), ready for further analysis.

Telica, Inc.

4-3

PlexView Traffic Collection Application (TCA)

Issue 3, December 12, 2003

See Figure 4-1 for an illustrated example of the statistics retrieval process.
Signaling
Process
CDRs

ASCII Files

TCP/IP

FTP

Active
Standby
Call
Records

Circular
Buffer

N groups of
X# of above
records
(Configurable)

Traffic
Capacity
and Eng
App

Data Collector

Sun Server

TM

X# of
Records
(Configurable)

PlexView
Traffic Mgmt
Module

Memory

Virtual
Memory
(Disk)

Switch
Interface
(Receives
CDRs)

Track
Busy Hour
Statistics

Daily
Files

Track
Call
Statistics
(Peg Count)

Daily
Files

Track
Traffic (CCS)
Statistics

Hourly
Files

Track Trunk
Group HoldTime Output

Daily
Files

FTP

P506-AA
12-10-01

Figure 4-1. PlexView TCA Statistics Retrieval Process


4.3.1

Telica Statistical Data Server (TSDS) Application


The TSDS can handle connections to multiple Plexus 9000 switches, using
a TCP/IP socket base connection between the Plexus and the TCA server.
Generated CDRs flow from each Plexus 9000 to the TCA server.
When the TSDS runs its TelicaStatsSrvr process, it creates the tsds_data
directory (DATA_DIR directory set in tsds.conf file). This directory
contains the following generated files:

4-4

tsds.log This file contains log information, such as time the


server started, which client has established a connection, and error
information. This file is limited by size (700K). When the size
reaches the limit, it copies the file into tsds.log_OLD and begins a
new tsds.log file.

tsds.conn This binary file contains connection information about


the clients, such as last received sequence number and IP address.
In case the server goes down for maintenance or the process exited
because of a major error condition, upon reconnection with the
client, the server will know which CDR record to request next.

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-200-400

prefix_STATS_yyyymmdd.dat This is the binary file created by


TSDS. Prefix is the client prefix configured in tsds.conf file. This
file is created when a valid client establishes a connection. The file
is closed at midnight around 12:15 a.m. and a new file is created to
reflect the next-day time stamp. The information in the file can be
displayed on a Sun terminal by typing the following:
od X XXX_yyyymmddhhmm.dat | more

Table 4-A displays a sample of the tsds.conf file. The file is read upon
TCA server startup, containing keywords followed by parameter values.
The changes you will make to this file are shown in boldface type. You
must save the configuration before exiting.
Table 4-A. Sample tsds.conf File
# FileName: tsds.conf
# Telica Stats Server configuration environment
#
# Server TCP listen Port number and working directory
SERVER_PORT

10000

# Working Directory - contains data, connection info and log files


# DATA_DIR

tsds_data

# Client switches (usually SPA/SPB pairs use the same prefix)


# Plexus-9000 host processors (name or dotted IP address)

# Key

IP-or Host

Prefix

# =====

==========

========

CLIENT

<SP-A IP or Hostname>

<boston>

CLIENT

<SP-B IP or Hostname>

<boston>

CLIENT

See Note below.

Note: There can be up to sixteen (16) CLIENT entries for connection to up to eight (8)
Plexus 9000 switches.

Telica, Inc.

4-5

PlexView Traffic Collection Application (TCA)

Issue 3, December 12, 2003

Fields:
SERVER_PORT
The Server_Port is the TCP connection port number. There is no need to
change.
DATA_DIR
The Data_Dir is the directory that keeps the statistics data, log, and
connection files. This directory need not exist beforehand. It will be
created when TelicaStatsSrvr is started. There is no need to change from
the default.
CLIENT
The Client field consists of the IP address or host name and a prefix.
IP or Host
The IP or Host field specifies the IP addresses or host names of the SP and
are provided by the customer.
Prefix
The Prefix field must be the same for both SP-A and SP-B. The chosen
Prefix name will be used to identify and correlate the statistics data files
that are generated by your switch. It is recommended that the prefix name
is also used to provide a unique name for the tsaa.conf files so that each
switch has its own file. The Prefix name (boston) shown in the sample
tsds.conf file is only an example.
4.3.2

Telica Statistical Analysis Application (TSAA)


The TSAA is a stand-alone application that runs on a Sun workstation. It
interfaces with the TSDS, which generates CDRs in binary files. The
TSAA parses this data and generates peg count records and calculates
busy hour information in text formats.
The TSAA executable and configuration files reside in the same directory
as the TSDS. It is automatically started when the S99PLXStats script is
run.
Once the TSAA is operational, the application generates peg counts, CCS,
holdtime and busy hour information as determined by the
tsaa_<prefix>.conf file. The application creates directories specified in
the tsaa_<prefix>.conf file, for its output and log files. The log file is:
tsaa_<pid>.log
with pid meaning process ID.

4-6

Telica, Inc.

Billing and Traffic Collection Guide

4.3.2.1

Section 150-200-400

The tsaa.conf File


The tsaa.conf file is included in a .tar file on the installation CD and stores
all configuration information. The file is read upon TCA server startup,
containing keywords followed by parameter values. If traffic statistics are
being gathered from multiple switches, there must also be multiple
tsaa.conf files. The installation procedure recommends that you copy and
name the files in the format of tsaa_<prefix>.conf. The prefix was
established when editing the tsds.conf file.
The fields that require changes are shown in boldface type. Other fields
may also be changed. If you enter a configuration point value beyond a
valid range, default values are used. You must save the configuration
before exiting. A sample of the tsaa_<prefix>.conf file is shown in
Table 4-B.
Fields:
Prefix
This field indicates the prefix that is unique for a switch and was
established in the PlexusDC.ini or tsds.conf file.
Input Directory
This field specifies the directory containing the binary files generated from
the TelicaStatsServer. It must be identical to the value specified in the
Statistics entity configuration section of the PlexusDC.ini file or the
DATA_DIR parameter of the tsds.conf file. The default name is
tsds_data.
Output Directory
This field specifies the name of the output directory for statistics data files.
This name should be changed to tsaa_<prefix>.
Log Directory
This field specifies the name of the output directory for all log files. The
name should be changed to tsaa_<prefix>/log. It must be identical to the
value specified in the Statistics entity configuration section of the
PlexusDC.ini file
Percent Blocking
This field indicates the value used in the calculation of Erlang B,
specifying the acceptable number of failure of calls due to an insufficient
number of lines available. The minimum is 0; the maximum is 1; and the
default is 0.01. Refer to section 4.3.2.3 for a description of Erlang B.

Telica, Inc.

4-7

PlexView Traffic Collection Application (TCA)

Issue 3, December 12, 2003

Table 4-B. Sample tsaa_<prefix>.conf File


#
#
#
#
#
#

FileName: *tsaa.conf
This file contains the configuration information for the
Telica Statistical Analysis Application (TSAA), and should be
modified by authorized personnel only.
Prefix: boston
Input Directory: tsds_data
Output Directory: tsaa_boston
Log Directory: tsaa_boston/log
Percent Blocking: 0.01
Peg Count Report: 1
ASR Report: 1
Hold Time Report: 1
SS7 Trkgrp CCS Report: 3
Intfcgrp CCS Report: 3
CAS Trkgrp CCS Report: 3
BICC Trkgrp CCS Report: 3
SIP Trkgrp CCS Report: 3
GR303 Intfcgrp CCS Report: 3
CAS Intfcgrp CCS Report: 3
ASCII CDR Report: 1
Detailed Peg Report: 1
Calculate DN Peg Count: 1
Busy Hour Granularity: 30
CCS Granularity Period: 4
Peg Count Granularity Period: 4
ASR Granularity Period: 4
Hold Time Granularity Period: 4
Input Storage Duration: 30

Output Storage Duration: 30


FTP to EMS: 0
FTP Transfer Interval: 60

EMS
EMS
EMS
EMS

IP Address: 127.0.0.1
Username: anonymous
Password: boston
Output Directory: /tsaa_data

Peg Count Report


This field specifies whether or not to report Peg Counts.
0 = Do not report Peg Counts.
1 = Report Peg Counts. This is the default value.

4-8

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-200-400

ASR Report
This field specifies whether or not to report the Answer to Seizure Ratio
(ASR).
0 = Do not report ASR.
1 = Report ASR. This is the default value.
Hold Time Report
This field specifies whether or not to report trunk group average hold time.
0 = Do not report average hold time.
1 = Report the average hold time. This is the default value.
SS7 Trkgrp CCS Report
This field specifies the format for the SS7 trunk group CCS reporting.
0 = Reporting is disabled.
1 = Report only, space-delimited format.
2 = Report only, comma-delimited format.
3 = Report both space-delimited and comma-delimited formats.
This is the default value.
Intfcgrp CCS Report
This field specifies the format for the interface group CCS reporting.
0 = Reporting is disabled.
1 = Report only, space-delimited format.
2 = Report only, comma-delimited format.
3 = Report both space-delimited and comma-delimited formats.
This is the default value.
CAS Trkgrp CCS Report
This field specifies the format for the CAS trunk group reporting.
0 = Reporting is disabled.
1 = Report only, space-delimited format.
2 = Report only, comma-delimited format.
3 = Report both space-delimited and comma-delimited formats.
This is the default value.
BICC Trkgrp CCS Report
This field specifies the format for the BICC trunk group reporting.
0 = Reporting is disabled.
1 = Report only, space-delimited format.
2 = Report only, comma-delimited format.
3 = Report both space-delimited and comma-delimited formats.
This is the default value.

Telica, Inc.

4-9

PlexView Traffic Collection Application (TCA)

Issue 3, December 12, 2003

SIP Trkgrp CCS Report


This field specifies the format for the SIP trunk group reporting.
0 = Reporting is disabled.
1 = Report only, space-delimited format.
2 = Report only, comma-delimited format.
3 = Report both space-delimited and comma-delimited formats.
This is the default value.
GR303 Intfcgrp CCS Report
This field specifies the format for the GR303 interface group CCS
reporting.
0 = Reporting is disabled.
1 = Report only, space-delimited format.
2 = Report only, comma-delimited format.
3 = Report both space-delimited and comma-delimited formats.
This is the default value.
CAS Intfcgrp CCS Report
This field specifies the format for the CAS interface group CCS reporting.
0 = Reporting is disabled.
1 = Report only, space-delimited format.
2 = Report only, comma-delimited format.
3 = Report both space-delimited and comma-delimited formats.
This is the default value
ASCII CDR Report
This field enables or disables ASCII CDR reporting every five minutes.
0 = Reporting is disabled.
1 = Only Call Release CDRs are printed. This is the default value
2 = Both Long Duration and Release CDRs are printed.
Detailed Peg Report
This field enables or disables detailed peg reporting.
0 = Detailed reporting is disabled. Pegged for the state of the call.
1 = Detailed reporting is enabled. Pegged for the release cause
codes. This is the default value
Calculate DN Peg Count
This field enables or disables the calculation of Directory Number (DN)
peg counts.
0 = Do not calculate DN Peg Counts.
1 = Calculate DN Peg Counts. This is the default value.

4-10

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-200-400

Busy Hour Granularity


This field specifies the granularity of the busy hour calculation. Units are
in minutes. Valid range is 0, 5, 30 and 60 and the default is 30.
0 = Disable.
5 = 5 minutes.
30 = 30 minutes - This is the default value.
60 = 60 minutes or 1 hour.
CCS Granularity Period
This field specifies the granularity of how often the files are written to
disk. The values are 2, 3 and 4.
2 = Created every 15 minutes
3 = Created every 30 minutes
4 = Created every hour. This is the default value
Peg Count Granularity Period
This field specifies the granularity of how often the files are written to
disk. The values are 2, 3, 4 and 5.
2 = Created every 15 minutes
3 = Created every 30 minutes
4 = Created every hour. This is the default value.
5 = Created once a day
ASR Granularity Period
This field specifies the granularity of how often Answer to Seizure Ratio
(ASR) files are written to disk. The values are 2, 3, 4 and 5.
2 = Created every 15 minutes.
3 = Created every 30 minutes.
4 = Created every hour. This is the default value.
5 = Created once a day.
Hold Time Granularity Period
This field specifies the granularity of how often the files are written to
disk. Values are 2, 4 and 5.
2 = Created every 15 minutes
4 = Created every hour. This is the default value.
5 = Created once a day

Telica, Inc.

4-11

PlexView Traffic Collection Application (TCA)

Issue 3, December 12, 2003

Input Storage Duration


This field specifies the number of days to store input files. Values are 0 to
180.
0 = File should be removed next day. (Not recommended).
30 days is the default value.
If tsaa is configured to ftp files, even if the files are older than Input
Storage Duration they are not removed, if they have not been ftped yet.
Output Storage Duration
This field specifies number of days to store files. Values are 0 to 180.
0 = File should be removed next day. (Not recommended).
30 days is the default value.
If tsaa is configured to ftp files, even if the files are older than Output
Storage Duration they are not removed, if they have not been ftped yet.
Note: The following fields refer to files that are FTPed to the EMS server
FTP to EMS
This field specifies whether or not to FTP to Element Management System
(EMS).
0 = Do not FTP to EMS.
1 = FTP to EMS
FTP Transfer Interval
This field specifies the interval between FTPs to EMS. Values are 30 to
900 seconds. The default value is every 60 seconds.
EMS IP Address:
This field specifies the IP address of the EMS server.
EMS Username:
This field specifies the username for EMS.
EMS Password:
This field specifies the password for EMS.
EMS Output Directory:
This field specifies the output directory on the EMS server (full path).
This directory needs to already exist and the EMS user must have read and
write permission to the directory.

4-12

Telica, Inc.

Billing and Traffic Collection Guide

4.3.2.2

Section 150-200-400

The tsaa_<pid>.log File


This file stores the TCA current activity by the process ID (PID).
Common activities are peg counts, busy hour calculations, CCS reporting,
hold time calculating and rolling of logs, but error codes and other
debugging information are also reported in the file.

4.3.2.3

Erlang B
Erlang and Erlang B calculations are used in the creation of busy hour call
reports (refer to Traffic Statistics Reports section of this manual). The
report specifies the number of Erlangs and circuits and the circuit usage
percentage.
An Erlang is a unit of telecommunications traffic measurement. Strictly
speaking, an Erlang represents the continuous use of one voice path. In
practice, it is used to describe the total traffic volume of one hour. For
example, if a group of users made 30 calls in one hour, and each call had
an average call duration of 5 minutes, then the number of Erlangs this
represents is worked out as follows:
Minutes of traffic in the hour
Minutes of traffic in the hour
Minutes of traffic in the hour
Hours of traffic in the hour
Hours of traffic in the hour
Traffic figure

= number of calls x duration


= 30 x 5
= 150
= 150 / 60
= 2.5
= 2.5 Erlangs

The Erlang B traffic model is used by telephone system designers to


estimate the number of lines required for PSTN connections or private
wire connections. The three variables involved are Busy Hour Traffic
(BHT), Blocking and Lines:
Busy Hour Traffic (in Erlangs) is the number of hours of call traffic
there are during the busiest hour of operation of a telephone
system.
Blocking is the failure of calls due to an insufficient number of
lines being available. For example, 0.03 mean 3 calls blocked per
100 calls attempted.
Lines is the number of lines in a circuit.

Telica, Inc.

4-13

PlexView Traffic Collection Application (TCA)

Issue 3, December 12, 2003

The Erlang B algorithm is as follows:

where a is the busy hour traffic in Erlangs, c is the number of lines, and
B(c,a) is the blockage. The application uses this equation to determine c.
The model assumes that all blocked calls are immediately cleared.
4.3.3 Reporting
The TCA generates several reports. Refer to Traffic Statistics Reports
section of this manual for reporting details.

4.4

Installation and Configuration


To use the TCA successfully with the Plexus 9000, you must first meet
specific TCA platform requirements, listed in 4.4.1. You must then install
and configure the TCA on the Sun server and establish communications
between the TCA and the Plexus 9000.

4.4.1 TCA Server Platform Requirements


The TCA supports the Plexus 9000, release 3.1.1.1 or greater, and must
meet these prerequisites:
Sun Solaris 2.7 or 2.8 with 500 MB memory and a 10/100
Ethernet card

4.4.2

Sun server with a minimum of a 400 Mhz processor

Configuration Procedure
Configuration procedure for gathering statistics can be found in DLP-521
or DLP-522 of this manual. Procedures for provisioning the Plexus 9000
for gathering statistics can be found in the Plexus 9000 Installation and
Operation Manual.

4-14

Telica, Inc.

5.
5.1
5.2
5.3
5.4

PlexView Billing and Traffic System


Introduction ..........................................................................................................5-2
Features ................................................................................................................5-3
How the Transfer Works ......................................................................................5-4
Provisioning for the Billing and Traffic System ..................................................5-6
5.4.1 The plexusDc.ini File ...............................................................................5-6
5.1.1.1 Data Collector Main Entity Configuration.................................5-11
5.1.1.2 Receiver Entity Configuration ...................................................5-13
5.1.1.3 Billing Entity Configuration ......................................................5-14
5.1.1.4 Billing Output Options ...............................................................5-21
5.1.1.5 ASCII and AMA Lite (BAF) File Parameters ...........................5-22
5.1.1.6 PlexView Pro Billing (Billdats) Parameters...............................5-23
5.1.1.7 ASCII and BAF Push Entity Configuration...............................5-24
5.1.1.8 Statistics Entity Configuration ...................................................5-25
5.4.2 The tsaa.conf File...................................................................................5-26
5.4.3 The tsaa_<pid>.log File ........................................................................5-32
5.4.4 Erlang B..................................................................................................5-33

Note: To avoid local time synchronization problems, Telica strongly


recommends setting the Plexus system clock to use GMT.
Note: The plexusDc.ini and tsaa.conf files may differ from your files
depending upon the version of software. This document lists the files as they
were at the date of this document.

PlexView
Billing and Traffic System

Issue 4, January 9, 2004

5.1 Introduction
The PlexView Billing and Traffic System (BTS), which runs on a Sun
computer platform, works with the Plexus 9000 switch to receive raw data
Call Detail Records (CDRs). The Plexus must be running software 3.8 or
greater.
As each call is placed through a Plexus switch, the Plexus takes a snapshot
of the call state and saves it in a CDR. Because the CDR contains raw call
data stored in a proprietary format, it is not very useful as is and further
processing is required to convert the CDR into a format that can be used
by off-switch billing and statistics systems.
The Plexus 9000 saves one raw data CDR for each attempted call and
sends it over TCP/IP to the BTS. The BTS has the responsibility of
processing CDRs and interfacing with billing and traffic collection
systems allowing the Plexus to be able to use more of its resources for
processing calls.
In earlier software versions of the Plexus, two raw CDRs were generated
for every call. Then Billing CDRs were formatted into AMA like objects
and written to a circular file on the switch and Traffic Collection CDRs
were formatted into their format and written to another circular file. Two
instances of a GDI transmitter were running to read the circular files and
transmit the data over a TCP/IP connection to the appropriate server where
a GDI receiver collected the data and formatted into the correct output.
Processing and interfacing with the billing and traffic collection systems
occurred in the Plexus using valuable resources.
The BTS receives CDR records from the Plexus via the Data Collector or
GDI Receiver. The Data Collector establishes connections to one or more
Plexus switches and receives a stream of CDRs from each one. The CDRs
are parsed to determine if they should be forwarded to ASCII billing,
AMA Lite, PlexView Pro billing or Traffic collection.

5-2

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-200-500

5.2 Features
The PlexView Billing and Traffic System offers these features.

Telica, Inc.

One CDR is generated in the Plexus for both billing and traffic
collection.

CDR formatting occurs in the BTS allowing the Plexus more


resources for processing calls.

The Data Collector or GDI receiver of the BTS collects the


data from the Plexus and multiplexes the same CDR into a
traffic collection handler and a billing handler.

Any combination of billing reporting (ASCII Billing, AMA


Lite or PlexView Pro Billing) can be used.

Accurate and continuous capturing and storing of records in the


event of failover. The BTS supports the ability of the Plexus
9000 to fail over to the standby system processor by
maintaining a standby connection and continuing to add
records. This ensures accurate and continuous capturing and
storing of records in the event of a Plexus system processor
failure.

No loss of records in the event of a short-term communication


failure. The Plexus has a circular buffer of approximately
2 gigabytes ensuring no records are lost if there is a short-term
communication failure.

Traffic application will automatically restart when the Sun


server is rebooted if the S99PLexDC file is installed in the
/etc/rc3.d directory.

Can collect CDRs from multiple Plexus switches.

Provides the infrastructure for other data interfaces (i.e., fraud


system, NTM or NTP).

5-3

PlexView
Billing and Traffic System

Issue 4, January 9, 2004

5.3 How the Transfer Works


Billing and traffic collection CDRs are combined and sent as one CDR to
the Billing and Traffic System via the GDI protocol over a TCP/IP
connection. The information needed to complete the formatting (e.g.
subscriber specifics) for billing or traffic collection is part of the CDR sent
to the Data Collector. The GDI receiver/Data Collector in the BTS will
forward the CDR to the interested entities (i.e., ASCII billing, AMA Lite,
Pro Billing or Traffic Collection) based on the configuration information.
Refer to Figure 5-1 for an illustration of the Plexus and the Billing and
Traffic System.

Sun Hardware Platform with Solaris OS


ASCII
Billing

Billing
AMA
Formatter

GDI
AMA
Trans

AMA
Lite
CDRs

ASCII
Files

AMA
Pro Billing

AMA
Lite
Files

TCP/IP
Active

Data
Collector/
GDI Receiver

Traffic
Statistics

Traffic
Collection
App

Standby
NetMinder
NTM
(Future)

TM

Raw
CDRs
P983-AA
05-01-03

NetMinder
NTP
(Future)

NetMinder
NTM
OSS
NetMinder
NTP
OSS

Figure 5-1. The Plexus and the Billing and Traffic System

If the connection exists between the Plexus and the BTS, the switch will
send the data at 5-second intervals or sooner it the buffer fills.
Data can be output in several forms depending on the Data Collector
configuration. ASCII Billing will take the CDRs from the GDI
Receiver/Mux/Data Collector and generate ASCII output files using the
current ASCII Billing format; AMA Lite will convert Call Detail Records
(CDRs) to an AMA record format.

5-4

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-200-500

For a PlexView Pro Billing configuration, data is written in BAF format to


a circular buffer file, and another GDI transmitter entity will be started on
the BTS to send the data to the PlexView Pro Billing application. The
dotted circle around AMA Pro Billing in the illustration indicates that the
application can run on the BTS server or on a separate server.
Traffic statistics are sent to the Traffic Collection Application and the
Telica Statistical Analysis Application (TSAA) as shown in Figure 5-2.
The statistical data is tracked for peg counts, busy hour information, traffic
Centum Call Seconds (CSS) and trunk group hold time.

Traffic Collection Application


Track Call
Statistics
(Peg Counts)

Traffic
Statistics

Files

DATs
Track
Busy Hour
Statistics

Daily
Files

TSAA

ASCII Files

Conf

Raw
CDRs

FTP
Track
Traffic (CCS)
Statistics

Files

Track
Avg Trunk
Hold Time

Files

Data/
PlexView
EMS

P984-AA
05-01-03

Figure 5-2. Traffic Collection Application

Telica, Inc.

5-5

PlexView
Billing and Traffic System

Issue 4, January 9, 2004

5.4 Provisioning for the Billing and Traffic System


The Plexus 9000 uses the TCP/IP connection between the BTS and the
Plexus 9000 switches to send CDRs to the BTS. IP addresses of the BTS
for the Plexus are provisioned using the ENT-DATASERVER-HOSTCFG
command. Billing and Traffic Collection are enabled in the Plexus using
the ED-BILLSYS and ED-TRAFFICSTATS commands respectively.
In order to make this connection, the Plexus 9000 IP address or name
needs to be previously configured into the configuration file
(plexusDc.ini). If the BTS will be collecting CDRs from multiple Plexus
switches, a directory for each switch should be created (i.e., <plexusDCn>
where n is a unique number or <SwitchName>). A copy of the
plexusDc.ini must be copied into each directory and edited. For traffic
reporting, a copy of the tsaa.conf file is also copied into each directory and
it must also be edited.
5.4.1 The plexusDc.ini File
In order to make this connection, the Plexus 9000 IP address or name
needs to be previously configured into the configuration file
(plexusDc.ini). Refer to Table 5-A for a sample of the plexusDc.ini file.
Refer to the procedures section of this manual and DLP-541 for
instructions to edit this file.
If the BTS is collecting billing and/or traffic data from multiple Plexus
switches, you must have a plexusDc.ini file and a unique directory for
each Plexus. It is suggested that you name the directory as plexusDcn
where n is a unique number or SwitchName with the SwitchName being
the name or TID of the Plexus.
Lines that begin with # (pound sign) are commented lines. The
commented lines may also contain default values. If you wish to change a
default value, it is suggested that that you insert a line with the changed
value. For example, if you wanted to change the LogPath, then you would
insert a line after the DebugPort=2361 line and enter LogPath=<new
value>.

5-6

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-200-500

Table 5-A. plexusDc.ini File


# Template TelicaPlexusDc configuration file.
# $Id: plexusDc_template.ini,v 1.11.2.17 2003/12/03 21:53:58 ggaus Exp $
#
# The parameter comment blocks document the default settings if the
# parameter is not defined in this file.
#
# Parameter names are not case sensitive, but the "=" MUST follow the
# name with no intervening space.
#
#NOTE: actual parameter lines can NOT include comments on the end
##############################
#Data Collector MAIN Entity Configuration
##############################
[DataCollectorConfig]
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#

Prefix=
MaxLogQueue=
MaxFileSize=
MaxFileCount=
LogPath=
LogFilename=
DebugPort=
DebugBindIp=
BindIp=

<none>
16384
10485760
6
./logs
dcLog
<none>
0.0.0.0
0.0.0.0

Timezone=

<system>

Prefix=

prefix for various output files (ascii, baf, stats)


max trace entries allow on queue before dropping
max size in bytes of any single trace file
max old trace log files retained
directory for trace log files
base name of trace log files
telnet debug port into DataCollector
(INADDR_ANY) override BindIp for debug port only.
(INADDR_ANY) default local bind IP(i/f) for all
TCP listen and connect calls (allows DC bind
to system alias IP). Other sections in the ini
will default to this value if their individual
BindIp is not defined.
USE ONLY IF SERVER and SWITCH timezones DON'T MATCH
Timezone is used to calculate file names, file
rollover times, and some billing fields.
See end of file for description.

SwitchName

##############################
#Receiver Entity Configuration
##############################
[ReceiverConfig]
#
#
#
#
#
#
#
#

GdiPort=
GdiHost=

1986
mgcId

host/IP

IP port to listen on for GDI connections


mgcId is a unique integer (1-63)

ArchiveDays=
0
ArchiveInterval= 720
720 minutes = 12 hour (limit 5 - 1440)
ArchivePath=
<DataCollectConfig:LogPath>
ArchivePrefix=
<DataCollectConfig:Prefix>
ArchivePurgeNull= 1
purge null files

GdiHost=
GdiHost=

1
2

SPA_address
SPB_address

#################################
# Billing entity configuration
#################################
[BillingConfig]

Telica, Inc.

5-7

PlexView
Billing and Traffic System

Issue 4, January 9, 2004

# AMA Record Formatting Parameters


# -------------------------------#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#

5-8

SensorType=
SensorId=

195
0

RecOfficeType=
RecOfficeId=

195
999999

DAAMAGen=
IntraLATAAMAGen=
FraudAMAGen=
FraudCallType=

1
1
0
800

Sensor Type
Sensor Id - If non-zero, it overrides the
switch Id sent from the switch.
Recording Office Type
Recording Office Id
Directory Assistance AMA Generation
Intra LATA AMA Generation
Fraud AMA Generation
Call Type for Fraud Calls - Valid values are
from 800 to 999.

OrigNumberModuleGen=

TermNumberModuleGen=

DialedDigitsModuleGen=
0
OutpulseDigitsModuleGen= 0
TrunkIdModuleGen=

SipCallIdModuleGen=
CallIdModuleGen=
ReleaseCauseModuleGen=

0
0
0

QoSModuleGen=

SeqNumModuleGen=

CallSeqModuleCntxt=
RecordSeqModuleCntxt=
FinalTrunkModuleGen=
FinalTrunkModuleCntxt=
TDMRsrcModuleGen=
OrigTDMRsrcModuleCntxt=
TermTDMRsrcModuleCntxt=
PktRsrcModuleGen=

90000
80
0
90010
0
90020
90021
0

OrigPktRsrcModuleCntxt=
TermPktRsrcModuleCntxt=
PhysicalModuleGen=

90030
90031
0

PhysicalModuleCntxt=
PrefixModuleGen=
DialedPrefixModuleCntxt=
CalledPrefixModuleCntxt=
TreatmentModuleGen=

90040
0
81
82
0

TreatmentModuleCntxt=

90050

Orig Number Module 164 Generation


0 - Use GR-1100 generation rules
1 - Generate 164 Module for all
originating numbers
Term Number Module 164 Generation
0 - Use GR-1100 generation rules
1 - Generate 164 Module for international
terminating numbers
2 - Generate 164 Module for all
terminating numbers
Dialed Digits Module Generation (Module 101)
Outpulse Digits Module Generation
(Module 40)
Trunk Id Module Generation
0 Disable trunk id module generation
1 Generate Module 104
2 Generate Module 167 (Large trunks)
SIP Call Id Module Generation (Module 198)
Call Id Module Generation (Module 611)
Release Cause Module Generation
(Module 616)
Quality of Service Module Generation
(Module 264)
Sequence Number Module Generation
(Module 611 and 616)
Call Sequence Number Module Context
Record Sequence Number Module Context
Final Trunk Module Generation (Module 611)
Final Trunk Module Context
TDM Resource Module Generation (Module 611)
Orig TDM Resource Module Context
Term TDM Resource Module Context
Packet Resource Module Generation
(Module 613)
Orig Packet Resource Module Context
Term Packet Resource Module Context
Physical Interface Module Generation
(Module 612)
Physical Interface Module Context
Prefix Module Generation (Module 616)
Dialed Prefix Module Context
Called Prefix Module Context
Call Treatment Module Generation
(Module 198)
Call Treatment Module Context

Telica, Inc.

Billing and Traffic Collection Guide

#
#
#
#
#
#
#
#

211CallType=
311CallType=
411CallType=
511CallType=
611CallType=
711CallType=
811CallType=
911CallType=

0
0
9
0
0
0
0
0

Section 150-200-500

Call Types for N11 Calls - Valid values are from


zero to 999. The value zero disables AMA generation.

# Output Options
# -------------# Enable ASCII output
# Enable ASCII push
#
ASCIIEnabled= 1
ASCIIPush= 0

0 - Disable 1 - Enable
0 - Disable 1 - Enable
(see section AsciiPush)

# Enable BAF output (AMA Lite)


# Enable BAF push
#
BAFEnabled= 0
BAFPush= 0

0 - Disable 1 - Enable
0 - Disable 1 - Enable
(see section BafPush)

# Enable PlexView Pro output


ProBillEnabled= 0

0 - Disable

1 - Enable

# ASCII/BAF file parameters


# ------------------------# Note: These parameters are relevant only if ASCII or
#
BAF (AMA Lite) output is enabled
# Directory for ASCII output files
ASCIIDir= ./Bill_data/ascii
# Directory for BAF output files
BAFDir= ./Bill_data/baf
# Time BAF and ASCII output files are open for writing (minutes)
FileInterval= 120
# Purge empty BAF and ASCII files
#
0 - Do not purge
#
1 - Purge
PurgeNull= 0
# PlexView Pro Parameters
# ----------------------# Note: These parameters are relevant only if PlexView Pro output is enabled
#
# GDIDir= ./Bill_data/proBill
Directory for PlexView Pro data record buffer

Telica, Inc.

5-9

PlexView
Billing and Traffic System

Issue 4, January 9, 2004

##########################
# ProBilling configuration
##########################
[ProBillingConfig]
#
#
#
#
#
#
#
#

gdiRecordSize=
128
gdiMiniRecs=
1024
gdiMiniInWhole= 4000
gdiPsPort=
gdiPsRaoHost=

1983
<none>

gdiPsHost=

<none>

#gdiPsRaoHost=

Average size of BAF records in bytes


Number of records to be held in shared memory
Number of gdiMiniRecs to be stored in disk buffer
(total records = gdiMiniRecs * gdiMiniInWhole)
port that ProBilling is listening on
Revenue Accounting Host (ProBilling Server)
or 0 to 4 instances of
ProBilling Server hostname/IP

localhost

#################################
# AsciiPush entity configuration
#################################
# Configure FTP push of ASCII billing files to remote server
[AsciiPush]
#
#
#
#
#
#

ArchiveDays=
7
DestinationDir=
Passive=
1
Host=
User=
Password=

Number of days to retain files that have been pushed


Destination directory on FTP server for files
Use FTP passive transfer (0/1 F/T)
FTP server hostname/IP
FTP server login id
FTP server login password

#################################
# BafPush entity configuration
#################################
# Configure FTP push of BAF (AMA Lite) billing files to remote server
[BafPush]
#
#
#
#
#
#

ArchiveDays=
7
DestinationDir=
Passive=
1
Host=
User=
Password=

Number of days to retain files that have been pushed


Destination directory on FTP server for files
Use FTP passive transfer (0/1 F/T)
FTP server hostname/IP
FTP server login id
FTP server login password

#################################
# Statistics entity configuration
#################################
[StatisticsConfig]
# TypeOf740If=
#
# LogPath=
# TsdsPath=

5-10

4
./stats_log
./tsds_data

4=TSAA statistics data fed to tsaa reporter


8=NONE
Path for statistics log file (future)
Path for TSDS .dat files (for TSAA input)

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-200-500

############INFORMATION#######################################################
# Timezone Info, [DataCollectorConfig] section
#
For detailed description of the rules for defining Timezone,
#
see the description of the TZ environment variable in environ(5).
#
#
TZ values used in US:
#
US/Alaska
US/Central
US/Hawaii
US/Pacific
#
US/Aleutian
US/East-Indiana US/Michigan
US/Pacific-New
#
US/Arizona
US/Eastern
US/Mountain
US/Samoa
#
#
The Timezone adjusts the time offset from GMT and the rules for
#
daylight savings time (if applicable).
#
#
If the configured Timezone is invalid, then use GMT, if no Timezone
#
is provided then server's time zone is used for time calculations.

5.1.1.1 Data Collector Main Entity Configuration


The following portion of the plexusDC<_prefix>.ini file indicates the
main entity configuration.
##############################
#Data Collector MAIN Entity Configuration
##############################
[DataCollectorConfig]
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#

Prefix=
MaxLogQueue=
MaxFileSize=
MaxFileCount=
LogPath=
LogFilename=
DebugPort=
DebugBindIp=
BindIp=

<none>
16384
10485760
6
./logs
dcLog
<none>
0.0.0.0
0.0.0.0

Timezone=

<system>

Prefix=

prefix for various output files (ascii, baf, stats)


max trace entries allow on queue before dropping
max size in bytes of any single trace file
max old trace log files retained
directory for trace log files
base name of trace log files
telnet debug port into DataCollector
(INADDR_ANY) override BindIp for debug port only.
(INADDR_ANY) default local bind IP(i/f) for all
TCP listen and connect calls (allows DC bind
to system alias IP). Other sections in the ini
will default to this value if their individual
BindIp is not defined.
USE ONLY IF SERVER and SWITCH timezones DON'T MATCH
Timezone is used to calculate file names, file
rollover times, and some billing fields.
See end of file for description.

SwitchName

MaxLogQueue
This field is the maximum number of entries on the queue before entries
are dropped. The default size of 16384 entries does not need to be
changed.

Telica, Inc.

5-11

PlexView
Billing and Traffic System

Issue 4, January 9, 2004

MaxFileSize
This field is the maximum size of any trace file in bytes. The default size
of 10485760 does not need to be changed.
MaxFileCount
This field indicates the maximum number of old log files that are retained
on the disk. The default size of 6 does not need to be changed.
LogPath
This field indicates the name of the directory and its path of where the logs
are stored. The default is ./logs.
LogFilename
This field indicates the base name of log files and does not need to be
changed from the default.
DebugPort
The field indicates the telnet debug port into Data Collector. It has been
set to 2361.
DebugBindip
This field indicates the override IP address of the Plexus for debug only.
The default is 0.0.0.0 so that TCP can listen and connect calls (allows DC
bind to system alias IP).
Bindip
This field indicates the IP address of the Plexus. The default is 0.0.0.0 so
that TCP can listen and connect calls (allows DC bind to system alias IP).
Other sections in the plexusDC<_prefix>.ini file will default to this value
if their individual BindIp is not defined.
Timezone
This field is used if the server and switch time zones do not match. It is
used to calculate file names, file rollover times, and some billing fields.
Prefix
This field is used to assign the switch name.

5-12

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-200-500

5.1.1.2 Receiver Entity Configuration


The following portion of the plexusDC<_prefix>.ini file indicates the
receiver configuration.
##############################
#Receiver Entity Configuration
##############################
[ReceiverConfig]
#
#
#
#
#
#
#
#

GdiPort=
GdiHost=

1986
mgcId

host/IP

IP port to listen on for GDI connections


mgcId is a unique integer (1-63)

ArchiveDays=
0
ArchiveInterval= 720
720 minutes = 12 hour (limit 5 - 1440)
ArchivePath=
<DataCollectConfig:LogPath>
ArchivePrefix=
<DataCollectConfig:Prefix>
ArchivePurgeNull= 1
purge null files

GdiHost=
GdiHost=

1
2

SPA_address
SPB_address

GDIPort
The GDI (Generating system to Data server Interface) server port is 1986
and does not need to be changed. This is the port of the server that
receives the CDRs.
GDIHost
GDIHost is the mgcId and the IP address or name of each the switchs
system processors. The mgcId indicates the unique media gateway
controller identification which a number from 1 to 63. The defaults are 1
and 2. If the Data Collector is collecting information from multiple
Plexus, there will be multiple plexusDC<_prefix>.ini files and at this time
the GDI host can be 1 and 2 in each of those files. The host/IP is the IP
address or name of the system processor. These fields must be changed so
are inserted with no comment indicator at the end of this section.
ArchiveDays
This field indicates the number of days to hold archive files before
deleting. The default value of 0 disables this feature.
ArchiveInterval
This field indicates how often the files will be archived. The range is 5 to
1440 minutes and the default is 720 minutes or 12 hours.
ArchivePath
This field indicates the path for archived files.

Telica, Inc.

5-13

PlexView
Billing and Traffic System

Issue 4, January 9, 2004

ArchivePrefix
This field indicates the prefix for archived files.
ArchivePurgeNull
This field indicates whether or not null files will be purged. A value of 0
indicates that they will not be purged and the default value of 1 indicates
that they will be purged.
5.1.1.3 Billing Entity Configuration
The following portion of the plexusDC<_prefix>.ini file indicates the
configuration for billing. The billing configuration fields for Plexus
running a software version earlier than 3.8 were provisioned in the Plexus
with the ED-BILLSYS command.

#################################
# Billing entity configuration
#################################
[BillingConfig]

# AMA Record Formatting Parameters


# -------------------------------#
#
#
#
#
#
#
#
#
#
#
#

SensorType=
SensorId=

195
0

Sensor Type
Sensor Id - If non-zero, it overrides the
switch Id sent from the switch.
Recording Office Type
Recording Office Id

RecOfficeType=
RecOfficeId=

195
999999

DAAMAGen=
IntraLATAAMAGen=
FraudAMAGen=
FraudCallType=

1
1
0
800

#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#

OrigNumberModuleGen=

TermNumberModuleGen=

Directory Assistance AMA Generation


Intra LATA AMA Generation
Fraud AMA Generation
Call Type for Fraud Calls - Valid values are
from 800 to 999.

DialedDigitsModuleGen=
0
OutpulseDigitsModuleGen= 0
TrunkIdModuleGen=

SipCallIdModuleGen=
CallIdModuleGen=

0
0

5-14

Orig Number Module 164 Generation


0 - Use GR-1100 generation rules
1 - Generate 164 Module for all
originating numbers
Term Number Module 164 Generation
0 - Use GR-1100 generation rules
1 - Generate 164 Module for international
terminating numbers
2 - Generate 164 Module for all
terminating numbers
Dialed Digits Module Generation (Module 101)
Outpulse Digits Module Generation
(Module 40)
Trunk Id Module Generation
0 Disable trunk id module generation
1 Generate Module 104
2 Generate Module 167 (Large trunks)
SIP Call Id Module Generation (Module 198)
Call Id Module Generation (Module 611)

Telica, Inc.

Billing and Traffic Collection Guide


# ReleaseCauseModuleGen=
#
# QoSModuleGen=
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#

0
0

SeqNumModuleGen=

CallSeqModuleCntxt=
RecordSeqModuleCntxt=
FinalTrunkModuleGen=
FinalTrunkModuleCntxt=
TDMRsrcModuleGen=
OrigTDMRsrcModuleCntxt=
TermTDMRsrcModuleCntxt=
PktRsrcModuleGen=

90000
80
0
90010
0
90020
90021
0

OrigPktRsrcModuleCntxt=
TermPktRsrcModuleCntxt=
PhysicalModuleGen=

90030
90031
0

PhysicalModuleCntxt=
PrefixModuleGen=
DialedPrefixModuleCntxt=
CalledPrefixModuleCntxt=
TreatmentModuleGen=

90040
0
81
82
0

TreatmentModuleCntxt=

90050

211CallType=
311CallType=
411CallType=
511CallType=
611CallType=
711CallType=
811CallType=
911CallType=

0
0
9
0
0
0
0
0

Section 150-200-500
Release
(Module
Quality
(Module

Cause Module Generation


616)
of Service Module Generation
264)

Sequence Number Module Generation


(Module 611 and 616)
Call Sequence Number Module Context
Record Sequence Number Module Context
Final Trunk Module Generation (Module 611)
Final Trunk Module Context
TDM Resource Module Generation (Module 611)
Orig TDM Resource Module Context
Term TDM Resource Module Context
Packet Resource Module Generation
(Module 613)
Orig Packet Resource Module Context
Term Packet Resource Module Context
Physical Interface Module Generation
(Module 612)
Physical Interface Module Context
Prefix Module Generation (Module 616)
Dialed Prefix Module Context
Called Prefix Module Context
Call Treatment Module Generation
(Module 198)
Call Treatment Module Context

Call Types for N11 Calls - Valid values are from


zero to 999. The value zero disables AMA generation.

AMA Record Formatting Parameters


SensorType
This field identifies the type of switch in the billing office. The factory
default of sensorType is 195 and currently is the only acceptable value,
indicating that the switch is the Plexus 9000.
SensorId
The sensor ID identifies the local switching element that generates the
billing records. A value of 0 (the factory default) indicates that the
parameter is not applicable. Valid values are 0 to 999999. The default is
0 and should be changed.
RecordingOfficeType
The RecOfficeType field identifies the type of switch in the billing office.
The factory default is 195 and currently the only acceptable value,
indicating that the switch is the Plexus 9000.
Telica, Inc.

5-15

PlexView
Billing and Traffic System

Issue 4, January 9, 2004

RecordingOfficeID
The RecOfficeId field identifies the billing office. A value of 0 (the
factory default) indicates that the parameter is not applicable. Valid
values are 0 to 999999. The default is 999999 and can be changed.
Directory Assistance AMA Generation
The DAAMAGen field indicates whether call detail record processing for
directory assist calls is set to be in service or out of service. The default is
1 or enabled. Values are:
0 = Disable
1 = Enable
IntraLATA AMA Generation
The IntraLATAAMAGen field identifies the default IntraLATA call type.
Call processing determines the call type when intralataCallType is set to
zero. The default is 1 or enabled. Values are:
0 = Disable
1 = Enable
Fraud AMA Generation
The FraudAMAGen field identifies whether a CDR will be generated for
the beginning of a fraud call. The default is 0 or disabled. Values are:
0 = Disable
1 = Enable
Call Type for Fraud Calls
The FraudCallType field identifies the call type to be used for fraud calls.
The default is 800, can be a value from 800 to 999, which are the call
types that are not administered by Telcordia.
Originating Number Module Generation
The OrigNumberModuleGen field identifies whether GR-1100 generation
rules will be used or whether all module 164 originating number
information for fields 133 to 137 will be generated. The default is 0.
0 = Use GR-1100 generation rules
1 = Generate 164 Module for all originating numbers

5-16

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-200-500

Terminating Number Module Generation


The TermNumberModuleGen field identifies whether GR-1100 generation
rules will be used, whether module 164 will be used for terriginating
international numbers or whether all module 164 terminating number
information for fields 113 to 117 will be generated. The default is 0.
0 = Use GR-1100 generation rules
1 = Generate 164 Module for all international terminating numbers
2 = Generate 164 Module for all terminating numbers
Dialed Digit Module Generation (Module 101)
The DialedDigitsModuleGen field identifies whether dialed digits for
fields 156 to 158 will be generated. The default is 0 or disabled. Values
are:
0 = Disable
1 = Enable
Outpulse Digits Module Generation (Module 40)
The OutpulseDigitsModuleGen field identifies whether outpulse digits for
fields 168 and 169 will be generated. The default is 0 or disabled. Values
are:
0 = Disable
1 = Enable
Trunk Id Module Generation (Module 104)
The TrunkIdModuleGen field enables or disables Module 104 or Module
167 (for large trunks), which captures trunk identification. When enabled
the trunk group, as well as the particular trunk within the trunk group, is
identified in fields 64 to 69 of the ASCII or AMA Lite billing report. The
default is 1 or generate Module 104. Values are:
0 Disable trunk id module generation
1 Generate Module 104
2 Generate Module 167 (Large trunks)
SIP Call Id Module Generation (Module 198)
The SipCallIdModuleGen enables or disables inserting an ASCII string for
a SIP called or calling party number. The default is 1 or enabled. Values
are:
0 = Disable
1 = Enable

Telica, Inc.

5-17

PlexView
Billing and Traffic System

Issue 4, January 9, 2004

Call Id Module Generation (Module 611)


The CallIdModuleGen field enables or disables the generation of a unique
identification number that matches a number used in traffic statistics
reports. The call identifier is generated by the switch so call IDs are
unique only among calls from a particular switch. The default is 0 or
disabled. Values are:
0 = Disable
1 = Enable
Release Cause Module Generation (Module 616)
The ReleaseCauseModuleGen field identifies whether the release cause
module 616 will be generated for fields 170 and 172. The default is 0 or
disabled. The default is 0 or disabled. Values are:
0 = Disable
1 = Enable
Quality of Service (Qos) Module Generation (Module 264)
The QosModuleGen field identifies whether the release cause module 616
will be generated for fields 186 to 201. The default is 0 or disabled.
Values are:
0 = Disable
1 = Enable
Sequence Number Module Generation (Module 611 and 616)
Unique call sequence numbers are generated for each billing record sent
from the Plexus 9000 to the BTS. The call sequence number is captured
in AMA Module 611. For cases where multiple records are generated
from one billing record sent from the switch (i.e. Call Forwarding), the
BTS includes an additional record sequence number. Additional record
sequence number fields will only be included on subsequent billing
records. The record sequence numbers will be captured in AMA Module
616.
The SeqNumModuleGen field enables or disables the generation of
sequence numbers with module 611 and 616. The default is 0 or disabled.
Values are:
0 = Disable
1 = Enable
Call Sequence Number Module Context
The CallSeqModuleCntxt field identifies module 611 as a sequence
number module. The default is 90000. Values are 90000 to 99998.

5-18

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-200-500

Record Sequence Number Module Context


The RecordSeqModuleCntxt identifies module 616 as a sequence number
module. The default is 80.
Final Trunk Module Generation (Module 611)
The FinalTrunkModuleGen field enables or disables the generation of
final trunks with module 611. The default is 0 or disabled. Values are:
0 = Disable
1 = Enable
Final Trunk Module Context
The FinalTrunkModuleCntxt field identifies module 611 as a final trunk
module. The default is 90010. Values are 90000 to 99998.
TDM Resource Module Generation (Module 611)
The TDMRsrcModuleGen field identifies whether module 611 TDM
resources will or will not be generated. The default is 0 or disabled.
Values are:
0 = Disable
1 = Enable
Originating TDM Resource Module Context
The OrigTDMRsrcModuleCntxt field identifies the context number. The
default value is 90020. Values are 90000 to 99998.
Terminating TDM Resource Module Context
The TermTDMRsrcModuleCntxt field identifies the context number. The
default value is 90021. Values are 90000 to 99998.
Packet Resource Module Generation (Module 613)
The PktRsrcModuleGen field identifies whether module 613 packet
resource information will be generated. The default is 0 or disabled.
Values are:
0 = Disable
1 = Enable
Originating Packet Resource Module Context
The OrigPktRsrcModuleCntxt field identifies the originating context
number. The default value is 90030. Values are 90000 to 99998.
Terminating Packet Resource Module Context
The TermPktRsrcModuleCntxt field identifies the terminating context
number. The default value is 90031. Values are 90000 to 99998.

Telica, Inc.

5-19

PlexView
Billing and Traffic System

Issue 4, January 9, 2004

Physical Interface Module Generation (Module 612)


The PhysicalModuleGen field enables or disables the appending of nonstandard module 612 to all billing records for physical circuit
identification. The default is 0 or disabled. Values are:
0 = Disable
1 = Enable
Physical Interface Module Context
The PhysicalModuleCntxt field identifies the context inserted into module
612 when the value of append612 is enabled. The factory default is
90040. Values are 90000 to 99998.
Prefix Module Generation (Module 616)
The PrefixModuleGen field identifies whether module 616 for fields 163
and 164 will be generated. The default is 0 or disabled. Values are:
0 = Disable
1 = Enable
Dialed Prefix Module Context
The DialedPrefixCntxt field identifies the dialed prefix context number.
The default value is 81.
CalledPrefix Module Context
The CalledPrefixModuleCntxt field identifies the called prefix context
number. The default value is 82.
Treatment Module Generation
The TreatmentModuleGen field identifies whether module 198 fields will
be generated. The default is 0 or disabled. Values are:
0 = Disable
1 = Enable
Treatment Module Context
The TreatmentModuleCntxt field identifies the treatment context. The
factory default is 90050. Values are 90000 to 99998.
Call Types for N11 Calls
These fields assign a call type for N11 calls. The values can be 0 to 999.
Values of 1 to 799 are administered by Telcordia. The default value for
all call types, except 411, is 0 that disables AMA generation. 411 call
type has a default of 9 which is the Telcordia call type for 411 calls.

5-20

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-200-500

5.1.1.4 Billing Output Options


The following portion of the plexusDC<_prefix>.ini file indicates the
configuration for enabling or disabling output options. Outputs can be any
combination.
# Output Options
# -------------# Enable ASCII output
# Enable ASCII push
#
ASCIIEnabled= 1
ASCIIPush= 0

0 - Disable 1 - Enable
0 - Disable 1 - Enable
(see section AsciiPush)

# Enable BAF output (AMA Lite)


# Enable BAF push
#
BAFEnabled= 0
BAFPush= 0

0 - Disable 1 - Enable
0 - Disable 1 - Enable
(see section BafPush)

# Enable PlexView Pro output


ProBillEnabled= 0

0 - Disable

1 - Enable

Enable ASCII Output


The ASCIIEnabled field enables or disables the generation of ASCII
Billing System records. Default is 1 or enable. Values are:
0 = Disable
1 = Enable
Enable ASCII Push
The ASCIIPush field enables or disables whether files will be FTPed to
another server. The default is 0 or disabled. Values are:
0 = Disable
1 = Enable
Enable BAF output (AMA Lite)
The BAFEnabled field enables or disables the generation of AMA Lite
records. Default is 0 or disable. Values are:
0 = Disable
1 = Enable

Telica, Inc.

5-21

PlexView
Billing and Traffic System

Issue 4, January 9, 2004

Enable BAF Push


The BAFPush field enables or disables whether files will be FTPed to
another server. The default is 0 or disabled. Values are:
0 = Disable
1 = Enable
Enable PlexView Pro Output
The ProBillingEnabled field enables or disables the generation of Billdats
records for the PlexView Pro Billing System. Default is 0 or disable.
Values are:
0 = Disable
1 = Enable
5.1.1.5 ASCII and AMA Lite (BAF) File Parameters
The following portion of the plexusDC<_prefix>.ini file indicates the
configuration for ASCII billing or AMA Lite (BAF) file parameters.
These parameters are only relevant if either ASCII billing or AMA Lite
was enabled.
# ASCII/BAF file parameters
# ------------------------# Note: These parameters are relevant only if ASCII or
#
BAF (AMA Lite) output is enabled
# Directory for ASCII output files
ASCIIDir= ./Bill_data/ascii
# Directory for BAF output files
BAFDir= ./Bill_data/baf
# Time BAF and ASCII output files are open for writing (minutes)
FileInterval= 120
# Purge empty BAF and ASCII files
#
0 - Do not purge
#
1 - Purge
PurgeNull= 0

Directory for ASCII output files


The ASCIIDir field identifies the working directory for data, connection
information and log files of the ASCII Billing System. The default is
./Bill_data/ascii and does not need to be changed.

5-22

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-200-500

Directory for BAF output files


The BAFDir field identifies the working directory for data, connection
information and log files of AMA Lite billing. The default is
./Bill_data/baf and does not need to be changed.
Time BAF and ASCII output files are open for writing (minutes)
The FileInterval field indicates the interval or frequency that files are sent
to the server. The default is 120 minutes. The minimum is five minutes
and the maximum interval is 1440 minutes, which is equal to one day or
24-hours. The start time is midnight.
Purge empty BAF and ASCII files
The PurgeNull field allows files with zero (0) records to be deleted when
it is equal to 1. Files that are saved then have at least one record. The
default is 0 or do not purge. Values are:
0 = Do not purge
1 = Purge
5.1.1.6 PlexView Pro Billing (Billdats) Parameters
These parameters in the following fields are relevant only if PlexView Pro
output is enabled.
# PlexView Pro Parameters
# ----------------------# Note: These parameters are relevant only if PlexView Pro output is enabled
#
# GDIDir= ./Bill_data/proBill
Directory for PlexView Pro data record buffer
##########################
# ProBilling configuration
##########################
[ProBillingConfig]
#
#
#
#
#
#
#
#

gdiRecordSize=
128
gdiMiniRecs=
1024
gdiMiniInWhole= 4000
gdiPsPort=
gdiPsRaoHost=

1983
<none>

gdiPsHost=

<none>

#gdiPsRaoHost=

Telica, Inc.

Average size of BAF records in bytes


Number of records to be held in shared memory
Number of gdiMiniRecs to be stored in disk buffer
(total records = gdiMiniRecs * gdiMiniInWhole)
port that ProBilling is listening on
Revenue Accounting Host (ProBilling Server)
or 0 to 4 instances of
ProBilling Server hostname/IP

localhost

5-23

PlexView
Billing and Traffic System

Issue 4, January 9, 2004

Directory for PlexView Pro Data Files


The GDIDir field identifies the directory for data, connection information
and log files for the PlexView Pro Billing application. The default is
/Bill_data/proBill and does not need to be changed.
Average Record Size (bytes)
The gdiRecordSize field indicates the average record size and the default
is 128 bytes.
Number of Records to be Held in Shared Memory
The gdiMiniRecs field indicates the number of records to be held in shared
memory and the default is 1024 record.
Number of Records to be Stored in Disk Buffer
The gdiMiniInWhole field indicates the number of records to be stored in
the disk buffer and the default is 4000 records.
Revenue Accounting Host
The gdiPsRaoHost field identifies the ProBilling server revenue
accounting host with a name or an IP address or there can be up to 4
instances of gdiPsHost.
5.1.1.7 ASCII and BAF Push Entity Configuration
#################################
# AsciiPush entity configuration
#################################
# Configure FTP push of ASCII billing files to remote server
[AsciiPush]
#
#
#
#
#
#

ArchiveDays=
7
DestinationDir=
Passive=
1
Host=
User=
Password=

Number of days to retain files that have been pushed


Destination directory on FTP server for files
Use FTP passive transfer (0/1 F/T)
FTP server hostname/IP
FTP server login id
FTP server login password

#################################
# BafPush entity configuration
#################################
# Configure FTP push of BAF (AMA Lite) billing files to remote server
[BafPush]
#
#
#
#
#
#

ArchiveDays=
7
DestinationDir=
Passive=
1
Host=
User=
Password=

5-24

Number of days to retain files that have been pushed


Destination directory on FTP server for files
Use FTP passive transfer (0/1 F/T)
FTP server hostname/IP
FTP server login id
FTP server login password

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-200-500

ASCII and BAF (AMA Lite) files can be FTPed to remote servers. The
configuration of the push entity specifies the name of the server, the
username and password.
Archive Days
This field indicates the number of to retain files that have been pushed
before deleting them from the BTS server. The default is 7 days.
Destination Directory
This field indicates the output directory on the server (full path).
This directory needs to already exist and the user must have read and write
permission to the directory.
Passive
This field indicates whether to use FTP passive transfer. Passive transfers
are typically used when there is a firewall involved. The default is 1 or
enable passive transfers. Values are:
0 = Disable
1 = Enable
Host
This field is the name or IP address of the server to which the files will be
FTPed.
User
This field is the username that is used when FTPing the ASCII or BAF
files.
Password
This field is the password that is used when FTPing the ASCII or BAF
files.
5.1.1.8 Statistics Entity Configuration
The following portion of the plexusDC<_prefix>.ini file indicates the
configuration for Traffic Collection or statistics file parameters.
#################################
# Statistics entity configuration
#################################
[StatisticsConfig]
# TypeOf740If=
#
# LogPath=
# TsdsPath=

Telica, Inc.

4
./stats_log
./tsds_data

4=TSAA statistics data fed to tsaa reporter


8=NONE
Path for statistics log file (future)
Path for TSDS .dat files (for TSAA input)

5-25

PlexView
Billing and Traffic System

Issue 4, January 9, 2004

TypeOf740If
This field enables the collection of traffic statistics data. If you wish to
disable the traffic collection application, you should insert
TypeOf740IF=8 after TsdsPath line.
LogPath
This field indicates the directory that keeps the statistics data, log, and
connection files. The default is ./stats_log and there is no need to
change from the default.
TdsPath
This field specifies the directory containing the binary files generated from
the TelicaStatsServer. The default path is ./tsds_data.
5.4.2 The tsaa.conf File
The TCA is a stand-alone application that runs on Sun server. It interfaces
with the BTS, which generates CDRs in binary files. The TCA parses this
data and generates peg count records and calculates busy hour information
in text formats.
The TCA configuration file named tsaa.conf resides in the same directory
as the plexusDC<prefix>.ini file. It is automatically started when the
S99PLXStats script is run.
Once the TCA is operational, the application generates peg counts, CCS,
holdtime and busy hour information as determined by the
tsaa_<prefix>.conf file. The application creates directories specified in
the tsaa_<prefix>.conf file, for its output and log files. The log file is:
tsaa_<pid>.log
with pid meaning process ID.
The changes you must make to this file are shown in boldface type. Other
lines may also be changed. If you enter a configuration point value
beyond a valid range, default values are used. You must save the
configuration before exiting. A sample of the tsaa_<prefix>.conf file is
shown in Table 5-B.

5-26

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-200-500

Table 5-B. Sample tsaa_<prefix>.conf File


#
#
#
#
#
#

FileName: *tsaa.conf
This file contains the configuration information for the
Telica Statistical Analysis Application (TSAA), and should be
modified by authorized personnel only.
Prefix: boston
Input Directory: tsds_data
Output Directory: tsaa_boston
Log Directory: tsaa_boston/log
Percent Blocking: 0.01
Peg Count Report: 1
ASR Report: 1
Hold Time Report: 1
SS7 Trkgrp CCS Report: 3
Intfcgrp CCS Report: 3
CAS Trkgrp CCS Report: 3
BICC Trkgrp CCS Report: 3
SIP Trkgrp CCS Report: 3
GR303 Intfcgrp CCS Report: 3
CAS Intfcgrp CCS Report: 3
ASCII CDR Report: 1
Detailed Peg Report: 1
Calculate DN Peg Count: 1
Busy Hour Granularity: 30
CCS Granularity Period: 4
Peg Count Granularity Period: 4
ASR Granularity Period: 4
Hold Time Granularity Period: 4
Input Storage Duration: 30
Output Storage Duration: 30
FTP to EMS: 0
FTP Transfer Interval: 60
EMS IP Address: 127.0.0.1
EMS Username: anonymous
EMS Password: boston
EMS Output Directory: /tsaa_data

Fields:
Prefix
This field indicates the prefix that is unique for a switch and was
established in the PlexusDC.ini or tsds.conf file.

Telica, Inc.

5-27

PlexView
Billing and Traffic System

Issue 4, January 9, 2004

Input Directory
This field specifies the directory containing the binary files generated from
the TelicaStatsServer. It must be identical to the value specified in the
Statistics entity configuration section of the PlexusDC.ini file or the
DATA_DIR parameter of the tsds.conf file. The default name is
tsds_data.
Output Directory
This field specifies the name of the output directory for statistics data files.
This name should be changed to tsaa_<prefix>.
Log Directory
This field specifies the name of the output directory for all log files. The
name should be changed to tsaa_<prefix>/log. It must be identical to the
value specified in the Statistics entity configuration section of the
PlexusDC.ini file
Percent Blocking
This field indicates the value used in the calculation of Erlang B,
specifying the acceptable number of failure of calls due to an insufficient
number of lines available. The minimum is 0; the maximum is 1; and the
default is 0.01. Refer to section 5.4.4 for a description of Erlang B.
Peg Count Report
This field specifies whether or not to report Peg Counts.
0 = Do not report Peg Counts.
1 = Report Peg Counts. This is the default value.
ASR Report
This field specifies whether or not to report the Answer to Seizure Ratio
(ASR).
0 = Do not report ASR.
1 = Report ASR. This is the default value.
Hold Time Report
This field specifies whether or not to report trunk group average hold time.
0 = Do not report average hold time.
1 = Report the average hold time. This is the default value.

5-28

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-200-500

SS7 Trkgrp CCS Report


This field specifies the format for the SS7 trunk group CCS reporting.
0 = Reporting is disabled.
1 = Report only, space-delimited format.
2 = Report only, comma-delimited format.
3 = Report both space-delimited and comma-delimited formats.
This is the default value.
Intfcgrp CCS Report
This field specifies the format for the interface group CCS reporting.
0 = Reporting is disabled.
1 = Report only, space-delimited format.
2 = Report only, comma-delimited format.
3 = Report both space-delimited and comma-delimited formats.
This is the default value.
CAS Trkgrp CCS Report
This field specifies the format for the CAS trunk group reporting.
0 = Reporting is disabled.
1 = Report only, space-delimited format.
2 = Report only, comma-delimited format.
3 = Report both space-delimited and comma-delimited formats.
This is the default value.
BICC Trkgrp CCS Report
This field specifies the format for the BICC trunk group reporting.
0 = Reporting is disabled.
1 = Report only, space-delimited format.
2 = Report only, comma-delimited format.
3 = Report both space-delimited and comma-delimited formats.
This is the default value.
SIP Trkgrp CCS Report
This field specifies the format for the SIP trunk group reporting.
0 = Reporting is disabled.
1 = Report only, space-delimited format.
2 = Report only, comma-delimited format.
3 = Report both space-delimited and comma-delimited formats.
This is the default value.

Telica, Inc.

5-29

PlexView
Billing and Traffic System

Issue 4, January 9, 2004

GR303 Intfcgrp CCS Report


This field specifies the format for the GR303 interface group CCS
reporting.
0 = Reporting is disabled.
1 = Report only, space-delimited format.
2 = Report only, comma-delimited format.
3 = Report both space-delimited and comma-delimited formats.
This is the default value.
CAS Intfcgrp CCS Report
This field specifies the format for the CAS interface group CCS reporting.
0 = Reporting is disabled.
1 = Report only, space-delimited format.
2 = Report only, comma-delimited format.
3 = Report both space-delimited and comma-delimited formats.
This is the default value
ASCII CDR Report
This field enables or disables ASCII CDR reporting every five minutes.
0 = Reporting is disabled.
1 = Only Call Release CDRs are printed. This is the default value
2 = Both Long Duration and Release CDRs are printed.
Detailed Peg Report
This field enables or disables detailed peg reporting.
0 = Detailed reporting is disabled. Pegged for the state of the call.
1 = Detailed reporting is enabled. Pegged for the release cause
codes. This is the default value
Calculate DN Peg Count
This field enables or disables the calculation of Directory Number (DN)
peg counts.
0 = Do not calculate DN Peg Counts.
1 = Calculate DN Peg Counts. This is the default value.
Busy Hour Granularity
This field specifies the granularity of the busy hour calculation. Units are
in minutes. Valid range is 0, 5, 30 and 60 and the default is 30.
0 = Disable.
5 = 5 minutes.
30 = 30 minutes - This is the default value.
60 = 60 minutes or 1 hour.

5-30

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-200-500

CCS Granularity Period


This field specifies the granularity of how often the files are written to
disk. The values are 2, 3 and 4.
2 = Created every 15 minutes
3 = Created every 30 minutes
4 = Created every hour. This is the default value
Peg Count Granularity Period
This field specifies the granularity of how often the files are written to
disk. The values are 2, 3, 4 and 5.
2 = Created every 15 minutes
3 = Created every 30 minutes
4 = Created every hour. This is the default value.
5 = Created once a day
ASR Granularity Period
This field specifies the granularity of how often Answer to Seizure Ratio
(ASR) files are written to disk. The values are 2, 3, 4 and 5.
2 = Created every 15 minutes.
3 = Created every 30 minutes.
4 = Created every hour. This is the default value.
5 = Created once a day.
Hold Time Granularity Period
This field specifies the granularity of how often the files are written to
disk. Values are 2, 4 and 5.
2 = Created every 15 minutes
4 = Created every hour. This is the default value.
5 = Created once a day
Input Storage Duration
This field specifies the number of days to store input files. Values are 0 to
180.
0 = File should be removed next day. (Not recommended).
30 days is the default value.
If tsaa is configured to ftp files, even if the files are older than Input
Storage Duration they are not removed, if they have not been ftped yet.

Telica, Inc.

5-31

PlexView
Billing and Traffic System

Issue 4, January 9, 2004

Output Storage Duration


This field specifies number of days to store files. Values are 0 to 180.
0 = File should be removed next day. (Not recommended).
30 days is the default value.
If tsaa is configured to ftp files, even if the files are older than Output
Storage Duration they are not removed, if they have not been ftped yet.
Note: The following fields refer to files that are FTPed to the EMS
server
FTP to EMS
This field specifies whether or not to FTP to Element Management System
(EMS).
0 = Do not FTP to EMS.
1 = FTP to EMS
FTP Transfer Interval
This field specifies the interval between FTPs to EMS. Values are 30 to
900 seconds. The default value is every 60 seconds.
EMS IP Address:
This field specifies the IP address of the EMS server.
EMS Username:
This field specifies the username for EMS.
EMS Password:
This field specifies the password for EMS.
EMS Output Directory:
This field specifies the output directory on the EMS server (full path).
This directory needs to already exist and the EMS user must have read and
write permission to the directory.
5.4.3

The tsaa_<pid>.log File


This file stores the TSAA current activity by the process ID (PID).
Common activities are peg counts, busy hour calculations, CCS reporting,
hold time calculating and rolling of logs, but error codes and other
debugging information are also reported in the file.

5-32

Telica, Inc.

Billing and Traffic Collection Guide


5.4.4

Section 150-200-500

Erlang B
Erlang and Erlang B calculations are used in the creation of busy hour call
reports. The report specifies the number of Erlangs and circuits and the
circuit usage percentage.
An Erlang is a unit of telecommunications traffic measurement. Strictly
speaking, an Erlang represents the continuous use of one voice path. In
practice, it is used to describe the total traffic volume of one hour. For
example, if a group of users made 30 calls in one hour, and each call had
an average call duration of 5 minutes, then the number of Erlangs this
represents is worked out as follows:
Minutes of traffic in the hour
Minutes of traffic in the hour
Minutes of traffic in the hour
Hours of traffic in the hour
Hours of traffic in the hour
Traffic figure

=
=
=
=
=
=

number of calls x duration


30 x 5
150
150 / 60
2.5
2.5 Erlangs

The Erlang B traffic model is used by telephone system designers to


estimate the number of lines required for PSTN connections or private
wire connections. The three variables involved are Busy Hour Traffic
(BHT), Blocking and Lines:
Busy Hour Traffic (in Erlangs) is the number of hours of call traffic
there are during the busiest hour of operation of a telephone
system.
Blocking is the failure of calls due to an insufficient number of
lines being available. For example, 0.03 mean 3 calls blocked per
100 calls attempted.
Lines is the number of lines in a circuit.

Telica, Inc.

5-33

PlexView
Billing and Traffic System

Issue 4, January 9, 2004

The Erlang B algorithm is as follows:

where a is the busy hour traffic in Erlangs, c is the number of lines, and
B(c,a) is the blockage. The application uses this equation to determine c.
The model assumes that all blocked calls are immediately cleared.

5-34

Telica, Inc.

6.

ASCII Billing Reports

6.1
6.2

Introduction ..........................................................................................................6-2
CDR and ABS Formats ........................................................................................6-2
6.2.1 CDR Data Prior to Conversion.................................................................6-2
6.2.2 ASCII Files After Conversion..................................................................6-4
ASCII-Format Master Record Field Descriptions ...............................................6-9
Module Inclusion Rules .....................................................................................6-60
6.4.1 Module 021, Carrier Access Originating ............................................6-61
6.4.2 Module 022, Long Duration Connection ...............................................6-61
6.4.3 Module 025, Circuit Release Module ....................................................6-65
6.4.4 Module 027, Business Customer ID Module .........................................6-65
6.4.5 Module 029, Alternate Billing Number Module....................................6-66
6.4.6 Module 040, Digits Module ...................................................................6-66
6.4.7 Module 049, Calling Name/Number Delivery Module .........................6-66
6.4.8 Module 68, Called Directory Number (DN) Descriptor ........................6-67
6.4.9 Module 101, Digits Dialed Module........................................................6-67
6.4.10 Module 102, Authorization Code Module .............................................6-67
6.4.11 Module 103, Account Code/Customer Dialed Account Recording
(CDAR) Module ....................................................................................6-67
6.4.12 Module 104, Trunk Identification Module.............................................6-68
6.4.13 Module 105, Message Detail Recording (MDR) ...................................6-68
6.4.14 Module 164, E.164/X.121 Number Module ..........................................6-68
6.4.15 Module 198, Flex Module......................................................................6-68
6.4.16 Module 264, Quality of Service (QoS) (NDGR) ...................................6-68
6.4.17 Module 306, Originating Line Information Parameter (OLIP)..............6-68
6.4.18 Module 611, Generic Module ................................................................6-68
6.4.19 Module 612, Generic Module: Two Digits String Format.....................6-69
6.4.20 Module 613, Generic Module: Three Digits String Format...................6-69
6.4.21 Module 616, 5 Digit Information Module..............................................6-69
6.4.22 Module 719, Local Number Portability (LNP) Core Module................6-69
6.4.23 Module 720, Local Number Portability (LNP) Module.........................6-69
Module Number 164 ..........................................................................................6-69
6.5.1 E.164 Numbering Plan ...........................................................................6-71
6.5.2 X.121 Numbering Plan...........................................................................6-72
Call Types, Structure Codes, and Modules ........................................................6-72
Configuration and Operation..............................................................................6-73

6.3
6.4

6.5

6.6
6.7

Note: To avoid local time synchronization problems, Telica strongly


recommends setting the Plexus system clock to use GMT.

ASCII Billing Reports

Issue 5, January 9, 2003

6.1 Introduction
The PlexView ASCII Billing Server (ABS) or the Billing and Traffic
System (BTS) convert Call Detail Records (CDRs) to an ASCII record
format. The number of fields supported is determined by the version of
ABS or BTS. For detailed information about ABS and BTS, please refer
to those sections of this manual. This section will only describe the
reports generated by either ABS or BTS.

Note: When importing stored file into an Excel spreadsheet, leading zeros
and tenths of seconds may be truncated.
For a description of the master ASCII record and its fields, refer to section
6.2.2, ASCII Files After Conversion.

6.2 CDR and ABS Formats


The Plexus 9000 sends the CDR data at least every five seconds from the
circular buffer. After delivery to ABS or BTS, the data records are
converted to ASCII and saved into ASCII files.
6.2.1 CDR Data Prior to Conversion
The Plexus 9000 CDRs support the Billing Automatic Message
Accounting Format (BAF) call types and structures, and are based on
Telcordias AMA architecture (GR-1100). Currently, the ABS and BTS
applications support the following AMA call types from the switch. These
call types are listed in Table 6-A.
Each CDR is appended with a header that consists of a 4-byte sequence
number and a 2-byte record length. The length field represents the size of
the data and does not include the header size. The Plexus 9000 runs a
process that captures CDRs into memory using a circular buffer that can
be configured to save data.
The ABS or BTS converts the received CDR data into ASCII. The data
field information transferred from the CDR to the ASCII master record is
determined by the call type, the structure code, and the module, if
applicable. For example, call type 110 supports structure code 0625 and
modules 021, 104, 164 and 720. Refer to Table 6-G at the end of this
chapter for a listing of all call types and the structure codes and modules
supported by each.

6-2

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-300-100

Table 6-A. ABS-supported AMA Call Types


Call Type Description
001
Detailed Message Rate, Timed, w/ MBI (MRTD)
002
Message Rate, Timed, w/ MBI (MRT)
003
Detailed Message Rate, Untimed, w/ MBI (MRD)
004
Message Rate, Untimed, w/ MBI. (MR)
006
Station Paid
009
411 Directory Assistance
031
Call Forwarding
033
555 Directory Assistance
036
Terminating Study Record
047
Default Advanced Intelligent Network (AIN)
067
Originating Study Record
074
Free Call
088
Non-Directory Assistance 555 Call
110
Inter-LATA station paid
119
Terminating Access record
123
CLASS Feature Activation
141
InterExchange Carrier (IC/IXC) Number Service
142
Local Exchange Carrier (LEC) Number Service
159
Message Detail Recording (MDR) Data
264
Calling Identity Delivery Record
330
CLASS Feature
710
Originating Toll AMA Recording (Vendor Specific)
720
Connecting Network Access Incoming Record
721
Default Local Number Portability (LNP)

Therefore, all information in the data fields generated by this call type and
its structure code and modules is transferred to the ASCII master record.
In this example, modules 021, 104, 164 and 720 are supported by the call
type. This does not mean that each module is included in every CDR of
this type. Each module is included in the CDR and sent to the ABS or
BTS, based on certain conditions of the call. For a description of when the
modules and their associated data items are included, refer to Section 6.4,
Module Inclusion Rules.

Telica, Inc.

6-3

ASCII Billing Reports

Issue 5, January 9, 2003

6.2.2 ASCII Files After Conversion


ASCII files are saved as comma-delimited ASCII text with a line feed,
which indicates the end of the record. If any field within the master record
has no associated data, the ABS or BTS will still represent the fields
position with commas. For example, if the master record contained six
fields and two of those fields had no data populated, the record might look
as follows:
6178873341,,002010,,002020,1245
Although the default for saving ASCII files is 24 hours, you can configure
the frequency with which files are saved in minutes.
All converted CDR information is captured in an ASCII master record.
This master record contains the fields listed in Table 6-B. Refer to
Section 6.3, ASCII-Format Master Record Field Descriptions for a
description of each field listed in the ASCII master record.
Table 6-B. List of Fields in the Master Record
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27

6-4

Field Description
Call Type
Structure Code
Sensor Type
Sensor Identification
Recording Office Type
Recording Office Identification
Connect Date
Timing Indicator
Study Indicator
Called Party Off-hook Indicator
Service Observed/Traffic Sampled
Indicator
Operator Action
Service Feature
Originating NPA
Originating Number
Overseas (International Call) Indicator
Terminating (Destination) Number Plan
Area
Terminating (Destination) Number
Connect Time
Elapsed Time
IC/INC Prefix
Carrier Connect Date
Carrier Connect Time
Carrier Elapsed Time
IC/INC Call Event Status
Trunk Group Number
IC/INC Routing Indicator

GR-1100
Table #
1
0
2
3
4
5
6
7
8
9

Maximum
# of Char.
3
4
3
6
3
6
10
5
7
1

Format
(see Note.)
###
####
###
######
###
######
MM-DD-YYYY
#####
#######
#

10

11
12
13
14
15

1
3
3
7
1

#
###
###
#######
#

16

#####

17
18
19
5
6
18
19
58
83
59

7
10
9
5
10
10
9
2
5
1

#######
HH:MM:SS.T
#########
CCCCO
MM-DD-YYYY
HH:MM:SS.T
#########
##
STTTT
#

Telica, Inc.

Billing and Traffic Collection Guide

28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58

Field Description
Dialing and Pre-subscription Indicator
ANI/CPN Indicator
Dialed NPA
Dialed Number
Numbering Plan Area
Directory Number
WATS Indicator
WATS Band or Message Billing Index
WATS Administration
Completion Indicator
Service Logic Identification
Revenue Accounting Office (RAO)
Number
Local Access Transport Area (LATA)
Data Capabilities Indicator
Information Transfer Rate Indicator
Terminating Company
Usage Count
Module 21 IC/INC Prefix
Module 21 Carrier Access Date
Module 21 Carrier Access Time
Module 21 Elapsed Time
Module 21 IC/INC Call Event Status
Module 21 Trunk Group Number
Module 21 Routing Indicator
Module 21 Dialing and Presubscription Indicator
Module 21 ANI/CPN Indicator
Module 22 Present Date
Module 22 Present Time
Module 25 Circuit Date
Module 25 Circuit Time
Module 27 Business Customer ID
(Reserved)

59

Module 27 Context ID (Orig/Term)

60
61
62
63

Module 29 Alternate Billing Number


Module 40 Digits Identifier
Module 40 Digits
Module 40 Significant Digits
Module 104 Incoming Routing
Indicator
Module 104 Incoming Trunk Group
Number
Module 104 Incoming Trunk Member
Number
Module 104 Outgoing Routing
Indicator
Module 104 Outgoing Trunk Group
Number
Module 104 Outgoing Trunk Member
Number

64
65
66
67
68
69

Telica, Inc.

Section 150-300-100
GR-1100
Table #
85
60
13
14
13
14
28
29
30
280
77

Maximum
# of Char.
1
1
3
7
3
7
1
3
4
3
9

Format
(see Note.)
#
#
###
#######
###
#######
#
###
####
###
#########

46

###

197
41
42
56
130
57
6
18
19
58
83
59

3
3
3
3
5
5
10
9
9
2
5
1

###
###
###
###
#####
CCCCO
MM-DD-YYYY
HH:MM:SS.T
#########
##
STTTT
#

85

60
6
18
6
18
87
(char. 2-11)
87
(char. 1)
138
78
32 33
55
244
(char. 1)
244
(char. 2-5)
244
(char. 6-9)
244
(char. 1)
244
(char. 2-5)
244
(char. 6-9)

1
10
10
10
10

#
MM-DD-YYYY
HH:MM:SS.T
MM-DD-YYYY
HH:MM:SS.T

10

##########

11
3
24
3

N##########
###
##...##
###

####

####

####

####

6-5

ASCII Billing Reports

73
74

Field Description
Module 164 ChN Number Identity
Module 164 ChN Number Plan
Indicator
Module 164 ChN Country Code or
Data Network Identification Code
Module 164 ChN Significant Digits
Module 164 Charge Number (ChN)

75

Module 611 Significant Digits

76

Module 611 Final Switch, Trunk


Group Number, Trunk Member Number

77

Module 720 Orig Location Type

78

Module 720 Orig Party Identifier


Module 720 Orig Location Routing
Number (LRN)
Module 720 Orig Service Provider
Identity

70
71
72

79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107

6-6

Module 720 Orig Location


Module 720 Orig Supporting
Information
Module 049 - Count of name only
Module 049 - Count of number only
Module 102 - Authorization Code
Module 103 - Account Code

Issue 5, January 9, 2003


GR-1100
Table #
76
165
(char. 1)
165
(char. 2-5)
55
126
237
(char. 6-7)

Maximum Format
# of Char. (see Note.)
1
1 or 4
1

####

3
15

###
###############

15

15

SSSTTTTTTMMMM
MM

###

001

10

##########

########

733
(char 4-15)

12

############

734

SQQ0000

5
5
15
15

#####
#####
###############
###############

10

##########

##

##

3
3
3
10
10
5

###
###
###
MM-DD-YYYY
HH:MM:SS.T
#####

#####

3
3
3
3
24
3
3
24
3
3

###
###
###
###
##...##
###
###
##...##
###
###

126
733
(char 1-3)
730
731
732

803
803
126
126
87
Module 105 - MDR Customer Id context
(char. 1)
87
Module 105 - MDR Customer Id
(char. 2-11)
246
Module 105 - Originating Fac Type
(char. 2-3)
246
Module 105 - Terminating Fac Type
(char. 4-5)
CLASS Feature Code
415
CLASS Functions
330
CLASS Feature Status
331
Deactivation date
6
Deactivation time
18
Call Count - Info Delivered
803
Call Count - Info
803
Anonymous/Unavailable
Screening List Size - SCF SCA
802
Screening List Size SCR
802
Screening List Size - DR CW
802
Module 40_2 - Digits Identifier
78
Module 40_2 Digits
32, 33
Module 40_2 - Significant Digits
55
Module 40_3 - Digits Identifier
78
Module 40_3 - Digits
32, 33
Module 40_3 - Significant Digits
55
Module 40_4 - Digits Identifier
78

Telica, Inc.

Billing and Traffic Collection Guide

108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138

Field Description
Module 40_4 - Digits
Module 40_4 - Significant Digits
Module 40_5 - Digits Identifier
Module 40_5 Digits
Module 40_5 - Significant Digits
Module 164 Term Number Identity
Module 164 Term Number Plan
Indicator
Module 164 Term Country Code or
DNIC
Module 164 Term Significant Digits
Module 164 Term Number
Module 164 CPN Number Identity
Module 164 CPN Number Plan
Indicator
Module 164 CPN Country Code or
DNIC
Module 164 CPN Significant Digits
Module 164 Calling Party Number
(CPN)
Module 164 RN Number Identity
Module 164 RN Number Plan
Indicator
Module 164 RN Country Code or
DNIC
Module 164 RN Significant Digits
Module 164 Redirecting Number (RN)
Module 164 OCN Number Identity
Module 164 OCN Number Plan
Indicator
Module 164 OCN Country Code or
DNIC
Module 164 OCN Significant Digits
Module 164 Original Called Number
(OCN)
Module 164 Billing Number Identity
Module 164 Billing Number Plan
Indicator
Module 164 Billing Country Code or
DNIC
Module 164 Billing Significant Digits
Module 164 Billing Number
Module 306 - OLIP

139 Module 612 - Significant Digits


140 Module 612 Orig Physical
141 Module 612 Term Physical
142 Module 720 Term Location Type
143 Module 720 Term Party Identifier
Module 720 Term Location Routing
144
Number (LRN)

Telica, Inc.

Section 150-300-100
GR-1100
Table #
32,33
55
78
32,33
55
76
165
(char. 1)
165
(char. 2-5)
55
126
76
165
(char. 1)
165
(char. 2-5)
55

Maximum
# of Char.
24
3
3
24
3
1

Format
(see Note.)
##...##
###
###
##...##
###
2

####

3
15
1

###
###############
3 or 5

####

###

126

15

###############

76
165
(char. 1)
165
(char. 2-5)
55
126
76
165
(char. 1)
165
(char. 2-5)
55

####

3
15
1

###
###############
7

####

###

126

15

###############

76
165
(char. 1)
165
(char. 2-5)
55
126
421
237
(char. 6-7)
126
126
733
(char 1-3)
730

####

3
15
3

###
###############
###

30

15
15

TTCCSS0OO331100
TTCCSS0OO331100

###

002

10

##########

731

6-7

ASCII Billing Reports

Field Description
Module 720 Term Service Provider
145
Identity
146 Module 720 Term Location
Module 720 Term Supporting
Information
148 Unused
147

149 Module 611 - Significant Digits


150
151
152
153
154
155
155
156
157
158

Module 611 Call Id


Module 198 Module Descriptor
Module 198 Orig SIP Call Id
Module 198 Module Descriptor
Module 198 Term SIP Call Id
Module 68 Called DN Description
Module 68 Called DN Description
Module 101 - Significant Digits
Module 101 - Digits Dialed
Module 101 Access Code

159 Module 611 - Significant Digits


160 Module 611 Call Sequence Number
161 Module 616 Significant Digits
162

Module 616 Record Sequence


Number

163 Module 616 Significant Digits


164 Module 616 - Dialed Prefix Indicator
165 Module 616 Significant Digits
166
167
168
169

Module 616 - Called Prefix Digits


Module 40 Digits Identifier
Module 40 Outpulse Digits
Module 40 Significant Digits

170 Module 616 Significant Digits


Module 616 Release Originator,
Category, Cause Indicator
172 Module 198 Module Descriptor
173 Module 198 Release Treatment
171

174 Module 611 - Significant Digits


175

Module 611 Orig Echo Indicator, NLP


Indicator, DSP

176 Module 611 - Significant Digits


177

Module 611 Term Echo Indicator NLP


Indicator, DSP

178 Module 613 - Significant Digits


179 Module 613 Orig Local IP Address

6-8

Issue 5, January 9, 2003


GR-1100
Table #

Maximum Format
# of Char. (see Note.)

732

########

733
(char 4-15)

12

############

734

SQQ0000

10

15
5
32
5
32
3
3
3
24
5

00000##########
00010
Variable length
00011
Variable length
###
###
###
####
#####

10

15

00000##########

000##

0000#

5
3
24
3

0000#
005
####
###

803

OCRRR

575
237
(char. 6-7)

5
10

#####
Variable length

126

15

000000ENDDDDDDD

237
(char. 6-7)

126

15

000000ENDDDDDDD

45

15

000############

237
(char. 6-7)
126
575
575
70
70
55
32, 33
803
237
(char. 6-7)
126
569
(char. 3)
803
569
(char. 3)
803
569
(char. 3)
803
78
32, 33
55
569
(char. 3)

237
(char. 6-7)
126

Telica, Inc.

Billing and Traffic Collection Guide

Field Description
180 Module 613 Orig Remote IP Address
Module 613 Orig Local/Remote Port,
181
Codec, Fax Indicator
182 Module 613 - Significant Digits

Section 150-300-100
GR-1100
Table #
126
126
237
(char. 6-7)
126
126

Maximum Format
# of Char. (see Note.)
15
000############
15

00LLLLLRRRRRCCF

45

183 Module 613 Term Local IP Address


15
000############
184 Module 613 Term Remote IP Address
15
000############
Module 613 Term Local/Remote Port,
185
126
15
00LLLLLRRRRRCCF
Codec, Fax Indicator
Module 264 Orig Release Cause
186
411
4
CRRR
Indicator
187 Module 264 Orig Packets Sent
807
13
#############
188 Module 264 Orig Packets Received
807
13
#############
189 Module 264 Orig Packets Lost
807
13
#############
190 Module 264 Orig Octets Sent
807
13
#############
191 Module 264 Orig Octets Received
807
13
#############
192 Module 264 Orig Jitter
802
3
###
193 Module 264 Orig Latency
802
3
###
Module 264 Term Release Cause
194
411
4
CRRR
Indicator
195 Module 264 Term Packets Sent
807
13
#############
196 Module 264 Term Packets Received
807
13
#############
197 Module 264 Term Packets Lost
807
13
#############
198 Module 264 Term Octets Sent
807
13
#############
199 Module 264 Term Octets Received
807
13
#############
200 Module 264 Term Jitter
802
3
###
201 Module 264 Term Latency
802
3
###
Note: Format characters: #=Numeric, In MM-DD-YYYY - M=Month, D=Day, Y=Year; in
HH:MM:SS.T - H=Hours, M=Minutes, S=Seconds, T=Tenth of sec. For all others, refer to field
descriptions.

6.3 ASCII-Format Master Record Field Descriptions


This section contains a description of all fields making up the ASCIIformat master record. For appended module fields (letters ss dddd in this
section), specific module inclusion conditions must first be met. Module
inclusion requirements are provided in Section 6.4, Module Inclusion
Rules.
1. Call Type
The Call Type field defines the type of call that occurred. Based on the
type of call, different fields within the master record are populated. Refer
to Section 6.6, Call Types, Structure Codes, and Modules, for a list of the
data fields that can be populated per call types, structure code and
module(s).

Telica, Inc.

6-9

ASCII Billing Reports

Issue 5, January 9, 2003

Call types 000 799 are administered by Telcordia for uniformity of the
network/accounting interface.
Call types 800 999 are not administered by Telcordia. They are reserved
for use by the carrier.
The Call Type field is a maximum of three numeric characters. Table 6-C
identifies the various call types supported by the Plexus 9000. The table
also provides the associated structure codes and modules that are defined
in Telcordias GR-1000 specification. If Automatic Message Accounting
(AMA) information is not being used by the associated billing application,
the structure code and module information can be ignored.
2. Structure Code
The Structure Code is a four-character numeric field. Each structure code
points to a set of predefined fields in Section 3 of Telcordias GR-1100
documentation. If AMA information is not being used by the associated
billing application, the structure code information can be ignored. The
Plexus supports the AMA structure codes as listed in Table 6-D.

Table 6-C. Call Types Supported by the Plexus 9000


Call
Structure
Type Call Type Name
Code
Module
001 Detailed Message Rate, Timed, w/ MBI
0020
022
002 Message Rate, Timed, w/ MBI.
0020
022
003 Detailed Message Rate, Untimed, w/ MBI.
0020
022
004 Message Rate, Untimed, w/ MBI.
0020
022
006 Station Paid
0001
021, 022, 720
009 411 Directory Assistance
0028
022
031 Call Forwarding
0096, 0614 022
033 555 - Directory Assistance
0028
022
036 Terminating Study Record
0079
022
047 Default Advanced Intelligent Network
0220
021, 022, 025, 027,
(AIN)
029, 040, 104, 164
067 Default Advanced Intelligent Network
0001
021, 022, 720
(AIN)
074 Free Call
0001
022
088 Non-Directory Assistance 555 Call
0001
021, 022, 720
110 Inter-LATA station paid
0625
022, 104, 164
119 Terminating Access record
0625
022, 104, 164
123 CLASS Feature Activation
1030
022
141 InterExchange Carrier (IC/IXC) Number
0360
022
Service

6-10

Telica, Inc.

Billing and Traffic Collection Guide


Call
Type Call Type Name
142 Local Exchange Carrier (LEC) Number
Service
159 Message Detail Recording (MDR) Data
264
330
710
720
721

Section 150-300-100
Structure
Code
0364

Module
022

0001, 0079, 102, 103, 105


0500
Calling Identity Delivery Record
0110
CLASS Feature
110, 1030 49
Originating Toll AMA Recording (Vendor
0625
022, 104, 164
Specific)
Connecting Network Access Incoming
0625
022, 104, 164, 720
Record
Default Local Number Portability (LNP)
0500
022, 104, 164, 720

3.

Sensor Type
The Sensor Type field identifies the type of switch by a three-character
number assigned by Telcordia. Plexus 9000 is Sensor Type = 195. If
AMA information is not being used by the associated billing application,
the Sensor Type information can be ignored.
Table 6-D. Structure Codes
Structure Code List
Call Types
0001
006, 067, 074, 088
0020
001, 002, 003, 004
0028
009, 033
0079
036
0110
264, 330
0220
047, 159
0360
141
0364
142
0500
721
0625
110, 119, 710, 720
1030
123, 330

4. Sensor Identification
The Sensor Identification field is a six-character numeric field. Characters
1-6 specify a six-digit sensor identification code. This code identifies the
sensor that generated or formatted the BAF record that contains the code.

Telica, Inc.

6-11

ASCII Billing Reports

Issue 5, January 9, 2003

The sensor identification code is specified by a carrier and is assigned by a


carrier through translation procedures, except for code 999999. The
999999 code indicates the sensor is a vendors working model of a
switching system that generates AMA test tapes. All records on an AMA
test tape have this sensor identification code.
If AMA information is not being used by the associated billing
application, the Sensor Identification code information can be ignored.
5. Recording Office Type
The Recording Office Type is a three-digit numeric code. The code
identifies the type of office that writes the BAF data to a physical medium
on which it will be transported to a Revenue Accounting Office (RAO) for
processing. The recording office type code may be different from the
sensor type code identified in the Sensor Type field.
The term recording office refers to the first system or device that
captures a BAF record on an archival medium that is intended for
transport of the record to, or storage of the record within, an RAO.
The Plexus 9000s recording office type = 195.
If AMA information is not being used by the associated billing
application, the Recording Office Type information can be ignored.
6. Recording Office Identification
The Recording Office Identification field is a six-character numeric field.
Characters 1-6 specify a six-digit recording office identification code.
This code identifies the recording office that first created an archival
image of the BAF record that contains the code. The recording office
identification code is specified by a Carrier and is assigned by a Carrier
through translation procedures, except for 999999. The 999999 code
indicates the sensor is a vendors working model of a switching system
that generates AMA test tapes. All records on an AMA test tape have this
recording office identification code.
If AMA information is not being used by the associated billing
application, the Recording Office Identification information can be
ignored.
7. Connect Date
The Connect Date indicates the date that Plexus received answer
supervision indicating a completed call. The ten-character field represents
the month, day, and year as follows:
MM-DD-YYYY.
6-12

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-300-100

8. Timing Indicator
The Timing Indicator is a five-digit numeric field. Valid values are:
Chars
digit 1

Meaning
Timing Guard Flag
0 = Default value
1 = Time Release Disconnect
4 = Unanswered Call Release Answer Timer Expiry
6 = The call is forcibly released.

digit 2

Short Called Party Off-Hook Indicator


0 = Default value
1 = Short called party off-hook detected
2 = Under minimum chargeable (UMCD)
3 = SST&UMCD (At disconnect with SST)
4 = SST (Not at disconnect, No SST)

digit 3

Long Duration/Service Party Capability Indicator


0 = Default value
1 = Start of long duration call (for service capability status:
Activation)
2 = Continuation of long duration call
3 = Service capability status: Deactivation

digit 4

Charge Guard Indicator


0 = Default value
1 = Charge guard (conversation elapsed time)
2 = Message Register Not Stroked or trunk not seized
3 = Charge guard and Mess Reg. Not Stroked
4 = Charge guard (elapsed time from carrier connect)
5 = Charge guard (elapsed time and elapsed time from
carrier connect)

digit 5 Time Stamp Error Indicator


0 = Default value
1 = Possible Time Stamp Error (conversation connect)
2 = Possible time stamp error (carrier connect)
3 = Possible time stamp error (carrier and carrier connect)
4 = Time Change Rating Discrepancy

Telica, Inc.

6-13

ASCII Billing Reports

Issue 5, January 9, 2003

9. Study Indicator
Study Indicator is a seven-character numeric field. This field is used in
conjunction with billing studies.

6-14

Chars
digit 1

Meaning
Study Type A
0 = Default value
1 = Point To Point
2 = Subscriber Line Usage Study (SLUS)
3 = Point-to-Point and SLUS (Operator Services Position
System [OSPS] value)
4-9 = Study Dependent (OSPS value)

digit 2

Study Type B
0 = Default value
1 = Complaint observed
2 = Network completion
3 = Complaint observed and network completion
4-9 = Study Dependent (OSPS value)

digit 3

-------0 = Default value


1 = Validation test
2 = Study generated record
3 = Validation test and study generated record
4-9 = Study dependent (OSPS value)

digit 4

Test Call Indicator


0 = Default value
1 = Test call
2 = Network Specific Facility (NSF)
3 = NSF and Test Call
4-9 = Study Dependent (OSPS value)

digit 5

LEC-settable
0 = Default value
2 = Called directory number not marked anonymous
3 = Called directory number marked anonymous
4 = Calling Party Marked Anonymous, Called Party
Marked Not Anonymous
5 = Calling and Called Party Marked Anonymous

digit 6

Originating and Terminating Number Indicator


0 = Default value
1 = No originating number
3 = No terminating number
4 = No originating and terminating numbers
5 = No terminating North American Number Plan (NANP)
station number
Telica, Inc.

Billing and Traffic Collection Guide

Section 150-300-100

6 = No originating NANP station number


7 = No originating and terminating NANP station numbers
8-9 = Study dependent
digit 7

Operator Services System Indicator


0 = Default value
2 = No Automatic Message Accounting (AMA) call
(Operator Services System)
3 = Holding Time Study
4 = Expanded 4 digits
5 = Expanded 5 digits
6 = Expanded 6 digits
7 = Corrected 7 digits
8 = Corrected undetermined number of digits
9 = More than 7 digits seen. No correction

10. Called Party Off-hook Indicator


Called Party Off-hook Indicator is a one-character numeric field. Value 0
indicates called party off-hook is detected on the call, regardless of the
duration of the called party off-hook interval. Valid values:
0 = Called party off-hook detected
1 = Called party off-hook not detected
9 = Unknown
11. Service Observed/Traffic Sampled Indicator
The Service Observed/Traffic Sampled Indicator is a one-character
numeric field. Service observing and/or traffic sampling is applied to a
call if a Carrier activates this feature in the Plexus. Currently, only Local
Number Portability (LNP) and 800 Service calls activate this indicator.
Valid values:
0 = Default value
1 = Service observed
2 = Traffic sampled
3 = Service observed and traffic sampled
4 = Not Service Observed, Not Traffic Sampled, message detailed
recorded
5 = Service Observed, Not Traffic Sampled, message detail
recorded
6 = Not Service Observed, Traffic Sampled, Message Detail
Recorded (MDR)
7 = Service observed, traffic sampled, message detail recorded

Telica, Inc.

6-15

ASCII Billing Reports

Issue 5, January 9, 2003

12. Operator Action


The Operator Action Indicator is a one-character numeric field. This field
indicates whether the operator identifies the originating number and
whether the operator dials the number. For example, value 0 indicates
the call is identified automatically and is customer dialed. Valid values:
0 = Automatically identified, customer-dialed call
1 = Automatically identified, operator-dialed call involving an
Operator Services System
2 = Operator-identified, customer-dialed call
3 = Operator- identified, operator-dialed call involving an Operator
Services System
4 = Customer Dialed, Number Identification Failure (Billing Data
Transmitter [BDT])
5 = Operator Dialed, Number Identification Failure (Billing Data
Transmitter [BDT])
6 = Customer Dialed, Identification failure Automatic Number
Identification (ANI) (Billing Data Transmitter [BDT])
7 = Operator Dialed, Identification Failure Automatic Number
Identification (ANI) (Billing Data Transmitter [BDT])
13. Service Feature
The Service Feature is a three-digit numeric field. It indicates a service
used during the call. The Plexus 9000 supports the following service
values:
001 = Local Exchange Carrier (LEC)-owned standard interface
public line
010 = Three-Way Calling
012 = Call Forwarding
014 = Call Forwarding Busy Line or Call Forwarding Dont
Answer
14. Originating NPA
This Originating NPA is a three-digit numeric field that identifies the
Numbering Plan Area. This field is coordinated with the use of the
Originating Number field.
15. Originating Number
The Originating Number is a seven-character numeric field. The first
three characters represent the NXX and the last four characters (XXXX)
represent the station number.

6-16

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-300-100

The following paragraphs describe requirements for populating the


originating number. This field is coordinated with the use of the
Originating Numbering Plan Area (NPA) field above.
When the NPA, NXX, and station number of the originating line are
available, the system does the following:
Populates the NPA in characters 1-3 of the Originating NPA field.
Populates the NXX in characters 1-3 of the Originating Number
field.
Populates the station number in characters 4-7 of the Originating
Number field.
When only the NPA and the three digits corresponding to the NXX of the
originating number are available for a call (e.g., a call requiring Operator
Number Identification), the system does the following:
Populates the NPA in characters 1-3 of the Originating NPA field.
Populates the NXX in characters 1-3 of the Originating Number
field.
Populates 0000 in characters 4-7 of the Originating Number
field.
Flags that the originating station number is not known or applicable to the
call by setting character 6 of the Study Indicator field to 6.
When the originating number is not available and no error condition
exists, the system does the following:
Populates 0 in each of the character positions (excluding the sign
character) of the Originating NPA field. For a particular toll-free
service call scenario, the NPA may be available, but the originating
number may not (see TR-NWT-000533). In this case, the NPA
populates the Originating NPA field.
Populates 0 in each of the character positions (excluding the sign
character) of the Originating Number field.
Flags that the originating number is not available (and no errors
exist) by setting character 6 of the Study Indicator field to 1.
When the originating number to be recorded in the originating number
fields exceeds 10 digits, it should populate Module 164. A description of
Module 164 is described in section 7, Module Number 164.

Telica, Inc.

6-17

ASCII Billing Reports

Issue 5, January 9, 2003

The Originating Number field together with the Originating NPA field
may be populated with a billing number. Billing numbers are LECassigned and may or may not be consistent with the North American
Numbering Plan (NANP). Non-NANP billing numbers may vary from 1
to 10 digits. The Originating NPA and Number fields are treated as one
concatenated field and the non-NANP billing number populates this
concatenated field right justified and padded with zeros as necessary.
16. Overseas (International Call) Indicator
The Overseas (International Call) Indicator is used with the Terminating
NPA and Terminating Number fields. The Terminating number is the
number the switch uses to route a call. The following list contains the
valid values:
0 = Numbering Plan Area (NPA) dialed by the customer or
provided by another network element (non-international call)
1 = NPA determined by the network element (non-international
call)
2 = Non-North American Numbering Plan (NANP) terminating
number (non-international)
3 = 7-digit international number
4 = 8-digit international number
5 = 9-digit international number
6 = 10-digit international number
7 = 11-digit international number
8 = 12-digit (or greater) international number
17. Terminating (Destination) Number Plan Area
The Terminating NPA is a five-character numeric field. The Terminating
NPA and Terminating Number are used to route the call. These numbers
are not necessarily the dialed numbers.
Chars
digits 1-2
digits 3-5

Meaning
International Expander Positions
Numbering Plan Area

18. Terminating (Destination) Number


The Terminating Number is a seven-character numeric field that
represents the NXX and the station number (XXXX) that is being called.
Chars Meaning
1-3
NXX
4-7
Station Number

6-18

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-300-100

19. Connect Time


The Connect Time is a ten-character field. It provides the hour, minute,
seconds, and tenth of second to indicate the time of day of the called party
going off-hook. The format of this field is HH:MM:SS.T where H=hours,
M= minutes, S = seconds, and T = tenth of seconds.
20. Elapsed Time
The Elapsed Time is a nine-character numeric field. The Elapsed Time
provides a count in tenth of seconds from when the call went off-hook to
the end of the call.
21. IC/INC Prefix
The Inter-exchange Carrier/International Carrier Identification (IC/INC)
Prefix is a five-character numeric field in the format of CCCCO. This
field in an Automatic Message Accounting (AMA) record identifies the
IC/INC that transports the call. The Carrier Identification Code (CIC) in
this field represents either a domestic IC or an INC. If a domestic carrier
delivers the call to an INC, the INCs code is recorded.
Characters 1-4 represent the IC/INC Identification - Characters 1-4
(CCCC) contain the four-digit CIC. These characters are zero when
the CIC is 0000 or when the switch has no valid CIC to populate
these characters.
Character 5 (O) represent an Operator Involvement and can have the
following values:
0 = The Carrier Identification Code (CIC) is a Feature Group D
(FGD) identity, and an IC/INC operator system is involved.
1 = The CIC is an FGD identity, the call is dialed direct, and no
IC/INC operator system is involved.
2 = The CIC is an FGD identity, and IC/INC operator system
involvement cannot be determined.
7 = The CIC is unknown, and an IC/INC operator system is
involved
8 = The CIC is unknown, the call is dialed direct, and no
IC/INC operator system is involved.
9 = The CIC is unknown, and IC/INC operator system
involvement cannot be determined.
22. Carrier Connect Date
The Carrier Connect Date indicates the date that Plexus received the Initial
Address Message (IAM) from the signaling network. The ten-character
field represents the month, day, and year as follows: MM-DD-YYYY.

Telica, Inc.

6-19

ASCII Billing Reports

Issue 5, January 9, 2003

23. Carrier Connect Time


The Carrier Connect Time is a ten-character field. It provides the hour,
minute, seconds, and tenth of second to indicate the time of day that the
switch received the Initial Address Message (IAM). The format of this
field is HH:MM:SS.T where H=hours, M= minutes, S = seconds, and
T = tenth of seconds.
24. Carrier Elapsed Time
The Carrier Elapsed Time is a nine-character numeric field. The Elapsed
Time provides a count in tenth of seconds that indicates the duration time
from the carrier connect time until a Release Message (REL) is received or
sent by the originating network.
25. IC/INC Call Event Status
The IC/INC Call Event Status is a maximum of two digits with leading
zeros suppressed. This field provides information about events occurring
in calls involving ICs or INCs. The information describes how far a call
progressed before terminating and identifies the conditions associated with
the calls termination. The following describes the values and their
meaning:
Broadband Integrated Services Digital Network User Part (BISUP) calls
Originating Carrier Network
00indicates the Switched Virtual Connection (SVC) is
cleared before the BISUP IAM is sent from the Originating
Broadband Switching System.
01 indicates the BISUP IAM is sent.
02 indicates the BISUP IAM Acknowledge (IAA) is
received.
03 indicates the BISUP IAM Reject (IAR) is received.
04 indicates the BISUP Exit Message (EXM) is received
(when referring to the originating BSS) or 04 indicates the
BISUP EXM is sent (when referring to the intermediate BSS).
07 indicates the BISUP Address Complete Message (ACM)
is received.
10 indicates the BISUP Answer Message (ANM) is received.
Terminating Carrier Network
01 indicates the BISUP IAM is received.
10 indicates the BISUP ANM or DSS2 CONNECT is
received.

6-20

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-300-100

Cellular Mobile Carrier (CMC) Calls


Originating Carrier Network
"00" indicates a wink is not received.
"01" indicates a wink is received.
"10" indicates a Called Party Off-Hook indication is received.
Terminating Carrier Network
"01" indicates trunk is seized.
"05" indicates Operator Services Signaling (Type 1 only).
"06" indicates call terminated due to network management.
"08" indicates invalid called NXX.
"09" indicates all other failures in which the call cannot be
completed to the terminating office.
"10" indicates a Called Party Off-Hook indication is received.
Multifrequency (MF) Calls
"00" indicates the call is abandoned or released before receipt
of the carrier connect wink by the originating Exchange
Carriers (ECs) End Office (EO) for an originating exchange
access call, and before trunk seizure at the terminating ECs
EO for a terminating exchange access call.
"01" indicates the carrier connect wink is received from the
carrier by the originating ECs EO for originating exchange
access records, and that trunk seizure occurred at the
terminating ECs EO.
"02" indicates the customer abandons the call before
completing the dialing. This value only applies to originating
exchange access calls.
"03" indicates the call failed or is abandoned after the second
start dial wink is received from trunks utilizing INC signaling.
"04" indicates a timeout occurred waiting for an
acknowledgment wink. It may also indicate that an off-hook
indication instead of an acknowledgment wink is received from
the IC/INC.
"05" indicates disconnect occurred after the originating ECs
EO received the IC/INC off-hook. For operator services or
CAMA signaling, this value applies after the called number is
transmitted and an ANI request off-hook signal is received
from the IC/INC.
"06" (terminating access only) indicates the call disconnects in
the terminating network due to a network management
procedure. This occurs before called party off-hook but after
terminating trunk seizure.

Telica, Inc.

6-21

ASCII Billing Reports

Issue 5, January 9, 2003

"07" indicates the call is abandoned or failed after an


acknowledgment wink is received from the IC/INC by the
originating ECs EO. This only occurs in the originating
network.
"08" (terminating access only) indicates the terminating end of
the call either did not recognize the called NXX or that the
NXX received is not valid in the terminating network
"09" (terminating access only) indicates the call cannot be set
up to the terminating office in the terminating network. This
value is used to cover all failures at the terminating end except
those failures indicated by values "06" and "08".
"10" indicates the receipt of called party off-hook in the
originating network and the occurrence of called party off-hook
in the terminating network.
"11" indicates timeout occurred waiting for the receipt of the
second start dial wink from the carrier for calls utilizing INC
signaling. This only occurs in the originating network.
"12" indicates timeout occurred waiting for an off-hook ANI
request signal from the IC/INC, after the called number was
transmitted in calls utilizing operator services or CAMA
signaling. This only occurs in the originating network.
"13" indicates an off-hook rather than a second start dial wink
is received by the ECs EO for calls utilizing INC signaling.
This only occurs in the originating network.
Signaling System 7 (SS7) Calls (direct connections and/or connections via
an AT)
Calls connected directly to IC
00 indicates the call is abandoned or released before the IAM
is sent by the originating ECs EO.
01 indicates the call is abandoned or released after the IAM
is sent by the originating ECs EO.
06 (terminating access only) indicates the call disconnects in
the terminating network due to a network management
procedure. This occurs before called party off-hook but after
the IAM is received.
07 indicates the call is abandoned or released after the ACM
is received by the originating ECs EO.
08 (terminating access only) indicates the terminating end of
the call either did not recognize the called NXX or that the
NXX received is not valid in the terminating network.
09 (terminating access only) indicates the call cannot be set
up to the terminating office in the terminating network.
10 indicates the call is abandoned or released after the ANM
is received by the originating ECs EO.
6-22

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-300-100

Calls Connected to an IC via an AT


00 indicates the call is abandoned or released before the IAM
is sent by the originating ECs EO or before the EXM is
received by the originating ECs EO from the ECs AT.
01 indicates the call is abandoned or released after the EXM
is received by the originating ECs EO from the ECs AT.
04 indicates a timeout occurs after the EXM is received by
the originating ECs EO from the ECs AT.
06 (terminating access only) indicates the call disconnects in
the terminating network due to a network management
procedure. This occurs before called party off-hook but after
the IAM is received
07 indicates the call is abandoned or released after the ACM
is received by the originating ECs EO.
08 (terminating access only) indicates the terminating end of
the call either did not recognize the called NXX or that the
NXX received is not valid in the terminating network.
09 (terminating access only) indicates the call cannot be set
up to the terminating office in the terminating network.
10 indicates the call is abandoned or released after the ANM
is received by the originating ECs EO.
Interim Interswitch Signaling Protocol (IISP) Calls
Originating Carrier Network
"00" indicates the Switched Virtual Connection (SVC) is
cleared before the IISP SETUP message is sent from the
Originating Broadband Switching System (BSS).
"01" indicates the IISP SETUP message is sent.
"02" indicates the IISP CALL PROCEEDING (CALL PROC)
message is received.
"07" indicates the IISP ALERT message is received..
"10" indicates the IISP CONNECT (CONN) message is
received.
"14" indicates a CONNECTION ACKNOWLEDGE (CONN
ACK) message is sent.
Terminating Carrier Network
"01" indicates the IISP SETUP message is received.
"10" indicates the IISP CONNECT (CONN) or DSS2
CONNECT is received.
"14" indicates a CONNECTION ACKNOWLEDGE (CONN
ACK) message is sent.

Telica, Inc.

6-23

ASCII Billing Reports

Issue 5, January 9, 2003

Private Network-Network Interface (PNNI) Calls


Originating Carrier Network
"00" indicates the Switched Virtual Connection (SVC) is
cleared before the PNNI SETUP message is sent from the
Originating Broadband Switching System (BSS).
"01" indicates the PNNI SETUP message is sent.
"02" indicates the PNNI CALL PROCEEDING (CALL
PROC) message is received.
"07" indicates the PNNI ALERT message is received.
"10" indicates the PNNI CONNECT (CONN) message is
received.
"14" indicates a PNNI CONNECTION ACKNOWLEDGE
(CONN ACK) message is sent.
Terminating Carrier Network
"10" indicates the PNNI CONNECT (CONN) message is
received.
ATM Inter-Network Interface (AINI) Calls
Originating Carrier Network
"00" indicates the Switched Virtual Connection (SVC) is
cleared before the AINI SETUP message is sent by the
Broadband Switching System (BSS).
"01" indicates the AINI SETUP is sent by the BSS.
"02" indicates the AINI CALL PROC message was received
by the BSS..
"07" indicates the AINI ALERT message was received by the
BSS.
"10" indicates the AINI CONNECT message was received by
the BSS.
Terminating Carrier Network
-"01" indicates the AINI SETUP message is received.
26. Trunk Group Number
The Trunk Group Number is a five-character numeric field in the format
of STTTT. This field provides the outgoing Trunk Group Number
(TGN) for originating calls and the incoming TGN for terminating calls.

6-24

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-300-100

Character 1 (S) = Trunk Group Signaling Type Indicator as


follows:
1 = Non-Signaling System 7 (SS7) direct trunk group
number
2 = Non-SS7 from Interexchange Carrier (IC) to Access
Tandem (AT) and non-SS7 from AT to End Office
(EO)
3 = SS7 direct trunk group number
4 = SS7 from IC to AT and SS7 from AT to EO
5 = Non-SS7 from IC to AT and SS7 from AT to EO
6 = SS7 from IC to AT and non-SS7 from AT to EO
(terminating only)
9 = Signaling type not specified
Characters 2-5 (TTTT) = Trunk Group Number
27. IC/INC Routing Indicator
The IC/INC Routing Indicator is a one-character numeric field. This field
indicates whether direct or tandem routing was used to deliver traffic to an
IC/INC from the end office or from an IC/INC to an end office. Valid
values for this indicator are:
0 = Direct
1 = Tandem
2 = Competitive Access Provider (CAP) direct from end office
3 = CAP direct from Access Provider (AP) tandem
4 = Tandem signaling to Tandem Switch Provider (TSP) - CAP
trunks
5 = Tandem from another Local Exchange Carriers (LEC's) end
office (LEC to LEC Interconnection)
The conditions for recording values for originating calls are as follows:
0 indicates the call is routed to the IC/INC directly from the
originating Equal Access End Office (EAEO).
1 indicates the call is routed to the IC/INC via an Access
Tandem (AT) from the originating EAEO.
The conditions for recording values for terminating calls are as follows:
0 indicates the call is routed from the IC/INC directly to the
terminating EAEO.
1 indicates the call is routed from the IC/INC via an AT to the
terminating EAEO.

Telica, Inc.

6-25

ASCII Billing Reports

Issue 5, January 9, 2003

28. Dialing and Presubscription Indicator


The Dialing and Presubscription Indicator is a one-character field. This
field indicates three things to an accounting office. The first is whether
the end user dialed a Carrier Access Code (CAC) to select a particular
IC/INC for the call. The second is whether the station being used is
presubscribed to the IC/INC to the IC/INC transporting the call. The third
is whether the IC/INC involved in the call has a service arrangement with
the Local Exchange Carrier (LEC) to receive a special Key Pulse (KP)
signal that indicates whether the station is presubscribed to the IC/INC.
The CAC is the dialing pattern used by the customer to access a particular
IC/INC. The dialing pattern of the CAC is currently 101XXXX or
10XXX (permissive to year 2001) for Feature Group D (FGD) and
950-XXXX for Feature Group B (FGB). (Telica currently does not
support FGB).
Within the CAC, the Xs, which range from 0-9, represent a Carrier
Identification Code (CIC). The CIC is placed into the IC/INC Identity
Code field. The CIC identifies the IC/INC that was selected by the
customer for the call.
The CAC is dialed by the customer only to access a particular IC/INC.
Feature Group D (FGD) customers need not dial this code to access a
presubscribed IC/INC. However, the CAC may have to be dialed on intranetwork and cut-through calls.
For FGD, the CAC alone may not be enough to properly route a call.
Other network access digits, such as 1+ or 0+, may have to be dialed after
the CAC to access various switching network functions.
Value 0 applies when recording occurs at a tandem, and when the dialed
digits are not known. Values 1, 2, and 4 9 are associated with
FGD service while value 3 is associated with FGB service.
The following describes each valid value for the Dialing and
Presubscription Indicator:
0 = Dialed digits cannot be determined (No indication CAC dialed:
presubscription status cannot be determined: no presubscription
indication forwarded to IC/INC
1 = Carrier Access Code (CAC) not dialed, customer
presubscribed, not presubscription indication arrangement with
IC/INC
2 = CAC dialed, customer not presubscribed, no presubscription
indication arrangement with IC/INC
3 = 950-XXXX dialed

6-26

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-300-100

4 = CAC not dialed, customer presubscribed, presubscription


indication arrangement with IC/INC
5 = CAC dialed, customer not presubscribed, presubscription
indication arrangement with IC/INC. (Customer not
presubscribed indication provided to IC/INC.)
6 = CAC dialed, customer presubscribed, presubscription
indication arrangement with IC/INC
7 = CAC dialed, customer presubscribed, no presubscritpion
indication arrangement with IC/INC
8 = No CAC dialed; station not presubscribed; no presubscription
indication arrangement with IC/INC
9 = No indication CAC dialed; station presubscribed;
presubscription indication forwarded to IC/INC
29. ANI/CPN Indicator
The ANI Calling Party Number (CPN) Indicator is a one-character field.
This field indicates whether ANI and/or the CPN are provided for the call.
Only ANI is provided in non- SS7 calls. Both ANI and CPN may be
provided in SS7 calls. Valid values for this field are:
0 = Neither ANI nor CPN provided
1 = ANI provided
2 = CPN provided
3 = Both ANI and CPN provided
30. Dialed NPA
The Dialed NPA field is a three-character field. This field is the dialed
NPA.
31. Dialed Number
The Dialed Number is a seven-character field represented as NXXXXXX.
32. Numbering Plan Area
The NPA field is a three-character field. This field represents the
originating NPA and it is only used with a billing study record.
33. Directory Number
The Directory Number is a seven-character field represented as NXXXXXX. This field represents the originating number and it is only used
with a billing study record.

Telica, Inc.

6-27

ASCII Billing Reports

Issue 5, January 9, 2003

34. WATS Indicator


The WATS Indicator is a one-character field. This field indicates
measured time Wide Area Telecommunications Service (WATS) when its
value is 2. Valid values for this field are:
0 = Default
2 = Measured Time
35. WATS Band or Message Billing Index
The WATS band or Message Billing Index (MBI) is a three-character
field. This field is populated with the Wide Area Telecommunications
Service (WATS) band or MBI, which are mutually exclusive. The WATS
band identifies the geographical area to which a WATS customer makes
calls via dedicated access lines. The MBI indicates the specific local
measured service provided for the call to the Revenue Accounting Office
(RAO).
For WATS calls (Call Type Code 007, and 068), Characters 1-3 make up
the WATS band. For message rate calls (Call Type Code 001 through
004), Characters 1-3 make up the MBI, which ranges from 000-999.
It is a carriers responsibility to set the translation-settable MBI codes in
the Plexus.
36. WATS Administration
The WATS Administration field is four characters. The first character is a
constant 0 and the other four characters contain the pseudo-trunk number
for WATS lines that use simulated facilities. Use of the pseudo-trunk
number is intended to enable customers to engineer their WATS better.
The pseudo-trunk number may range from 0000-9999.
37. Completion Indicator
The Completion Indicator is a three-character field. This field contains the
status of a call. The following codes indicate the supported statuses:
001 = Completed: Connected - Indicates the call is successfully
completed (i.e., conversation between calling and called
parties occurs). Each of the other values in this field is
recorded as appropriate for calls that do not complete.
002 = Not completed: Billing failure
003 = Not completed: Setup Restrictions Table
004 = Not completed: Person requested on person-to-person call
not available
005 = Not completed: No circuits. Indicates all circuits are in use
and the call cannot be completed.

6-28

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-300-100

006 = Not completed:Indicates the called party does not go offhook.


007 = Not completed: Busy. Indicates the called line is busy.
007 = Not completed: Busy
008 = Not completed: No answer supervision returned
009 = Advanced Intelligent Network (AIN) pre-final route record
final call disposition completed
010 = AIN pre-final route record - disposition not completed
011 = AIN Service Control Point (SCP)-requested release time
(disconnect message received)
012 = Not completed: Network Failure
013 = Not completed: Caller Aborted
014 = AIN pre-final route - NEL follows - "Limited
Implementation"*
015 = Not completed: Call sent to treatment
018 = Release To Pivot (RTP) Operator Services System (OSS)
Redirected
031 = Answered with Charge (per R2/Telephone User Part (TUP)
signaling) (Vendor Specific)
035 = Answered without Charge (per R2/TUP signaling) (Vendor
Specific)
040 = Service Control Point (SCP) initiated Vertical Service Code
call disposition not provided
060 = Record closed because subsequent non-Specific Digits
String (SDS) record exists and has call elapsed time (if any)
999 = Unknown
38. Service Logic Identification
The Service Logic Identification is a nine-character field. This field is
used in an AIN environment. It records an identification of the service
logic in the SCP that was used.
000000000 - 899999999 = Local Exchange Carrier (LEC)assignable
900000000 = Advanced Intelligent Network (AIN) default routing
invoked
999999999 = Unknown
39. Revenue Accounting Office (RAO) Number
The RAO is a three-character field that is populated with a three-digit
ROA number 000-999. This number identifies the RAO that services the
account identified by the billing number located elsewhere in the record.
Telcordia assigns the RAO numbers.

Telica, Inc.

6-29

ASCII Billing Reports

Issue 5, January 9, 2003

One example for the use of this field is as follows:


- The RAO number is returned from the Line Information
Database (LIDB) or billing validation database for queries that
return an Accepted, Verify or PIN Match response.
40. Local Access Transport Area (LATA)
The LATA is a three-character field. This field indicates the numerical
identifier of a Local Access and Transport Area (LATA).
41. Data Capabilities Indicator
The Data Capabilities Indicator is a three-character field that uses
three-digit code to specify data capabilities. Values are:
000 = Unknown - Indicates the switch cannot determine whether
the call is a data-only Public Switched Digital Service
(PSDS) call or an alternate voice/data PSDS call.
003 = Data only
008 = Alternate voice/data
009 = Unidirectional data transfer
010 = Bidirectional data transfer
42. Information Transfer Rate Indicator
The Information Transfer Rate Indicator is a three-character field. This
field indicates the information transfer rate of a call.
000 = Unknown transfer rate
001 = 1536 kilobits/second (kbps) clear
002 = 1536 kbps restricted
003 = 384 kbps clear
004 = 384 kbps restricted
005 = 64 kbps clear
007 = 64 kbps restricted
008 = 56 kbps
009 = 128 kbps clear
010 = 192 kbps clear
011 = 256 kbps clear
012 = 320 kbps clear
013 = 448 kbps clear
014 = 512 kbps clear
015 = 576 kbps clear
016 = 640 kbps clear
017 = 704 kbps clear
018 = 768 kbps clear
019 = 832 kbps clear
020 = 896 kbps clear
021 = 960 kbps clear
6-30

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-300-100

022 = 1024 kbps clear


023 = 1088 kbps clear
024 = 1152 kbps clear
025 = 1216 kbps clear
026 = 1280 kbps clear
027 = 1344 kbps clear
028 = 1408 kbps clear
029 = 1472 kbps clear
43. Terminating Company
The Terminating Company is a three-character field. This field indicates
whether the terminating company involved in the call is a LEC or an
independent company, and whether the call is interstate or intrastate.
Terminating company values are:
000 = Not used
001 = Company unknown, interstate
002 = Company unknown, intrastate
011 = LEC, interstate
012 = LEC, intrastate
021 = Independent, interstate
022 = Independent, intrastate
44. Usage Count
The Usage Count is a five-digit numeric field. This field indicates the
number of times an event occurs. This field is used for capturing billing
study information.
45. Module 21 IC/INC Prefix
The Inter-exchange Carrier/International Carrier Identification (IC/INC)
Prefix is a five-character numeric field in the format of CCCCO.
-

Characters 1-4 (CCCC) represent the IC/INC Identification


Character 5 (O) represents an Operator Involvement Indicator.
Refer to Field 21 for values and descriptions.

This field in an AMA record identifies the IC/INC that transports the call.
The CIC in this field represents either a domestic IC or an INC. If a
domestic carrier delivers the call to an INC, the INCs code is recorded.
46. Module 021 Carrier Access Date
The Carrier Access Date indicates the date that Plexus received the IAM
from the signaling network. The ten-character field represents the month,
day, and year as follows: MM-DD-YYYY.

Telica, Inc.

6-31

ASCII Billing Reports

Issue 5, January 9, 2003

47. Module 021 Carrier Access Time


The Carrier Connect Time is a ten-character field. It provides the hour,
minute, seconds, and tenth of second to indicate the time of day that the
switch received the IAM. The format of this field is HH:MM:SS.T where
H=hours, M= minutes, S = seconds, and T = tenth of seconds.
48. Module 021 Carrier Elapsed Time
The Carrier Elapsed Time is a nine-character numeric field. The Elapsed
Time provides a count in tenth of seconds from when the switch received
the IAM from signaling network.
49. Module 021 IC/INC Call Event Status
The IC/INC Call Event Status is a maximum of two digits. This field
provides information about events occurring in calls involving ICs or
INCs. The information describes how far a call progressed before
terminating and identifies the conditions associated with the calls
termination. Refer to Field 25 for description of values and their meaning.
50. Module 021 Trunk Group Number
The Trunk Group Number is a five-character numeric field in the format
of STTTT. This field provides the outgoing Trunk Group Number
(TGN) for originating calls and the incoming TGN for terminating calls.
Refer to Field 26 for description of values and their meaning.
51. Module 021 Routing Indicator
The IC/INC Routing Indicator is a one-character numeric field. This field
indicates whether direct or tandem routing was used to deliver traffic to an
IC/INC from the end office or from an IC/INC to an end office. Refer to
Field 27 for description of values and their meaning.
52. Module 021 Dialing and Presubscription Indicator
The Dialing and Presubscription Indicator is a one-character field. Refer
to Field 28 for description of values and their meaning.

6-32

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-300-100

53. Module 021 ANI/CPN Indicator


The ANI/CPN Indicator is a one-character field. This field indicates
whether ANI and/or the CPN are provided for the call. Only ANI is
provided in non-SS7 calls. Both ANI and CPN may be provided in SS7
calls. Valid values for this field are:
0 = Neither ANI nor CPN provided
1 = ANI provided
2 = CPN provided
3 = Both ANI and CPN provided
54. Module 022 Present Date
The Present Date indicates the date the record was formed for a long
duration call. The ten-character field represents the month, day, and year
as follows: MM-DD-YYYY.
55. Module 022 Present Time
The Present Time is a ten-character field. It provides the hour, minute,
seconds, and tenth of second to indicate the time the record was formed
for a long duration call. The format of this field is HH:MM:SS.T where
H=hours, M= minutes, S = seconds, and T = tenth of seconds.
56. Module 025 Circuit Date
The Circuit Date indicates the date that Plexus received answer
supervision indicating a completed call. The ten-character field represents
the month, day, and year as follows: MM-DD-YYYY.
57. Module 025 Circuit Time
The Circuit Time is a ten-character field. It provides the hour, minute,
seconds, and tenth of second to indicate the time of day of the called party
going off-hook. The format of this field is HH:MM:SS.T where H=hours,
M= minutes, S = seconds, and T = tenth of seconds.
58. Module 027 Business Customer ID
The Business Customer ID is a ten-character field that contains the
customer identification number. This number uniquely identifies records
for a single customer or for customers who are members of a customer
group. The information in this field is populated by the data returned from
a SCP query.

Telica, Inc.

6-33

ASCII Billing Reports

Issue 5, January 9, 2003

59. Module 027 Context ID (Orig/Term)


The Context ID is a one-character numeric field that provides the context
of the Business Customer ID above. Valid values for the Context ID are:
0 = Default
1 = Originating customers ID
2 = Terminating customers ID
3 = Originating and terminating customers ID
60. Module 029 Alternate Billing Number
The Alternate Billing Number (ABN) is an eleven-digit numeric field.
The first character is the Network Element Indicator and the values are:
0 = Zero constant
1 = Service Control Point (SCP)-based Alternate Billing Number
2 = Switch-based Alternate Billing Number
The other digits provide the ABN when the ABN option is used. For
originating calls, this option is provisioned on a per subscriber basis. For
terminating calls, the ABN is provided in the IAM of the SS7 protocol.
Currently Module 029 is not supported.
61. Module 040 Digits Identifier
The Digits Identifier field is a three-digit numeric field. This field
identifies the type of information represented by the digits recorded in the
Digits 1 field for an Advanced Intelligent Network (AIN) call. The Digits
1 field that follows can record up to 24 numbers
Valid values for the Digits Identifier field are:
001 = Authorization code
002 = Account code
003 = Access code
004 = Digits dialed
005 = Outpulse number
006 = International calling party identification
011 = Non-international calling party ID greater than 12 digits
012 = Incoming terminating number greater than 12 digits
300-998 = LEC-assigned
999 = Unknown

6-34

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-300-100

62. Module 040 Digits


The Digits field contains 24-numeric characters. This field includes the
Digits 1 and Digits 2 field defined in the AMA definition of module 40.
The field captures the dialed digits. If there are unused digits in either
field, the most significant digits are right justified and the unused digits
are filled with 0s.
63. Module 040 Significant Digits
The Significant Digits field identifies the number of significant digits
associated with the Digits 1 field.
64. Module 104 Incoming Routing Indicator
The Incoming Routing Indicator is a one-character numeric field. The
field describes how the traffic is generally routed over the identified trunk
group in Local Service Provider Identification (LSPI)-recording scenarios.
Valid values for this field are:
1 = Direct Incoming different network [Local Service Provider
Identification Switch Owner (LSPI-SO)] interconnecting at
far-end.
2 = Direct Outgoing different network (LSPI-SO)
interconnecting at far-end.
3 = Direct Incoming same network (LSPI-SO) interconnecting at
far-end.
4 = Direct Outgoing same network (LSPI-SO) interconnecting at
far-end.
5 = Tandem Incoming different network (LSPI-SO)
interconnecting at far-end.
6 = Tandem Outgoing different network (LSPI-SO)
interconnecting at far-end.
7 = Tandem Incoming same network (LSPI-SO) interconnecting
at far-end.
8 = Tandem Outgoing same network (LSPI-SO) interconnecting
at far-end.
65. Module 104 Incoming Trunk Group Number
Incoming Trunk Group Number (TGN) is a four-character numeric field.
This field provides the incoming TGN for terminating calls.
66. Module 104 Incoming Trunk Group Member Number
Incoming Trunk Member Number is a four-character numeric field that
indicates the particular trunk within the group.

Telica, Inc.

6-35

ASCII Billing Reports

Issue 5, January 9, 2003

67. Module 104 Outgoing Routing Indicator


The Outgoing Routing Indicator is a one-character numeric field. The
field describes how the traffic is generally routed over the identified trunk
group in Local Service Provider Identification (LSPI)-recording scenarios.
Valid values for this field are:
1 = Direct Incoming different network [Local Service Provider
Identification Switch Owner (LSPI-SO)] interconnecting at
far-end.
2 = Direct Outgoing different network (LSPI-SO)
interconnecting at far-end.
3 = Direct Incoming same network (LSPI-SO) interconnecting at
far-end.
4 = Direct Outgoing same network (LSPI-SO) interconnecting at
far-end.
5 = Tandem Incoming different network (LSPI-SO)
interconnecting at far-end.
6 = Tandem Outgoing different network (LSPI-SO)
interconnecting at far-end.
7 = Tandem Incoming same network (LSPI-SO) interconnecting
at far-end.
8 = Tandem Outgoing same network (LSPI-SO) interconnecting
at far-end.
68. Module 104 Outgoing Trunk Group Number
Outgoing TGN is a four-character numeric field. This field provides the
outgoing TGN for terminating calls.
69. Module 104 Outgoing Trunk Group Member Number
Outgoing TGMN is a four-character numeric field that indicates the
particular trunk within the group.
70. Module 164 ChN Number Identity
Charge Number (ChN) Number Identity is a one-character numeric field.
This field identifies whether the number (or address) is an originating
number or terminating number. If originating ANI and Calling Party
Number (CPN) are the same number, value 1 should be used. If the
originating CPN or ANI number is private, then the appropriate value
should be used. The possible values for this field are:
1 = Originating Automatic Number Identification (ANI) (source)
4 = Private Originating ANI

6-36

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-300-100

71. Module 164 ChN Number Plan Indicator


Charge Number (ChN) Number Plan indicator is a one-character numeric
field that supports the following values:
0 = E.164 number for which country code length cannot be
determined
1 = E.164 number with 1-digit country code
2 = E.164 number with 2-digit country code
3 = E.164 number with 3-digit country code
4 = X.121 number which indicates a 4-digit Data Network
Identification Code
Refer to section 6.5, Module Number 164 for a more detailed description
of this module.
72. Module 164 ChN Country Code or Data Network Identification
Code
The Charge Number (ChN) Country Code or Data Network Identification
Code (DNIC) field is a four-digit field that identifies the Country Code or
the DNIC.
Refer to section 6.5, Module Number 164, for a more detailed description
of this module.
73. Module 164 ChN Significant Digits
The Charge Number (ChN) Significant Digits field is a maximum of
three-digits and indicates the number of significant digits in the next field Number.
Refer to section 6.5, Module Number 164 for a more detailed description
of this module.
74. Module 164 Charge Number (ChN)
The Charge Number field is a maximum of fifteen digits and, as noted
above, is preceded by the number of significant digits contained in this
field. In Module 164, this field contains the originating or terminating
number that is too long to be recorded in the structure associated with the
call. For an E.164 number, this field contains the National (Significant)
Number [N(S)N] (a maximum of 14 digits). For an X.121 number, this
field contains the Network Terminal Number (NTN) (a maximum of 10
digits).
Refer to section 6.5, Module Number 164 for a more detailed description
of this module.

Telica, Inc.

6-37

ASCII Billing Reports

Issue 5, January 9, 2003

75. Module 611 Significant Digits


The Significant Digits field contains two characters and is always 15, that
indicates there are fifteen significant digits in Digits String(s).
76. Module 611 Final Switch, Trunk Group Number, Trunk Member
Number
The Final Switch, Trunk Group Number, Trunk Member Number field is a
15-digit field in the format of SSSTTTTTTMMMMMM where:
SSS = Switch Identification
TTTTTT = Trunk Group
MMMMMM = Trunk Member
77. Module 720 Orig Location Type
The Origination (Orig) Location Type field contains up to 3 digits. Its
value determines the interpretation of ASCII field 81. Values are:
006 = 6-Digit Geographic Unit Building Block (GUBB)
100 = Signaling Point Code
78. Module 720 Orig Party Identifier
The Origination (Orig) Party Identifier field is a three-digit numeric field.
This field identifies the directory number reference of the party within this
module. This field is always 001 to indicate originating party number.
79. Module 720 Orig Location Routing Number (LRN)
The Origination (Orig) Location Routing Number (LRN) is a 10 character
numeric field. This field identifies the switching entity (LRN) that
provides service to the party identified in the Party Identifier field. The
source of the LRN is identified in the LRN Source Indicator of the
Supporting Information field.
Some LRN sources may provide the LRN in terms of an NPA-NXX sextet
followed by a four-digit pseudo-line number. Other sources may provide
the LRN in terms of an NPA-NXX sextet only. In this case, the 4 right
most (least significant) digits (the line number digits) of the LRN in this
table are 0-filled. The LRN Source Indicator of the Supporting
Information field may be used to distinguish between these cases.

6-38

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-300-100

If an LRN is not available due to an error encountered in querying an LNP


database, each of the 10 character positions will be populated with 9s
and the appropriate Query Status Indicator shall be set in the Supporting
Information field. If this field is not used or is not applicable, each of the
10 character positions shall be populated with 0s.
80. Module 720 Orig Service Provider Identity
The Origination (Orig) Service Provider Identity is an eight-character
numeric field. If used this field identifies the entity that provides service
to the party identified in the Party Identifier field. If this field is not used
or is not applicable, each of the eight characters will be populated with
0s.
81. Module 720 Orig Location
The Origination (Orig) Location component is 12 digits. This field is
populated by data returned from a Service Control Point (SCP) query. Its
interpretation depends on the value in Location Type (field 77)
The Location Type has two possible values:
006 = 6-digit Geographic Unit Building Block (GUBB)
100 = Signaling Point Code (SPC)
When the Location type component represents an SPC, the 12 digits of the
Location field are parsed as follows:
Characters 1-3 = 0
Characters 4-6 = Network ID
Characters 7-9 = Network cluster
Characters 10-12= Cluster member
When the Location type field represents the six-digit GUBB for Local
Number Portability, the 12 digits of the Location field are parsed as
follows:
Characters 1-6 = The GUBB, which is in the format of an NPANXX
Characters 7-12 = 0
82. Module 720 Orig Supporting Information
The Origination (Orig) Supporting Information field is a seven-character
numeric field in the format of SQQ0000. This field is used in Module
720 to provide information in support of interpreting and parsing the
Location Routing Number field and the Location field.

Telica, Inc.

6-39

ASCII Billing Reports

Issue 5, January 9, 2003

Character 1 (S) of this field represents the Location Routing Number


Source Indicator. Valid values are:
1 = LNP database
2 = Switching system data
3 = Incoming signaling
The next two characters (QQ) represent the Query Status Indicator. Valid
values are:
01 = Successful Query
09 = No query done
99 = Query unsuccessful, reason unknown
83. Module 049 - Count of Name Only
Count of Name Only is a maximum five-character field that counts the
number of times a calling name appears in the information delivered to the
customer. For each count, an "anonymous" or "unavailable" indication is
sent in place of the calling number. This field is appended to Structure
0110 when CLASS Feature Code field is "087". The value 087 indicates
that a customer has both Calling Number Delivery (CND) and Calling
Name Delivery (CNAM).
84. Module 049 - Count of Number Only
The Count of Number-Only field is a maximum five-character field and
only counts the number of times a calling number appears in the
information delivered to the customer. For each count, an "anonymous"
or "unavailable" indication is sent in place of the calling name.
85. Module 102 Authorization Code
The Authorization Code is a maximum fifteen-digit field and is used to
provide Message Recording Detail (MDR). If an authorization code is
received on a call using the Authorization Codes for the Automatic
Flexible Routing (AFR) feature, this field is equal to the Authorization
Code digits. This field can be up to 15 digits. If the dialed Authorization
Code exceeds 15 digits, only the first 15 digits dialed are used; if the code
contains less than 15 digits, it is truncated.

6-40

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-300-100

86. Module 103 Account Code


This module contains an account code or Customer-Dialed Account
Recording (CDAR) information, maximum of 15 characters. If both the
account and CDAR features are used on the same call, the account code
information populates the module, not the CDAR information. Account
code information is similar to CDAR information except for the point in
the customers dialing pattern when the account code/CDAR information
is provided.
87. Module 105 MDR Customer ID Context
The Message Detail Recording (MDR) customer ID Context field is one
character and identifies the customer as originating, terminating or both.
Values are:
0 = Default
1 = Originating customers ID
2 = Terminating customers ID
3 = Originating and terminating customers ID
88. Module 105 MDR Customer ID
The Message Detail Recording (MDR) Customer ID field is a maximum
ten digits and contains the MDR customer identification number of the
MDR customer for whom the MDR data is intended.
89. Module 105 Originating FAC Type
The Originating FAC (Facilities) Type field is maximum two digits and
identifies the type of originating (incoming) facilities used on the call.
This field may not be supported and will be 0 indicating that the facility
type is not known.
0 = Not known
1 = On-network colocated line
2 = On-network colocated attendant
3 = On-network trunk (physical private facility)
4 = On-network trunk (virtual private facility)
5 = Off-network colocated line
6 = Off-network trunk (public network facility)
7 = On-network foreign exchange
8 = Other on-network facility
9 = Other off-network facility

Telica, Inc.

6-41

ASCII Billing Reports

Issue 5, January 9, 2003

90. Module 105 Terminating FAC Type


The Terminating FAC (Facilities) Type field is maximum two digits and
identifies the terminating (outgoing) facilities used on the call. This field
may not be supported and will be 0 indicating that the facility type is not
known.
0 = Not known
1 = On-network co-located line
2 = On-network co-located attendant
3 = On-network trunk (physical private facility)
4 = On-network trunk (virtual private facility)
5 = Off-network co-located line
6 = Off-network trunk (public network facility)
7 = On-network foreign exchange
8 = Other on-network facility
9 = Other off-network facility
91. CLASS Feature Codes
CLASS Feature Codes is a maximum three-digit field that indicates the
CLASS feature that is involved in the call or aggregate recording interval.
The following values are used:
032 = Automatic Recall (AR) reactivation: Delayed processing
resulting in attempted call setup
033 = Automatic Callback (AC) reactivation: Delayed processing
resulting in attempted call setup
038 = AR reactivation: Delayed processing ended by customer
deactivation or extended by reactivation
039 = AC reactivation: Delayed processing ended by customer
deactivation or extended by reactivation
057 = Anonymous Call Rejection: Activation
058 = Anonymous Call Rejection: Deactivation
060 = AR activation: Immediate processing resulting in attempted
call setup or busy tone
061 = AC activation: Immediate processing resulting in attempted
call setup or busy tone
062 = AR activation: Delayed processing resulting in attempted
call setup
063 = AC activation: Delayed processing resulting in attempted
call setup
068 = AR activation: Delayed processing ended by customer
deactivation or extended by reactivation
069 = AC activation: Delayed processing ended by customer
deactivation or extended by reactivation
070 = Customer-Originated Trace (COT) activation
075 = Calling Number Delivery Blocking (CNDB) activation

6-42

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-300-100

085 = Calling Identity Delivery and Suppression (CIDS)


086 = Calling Name Delivery Blocking (CNDB)
095 = AR two-level activation: First-level completion
92. CLASS Functions
CLASS Functions is a maximum three-digit field that indicates the status
of the CLASS Screening List (SL) features (i.e., Selective Call
Forwarding (SCF), Selective Call Rejection (SCR), Distinctive Ringing/
Call Waiting (DRCW), and the analogous features when provided in an
Integrated Services Digital Network (ISDN) context) and any change to
the SL at the end of a screening list editing session. Values are as follows:
0 = None of the following values apply
1 = Active
2 = Inactive
3 = Delete
4 = Create active
5 = Create inactive
6 = Session aborted
93. CLASS Feature Status
CLASS Feature Status is a maximum three-digit field that indicates the
status of SCF, SCR and DRCW. Values are as follows:
0 = None of the following values apply
1 = Selective Call Forwarding (SCF) active
2 = Selective Call Rejection (SCR) active
3 = SCF and SCR active
4 = Distinctive Ringing/Call Waiting (DRCW) active
5 = SCF and DRCW active
6 = SCR and DRCW active
7 = SCF, SCR, and DRCW active
10 = SASCF active (Vendor Specific)
12 = SASCF & SCR active (Vendor Specific)
14 = SASCF & SDA active (Vendor Specific)
16 = SASCF, SCR & SDA active (Vendor Specific)
20 = SCF list exists (Vendor Specific)
22 = SCF and SCR lists exist (Vendor Specific)
24 = SCF and DRCW lists exist (Vendor Specific)
26 = SCF, SCR, and DRCW lists exist (Vendor Specific)
94. Deactivation Date
The Deactivation Date indicates the date that Plexus a deactivated CLASS
feature. The ten-character field represents the month, day, and year as
follows: MM-DD-YYYY.

Telica, Inc.

6-43

ASCII Billing Reports

Issue 5, January 9, 2003

95. Deactivation Time


The Deactivation Time is a ten-character field. It provides the hour,
minute, seconds, and tenth of second to indicate the time of day of the
deactivation of a CLASS feature. The format of this field is
HH:MM:SS.T where H=hours, M= minutes, S = seconds, and T = tenth of
seconds.
96. Call Count Info Delivered
The Call Count is a maximum five-digit numeric field. The Call Count Information Delivered field counts the number of times that both a calling
name and calling number appear in the information delivered to the
customer.
97. Call Count Info Anonymous/Unavailable
The Call Count - Information Anonymous/Unavailable field is a
maximum five-digit field that counts the number of times that both a
calling name and calling number do not appear in the information
delivered to the customer. For each count, "anonymous" or "unavailable"
indications are sent in place of the calling name and calling number.
98. Screening List Size SCF SCA
The Screening List Size - Selective Call Forwarding (SCF) Selective Call
Acceptance (SCA) field is a three-digit field that indicates the size of the
list for SCF SCA.
99. Screening List Size SCR
The Screening List Size - Selective Call Rejection (SCR) field is a
three-digit field that indicates the size of the list for SCR.
100. Screening List Size DR CW
The Screening List Size - Distinctive Ringing Call Waiting (DR CW) field
is a three-digit field that indicates the size of the list for DR CW.
101. Module 40_2 - Digits Identifier
This field is a three-digit field and identifies the type of information
represented by the digits recorded in the Digits Dialed fields for an
Advanced Intelligent Network (AIN) call. Refer to Field 61 for a
complete description.

6-44

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-300-100

102. Module 40_2 Digits


This field is a 24-digit field and contains numeric strings of dialed digits.
Refer to Field 62 for a complete description.
103. Module 40_2 - Significant Digits
This field is a maximum three-digit field and indicates the number of
significant digits in the next field(s). Refer to Field 63 for a complete
description.
104. Module 40_3 - Digits Identifier
This field is a three-digit field and identifies the type of information
represented by the digits recorded in the Digits Dialed fields for an
Advanced Intelligent Network (AIN) call. Refer to Field 61 for a
complete description.
105. Module 40_3 Digits
This field is a 24-digit field and contains numeric strings of dialed digits.
Refer to Field 62 for a complete description.
106. Module 40_3 - Significant Digits
This field is a maximum three-digit field and indicates the number of
significant digits in the next field(s). Refer to Field 63 for a complete
description.
107. Module 40_4 - Digits Identifier
This field is a three-digit field and identifies the type of information
represented by the digits recorded in the Digits Dialed fields for an
Advanced Intelligent Network (AIN) call. Refer to Field 61 for a
complete description.
108. Module 40_4 Digits
This field is a 24-digit field and contains numeric strings of dialed digits.
Refer to Field 62 for a complete description.
109. Module 40_4 - Significant Digits
This field is a maximum three-digit field and indicates the number of
significant digits in the next field(s). Refer to Field 63 for a complete
description.

Telica, Inc.

6-45

ASCII Billing Reports

Issue 5, January 9, 2003

110. Module 40_5 - Digits Identifier


This field is a three-digit field and identifies the type of information
represented by the digits recorded in the Digits Dialed fields for an
Advanced Intelligent Network (AIN) call. Refer to Field 61 for a
complete description.
111. Module 40_5 Digits
This field is a 24-digit field and contains numeric strings of dialed digits.
Refer to Field 62 for a complete description.
112. Module 40_5 - Significant Digits
This field is a maximum three-digit field and indicates the number of
significant digits in the next field(s). Refer to Field 63 for a complete
description.
113. Module 164 Term Number Identity
The Terminating (Term) Number Identity field is a one-character numeric
field that identifies that the number (or address) is a terminating number.
It is always a 2.
114. Module 164 Term Number Plan Indicator
The Terminating (Term) Number Plan indicator is a one-character
numeric field. Refer to Field 71 for a complete description.
115. Module 164 Term Country Code or Data Network Identification
Code
The Terminating (Term) Country Code or Data Network Identification
Code (DNIC) field is a four-digit field that identifies the Country Code or
the DNIC. Refer to Field 72 for a complete description.
116. Module 164 Term Significant Digits
The Terminating (Term) Significant Digits field is a maximum of threedigits and indicates the number of significant digits in the next field Number. Refer to Field 73 for a complete description.
117. Module 164 Term Number
The Terminating (Term) Number field is a maximum of fifteen digits.
Refer to Field 74 for a complete description.

6-46

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-300-100

118. Module 164 CPN Number Identity


The Calling Party Number (CPN) Number Identity is a one-character
numeric field that identifies whether the number (or address) is an
originating number or terminating number. The possible values for this
field are:
3 = Originating Calling Party Number (CPN)
5= Private Originating CPN
119. Module 164 CPN Number Plan Indicator
The Calling Party Number (CPN) Number Plan indicator is a onecharacter numeric field. Refer to Field 71 for a complete description.
120. Module 164 CPN Country Code or Data Network Identification
Code
The Calling Party Number (CPN) Country Code or Data Network
Identification Code (DNIC) field is a four-digit field that identifies the
Country Code or the DNIC. Refer to Field 72 for a complete description.
121. Module 164 CPN Significant Digits
The Calling Party Number (CPN) Significant Digits field is a maximum of
three-digits and indicates the number of significant digits in the next field Number. Refer to Field 73 for a complete description.
122. Module 164 Calling Party Number (CPN)
The Calling Party Number (CPN) field is a maximum of fifteen digits.
Refer to Field 74 for a complete description.
123. Module 164 RN Number Identity
The Redirecting Number (RN) Number Identity is a one-character
numeric field that identifies whether the number (or address) is an
originating number or terminating number. The only value for this field
is:
6 = Redirecting Number (RN)
124. Module 164 RNNumber Plan Indicator
The Redirecting Number (RN) Number Plan indicator is a one-character
numeric field. Refer to Field 71 for a complete description.

Telica, Inc.

6-47

ASCII Billing Reports

Issue 5, January 9, 2003

125. Module 164 RN Country Code or Data Network Identification Code


The Redirecting Number (RN) Country Code or Data Network
Identification Code (DNIC) field is a four-digit field that identifies the
Country Code or the DNIC. Refer to Field 72 for a complete description.
126. Module 164 RN Significant Digits
The Redirecting Number (RN) Significant Digits field is a maximum of
three-digits and indicates the number of significant digits in the next field Number. Refer to Field 73 for a complete description.
127. Module 164 Redirecting Number (RN)
The Redirecting Number (RN) field is a maximum of fifteen digits. Refer
to Field 74 for a complete description.
128. Module 164 OCN Number Identity
The Original Called Number (OCN) Number Identity is a one-character
numeric field that identifies whether the number (or address) is an
originating number or terminating number. The value for this field is:
7 = Original Called Number (OCN)
129. Module 164 OCN Number Plan Indicator
The Original Called Number (OCN) Number Plan indicator is a onecharacter numeric field. Refer to Field 71 for a complete description.
130. Module 164 OCN Country Code or Data Network Identification
Code
The Original Called Number (OCN) Country Code or Data Network
Identification Code (DNIC) field is a four-digit field that identifies the
Country Code or the DNIC. Refer to Field 72 for a complete description.
131. Module 164 OCN Significant Digits
The Original Called Number (OCN) Significant Digits field is a maximum
of three-digits and indicates the number of significant digits in the next
field - Number. Refer to Field 73 for a complete description.
132. Module 164 Original Called Number
The Original Called Number (OCN) field is a maximum of fifteen digits.
Refer to Field 74 for a complete description.

6-48

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-300-100

133. Module 164 Billing Number Identity


The Billing Number Identity is a one-character numeric field that
identifies whether the number (or address) is an originating number or
terminating number. The value for this field s:
8 = Provisioned Billing Number
134. Module 164 Billing Number Plan Indicator
The Billing Number indicator is a one-character numeric field. Refer to
Field 71 for a complete description.
135. Module 164 Billing Country Code or Data Network Identification
Code
The Billing Number Country Code or Data Network Identification Code
(DNIC) field is a four-digit field that identifies the Country Code or the
DNIC. Refer to Field 72 for a complete description.
136. Module 164 Billing Significant Digits
The Billing Number Significant Digits field is a maximum of three-digits
and indicates the number of significant digits in the next field - Number.
Refer to Field 73 for a complete description.
137. Module 164 Billing Number
The Billing Number field is a maximum of fifteen digits. Refer to Field
74 for a complete description.
138. Module 306 - OLIP
The Originating Line Information Parameter (OLIP) field is three
characters and records the originating line information parameter (or
Automatic Number Identification [ANI]) that identifies the class of service
of the originating line. It can also be used to record a unique class of
service that can identify various services offered by Local Exchange
Carriers (LECs). The possible values for this field are as follows:

Telica, Inc.

6-49

ASCII Billing Reports

Issue 5, January 9, 2003

Binary
00000000
00000001
00000010
00000110
00000111
00010100

BCD
00
01
02
06
07
20

00010111

23

00011000
00011001
00011011
00011101
00011110
00011111
00100000
00100010
00100100
00101000

24
25
27
29
30
31
32
34
36
40

00110100

52

00111100
00111101
00111110
00111111
01000010
01000011
01000110
01011101

60
61
62
63
66
67
70
93

Description
Plain Old Telephone Service (POTS)
Multiparty line (more than 2)
ANI failure
Station Level Rating
Special operator handling required
Automatic Identified Outward Dialing
(AIOD)
coin or non-coin on calls using database
access
800 service call
800 service call from a pay station
coin
prison/inmate service
intercept (blank)
intercept (trouble)
intercept (regular)
telco operator handled call
CPE
to 00110001 (49) unrestricted use - locally
determined by carrier
OUTward Wide Area Telecommunications
Service (OUTWATS)
TRS
cellular/wireless PCS (type 1)
cellular/wireless PCS (type 2)
cellular/wireless PCS (roaming)
TRS
TRS
private paystations
access for private virtual network types of
service

139. Module 612 - Significant Digits


This field is a maximum two-digit field that indicates the number of
significant digits in the Digits field(s). It is always 30.
140. Module 612 Orig Physical
This field is a fifteen-digit string identifying the originating physical
resource used by the call. The string is formatted as follows as
TTCCSS0OO33110 where TT is the front IOM board type as identified in
the following table.

6-50

Telica, Inc.

Billing and Traffic Collection Guide


00
01
02
03
04
05
06
07
08
09
10
11
12
13
14
15
16
17
18
19

Section 150-300-100

UNKNOWN
DS1 (89-0360)
DS3 (89-0365)
Octal DS3 (89-0382)
Octal DS3 (89-0398)
ATM DS3 (89-0409)
Octal DS3
ENA (89-0390)
Voice Server (VOP8) (89-0388)
Voice Server (VOP6) (89-0395)
OC12
VOIP
STS DS3
STS or DS3
PNA (89-0393)

Triple DS3 (410)


Octal DS3 (411)

CC - The switch (chassis) number. Currently is always 01.


SS - The slot number (00 to 17).
0 - Unused. Will be 0.
OO - The OC3. Non-zero on OC3 boards.
33 - The DS3. Non-zero on OC3 and DS3 boards.
11 - The DS1.
00 - The DS0.
Note that only TDM board types are supported. For non-TDM boards
only TTCCSS are populated. The remaining fields are zero.
141. Module 612 Term Physical
Terminating physical resource, formatted the same as in the previous
description.
142. Module 720 Term Location Type
Refer to Field 77 for a complete description of location type.
143. Module 720 Term Party Identifier
The Terminating Party Identifier field is a three-digit numeric field. This
field identifies the directory number reference of the party within this
module. This field is always 002 to indicate terminating party number.

Telica, Inc.

6-51

ASCII Billing Reports

Issue 5, January 9, 2003

144. Module 720 Term Location Routing Number (LRN)


The Terminating Location Routing Number (LRN) is a 10 character
numeric field. This field identifies the switching entity (LRN) that
provides service to the party identified in the Party Identifier field. The
source of the LRN is identified in the LRN Source Indicator of the
Supporting Information field. Refer to Field 79 for a complete
description.
145. Module 720 Term Service Provider Identity
The Terminating Service Provider Identity is an eight-character numeric
field. Refer to Field 80 for a complete description.
146. Module 720 Term Location
The Terminating Location component is 12 digits. This field is populated
by data returned from a Service Control Point (SCP) query. Its
interpretation depends on the value in Location Type (field 77). Refer to
Field 81 for a complete description.
147. Module 720 Term Supporting Information
The Terminating Supporting Information field is a seven-character
numeric field in the format of SQQ0000. This field is used in Module
720 to provide information in support of interpreting and parsing the
Location Routing Number field and the Location field. Refer to Field 82
for a complete description.
148. Unused
149. Module 611 - Significant Digits
This field is a maximum of two digits field that indicates the number of
significant digits in the Digits field. It is always 10.
150. Module 611 Call ID
This field is a 15-digit string that contains a call identifier. The call
identifier is generated by the switch so call IDs are unique only among
calls from a particular switch. The first five digits are always 00000.
151. Module 198 Module Descriptor
This field identifies the type of data in the data field. The value is always:
00010 = Originating SIP Call Id

6-52

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-300-100

152. Module 198 Orig SIP Call Id


This field is a digit string of up to 32 digits that contains the SIP call
identifier associated with a call originating from or terminating to a SIP
interface.
153. Module 198 Module Descriptor
This field identifies the type of data in the data field. The value is always:
00011 = Terminating SIP Call Id
154. Module 198 - Term SIP Call Id
This field is a digit string of up to 32 digits that contains the SIP call
identifier associated with a call originating from or terminating to a SIP
interface.
155. Module 68 Called DN Description
This field indicates the called Directory Number (DN) needs some special
handling in billing situations. Values are as follows:
001 = Called directory number marked anonymous
006 = Called directory number not marked anonymous
156. Module 101 - Significant Digits
This field is a three-digit field that indicates the number of significant
digits in the Digits Dialed field.

157. Module 101 - Digits Dialed


This field contains a numeric string of digits dialed.
158. Module 101 Access Code
This field contains a 5-digit number from 0-99999 that identifies the
access code.
159. Module 611 - Significant Digits
This field is a two-digit field that indicates the number of significant digits
in the Call Sequence Number field. It is always 10.
160. Module 611 Call Sequence Number
This field is five digits and identifies the call sequence number.

Telica, Inc.

6-53

ASCII Billing Reports

Issue 5, January 9, 2003

161. Module 616 Significant Digits


This field is a one-digit field that indicates the number of significant digits
in the Record Sequence field. It is always 2.
162. Module 616 Record Sequence Number
This field is five-digit field that identifies the record sequence number. It
is in the format of 0000#.
163. Module 616 Significant Digits
This field is a one-digit field that indicates the number of significant digits
in the Dialed Prefix Digits field. It is always 1.
164. Module 616 - Dialed Prefix Digits
This field is five-digit field that identifies the prefix digits of the dialed
number. It is always prefaced with 0000. Values of the significant digit
(fifth digit) are:
0 = None
1 = 0 Prefix
2 = 01 Prefix
3 = 011 Prefix
4 = 1 Prefix
5 = 00 Prefix
6 = 101 Prefix.
165. Module 616 Significant Digits
This field is a one-digit field that indicates the number of significant digits
in the Called Prefix Digits field. It will always be 1.
166. Module 616 - Called Prefix Digits
This field is five-digit field that identifies the prefix digits of the called
number. It is always prefaced with 0000. Values of the significant digit
(fifth digit) are:
0 = None
1 = 0 Prefix
2 = 01 Prefix
3 = 011 Prefix
4 = 1 Prefix
5 = 00 Prefix
6 = 101 Prefix.

6-54

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-300-100

167. Module 40 Digits Identifier


The Digits Identifier field is a three-digit numeric field. This field
identifies the type of information represented by the digits recorded in the
Field 168. The value for the Digits Identifier field is always 005
indicating the next field is the Outpulse number.
168. Module 40 Outpulse Digits
The Outpulse Digits field contains 24-numeric characters. This field
includes the Digits 1 and Digits 2 field defined in the AMA definition of
module 40. The field captures the outpulse digits. If there are unused
digits in either field, the most significant digits are right justified and the
unused digits are filled with 0s.
169. Module 40 Significant Digits
The Significant Digits field identifies the number of significant digits
associated with Field 168.
170. Module 616 Significant Digits
The Significant Digits field identifies the number of significant digits in
the next field. The value is always 5.
171. Module 616 Release Originator, Category, Cause Indicator
The Release Originator, Category, Cause Indicator field is five-digits in
the format of OCRRR. The first digit (O) indicates who releases the
call. Values are:
1 = Release initiated by the incoming interface.
2 = Release initiated by the outgoing interface.
3 = Release initiated internally (by the stack)
The C indicates the Cause Category and the values can be:
0 = International Telecommunications Union (ITU) standard
2 = National
3 = Network specific
RRR indicates the release cause indication. Refer to Appendix A for a
complete list.

Telica, Inc.

6-55

ASCII Billing Reports

Issue 5, January 9, 2003

172. Module 198 Module Descriptor


The Module Descriptor field is a five-digit field describing the next field.
The value that appears in this field 172 is configurable by the customer. It
is set in the BTS configuration (.ini) file. Since module 198 can be used
for different purposes, the Module Descriptor (Table 575) identifies what
the Module is being used for. In the case of fields 172 and 173, Module
198 is being used for Release Treatment.
173. Module 198 Release Treatment
The Release Treatment field has a maximum of ten characters and
indicates the last release treatment for the call.
174. Module 611 - Significant Digits
The Significant Digits field identifies the number of significant digits in
the next field. The value is always 9.
175. Module 611 Orig Echo Indicator, NLP Indicator, DSP
The Originating Echo Indicator, NLP Indicator, DSP field is in the format
of 000000ENDDDDDDD. The number of digits is actually 15 with six
leading zeros. The first significant digit is indicated with E for the
Originating Echo Indicator. Values are:
0 = No echo cancellation was required on the call or was not
applicable (for packet side connection).
1 = Echo cancellation was used on the call.
2 = Echo cancellation was requested for the call, but no resources
were available.
3 = Echo cancellation was requested, applied, and later dropped for
a fax/modem type call.
The second significant digit is indicated with N for the NLP (NonLinear Processing). Values are
0 = No NLP was required on the call.
1 = NLP was used on the call.
2 = NLP was requested for the call, but no resources were
available.
3= NLP was requested, applied, and later dropped for a fax/modem
type call.
The DDDDDDD is represented as follows:
First D = Failover occurred and values are 0 or 1.
Second and third D = IOM used and values are 1 through 17.
Fourth and fifth D = Processor and values are 1 through 8.
Sixth and seventh D = DSP and values are 1 through 6
6-56

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-300-100

176. Module 611 - Significant Digits


The Significant Digits field identifies the number of significant digits in
the next field. The value is always 9.
177. Module 611 Term Echo Indicator NLP Indicator, DSP
The Terminating Echo Indicator, NLP Indicator and DSP field is in the
format of 000000ENDDDDDDD. The number of digits is actually 15
with six leading zeros. The first significant digit is indicated with E for
the Originating Echo Indicator and the second significant digit is indicated
with N for the NLP (Non-Linear Processing). Refer to Field 175 for
details.
178. Module 613 - Significant Digits
The Significant Digits field identifies the number of significant digits in
the next three fields. The value is always 45.
179. Module 613 Orig Local IP Address
The Originating Local IP Address field is a 15-digit field with three
leading zeros. The remaining twelve digits indicate the local IP address.
180. Module 613 Orig Remote IP Address
The Originating Remote IP Address field is a 15-digit field with three
leading zeros. The remaining twelve digits indicate the remote IP address.
181. Module 613 Orig Local/Remote Port, Codec, Fax Indicator
The Originating Local/Remote Port, Codec, and Fax Indicator field is a
15-digit field in the format of 00LLLLLRRRRRCCF. LLLLL are the
digits for the local IP port, RRRRR are the digits for the remote IP port,
CC are the digits for the Codec. Values for the Codec can be:
0 = G723
1 = G726-16
2 = G726-24
3 = G726-32
4 = G729
5 = G729a
6 = PCMU
7 = PCMA
8 = X-NSE
9 - X-CCD
10 = Telephone Event
11 = Cisco Clear Channel
Telica, Inc.

6-57

ASCII Billing Reports

Issue 5, January 9, 2003

12 = Clear Mode
99 = Unknown
F is the Fax indicator digit. Values are:
0 = Call did not utilize fax/modem. Currently only value used.
1 = Call used fax/modem.
0 = Call used T.38.
182. Module 613 - Significant Digits
The Significant Digits field identifies the number of significant digits in
the next three fields. The value is always 45.
183. Module 613 Term Local IP Address
The Terminating Local IP Address field is a 15-digit field with three
leading zeros. The remaining twelve digits indicate the local IP address.
184. Module 613 Term Remote IP Address
The Terminating Remote IP Address field is a 15-digit field with three
leading zeros. The remaining twelve digits indicate the remote IP address.
185. Module 613 Term Local/Remote Port, Codec, Fax Indicator
The Terminating Local/Remote Port, Codec, and Fax Indicator field is a
15-digit field in the format of 00LLLLLRRRRRCCF. LLLLL are the
digits for the local port, RRRRR are the digits for the remote port, CC
are the digits for the Codec and F is the Fax indicator digit. Refer to
Field 181 for Codec values.
186. Module 264 Orig Release Cause Indicator
The Originating Release Cause Indicator field is a 4-digit field in the
format of CRRR. The C indicates the Cause Category and the values
can be:
0 = International Telecommunications Union (ITU) standard
2 = National
3 = Network specific
RRR indicates the release cause indication. Refer to Appendix A for a
complete list.
187. Module 264 Orig Packets Sent
The Originating Packets Sent field is a 13-digit field that identifies the
number of packets sent.

6-58

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-300-100

188. Module 264 Orig Packets Received


The Originating Packets Received field is a 13-digit field that identifies
the number of packets received.
189. Module 264 Orig Packets Lost
The Originating Packets Lost field is a 13-digit field that identifies the
number of packets lost.
190. Module 264 Orig Octets Sent
The Originating Octets Sent field is a 13-digit field that identifies the
number of octets sent.
191. Module 264 Orig Octets Received
The Originating Octets Received field is a 13-digit field that identifies the
number of octets.
192. Module 264 Orig Jitter
The Originating Jitter field is a 3-digit field indicating the jitter. This field
is currently not supported.
193. Module 264 Orig Latency
The Originating Latency field is a 3-digit field indicating the latency. This
field is currently not supported.
194. Module 264 Term Release Cause Indicator
The Terminating Release Cause Indicator field is a 4-digit field in the
format of CRRR. The C indicates the Cause Category and the values
can be:
0 = International Telecommunications Union (ITU) standard
2 = National
3 = Network specific
RRR indicates the release cause indication. Refer to Appendix A for a
complete list.
195. Module 264 Term Packets Sent
The Terminating Packets Sent field is a 13-digit field that identifies the
number of packets sent.

Telica, Inc.

6-59

ASCII Billing Reports

Issue 5, January 9, 2003

196. Module 264 Term Packets Received


The Terminating Packets Received field is a 13-digit field that identifies
the number of packets received.
197. Module 264 Term Packets Lost
The Terminating Packets Lost field is a 13-digit field that identifies the
number of packets lost.
198. Module 264 Term Octets Sent
The Terminating Octets Sent field is a 13-digit field that identifies the
number of octets sent.
199. Module 264 Term Octets Received
The Terminating Octets Received field is a 13-digit field that identifies the
number of octets
200. Module 264 Term Jitter
The Terminating Jitter field is a 3-digit field indicating the jitter. This
field is currently not supported.
201. Module 264 Term Latency
The Terminating Latency field is a 3-digit field indicating the latency.
This field is currently not supported.

6.4 Module Inclusion Rules


This section contains the module inclusion rules that must be met in order
for the data fields of a specific module to be appended to the ASCII
Billing Server master record. The modules supported by the ASCII
Billing Server are listed in Table 6-E.
Table 6-E. Module Numbers and Descriptions
Module Description
021
Carrier Access Originating
022
Long Duration Connection
025
Circuit Release Module
027
Business Customer ID Module
029
Alternate Billing Number Module
040
Digits Module
049
Calling Name/Number Delivery Module
068
Called Directory Number (DN) Descriptor
101
Digits Dialed Module
102
Authorization Code Module

6-60

Telica, Inc.

Billing and Traffic Collection Guide


Module
103
104
105
164
198
264
306
611
612
613
616
719
720

Section 150-300-100

Description
Account Code/Customer Dialed Account Recording (CDAR)
Module
Trunk Identification Module
Message Detail Recording (MDR)
E.164/X.121 Number Module
Flex Module
Quality of Service (QoS) (NDGR)
Originating Line Information Parameter (OLIP)
Generic Module
Generic Module: Two Digits String Format
Generic Module: Three Digits String Format
5 Digit Information Module
Local Number Portability Core Module
Local Number Portability (LNP) Module (NDGR)

6.4.1 Module 021, Carrier Access Originating


This module contains fields necessary to identify originating
Interexchange Carrier/International Carrier (IC/INC) access, including
carrier identification and the elapsed time of the carriers access to the
Local Access and Transport Area (LATA) network. However, in certain
situations, the Automatic Number Identification/Calling Party Number
(ANI/CPN) indicator is needed for the terminating end of a call (as in an
SS7 Environment), and this module may be used to identify terminating
IC/INC access.
6.4.2

Module 022, Long Duration Connection


This module contains fields necessary for time stamping long duration
connection records. Present date and present time refer to the moment
when the long duration connection is output or to the moment of
disconnect.
A long duration connection is an intra-network or inter-network call on
which, at a scheduled record generation time, both calling and called
parties remain off-hook ("connected" for carrier timing) and the elapsed
time and/or carrier elapsed time of the call already exceeds 1440 minutes
(24 hours).
For intra-network calls, the requirements for long duration connection
processing are as follows:
1. First record of a long duration connection must be generated at
the first scheduled record generation time after the elapsed time
of the call exceeds 1440 minutes.

Telica, Inc.

6-61

ASCII Billing Reports

Issue 5, January 9, 2003

2. First record must be generated as a conventional record that


must contain the Connect Date, Connect Time, and Elapsed
Time fields, except the Timing Indicator field must contain a
1 in character 3, indicating the start of a long duration
connection.
3. Elapsed time reported in the first record must equal the interval
from call connect time to the time when the record is
generated.
4. Determine inaccuracy compensation and the variable
inaccuracy allowance must be applied to duration time
determination made for the Elapsed Time field in the first
record.
5. Continuation record must be generated at each record
generation time that occurs between the time a calls first
record is made and call disconnect.
6. Continuation record of a long duration connection must contain
Connect Date and Connect Time fields and a Long Duration
Connection Module.
7. Timing Indicator field of a continuation record must contain a
2 in character 3, indicating a continuation record.
8. Elapsed time reported in a continuation record must be the
interval from the time when the previous record was generated
to either the time the current record is generated or the time the
call disconnects.
Record generation requirements for long duration connections are shown
in Figure 6-1.

6-62

Telica, Inc.

Billing and Traffic Collection Guide


G1

Section 150-300-100

G2

G3

Gk

Cell
Connect

Disconnect

Elapsed Time > 24 hours

Actual time
of call
connect
computed
and stored
pending
disconnect.

Long duration call


recognized. First
record computed.
Duration covers
interval from call
connect to G2
including
determinate
inaccuracy
compensation and
variable inaccuracy
allowance.

"Continuation"
record output.
Duration covers
interval G2 to G3 .

"Continuation"
record outpu for
G to G .
k-1

"Continuation"
record outpu for
G to disconnect.
k

P504-AA
12-06-01

Key: G denotes the scheduled record generation time.

Figure 6-1. Long Duration Call Sample

For inter-network calls, the requirements for intra-network calls apply.


The following requirements for carrier elapsed time recording also apply.
1. Long duration connection requirements (1 8 above) must be
applied to inter-network calls.
2. First record of a long duration connection for an inter-network
call must be generated at the first scheduled record generation
time after the carrier elapsed time (instead of elapsed time) of
the connection exceeds 1440 minutes.
3. First record for an inter-network call must be generated as a
conventional record that must contain Carrier Connect Date,
Carrier Connect Time, and Carrier Elapsed Time fields, except
the Timing Indicator field must contain a 1 in character 3,
indicating a start of a long duration connection.
4. Carrier Elapsed Time field of the first record for an internetwork call must be equal to the interval from carrier connect
time to the time when the record is generated.

Telica, Inc.

6-63

ASCII Billing Reports

Issue 5, January 9, 2003

5. Determinate inaccuracy compensation and the variable


inaccuracy allowance must be applied to duration time
determination made for the Carrier Elapsed Time field in the
first record for an inter-network call.
6. Continuation record of a long duration connection for an internetwork call must contain Carrier Connect Date and Carrier
Connect Time fields which must include the date and time of
the original call set up, and Long Duration Connection Module
(Present Day and Present Time fields).
7. Timing Indicator field of a continuation record for an internetwork call must contain a 2 in character 3, indicating a
continuation record.
8. Carrier Elapsed Time field for a continuation record for an
inter-network call must be the interval from the time when the
previous record was generated to either the time the current
record is generated or the time the call disconnects.
Forward changes in time (for example, 11:30 p.m. to 12:30 a.m. of the
next day with midnight as the record generation time) and backward
changes in time (for example, 12:30 a.m. to 11:30 p.m. of the preceding
day), can span record generation time.
When a forward change in time spans a record generation time, the switch
must generate all records that already have an elapsed time (or carrier
elapsed time) exceeding 1440 minutes. Also, the switch must generate all
continuation records that would have occurred at the spanned record
generation time.
An exception occurs when the forward change in time that spans a record
generation time follows a backward change in time that spanned the same
record generation time. In this case, records should not be generated.
When a backward change in time spans a record generation time, the
switch must not generate any first and continuation records at the record
generation time following the time change.
AMA data should be generated for a long duration connection as
described in the following example.
A call originates at 8:00 p.m. on day 1 and disconnects at 2:00 p.m. on
day 4. The time designated by the LEC for record generation each day is
3:00 a.m. At 3:00 a.m. on the second day, no record is generated because
the elapsed time is still less than 1440 minutes. Three records should be
generated as follows:

6-64

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-300-100

1. The first record is generated at 3:01:10 a.m. on the third day,


with an elapsed time of 1861 minutes, 10 seconds. The record
is generated after the scheduled record generation time due to
processing or scheduling delays in the switch.
2. The first continuation record is generated at 3:02:00 a.m. on the
fourth day with an elapsed time of 1440 minutes, 50 seconds,
which is the interval from 3:01:10 a.m. of the third day to
3:02:00 a.m. of the fourth day. Again, the switch had
processing or scheduling delays, causing the record to be
generated after the scheduled record generation time.
3. The second continuation record is generated at disconnect at
2:00:00 p.m. on the fourth day with an elapsed time of 658
minutes, 0 seconds.
6.4.3 Module 025, Circuit Release Module
This module contains the fields necessary to identify the date and time of
circuit (or trunk) release.
If this module is included in a BAF record format generated for intranetwork calls on which the called party off-hook is not detected, the
Circuit Date and Time fields indicate the date and time of circuit (or trunk)
release. The Called Party Off-Hook Indicator field contains a 1
(indicating called party off-hook is not detected). The Elapsed Time field
is set to 0 and the Connect Date and Time fields indicate the time of
circuit (or trunk) seizure.
This module is not used with carrier access calls, nor should it be used
with Operator Services System (OSS) calls.
6.4.4 Module 027, Business Customer ID Module
This module is included in a record when, as a result of the service, the
record must contain a business customer identification. The Business
Customer Identification is populated in the Business Customer
Identification field (right-justified) and unused characters are populated
with zeroes.
This module can be used, for example, with Private Virtual Network
(PVN) calls. The Business Customer ID module is included in the BAF
record if the response message from the Service Control Point (SCP)
contains a Business Customer Identification number. If a Business
Customer Identification number is not included in the response message,
the Business Customer Identification Module is not included in the record.

Telica, Inc.

6-65

ASCII Billing Reports

Issue 5, January 9, 2003

In an AIN BAF record, the Business Customer ID Module is recorded


instead of this module when the response message from the SCP to the
SSP contains an AMA sequence number parameter in addition to the
AMA Business Customer ID parameter.
6.4.5

Module 029, Alternate Billing Number Module


This module is included in a BAF record when an alternate billing number
is needed. This billing number populates the Alternate Billing Number
field, is right-justified, and unused characters are populated with zeroes.
This module can be used, for example, with PVN calls. The Alternate
Billing Number module is only included in the BAF record for a PVN call
if the response message from the SCP contains a billing number.
In an AIN BAF record, the Alternate Billing Module is recorded instead of
this module when the response message from the SCP to the SSP contains
an AMA Sequence Number parameter in addition to the AMA Alternate
Billing Number parameter.

6.4.6 Module 040, Digits Module


This module is used to record digits used during an AIN call. Up to 24
significant digits can be recorded. This module is only appended to
Structure Codes 0220 and 0221, and it may be repeated in the same AMA
record.
The Digits Module is recorded instead of this module when recording
SCP-provided digits and the response message from the SCP to the SSP
also contains an AMA Sequence Number parameter.
6.4.7 Module 049, Calling Name/Number Delivery Module
This module provides the Count of Name-Only and Count of NumberOnly fields. The Count of Name-Only field counts the number of times a
calling name appears in the information delivered to the customer. For
each count, an "anonymous" or "unavailable" indication is sent in place of
the calling number. - The Count of Number-Only Deliveries field counts
the number of times a calling number appears in the information delivered
to the customer. For each count, an "anonymous" or "unavailable"
indication is sent in place of the calling name.

6-66

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-300-100

6.4.8 Module 68, Called Directory Number (DN) Descriptor


This module contains one field that describes the special billing potential
of the called Directory Number (DN). If the called DN requires special
treatment by the Revenue Accounting Office (RAO) in the billing process,
this module will be appended to the Automatic Message Accounting
(AMA) data structure normally generated for that call. Examples of
features that use this module are the CLASS features Automatic Callback
(AC) and Automatic Recall (AR).
6.4.9

Module 101, Digits Dialed Module


This module is currently used in Message Detail Recording (MDR).
When the actual number to which the call is routed differs from the
number dialed by the originator of the call (as seen at the switching system
at which the MDR data record is generated), the actual digits received on
the originating facility populate the digits dialed fields. The Access Code
for private network calls (i.e., Tie Trunk calls) contains the digits dialed to
indicate the particular type of call (e.g., a code dialed for Wide Area
Telecommunications Service (WATS) access). The dialed Access Code is
right-justified in Table 803 and unused characters are filled with zeros. For
public network calls dialed using prefix digits for access to the public
network (i.e., "dial 9" calls), the prefix digits dialed before the public
directory number populate the Access Code field, are right-justified, and
unused characters are filled with zeros.

6.4.10 Module 102, Authorization Code Module


This module is used to provide Message Recording Detail (MDR). If an
authorization code is received on a call using the Authorization Codes for
the Automatic Flexible Routing (AFR) feature, the Authorization Code
digits populate Table 126. If the dialed Authorization Code exceeds 15
digits, only the first 15 digits dialed populate this field. If the code
contains fewer than 15 digits, it is right-justified, and unused characters
are filled with zeros.
6.4.11 Module 103, Account Code/Customer Dialed Account Recording (CDAR)
Module
This module contains account code or Customer-Dialed Account
Recording (CDAR) information. If both the account and CDAR features
are used on the same call, the account code information populates the
module, not the CDAR information. Account code information is similar
to CDAR information except for the point in the customer dialing pattern
when the account code/CDAR information is provided.

Telica, Inc.

6-67

ASCII Billing Reports

Issue 5, January 9, 2003

6.4.12 Module 104, Trunk Identification Module


This module captures trunk identification information for incoming and
outgoing calls. Module 104 appears when a trunk-side connection occurs.
For example, if a call originates from a PRI and routes out over an SS7
trunk, one module 104 will appear on the record with the SS7 trunk
information. If the call is switched from one SS7 trunk to another SS7
trunk, two module 104s will appear on the record with the incoming and
outgoing trunk information. If a call originates PRI and terminates via
PRI from the same switch, no module 104 appears on the record.
6.4.13 Module 105, Message Detail Recording (MDR)
This module is included in every Message Detail Recording (MDR)
record. The MDR customer for whom the MDR data is intended is
uniquely identified in Table 87. The facility types in Table 246 are
recorded from the perspective of the switch that is creating the MDR data
record.
6.4.14 Module 164, E.164/X.121 Number Module
This module provides the means to record lengthy numbers that cannot be
recorded in the structure applicable to the call. Refer to section 6.5,
Module Number 164 for details concerning module 164.
6.4.15 Module 198, Flex Module
This module is used to hold a field that has a variable length. Table 575 is
a context identifier (i.e., originating address, terminating address) that
defines the tables that follow Table 575.
6.4.16 Module 264, Quality of Service (QoS) (NDGR)
Module Code 264 is used to record the Network Latency and Inter-arrival
jitter that are associated with Quality of Service (QoS). It includes the release
cause indicator, the number of packets sent, the number of packets
received, the number of packets lost, the number of octets sent, the
number of octets received, the inter-arrival jitter and the amount of
network latency.
6.4.17 Module 306, Originating Line Information Parameter (OLIP)
This module identifies the class of service of the originating line. It can
also be used to record a unique class of service that can identify various
services offered by Local Exchange Carriers (LECs).
6.4.18 Module 611, Generic Module
This is a generic, general-purpose module. The Generic Context Identifier
field (Table 237) defines the parsing rules and the type of data to be stored
in the Digits String field (Table 126).

6-68

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-300-100

6.4.19 Module 612, Generic Module: Two Digits String Format


This module is a generic, general-purpose module used when the
requirements of the application fit the format of this layout. The Generic
Context Identifier field, (Table 237) defines the number of characters in
the Digits String 1 (Table 126) and Digits String 2 (Table 126) fields. The
Digits String fields identify the IOM typeand slot.
6.4.20 Module 613, Generic Module: Three Digits String Format
This module is a generic, general-purpose module used when the
requirements of the application fit the format of this layout. The Generic
Context Identifier field (Table 237) defines the number of digits to be
stored in the Digits String 1 (Table 126), Digits String 2 (Table 126) fields
and Digits String 3 (Table 126). The Digit String 1 and 2 fields are used
to identify IP addresses and Digit String 3 is used to identify the local and
remote ports, the Codec and the Fax indicator.
6.4.21 Module 616, 5 Digit Information Module
This module is a general purpose, vendor specific, 5 digit information
module.
6.4.22 Module 719, Local Number Portability (LNP) Core Module
This module provides the LRN when applicable for calls in the LNP
environment. Module 719 is now obsolete. Telica has replaced it with
Module 720.
6.4.23 Module 720, Local Number Portability (LNP) Module
This module is used to convey information pertinent to rating and billing
of calls to and/or from ported numbers in environments with LNP.

6.5 Module Number 164


Module 164 (also know as E.164/X.121 Number Module ) is appended to
provide additional information about the telephone numbers associated
with the call gathered from the CDR, only if the CDR call type and call
conditions dictate that Module 164 needs to be appended to the CDR.
More specifically, Module 164 will be appended to the ASCII record
being generated when one or more of the following conditions occur:
The originating number to be recorded in the originating
number field (defined in section 8.3.1, R1-50) exceeds 10
digits. If it is 10 or fewer digits (not including incoming
international calls), it is recorded in the originating number
fields of the structure and the module is not appended.

Telica, Inc.

6-69

ASCII Billing Reports

Issue 5, January 9, 2003

The terminating number to be recorded in the terminating


number fields (section 83.1, R1-50) exceeds 12 digits. If it is
12 or fewer digits, it is recorded in the terminating number
fields of the structure and the module is not appended.
The Call is forwarded
The Calling Party Number is different than the Charge Number
The Trunk Group is provisioned with a Billing Number
Although it is unlikely, it is possible to have all the conditions occur in
one call. Based on the population rules for Module 164, this would
require a maximum of 6 module 164s.
Telicas Module 164 contain the following ordered list of fields:
Module Code
Number Identify
Country Code or Data Network Identification Code
Significant Digits in the Next Field(s)
Number
Call Forwarding Rules for Populating Module 164
A call can be forwarded from one to five times on one dialed call. Each
time the call is forwarded, module 164 is used to capture information
about the call that would otherwise be lost. For example, A calls B and, B
forwards the call to C, when B receives the bill for the B to C leg of the
call, B would like to know that it was a forwarded call and who originated
it. To provide this data, a Module 164 is appended with the Calling Party
Number and the Service Feature Field (defined above) populated with a
12 to indicate that the call was forwarded.
Since a CDR may be generated for each individual subscriber at the
forwarded leg of the call, the CDR needs to capture different information
at each leg. Table 6-F shows the various legs of a call that has been
forwarded several times and the information that may be populated by
signaling for each leg. The Plexus 9000 will use this information to
populate multiple module 164s as indicated in the chart. The table also
illustrates how the modules will be populated if there is a billing number
override associated with the subscriber or the associated trunk group used
for the call.

6-70

Telica, Inc.

Billing and Traffic Collection Guide


6.5.1

Section 150-300-100

E.164 Numbering Plan


The E.164 numbering plan, as derived from ITU-T Recommendation
E.164 and TR-TSY-000448, defines the currently used structure of an
international telephone number. According to Recommendation E.164,
such numbers follow the CC+N(S)N format where:
CC= Country Code Identifies the destination country and can vary
between 1 and 3 digits.
N(S)N = National (Significant) Number Identifies the destination
termination, and the maximum N(S)N length is 11 digits.
CC+N(S)N = maximum of 12 digits.

Table 6-F. Call Forwarding Module 164 Population Chart


Signaling
CPN (Calling Party Number)
ChN (Charge Number)
RN (Redirecting Number}
OCN (Original Called Number)
CN (Called (terminating) Number)
SFC (Service Feature Code (BAF
Table 12))

A -> B
A

B -> C
A
B

Leg
C -> D
A
C
B

B
0

C
12

D
12

A
B

B
C
A

BN
B
A

BN
C
B
A

D -> E
A
D
C
B
E
12

E -> F
A
E
D
B
F
12

C
D
A
B

D
E
A
C
B

E
F
A
D
B

BN
D
C
A
B

BN
E
D
A
C
B

BN
F
E
A
D
B

CDR
Orig
Term
Module 164
Module 164
Module 164
Module 164

CDR w/BN override


Orig
Term
Module 164
Module 164
Module 164
Module 164

Note: The letter in each cell indicates the value that should be assigned to each
variable for a particular leg. For instance, the Redirecting Number (RN) should be
assigned B's number for C -> D leg. Empty cells indicate that the variable is not set to
a valid value and should be marked as 'Not present'.

Telica, Inc.

6-71

ASCII Billing Reports

Issue 5, January 9, 2003

The above applies until Time T (year-end 1996). After that, CC+N(S)N
will be a maximum of 15 digits, which results in a maximum N(S)N of 14
digits since no changes are planned for the structure of a CC.
The North American Numbering Plan (NAPN) is the numbering plan
currently used in the United States. It meets the requirements set forth in
the ITU-T Recommendation E.164.
6.5.2

X.121 Numbering Plan


The International Numbering Plan for Public Data Networks (PDNs) is
documented in ITU-T-Recommendation X.121. An international
/internetwork data number consists of the Data Network Identification
Code (DNIC) followed by the Network Terminal Number (NTN). The
DNIC consists of a three-digit Data Country Code (DCC) followed by a
network digit. DCCs are ITU-T administered; however, they are not the
same country codes specified in Recommendation E.164. The DCC
identifies a country; the network digit identifies a specific data network
within the country identified by the DCC. The DCC in conjunction with
the network digit can identify up to ten PDNs. Multiple DCCs may be
assigned to a country where more than ten PDNs exist. Recommendation
X.121 specifies a maximum length of ten digits for the NTN. No
minimum NTN length is specified. The format of the NTN is determined
by the network provider that is identified by the DNC. Although the most
commonly discussed usage of the X.121 numbering plan is in connection
with packet data networks, the plan is also applicable to circuit-switched
data networks that may choose to use it. X.121 numbers are included in
the E.164/X.121 Number Module (Module Code 164) to cover the
possibility of a future increase in length of NTN.

6.6 Call Types, Structure Codes, and Modules


A call type, together with a call type code, represents the
service/technology provided to a customer or carrier. The call type code
in a BAF record provides guidance to accounting systems for processing
the record. Call types are determined by the type of service.
A structure is a set of eight common data fields, followed by a group of
fields required by the type of service or technology for which the data are
recorded. Each structure is a unique, ordered set of fields identified by a
structure code (the third data field in the ASCII master record). Every
BAF structure contains a common set of eight data fields. Structure codes
are determined by call type.

6-72

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-300-100

In Table 6-G, all data fields for each particular structure code are listed.
The eight common data fields, common to every structure code, are listed,
but they will not be included in the Structure Code Fields column in
Table 6-G. Therefore, a structure code listed in Table 6-G contains all
data fields listed in the Structure Code Fields column for that structure
code, as well as the eight common data fields provided in the following
list. The letter appearing beside most entries listed identifies which field
description to reference in the lettered list in section 5, ASCII-Format
Master Record Field Descriptions, of this document.
The eight common data fields shared by most structure codes are:

Record Descriptor Word


Hexadecimal Identifier
Structure Code (b)
Call Type (a)
Sensor Type (c)
Sensor Identification (d)
Recording Office Type (e)
Recording Office Identification (f)

Modules are predefined sets of data fields that may be appended to a


structure according to the service/technology rendered, or to report
information connected with specific conditions. Modules are often
referred to by their module code number. Modules have fixed names that
indicate the meaning of the data they contain or the service or capability
for which they are used. They are determined by the call type and the
conditions of the call. Modules are appended to the end of the record,
after the structure code fields.
Use the letter listed next to the field in Table 6-G to cross-reference
against the field definitions provided in section 6.3, ASCII-Format Master
Record Field Descriptions.

6.7 Configuration and Operation


To use the ABS or BTS successfully with the Plexus 9000, you must first
meet specific ABS or BTS server platform requirements and then
configure the ABS or BTS on the Sun server to communicate with the
Plexus 9000, and configure the Plexus 9000 to communicate with the
ABS. The procedures for installing and configuring the ABS or BTS
application on a Server are found in the Procedures section of this guide.
Procedures for provisioning the Plexus 9000 for Billing are found in the
Plexus 9000 Installation and Operation Manual.

Telica, Inc.

6-73

Table 6-G. Call Types, Modules and Structure Code 0625


Call Types, Modules and Structure Code 0625 (5 pages)
Call
Type
110

Call Type Name

Mod.

Inter-LATA
Station Paid

021,
104,
164,
720

Module Fields and Field Ref. #


for Sect. 6
021 - Module Code ID,
IC/INC Prefix,
Carrier Access Date (tt),
Carrier Access Time (uu),
Elapsed Time (vv),
IC/INC Call Event Status (ww),
Trunk Group Number (xx),
Routing Indicator (yy),
Dialing and Presubscription Indicator (zz),
ANI/CPN Indicator (aaa)
104 Module Code ID,
Trunk ID
164 Module Code,
Number Identity (rrr),
Country Code or Data Network ID Code (ttt),
Significant Digits in Next Field(s) (uuu),
Number (vvv)
720 Module Code ID,
Party ID (zzz),
Location Routing Number (LRN) (xxx),
Service Provider Identity (bbbb),
Location (cccc),
Supporting Information (dddd)

Structure Code Fields


Eight common data fields,
Connect Date (g),
Timing Indicator (h),
Study Indicator (i),
Called Party Off-hook Indicator (j),
Service Observed/Traffic Sampled (k),
Operator Action (l),
Service Feature (m),
Originating NPA (n),
Originating Number (o),
Overseas (International Call) Indicator (p),
Terminating NPA (q),
Terminating Number (r),
Connect Time (s),
Elapsed Time (t),
IC/INC Prefix (u),
Carrier Connect Date (v),
Carrier Connect Time (w),
IC/INC Call Event Status (y),
Trunk Group Number (z),
Routing Indicator (aa),
Dialing and Presubscription Indicator (bb),
ANI/CPN Indicator (cc)

Calling Pattern
(Based on Call Type)
1+NXX+ XXXX,
0-,
0+NXX+ XXXX,
1+ NPA+555+ 1212,
101XXXX+ 0+,
101XXXX+00-,
101XXXX+ 0/1+
(originating),
101XXXX+ 01/011+
(orig),
01/011+7 to 18-digit,
800 call (non-SSP),
1+500+7-digits,
1+700+7-digits,
1+900+7-digits

Call Types, Modules and Structure Code 0625 (5 pages)


Call
Type
119

Call Type Name

Mod.

Terminating
Access Record

021,
104,
164,
720

Module Fields and Field Ref. #


for Sect. 6
021 - Module Code ID,
IC/INC Prefix,
Carrier Access Date (tt),
Carrier Access Time (uu),
Elapsed Time (vv),
IC/INC Call Event Status (ww),
Trunk Group Number (xx),
Routing Indicator (yy),
Dialing and Presubscription Indicator (zz),
ANI/CPN Indicator (aaa)
104 Module Code ID,
Trunk ID
164 Module Code,
Number Identity (rrr),
Country Code or Data Network ID Code (ttt),
Significant Digits in Next Field(s) (uuu),
Number (vvv)
720 Module Code ID,
Party ID (zzz),
Location Routing Number (LRN) (xxx),
Service Provider Identity (bbbb),
Location (cccc),
Supporting Information (dddd)

Structure Code Fields


Eight common data fields,
Connect Date (g),
Timing Indicator (h),
Study Indicator (i),
Called Party Off-hook Indicator (j),
Service Observed/Traffic Sampled (k),
Operator Action (l),
Service Feature (m),
Originating NPA (n),
Originating Number (o),
Overseas (International Call) Indicator (p),
Terminating NPA (q),
Terminating Number (r),
Connect Time (s),
Elapsed Time (t),
IC/INC Prefix (u),
Carrier Connect Date (v),
Carrier Connect Time (w),
IC/INC Call Event Status (y),
Trunk Group Number (z),
Routing Indicator (aa),
Dialing and Presubscription Indicator (bb),
ANI/CPN Indicator (cc)

Calling Pattern
(Based on Call Type)
Terminating exchange

Call Types, Modules and Structure Code 0625 (5 pages)


Call
Type
710

Call Type Name


Originating Toll
AMA Recording
(Vendor Specific)

Mod.

Module Fields and Field Ref. #


for Sect. 6

Structure Code Fields


Eight common data fields,
Connect Date (g),
Timing Indicator (h),
Study Indicator (i),
Called Party Off-hook Indicator (j),
Service Observed/Traffic Sampled (k),
Operator Action (l),
Service Feature (m),
Originating NPA (n),
Originating Number (o),
Overseas (International Call) Indicator (p),
Terminating NPA (q),
Terminating Number (r),
Connect Time (s),
Elapsed Time (t),
IC/INC Prefix (u),
Carrier Connect Date (v),
Carrier Connect Time (w),
IC/INC Call Event Status (y),
Trunk Group Number (z),
Routing Indicator (aa),
Dialing and Presubscription Indicator (bb),
ANI/CPN Indicator (cc)

Calling Pattern
(Based on Call Type)

Call Types, Modules and Structure Code 0625 (5 pages)


Call
Type
720

Call Type Name

Mod.

Connecting
Network Access
Incoming Record

021,
104,
164,
720

Module Fields and Field Ref. #


for Sect. 6
021 - Module Code ID,
IC/INC Prefix,
Carrier Access Date (tt),
Carrier Access Time (uu),
Elapsed Time (vv),
IC/INC Call Event Status (ww),
Trunk Group Number (xx),
Routing Indicator (yy),
Dialing and Presubscription Indicator (zz),
ANI/CPN Indicator (aaa)
104 Module Code ID,
Trunk ID
164 Module Code,
Number Identity (rrr),
Country Code or Data Network ID Code (ttt),
Significant Digits in Next Field(s) (uuu),
Number (vvv)
720 Module Code ID,
Party ID (zzz),
Location Routing Number (LRN) (xxx),
Service Provider Identity (bbbb),
Location (cccc),
Supporting Information (dddd)

Structure Code Fields


Eight common data fields,
Connect Date (g),
Timing Indicator (h),
Study Indicator (i),
Called Party Off-hook Indicator (j),
Service Observed/Traffic Sampled (k),
Operator Action (l),
Service Feature (m),
Originating NPA (n),
Originating Number (o),
Overseas (International Call) Indicator (p),
Terminating NPA (q),
Terminating Number (r),
Connect Time (s),
Elapsed Time (t),
IC/INC Prefix (u),
Carrier Connect Date (v),
Carrier Connect Time (w),
IC/INC Call Event Status (y),
Trunk Group Number (z),
Routing Indicator (aa),
Dialing and Presubscription Indicator (bb),
ANI/CPN Indicator (cc)

Calling Pattern
(Based on Call Type)

7.

AMA Lite Reports

7.1
7.2

Introduction ..........................................................................................................7-2
CDR and AMA Lite Formats ...............................................................................7-2
7.2.1 CDR Data Prior to Conversion.................................................................7-2
7.2.2 AMA Files After Conversion...................................................................7-4
Module Inclusion Rules .......................................................................................7-8
7.3.1 Module 021, Carrier Access Originating ..............................................7-8
7.3.2 Module 022, Long Duration Connection .................................................7-9
7.3.3 Module 025, Circuit Release Module ....................................................7-12
7.3.4 Module 027, Business Customer ID Module .........................................7-12
7.3.5 Module 029, Alternate Billing Number Module....................................7-13
7.3.6 Module 040, Digits Module ...................................................................7-13
7.3.7 Module 049, Calling Name/Number Delivery Module .........................7-13
7.3.8 Module 68, Called Directory Number (DN) Descriptor ........................7-14
7.3.9 Module 101, Digits Dialed Module........................................................7-14
7.3.10 Module 102, Authorization Code Module .............................................7-14
7.3.11 Module 103, Account Code/Customer Dialed Account Recording
(CDAR) Module.....................................................................................7-14
7.3.12 Module 104, Trunk Identification Module.............................................7-15
7.3.13 Module 105, Message Detail Recording (MDR) ...................................7-15
7.3.14 Module 164, E.164/X.121 Number Module ..........................................7-15
7.3.15 Module 198, Flex Module......................................................................7-15
7.3.16 Module 264, Quality of Service (QoS) (NDGR) ...................................7-15
7.3.17 Module 306, Originating Line Information Parameter (OLIP)..............7-15
7.3.18 Module 611, Generic Module ................................................................7-15
7.3.19 Module 612, Generic Module: Two Digits String Format.....................7-16
7.3.20 Module 613, Generic Module: Three Digits String Format...................7-16
7.3.21 Module 616, 5 Digit Information Module..............................................7-16
7.3.22 Module 719, Local Number Portability (LNP) Core Module................7-16
7.3.23 Module 720, Local Number Portability (LNP) Module.........................7-16
Module Number 164 ..........................................................................................7-16
7.4.1 E.164 Numbering Plan ...........................................................................7-17
7.4.2 X.121 Numbering Plan...........................................................................7-18
7.4.3 Generation of Module 164 .....................................................................7-18
Call Types, Structure Codes, and Modules ........................................................7-19
Configuration and Operation..............................................................................7-20

7.3

7.4

7.5
7.6

To avoid local time synchronization problems, Telica strongly recommends


setting the Plexus system clock to use GMT.

AMA Lite Reports

7.1

Issue 2, January 12, 2004

Introduction
The PlexView Automatic Message Accounting (AMA) Lite application
and the PlexView Billing and Traffic System (BTS) works with the
Plexus 9000 switch to convert Call Detail Records (CDRs to an AMA
record format. For more detail about AMA Lite or BTS, refer to these
sections of this manual.

7.2

CDR and AMA Lite Formats


The Plexus 9000 sends the server the CDR data every five seconds from
the circular buffer, where they are converted to AMA files via the
converter. After delivery to server, the data records are formatted to AMA
and saved into AMA files.

7.2.1 CDR Data Prior to Conversion


The Plexus 9000 CDRs support the Billing Automatic Message
Accounting Format (BAF) call types and structures, and are based on
Telcordias AMA architecture (GR-1100). Currently, the AMA Lite and
BTS applications supports the AMA call types from the switch that are
listed in Table 7-A.
The AMA Lite billing and BTS applications follow the AMA record
formatting rules as defined in Telcordias GR-1100. Generally, based on
dialing pattern or type of call (i.e. 800 service) and connection type (i.e.
access tandem to end office, end office to access tandem, access tandem to
IXC, etc.), a call type is determined. Using the call type, the Plexus 9000
will map the call to an underlying structure code, which is a four-character
numeric field. Refer to Table 7-A for a listing of all call types and the
structure codes and modules supported by each. Refer to Table 7-B for a
list of the structure codes and the associated call types.
In GR-1100, the structure codes define the group of fields that will be
provided for this call and, for each field, GR-1100 provides a table number
that further defines the content of the field. In addition, depending on the
specific conditions of the call, the Plexus 9000 will append modules that
will provide additional information (i.e. on long duration calls module 22
is appended). Again, GR-1100 documents the group of fields contained
within each module and provides a table number that further defines the
content of each field.

7-2

Telica, Inc.

Billing and Traffic Collection Guide

Call
Type
001
002
003
004
006
009
031
033
036
037
047
067
074
088
110
119
123
141
142
159
264
330
710
720
721

Section 150-300-200

Table 7-A. Call Types Supported by the Plexus 9000


Structure
Call Type Name
Code
Module
Detailed Message Rate, Timed, w/ MBI.
0020
022
Message Rate, Timed, w/ MBI.
0020
022
Detailed Message Rate, Untimed, w/ MBI. 0020
022
Message Rate, Untimed, w/ MBI.
0020
022
Station Paid
0001
021, 022, 720
411 Directory Assistance
0028
022
Call Forwarding
0096, 0614 022
555 Directory Assistance
0028
022
Terminating Study Record
0079
022
Terminating SLUs Overflow Counts
9003
Default Advanced Intelligent Network
0220
021, 022, 025, 027,
(AIN)
029, 040, 104, 164
Default Advanced Intelligent Network
0001
021, 022, 720
(AIN)
Free Call
0001
022
Non-Directory Assistance 555 Call
0001
021, 022, 720
Inter-LATA station paid
0625
022, 104, 164
Terminating Access record
0625
022, 104, 164
CLASS Feature Activation
1030
022
InterExchange Carrier (IC/IXC) Number
0360
022
Service
Local Exchange Carrier (LEC) Number
0364
022
Service
Message Detail Recording (MDR) Data
0001, 0079, 102, 103, 105
0500
Calling Identity Delivery Record
0110
CLASS Feature
110, 1030 49
Originating Toll AMA Recording (Vendor 0625
022, 104, 164
Specific)
Connecting Network Access Incoming
0625
022, 104, 164, 720
Record
Default Local Number Portability (LNP)
0500
022, 104, 164, 720

Telica, Inc.

7-3

AMA Lite Reports

Issue 2, January 12, 2004

Table 7-B. Structure Codes


Structure Code
Call Types
0001
006, 067, 074, 088
0020
001, 002, 003, 004
0028
009, 033
0079
036
0110
264, 330
0220
047, 159
0360
141
0364
142
0500
721
0625
110, 119, 710, 720
1030
123, 330
7.2.2 AMA Files After Conversion
The default for saving AMA files is 24 hours, but you can configure the
frequency with which files are saved in minutes. The file is also available
on the server for a configurable number of days before it is deleted. The
maximum number of days is 62. The larger the number, the more disk
space is required. The frequency and the archive parameters are
provisioned in the ama.conf file.
All converted CDR information is captured in an AMA master record.
Each record is pre-pended with a proprietary header. Refer to Table 7-C
for the fields in the header.
Refer to GR-1100 CORE, Billing Automatic Message Accounting Format
(BAF) Generic Requirements for value descriptions of the fields or to the
comparable fields listed in the PlexView ASCII Billing Server (ABS)
chapter of this guide.

7-4

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-300-200

Table 7-C. Header of AMA Lite Record


Field
Description
* * * *STRUCTURE CODE 9999* * * * header record
recDes
Defines length of record header.
hexId
Identifies number of errors in header.
structCode
The structure code is always 9999C and may be
prefaced with a 0 or a 4. 0 indicates that no
modules are attached; 4 indicates that modules
are attached.
callType
This is always call type 999C.
version
Identifies version number in the format of
MMMmm, where M is the major release number
and m is the minor.
create_date
Identifies creation date.
create_time
Identifies creation time.
close_date
Identifies the date when the file is closed. If file
was not properly closed, it will be FFFFFC.
close_time
Identifies the time when the file is closed. If file
was not properly closed, it will be FFFFFFFC
records
Identifies the number of records when file is
closed. If file was not properly closed, it will be
FFFFFFFFFC

Table
000
00
0

1
803

6
18
6
18
805

Table 7-D. Fields in the AMA Lite Record


Field Description
* * * *STRUCTURE CODE 0625* * * *
recDes
hexId
structCode
callType
sensorType
sensorId
rcrdOfficeType
rcrdOfficeId
date
timingInd
studyInd
answerInd
servObsrvdTrafSampled
operatorAction
serviceFeature
origNPA
origNumber

overseasInd
termNPA
termNumber
answerTime
elapsedTime
icIncPrefix

Telica, Inc.

GR-1100
Table #

# of Char.

2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
57

4
8
4
8
6
6
8
2
2
2
4
4
8
2
6
8
8
10
6

7-5

AMA Lite Reports

Issue 2, January 12, 2004

Field Description
carrierConnectDate
carrierConnectTime
carrierElapsedTime
icIncCallEventStatus
trunkGroupNumber
routingIndicator
dialingInd
aniInd
* * * *MODULE 104* * * *
moduleCode
trunkIdentNumber
* * * *MODULE 164* * * *
moduleCode
numberIdentity
countryCodeOrDNIC
sigDigitsInNext
digits
* * * *TERMINATOR MODULE CODE zero * * * *

GR-1100
Table #
6
18
19
58
83
59
85
60

# of Char.
6
8
10
4
6
2
2
2
4
10
4
2
6
4
16

The master record contains the fields listed in Table 7-E. Refer to GR1100 CORE, Billing Automatic Message Accounting Format (BAF)
Generic Requirements for value descriptions of the fields or to the
comparable fields listed in the PlexView ASCII Billing Server (ABS)
chapter of this guide.
Table 7-E. List of Fields in the Master Record
Field Description
Sensor Type
Sensor Previous Output Ind
Sensor Identification
Recording Office Type
Recording Office Previous Output Ind
Recording Office Identification
Connect Date [3]
Connect Time
Timing Indicator [3]
Study Indicator[7]
Called Party Off-Hook Indicator
Service Observed/Traffic Sampled
Operator Action
Service Feature
Originating NPA [2]
Originating Number [4]
Dialed NPA [2]
Dialed Number [4]
Destination Overseas (International Call) Indicator
Destination Number Plan Area (NPA) [3]

7-6

GR-1100
Table #
2

# of Char.
4

3
4

8
4

5
6
18
7
8
9
10
11
12
13
14
13
14
15
16

8
6
8
6
8
2
2
2
4
4
8
4
8
2
6

Telica, Inc.

Billing and Traffic Collection Guide

Field Description
Destination Number [4]
Elapsed Time
IC/INC Prefix [3]
Carrier Connect Date [3]
Carrier Connect Time [4]
Carrier Elapsed Time
IC/INC Call Event Status
trunkGroupSigTypeInd
Trunk Group Number
Routing Indicator
Dialing And Presubscription Indicator
ANI/CPN Indicator
Revenue Accounting Office (RAO) Number
Local Access Transport Area (LATA)
WATS Indicator
Wats Band or Message billing Index
WATS Administration
Data Capabilities Indicator
Information Transfer Rate Indicator
Terminating Company
Completion Indicator
Service Logic Identification [5]
Numbering Plan Area (NPA)
Directory Number
Usage count
Date
Time
Class Feature Code
Call Count -Information delivered
Call Count -Information Anonymous/Unavailable
Activating NPA
Activating Number
Far-end Overseas indicator
Far-end NPA
Far-end Number
CLASS Functions
CLASS Feature status
Screening list size of selective call forwarding or
selective call acceptance
screening list size of selective call rejection
screening list size for distinctive ringing/call waiting
forward to overseas Indicator
forward to NPA
forward Number
activation date
activation time
deactivation date
deactivation time

Telica, Inc.

Section 150-300-200
GR-1100
Table #
17
19
57
6
18
19
58

# of Char.
8
10
6
6
8
10
4

83
59
85
60
46
197
28
29
30
41
42
56
280
77
13
14
130
6
18
415
803
803
13
14
15
16
17
330
331

6
2
2
2
4
4
2
4
6
4
4
4
4
10
4
8
6
6
8
4
6
6
4
8
2
6
8
4
4

802

802
802
15
16
17
18
18
6
18

4
4
2
6
8
8
8
6
8

7-7

AMA Lite Reports

7.3

Issue 2, January 12, 2004

Module Inclusion Rules


This section contains the module inclusion rules that must be met in order
for the data fields of a specific module to be appended to the AMA Billing
Server master record. The modules supported by the AMA Billing Server
are listed in Table 7-F.
Table 7-F. Module Numbers and Descriptions
Module Description
021
Carrier Access Originating
022
Long Duration Connection
025
Circuit Release Module
027
Business Customer ID Module
029
Alternate Billing Number Module
040
Digits Module
049
Calling Name/Number Delivery Module
068
Called Directory Number (DN) Descriptor
101
Digits Dialed Module
102
Authorization Code Module
103
Account Code/Customer Dialed Account Recording (CDAR)
Module
104
Trunk Identification Module
105
Message Detail Recording (MDR)
164
E.164/X.121 Number Module
198
Flex Module
264
Quality of Service (QoS) (NDGR)
306
Originating Line Information Parameter (OLIP)
611
Generic Module
612
Generic Module: Two Digits String Format
613
Generic Module: Three Digits String Format
616
5 Digit Information Module
719
Local Number Portability Core Module
720
Local Number Portability (LNP) Module (NDGR)

7.3.1 Module 021, Carrier Access Originating


This module contains fields necessary to identify originating
Interexchange Carrier/International Carrier (IC/INC) access, including
carrier identification and the elapsed time of the carriers access to the
Local Access and Transport Area (LATA) network. However, in certain
situations, the Automatic Number Identification/Calling Party Number
(ANI/CPN) indicator is needed for the terminating end of a call (as in an
SS7 Environment), and this module may be used to identify terminating
IC/INC access.

7-8

Telica, Inc.

Billing and Traffic Collection Guide


7.3.2

Section 150-300-200

Module 022, Long Duration Connection


This module contains fields necessary for time stamping long duration
connection records. Present date and present time refer to the moment
when the long duration connection is output or to the moment of
disconnect.
A long duration connection is an intra-network or inter-network call on
which, at a scheduled record generation time, both calling and called
parties remain off-hook ("connected" for carrier timing) and the elapsed
time and/or carrier elapsed time of the call already exceeds 1440 minutes
(24 hours).
For intra-network calls, the requirements for long duration connection
processing are as follows:
1. First record of a long duration connection must be generated at
the first scheduled record generation time after the elapsed time
of the call exceeds 1440 minutes.
2. First record must be generated as a conventional record that
must contain the Connect Date, Connect Time, and Elapsed
Time fields, except the Timing Indicator field must contain a
1 in character 3, indicating the start of a long duration
connection.
3. Elapsed time reported in the first record must equal the interval
from call connect time to the time when the record is
generated.
4. Determine inaccuracy compensation and the variable
inaccuracy allowance must be applied to duration time
determination made for the Elapsed Time field in the first
record.
5. Continuation record must be generated at each record
generation time that occurs between the time that a calls first
record is made and the call disconnects.
6. Continuation record of a long duration connection must contain
Connect Date and Connect Time fields and a Long Duration
Connection Module.
7. Timing Indicator field of a continuation record must contain a
2 in character 3, indicating a continuation record.
8. Elapsed time reported in a continuation record must be the
interval from the time when the previous record was generated
to either the time the current record is generated or the time the
call disconnects.

Telica, Inc.

7-9

AMA Lite Reports

Issue 2, January 12, 2004

Record generation requirements for long duration connections are shown


in Figure 7-1.
G1

G2

G3

Gk

Cell
Connect

Disconnect

Elapsed Time > 24 hours

Actual time
of call
connect
computed
and stored
pending
disconnect.

Long duration call


recognized. First
record computed.
Duration covers
interval from call
connect to G2
including
determinate
inaccuracy
compensation and
variable inaccuracy
allowance.

"Continuation"
record output.
Duration covers
interval G2 to G3 .

"Continuation"
record outpu for
G to G .
k-1

"Continuation"
record outpu for
G to disconnect.
k

P504-AA
12-06-01

Key: G denotes the scheduled record generation time.

Figure 7-1. Long Duration Call Sample


For inter-network calls, the requirements for intra-network calls apply.
The following requirements for carrier elapsed time recording also apply.
1. Long duration connection requirements (1 8 above) must be
applied to inter-network calls.
2. First record of a long duration connection for an inter-network
call must be generated at the first scheduled record generation
time after the carrier elapsed time (instead of elapsed time) of
the connection exceeds 1440 minutes.
3. First record for an inter-network call must be generated as a
conventional record that must contain Carrier Connect Date,
Carrier Connect Time, and Carrier Elapsed Time fields, except
the Timing Indicator field must contain a 1 in character 3,
indicating a start of a long duration connection.
4. Carrier Elapsed Time field of the first record for an internetwork call must be equal to the interval from carrier connect
time to the time when the record is generated.
7-10

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-300-200

5. Determinate inaccuracy compensation and the variable


inaccuracy allowance must be applied to duration time
determination made for the Carrier Elapsed Time field in the
first record for an inter-network call.
6. Continuation record of a long duration connection for an internetwork call must contain Carrier Connect Date and Carrier
Connect Time fields which must include the date and time of
the original call set up, and Long Duration Connection Module
(Present Day and Present Time fields).
7. Timing Indicator field of a continuation record for an internetwork call must contain a 2 in character 3, indicating a
continuation record.
8. Carrier Elapsed Time field for a continuation record for an
inter-network call must be the interval from the time when the
previous record was generated to either the time the current
record is generated or the time the call disconnects.
Forward changes in time (for example, 11:30 p.m. to 12:30 a.m. of the
next day with midnight as the record generation time) and backward
changes in time (for example, 12:30 a.m. to 11:30 p.m. of the preceding
day), can span record generation time.
When a forward change in time spans a record generation time, the switch
must generate all records that already have an elapsed time (or carrier
elapsed time) exceeding 1440 minutes. Also, the switch must generate all
continuation records that would have occurred at the spanned record
generation time.
An exception occurs when the forward change in time that spans a record
generation time follows a backward change in time that spanned the same
record generation time. In this case, records should not be generated.
When a backward change in time spans a record generation time, the
switch must not generate any first and continuation records at the record
generation time following the time change.
AMA data should be generated for a long duration connection as
described in the following example.
A call originates at 8:00 p.m. on day 1 and disconnects at 2:00 p.m. on day
4. The time designated by the LEC for record generation each day is 3:00
a.m. At 3:00 a.m. on the second day, no record is generated because the
elapsed time is still less than 1440 minutes. Three records should be
generated as follows:

Telica, Inc.

7-11

AMA Lite Reports

Issue 2, January 12, 2004


1. The first record is generated at 3:01:10 a.m. on the third day,
with an elapsed time of 1861 minutes, 10 seconds. The record
is generated after the scheduled record generation time due to
processing or scheduling delays in the switch.
2. The first continuation record is generated at 3:02:00 a.m. on the
fourth day with an elapsed time of 1440 minutes, 50 seconds,
which is the interval from 3:01:10 a.m. of the third day to
3:02:00 a.m. of the fourth day. Again, the switch had
processing or scheduling delays, causing the record to be
generated after the scheduled record generation time.
3. The second continuation record is generated at disconnect at
2:00:00 p.m. on the fourth day with an elapsed time of 658
minutes, 0 seconds.

7.3.3 Module 025, Circuit Release Module


This module contains the fields necessary to identify the date and time of
circuit (or trunk) release.
If this module is included in a BAF record format generated for intranetwork calls on which the called party off-hook is not detected, the
Circuit Date and Time fields indicate the date and time of circuit (or trunk)
release. The Called Party Off-Hook Indicator field contains a 1
(indicating called party off-hook is not detected). The Elapsed Time field
is set to 0 and the Connect Date and Time fields indicate the time of
circuit (or trunk) seizure.
This module is not used with carrier access calls, nor should it be used
with Operator Services System (OSS) calls.
7.3.4 Module 027, Business Customer ID Module
This module is included in a record when, as a result of the service, the
record must contain a business customer identification. The Business
Customer Identification is populated in the Business Customer
Identification field (right-justified) and unused characters are populated
with zeroes.
This module can be used, for example, with Private Virtual Network
(PVN) calls. The Business Customer ID module is included in the BAF
record if the response message from the Service Control Point (SCP)
contains a Business Customer Identification number. If a Business
Customer Identification number is not included in the response message,
the Business Customer Identification Module is not included in the record.

7-12

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-300-200

In an AIN BAF record, the Business Customer ID Module is recorded


instead of this module when the response message from the SCP to the
SSP contains an AMA sequence number parameter in addition to the
AMA Business Customer ID parameter.
7.3.5

Module 029, Alternate Billing Number Module


This module is included in a BAF record when an alternate billing number
is needed. This billing number populates the Alternate Billing Number
field, is right-justified, and unused characters are populated with zeroes.
This module can be used, for example, with PVN calls. The Alternate
Billing Number module is only included in the BAF record for a PVN call
if the response message from the SCP contains a billing number.
In an AIN BAF record, the Alternate Billing Module is recorded instead of
this module when the response message from the SCP to the SSP contains
an AMA Sequence Number parameter in addition to the AMA Alternate
Billing Number parameter.

7.3.6 Module 040, Digits Module


This module is used to record digits used during an AIN call. Up to 24
significant digits can be recorded. This module is only appended to
Structure Codes 0220 and 0221, and it may be repeated in the same AMA
record.
The Digits Module is recorded instead of this module when recording
SCP-provided digits and the response message from the SCP to the SSP
also contains an AMA Sequence Number parameter.
7.3.7 Module 049, Calling Name/Number Delivery Module
This module provides the Count of Name-Only and Count of NumberOnly fields. The Count of Name-Only field counts the number of times a
calling name appears in the information delivered to the customer. For
each count, an "anonymous" or "unavailable" indication is sent in place of
the calling number. - The Count of Number-Only Deliveries field counts
the number of times a calling number appears in the information delivered
to the customer. For each count, an "anonymous" or "unavailable"
indication is sent in place of the calling name.

Telica, Inc.

7-13

AMA Lite Reports

Issue 2, January 12, 2004

7.3.8 Module 68, Called Directory Number (DN) Descriptor


This module contains one field that describes the special billing potential
of the called Directory Number (DN). If the called DN requires special
treatment by the Revenue Accounting Office (RAO) in the billing process,
this module will be appended to the Automatic Message Accounting
(AMA) data structure normally generated for that call. Examples of
features that use this module are the CLASS features Automatic Callback
(AC) and Automatic Recall (AR).
7.3.9

Module 101, Digits Dialed Module


This module is currently used in Message Detail Recording (MDR).
When the actual number to which the call is routed differs from the
number dialed by the originator of the call (as seen at the switching system
at which the MDR data record is generated), the actual digits received on
the originating facility populate the digits dialed fields. The Access Code
for private network calls (i.e., Tie Trunk calls) contains the digits dialed to
indicate the particular type of call (e.g., a code dialed for Wide Area
Telecommunications Service (WATS) access). The dialed Access Code is
right-justified in Table 803 and unused characters are filled with zeros. For
public network calls dialed using prefix digits for access to the public
network (i.e., "dial 9" calls), the prefix digits dialed before the public
directory number populate the Access Code field, are right-justified, and
unused characters are filled with zeros.

7.3.10 Module 102, Authorization Code Module


This module is used to provide Message Recording Detail (MDR). If an
authorization code is received on a call using the Authorization Codes for
the Automatic Flexible Routing (AFR) feature, the Authorization Code
digits populate Table 126. If the dialed Authorization Code exceeds 15
digits, only the first 15 digits dialed populate this field. If the code
contains fewer than 15 digits, it is right-justified, and unused characters
are filled with zeros.
7.3.11 Module 103, Account Code/Customer Dialed Account Recording (CDAR)
Module
This module contains account code or Customer-Dialed Account
Recording (CDAR) information. If both the account and CDAR features
are used on the same call, the account code information populates the
module, not the CDAR information. Account code information is similar
to CDAR information except for the point in the customer dialing pattern
when the account code/CDAR information is provided.

7-14

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-300-200

7.3.12 Module 104, Trunk Identification Module


This module captures trunk identification information for incoming and
outgoing calls. Module 104 appears when a trunk-side connection occurs.
For example, if a call originates from a PRI and routes out over an SS7
trunk, one module 104 will appear on the record with the SS7 trunk
information. If the call is switched from one SS7 trunk to another SS7
trunk, two module 104s will appear on the record with the incoming and
outgoing trunk information. If a call originates PRI and terminates via
PRI from the same switch, no module 104 appears on the record.
7.3.13 Module 105, Message Detail Recording (MDR)
This module is included in every Message Detail Recording (MDR)
record. The MDR customer for whom the MDR data is intended is
uniquely identified in Table 87. The facility types in Table 246 are
recorded from the perspective of the switch that is creating the MDR data
record.
7.3.14 Module 164, E.164/X.121 Number Module
This module provides the means to record lengthy numbers that cannot be
recorded in the structure applicable to the call. Refer to section 7.4,
Module Number 164, for details concerning module 164.
7.3.15 Module 198, Flex Module
This module is used to hold a field that has a variable length. Table 575 is
a context identifier (i.e., originating address, terminating address) that
defines the tables that follow Table 575.
7.3.16 Module 264, Quality of Service (QoS) (NDGR)
Module Code 264 is used to record the Network Latency and Inter-arrival
jitter that are associated with Quality of Service (QoS). It includes the release
cause indicator, the number of packets sent, the number of packets
received, the number of packets lost, the number of octets sent, the
number of octets received, the inter-arrival jitter and the amount of
network latency.
7.3.17 Module 306, Originating Line Information Parameter (OLIP)
This module identifies the class of service of the originating line. It can
also be used to record a unique class of service that can identify various
services offered by Local Exchange Carriers (LECs).
7.3.18 Module 611, Generic Module
This is a generic, general-purpose module. The Generic Context Identifier
field (Table 237) defines the parsing rules and the type of data to be stored
in the Digits String field (Table 126).

Telica, Inc.

7-15

AMA Lite Reports

Issue 2, January 12, 2004

7.3.19 Module 612, Generic Module: Two Digits String Format


This module is a generic, general-purpose module used when the
requirements of the application fit the format of this layout. The Generic
Context Identifier field, (Table 237) defines the number of characters in
the Digits String 1 (Table 126) and Digits String 2 (Table 126) fields. The
Digits String fields identify the IOM typeand slot.
7.3.20 Module 613, Generic Module: Three Digits String Format
This module is a generic, general-purpose module used when the
requirements of the application fit the format of this layout. The Generic
Context Identifier field (Table 237) defines the number of digits to be
stored in the Digits String 1 (Table 126), Digits String 2 (Table 126) fields
and Digits String 3 (Table 126). The Digit String 1 and 2 fields are used
to identify IP addresses and Digit String 3 is used to identify the local and
remote ports, the Codec and the Fax indicator.
7.3.21 Module 616, 5 Digit Information Module
This module is a general purpose, vendor specific, 5 digit information
module.
7.3.22 Module 719, Local Number Portability (LNP) Core Module
This module provides the LRN when applicable for calls in the LNP
environment. Module 719 is now obsolete. Telica has replaced it with
Module 720.
7.3.23 Module 720, Local Number Portability (LNP) Module
This module is used to convey information pertinent to rating and billing
of calls to and/or from ported numbers in environments with LNP.

7.4

Module Number 164


The E.164/X.121 Number Module (Module Code 164) defines specific
information gathered from the CDR, only if the CDR call type and call
conditions dictate that Module 164 needs to be appended to the CDR.
The term call is used in this section to indicate a subscribers access
to a system that potentially causes generation of a BAF record.
Calls could be, for example, Plain Old Telephone Service (POTS)
calls or data link access to a computer.

7-16

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-300-200

Specifically, Module 164 and its associated BAF tables (fields) enable the
AMA Billing Server to record longer length addresses. The module is
appended to the CDR in accordance with the BAF data structures when
conditions of the call require recording longer length addresses than the
structures can accommodate. The current international E. 164 number
format records numbers of up to 12 digits. The module includes X.121 in
case it is necessary to record long length data network addresses.
Module 164 must be appended to the BAF structure being generated when
either (or both) of the following conditions are met:
The originating number to be recorded in the originating
number field (defined in section 8.3.1, R1-50) exceeds 10
digits. If it is 10 or fewer digits (not including incoming
international calls), it is recorded in the originating number
fields of the structure and the module is not appended.
The terminating number to be recorded in the terminating
number fields (section 83.1, R1-50) exceeds 12 digits. If it is
12 or fewer digits, it is recorded in the terminating number
fields of the structure and the module is not appended.
Module 164 must contain the following ordered list of fields:

7.4.1

Module Code
Number Identify
Country Code or Data Network Identification Code
Significant Digits in the Next Field(s)
Number

E.164 Numbering Plan


The E.164 numbering plan, as derived from ITU-T Recommendation
E.164 and TR-TSY-000448, defines the currently used structure of an
international telephone number. According to Recommendation E.164,
such numbers follow the CC+N(S)N format where:
CC= Country Code Identifies the destination country and can
vary between 1 and 3 digits.
N(S)N = National (Significant) Number Identifies the destination
termination, and the maximum N(S)N length is 11 digits.
CC+N(S)N = maximum of 12 digits.
The above applies until Time T (year-end 1996). After that, CC+N(S)N
will be a maximum of 15 digits, which results in a maximum N(S)N of 14
digits since no changes are planned for the structure of a CC.

Telica, Inc.

7-17

AMA Lite Reports

Issue 2, January 12, 2004

The North American Numbering Plan (NAPN) is the numbering plan


currently used in the United States. It meets the requirements set forth in
the ITU-T Recommendation E.164.
7.4.2

X.121 Numbering Plan


The International Numbering Plan for Public Data Networks (PDNs) is
documented in ITU-T-Recommendation X.121. An international
/internetwork data number consists of the Data Network Identification
Code (DNIC) followed by the Network Terminal Number (NTN). The
DNIC consists of a three-digit Data Country Code (DCC) followed by a
network digit. DCCs are ITU-T administered; however, they are not the
same country codes specified in Recommendation E.164. The DCC
identifies a country; the network digit identifies a specific data network
within the country identified by the DCC. The DCC in conjunction with
the network digit can identify up to ten PDNs. Multiple DCCs may be
assigned to a country where more than ten PDNs exist. Recommendation
X.121 specifies a maximum length of ten digits for the NTN. No
minimum NTN length is specified. The format of the NTN is determined
by the network provider that is identified by the DNC. Although the most
commonly discussed usage of the X.121 numbering plan is in connection
with packet data networks, the plan is also applicable to circuit-switched
data networks that may choose to use it. X.121 numbers are included in
the E.164/X.121 Number Module (Module Code 164) to cover the
possibility of a future increase in length of NTN.

7.4.3

Generation of Module 164


Module 164 is used when the originating and/or terminating number
contains too many digits to record in the BAF structure associated with the
call. Module 164 is also used when the system cannot determine the
Country Code form the originating number information, regardless of the
length of the originating number. The module only records one number,
so if both originating and terminating number contain too many digits for
conventional recording, two modules should be appended one for the
originating number and one for the terminating number.
The Network Element (NE) generates Module 164 and appends it to the
BAF structure generated for a call when the following conditions exist:
The originating number to be recorded in the originating
number fields exceeds 10 digits. The originating number fields
this requirement refers to are BAF Tables 13, 14, 172 and 173,
listed in GR-1100-CORE.

7-18

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-300-200

The originating number to be recorded is for an incoming


international call. Module 164 is used regardless of the length
of this number.
The terminating number to be recorded in the terminating
number fields exceeds 12 digits. The terminating number
fields this requirement refers to are BAF tables 15, 16, 17, 174,
and 175, listed in GR-1100-CORE.

7.5

Call Types, Structure Codes, and Modules


A call type, together with a call type code, represents the
service/technology provided to a customer or carrier. The call type code
in a BAF record provides guidance to accounting systems for processing
the record. Call types are determined by the type of service.
A structure is a set of eight common data fields, followed by a group of
fields required by the type of service or technology for which the data are
recorded. Each structure is a unique, ordered set of fields identified by a
structure code (the third data field in the AMA master record). Every
BAF structure contains a common set of eight data fields. Structure codes
are determined by call type.
In Table 7-G, all data fields for each particular structure code are listed.
The eight common data fields, common to every structure code, are listed,
but they will not be included in the Structure Code Fields column in
Table 7-G. Therefore, a structure code listed in Table 7-G contains all
data fields listed in the Structure Code Fields column for that structure
code, as well as the eight common data fields provided in the following
list. The letter appearing beside most entries listed identifies which field
description to reference in the lettered list in section 5, AMA-Format
Master Record Field Descriptions, of this document.
The eight common data fields shared by most structure codes are:

Telica, Inc.

Record Descriptor Word


Hexadecimal Identifier
Structure Code (b)
Call Type (a)
Sensor Type (c)
Sensor Identification (d)
Recording Office Type (e)
Recording Office Identification (f)

7-19

AMA Lite Reports

Issue 2, January 12, 2004

Modules are predefined sets of data fields that may be appended to a


structure according to the service/technology rendered, or to report
information connected with specific conditions. Modules are often
referred to by their code number. Modules have fixed names that indicate
the meaning of the data they contain or the service or capability for which
they are used. They are determined by the call type and the conditions of
the call. Modules are appended to the end of the record, after the structure
code fields.

7.6

Configuration and Operation


To use the AMA Lite or BTS successfully with the Plexus 9000, you must
first meet specific AMA Lite server platform requirements and then
configure the AMA Lite or BTS on the Sun server to communicate with
the Plexus 9000, and configure the Plexus 9000 to communicate with the
AMA Lite or BTS. The procedures (NTP-031) for configuring the billing
and the Plexus 9000 are found in volume 2 of the Plexus 9000 Installation
and Operation Manual.

7-20

Telica, Inc.

Table 7-G. Call Types, Modules and Structure Code 0625


Call Types, Modules and Structure Code 0625 (5 pages)
Call
Type
110

Call Type Name

Mod.

Inter-LATA
Station Paid

021,
104,
164,
720

Module Fields and Field Ref. #


for Sect. 6
021 - Module Code ID,
IC/INC Prefix,
Carrier Access Date (tt),
Carrier Access Time (uu),
Elapsed Time (vv),
IC/INC Call Event Status (ww),
Trunk Group Number (xx),
Routing Indicator (yy),
Dialing and Presubscription Indicator (zz),
ANI/CPN Indicator (aaa)
104 Module Code ID,
Trunk ID
164 Module Code,
Number Identity (rrr),
Country Code or Data Network ID Code (ttt),
Significant Digits in Next Field(s) (uuu),
Number (vvv)
720 Module Code ID,
Party ID (zzz),
Location Routing Number (LRN) (xxx),
Service Provider Identity (bbbb),
Location (cccc),
Supporting Information (dddd)

Structure Code Fields


Eight common data fields,
Connect Date (g),
Timing Indicator (h),
Study Indicator (i),
Called Party Off-hook Indicator (j),
Service Observed/Traffic Sampled (k),
Operator Action (l),
Service Feature (m),
Originating NPA (n),
Originating Number (o),
Overseas (International Call) Indicator (p),
Terminating NPA (q),
Terminating Number (r),
Connect Time (s),
Elapsed Time (t),
IC/INC Prefix (u),
Carrier Connect Date (v),
Carrier Connect Time (w),
IC/INC Call Event Status (y),
Trunk Group Number (z),
Routing Indicator (aa),
Dialing and Presubscription Indicator (bb),
ANI/CPN Indicator (cc)

Calling Pattern
(Based on Call Type)
1+NXX+ XXXX,
0-,
0+NXX+ XXXX,
1+ NPA+555+ 1212,
101XXXX+ 0+,
101XXXX+00-,
101XXXX+ 0/1+
(originating),
101XXXX+ 01/011+
(orig),
01/011+7 to 18-digit,
800 call (non-SSP),
1+500+7-digits,
1+700+7-digits,
1+900+7-digits

7-21

Call Types, Modules and Structure Code 0625 (5 pages)


Call
Type
119

7-22

Call Type Name

Mod.

Terminating
Access Record

021,
104,
164,
720

Module Fields and Field Ref. #


for Sect. 6
021 - Module Code ID,
IC/INC Prefix,
Carrier Access Date (tt),
Carrier Access Time (uu),
Elapsed Time (vv),
IC/INC Call Event Status (ww),
Trunk Group Number (xx),
Routing Indicator (yy),
Dialing and Presubscription Indicator (zz),
ANI/CPN Indicator (aaa)
104 Module Code ID,
Trunk ID
164 Module Code,
Number Identity (rrr),
Country Code or Data Network ID Code (ttt),
Significant Digits in Next Field(s) (uuu),
Number (vvv)
720 Module Code ID,
Party ID (zzz),
Location Routing Number (LRN) (xxx),
Service Provider Identity (bbbb),
Location (cccc),
Supporting Information (dddd)

Structure Code Fields


Eight common data fields,
Connect Date (g),
Timing Indicator (h),
Study Indicator (i),
Called Party Off-hook Indicator (j),
Service Observed/Traffic Sampled (k),
Operator Action (l),
Service Feature (m),
Originating NPA (n),
Originating Number (o),
Overseas (International Call) Indicator (p),
Terminating NPA (q),
Terminating Number (r),
Connect Time (s),
Elapsed Time (t),
IC/INC Prefix (u),
Carrier Connect Date (v),
Carrier Connect Time (w),
IC/INC Call Event Status (y),
Trunk Group Number (z),
Routing Indicator (aa),
Dialing and Presubscription Indicator (bb),
ANI/CPN Indicator (cc)

Calling Pattern
(Based on Call Type)
Terminating exchange

Call Types, Modules and Structure Code 0625 (5 pages)


Call
Type
710

Call Type Name


Originating Toll
AMA Recording
(Vendor Specific)

Mod.

Module Fields and Field Ref. #


for Sect. 6

Structure Code Fields

Calling Pattern
(Based on Call Type)

Eight common data fields,


Connect Date (g),
Timing Indicator (h),
Study Indicator (i),
Called Party Off-hook Indicator (j),
Service Observed/Traffic Sampled (k),
Operator Action (l),
Service Feature (m),
Originating NPA (n),
Originating Number (o),
Overseas (International Call) Indicator (p),
Terminating NPA (q),
Terminating Number (r),
Connect Time (s),
Elapsed Time (t),
IC/INC Prefix (u),
Carrier Connect Date (v),
Carrier Connect Time (w),
IC/INC Call Event Status (y),
Trunk Group Number (z),
Routing Indicator (aa),
Dialing and Presubscription Indicator (bb),
ANI/CPN Indicator (cc)

7-23

Call Types, Modules and Structure Code 0625 (5 pages)


Call
Type
720

7-24

Call Type Name

Mod.

Connecting
Network Access
Incoming Record

021,
104,
164,
720

Module Fields and Field Ref. #


for Sect. 6
021 - Module Code ID,
IC/INC Prefix,
Carrier Access Date (tt),
Carrier Access Time (uu),
Elapsed Time (vv),
IC/INC Call Event Status (ww),
Trunk Group Number (xx),
Routing Indicator (yy),
Dialing and Presubscription Indicator (zz),
ANI/CPN Indicator (aaa)
104 Module Code ID,
Trunk ID
164 Module Code,
Number Identity (rrr),
Country Code or Data Network ID Code (ttt),
Significant Digits in Next Field(s) (uuu),
Number (vvv)
720 Module Code ID,
Party ID (zzz),
Location Routing Number (LRN) (xxx),
Service Provider Identity (bbbb),
Location (cccc),
Supporting Information (dddd)

Structure Code Fields


Eight common data fields,
Connect Date (g),
Timing Indicator (h),
Study Indicator (i),
Called Party Off-hook Indicator (j),
Service Observed/Traffic Sampled (k),
Operator Action (l),
Service Feature (m),
Originating NPA (n),
Originating Number (o),
Overseas (International Call) Indicator (p),
Terminating NPA (q),
Terminating Number (r),
Connect Time (s),
Elapsed Time (t),
IC/INC Prefix (u),
Carrier Connect Date (v),
Carrier Connect Time (w),
IC/INC Call Event Status (y),
Trunk Group Number (z),
Routing Indicator (aa),
Dialing and Presubscription Indicator (bb),
ANI/CPN Indicator (cc)

Calling Pattern
(Based on Call Type)

Table 7-H. Plexus 9000 AMA Record Mapping to Telcordia GR-1100


Field Description

#
table
Char.
#

Record Descriptor Word

000

0001 0020
X
X

0027
X

0028
X

0079
X

0220
X

0360
X

0364
X

0500
X

Structure Code
0625 0631 0645
X
X
X

0653
X

0656
X

0664
X

9003
X

0110
X

1030
X

0614
X

0096
X

Hexadecimal Identifier

00

Structure Code

Call Type Code


Sensor Type
Sensor Previous Output Ind

4
4

1
2

X
X

X
X

X
X

X
X

X
X

X
X

X
X

X
X

X
X

X
X

X
X

X
X

X
X

X
X

X
X

X
X

X
X

X
X

X
X

X
X

Sensor Identification

Recording Office Type


Recording Office Previous
Output Ind
Recording Office Identification

Connect Date [3]

Connect Time

18

Timing Indicator [3]

Study Indicator[7]
Called Party Off-Hook
Indicator
Service Observed/Traffic
Sampled
Operator Action

10

11

Service Feature

12

Originating NPA [2]

13

Originating Number [4]

14

Dialed NPA [2]

13

Dialed Number [4]


Destination Overseas
(International Call) Indicator
Destination Number Plan
Area (NPA) [3]
Destination Number [4]

14

15

16

17

Elapsed Time

10

19

IC/INC Prefix [3]

57

Carrier Connect Date [3]

7-25

Field Description

#
table
Char.
#

0001 0020

0027

0028

0079

0220

0364

0500

Structure Code
0625 0631 0645
X
X
X

Carrier Connect Time [4]

18

0360
X

0653
X

0656
X

Carrier Elapsed Time

10

19

IC/INC Call Event Status

58

Trunk Group Number

83

Routing Indicator
Dialing And Presubscription
Indicator
ANI/CPN Indicator
Revenue Accounting Office
(RAO) Number
Local Access Transport Area
(LATA)
WATS Indicator
Wats Band or Message billing
Index
WATS Administration

59

85

60

46

197

28

29

30

Data Capabilities Indicator


Information Transfer Rate
Indicator
Terminating Company

41

42

56

Completion Indicator

280

Service Logic Identification [5]

10

77

Numbering Plan Area (NPA)

Directory Number

0664

9003

0110

1030

0614

0096

13

14

Usage count

130

Date

Time

18

Class Feature Code


Call Count -Information
delivered
Call Count -Information
Anonymous/Unavailable
Activating NPA

415

803

803

13

Activating Number

14

Far-end Overseas indicator

15

trunkGroupSigTypeInd

7-26

Telica, Inc.

Field Description

#
table
Char.
#

1030
X

0614

0096

17

330

CLASS Feature status


Screening list size of selective
call forwarding or selective
call acceptance
screening list size of selective
call rejection
screening list size for
distinctive ringing/call waiting
forward to overseas Indicator

331

802

802

802

15

forward to NPA
forward Number

16

17

activation date

18

activation time

18

deactivation date

deactivation time

18

Far-end Number
CLASS Functions

0027

0028

0079

0220

0360

0364

0500

Structure Code
0625 0631 0645

16

Far-end NPA

0001 0020

7-27

0653

0656

0664

9003

0110

7-28

Telica, Inc.

8.

Traffic Statistics Reports

8.1
8.2

Introduction ..........................................................................................................8-1
Types of Statistics and Reports ............................................................................8-2
8.2.1 Types of Statistics ....................................................................................8-2
8.2.2 Types of Reports ......................................................................................8-3
8.2.2.1 Busy Hour ....................................................................................8-3
8.2.2.2 Peg Counts....................................................................................8-5
8.2.2.3 Trunk Group Hold Time ............................................................8-10
8.2.2.4 Traffic Centum Call Seconds (CCS)..........................................8-11
8.2.2.5 ASCII CDR Report ....................................................................8-22
8.2.2.6 ASR Report ................................................................................8-27
Installation and Configuration............................................................................8-29
8.3.1 Platform Requirements...........................................................................8-29
8.3.1.1 TCA Server Platform Requirements ..........................................8-29
8.3.1.2 BTS Server Platform Requirements...........................................8-29
8.3.2 Configuration .........................................................................................8-29
8.3.2.1 TCA............................................................................................8-29
8.3.2.2 BTS.............................................................................................8-30

8.3

8.1

Introduction
The PlexView Traffic Collection Application (TCA) and the PlexView
Billing and Traffic System (BTS) work in conjunction with the Plexus
9000 to capture information about every call, and to process that
information into statistical data. The statistical data is tracked for busy
hour information, peg counts, trunk group hold time, and traffic Centum
Call Seconds (CCS).
Up to eight Plexus 9000 switches can use the TCP/IP protocol to send a
Call Detail Record (CDR) for each attempted call to the BTS or to the
TCA via the Telica Statistical Data Server (TSDS). The TSDS stores this
information in binary format on the TCA server.
The Telica Statistical Analysis Application (TSAA) then extracts the
necessary information from the CDR and updates the call statistics and
traffic measurements accordingly, writing it to output text files, and
storing it on the server. The TSAA also works with the Billing and Traffic
System for Plexus software version 3.8 or greater.

Traffic Statistics Reports

8.2

Issue 3, January 9, 2003

Types of Statistics and Reports


The Plexus 9000 provides two methods in which to retrieve statistics:

Internally, by use of TL1 commands, for statistics maintained on


the Plexus.

Externally, via automatic processing, from per call records that are
sent from the Plexus to an adjoining TCA application.

Each day a new output directory - STATS_yyyymmdd is created under


tsaa output directory. And five subdirectories CDR, BusyHour,
CCSReport, HoldTime and PegCount- are created for each report type.
(i.e., tsaa_<prefix>/Stats_20020301/ Busyhour/). Each report file is
created at the end of their Granularity period (configured in
tsaa_<prefix>.conf file), except Busy Hour report. Busy Hour report is
created at the beginning of next day (15 past midnight).
At any time during the process, you can open a previously existing peg
count, busy hour, traffic CCS, trunk group hold-time, or CDR file to view
and analyze the associated data.
8.2.1

Types of Statistics
Detailed statistics are available with the TCA and include:

8-2

Peg counts of calls on each ISDN interface, directory number


(DN), and trunk group number

Peg count of resulting call state (answered, ringing, busy, not


completed)

Peg count of incoming and outgoing calls

Number of provisioned circuits

Busy Call Hour for each ISDN interface, directory number, and
trunk group number

Erlang B calculations for each ISDN interface, directory number,


and trunk group number

Average hold time for each trunk group

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-300-300

8.2.2 Types of Reports


The TCA captures the statistics into these five types of files:

8.2.2.1

Busy hour information

Peg counts

Trunk group hold time

Traffic CCS
By Trunk Group
By ISDN Interface
By GR303 Interface
By CAS Trunk Group
By SIP Trunk Group
By BICC Trunk Group

ASCII CDR reports

Busy Hour

8.2.2.1.1 Busy Hour Report


Busy hour information is necessary for sizing your trunk groups and ISDN
interfaces. The PlexView TCA captures busy hour records that contain
utilization expressed in Erlangs; trunk justification based on usage of the
group (Erlang B algorithm); and utilization expressed as a decimal. Busy
hour information is calculated to a 30-minute level of granularity, which is
the recommended and default setting. Busy hour reporting can be disabled
by setting Busy Hour Granularity to 0 in the tsaa_<prefix>.conf.file.
Busy hour parameters are captured based on the following criteria:

All incoming trunks to a Plexus 9000 (daily usage of the system)

Trunks groups (SIP, CAS, BICC and SS7) ))

ISDN and GR303 interfaces

Directory numbers (Optional) This is not supported in version


2.0.0.61 and above.

For each item listed above, the following information is calculated:

Telica, Inc.

Utilization expressed in Erlangs

Trunk justification based on usage on the group (Erlang B


algorithm)

Utilization expressed as a decimal

8-3

Traffic Statistics Reports

Issue 3, January 9, 2003

8.2.2.1.2 Busy Hour Output


The Busy Hour file contains all the busy hour information for the day.
The naming convention for the file is:
<prefix>_STATS_BUSY_HOUR_yyyymmdd.txt
where <prefix> is the prefix defined in the tsaa_<prefix>.conf file, and
yyyymmddhhmm is the reported year/month/day. The format for this file
is:
version,month,day,year,hour,min,record_type,value,name,erlangs,
circuits,utilization
A sample of what the output would actually look like is provided below.
Field descriptions follow.
Sample Output (generated by Plexus 9000):
Boston_STATS_BUSY_HOUR_200201032200.txt
1.0,2,13,2001,15,55,4,1,NONAME,14.21,23,0.6180
1.0,2,13,2001,15,55,5,1234554321,NONAME,14.21,23,0.5922
1.0,2,13,2001,15,55,6,1,boston,14.21,23,0.5922
1.0,2,13,2001,0,0,7,0,NONAME,14.21,23,0.5922

Fields:
version

Specifies the version of the application on the Plexus.

month, day, year, hour, min Describes the date and time of the record.
record_type Has the following values:

value

8-4

4 = busy hour info ISDN interface


5 = busy hour info directory number
6 = busy hour info SS7 trunk group
7 = busy hour info system (over the course of an entire
day, during non-busy hours, for the entire system)
8 = busy hour info CAS trunk group
9 = busy hour info BICC trunk group
10 = busy hour info CAS interface
The record_types value (i.e., ISDN interface ID, trunk
group number, etc.).

name

The name of the trunk group for SS7 and CAS trunk
groups, name of the interface for CAS interface,
NONAME for ISDN, directory number, and system.

erlangs

The Erlang calculation (refer to Traffic Collection


Application section of this manual for details).

circuits

The number of circuits

utilization

The decimal percentage of circuit usage (usage in minutes


divided by total number of circuits multiplied by 60).

Telica, Inc.

Billing and Traffic Collection Guide

8.2.2.2

Section 150-300-300

Peg Counts

8.2.2.2.1 Peg Counts Report


To further monitor call delivery, TCA updates peg counts to capture the
disposition of every call per trunk group (SS7, SIP, BICC and CAS, ISDN
and GR303) interfaces and outgoing directory number. The disposition
identifies if the call was answered, ringing (no answer), busy, not
completed or in-coming.
Detailed peg count reports are generated if the Detailed Peg Report
value in the tsaa_<prefix>.conf file is set to 1. When peg count reports
are not detailed, the state field will show states. When peg count reports
are detailed, the state field will show cause codes. In addition, statistics
for the circuit state will be included in each peg count record and will
provide the number of circuits provisioned for traffic. This is calculated
when the record is produced.
Based on the configuration, files can be produced on one of the following
intervals:

Every 15 minutes
Every 30 minutes
Every 1 hour
Every 24 hours

The following information is calculated for every record when the nondetailed output option is chosen:
ISDN
Interface
Incoming

Outgoing

Circuit
States

Telica, Inc.

Directory
Number (route)

Trunk
Group

Answered
Ringing
Busy
Not completed
In Progress
Answered
Ringing
Busy
Not completed
In Progress
Total Circuits
Provisioned

8-5

Traffic Statistics Reports

Issue 3, January 9, 2003

8.2.2.2.2 Peg Counts Output


Peg counts are reported for every ISDN interface, directory number, trunk
group and cause code in the system. The naming convention for the file
is:
<prefix>_STATS_PEG_COUNT_yyyymmddhhmm.txt
where <prefix> is the prefix defined in the tsaa_<prefix>.conf file, and
yyyymmddhhmm is the reported year/month/day/hour/minute.
The format for this file is:
version,month,day,year,hour,min,record_type,type_id,mode,state,
medium,value,peg_count,circuits
A sample of what the output would actually look like is provided below.
Field descriptions follow.
Sample Output (generated by Plexus 9000):
Boston_STATS_PEG_COUNT_200201032200.txt
1.0,3,7,2002,0,0,1,1,2,16,1,4001,48,671
1.0,3,7,2002,0,0,1,2,2,16,1,5084800001,48,671
1.0,3,7,2002,0,0,1,3,1,16,1,599,48,24
1.0,3,7,2002,0,5,1,1,2,16,1,4001,45,671
1.0,3,7,2002,0,5,1,2,2,16,1,5084800001,45,671
1.0,3,7,2002,0,5,1,3,1,16,1,599,45,24

Fields:
version

Specifies the version of the application on the Plexus.

month, day, year, hour, min Describes the start date and time of the fiveminute reporting interval of the record.
record_type Has the following values:
1 = peg count 5 min period
2 = peg count 1 hour period
3 = peg count 24 hour period
4 = peg count 30 min period
type _id

8-6

Has the following values:


1 = ISDN interface
2 = directory number
3 = SS7 trunk group
4 = CAS trunk group
5 = SIP trunk group
6 = CAS interface
7 = GR303 interface
8 = BICC trunk group
Telica, Inc.

Billing and Traffic Collection Guide


mode

Section 150-300-300

Has the following values:


1 = incoming
2 = outgoing

state

Has the following values if the Detailed Peg Report value


in the tsaa_<prefix>.conf file is set to 0 (Detailed
reporting is disabled).
State Values when Detailed reporting is disabled
0
in progress
16
Answered
17
Busy
18
Ringing
999
not connected
Has the following values (cause codes) if the Detailed Peg
Report value in the tsaa_<prefix>.conf file is set to 1
(Detailed reporting is enabled).
SS7 Cause Codes when Detailed reporting is enabled
0
in progress
1
unassigned number
2
no route to transit network
3
no route to destination
4
send special infomation tone
5
misdialed trunk prefix
16 normal call clearing
17 user busy
18 no user response
19 no answer (user alerted )
21 call rejected
22 number changed
23 unallocated destination number
24 unknown business group
25 exchange routing error
26 Misrouted call to a Ported Number
27 destination out of order
28 Address incomplete
29 facility rejected
31 normal unspecified
34 no circuit/channel available
38 network out of order
41 Temporary failure
42 Switch equipment congestion
44 requested circuit/channel unavailable

Telica, Inc.

8-7

Traffic Statistics Reports

Issue 3, January 9, 2003


SS7 Cause Codes when Detailed reporting is enabled
47 resources unavailable, unspecified
43 user information discarded
45 Preemption
46 precedence call blocked
47 Preemption
50 requested facility not subscribed
51 call type incompatible with service request
54 call blocked due to group restrictions
55 incoming calls barred within CUG
57 bearer capability not authorized
58 bearer capability not available
63 Service or option unavailable
65 bearer capability not implemented
69 requested facility not implemented
70 only restricted digital bear cap is avail*/
79 service or option not implemented
87 Called User Not member of CUG
88 incompatible destination
91 invalid transit network selection
95 invalid message, unspecified
81 invalid call reference value
97 msg type is non-existent or not implemented
99 Param. non-existant, or not impl., discard
110 Param. non-existant, or not impl., discard message
102 timeout recovery
103 Param. non-existant, or not impl. pass along
111 protocol error, unspecified
100 invalid parameter contents
127 interworking unspecified

ISDN Cause Codes when Detailed reporting is enabled


0
in progress
1
unassigned number
2
no route to transit network
3
no route to destination
6
channel unacceptable
7
call awarded and being delivered
9
prefix 1 dialed in error
16 normal call clearing
17 user busy
18 no user response
19 no answer (user alerted )
21 call rejected

8-8

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-300-300

ISDN Cause Codes when Detailed reporting is enabled


22 number changed
24 number unassigned
26 non selected User clearing
27 destination out of order
28 invalid number format
29 facility rejected
30 response to STATUS ENQUIRY
31 normal unspecified
34 no circuit/channel available
35 call queued
38 network out of order
41 Temporary failure
42 Switch equipment congestion
43 access info discarded
44 requested circuit/channel unavailable
47 resources unavailable, unspecified
49 Quality of Service unavailable
50 requested facility not subscribed
52 outgoing calls barred
54 incoming calls barred
57 bearer capability not authorized
58 bearer capability not available
59 call restriction
60 terminal call redirection rejected
62 unathorized service
63 Service or option unavailable
65 bearer capability not implemented
66 channel type not implemented
69 requested facility not implemented
70 only restricted digital bear cap is avail.
79 service or option not implemented
81 invalid call reference
82 channel does not exist
83 susp. call exists, call id is invalid
84 call identity is in use
85 no call suspended
86 call id'd has been cleared
88 incompatible destination
91 invalid transit network selection
92 invalid facility parameter
95 invalid message, unspecified
96 mandatory info element is missing
97 msg type is non-existent or not implemented
98 msg type invalid in call state or not implemented

Telica, Inc.

8-9

Traffic Statistics Reports

Issue 3, January 9, 2003


ISDN Cause Codes when Detailed reporting is enabled
99 info element non-existent or not implemented
100 invalid info element
101 msg type not compatible with call state
102 recovery on timer expiry
103 mssg recvd with mand info elmt of incorrect
length
111 protocol error, unspecified
112 protocol discriminator error
113 bearer service not available
114 end-to-end info transfer impossible
126 entering conversation mode
127 Interworkingpecified

medium

Has the following values:


1 = digital
2 = analog

8.2.2.3

value

Type_ids value (i.e. trunk group #, ISDN Interface, or


Directory Number)

peg_count

The number of peg counts for the value.

circuits

The number of provisioned circuits for the value. This is


not valid for Directory Number or SIP.

Trunk Group Hold Time

8.2.2.3.1 Trunk Group Hold Time Report


This report is generated every fifteen-minutes, every hour or every twentyfour hours as is the Peg Count report. It displays the average hold time for
each trunk group.
For a description and sample of Trunk Group Hold Time output, refer to
8.2.2.3.2.
8.2.2.3.2 Trunk Group Hold Time Output
This report displays the average hold time for all trunks within the trunk
group. The naming convention for the Trunk Group Hold Time is:
<prefix>_STATS_HOLD_TIME_yyyymmddhhmm.txt
where <prefix> is the prefix defined in the tsaa_<prefix>.conf file, and
yyyymmddhhmm is the reported year/month/day/hour/minute. The format
for the Trunk Group Hold Time output is:
version,month, day,year,hour,min,value,hold_time

8-10

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-300-300

A sample of what the output would actually look like is provided below.
Field descriptions follow.
Sample Output (generated by Plexus 9000):
Boston_STATS_HOLD_TIME_021301.txt
1.0,9,4,2001,10,20,1,20
1.0,9,4,2001,10,25,1,5
1.0,9,4,2001,10,30,1,6
1.0,9,4,2001,10,35,1,19
1.0,9,4,2001,10,40,1,101
1.0,9,4,2001,10,45,1,543
1.0,9,4,2001,10,50,1,66
1.0,9,4,2001,10,55,1,22
1.0,9,4,2001,15,55,1,1
1.0,9,4,2001,16,0,1,27
1.0,9,4,2001,16,5,1,43
1.0,9,4,2001,16,10,1,18
1.0,9,4,2001,16,15,1,1
1.0,9,4,2001,16,20,1,21

Fields:
version

Specifies the version of the application on the


Plexus.

month, day, year, hour, min Describes the date and time of the record.

8.2.2.4

value

Trunkgroup ID.

hold_time

The average hold time for the value (in seconds).

Traffic Centum Call Seconds (CCS)

8.2.2.4.1 Traffic CCS Report


The following criteria is used for data collection to generate traffic reports
for Trunk Groups and ISDN Interfaces:

Operational measurements/traffic statistics are gathered on a realtime basis, at the DS0 level.

Traffic statistics are consolidated for a specific trunk group.

Reports are generated as specified in the tsaa_<prefix>.conf file


and are accessible through an automated polling process. A time
stamp is placed on the report, indicative of local time.

Each report indicates trunks in service, trunks that are in a


maintenance busy (or busied-out) status, and total trunks
included on the trunk group.

Note: All time period criteria used to generate Traffic CCS reports are based
on the Plexus 9000 clock, not the Sun server clock.

Telica, Inc.

8-11

Traffic Statistics Reports

Issue 3, January 9, 2003

8.2.2.4.2 Traffic CCS Output


The traffic report is generated as specified in the tsaa_<prefix>.conf file.
The report format parameter the conf file determines the output for this
report. The options and naming conventions for the files are spacedelimited with header and comma-delimited with header.
Space-delimited with header
There are five types of space-delimited with header files:
atsm_<prefix>.yyyymmddhhmm.txt
castg_<prefix>.yyyymmddhhmm.txt
pri_<prefix>.yyyymmddhhmm.txt
siptg_<prefix>.yyyymmddhhmm.txt
gr3_<prefix>.yyyymmddhhmm.txt
bicctg_<prefix>.yyyymmddhhmm.txt
casif_<prefix>.yyyymmddhhmm.txt
Prefix is the hostname; yyyy is the year; mm is the month within the
year; dd is the day of the month; hh is the hour of the day; and mm is the
minute of the hour.
Samples of what the outputs would actually look like are provided on
following pages. Field descriptions follow.
Sample of atsm, bicctg and castg Space-delimited with Header Report:
Format is common for atsm_<prefix>.yyyymmddhhmm.txt,
bicctg_<prefix>.yyyymmddhhmm.txt and
castg_<prefix>.yyyymmddhhmm.txt
BOSTON 03/04/2002 17:15:00
Start 05/21/2002 23:00:00 Stop 05/22/2002 00:00:00
TGPNUM TGPNAM TOTTRK AVLTRK MNTTRK PRECUTTRK INCCNT
OUTCNT TOTCNT OFLCNT INCCCS OUTCCS TOTCCS
1 TRUNKGROUP1 36 24 12 12 0 2053 2053 1540 0 414 414
2 TRUNKGROUP2 12 12 0 0 0 1547 1547 0 0 310 310
3 trkgrp3 48 48 0 0 3600 0 3600 0 724 0 724

Fields for atsm, bicctg and castg Space-delimited Reports:


Switch Name Name of the switch

8-12

Start/Stop

On-the-hour start and stop times.

TGPNUM

Trunk group number.

TGPNAM

Trunk group name

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-300-300

TOTTRK

Total trunks available (All provisioned trunks including


those that have not been turned up for service and those
that are in a maintenance state.).

AVLTRK

Available trunks (All cut trunks (in-service and out-ofservice) but not including pre-cut. Supported in releases
3.1.1.3X and 3.6 or greater.

MNTTRK

Maintenance trunks (Trunks in a maintenance state either


by an operator or abnormal circumstances). Supported in
releases 3.1.1.3X and 3.6 or greater.

PRECUTTRK Number of trunks that are precut (trunks not turned up


for service). Supported in releases 3.1.1.3X and 3.6 or
greater.
INCCNT

Incoming peg count indicates the number of times the


trunk was seized.

OUTCNT

Outgoing peg count indicates the number of times the


trunk was seized attempted to terminate.

TOTCNT

Total peg count sum of INCCNGT and OUTCNT.

OFLCNT

Overflow count the number of outgoing calls that


overflowed from this trunk group to alternate trunk groups
because all trunks of this group were busy. Supported in
releases 3.1.1.3X and 3.6 or greater.

INCCCS

Incoming CCS.

OUTCCS

Outgoing CCS.

TOTCCS

Total CCS sum of INCCCS and OUTCCS.

Sample pri Space-delimited with Header Report:


BOSTON 03/04/2002 17:15:00
Start 05/21/2002 23:00:00 Stop 05/22/2002 00:00:00
INTFCNUM TOTCIRC AVLCIRC NUMLINK INCCNT OUTCNT TOTCNT
INCCCS OUTCCS TOTCCS
1 23 23 1 0 1832 1832 0 372 372
2 23 23 1 1832 0 1832 372 0 372
4 23 23 1 0 0 0 0 0 0
5 23 23 1 0 0 0 0 0 0
10 23 23 1 0 0 0 0 0 0
13 23 23 1 0 0 0 0 0 0
14 23 23 1 0 0 0 0 0 0
15 23 23 1 0 0 0 0 0 0

Telica, Inc.

8-13

Traffic Statistics Reports

Issue 3, January 9, 2003

Fields for pri Space-delimited Reports:


Switch Name Name of the switch
Start/Stop

On-the-hour start and stop times.

INTFCNUM Interface number.


TOTCIRC

Total circuits (All provisioned circuits including those that


have not been turned up for service and those that are in a
maintenance state.).

AVLCIRC

Circuits available

NUMLINK

Number of links

INCCNT

Incoming peg count indicates the number of times the


trunk was seized.

OUTCNT

Outgoing peg count indicates the number of times the


trunk was seized attempted to terminate.

TOTCNT

Total peg count sum of INCCNGT and OUTCNT.

INCCCS

Incoming CCS.

OUTCCS

Outgoing CCS.

TOTCCS

Total CCS sum of INCCCS and OUTCCS.

Sample of sip Space-delimited with Header Report:


BOSTON 12/06/2002 16:15:50
Start 12/06/2002 15:00:00 Stop 12/06/2002 16:00:00
TGPNUM INCCNT OUTCNT TOTCNT INCCCS OUTCCS TOTCCS
13 0 1 1 0 1 1
180 1 0 1 1 0 1
2001 0 1 1 0 1 1

Fields for sip Space-delimited Reports:


Switch Name Name of the switch

8-14

Start/Stop

On-the-hour start and stop times.

TGPNUM
INCCNT

Trunk group number.


Incoming peg count indicates the number of times the
trunk was seized.

OUTCNT

Outgoing peg count indicates the number of times the


trunk was seized attempted to terminate.

TOTCNT

Total peg countP sum of INCCNGT and OUTCNT.

INCCCS

Incoming CCS.

OUTCCS

Outgoing CCS.

TOTCCS

Total CCS sum of INCCCS and OUTCCS.

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-300-300

Sample gr3 Space-delimited with Header Report:


BOSTON 03/04/2002 17:15:00
Start 05/21/2002 23:00:00 Stop 05/22/2002 00:00:00
INTFCNUM TOTCRV MNTCRV TOTDS0 MNTDS0 OFLCNT INCCNT OUTCNT
TOTCNT INCCCS OUTCCS TOTCCS
1 4 0 92 48 0 0 0 0 0 0 0
2 0 0 0 0 0 0 0 0 0 0 0

Fields for gr3 Space-delimited Reports:


Switch Name Name of the switch
Start/Stop

On-the-hour start and stop times.

INTFCNUM Interface number.


TOTCRV

Total CRVs (All provisioned CRVs including those that


have not been turned up for service and those that are in a
maintenance state.).

MNTCRV

CRVs in maintenance state

TOTDS0

Total bearer channels (DS0s)

MNTDS0

DS0s in maintenance state.

OFLCNT

Overflow count the number of outgoing calls that


overflowed from this GR303 interface to alternate route
because all DS0s of this interface were not idle.

INCCNT

Incoming peg count indicates the number of times the


trunk was seized.

OUTCNT

Outgoing peg count indicates the number of times the


trunk was seized attempted to terminate.

TOTCNT

Total peg count sum of INCCNGT and OUTCNT

INCCS

Incoming CCS.

OUTCCS

Outgoing CCS

TOTCCS

Total CCS sum of INCCCS and OUTCCS

Sample casif Space-delimited with Header Report:


BOSTON 03/04/2002 17:15:00
Start 05/21/2002 23:00:00 Stop 05/22/2002 00:00:00
INTFCNUM INTFCNAME TOTLINE INCCNT OUTCNT TOTCNT INCCCS
OUTCCS TOTCCS
1 CASIF1 4 10 0 10 20 0 20
11 CASIF2 1 1 0 1 1 0 1

Telica, Inc.

8-15

Traffic Statistics Reports

Issue 3, January 9, 2003

Fields for casif Space-delimited Reports:


Switch Name Name of the switch
Start/Stop

On-the-hour start and stop times.

INTFCNUM Interface number.


INTFCNAME Interface name
TOTLINE

Total CAS lines (All provisioned CAS lines)

INCCNT

Incoming peg count indicates the number of times the


trunk was seized.

OUTCNT

Outgoing peg count indicates the number of times the


trunk was seized attempted to terminate.

TOTCNT

Total peg count sum of INCCNGT and OUTCNT

INCCS

Incoming CCS.

OUTCCS

Outgoing CCS

TOTCCS

Total CCS sum of INCCCS and OUTCCS

Comma-delimited with header


There are five types of comma-delimited with header files:
ccs_atsm_<prefix>.yyyymmddhhmm.txt
ccs_castg_<prefix>.yyyymmddhhmm.txt
ccs_pri_<prefix>.yyyymmddhhmm.txt
ccs_siptg_<prefix>.yyyymmddhhmm.txt
ccs_gr3_<prefix>.yyyymmddhhmm.txt
ccs_bicctg_<prefix>.yyyymmddhhmm.txt
ccs_casif_<prefix>.yyyymmddhhmm.txt

Prefix is the hostname; yyyy is the year; mm is the month within the
year; dd is the day of the month; hh is the hour of the day; and mm is the
minute of the hour.
Format of ccs_atsm_<prefix> , ccs_bicctg_<prefix> or
ccs_castg_<prefix> reports is:
switchname,startmonth,startday,startyear,starthour,start
minute,period(in minutes),endmonth,endday,endyear,
endhour,endminute,tgpnum,tgpnam,tottrk,avltrk,mainttrk,
precuttrk,inccnt,outcnt,totcnt,oflcnt,incccs,outccs,
totccs

8-16

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-300-300

Sample of ccs_atsm Comma-delimited with Header Report:


BOSTON,5,21,2002,23,0,60,5,22,2002,0,0,1,TRUNKGROUP1,36,
24,12,12,0,2053,2053,1540,0,414,414
BOSTON,5,21,2002,23,0,60,5,22,2002,0,0,2,TRUNKGROUP2,12,
12,0,0,0,1547,1547,0,0,310,310
BOSTON,5,21,2002,23,0,60,5,22,2002,0,0,3,trkgrp3,48,48,
0,0,3600,0,3600,0,724,0,724

Fields for ccs_ atsm, ccs_bicctg and ccs_castg Comma-delimited


Reports:
switch name Name of the switch
startmonth, startday, startyear, starthour, startminute
The starting month, day, year, hour and minute of report.
period

Period in minutes

endmonth, endday, endyear, endhour, endminute


The ending month, day, year, hour and minute of report.

Telica, Inc.

tgpnum

Trunk group number.

tgpnam

Trunk group name

tottrk

Total trunks configured (All provisioned trunks including


those that have not been turned up for service and those
that are in a maintenance state.).

avltrk

Available trunks (All cut trunks (in-service and out-ofservice) but not including pre-cut. Supported in releases
3.1.1.3X and 3.6 or greater.

mainttrk

Maintenance trunks (Trunks in a maintenance state either


by an operator or abnormal circumstances). Supported in
releases 3.1.1.3X and 3.6 or greater.

precuttrk

Number of trunks that are precut (trunks not turned up for


service). Supported in releases 3.1.1.3X and 3.6 or greater.

inccnt

Incoming peg count indicates the number of times the


trunk was seized.

outcnt

Outgoing peg count indicates the number of times the


trunk was seized attempted to terminate.

totcnt

Total peg count sum of INCCNGT and OUTCNT.

oflcnt

Overflow count the number of outgoing calls that


overflowed from this trunk group to alternate trunk groups
because all trunks of this group were busy. Supported in
releases 3.1.1.3X and 3.6 or greater.

8-17

Traffic Statistics Reports

Issue 3, January 9, 2003

incccs

Incoming CCS.

outccs

Outgoing CCS.

totccs

Total CCS sum of INCCCS and OUTCCS.

Format of ccs_pri_<prefix>.yyyymmddhhmm.txt is:


switchname,startmonth,startday,startyear,starthour,start
minute,period(in minutes),endmonth,endday,endyear,
endhour,endminute,intfcnum,totcirc,avlcirc,numlink,
inccnt,outcnt,totcnt,incccs,outccs,totccs

Sample of ccs_pri Comma-delimited with Header Report:


BOSTON,5,21,2002,23,0,60,5,22,2002,0,0,1,23,23,1,0,1832,
1832,0,372,372
BOSTON,5,21,2002,23,0,60,5,22,2002,0,0,2,23,23,1,1832,0,
1832,372,0,372
BOSTON,5,21,2002,23,0,60,5,22,2002,0,0,4,23,23,1,0,0,0,
0,0,0
BOSTON,5,21,2002,23,0,60,5,22,2002,0,0,5,23,23,1,0,0,0,
0,0,0
BOSTON,5,21,2002,23,0,60,5,22,2002,0,0,10,23,23,1,0,0,
0,0,0,0
BOSTON,5,21,2002,23,0,60,5,22,2002,0,0,13,23,23,1,0,0,
0,0,0,0
BOSTON,5,21,2002,23,0,60,5,22,2002,0,0,14,23,23,1,0,0,
0,0,0,0

Fields for ccs_pri Comma-delimited Reports:


switch name Name of the switch
startmonth, startday, startyear, starthour, startminute
The starting month, day, year, hour and minute of report.
period

Period in minutes

endmonth, endday, endyear, endhour, endminute


The ending month, day, year, hour and minute of report.

8-18

intfcnum

Interface number.

totcirc

Total circuits (All provisioned circuits including those that


have not been turned up for service and those that are in a
maintenance state.).

avlcirc

Circuits available

numlink

Number of links

inccnt

Incoming peg count indicates the number of times the


trunk was seized.

outcnt

Outgoing peg count indicates the number of times the


trunk was seized attempted to terminate.
Telica, Inc.

Billing and Traffic Collection Guide

Section 150-300-300

totcnt

Total peg count sum of INCCNGT and OUTCNT.

incccs

Incoming CCS.

outccs

Outgoing CCS.

totccs

Total CCS sum of INCCCS and OUTCCS.

Format of ccs_siptg_<prefix> reports is:


switchname,startmonth,startday,startyear,starthour,start
minute,period(in minutes),endmonth,endday,endyear,
endhour,endminute,tgpnum,inccnt,outcnt,totcnt,incccs,
outccs,totccs

Sample of ccs_siptg Comma-delimited with Header Report:


BOSTON,12,6,2002,15,0,60,12,6,2002,16,0,13,0,1,1,0,1,1
BOSTON,12,6,2002,15,0,60,12,6,2002,16,0,180,1,0,1,1,0,1

Fields for ccs_siptg Comma-delimited Reports:


switch name Name of the switch
startmonth, startday, startyear, starthour, startminute
The starting month, day, year, hour and minute of report.
period
Period in minutes
endmonth, endday, endyear, endhour, endminute
The ending month, day, year, hour and minute of report.
tgpnum
Trunk group number.
inccnt
Incoming peg count indicates the number of times the
trunk was seized.
outcnt
Outgoing peg count indicates the number of times the
trunk was seized attempted to terminate.
totcnt
Total peg count sum of INCCNGT and OUTCNT.
incccs
Incoming CCS.
outccs
Outgoing CCS.
totccs
Total CCS sum of INCCCS and OUTCCS.
Format of ccs_gr3_<prefix>.yyyymmddhhmm.txt is:
switchname,startmonth,startday,startyear,starthour,start
minute,period(in minutes),endmonth,endday,endyear,
endhour,endminute,intfcnum,totcrv,mntcrv,totds0,mntds0,o
flcnt,inccnt,outcnt,totcnt,incccs,outccs,totccs

Telica, Inc.

8-19

Traffic Statistics Reports

Issue 3, January 9, 2003

Sample of ccs_gr3 Comma-delimited with Header Report:


BOSTON,4,4,2003,11,30,15,4,4,2003,11,45,1,4,0,92,48,0,0,0,
0,0,0,0
BOSTON,4,4,2003,11,30,15,4,4,2003,11,45,2,0,0,0,0,0,0,0,0,
0,0,0

Fields for ccs_gr3 Comma-delimited Reports:


switch name Name of the switch
startmonth, startday, startyear, starthour, startminute
The starting month, day, year, hour and minute of report.
period

Period in minutes

endmonth, endday, endyear, endhour, endminute


The ending month, day, year, hour and minute of report.
intfcnum

Interface number.

totcrv

Total crvs (All provisioned crvs including those that have


not been turned up for service and those that are in a
maintenance state.).

mntcrv

Crvs in maintenance state

totds0

Total bearer channels (DS0s)

mntds0

DS0s in maintenance state.

oflcnt

Overflow count the number of outgoing calls that


overflowed from this GR303 interface to alternate route
because all DS0s of this interface were not idle.

inccnt

Incoming peg count indicates the number of times the


trunk was seized.

outcnt

Outgoing peg count indicates the number of times the


trunk was seized attempted to terminate.

totcnt

Total peg count sum of INCCNGT and OUTCNT

inccs

Incoming CCS.

outccs

Outgoing CCS

totccs

Total CCS sum of INCCCS and OUTCCS

Format of ccs_siptg_<prefix> reports is:


switchname,startmonth,startday,startyear,starthour,start
minute,period(in minutes),endmonth,endday,endyear,
endhour,endminute,tgpnum,inccnt,outcnt,totcnt,incccs,
outccs,totccs

8-20

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-300-300

Sample of ccs_siptg Comma-delimited with Header Report:


BOSTON,12,6,2002,15,0,60,12,6,2002,16,0,13,0,1,1,0,1,1
BOSTON,12,6,2002,15,0,60,12,6,2002,16,0,180,1,0,1,1,0,1

Fields for ccs_siptg Comma-delimited Reports:


switch name Name of the switch
startmonth, startday, startyear, starthour, startminute
The starting month, day, year, hour and minute of report.
period
Period in minutes
endmonth, endday, endyear, endhour, endminute
The ending month, day, year, hour and minute of report.
tgpnum
Trunk group number.
inccnt
Incoming peg count indicates the number of times the
trunk was seized.
outcnt
Outgoing peg count indicates the number of times the
trunk was seized attempted to terminate.
totcnt
Total peg count sum of INCCNGT and OUTCNT.
incccs
Incoming CCS.
outccs
Outgoing CCS.
totccs
Total CCS sum of INCCCS and OUTCCS.
Format of ccs_casif_<prefix>.yyyymmddhhmm.txt is:
switchname,startmonth,startday,startyear,starthour,start
minute,period(in minutes),endmonth,endday,endyear,
endhour,endminute,intfcnum,intfcname,totline,
inccnt,outcnt,totcnt,incccs,outccs,totccs

Sample of ccs_casif Comma-delimited with Header Report:


BOSTON,4,4,2003,11,30,15,4,4,2003,11,45,1,CASIF1,4,10,0,10,
20,0,20
BOSTON,4,4,2003,11,30,15,4,4,2003,11,45,11,CASIF2,1,1,0,1,1
,0,1

Fields for ccs_casif Comma-delimited Reports:


switch name Name of the switch
startmonth, startday, startyear, starthour, startminute
The starting month, day, year, hour and minute of report.
period

Period in minutes

endmonth, endday, endyear, endhour, endminute


The ending month, day, year, hour and minute of report.
intfcnum
Telica, Inc.

Interface number.
8-21

Traffic Statistics Reports

8.2.2.5

Issue 3, January 9, 2003

intfcname

Interface name.

totline

Total CAS lines (All provisioned CAS lines).

inccnt

Incoming peg count indicates the number of times the


trunk was seized.

outcnt

Outgoing peg count indicates the number of times the


trunk was seized attempted to terminate.

totcnt

Total peg count sum of INCCNGT and OUTCNT

inccs

Incoming CCS.

outccs

Outgoing CCS

totccs

Total CCS sum of INCCCS and OUTCCS

ASCII CDR Report


If this option is turned on, then every 5 minutes an ASCII CDR file is
created and CDRs of the calls are written in these files. The naming
convention for the file is;
<prefix>_ STATS_CDR_ yyyymmddhhmm.txt
where prefix is the hostname; yyyy is the year; mm is the month within
the year; dd is the day of the month; hh is the hour of the day; and mm is
the minute of the hour.
A sample of what the output would actually look like and field
descriptions follow.
Sample Output
3,118,57,4,33,0,11-08-2002,15:13:45.00,47,6175551000,31055510000,16,0,1,
11-08-2002,15:13:49.00,11-08-2002,15:13:46.00,37,11-08-2002,15:13:49.00,
boston1,boston2,0,197379,0,9084446666,,020117000010101,010108000000101,
2222,4,31055510000
3,118,69,4,33,0,11-08-2002,15:13:58.00,48,6175551000,31055510000,16,0,1,
11-08-2002,15:14:02.00,11-08-2002,15:13:59.00,38,11-08-2002,15:14:02.00,
boston1,boston2,0,97379,0,9084446666,,020117000010101,010108000000101,2222
,6,31055510000

8-22

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-300-300

Fields:
Incoming Interface: Has the following values:
0 = Invalid or No interface
1 = ISDN interface
3 = SS7 trunk group
4 = CAS trunk group
5 = SIP trunk group
6 = CAS Line
7 = GR303 interface
8 = BICC trunk group
999 = Valid interface but not known by TSAA.
Incoming Interface id:
ISDN interface ID for ISDN interface,
GR303 interface ID for GR303 interface
Trunk group number for SS7
Trunk group number for CAS
Trunk group number for BICC
Trunk group number for SIP Trunk groups.
Interface id for CAS Interface
Incoming CIC:
0 = (not used) for ISDN,CAS Interface
CIC for SS7 Trunk Group
CRV for GR303 interface
CAS Trunk Group
SIP Trunk Group
BICC Trunk Group
CAS Line
Outgoing Interface: Has the following values;
0 = Invalid or No interface
1 = ISDN interface
3 = SS7 trunk group
4 = CAS trunk group
5 = SIP trunk group
6 = CAS Line
7 = GR303 interface
8 = BICC interface
999 = Valid interface but not known by TSAA
Telica, Inc.

8-23

Traffic Statistics Reports

Issue 3, January 9, 2003

Outgoing Interface id:


ISDN interface ID for ISDN interface
GR303 interface ID for GR303 interface
Trunk group number for SS7
Trunk group number for CAS
Trunk group number for BICC
Trunk group number for SIP Trunk groups.
Interface id for CAS Interface
Outgoing CIC:
0 = (not used) for ISDN,CAS Interface
CIC for SS7 Trunk Group
CRV for GR303 interface
CAS Trunk Group
SIP Trunk Group
BICC Trunk Group
CAS Line.
Carrier Connect Date: Carrier Connection date of the call.
Carrier Connect Time: Carrier Connection time of the call.
Carrier Duration: Total carrier duration of the call if its released,
current carrier duration of the call if its in progress (long
duration CDRs) in tenths of a second.
Calling Party Number
Called Party Number
Release cause: Release cause of the call if the call is released.0 for in
progress calls(long duration CDRs).
Off Hook Indicator: Has the following values:
0 = Call is answered
1 = Call is not answered.
9 = Unknown
Release Originator: Has the following values;
1 = Release initiated by the incoming interface.
2 = Release initiated by the outgoing interface.
3 = Release initiated internally (by the stack)

8-24

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-300-300

Carrier Release Date: Carrier Release date of the call if the call is
released. If the call is in progress, its 00-00-0000.
Carrier Release Time: Carrier Release time of the call if the call is
released. If the call is in progress, its 00:00:00.00.
Conversation Connect Date: Conversation Connection date of the call, if
the call is answered. If the call is not answered, its 00-000000.
Conversation Connect Time: Conversation Connection time of the call,
if the call is answered. If the call is not answered its
00:00:00.00.
Conversation Duration: Total conversation duration of the call if its
answered and released, current conversation duration of the
call if its in progress (long duration CDRs) in tenths of a
second. If the call is not answered, its 0.
Conversation Release Date: Conversation Release date of the call if the
call is answered and released. If the call is not answered or
if its in progress, its 00-00-0000.
Conversation Release Time: Conversation Release time of the call if the
call is answered and released. If the call is not answered or
if its in progress, its 00:00:00.00.
Incoming Trunk Group Name: NONAME if the interface doesnt
have a name.
Outgoing Trunk Group Name: NONAME if the interface doesnt
have a name.
International Indicator: Has the following values;
0 = Call is a domestic call.
1 = Call is an international call.
Originating Point Code:
Destination Point Code:
Charge Number:
Country Code: Represents a country code

Telica, Inc.

8-25

Traffic Statistics Reports

Issue 3, January 9, 2003

Incoming Physical Port: This field is a fifteen-digit string identifying the


originating physical resource used by the call. The string is
formatted as follows:
TTCCSS0OO331100 where:
TT - The front IOM board type as identified in following
table.
CC - The switch (chassis) number. Currently is always 01.
XX - The slot number (00 to 17).
0 - Unused. Will be 0.
OO - The OC3. Non-zero on OC3 boards.
33 - The DS3. Non-zero on OC3 and DS3 boards.
11 - The DS1.
00 - The DS0.
00
01
02
03
04
05
06
07
08
09
10
11
12
13
14
15
16
17
18
19

UNKNOWN
DS1 (89-0360)
DS3 (89-0365)
Octal DS3 (89-0382)
Octal DS3 (89-0398)
ATM DS3 (89-0409)
Octal DS3
ENA (89-0390)
Voice Server (VOP8) (89-0388)
Voice Server (VOP6) (89-0395)
OC12
VOIP
STS DS3
STS or DS3
PNA (89-0393)

Triple DS3 (410)


Octal DS3 (411)

Note that only TDM board types are supported. For


non-TDM boards only BBSSss are populated. The
remaining fields are zero.
Outgoing Physical Port: Terminating physical resource, formatted as in
the previous description.

8-26

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-300-300

Carrier: 4 digit carrier code.


Call Id: The unique callId value available from call control.
Dialed Number: Dialed number
8.2.2.6

ASR Report
Answer to Seizure Ratio (ASR) reports are generated if the ASR Report
value in the tsaa_<prefix>.conf file is set to 1.
Based on the configuration, files can be produced on one of the following
intervals:

Every 15 minutes
Every 30 minutes
Every 1 hour
Every 24 hours

8.2.2.6.1 ASR Output


ASRs are reported for every ISDN, and CAS interfaces, SS7, CAS, BICC,
and SIP trunk groups The naming convention for the file is:
<prefix>_ASR_yyyymmddhhmm.txt
where <prefix> is the prefix defined in the tsaa_<prefix>.conf file, and
yyyymmddhhmm is the reported year/month/day/hour/minute.
The format for this file is:
version,month,day,year,hour,min,record_type,type_id,value,
answered_incoming,answered_outgoing,answered_total,
seizure_incoming,seizure_outgoing,seizure_total,ASR
A sample of what the output would actually look like is provided below.
Field descriptions follow.
Sample Output (generated by Plexus 9000):
Boston_STATS_ASR_200211082000.txt
1.0,11,8,2003,20,50,1,3,661,0,1,1,0,1,1,1.00
1.0,11,8,2003,20,50,1,3,662,0,1,1,0,1,1,1.00
1.0,11,8,2003,20,50,1,3,663,0,1,1,0,1,1,1.00
1.0,11,8,2003,20,50,1,3,664,0,1,1,0,1,1,1.00
1.0,11,8,2003,20,50,1,3,665,0,1,1,0,1,1,1.00
1.0,11,8,2003,20,50,1,3,666,0,1,1,0,1,1,1.00
1.0,11,8,2003,20,50,1,3,667,0,1,1,0,1,1,1.00
1.0,11,8,2003,20,55,1,3,551,1,0,1,11,0,11,0.09
1.0,11,8,2003,20,55,1,3,552,1,0,1,12,0,12,0.08
1.0,11,8,2003,20,55,1,3,553,1,0,1,13,0,13,0.08
1.0,11,8,2003,20,55,1,3,554,1,0,1,13,0,13,0.08
1.0,11,8,2003,20,55,1,3,555,1,0,1,11,0,11,0.09
1.0,11,8,2003,20,55,1,3,556,1,0,1,10,0,10,0.10
1.0,11,8,2003,20,55,1,3,557,1,0,1,4,0,4,0.25

Telica, Inc.

8-27

Traffic Statistics Reports

Issue 3, January 9, 2003

1.0,11,8,2003,20,55,1,3,661,0,1,1,0,1,1,1.00
1.0,11,8,2003,20,55,1,3,662,0,1,1,0,1,1,1.00
1.0,11,8,2003,20,55,1,3,663,0,1,1,0,1,1,1.00
1.0,11,8,2003,20,55,1,3,664,0,1,1,0,1,1,1.00
1.0,11,8,2003,20,55,1,3,665,0,1,1,0,1,1,1.00
1.0,11,8,2003,20,55,1,3,666,0,1,1,0,1,1,1.00
1.0,11,8,2003,20,55,1,3,667,0,1,1,0,1,1,1.00
1.0,11,8,2003,20,30,4,3,551,3,0,3,15,0,15,0.20
1.0,11,8,2003,20,30,4,3,552,3,0,3,16,0,16,0.19
1.0,11,8,2003,20,30,4,3,553,3,0,3,17,0,17,0.18
1.0,11,8,2003,20,30,4,3,554,3,0,3,17,0,17,0.18
1.0,11,8,2003,20,30,4,3,555,3,0,3,15,0,15,0.20
1.0,11,8,2003,20,30,4,3,556,3,0,3,14,0,14,0.21

Fields:
version

Specifies the version of the application on the Plexus.

month, day, year, hour, min Describes the start date and time of the
reporting interval of the record.
record_type Has the following values:
1 = peg count 5 min period
2 = peg count 1 hour period
3 = peg count 24 hour period
4 = peg count 30 min period
type _id

Has the following values:


1 = ISDN interface
2 = directory number
3 = trunk group
4 = CAS trunk group
5 = SIP trunk group
6 = CAS interface
7 = GR303 interface
8 = BICC trunk group

value

Type_ids value (i.e. trunk group #, ISDN Interface)

answered_incoming Total number of answered incoming calls in the


period.
answered_outgoing Total number of answered outgoing calls in he
period.
answered_total Total number of answered calls in the period
(answered_incoming + answered_outgoing)

8-28

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-300-300

seizure_incoming Total number of seizures for the incoming calls in the


period.
seizure_outgoing Total number of seizures for the outgoing calls in he
period.
answered_total Total number of seizures in the period
(seizure_incoming + seizure_outgoing)
ASR

8.3

Answer to Seizure Ratio of the period. Calculated with the


formula; (answered_total / seizure_total)

Installation and Configuration


To use the BTS or TCA successfully with the Plexus 9000, you must first
meet specific platform requirements, listed in 8.3.1. You must then install
and configure the BTS or TCA on the Sun server and establish
communications between the BTS or TCA and the Plexus 9000.

8.3.1
8.3.1.1

Platform Requirements
TCA Server Platform Requirements
The TCA supports the Plexus 9000, release 3.1.1.1 or greater, and must
meet these prerequisites:

8.3.1.2

Sun Solaris 2.7 or 2.8 with 500 MB memory and a 10/100


Ethernet card

Sun server with a minimum of a 400 Mhz processor

BTS Server Platform Requirements


The BTS supports the Plexus 9000, release 3.8 or greater, and must meet
these prerequisites:

8.3.2
8.3.2.1

Sun Sparc with 256 MB memory and a 10/100 MB Ethernet card


and Ethernet connection

Sun server with a minimum of a 400 Mhz processor

Configuration
TCA
Configuration procedure for gathering statistics using the TCA can be
found in DLP-541 or DLP-542 of this manual. Procedures for
provisioning the Plexus 9000 for gathering statistics can be found in the
Plexus 9000 Installation and Operation Manual.

Telica, Inc.

8-29

Traffic Statistics Reports


8.3.2.2

Issue 3, January 9, 2003

BTS
Configuration procedure for gathering statistics using the BTS and TSAA
can be found in DLP-541 of this manual. Procedures for provisioning the
Plexus 9000 for gathering statistics can be found in the Plexus 9000
Installation and Operation Manual.

8-30

Telica, Inc.

Section 150-500-100
Issue 2, May 13, 2003

TNG-893

9.

TOP Procedures

9.1

Task Oriented Practices (TOPS)

9.1.1
9.1.2
9.1.3

Scope ......................................................................................................................... 9-1


Overview ................................................................................................................... 9-1
How To Use This TOP Section................................................................................. 9-2

9.1.1 Scope
This section describes Task Oriented Practices (TOPs) and how to use the
procedures.
9.1.2 Overview
The Installation, Configuration and Testing section of this manual is
written in the TOP style and complies with AT&T 000-100-115 Issue 3
February 1984. The Task Oriented Practices (TOPs) section includes the
following:

TOP Documentation References

Task Index Lists (IXLs)

Detailed Level Procedures (DLPs)

Checklist (CKL)

The procedures give you all the step-by-step instructions you need to do
your job or task. The instructions are given in the order they must be
done. Failure to follow the instructions in order may cause service
interruptions.
Regardless of your work experience, TOPs can be a useful tool in doing
your job. If you have done a particular job many times, TOPs serve as a
reminder for those instructions you cannot recall. If you have never done
a particular job, or do it infrequently, TOPs give you step-by-step
instructions.
Detailed Level Procedures: These tasks enable you to install
applications, to provision it for operation, and to test it after it is installed.

Telica, Inc.

9-1

TNG-893

9.1.3

Section 150-500-100
Issue 2, May 13, 2003

How To Use This TOP Section


To find the instructions for performing installation and provisioning, you
must complete the following steps.
1. Find the job in the Task Index (IXL-001) in the "FIND YOUR
JOB IN THE LIST BELOW" column. Then find the procedure
number for that job in the "THEN GO TO" column. The tasks of
IXL-001 are listed by application.
2. Go to the referenced procedure (for example: DLP-501 - Install
and Provision the ASCII Billing System) to find detailed
instructions on how to perform the task. The procedure will give
you step-by-step instructions to do that item.
3. All DLPs are located in the following the IXL.
4. If assistance is required after completing all applicable TOP
procedures, contact Telica Technical Support at 888-440-8354 or
508-485-5739.

9-2

Telica, Inc.

Issue 4, January 9, 2004


Section 150-500-200

9.2

Checklist

Procedures Checklist

DLP
IXL-001

TITLE NAME
Provisioning Task Index List

ISSUE &
DATE
2, 01/09/04

DLP-501
DLP-502
DLP-503

Install and Provision the ASCII Billing System


Edit Configuration Files for ASCII Billing
Upgrade the ASCII Billing Application

2, 05/13/03
2, 05/13/03
2, 05/13/03

DLP-511
DLP-512
DLP-513
DLP-514
DLP-515
DLP-516

Install and Provision AMA Lite Application


Edit Configuration Files for AMA Lite
Upgrade the AMA Lite Application
Create and Read AMA file
Disable ports for Security
Create and Read AMA file When using BTS

2, 05/13/03
2, 05/13/03
2, 05/13/03
2, 05/13/03
2, 05/13/03
1, 11/07/03

DLP-521
DLP-522
DLP-523

Install and Provision Traffic Collection Application


Edit Configuration Files for Traffic Collection
Upgrade the Traffic Collection Application

4, 01/09/04
3, 01/09/04
4, 01/09/04

DLP-531

Install the PlexView Pro AMA Billing Application

3, 09/25/03

DLP-541
DLP-542

Install the PlexView Billing and Traffic System


Upgrade the Billing and Traffic System

3, 01/09/04
2, 01/09/04

Telica, Inc.

9-3

Checklist

Issue 4, January 9, 2004


Section 150-500-200

NOTES:

9-4

Telica, Inc.

Section 150-500-300
Issue 2, January 9, 2004

9.3

IXL-001

Provisioning Task Index List

Note: DLPs are found in numerical order after this list.

FIND YOUR JOB IN THE LIST BELOW

THEN GO TO

ASCII Billing (ABS)


Install and Provision the ASCII Billing System .............................................. DLP-501
Edit Configuration Files for ASCII Billing ...................................................... DLP-502
Upgrade the ASCII Billing Application ........................................................... DLP-503

AMA LITE
Install and Provision AMA Lite Application ................................................... DLP-511
Edit Configuration Files for AMA Lite ............................................................ DLP-512
Upgrade the AMA Lite Application ................................................................. DLP-513
Create and Read AMA file................................................................................ DLP-514
Disable ports for Security.................................................................................. DLP-515
Create and Read AMA file When Using BTS .................................................. DLP-516

Traffic Collection Application (TCA)


Install and Provision Traffic Collection Application ....................................... DLP-521
Edit Configuration Files for Traffic Collection ................................................ DLP-522
Upgrade the Traffic Collection Application ..................................................... DLP-523

PlexView Pro AMA Billing


Install the PlexView Pro AMA Billing Application ........................................ DLP-531

Telica, Inc.

9-5

IXL-001

FIND YOUR JOB IN THE LIST BELOW

Issue 2, January 9, 2004


Section 150-500-300

THEN GO TO

PlexView Billing and Traffic System


Install the PlexView Billing and Traffic System .............................................. DLP-541
Upgrade the Billing and Traffic System............................................................ DLP-542

9-6

Telica, Inc.

Section 150-500-400
Issue 2, May 13, 2003

DLP-501

DLP-501 - INSTALL AND PROVISION THE ASCII BILLING


SYSTEM
SUMMARY: This procedure provides instructions for installing and configuring the
ABS application on the ABS Sun server. It also provides steps to verify that the
application has started properly.
This procedure assumes that the server to run the ABS application has already been
installed on the same network as the Plexus and is configured with sufficient disk space.
Knowledge of UNIX and the vi command or other text editor is also required. If you
have questions regarding vi, please contact Telica Technical Services at 1-888-440-8354.
Procedures for provisioning the Plexus for billing are found in the Plexus 9000
Installation and Operation Manual.

Note 1: To avoid local time synchronization problems, Telica strongly


recommends setting both the Plexus and the ABS server system clock to
GMT. For assistance, please contact Telica Technical Services at 1-888440-8354.
Note 2: Users of the ABS application are responsible for managing file
space and for any post-processing of ASCII billing records on the ABS
server.
Caution: When using the ASCII Billing System, it is possible to fill the
server's data directory to a point where the 'ls' command will not display
the contents of the data directory. To prevent this from happening, Telica
suggests that the previous month's data files be removed from the data
directory during the first week of a new month.

Step 1.

The ASCII Billing Server (ABS) supports the Plexus 9000, release 1.3
(3.1.1.1), 3.5 and 4.3 (3.4.3) or earlier, and must meet these prerequisites:

Telica, Inc.

Sun Solaris 7 or 8 with 256 MB memory and a 10/100 Ethernet


card
Sun Ultra 10 or Sun Netra X1 at a minimum

9-7

DLP-501

Section 150-500-400
Issue 2, May 13, 2003

Step 2.

Log into the ABS server as root after obtaining the username and password.

Step 3.

Once logged onto the ABS server, create the ABS base directory in opt/. Do
this by typing:

mkdir /opt/PlexViewABS

Step 4.

Change to the PlexView ABS directory by typing:

cd /opt/PlexViewABS

Note: In the following steps, the correct version number should be substituted
for x-x-x-x.
Step 5.

Obtain a copy of the latest AsciiBilling_SunOS_X-X-X-X.tar file from a system


CD or from Telica Technical Services (1-888-440-8354) and copy this
file to the PlexViewAbs directory on the ABS server.

Note: The tar file will extract directly into /opt/PlexViewABS.


Step 6.

Untar the AsciiBilling_SunOs_X-X-X-X.tar file by substituting the correct


version number for x-x-x-x and typing:

tar -xvf AsciiBilling_SunOS_X-X-X-X.tar

Step 7.

Using vi or any available text editor, edit the newly created configuration file
template. Refer to Table 9-A for an example of the abs.conf file. The only
fields that should be modified are highlighted in bold in the sample abs.conf
file as shown in . If using vi, type:

vi abs.conf

Step 8.

Change the DATA_DIR field if required.

Step 9.

Change the frequency of creating/writing billing files if required. The range is


from 5 to 1440 minutes.

Step 10. If billing files will be archived, remove the comment symbol (#) at the
beginning of the line and set the number of days for saving archived files.
If ARCHIVE is set to a value other than 0, then raw CDR records from the
switch are archived with the same frequency as the ASCII Billing files. The file
name of the raw file is the same with the ASCII Billing file, but the extension is
.dat. The ARCHIVE value defines the number of days a .dat file is left on the
system before it is automatically deleted. The maximum number of days is 62.

9-8

Telica, Inc.

Section 150-500-400
Issue 2, May 13, 2003

DLP-501

Table 9-A. Sample abs.conf File


#
#
#
#

FileName: abs.conf
Telica ASCII Billing Server configuration environment
Server TCP listen Port number and working directory
SERVER_PORT
1983

Working Directory - contains data, connection info and log files


DATA_DIR
data

#
#
#
#
#

ASCII Billing file writing/creation frequency in minutes


Must be integer interval of minutes within 24 hours. Intervals are
always based on an initial start time of Midnight.
Defaults to 24 Hours (60min * 24hr = 1440 min)
Valid values = 5-1440
FREQUENCY
1440

#
#
#
#
#
#
#

Uncomment the following line to have raw CDR records from the
switch archived with the same frequency as AMA data files.
The archive files use the same name, but the extension is .dat
The value define the number of days an archive file is left on the
system before it is automatically deleted.
WARNING: This may require a VERY large disk!
ARCHIVE
31

#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#

Client switches (usually SPA/SPB pairs use the same prefix but it
is not a requirement)
Prefix may be followed by TZ and/or SensorID/OfficeID.
TZ specifies the client's time zone.Clients which have the
same prefix should be in the same time zone. Time zone is used to
calculate the time in the file names.
For detailed description of the rules for defining TZ,
See environ(5) for a description of the TZ environment variable.
TZ values used in US:
EST5EDT
(Eastern Time, Daylight Savings Time applies)
CST6CDT
(Central Time, Daylight Savings Time applies)
PST8PDT
(Pacific Time, Daylight Savings Time applies)
MST7MDT
(Mountain Time, Daylight Savings Time applies)
If the configured TZ is invalid, then GMT, if no TZ is provided
then server's time zone is used for time calculations.
SensorID/OfficeID will override
the AMA Sensor ID and/or Recording Office ID sent from the switch.
Valid SensorID/OfficeID values = 000000-999999
Plexus-9000 host processors (name or doted IP address)
CLIENT name or IP
File Prefix
------ -------------------CLIENT bostonSPA
Boston
TZ=EST5EDT
CLIENT bostonSPB
Boston
TZ=EST5EDT
CLIENT
CLIENT

Telica, Inc.

sfoSPA
sfoSPB

SanFrancisco
SanFrancisco

9-9

DLP-501

Section 150-500-400
Issue 2, May 13, 2003

CLIENT
CLIENT

denverSPA
denverSPB

DenverA
DenverB

TZ=MST7MDT
TZ=MST7MDT

SensorID=123456
OfficeID=789012

CLIENT
CLIENT

10.0.0.26
10.0.0.27

Marlboro
Marlboro

SensorID=345678:OfficeID=901234

Note: There can be up to sixteen (16) CLIENT entries for connection to up to eight (8)
Plexus 9000 switches. Delete extra CLIENT entries.

Step 11. Enter the IP addresses or names of the Clients SPs that will send billing files to
the server. IP addresses are the addresses set on each Plexus with the
ED-CHASSIS-EQPT TL1 command. Names are obtained using DNS lookup.
Delete extra CLIENT entries.
Step 12. Enter the prefix name for the files to be received from each switch. Typically
the prefix is the same for both SPs of a Plexus.
Step 13. Have all the Clients and Prefixes required been entered?
If YES, then continue to the next step.
If NO, then go to Step 11.
Step 14. The TZ (time zone), SensorID and Office/ID fields are optional fields. If
required, enter the values for the SensorID and Office/ID which will override
the AMA Sensor ID and/or Recording Office ID sent from the switch. Valid
SensorID/OfficeID values between 000000 and 999999.
Step 15. Copy the S99PLXAbs file into the /etc/rc3.d directory by typing:

cp p S99PLXAbs /etc/rc3.d

Step 16. Change directories by typing:

cd

/etc/rc3.d

Step 17. Start the S99PLXAbs program by typing:

./S99PLXAbs start

Step 18. Verify that the billing process has started by typing:

ps ef | grep TelicaAbsSrvr

Step 19. Change to the directory defined by DATA_DIR in the abs.conf file by typing
the following and substituting the correct name for <DATA_DIR>:

cd /opt/PlexViewABS/<DATA_DIR>

9-10

Telica, Inc.

Section 150-500-400
Issue 2, May 13, 2003

DLP-501

Step 20. Verify that a log file and connection info file have been created (abs.log and
abs.conn) by typing:

ls -l

Step 21. If provisioning for billing must be completed at the Plexus 9000, refer to the
Plexus 9000 Installation and Operation Manual and NTP-018.
Step 22. Generate calls to or from any of the subscribers provisioned on the Plexus.
Note: ASCII text files of billing records, <PREFIX>_yyyymmdd_time.txt, are
created in accordance to the frequency defined in the abs.conf file. These text
files contains comma-delimited billing records.
abs.log contains information regarding the connections (new connections, lost
connections, error messages).
Abs.conn contains the IP address of all connecting switches in hexadecimal
code.

Step 23. Ensure you are in the correct directory by typing the following and substituting
the correct name for <DATA_DIR>:

cd /opt/PlexViewABS/data

Step 24. List the name(s) of the <PREFIX>_yyyymmdd_time.txt files by typing:

ls l *.txt

Step 25. Do you want to view a <PREFIX>_yyyymmdd_time.txt file?


If YES, then view file by typing the following substituting the correct
name of the file:

more <PREFIX>_yyyymmdd_time.txt

If NO, then go to Step 27.


Step 26. Do you want to view another file?
If YES, then Step 25.
If NO, then continue to the next step.

Telica, Inc.

9-11

DLP-501

Section 150-500-400
Issue 2, May 13, 2003

Step 27. Do you want to view the abs.conn file?


If YES, then view file by typing the following:

od x abs.conn

If NO, then continue to the next step.


Step 28. Do you want to view the abs.log file?
If YES, then view file by typing the following:

more abs.log

If NO, then continue to the next step.


Step 29. Do you want to logout of the ABS server at this time?
If YES, then logout by typing exit

If NO, then continue to the next step.

Step 30.

9-12

YOU HAVE COMPLETED THIS PROCEDURE.

Telica, Inc.

Section 150-500-400
Issue 2, May 13, 2003

DLP-502

DLP-502 - EDIT CONFIGURATION FILES FOR ASCII BILLING


SUMMARY:
This procedure provides the steps to edit the configuration files for the
ASCII Billing Server (ABS) application.
Knowledge of UNIX and the vi command or other text editor is also required. If you
have questions regarding vi, please contact Telica Technical Services at 1-888-440-8354.
Procedures for provisioning the Plexus for the ABS are found in the Plexus 9000
Installation and Operation Manual.

Caution: When using the ASCII Billing System, it is possible to fill the
server's data directory to a point where the 'ls' command will not display
the contents of the data directory. To prevent this from happening, Telica
suggests that the previous month's data files be removed from the data
directory during the first week of a new month.

Step 31. Log into the ABS (ASCII Billing Server) server after obtaining the username
and password of the chosen ABS server. Write access is required if the
checked file requires changes.
Step 32. Once logged onto the ABS server, type:

cd /opt/PlexViewABS

Step 33. Using vi or any available text editor, add new switches (IP address or host name
and prefix) or make other required changes. Refer to Table 9-B for a sample
file. Remember to save the *.conf files before exiting. Type:

vi abs.conf

Telica, Inc.

9-13

DLP-502

Section 150-500-400
Issue 2, May 13, 2003

Table 9-B. abs.conf File


#
#
#
#

FileName: abs.conf
Telica ASCII Billing Server configuration environment
Server TCP listen Port number and working directory
SERVER_PORT
1983

Working Directory - contains data, connection info and log files


DATA_DIR
data

#
#
#
#
#

ASCII Billing file writing/creation frequency in minutes


Must be integer interval of minutes within 24 hours. Intervals are
always based on an initial start time of Midnight.
Defaults to 24 Hours (60min * 24hr = 1440 min)
Valid values = 5-1440
FREQUENCY
1440

#
#
#
#
#
#
#

Uncomment the following line to have raw CDR records from the
switch archived with the same frequency as AMA data files.
The archive files use the same name, but the extension is .dat
The value define the number of days an archive file is left on the
system before it is automatically deleted.
WARNING: This may require a VERY large disk!
ARCHIVE
31

#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#

Client switches (usually SPA/SPB pairs use the same prefix but it
is not a requirement)
Prefix may be followed by TZ and/or SensorID/OfficeID.
TZ specifies the client's time zone.Clients which have the
same prefix should be in the same time zone. Time zone is used to
calculate the time in the file names.
For detailed description of the rules for defining TZ,
See environ(5) for a description of the TZ environment variable.
TZ values used in US:
EST5EDT
(Eastern Time, Daylight Savings Time applies)
CST6CDT
(Central Time, Daylight Savings Time applies)
PST8PDT
(Pacific Time, Daylight Savings Time applies)
MST7MDT
(Mountain Time, Daylight Savings Time applies)
If the configured TZ is invalid, then GMT, if no TZ is provided
then server's time zone is used for time calculations.
SensorID/OfficeID will override
the AMA Sensor ID and/or Recording Office ID sent from the switch.
Valid SensorID/OfficeID values = 000000-999999
Plexus-9000 host processors (name or doted IP address)
CLIENT name or IP
File Prefix
------ -------------------CLIENT bostonSPA
Boston
TZ=EST5EDT
CLIENT bostonSPB
Boston
TZ=EST5EDT
CLIENT
CLIENT

9-14

sfoSPA
sfoSPB

SanFrancisco
SanFrancisco

Telica, Inc.

Section 150-500-400
Issue 2, May 13, 2003

DLP-502

CLIENT
CLIENT

denverSPA
denverSPB

DenverA
DenverB

TZ=MST7MDT
TZ=MST7MDT

SensorID=123456
OfficeID=789012

CLIENT
CLIENT

10.0.0.26
10.0.0.27

Marlboro
Marlboro

SensorID=345678:OfficeID=901234

Note: There can be up to sixteen (16) CLIENT entries for connection to up to eight (8)
Plexus 9000 switches. Delete extra CLIENT entries.
Step 34. Stop the ABS Server by typing the following:

/etc/rc3.d/S99PLXAbs stop

Step 35. Start the ABS Server by typing the following:

/etc/rc3.d/S99PLXAbs start

Step 36. Determine the process ID by typing the following:

ps e o pid o args | grep TelicaAbsSrvr

Response: 1234 TelicaABsSrvr


Comment: 1234 in the preceding response is the pid number which is
used in the following step.
Step 37. Stop the ABS Server by typing the following:

kill XXXX

Comment: Substitute the pid number of the preceding response for


XXXX (i.e., kill 1234).
Step 38. Restart the TelicaAbsSrvr program by typing :

./TelicaAbsSrvr abs.conf

Step 39. Logout of the ABS server by typing:

exit

Step 40.

Telica, Inc.

YOU HAVE COMPLETED THIS PROCEDURE.

9-15

DLP-502

Section 150-500-400
Issue 2, May 13, 2003

NOTES:

9-16

Telica, Inc.

Section 150-500-400
Issue 2, May 13, 2003

DLP-503

DLP-503 - UPGRADE THE ASCII BILLING APPLICATION


SUMMARY:
This procedure provides instructions for upgrading the ASCII Billing
Server (ABS) application on a Sun server.
Knowledge of UNIX and vi command or other text editor is also required. If you have
questions regarding vi, please contact Telica Technical Services at 1-888-440-8354.
Procedures for provisioning the Plexus for the ABS are found in the Plexus 9000
Installation and Operation Manual.

Note 1: To avoid local time synchronization problems, Telica strongly


recommends setting both the Plexus and the server system clock to GMT.
For assistance, please contact Telica Technical Services at 1-888-440-8354.
Note 2: Users of the applications are responsible for managing file space
and for any post-processing of records on the server.

Step 1.

The ASCII Billing System (ABS) supports the Plexus 9000, release 3.1.0.0 or
greater, and must meet these prerequisites:

Sun Solaris 7 or 8 with 256 MB memory and a 10/100 Ethernet card


Sun Ultra 10 or Sun Netra X1 at a minimum

Step 2.

Log into the ABS server after obtaining the username and password.

Step 3.

Once logged onto the server, create the upgrade directory in opt/ if it does not
already exist. Do this by typing:

mkdir /opt/PlexViewABS/upgrade

Step 4.

Change to the upgrade directory by typing the following appropriate command:

cd /opt/PlexViewABS/upgrade

Telica, Inc.

9-17

DLP-503

Section 150-500-400
Issue 2, May 13, 2003

In the following steps, the correct version number should be substituted for xx-x-x.
Step 5.

Obtain a copy of the latest AsciiBilling_SunOS_X-X-X-X.tar from a system CD


or from Telica Technical Services (1-888-440-8354) and copy this file to the
upgrade directory on the server.
The tar file will extract directly into /opt/PlexViewABS/upgrade or
/opt/PlexViewAMA/upgrade directory

Step 6.

Untar the AsciiBilling_SunOs_X-X-X-X.tar file by substituting the correct


version number for x-x-x-x and typing:

tar -xvf AsciiBilling_SunOS_X-X-X-X.tar

Step 7.

Compare the new abs.conf file in the upgrade directory with the existing
abs.conf file. A sample of the file is shown in Table 9-C. Sample abs.conf File
found at the end of this procedure. Does the existing abs.conf file require any
changes?
If YES, then continue to the next step.
If NO, then go to Step 9.

Step 8.

Using vi or any available text editor, make the appropriate changes and save. If
using vi, type:

vi abs.conf

Step 9.

Stop the S99PLXAbs or S99PLXAma program by typing the following


appropriate command:

/etc/rc3.d/S99PLXAbs stop

Step 10. Move following file by typing:

mv Version.txt ..

Step 11. Move TelicaAbsSrvr file by typing:

mv TelicaAbsSrvr..

Step 12. If the S99PLXAbs file is different from existing, copy it into the /etc/rc3.d
directory by typing:

cp p S99PLXAbs /etc/rc3.d

9-18

Telica, Inc.

Section 150-500-400
Issue 2, May 13, 2003

DLP-503

Step 13. Start the S99PLXAbs program by typing:

/etc/rc3.d/S99PLXAbs start

Step 14. Verify that the billing process has started by typing:

ps ef | grep Tel

Step 15. Change to the directory defined by DATA_DIR in the abs.conf file by typing
the following and substituting the correct name for <DATA_DIR>:

cd /opt/PlexViewABS/data

Step 16. Tail the log file to verify connection to switch by typing:

tail abs.log

Step 17. Do you want to logout of the server at this time?


If YES, then logout by typing exit

If NO, then continue to the next step.


Step 18.

YOU HAVE COMPLETED THIS PROCEDURE.

Table 9-C. Sample abs.conf File


#
#
#
#

FileName: abs.conf
Telica ASCII Billing Server configuration environment
Server TCP listen Port number and working directory
SERVER_PORT
1983

Working Directory - contains data, connection info and log files


DATA_DIR
data

#
#
#
#
#

ASCII Billing file writing/creation frequency in minutes


Must be integer interval of minutes within 24 hours. Intervals are
always based on an initial start time of Midnight.
Defaults to 24 Hours (60min * 24hr = 1440 min)
Valid values = 5-1440
FREQUENCY
1440

#
#
#
#

Uncomment the following line to have raw CDR records from the
switch archived with the same frequency as AMA data files.
The archive files use the same name, but the extension is .dat
The value define the number of days an archive file is left on the

Telica, Inc.

9-19

DLP-503

Section 150-500-400
Issue 2, May 13, 2003

#
#
#

system before it is automatically deleted.


WARNING: This may require a VERY large disk!
ARCHIVE
31

#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#

Client switches (usually SPA/SPB pairs use the same prefix but it
is not a requirement)
Prefix may be followed by TZ and/or SensorID/OfficeID.

9-20

TZ specifies the client's time zone.Clients which have the


same prefix should be in the same time zone. Time zone is used to
calculate the time in the file names.
For detailed description of the rules for defining TZ,
See environ(5) for a description of the TZ environment variable.
TZ values used in US:
EST5EDT
(Eastern Time, Daylight Savings Time applies)
CST6CDT
(Central Time, Daylight Savings Time applies)
PST8PDT
(Pacific Time, Daylight Savings Time applies)
MST7MDT
(Mountain Time, Daylight Savings Time applies)
If the configured TZ is invalid, then GMT, if no TZ is provided
then server's time zone is used for time calculations.
SensorID/OfficeID will override
the AMA Sensor ID and/or Recording Office ID sent from the switch.
Valid SensorID/OfficeID values = 000000-999999
Plexus-9000 host processors (name or doted IP address)
CLIENT name or IP
File Prefix
------ -------------------CLIENT bostonSPA
Boston
TZ=EST5EDT
CLIENT bostonSPB
Boston
TZ=EST5EDT
CLIENT
CLIENT

sfoSPA
sfoSPB

SanFrancisco
SanFrancisco

CLIENT
CLIENT

denverSPA
denverSPB

DenverA
DenverB

TZ=MST7MDT
TZ=MST7MDT

CLIENT
CLIENT

10.0.0.26
10.0.0.27

Marlboro
Marlboro

SensorID=345678:OfficeID=901234

SensorID=123456
OfficeID=789012

Telica, Inc.

Section 150-500-400
Issue 2, May 13, 2003

DLP-511

DLP-511 - INSTALL AND PROVISION AMA LITE APPLICATION


SUMMARY: This procedure provides instructions for installing and configuring the
AMA Lite application on the Sun server. It also provides steps to verify that the
application has started properly.
This procedure assumes that the server to run the AMA Lite application has already been
installed on the same network as the Plexus and is configured with sufficient disk space.
Knowledge of UNIX and the vi command or other text editor is also required. If you
have questions regarding vi, please contact Telica Technical Services at 1-888-440-8354.
Procedures for provisioning the Plexus for the AMA Lite are found in the Plexus 9000
Installation and Operation Manual.

Note 1: To avoid local time synchronization problems, Telica strongly


recommends setting both the Plexus and the AMA Lite server system clock
to GMT. For assistance, please contact Telica Technical Services at 1-888440-8354.
Note 2: Users of the AMA Lite application are responsible for managing
file space and for any post-processing of ASCII billing records on the AMA
Lite server.
Caution: When using the AMA Lite application, it is possible to fill the
server's data directory to a point where the 'ls' command will not display
the contents of the data directory. To prevent this from happening, Telica
suggests that the previous month's data files be removed from the data
directory during the first week of a new month.

Step 1.

The AMA Lite application supports the Plexus 9000, release 1.3 (3.1.1.1), 3.5
and 4.3 (3.4.3) or greater, and must meet these prerequisites:

Telica, Inc.

Sun Solaris 7 or 8 with 256 MB memory and a 10/100 Ethernet


card
Sun Ultra 10 or Sun Netra X1 at a minimum

9-21

DLP-511

Section 150-500-400
Issue 2, May 13, 2003

Step 2.

Log into the AMA Lite server as root after obtaining the username and
password.

Step 3.

Once logged onto the AMA Lite server, create the AMA Lite base directory in
opt/. Do this by typing:

mkdir /opt/PlexViewAMA

Step 4.

Change to the PlexView AMA directory by typing:

cd /opt/PlexViewAMA

Note: In the following steps, the correct version number should be substituted
for x-x-x-x.
Step 5.

Obtain a copy of the latest PLXsAMA_Billing_SunOS_X-X-X-X.tar file from a


system CD or from Telica Technical Services (1-888-440-8354) and copy this
file to the PlexViewAMA directory on the AMA Lite server.

Note: The tar file will extract directly into /opt/PlexViewAMA.


Step 6.

Untar the PLXsAMA_Billing_SunOS_X-X-X-X.tar file by substituting the


correct version number for x-x-x-x and typing:

tar -xvf PLXsAMA_Billing_SunOS_X-X-X-X.tar

Step 7.

Using vi or any available text editor, edit the newly created configuration file
template. Refer to Table 9-D for an example of the ama.conf file. The only
fields that should be modified are highlighted in bold in the sample ama.conf
file as shown in . If using vi, type:

vi ama.conf

Step 8.

Change the frequency of creating/writing billing files if required. The range is


from 5 to 1440 minutes.

Step 9.

If AMA data files that have accumulated will be deleted, remove the comment
symbol (#) at the beginning of the PURGENULLDATA True line

9-22

Telica, Inc.

Section 150-500-400
Issue 2, May 13, 2003

DLP-511

Table 9-D. Sample ama.conf File


#
#
#
#

FileName: ama.conf
Telica AMA Billing Server configuration environment

Working Directory - contains data, connection info and log files


DATA_DIR
ama_data

#
#
#
#
#

AMA Billing file writing/creation frequency in minutes


Must be integer interval of minutes within 24 hours.
Intervals are always based on an initial start time of Midnight.
Defaults to 24 Hours (60min * 24hr = 1440 min)
Valid values = 5-1440
FREQUENCY
1440

#
#
#

Uncomment the following line to have AMA data file that have
accumulated zero records deleted when we rotate filenames to
the next collection interval every FREQUENCY minutes.
PURGENULLDATA True

#
#
#
#
#
#
#

Uncomment the following line to have raw CDR records from the
switch archived with the same frequency as AMA data files.
The archive files use the same name, but the extension is .dat
The value define the number of days an archive file is left on the
system before it is automatically deleted.
WARNING: This may require a VERY large disk!
ARCHIVE
31

#
#
#
#
#
#
#
#
#
#
#
#
#
#
#

Client switches (usually SPA/SPB pairs use the same prefix but it
is not a requirement)
Prefix may be followed by TZ and/or SensorID/OfficeID.

#
#
#
#
#
#
#

If the configured TZ is invalid, then GMT, if no TZ is provided


then server's time zone is used for time calculations.

Server TCP listen Port number and working directory


SERVER_PORT
1983

TZ specifies the client's time zone.Clients which have the


same prefix should be in the same time zone.Time zone is used to
calculate the time in the header records and in the file names.
For detailed description of the rules for defining TZ,
See environ(5) for a description of the TZ environment variable.
TZ values used in US:
EST5EDT (Eastern Time, Daylight Savings Time applies)
CST6CDT (Central Time, Daylight Savings Time applies)
PST8PDT (Pacific Time, Daylight Savings Time applies)
MST7MDT (Mountain Time, Daylight Savings Time applies)

SensorID/OfficeID will override


the AMA Sensor ID and/or Recording Office ID sent from the switch.
Valid SensorID/OfficeID values = 000000-999999
Plexus-9000 host processors (name or dotted IP address)

Telica, Inc.

9-23

DLP-511

#
#

Section 150-500-400
Issue 2, May 13, 2003

CLIENT
-----CLIENT
CLIENT

name or IP File Prefix


---------- ----------bostonSPA Boston
bostonSPB Boston

CLIENT
CLIENT

sfoSPA
sfoSPB

SanFrancisco
SanFrancisco

CLIENT
CLIENT

denverSPA
denverSPB

DenverA
DenverB

TZ=MST7MDT
TZ=MST7MDT

CLIENT
CLIENT

10.0.0.26
10.0.0.27

Marlboro
Marlboro

SensorID=345678:OfficeID=901234

TZ=EST5EDT
TZ=EST5EDT

SensorID=123456
OfficeID=789012

Note: There can be up to sixteen (16) CLIENT entries for connection to up to eight (8)
Plexus 9000 switches. Delete extra CLIENT entries.
Step 10. If billing files will be archived, remove the comment symbol (#) at the
beginning of the line and set the number of days for saving archived files.
If ARCHIVE is set to a value other than 0, then raw CDR records from the
switch are archived with the same frequency as the ASCII Billing files. The file
name of the raw file is the same with the ASCII Billing file, but the extension is
.dat. The ARCHIVE value defines the number of days a .dat file is left on the
system before it is automatically deleted. The maximum number of days is 62.
Step 11. Enter the IP addresses or names of the Clients SPs that will send billing files to
the server. IP addresses are the addresses set on each Plexus with the
ED-CHASSIS-EQPT TL1 command. Names are obtained using DNS lookup.
Delete extra CLIENT entries.
Step 12. Enter the prefix name for the files to be received from each switch. Typically
the prefix is the same for both SPs of a Plexus.
Step 13. Have all the Clients and Prefixes required been entered?
If YES, then continue to the next step.
If NO, then go to Step 11.
Step 14. The TZ (time zone), SensorID and Office/ID fields are optional fields. If
required, enter the values for the SensorID and Office/ID which will override
the AMA Sensor ID and/or Recording Office ID sent from the switch. Valid
SensorID/OfficeID values between 000000 and 999999.
Step 15. Copy the S99PLXsAma file into the /etc/rc3.d directory by typing:

cp p S99PLXsAma /etc/rc3.d

9-24

Telica, Inc.

Section 150-500-400
Issue 2, May 13, 2003

DLP-511

Step 16. Start the S99PLXsAma program by typing:

/etc/rc3.d/S99PLXsAma start

Step 17. Verify that the billing process has started by typing:

ps ef | grep TelicaAmaSrvr

Step 18. Change to the directory defined by DATA_DIR in the ama.conf file by
typing the following and substituting the correct name for <DATA_DIR>:

cd /opt/PlexViewAMA/ama_data

Step 19. Verify that a log file and connection info file have been created (ama.log and
ama.conn) by typing:

ls l ama.*

Step 20. If provisioning for billing must be completed at the Plexus 9000, refer to the
Plexus 9000 Installation and Operation Manual and NTP-018.
Step 21. Generate calls to or from any of the subscribers provisioned on the Plexus.
Note: AMA binary files of billing records, <PREFIX>_yyyymmdd_time.ama,
are created in accordance to the frequency defined in the ama.conf file. These
are binary ama records.
ama.log contains information regarding the connections (new connections, lost
connections, error messages).
Step 22. Do you want to view the ama.log file?
If YES, then view file by typing the following:

more ama.log

If NO, then continue to the next step.


Step 23. Do you want to logout of the AMA Lite server at this time?
If YES, then logout by typing exit

If NO, then continue to the next step.


Step 24.

Telica, Inc.

YOU HAVE COMPLETED THIS PROCEDURE.

9-25

DLP-511

Section 150-500-400
Issue 2, May 13, 2003

NOTES:

9-26

Telica, Inc.

Section 150-500-400
Issue 2, May 13, 2003

DLP-512

DLP-512 - EDIT CONFIGURATION FILES FOR AMA LITE


SUMMARY:
AMA Lite.

This procedure provides the steps to edit the configuration files for

Knowledge of UNIX and the vi command or other text editor is also required. If you
have questions regarding vi, please contact Telica Technical Services at 1-888-440-8354.
Procedures for provisioning the Plexus for the AMA Lite are found in the Plexus 9000
Installation and Operation Manual.

Caution: When using the ASCII Billing System, it is possible to fill the
server's data directory to a point where the 'ls' command will not display
the contents of the data directory. To prevent this from happening, Telica
suggests that the previous month's data files be removed from the data
directory during the first week of a new month.

Step 1.

Log into the AMA Lite server as root after obtaining the username and
password of the chosen AMA Lite server. Write access is required if the
checked file requires changes.

Step 2.

Once logged onto the AMA Lite server, type:

cd /opt/PlexViewAma

Step 3.

Using vi or any available text editor, add new switches (IP address or host name
and prefix) as shown in Table 9-E. Remember to save the .conf files before
exiting. Type:

vi ama.conf

Telica, Inc.

9-27

DLP-512

Section 150-500-400
Issue 2, May 13, 2003

Table 9-E . ama.conf File


#
#
#
#

FileName: ama.conf
Telica Billing Server configuration environment
Server TCP listen Port number and working directory
SERVER_PORT
1983

Working Directory - contains data, connection info and log files


DATA_DIR
ama_data

#
#
#
#
#

AMA Billing file writing/creation frequency in minutes


Must be integer interval of minutes within 24 hours. Intervals
are always based on an initial start time of Midnight.
Defaults to 24 Hours (60min * 24hr = 1440 min)
Valid values = 5-1440
FREQUENCY
1440

#
#
#
#

Uncomment the following line to have AMA data file that have
accumulated zero records deleted when we rotate filenames to the
next collection interval every FREQUENCY minutes.
PURGENULLDATA True

#
#
#
#
#
#
#

Uncomment the following line to have raw CDR records from the
switch archived with the same frequency as AMA data files.
The archive files use the same name, but the extension is .dat
The value define the number of days an archive file is left on the
system before it is automatically deleted.
WARNING: This may require a VERY large disk!
ARCHIVE
0

#
#
#
#
#
#

Client switches (usually SPA/SPB pairs use the same prefix but it
is not a requirement)
The prefix may be followed by an optional field that will override
the AMA Sensor ID and/or Recording Office ID sent from the switch.
Valid SensorID/OfficeID values = 000000-999999
Plexus-9000 host processors (name or dotted IP address)

#
#

CLIENT
-----CLIENT
CLIENT

name or IP
---------bostonSPA
bostonSPB

File Prefix
----------Boston
Boston

CLIENT
CLIENT

sfoSPA
sfoSPB

SanFrancisco
SanFrancisco

CLIENT
CLIENT

denverSPA
denverSPB

DenverA
DenverB

CLIENT
CLIENT
CLIENT

10.0.0.26 Marlboro
10.0.0.27 Marlboro
See Note below.

SensorID=123456
OfficeID=789012
SensorID=345678:OfficeID=901234

Note: There can be up to sixteen (16) CLIENT entries for connection to up to eight (8)
Plexus 9000 switches. Delete extra CLIENT entries.

9-28

Telica, Inc.

Section 150-500-400
Issue 2, May 13, 2003
Step 4.

DLP-512

Stop the AMA Lite Server by typing the following:

/etc/rc3.d/S99PLXsAma stop

Step 5.

Start the AMA Lite Server by typing the following:

/etc/rc3.d/S99PLXsAma start

Step 6.

Verify process is running by typing the following:

ps ef | grep TelicaAmaSrvr

Step 7.

Logout of the AMA Lite server by typing:

exit

Step 8.

Telica, Inc.

YOU HAVE COMPLETED THIS PROCEDURE.

9-29

DLP-512

Section 150-500-400
Issue 2, May 13, 2003

NOTES:

9-30

Telica, Inc.

Section 150-500-400
Issue 2, May 13, 2003

DLP-513

DLP-513 - UPGRADE THE AMA LITE APPLICATION


SUMMARY: This procedure provides instructions for upgrading the AMA Lite
application on a Sun server.
Knowledge of vi or other text editor is also required. If you have questions regarding vi,
please contact Telica Technical Services at 1-888-440-8354.
Procedures for provisioning the Plexus for the AMA Lite application are found in the
Plexus 9000 Installation and Operation Manual.

Note 1: To avoid local time synchronization problems, Telica strongly


recommends setting both the Plexus and the server system clock to GMT.
For assistance, please contact Telica Technical Services at 1-888-440-8354.
Note 2: Users of the applications are responsible for managing file space
and for any post-processing of records on the server.

Step 1.

The AMA Lite application supports the Plexus 9000, release 3.1.0.0 or greater,
and must meet these prerequisites:

Sun Solaris 7 or 8 with 256 MB memory and a 10/100 Ethernet


card
Sun Ultra 10 or Sun Netra X1 at a minimum

Step 2.

Log into the AMA Lite server as root after obtaining the username and
password.

Step 3.

Once logged onto the server, create the upgrade directory in opt/ if it does not
already exist. Do this by typing:

mkdir /opt/PlexViewAMA/upgrade

Step 4.

Change to the upgrade directory by typing the following command:

cd /opt/PlexViewAMA/upgrade
.

Telica, Inc.

9-31

DLP-513

Step 5.

Section 150-500-400
Issue 2, May 13, 2003

Note: In the following steps, the correct version number should be substituted
for x-x-x-x.
Obtain a copy of the latest PLXsAMA_Billing_SunOS_X-X-X-X.tar file from
Telica Technical Services (1-888-440-8354) and copy this file to the upgrade
directory on the server.
Note; The tar file will extract directly into /opt/PlexViewAma/upgrade
directory.

Step 6.

Untar the PLXsAMA_Billing_SunOS_X-X-X-X.tar file by substituting the


correct version number for x-x-x-x and typing:

tar -xvf PLXsAMA_Billing_SunOS_X-X-X-X.tar .


Step 7.

Compare the new ama.conf file in the upgrade directory with the existing
ama.conf file. A sample of the file is shown in Table-9-F found at the end of
this procedure. Does the current ama.conf file require any changes?
If YES, then continue to the next step.
If NO, then go to Step 9.

Step 8.

Using vi or any available text editor, make the appropriate changes and save. If
using vi, type:

vi ama.conf
.
Step 9.

Stop the S99PLXAbs or S99PLXAma program by typing the following


appropriate command:

/etc/rc3.d/S99PLXsAma stop

Step 10. Move following file by typing:

mv Version.txt ..
Step 11. Move following file by typing:

mv TelicaAmaSrvr..

9-32

Telica, Inc.

Section 150-500-400
Issue 2, May 13, 2003

DLP-513

Step 12. If the S99PLXAma file is different from existing, copy it into the /etc/rc3.d
directory and move it to the base directory by typing each of the following:

cp S99PLXsAma /etc/rc3.d

mv S99PLXsAma ..

Comment: Note possible differences in the PLXAMA_RUN_DIR


variable between this and the existing file based on the
installation (Some installations may not be using the standard
installation directory structure and this difference in this file
and the current file is acceptable.
Step 13. Start the S99PLXsAma program by typing:

/etc/rc3.d/S99PLXsAma start

Step 14. Verify that the billing process has started by typing:

ps ef | grep TelicaAmaSrvr

Step 15. Change to the directory defined by DATA_DIR in the ama.conf file by
typing the following and substituting the correct name for <DATA_DIR>:

cd /opt/PlexViewAma/ama_data

Step 16. Tail the log file to verify connection to switch by typing:

tail ama.log

Step 17. Do you want to logout of the server at this time?


If YES, then logout by typing exit
.
If NO, then continue to the next step.
Step 18.

Telica, Inc.

YOU HAVE COMPLETED THIS PROCEDURE.

9-33

DLP-513

Section 150-500-400
Issue 2, May 13, 2003

Table-9-F. ama.conf File


#
#
#
#

FileName: ama.conf
Telica AMA Billing Server configuration environment

Working Directory - contains data, connection info and log files


DATA_DIR
ama_data

#
#
#
#
#

AMA Billing file writing/creation frequency in minutes


Must be integer interval of minutes within 24 hours. Intervals are
always based on an initial start time of Midnight.
Defaults to 24 Hours (60min * 24hr = 1440 min)
Valid values = 5-1440
FREQUENCY
1440

#
#
#

Uncomment the following line to have AMA data file that have
accumulated zero records deleted when we rotate filenames to
the next collection interval every FREQUENCY minutes.
PURGENULLDATA True

#
#
#
#
#
#
#

Uncomment the following line to have raw CDR records from the
switch archived with the same frequency as AMA data files.
The archive files use the same name, but the extension is .dat
The value define the number of days an archive file is left on the
system before it is automatically deleted.
WARNING: This may require a VERY large disk!
ARCHIVE
31

#
#
#
#
#
#
#
#
#
#
#
#
#
#
#

Client switches (usually SPA/SPB pairs use the same prefix but it
is not a requirement)
Prefix may be followed by TZ and/or SensorID/OfficeID.

#
#
#
#
#
#
#

If the configured TZ is invalid, then GMT, if no TZ is provided


then server's time zone is used for time calculations.

9-34

Server TCP listen Port number and working directory


SERVER_PORT
1983

TZ specifies the client's time zone.Clients which have the


same prefix should be in the same time zone.Time zone is used to
calculate the time in the header records and in the file names.
For detailed description of the rules for defining TZ,
See environ(5) for a description of the TZ environment variable.
TZ values used in US:
EST5EDT (Eastern Time, Daylight Savings Time applies)
CST6CDT (Central Time, Daylight Savings Time applies)
PST8PDT (Pacific Time, Daylight Savings Time applies)
MST7MDT (Mountain Time, Daylight Savings Time applies)

SensorID/OfficeID will override


the AMA Sensor ID and/or Recording Office ID sent from the switch.
Valid SensorID/OfficeID values = 000000-999999
Plexus-9000 host processors (name or dotted IP address)

Telica, Inc.

Section 150-500-400
Issue 2, May 13, 2003

#
#

DLP-513

CLIENT
-----CLIENT
CLIENT

name or IP File Prefix


---------- ----------bostonSPA Boston
bostonSPB Boston

CLIENT
CLIENT

sfoSPA
sfoSPB

SanFrancisco
SanFrancisco

CLIENT
CLIENT

denverSPA
denverSPB

DenverA
DenverB

TZ=MST7MDT
TZ=MST7MDT

CLIENT
CLIENT

10.0.0.26
10.0.0.27

Marlboro
Marlboro

SensorID=345678:OfficeID=901234

TZ=EST5EDT
TZ=EST5EDT

SensorID=123456
OfficeID=789012

Note: There can be up to sixteen (16) CLIENT entries for connection to up to eight (8)
Plexus 9000 switches. Delete extra CLIENT entries.

Telica, Inc.

9-35

DLP-513

Section 150-500-400
Issue 2, May 13, 2003

NOTES:

9-36

Telica, Inc.

Section 150-500-400
Issue 2, May 13, 2003

DLP-514

DLP-514 - CREATE AND READ AMA FILE


SUMMARY:
This procedure provides steps to create an ama file from a raw data file
and then to read it.
Knowledge of UNIX and the vi command or other text editor is also required. If you
have questions regarding vi, please contact Telica Technical Services at 1-888-440-8354.
Procedures for provisioning the Plexus for the Traffic Collection Application (TCA) are
found in the Plexus 9000 Installation and Operation Manual.

Step 1.

Select your task from the following and go to the indicated step.

Step 2.

Create an *.ama file from a raw data file ...................................... Step 2

Delete a trunk group profile used for billing purposes................ Step 14

Finished, no other task in the above list .......... continue to the next step.
YOU HAVE COMPLETED THIS PROCEDURE.

Note: The following steps create an *.ama file from a raw data file.
Step 3.

Log into the AMA Lite server after obtaining the username and password.

Step 4.

Change to the export directory by typing the following appropriate command:

cd /opt/PlexViewAMA/

Telica, Inc.

9-37

DLP-514

Step 5.

Section 150-500-400
Issue 2, May 13, 2003
Run the program to create an AMA file from raw data by typing:

./TelicaAmaSrvr F <prefix> <input dir>


<output dir> [<date time stamp>]

Where <prefix> =
<input dir> =
<output dir> =
[<date time stamp>] =

prefix name
ama_data
test
i.e., 20020926_1000

Example: ./TelicaAmaSrvr F <prefix> ama_data

test 20020926_1000
.
Step 6.

Change to the test directory by typing the following command:

cd test

Step 7.

Verify that a new ama file has been created by typing:

ls -l

Step 8.

If multiple raw data files are to be converted, then put all the raw data (*.dat)
files into one directory.

Step 9.

Run the following by typing:

./TelicaAmaSrvr -F newdir_data test

where newdir_data is the directory where the raw data files are located.
Step 10. To stop the above process, type:

ps -ef |grep -i Tel

Step 11. Look for pid in the process (i.e., /TelicaAmaSrvr -F ama_data test
20020926_1000} and note the pid.
Step 12. Stop the process by typing the following with the pid noted in the previous step:

kill <pid>

Step 13. Do you want to create another ama file from a raw data file?
If YES, then go to Step 5.
If NO, then go to Step 1.

9-38

Telica, Inc.

Section 150-500-400
Issue 2, May 13, 2003

DLP-514

Note: The following steps will read an *.ama file.


Step 14. Log into the AMA Lite server after obtaining the username and password.
Step 15. Change to the opt directory by typing the following appropriate command:

cd /opt/PlexViewAMA/

Step 16. Start logging using the "Terminal Start Logging" option on the Telnet window
or using the capture text on Hyper terminal.
Step 17. Execute the following command by typing substituting the correct name for
<name>:

./dump_dms_ama ama_data/<name>.ama |more

Step 18. The previous step should output the AMA data. Refer to Example A. for a
sample.
Step 19. Do you want to read another ama file?
If YES, then go to Step 17.
If NO, then go to Step 1.

Example A.
****STRUCTURE CODE 9999**** header record
recDes
= 00200000
hexId
= AA
structCode
= 09999C
callType
= 999C
version
= 00101C
create_date
= 20926C
create_time
= 1500010C
close_date
= 20926C
close_time
= 1600000C
records
= 000025184C
****STRUCTURE CODE 0625****
recDes
= 006C0000
hexId
= AA
structCode
= 40625C
callType
= 720C

Telica, Inc.

9-39

DLP-514

Section 150-500-400
Issue 2, May 13, 2003

sensorType
= 195C
sensorId
= 0972728C
rcrdOfficeType
= 195C
rcrdOfficeId
= 0000195C
date
= 20926C
timingInd
= 00000C
studyInd
= 0000000C
answerInd
= 0C
servObsrvdTrafSampled = 0C
operatorAction
= 0C
serviceFeature
= 000C
origNPA
= 972C
origNumber
= 7282410C
overseasInd
= 0C
termNPA
= 00702C
termNumber
= 4574020C
answerTime
= 0947420C
elapsedTime
= 000012001C
icIncPrefix
= 00009C
carrierConnectDate
= 20926C
carrierConnectTime
= 0947390C
carrierElapsedTime
= 000012031C
icIncCallEventStatus
= 010C
trunkGroupNumber
= 31002C
routingInd
= 0C
dialingInd
= 0C
aniInd
= 0C
****MODULE 104****
moduleCode
= 104C
trunkIdentNumber
= 510022044C
****MODULE 164****
moduleCode
= 164C
numberIdentity
= 3C
countryCodeOrDNIC
= 00000C
sigDigitsInNext
= 010C
digits
=
000009724415203C
****TERMINATOR MODULE CODE zero****

9-40

Telica, Inc.

Section 150-500-400
Issue 2, May 13, 2003

DLP-515

DLP-515 DISABLE PORTS FOR SECURITY


SUMMARY:
This procedure provides instructions for disabling unnecessary ports
for Lynx OS security.
Knowledge of UNIX and the vi command or other text editor is also required. If you
have questions regarding vi, please contact Telica Technical Services at 1-888-440-8354.
Procedures for provisioning the Plexus for the Traffic Collection Application (TCA) are
found in the Plexus 9000 Installation and Operation Manual.
This procedure assumes you have some basic understanding of the operation of the
Plexus 9000. You should have knowledge of entering TL1 commands and of their usage.
More information about TL1 command syntax, system responses, and an explanation of
error messages can be found in the TL1 Command Reference Guide.
Note:
In this procedure the command syntax and examples are in
courier font. The command verb and modifiers, TID and CTAG,
appear in uppercase. [Square brackets] enclose a parameter that is optional
and can be omitted. Variables appear in lowercase, in <angle brackets>, and
require site-specific information. For example:
ENT-USER-SECU:[TID]::<uid>:[CTAG]::<pid>
Variable definitions except for TID and CTAG appear beneath each
command. Default values are shown in bold. Integer ranges are shown
within braces (i.e., {0 . . . 100}).
The TID is the target identifier that is used to identify target network
elements. The TID may consist of 1 to 20 ASCII characters.
The CTAG is the correlation tag that is used to correlate an input command
with a corresponding response message. The CTAG is a decimal number of
six characters or less.
The COMPLD message in the system response indicates that the command
has executed successfully.
The DENY message in the system response indicates the command was not
executed. This most commonly occurs when the input command was not
entered correctly. You should verify the command syntax in the TL1
Commands Reference Guide, and then execute that command again.

Telica, Inc.

9-41

DLP-515

Step 1.

Section 150-500-400
Issue 2, May 13, 2003

Telnet into the Lynx OS of the active or working Plexus System Processor (SP)
and log into Lynx OS the after obtaining the username and password.
Command Example: telnet 10.9.252.1
Response:

Trying 10.9.252.1...
Connected to 10.9.252.1.
Escape character is '^]'.
SunOS 5.8
login: root
Password: ********

Step 2.

In a second window, Telnet into the Lynx OS of the standby or protection


Plexus SP and log into Lynx OS the after obtaining the username and
password..
Command Example: telnet 10.9.252.2
Response:
Trying 10.9.252.2...
Connected to 10.9.252.2.
Escape character is '^]'.
SunOS 5.8
login: root
Password: ********

Step 3.

In the first window change to the etc directory.

cd /etc

Step 4.

In the first window make a copy of the services file to preserve it in case you
need to back out of changes.

cp services oldservices

Step 5.

In the first window rename the exports file to

mv exports noexports

Step 6.

In the second window change to the etc directory.

cd /etc

9-42

Telica, Inc.

Section 150-500-400
Issue 2, May 13, 2003
Step 7.

DLP-515

In the second window make a copy of the services file to preserve it in case you
need to back out of changes.

cp services oldservices

Step 8.

In the second window rename the exports file to

mv exports noexports

Step 9.

In the first window, open the original services file for editing.

vi services

Step 10. Comment the lines containing TFTP, NFS and sunrpc ports by inserting a
pound sign ( # ) at the beginning of these lines.
Step 11. Cancel the session in the first window by typing the following:

exit

Step 12. In the second window, open the original services file for editing.

vi services

Step 13. Comment the lines containing TFTP, NFS and sunrpc ports by inserting a
pound sign ( # ) at the beginning of these lines.
Step 14. Cancel the session in the second window by typing the following:

exit

Step 15. Telnet to the IP address of the active or working System Processor entering
2361 for Port.
Command Example: telnet 10.9.252.1 2361
Step 16. Press the Escape key once (twice if necessary) and the login screen should be
displayed. Refer to Figure 9-1 for an illustration of the login screen.
TELICA IPort 7 TL1 Agent

1999-2000 Telica Inc.

Telica>
Figure 9-1. Craft-port Login Screen

Telica, Inc.

9-43

DLP-515

Section 150-500-400
Issue 2, May 13, 2003

Step 17. Log on to the system using the ACT-USER command.


Command Syntax: ACT-USER:[TID]:<uid>:[CTAG]::<pid>;
Command Example: ACT-USER::telica:::telica;
Comment: When entering the password, it will be masked with an
asterisk (*) for each character (e.g., ACTUSER::telica:::******;)
Step 18. Switch the working processor to protection by using the SW-TOPROTN
command.
Command Syntax: SW-TOPROTN-EQPT:[TID]:<sw_id>:
[CTAG];
Command Example: SW-TOPROTN-EQPT:[TID]:sp-a;
Step 19. Telnet to the IP address of the now active or working System Processor and
enter 2361 for Port and.
Command Example: telnet 10.9.252.2 2361
Step 20. Log on with the ACT-USER command.
Command Example: ACT-USER::telica:::telica;
Step 21. Wait for the System Processors to synchronize with each other. This is
indicated with an autonomous message.
Output Example:
telica 2001-06-27 13:28:36
A 11 REPT EVT EQPT
"SP-B:INIT-51,TC,06-27,13-2835,,,,,:\"Protection SP-A is synchronized and
ready to provide service\""
Step 22. Ensure that the protection System Processor has a state of IS and STBYH and
the new version is shown by using the RTRV-EQPT command before
continuing to the next step.
Command Example: RTRV-EQPT;

9-44

Telica, Inc.

Section 150-500-400
Issue 2, May 13, 2003

DLP-515

Step 23. Switch the now working processor to protection by using the SW-TOPROTN
command.
Command Syntax: SW-TOPROTN-EQPT:[TID]:<sw_id>:
[CTAG];
Command Example: SW-TOPROTN-EQPT:[TID]:sp-b;
Step 24. Wait until both side have synchronized with each other.
Step 25. Run your port scan program and verify that security parameters are met.
Step 26.

Telica, Inc.

YOU HAVE COMPLETED THIS PROCEDURE.

9-45

DLP-515

Section 150-500-400
Issue 2, May 13, 2003

NOTES:

9-46

Telica, Inc.

Section 150-500-400
Issue 1, November 7, 2003

DLP-516

DLP-516 - CREATE AND READ AMA FILE WHEN USING BTS


SUMMARY:
This procedure provides steps to create an ama file from a raw data file
and then to read it.
Knowledge of UNIX and the vi command or other text editor is also required. If you
have questions regarding vi, please contact Telica Technical Services at 1-888-440-8354.
Procedures for provisioning Billing and Traffic in the Plexus are found in the Plexus
9000 Installation and Operation Manual.

Step 1.

Select your task from the following and go to the indicated step.

Step 2.

Create an *.ama file from a raw data file ...................................... Step 3

Using dump_dms_ama ................................................................ Step 14

Finished, no other task in the above list .......... continue to the next step.
YOU HAVE COMPLETED THIS PROCEDURE.

Note: The following steps create an *.ama file from a raw data file.
Step 3.

Log into the BTS server after obtaining the username and password.

Step 4.

Change to the directory where the dat file resides. The following is only an
example.

cd
Step 5.

Copy the dat file to be replayed to /export/home/opt/PlexDC/RAW.

cp
Step 6.

/PlexDc/plexDc1

<filename>.dat

/opt/PlexDC/RAW

Change to the export directory by typing the following appropriate command:

cd

Telica, Inc.

/opt/PlexDC/RAW

9-47

DLP-516

Step 7.

Section 150-500-400
Issue 1, November 7, 2003
Execute the following by typing where <replayfile> is the
name_of_file_being_replayed:

../raw_to_server r p 1986 <replayfile>


statserver2

Completion response:
processed x records'processed x records in y seconds
Step 8.

Change to the baf directory by typing the following command:

cd ./Bill_data/baf

Step 9.

Verify that a new file has been created by typing:

ls -orta

Comment: The last file listed (the one beginning with a period) will be
the file containing the newly washed AMA records. The file
header will not be complete until the top of the hour when the
file is rolled. Once the file is rolled, the header will be
complete and then the file can be run through a back end
system.
Step 10. Was the file created?
If YES, then go to Step 1.
If NO, then call Telica Technical Services at 1-888-440-8354.

Note: The following steps will run dump_dms_ama.


Step 11. Log into the BTS server after obtaining the username and password.
Step 12. Change to the baf directory by typing the following appropriate command:

cd /opt/PlexDC/<switch_name>/Bill_data/baf

Step 13. Execute the following command by typing substituting the correct name for
<name>:

./dump_dms_ama <name> |more

Step 14. The previous step should output the AMA data. Refer to Example B for a
sample.

9-48

Telica, Inc.

Section 150-500-400
Issue 1, November 7, 2003

DLP-516

Step 15. To save the data to a file, execute the following command by typing
substituting the correct name for <name> and the new file name for
<filename>:

./dump_dms_ama <name> > <filename>

Step 16. Do you want to read another ama file?


If YES, then go to Step 17.
If NO, then go to Step 1.

Example B
****STRUCTURE CODE 0625****
recDes
= 00B60000
hexId
= AA
structCode
= 40625C
callType
= 720C
sensorType
= 195C
sensorId
= 0702266C
rcrdOfficeType
= 195C
rcrdOfficeId
= 0000195C
date
= 31028C
timingInd
= 00000C
studyInd
= 0000000C
answerInd
= 0C
servObsrvdTrafSampled = 0C
operatorAction
= 0C
serviceFeature
= 000C
origNPA
= 702C
origNumber
= 3862222C
overseasInd
= 0C
termNPA
= 00702C
termNumber
= 6783020C
answerTime
= 0957001C
elapsedTime
= 000003000C
icIncPrefix
= 00009C
carrierConnectDate
= 31028C

carrierConnectTime
carrierElapsedTime

Telica, Inc.

= 0956570C
= 000003032C

9-49

DLP-516

Section 150-500-400
Issue 1, November 7, 2003
icIncCallEventStatus
= 010C
trunkGroupNumber
= 31003C
routingInd
= 0C
dialingInd
= 0C
aniInd
= 0C
****MODULE 720****
moduleCode
= 720C
partyIdentifier
= 002C
locationRoutingNumber = 07022669921C
serviceProviderIdent
= FFFFFFFFFF
location
= FFFFFFFFFFFFFFFF
supportingInfo
= 3090000C
****MODULE 720****
moduleCode
= 720C
partyIdentifier
= 001C
locationRoutingNumber = 07026780000C
serviceProviderIdent
= FFFFFFFFFF
location
= FFFFFFFFFFFFFFFF
supportingInfo
= 3090000C
****MODULE 612****
moduleCode
= 612C
genericContextId
= 9000030C
digitsString1
= 070112000030414C
digitsString2
= 070104000032321C
****MODULE 611****
moduleCode
= 611C
genericContextId
= 8001410C
digitsString
= 000000004066468C
****MODULE 104****
moduleCode
= 104C
trunkIdentNumber
= 110031646C
****TERMINATOR MODULE CODE zero****

9-50

Telica, Inc.

Section 150-500-400
Issue 4, January 9, 2004

DLP-521

DLP-521 - INSTALL AND PROVISION TRAFFIC COLLECTION


APPLICATION (TCA)
SUMMARY: This procedure provides the installation and configuration steps required
to gather statistical information from Plexus switches.
This procedure assumes that the server to run TCA has already been installed on the same
network as the Plexus and is configured with sufficient disk space.
Knowledge of UNIX and the vi command or other text editor is also required. If you
have questions regarding vi, please contact Telica Technical Services at 1-888-440-8354.
Procedures for provisioning the Plexus for the Traffic Collection Application (TCA) are
found in the Plexus 9000 Installation and Operation Manual.
Note 1: Users of TCA are responsible for managing file space the TCA
server.
Note 2: The Enter key, indicated by , must always follow inputs that you
enter.

Step 1.

TCA supports the Plexus 9000, release 1.3 (3.1.1.3), 3.5 and 4.3 (3.4.3) or
greater, and must meet these prerequisites:

Sun Solaris 7 or 8 with 256 MB memory and a 10/100 Ethernet


card
Sun Ultra 10, at a minimum

Note: The following steps are performed at the TCA server.


Step 2.

Will TCA run on the BTS server or on a separate TCA server?


If on the BTS server, then continue to the next step.
If on a TCA server, then go to Step 5.

Step 3.

Log into the BTS server as root after obtaining the username and password.

Step 4.

Change to the PlexView BTS directory by typing the following and then go to
Step 9.

cd /opt/PlexDC

Telica, Inc.

9-51

DLP-521

Section 150-500-400
Issue 4, January 9, 2004

Step 5.

Log into the TCA server as root after obtaining the username and password of
the chosen TCA server.

Step 6.

Once logged onto the TCA server, change directories by typing:

cd /opt .
Step 7.

Create the TCA base directory in opt/. Do this by typing:

mkdir PlexStats

Step 8.

Change to the TCA directory by typing:

cd /opt/PlexStats

Note: In the following steps, the correct version number should be substituted
for x.x.x.x.
Step 9.

If you do not have a Traffic Collection Application CD ROM with the


TCA_X.X.X.X.tar.gz file or a copy of the TCA_X.X.X.X.tar.gz file, obtain a copy
from Telica Technical Services at 1-888-440-8354.

Step 10. Will TCA run on the BTS server or on a TCA server?
If on the BTS server, copy this file to the PlexDC directory on the BTS
server.
If on a TCA server, copy this file to the PlexStats directory on the TCA
server.
Step 11. Ensure you are in the PlexDC directory if installing on the same server as the
BTS application or in the PlexStats directory if installing a separate TCA
server.
Step 12. Untar TCA_X.X.X.X.tar.gz file by substituting the correct version number for
x.x.x.x and typing:

gunzip -xvf TCA_X.X.X.X.tar.gz

Step 13. Untar TCA_X.X.X.X.tar file by substituting the correct version number for
x.x.x.x and typing:

tar -xvf TCA_X.X.X.X.tar

9-52

Telica, Inc.

Section 150-500-400
Issue 4, January 9, 2004

DLP-521

Step 14. Verify that the admin file exists by typing:

ls -l

Partial Sample Response:


-rw-r--r--

1 builder

cvsusers

135 Nov

5 15:44 admin

Step 15. If the admin file does not exist, please contact Telica Technical Services at
1-888-440-8354
Step 16. Type the following command ensuring that you type the period after -d.

pkgadd a admin -d.

Step 17. You will see a response similar to the following? Versions may differ.
Response:
The following packages are available:
1 BTS
Telica BTS application
(sparc) 3.9.0.0.31
2 TCA
Telica TSAA application
(sparc) 2.0.0.66
Select package(s) you wish to process (or 'all'
to process all packages). (default: all)
[?,??,q]:
Step 18. Type the number of the TCA package followed by the Enter key. Ensure that
the BTS package has already been installed because you should always install
the BTS package first.
Step 19. The package add utility will begin its process. For a complete display for
output, refer to Table 9-J.
Step 20. You will see displayed the following lines if there was not a previously
installed version. Ignore.
Looking for previously installed TCA package...
ERROR: information for "TCA" was not found

Telica, Inc.

9-53

DLP-521

Section 150-500-400
Issue 4, January 9, 2004

Step 21. You will see displayed the following lines and you will have to select the mode.
Enter 1 or 2.
TCA product can be installed in two ways:
(1) Just TCA
+ Installs only the TCA (Traffic Collection Application).
(2) TCA + BTS tsaa
+ Installs the TCA (Traffic Collection Application)
+ and copies the tsaa (Telica Statistical Analysis
Application)
+ that comes with the TCA package to the BTS package
installation
+ base directory as tsaaDc.
Which mode do you want
(1)TCA
(2)TCA + BTS tsaa

[?] 2

Step 22. The next line that requires input follows. Press the Enter (<CR> or ) key to
select the default of /opt as indicated in the following example.
Enter TCA pkg installation directory base (default: /opt):

Step 23. If you are installing both TCA and BTS on the same server, you will see the
following. Press the Enter (<CR> or ) key to select the default of /opt.
Enter BTS pkg installation directory base:
(The directory name in which the PlexDC dir resides)
(default: /opt):

Step 24. At the next line require an input, type a y to continue with installation.
This package contains scripts which will be executed with
super-user permission during the process of installing this
package.
Do you want to continue with the installation of <TCA>
[y,n,?] y

9-54

Telica, Inc.

Section 150-500-400
Issue 4, January 9, 2004

DLP-521

Step 25. When finished, you will see the following message displayed:
Installation of <TCA> was successful.
The following packages are available:
1 BTS
Telica BTS application
(sparc) 3.9.0.0.31
2 TCA
Telica TSAA application
(sparc) 2.0.0.66
Select package(s) you wish to process (or 'all'
to process all packages). (default: all) [?,??,q]
Step 26. Type q to quit followed by the Enter key.
Step 27. Do you want if verify and obtain information about application?
If YES, then type the following and then go to Step 29.

pkginfo l TCA

Response:
PKGINST:
NAME:
CATEGORY:
ARCH:
VERSION:
BASEDIR:
VENDOR:
PSTAMP:
INSTDATE:
STATUS:
FILES:

TCA
Telica TSAA application
system
sparc
2.0.0.67
/opt
Telica
dark20031204100621
Jan 06 2004 09:23
completely installed
7 installed pathnames
1 directories
3 executables
1967 blocks used (approx)

If NO, then go to Step 29.


Step 28. Ensure that STATUS is completely installed.
If YES, it is completely installed then continue to the next step.
If NO, then contact Telica Technical Services at 1-888-440-8354.
Step 29. Using vi or any available text editor, modify the tsds.conf file by entering the
host name and client as shown in Table 9-G at the end of this procedure.
Remember to save the tsds.conf files before exiting.
Step 30. Will TCA run on the BTS server or on a separate TCA server?
Telica, Inc.

9-55

DLP-521

Section 150-500-400
Issue 4, January 9, 2004
If on the BTS server, then go to Step 34.
If on a separate TCA server, then continue to the next step.
Note: The terms SwitchName and PlexDCn, where n is a number from 1 to 8,
may be used interchangeably in this procedure, but you should use only one
naming convention.

Step 31. Create a directory for each switch (or the single switch) using the SwitchName
or PlexStatsn where n is a number from 1 to 8.

mkdir <SwitchName>
or

mkdir PlexStatsn
Step 32. Copy the tsaa_template.conf file into the new directory (SwitchName or
plexusStatsn).

cp tsaa_template.conf

<SwitchName>/tsaa_template.conf
Step 33. Have you named directories for all switches and copied the tsaa_template.conf
to these directories?
If YES, then go to Step 36.
If NO, then go to Step 31.
Step 34. When you installed BTS, you created directories for each switch. Copy the
tsaa.conf file into that directory (SwitchName or plexusStatsn).

cp tsaa_template.conf
<SwitchName>/tsaa_template.conf

Step 35. Have you copied the tsaa_template.conf to these directories?


If YES, then continue to the next step.
If NO, then go to Step 34.
Step 36. Change to the directory for a switch.

cd <SwitchName>

9-56

Telica, Inc.

Section 150-500-400
Issue 4, January 9, 2004

DLP-521

Step 37. Copy tsaa_template.conf as tsaa.conf

Cp tsaa_template.conf tsaa.conf

Step 38. Using vi or any available text editor, modify the tsaa_<prefix>.conf file as
shown in Table 9-H at the end of this procedure. Remember to save the
tsaa_<prefix>.conf files before exiting.
Step 39. Is TCA to run on the BTS server or on a separate TCA server?
If on the BTS server, change to the PlexDC directory on the BTS server.

cd PlexDC

If on a TCA server, change to the PlexStats directory on the TCA server.

cd PlexStats

Step 40. You may need to modify the S99PLXStats file lines that read as shown below
using vi or any available text editor. The first lines of this file are shown shown
in Table 9-I at the end of this procedure.
PLXDC_INSTANCES="PlexDc1 PlexDc2"
TSAA_INSTANCES=$PLXDC_INSTANCES

Step 41. If you are running both BTS and TCA on the server there is no need to edit the
TSAA_INSTANCES line.
Step 42. If you are running TCA on a separate server, enter the names of the switches
separated by spaces (i.e., TSAA_INSTANCES="tsaa_bos1.conf
tsaa_bos2.conf). Remember to save the file before exiting.
Step 43. Copy the S99PLXStats file into the /etc/rc3.d directory by typing:

cp p

S99PLXStats /etc/rc3.d

Step 44. Run the BTS admin tool from this location by typing the following and entering
a 1 to start an instance.

./btsadmin

Response is on the following page.

Telica, Inc.

9-57

DLP-521

Section 150-500-400
Issue 4, January 9, 2004
Response:
#######################################################
############
Main Menu
######
1)
2)
3)
4)
5)
6)
7)
8)

Start an Instance
ReStart an Instance
Stop an Instance
Reinitialize an Instance
Start All Instances
Stop All Instances
Status
Exit

Enter the choice:

Step 45. The following menu will appear to allow you to select the switch. Names will
differ depending upon how your switches were named.
Response:
#######################################################
############
Start Menu
######
1)
2)
3)
4)
5)
6)
7)
8)

PlexDC1
PlexDC2
PlexDC3
PlexDC4
PlexDC5
PlexDC6
PlexDC7
PlexDC8

9) Main Menu
Enter the choice: 7

Step 46. The following menu will be displayed allowing to start the BTS
(TelicaPlexusDc), TCA (tsaaDc), both BTS and TCA or return to the main
menu. In the following example, BTS is selected.
Response is on the following page.

9-58

Telica, Inc.

Section 150-500-400
Issue 4, January 9, 2004

DLP-521

Response:
#######################################################
############
Choose Module for PlexDC7
######
1)
2)
3)
4)

TelicaPlexusDc
tsaaDc
Both
Main Menu

Enter the choice: 2

Response:
.
BTSBackupAdmin START Info:
TelicaPlexusDc for "PlexDC7" is started.

Step 47. When the following menu appears, you can check the status of the data
collector by selecting 7.
Response:
#######################################################
############
Main Menu
######
1)
2)
3)
4)
5)
6)
7)
8)

Start an Instance
ReStart an Instance
Stop an Instance
Reinitialize an Instance
Start All Instances
Stop All Instances
Status
Exit

Enter the choice: 7

Response:
BTS STATUS:
PID COMMAND
9335 ./TelicaPlexusDc -C PlexDC8
9307 ./TelicaPlexusDc -C PlexDC4
348 ./tsaaDc -C PlexDC3
352 ./tsaaDc -C PlexDC5
355 ./tsaaDc -C PlexDC7
357 ./tsaaDc -C PlexDC8
9300 ./TelicaPlexusDc -C PlexDC3
9321 PlexDC6/TelicaPlexusDc -C PlexDC6
4123 ./tsaaDc -C PlexDC1
9314 ./TelicaPlexusDc -C PlexDC5
9286 ./TelicaPlexusDc -C PlexDC1
9293 ./TelicaPlexusDc -C PlexDC2

BTSBackupAdmin :

Telica, Inc.

9-59

DLP-521

Section 150-500-400
Issue 4, January 9, 2004

Step 48. When the menu appears, you can make your next selection or exit.
Response:
#######################################################
############
Main Menu
######
1)
2)
3)
4)
5)
6)
7)
8)

Start an Instance
ReStart an Instance
Stop an Instance
Reinitialize an Instance
Start All Instances
Stop All Instances
Status
Exit

Enter the choice: 8

Step 49. Do you want to logout of the TCA server at this time?
If YES, then logout by typing exit

If NO, then continue to the next step.


Step 50. If provisioning for TCA must be completed at the Plexus 9000, refer to the
Plexus 9000 Installation and Operation Manual and NTP-018.

Step 51.

9-60

YOU HAVE COMPLETED THIS PROCEDURE.

Telica, Inc.

Section 150-500-400
Issue 4, January 9, 2004

DLP-521

Table 9-G. Sample tsds.conf File


# FileName: tsds.conf
# Telica Stats Server configuration environment
#
# Server TCP listen Port number and working directory
SERVER_PORT

10000

# Working Directory - contains data, connection info and log files


# DATA_DIR

tsds_data

# Client switches (usually SPA/SPB pairs use the same prefix)


# Plexus-9000 host processors (name or dotted IP address)

# Key

IP-or Host

Prefix

# =====

==========

========

CLIENT

<SP-A IP or Hostname>

<boston>

CLIENT

<SP-B IP or Hostname>

<boston>

CLIENT

See Note below.

Note: There can be up to sixteen (16) CLIENT entries for connection to up to eight (8)
Plexus 9000 switches. Delete extra CLIENT entries.

Telica, Inc.

9-61

DLP-521

Section 150-500-400
Issue 4, January 9, 2004

Table 9-H. Sample tsaa_<prefix>.conf File


#
#
#
#
#
#

FileName: *tsaa.conf
This file contains the configuration information for the
Telica Statistical Analysis Application (TSAA), and should be
modified by authorized personnel only.
Prefix: boston
Input Directory: tsds_data
Output Directory: tsaa_boston
Log Directory: tsaa_boston/log
Percent Blocking: 0.01
Peg Count Report: 1
ASR Report: 1
Hold Time Report: 1
SS7 Trkgrp CCS Report: 3
Intfcgrp CCS Report: 3
CAS Trkgrp CCS Report: 3
BICC Trkgrp CCS Report: 3
SIP Trkgrp CCS Report: 3
GR303 Intfcgrp CCS Report: 3
CAS Intfcgrp CCS Report: 3
ASCII CDR Report: 1
Detailed Peg Report: 1
Calculate DN Peg Count: 1
Busy Hour Granularity: 30
CCS Granularity Period: 4
Peg Count Granularity Period: 4
ASR Granularity Period: 4
Hold Time Granularity Period: 4
Input Storage Duration: 30

Output Storage Duration: 30


FTP to EMS: 0
FTP Transfer Interval: 60

EMS
EMS
EMS
EMS

9-62

IP Address: 127.0.0.1
Username: anonymous
Password: boston
Output Directory: /tsaa_data

Telica, Inc.

Section 150-500-400
Issue 4, January 9, 2004

DLP-521

Table 9-I. S99PLXStats File


#!/sbin/sh
#
# Copyright (c) 2000-2002 by Telica, Inc.
# All rights reserved.
#
# $Id: S99PlexDC,v 1.4 2003/09/04 19:12:05 rthornto Exp $
#
#
#
#
#
#
#
#
#
#

Add the name of each TelicaPlexusDc instance to start to PLXDC_INSTANCES.


These should be the subdirectory names under PLXDC_BASE_DIR
(e.g. PLXDC_INSTANCES="PlexDC1 PlexDC2 SwitchName1 SwitchName2"
A plexusDc.ini configuration file must exist in each subdirectory.
TSAA instances are defined by TSAA_INSTANCES which by default is a copy
of PLXDC_INSTANCES. Set it = "" to stop any TSAA instance from being
started, or set it to the specific subdirectory name to only start
specific instances. A tsaa.conf configuration file must exist in each
subdirectory.

PLXDC_BASE_DIR="/opt/PlexDC/"
PLXDC_INSTANCES="PlexDc1 PlexDc2"
TSAA_INSTANCES="tsaa1 tsaa2"
#
# Only allow this script to run by root

Note: Only the beginning of the file is shown above because only the line indicated in
bold must be modified.

Table 9-J. Display of Package Add


The following packages are available:
1 BTS
Telica BTS application
(sparc) 3.9.0.0.31
2 TCA
Telica TSAA application
(sparc) 2.0.0.66
Select package(s) you wish to process (or 'all' to process
all packages). (default: all) [?,??,q]: 2
Processing package instance <TCA> from </opt/PlexStats>
Telica TSAA application
(sparc) 2.0.0.66
Copyright (c) 2003 Telica, Inc.
734 Forest Street
Building G
Marlboro, MA 01752

Telica, Inc.

9-63

DLP-521

Section 150-500-400
Issue 4, January 9, 2004

Phone: (508) 480-0909


Fax: (508) 480-0922
All rights reserved. This product and related documentation is
protected by
copyright and distributed under licenses restricting its use,
copying,
distribution and decompilation. No part of this product or related
documentation
may be reproduced in any form by any means without prior written
authorization from
Telica.

Looking for previously installed TCA package...


Found TCA Version=2.0.0.62 at "/opt".
Looking for previously installed BTS package...
Found BTS Version=3.9.0.0.31 at "/opt".
TCA product can be installed in two ways:
(1) Just TCA
+ Installs only the TCA (Traffic Collection Application).
(2) TCA + BTS tsaa
+ Installs the TCA (Traffic Collection Application)
+ and copies the tsaa (Telica Statistical Analysis Application)
+ that comes with the TCA package to the BTS package installation
+ base directory as tsaaDc.
Which mode do you want
(1)TCA
(2)TCA + BTS tsaa

[?] 2

TELICA_OPR_MODE=TSAADC

Enter TCA pkg installation directory base (default: /opt): <CR>

Enter BTS pkg installation directory base:


(The directory name in which the PlexDC dir resides)(default: /opt):
<CR>
BTS_BASEDIR=/opt
GROUPNUM=802
Using </opt> as the package base directory.
## Processing package information.
## Processing system information.
7 package pathnames are already properly installed.
## Verifying disk space requirements.
## Checking for conflicts with packages already installed.
## Checking for setuid/setgid programs.
This package contains scripts which will be executed with super-user
permission during the process of installing this package.

9-64

Telica, Inc.

Section 150-500-400
Issue 4, January 9, 2004

DLP-521

Do you want to continue with the installation of <TCA> [y,n,?] y


Installing Telica TSAA application as <TCA>
## Executing preinstall script.
Saving the old conf files to /tmp/TCA_conf_files_2.0.0.66
Copying /opt/PlexStats/*.conf to /tmp/TCA_conf_files_2.0.0.66
total 32
-rw-r----1 root
other
974 Jan 6 09:23 tsaa.conf
-rw-r----1 root
other
544 Jan 6 09:23 tsds.conf
## Installing part 1 of 1.
[ verifying class <util> ]
## Executing postinstall script.
TELICA_OPER_MODE="TCA + BTS tsaa"
Copying /opt/PlexStats/tsaa to /opt/PlexDC as tsaaDc
Copying /opt/PlexStats/tsaa.conf to /opt/PlexDC as tsaa_template.conf
Installation of <TCA> was successful.
The following packages are available:
1 BTS
Telica BTS application
(sparc) 3.9.0.0.31
2 TCA
Telica TSAA application
(sparc) 2.0.0.66
Select package(s) you wish to process (or 'all' to process
all packages). (default: all) [?,??,q]: q

Telica, Inc.

9-65

DLP-521

Section 150-500-400
Issue 4, January 9, 2004

NOTES:

9-66

Telica, Inc.

Section 150-500-400
Issue 3, January 9, 2004

DLP-522

DLP-522 - EDIT CONFIGURATION FILES FOR TRAFFIC


COLLECTION
SUMMARY: This procedure provides the steps to edit the configuration files for the
traffic collection application.
Knowledge of UNIX and the vi command is also required. If you have questions
regarding vi, please contact Telica Technical Services at 1-888-440-8354.
Procedures for provisioning the Plexus for the Traffic Collection Application are found in
the Plexus 9000 Installation and Operation Manual.

Step 1.

Is TCA running on the BTS server or on a separate TCA server?


If on the BTS server, then continue to the next step.
If on a TCA server, then go to Step 5.

Step 2.

Log into the BTS server as root after obtaining the username and password.

Step 3.

Change to the PlexView BTS directory by typing the following and then go to
Step 9.

cd /opt/PlexDC

Step 4.

Log into the TCA server as root after obtaining the username and password of
the chosen TCA server. Write access is required if the checked file requires
changes.

Step 5.

Once logged onto the TCA server, change directories by typing:

cd /opt/PlexStats .
Step 6.

Using vi or any available text editor, modify the tsds.conf configuration file by
adding new IP address or Host names and prefixes or any other required
changes. Refer to Table 9-K. Remember to save the tsds.conf file before
exiting.

vi tsds.conf
.

Telica, Inc.

9-67

DLP-522

Section 150-500-400
Issue 3, January 9, 2004

Table 9-K. tsds.conf File


# FileName: tsds.conf
# Telica Stats Server configuration environment
#
# Server TCP listen Port number and working directory
SERVER_PORT

10000

# Working Directory - contains data, connection info and log files


# DATA_DIR

tsds_data

# Client switches (usually SPA/SPB pairs use the same prefix)


# Plexus-9000 host processors (name or dotted IP address)

# Key

IP-or Host

Prefix

# =====

==========

========

CLIENT

<SP-A IP or Hostname>

<boston>

CLIENT

<SP-B IP or Hostname>

<boston>

CLIENT

See Note below.

Note: There can be up to sixteen (16) CLIENT entries for connection to up to eight (8)
Plexus.

Step 7.

Using vi or any available text editor, modify the new tsaa_<prefix>.conf


configuration file for each new named file. Refer to Table 9-L. Remember to
save the file before exiting.
In Table 9-L, lines that have 0 or 1, a 0 means NO and 1 means YES. On lines
that have a 3 or 4, the choices are 2, 3, 4 or 5 where 2 means 15 minutes, 3
means 30 minutes, 4 means 1 hour and 5 means 1 day. Durations or intervals
are in minute increments.

9-68

Telica, Inc.

Section 150-500-400
Issue 3, January 9, 2004

DLP-522

Table 9-L. tsaa.conf File


#
#
#
#
#
#

FileName: *tsaa.conf
This file contains the configuration information for the
Telica Statistical Analysis Application (TSAA), and should be
modified by authorized personnel only.
Prefix: boston
Input Directory: tsds_data
Output Directory: tsaa_boston
Log Directory: tsaa_boston/log
Percent Blocking: 0.01
Peg Count Report: 1
ASR Report: 1
Hold Time Report: 1
SS7 Trkgrp CCS Report: 3
Intfcgrp CCS Report: 3
CAS Trkgrp CCS Report: 3
BICC Trkgrp CCS Report: 3
SIP Trkgrp CCS Report: 3
GR303 Intfcgrp CCS Report: 3
CAS Intfcgrp CCS Report: 3
ASCII CDR Report: 1
Detailed Peg Report: 1
Calculate DN Peg Count: 1
Busy Hour Granularity: 30
CCS Granularity Period: 4
Peg Count Granularity Period: 4
ASR Granularity Period: 4
Hold Time Granularity Period: 4
Input Storage Duration: 30

Output Storage Duration: 30


FTP to EMS: 0
FTP Transfer Interval: 60

EMS
EMS
EMS
EMS

IP Address: 127.0.0.1
Username: anonymous
Password: boston
Output Directory: /tsaa_data

Note: The output directory is named tsaa_<prefix>. Each tsaa_<prefix>.conf file will
have a different output and log directory.

Telica, Inc.

9-69

DLP-522

Step 8.

Section 150-500-400
Issue 3, January 9, 2004
Have all tssa.conf files that required changes been modified?
If YES, then continue to the next step.
If NO, then go to Step 7.

Step 9.

9-70

YOU HAVE COMPLETED THIS PROCEDURE.

Telica, Inc.

Section 150-500-400
Issue 4, January 9, 2004

DLP-523

DLP-523 - UPGRADE THE TRAFFIC COLLECTION


APPLICATION
SUMMARY:
This procedure provides instructions for upgrading the Traffic
Collection application on a Sun server. It also provides steps to verify that the
application has started properly.
Knowledge of UNIX and the vi command or other text editor is also required. If you
have questions regarding vi, please contact Telica Technical Services at 1-888-440-8354.
Procedures for provisioning the Plexus for the Traffic Collection Application are found in
the Plexus 9000 Installation and Operation Manual.

Note 1: To avoid local time synchronization problems, Telica strongly


recommends setting both the Plexus and the server system clock to GMT.
For assistance, please contact Telica Technical Services at 1-888-440-8354.
Note 2: Users of the applications are responsible for managing file space
and for any post-processing of records on the server.

Step 1.

The Traffic Collection Application (TCA) supports the Plexus 9000, release
3.1.0.0 or greater, and must meet these prerequisites:

Step 2.

Sun Solaris 7 or 8 with 256 MB memory and a 10/100 Ethernet card


Sun Ultra 10 or Sun Netra X1 at a minimum

Is TCA running on the BTS server or on a separate TCA server?


If on the BTS server, then continue to the next step.
If on a TCA server, then go to Step 5.

Step 3.

Log into the BTS server as root after obtaining the username and password.

Step 4.

Create the upgrade directory in opt/PlexDc if it does not already exist. Do this
by typing:

mkdir /opt/PlexDC/upgrade

Step 5.

Change directories by typing the following and then go to Step 9.

cd /opt/PlexDC/upgrade

Telica, Inc.

9-71

DLP-523

Section 150-500-400
Issue 4, January 9, 2004

Step 6.

Log into the TCA server as root after obtaining the username and password of
the chosen TCA server.

Step 7.

Once logged onto the server, create the upgrade directory in opt/PlexStats if it
does not already exist. Do this by typing:

mkdir /opt/PlexStats/upgrade

Step 8.

Change directories by typing :

cd /opt/PlexStats/upgrade
Step 9.

If you do not have a TrafficCollection Application CD ROM with the


TCA_X.X.X.X.tar.gz file or a copy of the TCA_X.X.X.X.tar.gz file, obtain a copy
from Telica Technical Services at 1-888-440-8354.

Step 10. Is TCA running on the BTS server or on a separate TCA server?
If on the BTS server, then copy this file to the PlexDC/upgrade directory
on the BTS server.
If on a TCA server, then Copy this file to the PlexStats/upgrade directory
on the TCA server.
Step 11. Ensure you are in the PlexDC directory if installing on the same server as the
BTS application or in the PlexStats directory if installing a separate TCA
server.
Step 12. Untar TCA_X.X.X.X.tar.gz file by substituting the correct version number for
x.x.x.x and typing:

gunzip -xvf TCA_X.X.X.X.tar.gz

Step 13. Untar TCA_X.X.X.X.tar file by substituting the correct version number for
x.x.x.x and typing:

tar -xvf TCA_X.X.X.X.tar

Step 14. Verify that the admin file exists by typing:

ls -l

Partial Sample Response:


-rw-r--r--

1 builder

cvsusers

135 Nov

5 15:44 admin

Step 15. If the admin file does not exist, please contact Telica Technical Services at
1-888-440-8354
Step 16. Type the following command ensuring that you type the period after -d.
9-72

Telica, Inc.

Section 150-500-400
Issue 4, January 9, 2004

DLP-523

pkgadd a admin -d.

Step 17. Did you see a response similar to the following? Versions may differ.
If YES, then continue to the next step.
If NO, then go to Step 19.
Response:
The following packages are available:
1 BTS
Telica BTS application
(sparc) 3.9.0.0.31
2 TCA
Telica TSAA application
(sparc) 2.0.0.66
Select package(s) you wish to process (or 'all'
to process all packages). (default: all)
[?,??,q]:
Step 18. Type the number of the TCA package followed by the Enter key. You should
have already installed the BTS package because you should always install the
BTS package first.
Step 19. The package add utility will begin its process. For a complete display for
output, refer to Table 9-O.
Step 20. You will see displayed the following lines and you will have to select the mode.
Enter 1 or 2.
TCA product can be installed in two ways:
(1) Just TCA
+ Installs only the TCA (Traffic Collection Application).
(2) TCA + BTS tsaa
+ Installs the TCA (Traffic Collection Application)
+ and copies the tsaa (Telica Statistical Analysis
Application)
+ that comes with the TCA package to the BTS package
installation
+ base directory as tsaaDc.
Which mode do you want
(1)TCA
(2)TCA + BTS tsaa

[?] 2

Step 21. The next line that requires input follows. Press the Enter (<CR> or ) key to
select the default of /opt as indicated in the following example.
Enter TCA pkg installation directory base (default: /opt):

Telica, Inc.

9-73

DLP-523

Section 150-500-400
Issue 4, January 9, 2004

Step 22. If you are installing both TCA and BTS on the same server, you will see the
following. Press the Enter (<CR> or ) key to select the default of /opt.
Enter BTS pkg installation directory base:
(The directory name in which the PlexDC dir resides)
(default: /opt):

Step 23. At the next line require an input, type a y to continue with installation.
This package contains scripts which will be executed with
super-user permission during the process of installing this
package.
Do you want to continue with the installation of <TCA>
[y,n,?] y

Step 24. When finished, you will see the following message displayed:
Installation of <TCA> was successful.
The following packages are available:
1 BTS
Telica BTS application
(sparc) 3.9.0.0.31
2 TCA
Telica TSAA application
(sparc) 2.0.0.66
Select package(s) you wish to process (or 'all'
to process all packages). (default: all) [?,??,q]
Step 25. Type q to quit followed by the Enter key.
Step 26. Do you want if verify and obtain information about application?
If NO, then go to Step 28.
If YES, then type the following and then go to Step 29.

pkginfo l TCA

Response is on the following page.

9-74

Telica, Inc.

Section 150-500-400
Issue 4, January 9, 2004

DLP-523

Response:
PKGINST:
NAME:
CATEGORY:
ARCH:
VERSION:
BASEDIR:
VENDOR:
PSTAMP:
INSTDATE:
STATUS:
FILES:

TCA
Telica TSAA application
system
sparc
2.0.0.67
/opt
Telica
dark20031204100621
Jan 06 2004 09:23
completely installed
7 installed pathnames
1 directories
3 executables
1967 blocks used (approx)

Step 27. Ensure that STATUS is completely installed.


If YES, it is completely installed then continue to the next step.
If NO, then contact Telica Technical Services at 1-888-440-8354.
Step 28. Compare the new tsds.conf and tsaa_template.conf files in the upgrade
directory with the existing files. This must be done for tsaa_<prefix>.conf for
each switch. Samples of these files are shown in Table 9-M and Table 9-N
found at the end of this procedure. Do these files require any changes?
If YES, then continue to the next step.
If NO, then go to Step 31.
Step 29. Using vi or any available text editor, make the appropriate changes and save. If
using vi, type:

vi ../tsds.conf

Step 30. Change directories by typing:

cd..

Step 31. If necessary, make the changes to the S99PLXStats file using vi or any available
text editor. If using vi, type:

vi S99PLXStats

Telica, Inc.

9-75

DLP-523

Section 150-500-400
Issue 4, January 9, 2004

Step 32. Copy the S99PLXStats file to the rc3.d directory by typing:

cp p S99PLXStats /etc/rc3.d

Step 33. Run the BTS admin tool from this location by typing the following and entering
a 1 to start an instance.

./btsadmin

Response:
#######################################################
############
Main Menu
######
1)
2)
3)
4)
5)
6)
7)
8)

Start an Instance
ReStart an Instance
Stop an Instance
Reinitialize an Instance
Start All Instances
Stop All Instances
Status
Exit

Enter the choice:

Step 34. The following menu will appear to allow you to select the switch. Names will
differ depending upon how your switches were named.
Response:
#######################################################
############
Start Menu
######
1)
2)
3)
4)
5)
6)
7)
8)

PlexDC1
PlexDC2
PlexDC3
PlexDC4
PlexDC5
PlexDC6
PlexDC7
PlexDC8

9) Main Menu
Enter the choice: 7

9-76

Telica, Inc.

Section 150-500-400
Issue 4, January 9, 2004

DLP-523

Step 35. The following menu will be displayed allowing to start the BTS
(TelicaPlexusDc), TCA (tsaaDc), both BTS and TCA or return to the main
menu. In the following example, BTS is selected.
Response:
#######################################################
############
Choose Module for PlexDC7
######
1)
2)
3)
4)

TelicaPlexusDc
tsaaDc
Both
Main Menu

Enter the choice: 2

Response:
.
BTSBackupAdmin START Info:
TelicaPlexusDc for "PlexDC7" is started.

Step 36. When the following menu appears, you can check the status of the data
collector by selecting 7.
Response:
#######################################################
############
Main Menu
######
1)
2)
3)
4)
5)
6)
7)
8)

Start an Instance
ReStart an Instance
Stop an Instance
Reinitialize an Instance
Start All Instances
Stop All Instances
Status
Exit

Enter the choice: 7

Telica, Inc.

9-77

DLP-523

Section 150-500-400
Issue 4, January 9, 2004
Response:
BTS STATUS:
PID COMMAND
9335 ./TelicaPlexusDc -C PlexDC8
9307 ./TelicaPlexusDc -C PlexDC4
348 ./tsaaDc -C PlexDC3
352 ./tsaaDc -C PlexDC5
355 ./tsaaDc -C PlexDC7
357 ./tsaaDc -C PlexDC8
9300 ./TelicaPlexusDc -C PlexDC3
9321 PlexDC6/TelicaPlexusDc -C PlexDC6
4123 ./tsaaDc -C PlexDC1
9314 ./TelicaPlexusDc -C PlexDC5
9286 ./TelicaPlexusDc -C PlexDC1
9293 ./TelicaPlexusDc -C PlexDC2

BTSBackupAdmin :

Step 37. When the menu appears, you can make your next selection or exit.
Response:
#######################################################
############
Main Menu
######
1)
2)
3)
4)
5)
6)
7)
8)

Start an Instance
ReStart an Instance
Stop an Instance
Reinitialize an Instance
Start All Instances
Stop All Instances
Status
Exit

Enter the choice: 8

Do you want to logout of the server at this time?


If YES, then logout by typing exit
.
If NO, then continue to the next step
Step 38.

9-78

YOU HAVE COMPLETED THIS PROCEDURE.

Telica, Inc.

Section 150-500-400
Issue 4, January 9, 2004

DLP-523

Table 9-M. tsds.conf File


# FileName: tsds.conf
# Telica Stats Server configuration environment
#
# Server TCP listen Port number and working directory
SERVER_PORT

10000

# Working Directory - contains data, connection info and log files


# DATA_DIR

tsds_data

# Client switches (usually SPA/SPB pairs use the same prefix)


# Plexus-9000 host processors (name or dotted IP address)

# Key

IP-or Host

Prefix

# =====

==========

========

CLIENT

<SP-A IP or Hostname>

<boston>

CLIENT

<SP-B IP or Hostname>

<boston>

CLIENT

See Note below.

Note: There can be up to sixteen (16) CLIENT entries for connection to up to eight (8)
Plexus 9000 switches. Delete extra CLIENT entries.

Telica, Inc.

9-79

DLP-523

Section 150-500-400
Issue 4, January 9, 2004

Table 9-N. tsaa.conf File


#
#
#
#
#
#

FileName: *tsaa.conf
This file contains the configuration information for the
Telica Statistical Analysis Application (TSAA), and should be
modified by authorized personnel only.
Prefix: boston
Input Directory: tsds_data
Output Directory: tsaa_boston
Log Directory: tsaa_boston/log
Percent Blocking: 0.01
Peg Count Report: 1
ASR Report: 1
Hold Time Report: 1
SS7 Trkgrp CCS Report: 3
Intfcgrp CCS Report: 3
CAS Trkgrp CCS Report: 3
BICC Trkgrp CCS Report: 3
SIP Trkgrp CCS Report: 3
GR303 Intfcgrp CCS Report: 3
CAS Intfcgrp CCS Report: 3
ASCII CDR Report: 1
Detailed Peg Report: 1
Calculate DN Peg Count: 1
Busy Hour Granularity: 30
CCS Granularity Period: 4
Peg Count Granularity Period: 4
ASR Granularity Period: 4
Hold Time Granularity Period: 4
Input Storage Duration: 30

Output Storage Duration: 30


FTP to EMS: 0
FTP Transfer Interval: 60

EMS
EMS
EMS
EMS

9-80

IP Address: 127.0.0.1
Username: anonymous
Password: boston
Output Directory: /tsaa_data

Telica, Inc.

Section 150-500-400
Issue 4, January 9, 2004

DLP-523

Table 9-O. Display of Package Add


The following packages are available:
1 BTS
Telica BTS application
(sparc) 3.9.0.0.31
2 TCA
Telica TSAA application
(sparc) 2.0.0.66
Select package(s) you wish to process (or 'all' to process
all packages). (default: all) [?,??,q]: 2
Processing package instance <TCA> from </opt/PlexStats>
Telica TSAA application
(sparc) 2.0.0.66
Copyright (c) 2003 Telica, Inc.
734 Forest Street
Building G
Marlboro, MA 01752
Phone: (508) 480-0909
Fax: (508) 480-0922
All rights reserved. This product and related documentation is
protected by
copyright and distributed under licenses restricting its use,
copying,
distribution and decompilation. No part of this product or related
documentation
may be reproduced in any form by any means without prior written
authorization from
Telica.

Looking for previously installed TCA package...


ERROR: information for "TCA" was not found...
Looking for previously installed BTS package...
Found BTS Version=3.9.0.0.31 at "/opt".
TCA product can be installed in two ways:
(1) Just TCA
+ Installs only the TCA (Traffic Collection Application).
(2) TCA + BTS tsaa
+ Installs the TCA (Traffic Collection Application)
+ and copies the tsaa (Telica Statistical Analysis Application)
+ that comes with the TCA package to the BTS package installation
+ base directory as tsaaDc.
Which mode do you want
(1)TCA
(2)TCA + BTS tsaa

Telica, Inc.

[?] 2

9-81

DLP-523

Section 150-500-400
Issue 4, January 9, 2004

TELICA_OPR_MODE=TSAADC
Enter TCA pkg installation directory base (default: /opt): <CR>

Enter BTS pkg installation directory base:


(The directory name in which the PlexDC dir resides)(default: /opt):
<CR>
BTS_BASEDIR=/opt
GROUPNUM=802
Using </opt> as the package base directory.
## Processing package information.
## Processing system information.
7 package pathnames are already properly installed.
## Verifying disk space requirements.
## Checking for conflicts with packages already installed.
## Checking for setuid/setgid programs.
This package contains scripts which will be executed with super-user
permission during the process of installing this package.
Do you want to continue with the installation of <TCA> [y,n,?] y
Installing Telica TSAA application as <TCA>
## Executing preinstall script.
Saving the old conf files to /tmp/TCA_conf_files_2.0.0.66
Copying /opt/PlexStats/*.conf to /tmp/TCA_conf_files_2.0.0.66
total 32
-rw-r----1 root
other
974 Jan 6 09:23 tsaa.conf
-rw-r----1 root
other
544 Jan 6 09:23 tsds.conf
## Installing part 1 of 1.
[ verifying class <util> ]
## Executing postinstall script.
TELICA_OPER_MODE="TCA + BTS tsaa"
Copying /opt/PlexStats/tsaa to /opt/PlexDC as tsaaDc
Copying /opt/PlexStats/tsaa.conf to /opt/PlexDC as tsaa_template.conf
Installation of <TCA> was successful.
The following packages are available:
1 BTS
Telica BTS application
(sparc) 3.9.0.0.31
2 TCA
Telica TSAA application
(sparc) 2.0.0.66
Select package(s) you wish to process (or 'all' to process
all packages). (default: all) [?,??,q]: q

9-82

Telica, Inc.

Section 150-500-400
Issue 4, January 9, 2004

DLP-523

NOTES:

Telica, Inc.

9-83

Section 150-500-400
Issue 2, September 25, 2003

DLP-531

DLP-531 - INSTALL THE PLEXVIEW PRO AMA BILLING


APPLICATION
SUMMARY: This procedure provides steps for installing the PlexView Pro AMA
Billing Application (version 1.5) on the Sun server and provisioning the Plexus for
billing.
Knowledge of UNIX and the vi command or other text editor is also required. If you
have questions regarding vi, please contact Telica Technical Services at 1-888-440-8354.
Procedures for provisioning the Plexus for the Plexview Pro Billing found in the Plexus
9000 Installation and Operation Manual.

Step 1.

The PlexView Pro AMA Billing Application supports the Plexus 9000, release
3.1.0.0 or greater, and must meet these prerequisites:

Step 2.

Sun Solaris 7 or 8 with 256 MB memory and a 10/100 Ethernet


card
Sun Ultra 10 or Sun Netra T1 at a minimum

Do you have the PlexView Pro AMA Billing Application CD ROM?


If YES, you have the CD ROM, then continue to the next step
If NO, then STOP. Obtain the CD ROM.
Note:

Step 3.

Log into the server for PlexView Pro AMA Billing after obtaining the
username and password of the chosen server.
Note:

Step 4.

Step 31 to Step 29 are performed at the AMA server.

The file names must be entered in the order shown below.

Insert the CD ROM into the CD drive and then type the following command:

pkgadd -a admin -d.


/cdrom/cdrom0/Telica1_5SF.pkg BaseWorX
DSsys DSplat DSgdi DSddi DSdata DS DSbaf
.

Telica, Inc.

9-85

DLP-531

Step 5.

Section 150-500-400
Issue 2, September 25, 2003
When prompted with a question, answer them as follows:

Step 6.

Answer /opt for BaseWorX prompt.


Answer simplex, (for the configuration question simplex or duplex?).
Enter a blank line for host name (to keep the current system name).
Answer y for all the other questions.

Ensure the following space requirements are met.


/umat - application software (100Mb) <----- Located under root (/) fs
/data - data files (100Mb) <--------------|
/log - log files (100Mb) <---------------|
/bafblks - billing record storage (500Mb to 4G) <- Independant fs
The "bafblks" file system needs to be confined to their own filesystem.
The size of bafblks depends on how much billing data the Telica Data
Generating System (DGS) is required to maintain. The largest AMADNS
file that this software will allow you to create is 2M. There are only
65535 filenames allowed in the AMADNS spec, so,
2M * 65535 = 131Gb of space (max) and the smallest AMADNS file is
100Kb * 65535 = 6.5Gb (min).

Step 7.

You have completed the installation of the application on the Sun server.

Step 8.

Do you want to logout of the PlexView Pro AMA Billing server at this time?
If YES, then logout by typing exit
.
If NO, then continue to the next step.

Step 9.

If provisioning for billing must be completed at the Plexus 9000, refer to the
Plexus 9000 Installation and Operation Manual and NTP-018.

Step 10.

YOU HAVE COMPLETED THIS PROCEDURE.

9-86

Telica, Inc.

Section 150-500-400
Issue 3, January 9, 2004

DLP-541

DLP-541 - INSTALL AND PROVISION THE BILLING AND


TRAFFIC SYSTEM
SUMMARY: This procedure provides instructions for installing and configuring the
Billing and Traffic System (BTS) application on the Sun server. It also provides steps to
verify that the application has started properly.
This procedure assumes that the server to run the BTS application has already been
installed on the same network as the Plexus and is configured with sufficient disk space.
Knowledge of UNIX and the vi command or other text editor is also required. If you
have questions regarding vi, please contact Telica Technical Services at 1-888-440-8354.
Procedures for provisioning the Plexus for the billing and traffic are found in the Plexus
9000 Installation and Operation Manual.

Note 1: To avoid local time synchronization problems, Telica strongly


recommends setting both the Plexus and the BTS server system clock to
GMT. For assistance, please contact Telica Technical Services at 1-888440-8354.
Note 2: Users of the BTS application are responsible for managing file
space on their BTS server.
Note 3: The Enter key, indicated by , must always follow inputs that you
enter.

Step 1.

The Billing and Traffic System (BTS) supports the Plexus 9000, release 3.8,
and must meet these prerequisites:

Step 2.

Sun Solaris 7 or 8 with 256 MB memory and a 10/100 Ethernet


card
Sun Ultra 10 or Sun Netra X1 at a minimum

Log into the BTS server as root after obtaining the username and password.

Telica, Inc.

9-87

DLP-541

Step 3.

Section 150-500-400
Issue 3, January 9, 2004
Verify that your system has 2GB of swap space available by typing:

swap 1
swap s
Comment: If there is not enough swap space available then refer to your
resident Unix system administrator.
Note: This procedure will install the BTS application using the PKGADD
utility. If you encounter any problems, please contact Telica Technical
Services at 1-888-440-8354 for assistance.
Step 4.

Create the BTS base directory in /opt. Do this by typing:

mkdir /opt/PlexDC

Step 5.

Change to the PlexView BTS directory by typing:

cd /opt/PlexDC

Note: In the following steps, the correct version number should be substituted
for x.x.x.x.x.
Step 6.

If you do not have a Billing and Traffic System CD ROM with the
BTS_X.X.X.X.X.tar.gz file or a copy of the BTS_X.X.X.X.X.tar.gz file, obtain a
copy from Telica Technical Services at 1-888-440-8354.

Step 7.

Copy this file to the PlexDC directory on the BTS server.

Note: The tar file will extract directly into /opt/PlexDC.


Step 8.

Unzip BTS_X.X.X.X.X.tar.gz file by substituting the correct version number for


x.x.x.x.x and typing:

gunzip -xvf BTS_X.X.X.X.X.tar.gz

Step 9.

Untar BTS_X.X.X.X.X.tar file by substituting the correct version number for


x.x.x.x.x and typing:

tar -xvf BTS_X.X.X.X.X.tar

9-88

Telica, Inc.

Section 150-500-400
Issue 3, January 9, 2004

DLP-541

Step 10. Verify that the admin file has been created by typing:

ls -l

Partial Sample Response:


-rw-r--r-1 builder
rwxr-xr-x
1 builder
TelicaPlexusDC

cvsusers
cvsusers

135 Nov
135 Nov

5 15:44 admin
5 15:44

Step 11. If the admin file does not exist, please contact Telica Technical Services at
1-888-440-8354
Step 12. Verify the permissions of the TelicaPlexusDc application. If they are not
rwxr-xr-x then change them by typing:

chmod 755 TelicaPlexusDc

Step 13. Type the following command ensuring that you type the period after -d.

pkgadd a admin -d.


.
Step 14. Do you see a response similar to the following? Versions may differ.
If YES, then continue to the next step.
If NO, you only saw the BTS line then go to Step 19.
Response:
The following packages are available:
1 BTS
Telica BTS application
(sparc) 3.9.0.0.31
2 TCA
Telica TSAA application
(sparc) 2.0.0.66
Select package(s) you wish to process (or 'all'
to process all packages). (default: all)
[?,??,q]:
Step 15. Type the number of the BTS package followed by the Enter key. You should
always install the BTS package first.
Step 16. The package add utility will begin its process. For a complete display of the
output, refer to Table 9-P. The first line that requires input follows. Enter
/opt as indicated in the following example.
Enter BTS pkg installation directory base
(default: /opt): /opt

Telica, Inc.

9-89

DLP-541

Section 150-500-400
Issue 3, January 9, 2004

Step 17. Enter a y to the next two questions that require a response.
Do you want to install these as setuid/setgid
files [y,n,?,q] y

Do you want to continue with the installation of


<BTS> [y,n,?] y

Step 18. When finished, you will see the following message displayed:
Installation of <BTS> was successful.
The following packages are available:
1 BTS
Telica BTS application
(sparc) 3.9.0.0.31
2 TCA
Telica TSAA application
(sparc) 2.0.0.66
Select package(s) you wish to process (or 'all'
to process all packages). (default: all) [?,??,q]
Step 19. Type q to quit followed by the Enter key. You will enter the TCA application
in another procedure.
Step 20. Verify and obtain information about application by typing the following.

pkginfo l BTS

Sample Response:
# pkginfo -l
PKGINST:
NAME:
CATEGORY:
ARCH:
VERSION:
BASEDIR:
VENDOR:
PSTAMP:
INSTDATE:
STATUS:
FILES:

9-90

BTS
BTS
Telica BTS application
system
sparc
3.9.0.0.31
/opt
Telica
martin20030911172127
Dec 09 2003 10:00
completely installed
8 installed pathnames
1 directories
6 executables
6 executables
1 setuid/setgid executables
36371 blocks used (approx)

Telica, Inc.

Section 150-500-400
Issue 3, January 9, 2004

DLP-541

Step 21. Ensure that STATUS is completely installed.


If YES, it is completely installed then continue to the next step.
If NO, then contact Telica Technical Services at 1-888-440-8354.
Step 22. Will you be collecting data from more than one switch?
If YES, then continue to the next step.
If NO, then go to Step 26.
Note: The terms SwitchName and PlexDCn, where n is a number from 1 to 8,
may be used interchangeably in this procedure, but you should use only one
naming convention.
Step 23. Under the PlexDC directory create a directory for each switch using the
SwitchName or PlexDCn where n is a number from 1 to 8.

mkdir <SwitchName>
or

mkdir PlexDCn
Step 24. Copy the plexusDc_template.ini file from the PlexDC directory into all new
switch directories (SwitchName or plexusDCn) as plexusDc.ini.

cp p plexusDc_template.ini
./<SwitchName>/plexusDc.ini

Step 25. Have you created a directory for each switch and copied the
plexusDC_template to these directories?
If YES, then continue to the next step.
If NO, then go to Step 23.
Step 26. Change to the directory for a switch.

cd <SwitchName>

Step 27. Using vi or any available text editor, edit the newly created initialization file
template. Refer to Table 9-Y at the end of this procedure for an example of the
complete plexusDc.ini file. Portions of this file as they apply are shown at the
appropriate steps of this procedure. If using vi, type:

vi plexusDc.ini

Telica, Inc.

9-91

DLP-541

Section 150-500-400
Issue 3, January 9, 2004

Step 28. In the Main Entity Configuration section, change the prefix to the name of the
switch. If any of the default commented lines (lines preceded with the pound
(#) sign) require changing, insert the fields after the Prefix line.
Table 9-P. MAIN Entity Configuration Section of PlexusDC.ini File
##############################
#Data Collector MAIN Entity Configuration
##############################
[DataCollectorConfig]
#
#
#
#
#
#
#
#
#
#
#
#
#
#

Prefix=
MaxLogQueue=
MaxFileSize=
MaxFileCount=
LogPath=
LogFilename=
DebugPort=
DebugBindIp=
BindIp=

Timezone=

Prefix=

<none>
16384
10485760
6
./logs
dcLog
<none>
0.0.0.0
0.0.0.0

<system>

prefix for various output files (ascii, baf, stats)


max trace entries allow on queue before dropping
max size in bytes of any single trace file
max old trace log files retained
directory for trace log files
base name of trace log files
telnet debug port into DataCollector
INADDR_ANY) override BindIp for debug port only.
(INADDR_ANY) default local bind IP(i/f) for all
TCP listen and connect calls (allows DC bind
to system alias IP). Other sections in the ini
will default to this value if their individual
BindIp is not defined.
USE ONLY IF SERVER and SWITCH timezones DON'T MATCH
Timezone is used to calculate file names, file
rollover times, and some billing fields.
See end of file for description.

SwitchName

Note: GDI Host is the mgcId and the IP address or name of each the switchs
system processors. The mgcId indicates the unique media gateway controller
identification which a number from 1 to 63. The defaults are 1 and 2. If the
Data Collector is collecting information from multiple Plexus, there will be
multiple plexusDC_<prefix>.ini files and at this time the GDI host can be 1 and
2 in each of those files. The host/IP is the IP address or name of the system
processor. .

Step 29. In the Receiver Entity Configuration Section enter the IP addresses or names of
the Clients SPs that will send billing files to the server. IP addresses are the
addresses set on each Plexus with the ED-CHASSIS-EQPT TL1 command.
Names are obtained using DNS lookup.

9-92

Telica, Inc.

Section 150-500-400
Issue 3, January 9, 2004

DLP-541

Table 9-Q. Receiver Entity Configuration Section of PlexusDC.ini File


##############################
#Receiver Entity Configuration
##############################
[ReceiverConfig]
#
#
#
#
#
#
#
#

GdiPort=
GdiHost=

1986
mgcId

IP port to listen on for GDI connections


mgcId is a unique integer (1-63)

host/IP

ArchiveDays=
0
ArchiveInterval= 720
720 minutes = 12 hour (limit 5 - 1440)
ArchivePath=
<DataCollectConfig:LogPath>
ArchivePrefix=
<DataCollectConfig:Prefix>
ArchivePurgeNull= 1
purge null files

GdiHost=
GdiHost=

1
2

SPA_address
SPB_address

Step 30. If any of the other default commented lines (lines preceded with the pound (#)
sign) require changing, insert the fields after the GdiHost lines.
Note: The following steps edit the Billing entity configuration for ASCII
Billing and AMA Lite reporting as shown in Table 9-R.
Step 31. If you need to change any of the default commented lines (lines preceded with
the pound (#) sign), insert the fields with the new values after the Call Type
lines. Refer to 5. Billing and Traffic System section of this manual for complete
description of the fields.
Table 9-R. Billing Entity Configuration Section of PlexusDC.ini File
#################################
# Billing entity configuration
#################################
[BillingConfig]

# AMA Record Formatting Parameters


# -------------------------------#
#
#
#
#
#
#
#
#
#
#

SensorType=
SensorId=

195
0

RecOfficeType=
RecOfficeId=

195
999999

DAAMAGen=
IntraLATAAMAGen=
FraudAMAGen=
FraudCallType=

1
1
0
800

Sensor Type
Sensor Id - If non-zero, it overrides the
switch Id sent from the switch.
Recording Office Type
Recording Office Id
Directory Assistance AMA Generation
Intra LATA AMA Generation
Fraud AMA Generation
Call Type for Fraud Calls - Valid values are
from 800 to 999.

Telica, Inc.

9-93

DLP-541

Section 150-500-400
Issue 3, January 9, 2004

#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#

OrigNumberModuleGen=

TermNumberModuleGen=

#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#

DialedDigitsModuleGen=
0
OutpulseDigitsModuleGen= 0
TrunkIdModuleGen=

SipCallIdModuleGen=
CallIdModuleGen=
ReleaseCauseModuleGen=

0
0
0

QoSModuleGen=

SeqNumModuleGen=

CallSeqModuleCntxt=
RecordSeqModuleCntxt=
FinalTrunkModuleGen=
FinalTrunkModuleCntxt=
TDMRsrcModuleGen=
OrigTDMRsrcModuleCntxt=
TermTDMRsrcModuleCntxt=
PktRsrcModuleGen=

90000
80
0
90010
0
90020
90021
0

OrigPktRsrcModuleCntxt=
TermPktRsrcModuleCntxt=
PhysicalModuleGen=

90030
90031
0

PhysicalModuleCntxt=
PrefixModuleGen=
DialedPrefixModuleCntxt=
CalledPrefixModuleCntxt=
TreatmentModuleGen=

90040
0
81
82
0

TreatmentModuleCntxt=

90050

211CallType=
311CallType=
411CallType=
511CallType=
611CallType=
711CallType=
811CallType=
911CallType=

9-94

0
0
9
0
0
0
0
0

Orig Number Module 164 Generation


0 - Use GR-1100 generation rules
1 - Generate 164 Module for all
originating numbers
Term Number Module 164 Generation
0 - Use GR-1100 generation rules
1 - Generate 164 Module for international
terminating numbers
2 - Generate 164 Module for all
terminating numbers
Dialed Digits Module Generation (Module 101)
Outpulse Digits Module Generation
(Module 40)
Trunk Id Module Generation
0 Disable trunk id module generation
1 Generate Module 104
2 Generate Module 167 (Large trunks)
SIP Call Id Module Generation (Module 198)
Call Id Module Generation (Module 611)
Release Cause Module Generation
(Module 616)
Quality of Service Module Generation
(Module 264)
Sequence Number Module Generation
(Module 611 and 616)
Call Sequence Number Module Context
Record Sequence Number Module Context
Final Trunk Module Generation (Module 611)
Final Trunk Module Context
TDM Resource Module Generation (Module 611)
Orig TDM Resource Module Context
Term TDM Resource Module Context
Packet Resource Module Generation
(Module 613)
Orig Packet Resource Module Context
Term Packet Resource Module Context
Physical Interface Module Generation
(Module 612)
Physical Interface Module Context
Prefix Module Generation (Module 616)
Dialed Prefix Module Context
Called Prefix Module Context
Call Treatment Module Generation
(Module 198)
Call Treatment Module Context

Call Types for N11 Calls - Valid values are from


zero to 999. The value zero disables AMA generation.

Telica, Inc.

Section 150-500-400
Issue 3, January 9, 2004

DLP-541

Note: The following steps edit the Output Options for ASCII Billing, AMA
Lite and ProBilling reporting as shown Table 9-S.
Step 32. If you will be using the ASCII output, leave asciiEnable equal to 1
Step 33. If you will be FTPing ASCII files to another server, change asciiPush to 1, else
leave asciiPush as 0.
Step 34. If you will also be using the AMA Lite output, change the bafEnabled= 0 to 1,
else leave bafEnabled equal to 0
Step 35. If bafEnabled=1 and you will be FTPing BAF files to another server, change
bafPush to 1
Step 36. If you will also be using the PlexView Pro output, change the proBillEnabled=
0 to 1, else leave bafEnabled equal to 0.

Table 9-S. Output Options Section of PlexusDC.ini File


# Output Options
# -------------# Enable ASCII output
# Enable ASCII push
#
ASCIIEnabled= 1
ASCIIPush= 0

0 - Disable 1 - Enable
0 - Disable 1 - Enable
(see section AsciiPush)

# Enable BAF output (AMA Lite)


# Enable BAF push
#
BAFEnabled= 0
BAFPush= 0

0 - Disable 1 - Enable
0 - Disable 1 - Enable
(see section BafPush)

# Enable PlexView Pro output


ProBillEnabled= 0

0 - Disable

1 - Enable

Note: The following steps edit the ASCII and BAF file parameters
configuration for ASCII Billing and AMA Lite reporting as shown in
Table 9-T.
Step 37. If required, change the directories for ASCII and BAF files.
Step 38. Change the frequency of creating/writing billing files if required. The range is
from 5 to 1440 minutes. The default is 120 or 2 hours.
Step 39. If empty billing data files that have accumulated are to be deleted, edit the value
of Purge empty BAF and ASCII files to purgeNull=1.

Telica, Inc.

9-95

DLP-541

Section 150-500-400
Issue 3, January 9, 2004

Table 9-T. ASCII/BAF (AMA Lite) File Parameters Section of PlexusDC.ini File
# ASCII/BAF file parameters
# ------------------------# Note: These parameters are relevant only if ASCII or
#
BAF (AMA Lite) output is enabled
# Directory for ASCII output files
ASCIIDir= ./Bill_data/ascii
# Directory for BAF output files
BAFDir= ./Bill_data/baf
# Time BAF and ASCII output files are open for writing (minutes)
FileInterval= 120
# Purge empty BAF and ASCII files
#
0 - Do not purge
#
1 - Purge
PurgeNull= 0

Note: The following steps edit the ProBilling configuration for ProBilling
reporting as shown in Table 9-U.
Step 40. If you need to change any PlexView Pro parameters, do it in the following
section of the PlexusDC.ini file. If any of the default commented lines (lines
preceded with the pound (#) sign) require changing, insert the fields after the
gdiPsRaoHost line.
Table 9-U. PlexView Pro Parameters Section of PlexusDC.ini File
# PlexView Pro Parameters
# ----------------------# Note: These parameters are relevant only if PlexView Pro output is enabled
#
# GDIDir= ./Bill_data/proBill
Directory for PlexView Pro data record buffer
##########################
# ProBilling configuration
##########################
[ProBillingConfig]
#
#
#
#
#
#
#
#

gdiRecordSize=
128
gdiMiniRecs=
1024
gdiMiniInWhole= 4000
gdiPsPort=
gdiPsRaoHost=

1983
<none>

gdiPsHost=

<none>

#gdiPsRaoHost=

9-96

Average size of BAF records in bytes


Number of records to be held in shared memory
Number of gdiMiniRecs to be stored in disk buffer
(total records = gdiMiniRecs * gdiMiniInWhole)
port that ProBilling is listening on
Revenue Accounting Host (ProBilling Server)
or 0 to 4 instances of
ProBilling Server hostname/IP

localhost

Telica, Inc.

Section 150-500-400
Issue 3, January 9, 2004

DLP-541

Note: The following steps edit the ASCII push entity configuration for ASCII
Billing and AMA Lite reporting as shown in Table 9-V.
Step 41. Did you configure asciiPush or bafPush to a 1 in the Output Options
section?
If YES, then continue to the next step.
If NO, then go to Step 44.
Step 42. If you need to change the number of days to retain files that have been FTPed,
then insert the line ArchiveDays= with the correct number after the Password
line for asciiPush or bafPush or both.
Step 43. Insert lines for DestinationDir=, Host=, User= and Password= and follow
with the appropriate information.
Table 9-V. ASCII and BAF Push Configuration
#################################
# AsciiPush entity configuration
#################################
# Configure FTP push of ASCII billing files to remote server
[AsciiPush]
#
#
#
#
#
#

ArchiveDays=
7
DestinationDir=
Passive=
1
Host=
User=
Password=

Number of days to retain files that have been pushed


Destination directory on FTP server for files
Use FTP passive transfer (0/1 F/T)
FTP server hostname/IP
FTP server login id
FTP server login password

#################################
# BafPush entity configuration
#################################
# Configure FTP push of BAF (AMA Lite) billing files to remote server
[BafPush]
#
#
#
#
#
#

ArchiveDays=
7
DestinationDir=
Passive=
1
Host=
User=
Password=

Number of days to retain files that have been pushed


Destination directory on FTP server for files
Use FTP passive transfer (0/1 F/T)
FTP server hostname/IP
FTP server login id
FTP server login password

Note: The following steps edit the Statistics entity configuration for TCA
reporting as shown in Table 9-W.
Step 44. Traffic Collection is on by default. If you want it disabled, insert
TypeOf740IF= 8 after the line TsdsPath line.

Telica, Inc.

9-97

DLP-541

Section 150-500-400
Issue 3, January 9, 2004

Step 45. If you need to change either the LogPath or TsdsPath, insert the following with
the new path after the line TsdsPath line.
LogPath=<new path>
TsdsPath=<new path>
Table 9-W. Statistics Entity Configuration Section of PlexusDC.ini File
#################################
# Statistics entity configuration
#################################
[StatisticsConfig]
# TypeOf740If=
#
# LogPath=
# TsdsPath=

4
./stats_log
./tsds_data

4=TSAA statistics data fed to tsaa reporter


8=NONE
Path for statistics log file (future)
Path for TSDS .dat files (for TSAA input)

Step 46. Save the changes to the PlexusDC.ini file and exit vi by typing:.

<Esc> :wq
Step 47. Did you copy the plexusDC_template.ini file into each switch directory and
edit them for each switch or is there only one switch?
If YES, then continue to the next step.
If NO, then go to Step 26 and edit them for another switch.
Step 48. Copy the S99PlexDC file into the /etc/rc3.d directory by typing:

cp p S99PlexDC /etc/rc3.d

Step 49. Using vi or any available text editor, modify the line in the S99PlexDC file that
reads PLXDC_INSTANCES as shown in Table 9-X. Enter the names of the
switches separated by spaces (i.e.,INSTANCES="PlexDC1 PlexDC2
PlexDC3" or INSTANCES="bos1 bos2) . Remember to save the file
before exiting.

9-98

Telica, Inc.

Section 150-500-400
Issue 3, January 9, 2004

DLP-541

Table 9-X. S99PlexDC File (partial)


#!/sbin/sh
#
# Copyright (c) 2000-2002 by Telica, Inc.
# All rights reserved.
#
# $Id: S99PlexDC,v 1.4 2003/09/04 19:12:05 rthornto Exp $
#
#
#
#
#
#
#
#
#
#

Add the name of each TelicaPlexusDc instance to start to PLXDC_INSTANCES.


These should be the subdirectory names under PLXDC_BASE_DIR
(e.g. PLXDC_INSTANCES="PlexDC1 PlexDC2 SwitchName1 SwitchName2"
A plexusDc.ini configuration file must exist in each subdirectory.
TSAA instances are defined by TSAA_INSTANCES which by default is a copy
of PLXDC_INSTANCES. Set it = "" to stop any TSAA instance from being
started, or set it to the specific subdirectory name to only start
specific instances. A tsaa.conf configuration file must exist in each
subdirectory.

PLXDC_BASE_DIR="/opt/PlexDC/"
PLXDC_INSTANCES=""
TSAA_INSTANCES=$PLXDC_INSTANCES
#
# Only allow this script to run by root

Note: Only the beginning of the file is shown above because only the line indicated in
bold must be modified.

Step 50. Change to the PlexDC directory by typing:

cd /opt/PlexDC

Step 51. Are you using the Traffic Collection Application (TCA)?
If YES, then go to DLP-521 to install TCA.
If NO, then continue to the next step.
Step 52. Run the BTS admin tool from this location by typing the following and entering
a 1 to start an instance.

./btsadmin

Telica, Inc.

9-99

DLP-541

Section 150-500-400
Issue 3, January 9, 2004
Response:
#######################################################
############
Main Menu
######
1)
2)
3)
4)
5)
6)
7)
8)

Start an Instance
ReStart an Instance
Stop an Instance
Reinitialize an Instance
Start All Instances
Stop All Instances
Status
Exit

Enter the choice:

Step 53. The following menu will appear to allow you to select the switch. Names will
differ depending upon how your switches were named.
Response:
#######################################################
############
Start Menu
######
1)
2)
3)
4)
5)
6)
7)
8)

PlexDC1
PlexDC2
PlexDC3
PlexDC4
PlexDC5
PlexDC6
PlexDC7
PlexDC8

9) Main Menu
Enter the choice: 7

Step 54. The following menu will be displayed allowing to start the BTS
(TelicaPlexusDc), TCA (tsaaDc), both BTS and TCA or return to the main
menu. In the following example, BTS is selected.
Response:
#######################################################
############
Choose Module for PlexDC7
######
1)
2)
3)
4)

TelicaPlexusDc
tsaaDc
Both
Main Menu

Enter the choice: 1

9-100

Telica, Inc.

Section 150-500-400
Issue 3, January 9, 2004

DLP-541

Response:
.
BTSBackupAdmin START Info:
TelicaPlexusDc for "PlexDC7" is started.

Step 55. When the following menu appears, you can check the status of the data
collector by selecting 7.
Response:
#######################################################
############
Main Menu
######
1)
2)
3)
4)
5)
6)
7)
8)

Start an Instance
ReStart an Instance
Stop an Instance
Reinitialize an Instance
Start All Instances
Stop All Instances
Status
Exit

Enter the choice: 7

Response:
BTS STATUS:
PID COMMAND
9335 ./TelicaPlexusDc -C PlexDC8
9307 ./TelicaPlexusDc -C PlexDC4
348 ./tsaaDc -C PlexDC3
352 ./tsaaDc -C PlexDC5
355 ./tsaaDc -C PlexDC7
357 ./tsaaDc -C PlexDC8
9300 ./TelicaPlexusDc -C PlexDC3
9321 PlexDC6/TelicaPlexusDc -C PlexDC6
4123 ./tsaaDc -C PlexDC1
9314 ./TelicaPlexusDc -C PlexDC5
9286 ./TelicaPlexusDc -C PlexDC1
9293 ./TelicaPlexusDc -C PlexDC2

BTSBackupAdmin :

Telica, Inc.

9-101

DLP-541

Section 150-500-400
Issue 3, January 9, 2004

Step 56. When the menu appears, you can make your next selection or exit.
Response:
#######################################################
############
Main Menu
######
1)
2)
3)
4)
5)
6)
7)
8)

Start an Instance
ReStart an Instance
Stop an Instance
Reinitialize an Instance
Start All Instances
Stop All Instances
Status
Exit

Enter the choice: 8

Step 57. Verify that the following directories were created under the /opt/PlexDC
directory by typing:

/opt/PlexDc/ls l <SwitchName>

Response:
Bill_data
logs
stats_log
tsds_data
Step 58. Verify that the following directories have been created under the
/opt/PlexDC/Bill_data directory by typing:

/opt/PlexDc/ls l <SwitchName>/Bill_data

Response:
ascii
baf
proBill
Step 59. Verify that a log file and connection info file have been created (dcLog.out and
gdi.conn) by typing:

/opt/PlexDc/ls l <SwitchName>/logs

9-102

Telica, Inc.

Section 150-500-400
Issue 3, January 9, 2004

DLP-541

Note: You must list the files in the directory to obtain the exact name of the
following file.

Step 60. If provisioning for billing must be completed at the Plexus 9000, refer to the
Plexus 9000 Installation and Operation Manual and NTP-018.
Step 61. Generate calls to or from any of the subscribers provisioned on the Plexus.
Note: AMA binary files of billing records, <PREFIX>_yyyymmdd_time.txt, are
created in accordance to the frequency defined in the plexusDc.ini file. These
are binary ama records.
SwitchName/logs/dcLog.out contains information regarding the connections
(new connections, lost connections, error messages).

Step 62. Do you want to view the dcLog.out file?


If YES, then view file by typing the following:

less <SwitchName>/logs/dcLog.out
To exit the less application type:
q
If NO, then continue to the next step.
Step 63. Do you want to logout of the BTS server at this time?
If YES, then logout by typing exit

If NO, then continue to the next step.

Step 64.

Telica, Inc.

YOU HAVE COMPLETED THIS PROCEDURE.

9-103

DLP-541

Section 150-500-400
Issue 3, January 9, 2004

Table 9-Y. PlexusDc.ini File


# Template TelicaPlexusDc configuration file.
# $Id: plexusDc_template.ini,v 1.11.2.17 2003/12/03 21:53:58 ggaus Exp $
#
# The parameter comment blocks document the default settings if the
# parameter is not defined in this file.
#
# Parameter names are not case sensitive, but the "=" MUST follow the
# name with no intervening space.
#
#NOTE: actual parameter lines can NOT include comments on the end
##############################
#Data Collector MAIN Entity Configuration
##############################
[DataCollectorConfig]
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#

Prefix=
MaxLogQueue=
MaxFileSize=
MaxFileCount=
LogPath=
LogFilename=
DebugPort=
DebugBindIp=
BindIp=

<none>
16384
10485760
6
./logs
dcLog
<none>
0.0.0.0
0.0.0.0

Timezone=

<system>

Prefix=

prefix for various output files (ascii, baf, stats)


max trace entries allow on queue before dropping
max size in bytes of any single trace file
max old trace log files retained
directory for trace log files
base name of trace log files
telnet debug port into DataCollector
(INADDR_ANY) override BindIp for debug port only.
(INADDR_ANY) default local bind IP(i/f) for all
TCP listen and connect calls (allows DC bind
to system alias IP). Other sections in the ini
will default to this value if their individual
BindIp is not defined.
USE ONLY IF SERVER and SWITCH timezones DON'T MATCH
Timezone is used to calculate file names, file
rollover times, and some billing fields.
See end of file for description.

SwitchName

##############################
#Receiver Entity Configuration
##############################
[ReceiverConfig]
#
#
#
#
#
#
#
#

GdiPort=
GdiHost=

1986
mgcId

host/IP

IP port to listen on for GDI connections


mgcId is a unique integer (1-63)

ArchiveDays=
0
ArchiveInterval= 720
720 minutes = 12 hour (limit 5 - 1440)
ArchivePath=
<DataCollectConfig:LogPath>
ArchivePrefix=
<DataCollectConfig:Prefix>
ArchivePurgeNull= 1
purge null files

GdiHost=
GdiHost=

1
2

SPA_address
SPB_address

#################################
# Billing entity configuration
#################################

9-104

Telica, Inc.

Section 150-500-400
Issue 3, January 9, 2004

DLP-541

# AMA Record Formatting Parameters


# -------------------------------#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#

SensorType=
SensorId=

195
0

RecOfficeType=
RecOfficeId=

195
999999

DAAMAGen=
IntraLATAAMAGen=
FraudAMAGen=
FraudCallType=

1
1
0
800

Sensor Type
Sensor Id - If non-zero, it overrides the
switch Id sent from the switch.
Recording Office Type
Recording Office Id
Directory Assistance AMA Generation
Intra LATA AMA Generation
Fraud AMA Generation
Call Type for Fraud Calls - Valid values are
from 800 to 999.

OrigNumberModuleGen=

TermNumberModuleGen=

DialedDigitsModuleGen=
0
OutpulseDigitsModuleGen= 0
TrunkIdModuleGen=

SipCallIdModuleGen=
CallIdModuleGen=
ReleaseCauseModuleGen=

0
0
0

QoSModuleGen=

SeqNumModuleGen=

CallSeqModuleCntxt=
RecordSeqModuleCntxt=
FinalTrunkModuleGen=
FinalTrunkModuleCntxt=
TDMRsrcModuleGen=
OrigTDMRsrcModuleCntxt=
TermTDMRsrcModuleCntxt=
PktRsrcModuleGen=

90000
80
0
90010
0
90020
90021
0

OrigPktRsrcModuleCntxt=
TermPktRsrcModuleCntxt=
PhysicalModuleGen=

90030
90031
0

PhysicalModuleCntxt=
PrefixModuleGen=
DialedPrefixModuleCntxt=
CalledPrefixModuleCntxt=
TreatmentModuleGen=

90040
0
81
82
0

TreatmentModuleCntxt=

90050

Telica, Inc.

Orig Number Module 164 Generation


0 - Use GR-1100 generation rules
1 - Generate 164 Module for all
originating numbers
Term Number Module 164 Generation
0 - Use GR-1100 generation rules
1 - Generate 164 Module for international
terminating numbers
2 - Generate 164 Module for all
terminating numbers
Dialed Digits Module Generation (Module 101)
Outpulse Digits Module Generation
(Module 40)
Trunk Id Module Generation
0 Disable trunk id module generation
1 Generate Module 104
2 Generate Module 167 (Large trunks)
SIP Call Id Module Generation (Module 198)
Call Id Module Generation (Module 611)
Release Cause Module Generation
(Module 616)
Quality of Service Module Generation
(Module 264)
Sequence Number Module Generation
(Module 611 and 616)
Call Sequence Number Module Context
Record Sequence Number Module Context
Final Trunk Module Generation (Module 611)
Final Trunk Module Context
TDM Resource Module Generation (Module 611)
Orig TDM Resource Module Context
Term TDM Resource Module Context
Packet Resource Module Generation
(Module 613)
Orig Packet Resource Module Context
Term Packet Resource Module Context
Physical Interface Module Generation
(Module 612)
Physical Interface Module Context
Prefix Module Generation (Module 616)
Dialed Prefix Module Context
Called Prefix Module Context
Call Treatment Module Generation
(Module 198)
Call Treatment Module Context

9-105

DLP-541

#
#
#
#
#
#
#
#

211CallType=
311CallType=
411CallType=
511CallType=
611CallType=
711CallType=
811CallType=
911CallType=

Section 150-500-400
Issue 3, January 9, 2004

0
0
9
0
0
0
0
0

Call Types for N11 Calls - Valid values are from


zero to 999. The value zero disables AMA generation.

# Output Options
# -------------# Enable ASCII output
# Enable ASCII push
#
ASCIIEnabled= 1
ASCIIPush= 0

0 - Disable 1 - Enable
0 - Disable 1 - Enable
(see section AsciiPush)

# Enable BAF output (AMA Lite)


# Enable BAF push
#
BAFEnabled= 0
BAFPush= 0

0 - Disable 1 - Enable
0 - Disable 1 - Enable
(see section BafPush)

# Enable PlexView Pro output


ProBillEnabled= 0

0 - Disable

1 - Enable

# ASCII/BAF file parameters


# ------------------------# Note: These parameters are relevant only if ASCII or
#
BAF (AMA Lite) output is enabled
# Directory for ASCII output files
ASCIIDir= ./Bill_data/ascii
# Directory for BAF output files
BAFDir= ./Bill_data/baf
# Time BAF and ASCII output files are open for writing (minutes)
FileInterval= 120
# Purge empty BAF and ASCII files
#
0 - Do not purge
#
1 - Purge
PurgeNull= 0
# PlexView Pro Parameters
# ----------------------# Note: These parameters are relevant only if PlexView Pro output is enabled
#
# GDIDir= ./Bill_data/proBill
Directory for PlexView Pro data record buffer
##########################
# ProBilling configuration
##########################

9-106

Telica, Inc.

Section 150-500-400
Issue 3, January 9, 2004

DLP-541

[ProBillingConfig]

#
#
#
#
#
#
#
#

gdiRecordSize=
128
gdiMiniRecs=
1024
gdiMiniInWhole= 4000
gdiPsPort=
gdiPsRaoHost=

1983
<none>

gdiPsHost=

<none>

#gdiPsRaoHost=

Average size of BAF records in bytes


Number of records to be held in shared memory
Number of gdiMiniRecs to be stored in disk buffer
(total records = gdiMiniRecs * gdiMiniInWhole)
port that ProBilling is listening on
Revenue Accounting Host (ProBilling Server)
or 0 to 4 instances of
ProBilling Server hostname/IP

localhost

#################################
# AsciiPush entity configuration
#################################
# Configure FTP push of ASCII billing files to remote server
[AsciiPush]
#
#
#
#
#
#

ArchiveDays=
7
DestinationDir=
Passive=
1
Host=
User=
Password=

Number of days to retain files that have been pushed


Destination directory on FTP server for files
Use FTP passive transfer (0/1 F/T)
FTP server hostname/IP
FTP server login id
FTP server login password

#################################
# BafPush entity configuration
#################################
# Configure FTP push of BAF (AMA Lite) billing files to remote server
[BafPush]
#
#
#
#
#
#

ArchiveDays=
7
DestinationDir=
Passive=
1
Host=
User=
Password=

Number of days to retain files that have been pushed


Destination directory on FTP server for files
Use FTP passive transfer (0/1 F/T)
FTP server hostname/IP
FTP server login id
FTP server login password

#################################
# Statistics entity configuration
#################################
[StatisticsConfig]
# TypeOf740If=
#
# LogPath=
# TsdsPath=

4
./stats_log
./tsds_data

4=TSAA statistics data fed to tsaa reporter


8=NONE
Path for statistics log file (future)
Path for TSDS .dat files (for TSAA input)

############INFORMATION#######################################################
# Timezone Info, [DataCollectorConfig] section
#
For detailed description of the rules for defining Timezone,
#
see the description of the TZ environment variable in environ(5).
#
#
TZ values used in US:
#
US/Alaska
US/Central
US/Hawaii
US/Pacific
#
US/Aleutian
US/East-Indiana US/Michigan
US/Pacific-New
#
US/Arizona
US/Eastern
US/Mountain
US/Samoa

Telica, Inc.

9-107

DLP-541

#
#
#
#
#
#

Section 150-500-400
Issue 3, January 9, 2004

The Timezone adjusts the time offset from GMT and the rules for
daylight savings time (if applicable).
If the configured Timezone is invalid, then use GMT, if no Timezone
is provided then server's time zone is used for time calculations.

Table 9-Z. S99PlexDC File (partial)


#!/sbin/sh
#
# Copyright (c) 2000-2002 by Telica, Inc.
# All rights reserved.
#
# $Id: S99PlexDC,v 1.4 2003/09/04 19:12:05 rthornto Exp $
#
#
#
#
#
#
#
#
#
#

Add the name of each TelicaPlexusDc instance to start to PLXDC_INSTANCES.


These should be the subdirectory names under PLXDC_BASE_DIR
(e.g. PLXDC_INSTANCES="PlexDC1 PlexDC2 SwitchName1 SwitchName2"
A plexusDc.ini configuration file must exist in each subdirectory.
TSAA instances are defined by TSAA_INSTANCES which by default is a copy
of PLXDC_INSTANCES. Set it = "" to stop any TSAA instance from being
started, or set it to the specific subdirectory name to only start
specific instances. A tsaa.conf configuration file must exist in each
subdirectory.

PLXDC_BASE_DIR="/opt/PlexDC/"
PLXDC_INSTANCES=""
TSAA_INSTANCES=$PLXDC_INSTANCES
#
# Only allow this script to run by root

Note: Only the beginning of the file is shown above because only the line indicated in
bold must be modified.

Table 9-AA. Display of Package Add


The following packages are available:
1 BTS
Telica BTS application
(sparc) 3.9.0.0.31
2 TCA
Telica TSAA application
(sparc) 2.0.0.66
Select package(s) you wish to process (or 'all' to process
all packages). (default: all) [?,??,q]: 1
Processing package instance <BTS> from </opt>

9-108

Telica, Inc.

Section 150-500-400
Issue 3, January 9, 2004

DLP-541

Telica BTS application


(sparc) 3.9.0.0.313
Copyright (c) 2003 Telica, Inc.
734 Forest Street
Building G
Marlboro, MA 01752
Phone: (508) 480-0909
Fax: (508) 480-0922
All rights reserved. This product and related documentation is
protected by
copyright and distributed under licenses restricting its use,
copying,
distribution and decompilation. No part of this product or related
documentation
may be reproduced in any form by any means without prior written
authorization of
Telica and its licensors, if any.
Looking for previously installed BTS package...
ERROR: information for "BTS" was not found
Enter BTS pkg installation directory base [?,q] /opt
HOMEDIR=/home
GROUPNUM=802
Using </opt> as the package base directory.
## Processing package information.
## Processing system information.
## Verifying disk space requirements.
## Checking for conflicts with packages already installed.
## Checking for setuid/setgid programs.
The following files are being installed with setuid and/or setgid
permissions:
* /opt2/PlexDC/btsadmin <setuid btsadm>
* - overwriting a file which is also setuid/setgid.
Do you want to install these as setuid/setgid files [y,n,?,q] y
This package contains scripts which will be executed with super-user
permission during the process of installing this package.
Do you want to continue with the installation of <BTS> [y,n,?] y
Installing Telica BTS application as <BTS>
## Installing part 1 of 1.
/opt/PlexDC/S99PlexDC
/opt/PlexDC/TelicaPlexusDc
/opt/PlexDC/gdi_trans

Telica, Inc.

9-109

DLP-541

Section 150-500-400
Issue 3, January 9, 2004

/opt/PlexDC/plexusDc_template.ini
[ verifying class <util> ]

Installation of <BTS> was successful.


The following packages are available:
1 BTS
Telica BTS application
(sparc) 3.9.0.0.31
2 TCA
Telica TSAA application
(sparc) 2.0.0.66
Select package(s) you wish to process (or 'all' to process
all packages). (default: all) [?,??,q]: q

9-110

Telica, Inc.

Section 150-500-400
Issue 2, January 9, 2004

DLP-542

DLP-542 - UPGRADE THE BILLING AND TRAFFIC SYSTEM


SUMMARY:
This procedure provides instructions for upgrading the Billing and
Traffic System (BTS) application on the Sun server. It also provides steps to verify that
the application has started properly.
Knowledge of UNIX and the vi command or other text editor is also required. If you
have questions regarding vi, please contact Telica Technical Services at 1-888-440-8354.
Procedures for provisioning the Plexus for the billing and traffic are found in the Plexus
9000 Installation and Operation Manual.

Note 1: To avoid local time synchronization problems, Telica strongly


recommends setting both the Plexus and the BTS server system clock to
GMT. For assistance, please contact Telica Technical Services at 1-888440-8354.
Note 2: Users of the BTS application are responsible for managing file
space the BTS server.
Note 3: The Enter key, indicated by , must always follow inputs that you
enter.

Step 1.

The Billing and Traffic System (BTS) supports the Plexus 9000, release 3.8,
and must meet these prerequisites:

Sun Solaris 7 or 8 with 256 MB memory and a 10/100 Ethernet


card
Sun Ultra 10 or Sun Netra X1 at a minimum

Step 2.

Log into the BTS server as root after obtaining the username and password.

Step 3.

Once logged onto the server, check the default admin install settings by typing:

less

/var/sadm/install/admin/default

Sample response is on the following page.

Telica, Inc.

9-71

DLP-542

Section 150-500-400
Issue 2, January 9, 2004
Sample Response:
#ident "@(#)default
1.5.2.1
*/
mail=

1.4

92/12/23 SMI"

/* SVr4.0

instance=overwrite
partial=ask
runlevel=ask
idepend=ask
rdepend=ask
space=ask
setuid=ask
conflict=ask
action=ask
basedir=default

Step 4.

Verify that instance=overwrite. Does instance equal unique or


overwrite?
If unique, then continue to the next step.
If overwrite, then go to Step 4.

Step 5.

Using vi or any available text editor, edit the default file instance line to equal
overwrite and save the file. If using vi, type:

vi
Step 6.

/var/sadm/install/admin/default

Create the upgrade directory in opt/PlexDc if it does not already exist. Do this
by typing:

mkdir /opt/PlexDC/upgrade

Step 7.

Change directories by typing:

cd /opt/PlexDC/upgrade

Note: In the following steps, the correct version number should be substituted
for x.x.x.x.x.
Step 8.

If you do not have a Billing and Traffic System CD ROM with the
BTS_X.X.X.X.X.tar.gz file or a copy of the BTS_X.X.X.X.X.tar.gz file, obtain a
copy from Telica Technical Services at 1-888-440-8354.

Step 9.

Copy this file to the PlexDC/upgrade directory on the BTS server.

Note: The tar file will extract directly into /opt/PlexDC.

9-72

Telica, Inc.

Section 150-500-400
Issue 2, January 9, 2004

DLP-542

Step 10. Untar BTS_X.X.X.X.X.tar.gz file by substituting the correct version number for
x.x.x.x.x and typing:

gunzip -xvf BTS_X.X.X.X.X.tar.gz

Step 11. Untar BTS_X.X.X.X.X.tar file by substituting the correct version number for
x.x.x.x.x and typing:

tar -xvf BTS_X.X.X.X.X.tar

Step 12. Type the following command ensuring that you type the period after -d.

pkgadd a admin -d.


.
Step 13. Do you see a response similar to the following?
If YES, then continue to the next step.
If NO, then go to Step 19.
Response:
The following packages are available:
1 BTS
Telica BTS application
(sparc) 3.9.0.0.31
2 TCA
Telica TSAA application
(sparc) 2.0.0.66
Select package(s) you wish to process (or 'all'
to process
all packages). (default: all) [?,??,q]:
Step 14. Type the number of the BTS package followed by the Enter key. You should
always install the BTS package first.
Step 15. The package add utility will begin its process. For a complete display for
output, refer to Table 9-EE. When finished, you will see the following message
displayed:
Installation of <BTS> was successful.
The following packages are available:
1 BTS
Telica BTS application
(sparc) 3.9.0.0.13
2 TCA
Telica TSAA application
(sparc) 2.0.0.62
Select package(s) you wish to process (or 'all'
to process all packages). (default: all) [?,??,q]

Telica, Inc.

9-73

DLP-542

Section 150-500-400
Issue 2, January 9, 2004

Step 16. Type q to quit followed by the Enter key. You will enter the TCA application
in another procedure.
Step 17. Do you want if verify the currently installed BTS package?
If YES, then type the following and then go to Step 18.

pkginfo l BTS

Response:
# pkginfo -l
PKGINST:
NAME:
CATEGORY:
ARCH:
VERSION:
BASEDIR:
VENDOR:
PSTAMP:
INSTDATE:
STATUS:
FILES:

BTS
BTS
Telica BTS application
system
sparc
3.9.0.0.31
/opt
Telica
martin20030911172127
Dec 09 2003 10:00
completely installed
8 installed pathnames

1
6
6
1
36371

directories
executables
executables
setuid/setgid executables
blocks used (approx)

If NO, then go to Step 18.


Step 18. Compare the new plexusDc_template.ini file in the upgrade directory with the
existing files. This must be done for each switch. A sample of this file is
shown in Table 9-Y found at the end of this procedure. Do the PlexusDC.ini
files for the different switches require any changes?
If YES, then continue to the next step.
If NO, then go to Step 27.
Step 19. Copy the plexusDc_template.ini file into the SwitchName or plexusDCn
directory.

cp plexusDc_template.ini
<SwitchName>/plexusDc_template.ini

Step 20. Change to the directory for a switch.

cd <SwitchName>

9-74

Telica, Inc.

Section 150-500-400
Issue 2, January 9, 2004

DLP-542

Step 21. Using vi or any available text editor, edit the new initialization file template so
that fields are the same as the original plexusDc.ini file in that directory. Refer
to Table 9-Y at the end of this procedure for an example of the complete
plexusDc.ini file. If using vi, type:

vi plexusDc/plexusDc_template.ini

Step 22. Save the file as plexusDC.ini into the appropriate directory.
Step 23. Have you copied and made the changes to the plexusDC.ini files into directories
for each switch that required changing?
If YES, then continue to the next step.
If NO, then go to Step 19.
Step 24. Using vi or any available text editor, edit the S99PlexDC file by typing:

vi

/opt/PlexDC/S99PlexDC

Step 25. Will the TSAA_INSTANCES be different from the PLXDC_INSTANCES? ?


If YES, then modify the line in the S99PlexDC file that reads
TSAA_INSTANCES as shown in Table 9-BB. Enter the names of the
switches separated by spaces (i.e.,INSTANCES="tsaa1 tsaa2
PlexDC3" or INSTANCES="bostsaa1 bostsaa2) .
Remember to save the file before exiting.
Step 26. Copy the S99PlexDC file into the /etc/rc3.d directory by typing:

cp p S99PlexDC /etc/rc3.d

Telica, Inc.

9-75

DLP-542

Section 150-500-400
Issue 2, January 9, 2004

Table 9-BB. S99PlexDC File (partial)


#!/sbin/sh
#
# Copyright (c) 2000-2002 by Telica, Inc.
# All rights reserved.
#
# $Id: S99PlexDC,v 1.4 2003/09/04 19:12:05 rthornto Exp $
#
#
#
#
#
#
#
#
#
#

Add the name of each TelicaPlexusDc instance to start to PLXDC_INSTANCES.


These should be the subdirectory names under PLXDC_BASE_DIR
(e.g. PLXDC_INSTANCES="PlexDC1 PlexDC2 SwitchName1 SwitchName2"
A plexusDc.ini configuration file must exist in each subdirectory.
TSAA instances are defined by TSAA_INSTANCES which by default is a copy
of PLXDC_INSTANCES. Set it = "" to stop any TSAA instance from being
started, or set it to the specific subdirectory name to only start
specific instances. A tsaa.conf configuration file must exist in each
subdirectory.

PLXDC_BASE_DIR="/opt/PlexDC/"
PLXDC_INSTANCES="PlexDc1 PlexDc2"
TSAA_INSTANCES="tsaa1 tsaa2"
#
# Only allow this script to run by root

Note: Only the beginning of the file is shown above because only the line indicated in
bold must be modified.

Step 27. Do you need to upgrade the TCA application?


If YES, then go to DLP-523 and complete before continuing.
If NO, then continue to the next step.

9-76

Telica, Inc.

Section 150-500-400
Issue 2, January 9, 2004

DLP-542

Step 28. Run the BTS admin tool from this location by typing the following and entering
a 1 to start an instance.

./btsadmin

Response:
#######################################################
############
Main Menu
######
1)
2)
3)
4)
5)
6)
7)
8)

Start an Instance
ReStart an Instance
Stop an Instance
Reinitialize an Instance
Start All Instances
Stop All Instances
Status
Exit

Enter the choice:

Step 29. The following menu will appear to allow you to select the switch. Names will
differ depending upon how your switches were named.
Response:
#######################################################
############
Start Menu
######
1)
2)
3)
4)
5)
6)
7)
8)

PlexDC1
PlexDC2
PlexDC3
PlexDC4
PlexDC5
PlexDC6
PlexDC7
PlexDC8

9) Main Menu
Enter the choice: 7

Telica, Inc.

9-77

DLP-542

Section 150-500-400
Issue 2, January 9, 2004

Step 30. The following menu will be displayed allowing to start the BTS
(TelicaPlexusDc), TCA (tsaaDc), both BTS and TCA or return to the main
menu. In the following example, BTS is selected.
Response:
#######################################################
############
Choose Module for PlexDC7
######
1)
2)
3)
4)

TelicaPlexusDc
tsaaDc
Both
Main Menu

Enter the choice: 1

Response:
.
BTSBackupAdmin START Info:
TelicaPlexusDc for "PlexDC7" is started.

Step 31. When the following menu appears, you can check the status of the data
collector by selecting 7.
Response:
#######################################################
############
Main Menu
######
1)
2)
3)
4)
5)
6)
7)
8)

Start an Instance
ReStart an Instance
Stop an Instance
Reinitialize an Instance
Start All Instances
Stop All Instances
Status
Exit

Enter the choice: 7

9-78

Telica, Inc.

Section 150-500-400
Issue 2, January 9, 2004

DLP-542

Response:
BTS STATUS:
PID COMMAND
9335 ./TelicaPlexusDc -C PlexDC8
9307 ./TelicaPlexusDc -C PlexDC4
348 ./tsaaDc -C PlexDC3
352 ./tsaaDc -C PlexDC5
355 ./tsaaDc -C PlexDC7
357 ./tsaaDc -C PlexDC8
9300 ./TelicaPlexusDc -C PlexDC3
9321 PlexDC6/TelicaPlexusDc -C PlexDC6
4123 ./tsaaDc -C PlexDC1
9314 ./TelicaPlexusDc -C PlexDC5
9286 ./TelicaPlexusDc -C PlexDC1
9293 ./TelicaPlexusDc -C PlexDC2

BTSBackupAdmin :

Step 32. When the menu appears, you can make your next selection or exit.
Response:
#######################################################
############
Main Menu
######
1)
2)
3)
4)
5)
6)
7)
8)

Start an Instance
ReStart an Instance
Stop an Instance
Reinitialize an Instance
Start All Instances
Stop All Instances
Status
Exit

Enter the choice: 8

Step 33. Verify that the following directories were created under the /opt/PlexDC
directory by typing:

/opt/PlexDc/ls l <SwitchName>

Response:
Bill_data
logs
stats_log
tsds_data

Telica, Inc.

9-79

DLP-542

Section 150-500-400
Issue 2, January 9, 2004

Step 34. Verify that the following directories have been created under the
/opt/PlexDC/Bill_data directory by typing:

/opt/PlexDc/ls l <SwitchName>/Bill_data

Response:
ascii
baf
proBill
Step 35. Verify that a log file and connection info file have been created (dcLog.out and
gdi.conn) by typing:

/opt/PlexDc/ls l <SwitchName>/logs

Step 36. If provisioning for billing must be completed at the Plexus 9000, refer to the
Plexus 9000 Installation and Operation Manual and NTP-018.
Step 37. Generate calls to or from any of the subscribers provisioned on the Plexus.
Note: AMA binary files of billing records, <PREFIX>_yyyymmdd_time.txt, are
created in accordance to the frequency defined in the plexusDc.ini file. These
are binary ama records.
SwitchName/logs/dcLog.out contains information regarding the connections
(new connections, lost connections, error messages).
Step 38. Do you want to view the dcLog.out file?
If YES, then view file by typing the following:

less <SwitchName>/logs/dcLog.out
If NO, then continue to the next step.
Step 39. Do you want to logout of the BTS server at this time?
If YES, then logout by typing exit

If NO, then continue to the next step.


Step 40.

9-80

YOU HAVE COMPLETED THIS PROCEDURE.

Telica, Inc.

Section 150-500-400
Issue 2, January 9, 2004

DLP-542

Table 9-CC. PlexusDc.ini File


# Template TelicaPlexusDc configuration file.
# $Id: plexusDc_template.ini,v 1.11.2.17 2003/12/03 21:53:58 ggaus Exp $
#
# The parameter comment blocks document the default settings if the
# parameter is not defined in this file.
#
# Parameter names are not case sensitive, but the "=" MUST follow the
# name with no intervening space.
#
#NOTE: actual parameter lines can NOT include comments on the end
##############################
#Data Collector MAIN Entity Configuration
##############################
[DataCollectorConfig]
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#

Prefix=
MaxLogQueue=
MaxFileSize=
MaxFileCount=
LogPath=
LogFilename=
DebugPort=
DebugBindIp=
BindIp=

<none>
16384
10485760
6
./logs
dcLog
<none>
0.0.0.0
0.0.0.0

Timezone=

<system>

Prefix=

prefix for various output files (ascii, baf, stats)


max trace entries allow on queue before dropping
max size in bytes of any single trace file
max old trace log files retained
directory for trace log files
base name of trace log files
telnet debug port into DataCollector
(INADDR_ANY) override BindIp for debug port only.
(INADDR_ANY) default local bind IP(i/f) for all
TCP listen and connect calls (allows DC bind
to system alias IP). Other sections in the ini
will default to this value if their individual
BindIp is not defined.
USE ONLY IF SERVER and SWITCH timezones DON'T MATCH
Timezone is used to calculate file names, file
rollover times, and some billing fields.
See end of file for description.

SwitchName

##############################
#Receiver Entity Configuration
##############################
[ReceiverConfig]
#
#
#
#
#
#
#
#

GdiPort=
GdiHost=

1986
mgcId

host/IP

IP port to listen on for GDI connections


mgcId is a unique integer (1-63)

ArchiveDays=
0
ArchiveInterval= 720
720 minutes = 12 hour (limit 5 - 1440)
ArchivePath=
<DataCollectConfig:LogPath>
ArchivePrefix=
<DataCollectConfig:Prefix>
ArchivePurgeNull= 1
purge null files

GdiHost=
GdiHost=

Telica, Inc.

1
2

SPA_address
SPB_address

9-81

DLP-542

Section 150-500-400
Issue 2, January 9, 2004

#################################
# Billing entity configuration
#################################
[BillingConfig]

# AMA Record Formatting Parameters


# -------------------------------#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#

SensorType=
SensorId=

195
0

RecOfficeType=
RecOfficeId=

195
999999

DAAMAGen=
IntraLATAAMAGen=
FraudAMAGen=
FraudCallType=

1
1
0
800

Sensor Type
Sensor Id - If non-zero, it overrides the
switch Id sent from the switch.
Recording Office Type
Recording Office Id
Directory Assistance AMA Generation
Intra LATA AMA Generation
Fraud AMA Generation
Call Type for Fraud Calls - Valid values are
from 800 to 999.

OrigNumberModuleGen=

TermNumberModuleGen=

DialedDigitsModuleGen=
0
OutpulseDigitsModuleGen= 0
TrunkIdModuleGen=

SipCallIdModuleGen=
CallIdModuleGen=
ReleaseCauseModuleGen=

0
0
0

QoSModuleGen=

SeqNumModuleGen=

CallSeqModuleCntxt=
RecordSeqModuleCntxt=
FinalTrunkModuleGen=
FinalTrunkModuleCntxt=
TDMRsrcModuleGen=
OrigTDMRsrcModuleCntxt=
TermTDMRsrcModuleCntxt=
PktRsrcModuleGen=

90000
80
0
90010
0
90020
90021
0

OrigPktRsrcModuleCntxt=
TermPktRsrcModuleCntxt=
PhysicalModuleGen=

90030
90031
0

PhysicalModuleCntxt=
90040
PrefixModuleGen=
0
DialedPrefixModuleCntxt= 81

9-82

Orig Number Module 164 Generation


0 - Use GR-1100 generation rules
1 - Generate 164 Module for all
originating numbers
Term Number Module 164 Generation
0 - Use GR-1100 generation rules
1 - Generate 164 Module for international
terminating numbers
2 - Generate 164 Module for all
terminating numbers
Dialed Digits Module Generation (Module 101)
Outpulse Digits Module Generation
(Module 40)
Trunk Id Module Generation
0 Disable trunk id module generation
1 Generate Module 104
2 Generate Module 167 (Large trunks)
SIP Call Id Module Generation (Module 198)
Call Id Module Generation (Module 611)
Release Cause Module Generation
(Module 616)
Quality of Service Module Generation
(Module 264)
Sequence Number Module Generation
(Module 611 and 616)
Call Sequence Number Module Context
Record Sequence Number Module Context
Final Trunk Module Generation (Module 611)
Final Trunk Module Context
TDM Resource Module Generation (Module 611)
Orig TDM Resource Module Context
Term TDM Resource Module Context
Packet Resource Module Generation
(Module 613)
Orig Packet Resource Module Context
Term Packet Resource Module Context
Physical Interface Module Generation
(Module 612)
Physical Interface Module Context
Prefix Module Generation (Module 616)
Dialed Prefix Module Context

Telica, Inc.

Section 150-500-400
Issue 2, January 9, 2004
#
#
#
#
#
#
#
#
#
#
#
#
#

DLP-542

CalledPrefixModuleCntxt= 82
TreatmentModuleGen=
0
TreatmentModuleCntxt=
211CallType=
311CallType=
411CallType=
511CallType=
611CallType=
711CallType=
811CallType=
911CallType=

0
0
9
0
0
0
0
0

90050

Called Prefix Module Context


Call Treatment Module Generation
(Module 198)
Call Treatment Module Context

Call Types for N11 Calls - Valid values are from


zero to 999. The value zero disables AMA generation.

# Output Options
# -------------# Enable ASCII output
# Enable ASCII push
#
ASCIIEnabled= 1
ASCIIPush= 0

0 - Disable 1 - Enable
0 - Disable 1 - Enable
(see section AsciiPush)

# Enable BAF output (AMA Lite)


# Enable BAF push
#
BAFEnabled= 0
BAFPush= 0

0 - Disable 1 - Enable
0 - Disable 1 - Enable
(see section BafPush)

# Enable PlexView Pro output


ProBillEnabled= 0

0 - Disable

1 - Enable

# ASCII/BAF file parameters


# ------------------------# Note: These parameters are relevant only if ASCII or
#
BAF (AMA Lite) output is enabled
# Directory for ASCII output files
ASCIIDir= ./Bill_data/ascii
# Directory for BAF output files
BAFDir= ./Bill_data/baf
# Time BAF and ASCII output files are open for writing (minutes)
FileInterval= 120
# Purge empty BAF and ASCII files
#
0 - Do not purge
#
1 - Purge
PurgeNull= 0
# PlexView Pro Parameters
# ----------------------# Note: These parameters are relevant only if PlexView Pro output is enabled
#
# GDIDir= ./Bill_data/proBill
Directory for PlexView Pro data record buffer
##########################

Telica, Inc.

9-83

DLP-542

Section 150-500-400
Issue 2, January 9, 2004

# ProBilling configuration
##########################
[ProBillingConfig]
#
#
#
#
#
#
#
#

gdiRecordSize=
128
gdiMiniRecs=
1024
gdiMiniInWhole= 4000
gdiPsPort=
gdiPsRaoHost=

1983
<none>

gdiPsHost=

<none>

#gdiPsRaoHost=

Average size of BAF records in bytes


Number of records to be held in shared memory
Number of gdiMiniRecs to be stored in disk buffer
(total records = gdiMiniRecs * gdiMiniInWhole)
port that ProBilling is listening on
Revenue Accounting Host (ProBilling Server)
or 0 to 4 instances of
ProBilling Server hostname/IP

localhost

#################################
# AsciiPush entity configuration
#################################
# Configure FTP push of ASCII billing files to remote server
[AsciiPush]
#
#
#
#
#
#

ArchiveDays=
7
DestinationDir=
Passive=
1
Host=
User=
Password=

Number of days to retain files that have been pushed


Destination directory on FTP server for files
Use FTP passive transfer (0/1 F/T)
FTP server hostname/IP
FTP server login id
FTP server login password

#################################
# BafPush entity configuration
#################################
# Configure FTP push of BAF (AMA Lite) billing files to remote server
[BafPush]
#
#
#
#
#
#

ArchiveDays=
7
DestinationDir=
Passive=
1
Host=
User=
Password=

Number of days to retain files that have been pushed


Destination directory on FTP server for files
Use FTP passive transfer (0/1 F/T)
FTP server hostname/IP
FTP server login id
FTP server login password

#################################
# Statistics entity configuration
#################################
[StatisticsConfig]
# TypeOf740If=
#
# LogPath=
# TsdsPath=

9-84

4
./stats_log
./tsds_data

4=TSAA statistics data fed to tsaa reporter


8=NONE
Path for statistics log file (future)
Path for TSDS .dat files (for TSAA input)

Telica, Inc.

Section 150-500-400
Issue 2, January 9, 2004

DLP-542

############INFORMATION#######################################################
# Timezone Info, [DataCollectorConfig] section
#
For detailed description of the rules for defining Timezone,
#
see the description of the TZ environment variable in environ(5).
#
#
TZ values used in US:
#
US/Alaska
US/Central
US/Hawaii
US/Pacific
#
US/Aleutian
US/East-Indiana US/Michigan
US/Pacific-New
#
US/Arizona
US/Eastern
US/Mountain
US/Samoa
#
#
The Timezone adjusts the time offset from GMT and the rules for
#
daylight savings time (if applicable).
#
#
If the configured Timezone is invalid, then use GMT, if no Timezone
#
is provided then server's time zone is used for time calculations.

Telica, Inc.

9-85

DLP-542

Section 150-500-400
Issue 2, January 9, 2004

Table 9-DD. S99PlexDC File (partial)


#!/sbin/sh
#
# Copyright (c) 2000-2002 by Telica, Inc.
# All rights reserved.
#
# $Id: S99PlexDC,v 1.4 2003/09/04 19:12:05 rthornto Exp $
#
#
#
#
#
#
#
#
#
#

Add the name of each TelicaPlexusDc instance to start to PLXDC_INSTANCES.


These should be the subdirectory names under PLXDC_BASE_DIR
(e.g. PLXDC_INSTANCES="PlexDC1 PlexDC2 SwitchName1 SwitchName2"
A plexusDc.ini configuration file must exist in each subdirectory.
TSAA instances are defined by TSAA_INSTANCES which by default is a copy
of PLXDC_INSTANCES. Set it = "" to stop any TSAA instance from being
started, or set it to the specific subdirectory name to only start
specific instances. A tsaa.conf configuration file must exist in each
subdirectory.

PLXDC_BASE_DIR="/opt/PlexDC/"
PLXDC_INSTANCES=""
TSAA_INSTANCES=$PLXDC_INSTANCES
#
# Only allow this script to run by root

Note: Only the beginning of the file is shown above because only the line indicated in
bold must be modified.

9-86

Telica, Inc.

Section 150-500-400
Issue 2, January 9, 2004

DLP-542

Table 9-EE. Display of Package Add


The following packages are available:
1 BTS
Telica BTS application
(sparc) 3.9.0.0.31
2 TCA
Telica TSAA application
(sparc) 2.0.0.66
Select package(s) you wish to process (or 'all' to process
all packages). (default: all) [?,??,q]: 1
Processing package instance <BTS> from </opt>
Telica BTS application
(sparc) 3.9.0.0.313
Copyright (c) 2003 Telica, Inc.
734 Forest Street
Building G
Marlboro, MA 01752
Phone: (508) 480-0909
Fax: (508) 480-0922
All rights reserved. This product and related documentation is
protected by
copyright and distributed under licenses restricting its use,
copying,
distribution and decompilation. No part of this product or related
documentation
may be reproduced in any form by any means without prior written
authorization of
Telica and its licensors, if any.
Looking for previously installed BTS package...
Found BTS Version=3.9.0.0.30 at "/opt".
Enter BTS pkg installation directory base [?,q] /opt
HOMEDIR=/home
GROUPNUM=802
Using </opt> as the package base directory.
## Processing package information.
## Processing system information.
## Verifying disk space requirements.
## Checking for conflicts with packages already installed.
## Checking for setuid/setgid programs.
The following files are being installed with setuid and/or setgid
permissions:
* /opt2/PlexDC/btsadmin <setuid btsadm>
* - overwriting a file which is also setuid/setgid.
Do you want to install these as setuid/setgid files [y,n,?,q] y

Telica, Inc.

9-87

DLP-542

Section 150-500-400
Issue 2, January 9, 2004

This package contains scripts which will be executed with super-user


permission during the process of installing this package.
Do you want to continue with the installation of <BTS> [y,n,?] y
Installing Telica BTS application as <BTS>
## Installing part 1 of 1.
/opt/PlexDC/S99PlexDC
/opt/PlexDC/TelicaPlexusDc
/opt/PlexDC/gdi_trans
/opt/PlexDC/plexusDc_template.ini
[ verifying class <util> ]
Installation of <BTS> was successful.
The following packages are available:
1 BTS
Telica BTS application
(sparc) 3.9.0.0.31
2 TCA
Telica TSAA application
(sparc) 2.0.0.66
Select package(s) you wish to process (or 'all' to process
all packages). (default: all) [?,??,q]: q

9-88

Telica, Inc.

10

Acronyms

A ........................................................................................................................10-2
B ........................................................................................................................10-2
C ........................................................................................................................10-2
D ........................................................................................................................10-3
E.........................................................................................................................10-4
F .........................................................................................................................10-4
G ........................................................................................................................10-4
H ........................................................................................................................10-4
I ..........................................................................................................................10-4
J ..........................................................................................................................10-5
K ........................................................................................................................10-5
L.........................................................................................................................10-5
M .......................................................................................................................10-5
N ........................................................................................................................10-6
O ........................................................................................................................10-6
P .........................................................................................................................10-6
Q ........................................................................................................................10-7
R ........................................................................................................................10-7
S .........................................................................................................................10-7
T.........................................................................................................................10-7
U ........................................................................................................................10-8
V ........................................................................................................................10-8
W .......................................................................................................................10-8
X ........................................................................................................................10-8
Y ........................................................................................................................10-8
Z.........................................................................................................................10-8

Acronyms

Issue 3, November 14, 2003

A
ABS
ABN
AC
ACM
ACR
AFR
AIN
AINI
AIOD
AMA
AMADNS
AMI
ANA
ANI
ANM
ANSI
AP
AR
ASCII
ASN.1
AT
ATM

ASCII Billing Server


Alternate Billing Number
Automatic Callback
Address Complete Message
Anonymous Call Rejection
Automatic Flexible Routing
Advanced Intelligent Network
ATM Inter-Network Interface
Automatic Identified Outward Dialing
Automatic Message Accounting
Automatic Message Accounting Data Networking
System
Alternate Mark Inversion
ATM Network Adapter
Automatic Number Identification
Answer Message
American National Standards Institute
Access Provider
Automatic Recall
American Standard Code for Information Inter-exchange
Abstract Syntax Notation One
Access Tandem
Asynchronous Transfer Mode

B
BAF
BDT
B-ISDN
B-ICI
BISUP
BLV
BNN
BRI
BSS
BTS

Bellcore AMA Format


Billing Data Transmitter
Broadband Integrated Services Digital Network
Broadband Inter-Carrier Interface
Broadband Integrated Services Digital Network User
Part
Busy Line Verification
Billed Number Screening
Basic Rate Interface
Broadband Switching System
Billing and Traffic System

CAC
CALEA
CAMA
CAP

Carrier Access Code


Communications Assistance for Law Enforcement Act
Centralized Automatic Message Accounting
Competitive Access Provider

10-2

Telica, Inc.

Billing and Traffic Collection Guide

CAS
CAS
CC
CC
CCIS
CCITT

Section 150-400-000

CCN
CCS
CDAR
CDR
CF
CFBL
ChN
CIC
CIDN
CIDS
CLASS
CLEC
CLEI
CLLI
CMC
CN
CNAB
CNAM

Channel Associated Signaling


Customer Account Service
Calling Card
Country Code
Common Channel Interoffice Signaling
Consultative Committee on International Telephone &
Telegraph
Calling Card Number
Common Channel Signaling
Customer-Dialed Account Recording
Call Detail Record
Call Forwarding
Call Forwarding Busy Line
Charge Number
Circuit Identification Code
Customer International Data Number
Calling Identity Delivery and Suppression
Custom Local Area Signaling Service
Competitive Local Exchange Carrier
Common Language Equipment Identifier
Common Language Location Identifier
Cellular Mobile Carrier
Cellular Network
Calling Name Delivery Blocking
Calling Name Delivery

CND
CNDB
CNI
CO
COT
CPE
CPN
CW
CWC

Calling Number Delivery


Calling Number Delivery Blocked
Calling Number Identification
Central Office
Continuity Test message
Customer Premises Equipment
Calling Party Number
Call Waiting
City Wide Centrex

DA
CACC
DCC
DCE
DCS
DDD
DLCI

Directory Assistance
Directory Assistance Call Completion
Data Country Code (DCC
Data Communication Equipment
Digital Cellular Switch
Direct Distance Dialing
Data Link Connection Identifier

Telica, Inc.

10-3

Acronyms

Issue 3, November 14, 2003

DN
DNIC
DP
DPMS
DR
DRCW
DSLAM
DSP
DTE

Directory Number
Data Network Identification Code
Dial Pulse
Data Processing and Management System
Distinctive Ringing
Distinctive Ringing/ Call Waiting
Digital Subscriber Line Access Multiplexer
Digital Signal Processor
Data Terminal Equipment

E1
EAEO
EC
EIA
EMS
EO
ESD

Electronic 1
Equal Access End Office
Exchange Carrier
Electronics Industries Association
Element Management System
End Office
ElectroStatic Discharge

FAC
FCC
FGB
FGD

Facility
Federal Communications Commission
Feature Group B
Feature Group D

Gb/s
GCC
GDI
GR
GUBB

Gigabits per second


Generic Call Control
Generating system to Data server Interface
Generic Requirement
Geographic Unit Building Block

HDLC

High-level Data Link Control

IAM
IAR
ICC
IC
IC/IXC

Initial Address Message


IAM Reject
Interworking Call Control
Inter-exchange Carrier
Inter-exchange Carrier/International Carrier
Identification
Identification

H
I

ID
10-4

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-400-000

IISP
ILEC
INC
INWATS
IP
IPP
ISDN
ISP
ISUP
IVR
IXC

Interim Interswitch Signaling Protocol


Incumbent Local Exchange Carrier
International Carrier Identification
Internet Protocol or Intelligent Peripheral
Independent Payphone Provider
Integrated Services Digital Network
Internet Service Provider
Integrated Services Digital Network User Part
Interactive Voice Response
Inter-exchange Carrier

KB
Kb/s
KP

KiloByte
Kilobits per second
Key Pulse

LAN
LATA
LDS
LEC
LIDB
LNP
LRN
LSPI
LSPI-SO

Local Area Network


Local Access & Transport Area
Local Digital Switch
Local Exchange Carrier
Line Information Database
Local Number Portability
Location Routing Number
Local Service Provider Identification
Local Service Provider Identification Switch Owner

MB
MBI
Mb/s
MDR
MF
MG
MGC
MOU
MTBF
MU

Megabyte
Master Base Index
Megabits per second
Message Detail Recording
Multifrequency
Media Gateway
Media Gateway Controller
Minutes of Use
Mean Time Between Failures
Message Unit

J
K

Telica, Inc.

10-5

Acronyms

Issue 3, November 14, 2003

N
NANP
NCD
NE
NEBS
NGDLC
NLP
NMS
NPA
NSA
NTM
NTN
NTP
NXX

North American Numbering Plan


Network Call Denial
Network Element
Network Equipment Building System
Next Generation Digital Loop Carrier
Non-Linear Processing
Network Management System
Numbering Plan Area
Non-Service Affecting
Network Traffic Management
Network Terminal Number
Network Trouble Patterning
The first three digits of a seven-digit telephone number;
indicates the central office exchange number

OAM
OAM&P
OC
OCN
OLI
OLIP
ONI
OPC
OS
OSS
OSPS
OUTWATS

Operations, Administration, and Maintenance


Operations, Administration, Maintenance, and
Provisioning
Optical Carrier
Original Called Number
Originating Line Information
Originating Line Information Parameter
Operator Number Identification
Originating Point Code
Operating System
Operator Services System
Operator Services Position System
Outward Wide Area telecommunications Service

PCS
PCR
PDN
PFP
PIC
PIN
PNNI
POP
PORC
POTS
PPP
PRI

Personal Cellular Service


Provisioned Circuit Record
Public Data Networks
Private Facility Pooling
Primary Inter-exchange Carrier
Personal Identification Number
Private Network-Network Interface
Point Of Presence
Portability Outside the Rate Center
Plain Old Telephone Service
Point to Point Protocol
Primary Rate Interface

10-6

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-400-000

PSDS
PSTN
PVC
PVN

Public Switched Digital Service


Public Switched Telephone Network
Permanent Virtual Connection
Private Virtual Network

QOS

Quality of Service

RAO
RBOC
RCF
RDT
REL
RN
RTP

Revenue Accounting Office


Regional Bell Operating Company
Remote Call Forwarding
Remote Digital Terminal
Release Message
Redirecting Number
Release To Pivot

SA
SASCF
SCA
SCCP
SCF
SCP
SCR
SDS
SFC
SG
SL
SLUS
SPC
SVC

Service Affecting
Selective Call Acceptance
Signaling Connection Control Part
Selective Call Forwarding
Service Control Point
Selective Call Rejection
Specific Digits String
Service Feature Code
Signaling Gateway
Screening List
Subscriber Line Usage Study
Signaling Point Code
Switched Virtual Connection

TCA
TCAP
TDM
TGN
TL1
TMM
TRS
TSP

Traffic Collection Application (formerly called TMM)


Transaction Capabilities Applications Part
Time-Division Multiplexer/Multiplexing
Trunk Group Number
Transaction Language 1
Traffic Management Module (now called TCA)
Telecommunications Relay Service
Tandem Switch Provider

Q
R

Telica, Inc.

10-7

Acronyms

Issue 3, November 14, 2003

TUP
TWC

Telephone User Part


Three-Way Calling

UBR
UMCD
UNI

Unspecified Bit Rate


Under minimum chargeable
User to Network Interface

VMS
VoIP
VSS

Voice Message System


Voice over Internet Protocol
Voice Storage System

WATS

Wide Area Telecommunications Service

X
Y
Z

10-8

Telica, Inc.

Appendix A. Release Causes


This appendix lists the release causes values in the following tables:
Table A-A.
Table A-B.
Table A-C.
Table A-D.

ITU Standardized Cause Indication (ITU Standard)............... 1


National Standardized Cause Values ...................................... 7
Network Specific Cause Values .............................................. 9
Other Cause Values............................................................... 10

Table A-A. ITU Standardized Cause Indication (ITU Standard)


Class

Cause Value Description

Normal

001 Unallocated (unassigned) number This cause indicates that the


called party cannot be reached because, although the called party
number is in a valid format, it is not currently allocated
(assigned).

Normal

002 No route to specified transit network This cause indicates that


the equipment sending this cause has received a request to route
the call through a particular transit network which it does not
recognize. The equipment sending this cause does not recognize
the transit network either because the transit network does not
exist or because that particular transit network, while it does
exist, does not serve the equipment which is sending this cause.
This cause is supported on a network-dependent basis.

Normal

003 No route to destination This cause indicates that the called


party cannot be reached because the network through which the
call has been routed does not serve the destination desired. This
cause is supported on a network-dependent basis. Cause 4 Send
special information tone. This cause indicates that the called
party cannot be reached for reasons that are of long term nature
and that the special information tone should be returned to the
calling party.

Normal

006 Channel unacceptable This cause indicates that the channel


most recently identified is not acceptable for use in this call.

Release Causes

Issue 1, March 24, 2003

Class

Normal

007 Call awarded and being delivered in an established channel

Normal

016 Normal call clearing - This cause indicates that the call is being
cleared because one of the users involved in the call has
requested that the call be cleared. Under normal situations, the
source of this cause is not the network.

Normal

017 User busy - This cause is used to indicate that the called party is
unable to accept another call because the user busy condition has
been encountered. This cause value may be generated by the
called user or by the network. In the case of user determined
user busy, it is noted that the user equipment is compatible with
the call.

Normal

018 No user responding - This cause is used when a called party


does not respond to a call establishment message with either an
alerting or connect indication within the prescribed period of
time allocated.

Normal

019 User alerting, No answer - This value is used when the called
party has been alerted but does not respond with a connect
indication within a prescribed period of time. Note - This cause
is not necessarily generated by Q.931 procedures but may be
generated by internal network timers.

Normal

021 Call rejected - This cause indicates that the equipment sending
this cause does not wish to accept this call, although it could
have accepted the call because the equipment sending this cause
is neither busy nor incompatible. This cause may also be
generated by the network, indicating that the call was cleared
due to a supplementary service constraint. The diagnostic field
may contain additional information about the supplementary
service and reason for rejection.

A-2

Cause Value Description

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-900-000

Class

Normal

022 Number changed - This cause is returned to a calling party when


the called party number indicated by the calling party is no
longer assigned. The new called party number may optionally be
included in the diagnostic field. If a network does not support
this cause value, cause number 1, unallocated (unassigned)
number shall be used.

Normal

027 Destination out of order - This cause indicates that the


destination indicated by the user can not be reached because the
interface to the destination is not functioning correctly. The term
not functioning correctly indicates that a signaling message
was unable to be delivered to the remote party; e.g., a physical
layer or data link layer failure at the remote party, or user
equipment off-line.

Normal

028 Invalid number format (incomplete address) - This cause


indicates that the called party cannot be reached because the
called party number is not in a valid format or is not complete.

Normal

029 Facility rejected - This cause is returned when a supplementary


service requested by the user cannot be provided by the network.

Normal

030 Response to STATUS ENQUIRY This cause value is used to


report a normal clearing event when no other cause in the
normal class applies. The switch may send cause value #31
toward the calling party when the call is cleared by the remote
user or network without cause information and the call did not
reach the active state.

Normal

031 Normal, unspecified - This cause is used to report a normal


event only when no other cause in the normal class applies.

Network
Congestion

034

Telica, Inc.

Cause Value Description

Circuit/channel congestion - This cause indicates that there is no


appropriate circuit/channel presently available to handle the call.

A-3

Release Causes

Issue 1, March 24, 2003

Class

Cause Value Description

Network
Congestion

041

Temporary failure - This cause indicates that the network is not


functioning correctly and that the condition is not likely to last a
long period of time, e.g., the user may wish to try another call
attempt almost immediately.

042 Switching equipment congestion - This cause indicates that the


switching equipment generating this cause is experiencing a
period of high traffic.
Network
Congestion

043

Access information discarded - This cause indicates that the


network could not deliver access information to the remote user
as requested, i.e., user-to-user information, low layer
compatibility, high layer compatibility, or sub-address, as
indicated in the diagnostic. It is noted that the particular type of
access information discarded is optionally included in the
diagnostic.

Network
Congestion

044

Requested channel not available - This cause is returned when


the circuit or channel indicated by the requesting entity cannot
be provided by the other side of the interface.

Network
Congestion

047

Resource unavailable, unspecified - This cause is used to report


a resource unavailable event only when no other cause in the
resource unavailable class applies.

Service or
Option Not
Available

050

Requested facility not subscribed - This cause indicates that the


user has requested a supplementary service that is implemented
by the equipment which generated this cause, but the user is not
authorized to use.

Service or
Option Not
Available

057

Bearer capability not authorized - This cause indicates that the


user has requested a bearer capability which is implemented by
the equipment which generated this cause but the user is not
authorized to use.

A-4

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-900-000

Class

Cause Value Description

Service or
Option Not
Available

058

Bearer capability not presently available - This cause indicates


that the user has requested a bearer capability which is
implemented by the equipment which generated this cause but
which is not available at this time.

Service or
Option Not
Available

063

Service or option not available, unspecified - This cause is used


to report a service or option not available event only when no
other cause in the service or option not available class applies.

Service or
Option Not
Implemented

065

Bearer capability not implemented - This cause indicates that the


equipment sending this cause does not support the bearer
capability requested.

Service or
Option Not
Implemented

069

Requested facility not implemented - This cause indicates that


the equipment sending this cause does not support the requested
supplementary service.

Service or
Option Not
Implemented

079

Service or option not implemented, unspecified This cause is


used to report a service or option not implemented event only
when no other cause in the service or option not implemented
class applies.

Invalid
Message

081

Invalid call reference value This cause value is sent in a


RELease COMplete message when a message other than a
SETUP, RELease COMplete, STATus, or STATus ENQuiry is
received with a call reference value that is currently not in use
on interface. This cause value is sent in a STATus message
when a message other than a RESTart, RESTart ACKnowledge,
or STATus message is received with the global call reference
value.

Invalid
Message

088

Incompatible destination - This cause indicates that the


equipment sending this cause has received a request to establish
a call which has low layer compatibility, high layer
compatibility, attributes (e.g., data rate) which can not be
accommodated.

Telica, Inc.

A-5

Release Causes

Issue 1, March 24, 2003

Class

Cause Value Description

Protocol
Error

096

Mandatory information element missing This cause indicates


that message received is missing the information element
indicated in the diagnostic when that information element must
be present to process that message.

Protocol
Error

097

Message type nonexistent or not implemented - This cause


indicates that the equipment sending this cause has received a
message with a message type it does not recognize either
because this is a message not defined or defined but not
implemented by the equipment sending this cause.

Protocol
Error

099

Information element nonexistent or not implemented - This


cause indicates that the equipment sending this cause has
received a message which includes information
element(s)/parameter(s) not recognized because the information
element identifier(s)/parameter name(s) are not defined or are
defined but not implemented by the equipment sending the
cause. This cause indicates that the information
element(s)/parameter(s) were discarded. However, the
information element is not required to be present in the message
in order for the equipment sending the cause to process the
message.

Protocol
Error

100

Invalid information element contents This cause indicates that


one or more fields of the information element are coded in a way
that has not been implemented by the equipment sending this
cause.

Protocol
Error

101

Message not compatible with call state This cause indicates


that it is not permissible to receive the message in the current
call state.

Protocol
Error

102

Recovery on timer expiry - This cause indicates that a procedure


has been initiated by the expiry of a timer in association with
error handling procedures.

A-6

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-900-000

Class

Cause Value Description

Protocol
Error

111

Protocol error, Unspecified - This cause is used to report a


protocol error event only when no other cause in the protocol
error class applies.
Interworking Class

Interworking

127 Interworking: Unspecified - This cause indicates that there has


been interworking with a network which does not provide
causes for actions it takes. Thus, the precise cause for a message
which is being sent cannot be ascertained.

Table A-B. National Standardized Cause Values


Class

Cause Value Description

Normal

004

Vacant code - The switch sends this cause value when the
destination requested by the calling party cannot be reached
because the Numbering Plan Area (NPA) or Central Office (CO)
code is vacant (i.e., unassigned).

Normal

008

Prefix 0 dialed in error - The switch sends this cause value


when the prefix 0 is invalid for the entered number.

Normal

009

Prefix 1 dialed in error - The switch sends this cause value


when the prefix 1 is invalid for the entered number.

Normal

010

Prefix 1 not dialed - The switch sends this cause value when the
prefix 1 is required for the entered number.

Normal

011

Excessive digits received,call is proceeding - The switch sends


this cause valuewhen it receives more address digits than
expected as part of code interpretation procedures for a call
origination, and the received address information has been
truncated.

Telica, Inc.

A-7

Release Causes

Issue 1, March 24, 2003

Class

Cause Value Description

Normal

026

Misrouted call to a ported number- The switch generates to


indicate that the call was routed to the terminating switch due to
number portability, but the destination requested by the calling
party cannot be reached because the number, although in a valid
format, is not native and currently not assigned at the
terminating switch.

Service or
Option Not
Available

051

Bearer capability incompatible with service request - The


switch sends this cause value to indicate that the request for an
action was rejected because the action was not compatible with
the bearer capability of the call.

Service or
Option Not
Available

053

Service operation violated - The switch sends this cause value to


indicate that the user has violated the service operation.

Protocol
Error

101

Protocol error, threshold exceeded This cause value is used


when the switch clears the call because a threshold is being
exceeded for multiple protocol errors occurring during an active
call.

A-8

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-900-000

Table A-C. Network Specific Cause Values


Class

Cause Value Description

Normal

008

Call is proceeding -

Normal

013

Service denied

Normal

028

Special intercept announcement

Normal

029

Special intercept announcement: undefined code

Normal

030

Special intercept announcement: number unassigned

Normal

031

Special intercept announcement: call blocked due to group


restriction

Invalid
Message

090

Segmentation error

Invalid
Message

091

Reassembly error

Protocol
Error

101

Protocol error, threshold exceeded This cause value is used


when the switch clears the call because a threshold is being
exceeded for multiple protocol errors occurring during an active
call.

Telica, Inc.

A-9

Release Causes

Issue 1, March 24, 2003

Table A-D. Other Cause Values


Class

A-10

Cause Value Description

000

Invalid cause value proprietary

004

Send special information tone

005

Misdialed trunk prefix

008

Preemption This cause indicates that the call is being


preempted.

009

Preemption circuit reserved for reuse This cause indicates


that the call is being preempted and the circuit is reserved for
reuse by the preempting exchange.

010

UNI 3.0: VPCI/VCI unacceptable

020

Subscriber absent - This cause value is used when a mobile


station has logged off, radio contact is not obtained with a
mobile station or if a personal telecommunication user is
temporarily not addressable at any user-network interface.

023

Redirect to new destination - This cause is sued by a general


ISUP protocol mechanism that can be invoked by an exchange
that decides that the call should be set up to a different called
number. Such an exchange can invoke a redirect mechanism, by
use of this cause value, to request a preceding exchange
involved in the call to route the call to the new number.

032

PNNI: too many pending add party requests

035

Requested Virtual Path Connection Identifier (VPCI)/VCI not


available

036

VPCI/VCI assignment failure

037

User cell rate unavailable


Telica, Inc.

Billing and Traffic Collection Guide

Class

Telica, Inc.

Section 150-900-000

Cause Value Description

038

Network out of order - This cause indicates that the network is


not functioning correctly and that the condition is likely to last a
relatively long period of time, e.g., immediately re-attempting
the call is not likely to be successful.

039

Permanent frame mode connection out of service

040

Permanent frame mode connection operational

045

No VPCI/VCI available

046

Precedence call blocked - This cause indicates that there are no


preemptable circuits or that the called user is busy with a call of
equal or higher preemptable level.

049

Quality of service unavailable

051

UNI 3.0: user cell rate unavailable

053

Outgoing calls barred within Closed User Group (CUG) -

055

Incoming calls barred within CUG

062

Inconsistency in designated outgoing access information and


subscriber class - This cause indicates that there is an
inconsistency in the designated outgoing access information and
subscriber class.

066

Channel type not implemented

070

Only restricted digital information bearer capability is available


- This cause indicates that the calling party has requested an
unrestricted bearer service but that the equipment sending this
cause only supports the restricted version of the requested bearer
capability.

A-11

Release Causes

Class

A-12

Issue 1, March 24, 2003

Cause Value Description

073

Unsupported combination of traffic parameters

078

ATM Adaption Layer (AAL) parameter cannot be supported

082

Identified channel does not exist

083

A suspended call exists, but this call identity does not

084

Call identity in use

085

No call suspended

086

Call having the requested call identity has been cleared

087

User not member of CUG

089

Invalid end point reference

090

Non-existent CUG

091

Invalid transit network selection - This cause indicates that a


transit network identification was received which is of an
incorrect format as defined in Annex C of T1.607.

092

Too many pending add party requests

095

Invalid message, unspecified - This cause is used to report an


invalid message event only when no other cause in the invalid
message class applies. Protocol Error (e.g. Unknown Message)
Class.

098

Message not compatible with call state or message type nonexistent or not implemented

Telica, Inc.

Billing and Traffic Collection Guide

Class

Telica, Inc.

Section 150-900-000

Cause Value Description

103

Parameter non-existent or not implemented, passed on - This


cause indicates that the equipment sending this cause has
received a message which includes parameters not recognized
because the parameters are not defined or are defined but not
implemented by the equipment sending the cause. The cause
indicates that the parameter(s) were ignored. In addition, if the
equipment sending this cause is an intermediate point, then this
cause indicates that the parameter(s) were passed on unchanged.

104

Incorrect message length

110

Message with unrecognized parameter, discarded - This cause


indicates that the equipment sending this cause has discarded a
received message that includes a parameter that is not
recognized.

128

next node unreachable

160

DTL Transit not my node ID

A-13

Release Causes

Issue 1, March 24, 2003

NOTES:

A-14

Telica, Inc.

Billing and Traffic Collection Guide

Section 150-900-900

Index
8
800 call, 6-15

A
ABN, 6-34
ABS, 2-1, 4-2, 6-2
edit configuration, 9-13
installation, 9-7
provisioning, 9-7
upgrade, 9-17
ABS conversion process, 2-3
abs.conf, 2-3, 2-5, 2-7
abs.conn, 2-7
abs.log, 2-7
abs.log_old, 2-7
Advanced Intelligent Network. See AIN
AFR, 6-67, 7-14
AIN, 6-34, 6-44, 6-45, 6-46
AIN call, 6-66
Alternate billing number, 6-34, 6-66, 713
AMA, 1-1, 1-2, 1-4, 3-1, 6-10, 6-12, 619, 6-31
AMA files, 7-2
AMA Lite
conversion process, 3-3
create and read file, 9-37, 9-47
edit configuration, 9-27
installation, 9-21
provisioning, 9-21
transfer, 3-3
upgrade, 9-31
AMA master record, 7-4
AMA record format, 5-4
AMA test tapes, 6-12
ama.conf, 3-4, 3-6, 3-8, 7-4
AMADNS, 1-1, 1-2, 1-4
AMA-format, 3-3
ANI/CPN, 6-61, 7-8
indicator, 6-27, 6-33

Telica, Inc.

Answer to Seizure Ratio. See ASR. See


ASR
Architecture, 1-2
Archive, 2-5, 3-6
ArchiveDays, 5-13, 5-25
ArchiveInterval, 5-13
ArchivePath, 5-13
ArchivePrefix, 5-14
ArchivePurge, 5-14
ASCII, 6-2
format, 2-2
master record, 6-3, 6-4
record format, 2-1, 6-2
text, 6-4
ASCII Billing Server. See ABS
ASCII CDR Report, 4-10, 5-30, 8-22
ASCII output, 5-4
ASCII Push parameters, 5-25
ASCII/BAF parameters, 5-22
ASCIIDir, 5-22
ASCIIEnabled, 5-21
ASCIIPush, 5-21
ASR, 4-9, 5-28
granularity, 4-11, 5-31
Authorization code, 6-40
Authorization Codes, 6-67, 7-14
Automatic Flexible Routing. See AFR
Automatic Message Accounting. See
AMA

B
BAF, 1-2, 3-1, 6-2, 6-12, 6-65, 7-2, 7-12,
7-17
BAF Push parameters, 5-25
BAFDir, 5-23
BAFEnabled, 5-21
BAFPush, 5-22
Bellcore AMA Format, 1-2
Billing and Traffic System. See BTS
Billing Automatic Message Accounting
Format. See BAF
Billing entity, 5-14

Index-1

Index
Billing output, 5-21
Billing studies, 6-14
Bindip, 5-12
Blocking, 4-7, 5-28
BTS, 5-2, 5-3, 5-4, 6-2
installation, 9-87
provisioning, 9-87, 9-71
upgrading, 9-71
BTS provisioning, 5-6
Business customer ID, 6-33, 6-65
Business customer identification, 7-12
Busy Call Hour, 8-2
Busy hour, 4-1, 4-6, 5-26, 8-1, 8-3
granularity, 4-11, 5-30
information, 8-4
report, 8-3

C
CAC, 6-26
Calculate peg count, 4-10, 5-30
Call control, 4-3
Call Count - Information
Anonymous/Unavailable field, 6-44
Call Count - Information Delivered field,
6-44
Call Detail Records. See CDR
Call ID, 6-52
Call identifier, 5-18
Call type, 6-2, 6-9, 6-10, 6-11, 7-19
Call types, 7-2
Called number
prefix, 6-54
Called party off-hook indicator, 6-15
CalledPrefixModuleCntxt, 5-20
CallIdModuleGen, 5-18
Calling Name Delivery. See CNAM
Calling Number Delivery. See CND
Calling Party Number. See CPN
Carrier, 8-27
Carrier access - originating, 6-61
Carrier Access Code. See CAC
Carrier access date, 6-31
Carrier connect date, 6-19
Carrier connect time, 6-20, 6-32
Carrier connection, 8-24
Telica, Inc.

Issue 3, January 9, 2004


Carrier duration, 8-24
Carrier elapsed time, 6-20, 6-32
Carrier Identification Code. See CIC
CAS, 4-2, 8-3, 8-5, 8-23
CAS trunk group, 8-23
CAS Trunk group CCS report, 4-9, 5-29
CCS, 4-1, 4-2, 4-6, 4-13, 5-26, 5-32, 8-1,
8-2, 8-11, 8-13, 8-14, 8-15, 8-16, 818, 8-19, 8-20, 8-22
incoming, 8-19, 8-21
outgoing, 8-19, 8-21
CCS granularity, 4-11, 5-31
CDAR, 6-41
CDR, 1-1, 1-2, 1-3, 1-4, 2-1, 2-2, 2-7, 31, 3-3, 3-4, 3-8, 4-1, 4-2, 4-4, 4-6, 5-2,
5-4, 5-26, 6-2, 6-3, 7-2, 7-17, 8-1, 8-2
CDR report, 8-3
Centum Call Seconds. See CCS. See
CCS
CIC, 6-19, 6-26, 6-31, 8-23, 8-24
Circuit date, 6-33
Circuit release, 6-65
Circuit time, 6-33
Circular buffer, 1-3, 2-2, 3-2, 4-3, 6-2,
7-2
CLASS
feature code, 6-40, 6-42
feature status, 6-43
functions, 6-43
Client, 2-6, 3-7, 4-5, 4-6
CNAM, 6-40
CND, 6-40
Comma-delimited, 2-1, 4-2, 6-4, 8-12,
8-16
Commented lines, 5-6
Completion indicator, 6-28
Connect date, 6-12
Connect time, 6-19
Connection control block, 2-7, 3-8
Connection date, 8-25
Connection time, 8-25
Context ID, 6-34
Conversation duration, 8-25
Count of name only, 6-40
Count of Name-Only, 6-66, 7-13

Index-2

Billing and Traffic Collection Guide


Count of number-only, 6-40
Count of Number-Only, 6-66, 7-13
Country code, 6-37, 6-46, 6-47, 6-48,
6-49, 8-25
CPN, 6-36
Customer-Dialed Account Recording.
See CDAR

D
Data capabilities Indicator, 6-30
Data Collector, 5-2, 5-4
Data directory, 2-5, 3-5, 5-22, 5-23, 5-24
Data Network Identification Code. See
DNIC
Data Processing and Management
System, 1-2, 1-4
Deactivation date, 6-43
Deactivation time, 6-44
DebugBindip, 5-12
DebugPort, 5-12
DestinationDir, 5-25
Detailed peg count report, 4-10, 5-30
Dialed digits, 6-53
Dialed NPA field, 6-27
Dialed number, 6-27
DialedDigitsModuleGen, 5-17
DialedPrefixCntxt, 5-20
Dialing and presubscription indicator,
6-26, 6-32
Digits 1 field, 6-53
Digits field, 6-35, 6-45, 6-46, 6-55
Digits identifier, 6-34, 6-44, 6-45, 6-46,
6-55
Digits module, 6-66
Directory
input, 4-7, 5-26, 5-28
log, 4-7, 5-28
output, 4-7, 5-28
Directory assistance AMA, 5-16
Directory number, 6-27, 8-5
Disabling ports, 9-41
DNIC, 6-37, 6-46, 6-47, 6-48, 6-49, 7-18
DNS lookup, 2-6
DPMS, 1-2, 1-4
DR CW, 6-44
Telica, Inc.

Section 150-900-900
DRCW, 6-43

E
E.164, 6-37
E.164 numbering plan, 6-71, 7-17
Elapsed time, 6-19
Element Management System. See EMS.
See EMS
EMS, 1-2, 4-2, 4-12, 5-32
Erlang B, 4-7, 4-13, 4-14, 5-28, 5-33,
5-34, 8-2, 8-3
Excel, 2-1, 6-2

F
Failover, 2-2, 2-7, 3-2, 4-2
Failsover, 1-3
Feature Group D. See FGD
FGD, 6-26
File naming convention, 2-7, 3-8
FileInterval, 5-23
Final switch, 6-38
FinalTrunkModuleCntxt, 5-19
FinalTrunkModuleGen, 5-19
Formatter mode, 2-5, 3-6
FraudAMAGen, 5-16
FraudCallType, 5-16
Frequency, 2-5, 3-5, 5-23, 6-4

G
GDI protocol, 5-4
GDI Receiver, 5-2
GDI transmitter, 5-2
GDIDir, 5-24
GDIHost, 5-13
gdiMiniInWhole, 5-24
gdiMiniRecs, 5-24
GDIport, 5-13
gdiPsRaoHost, 5-24
gdiRecordSize, 5-24
Generating system, 1-3
GMT, 2-1, 2-6, 3-1, 3-7, 5-1, 6-1, 7-1
GR303, 8-23
Granularity

Index-3

Index
ASR, 4-11, 5-31
busy hour, 4-11, 5-30
CCS, 4-11, 5-31
hold time, 4-11, 5-31
peg count, 4-11, 5-31
GUBB, 6-39

H
Hold, 4-9, 5-28, 5-29
Hold time, 4-1, 4-2, 4-9, 4-13, 5-28,
5-32, 8-1, 8-2, 8-3, 8-10, 8-11
Hold time format, 4-9, 5-28
Hold time report, 4-2, 8-10
Host, 5-25

I
IAM, 6-19, 6-20, 6-31, 6-32, 6-34
IC/INC, 6-19, 6-25, 6-26, 6-61, 7-8
IC/INC call event status, 6-20, 6-32
IC/INC prefix, 6-31
IC/INC routing indicator, 6-25
Incoming CCS, 8-14
Incoming routing indicator, 6-35
Information transfer, 3-9
Information transfer rate indicator, 6-30
Initial Address Message. See IAM
Input directory, 4-7, 5-26, 5-28
Inter-exchange Carrier/International
Carrier Identification. See IC.INC
Interface group CCS report, 4-9, 4-10,
5-29, 5-30
Interface ID, 8-23, 8-24
Interface number, 8-18
International Call, 6-18
International Indicator, 8-25
IntraLATA, 5-16
IntraLATAAMAGen, 5-16
IP address, 2-6, 2-8
ISDN, 8-3, 8-23
ISDN interface, 8-5, 8-23

K
Key Pulse. See KP

Telica, Inc.

Issue 3, January 9, 2004


KP, 6-26

L
LATA, 6-30, 6-61, 7-8
Leading zeros, 2-1, 6-2
LEC, 6-26, 6-31
LNP, 6-15, 6-39, 6-69, 7-16
Local Access and Transport Area. See
LATA
Local Exchange Carrier. See LEC
Local Number Portability. See LNP
Local Service Provider Identification.
See LSPI
Local Service Provider Identification
Switch Owner. See LSPI-SO
Location, 6-39
Location component, 6-52
Location Routing Number. See LRN
Location type, 6-38, 6-51
LogFilename, 5-12
LogPath, 5-12, 5-26
Long call duration, 4-3
Long duration connection, 6-61, 7-9
LRN, 6-38, 6-52, 6-69, 7-16
LSPI, 6-35, 6-36
LSPI-SO, 6-35

M
Main entity configuration, 5-11
Maintenance trunks, 8-13, 8-17
Master record, 6-9, 6-60
fields, 7-6
MaxFileCount, 5-12
MaxFileSize, 5-12
MaxLogQueue, 5-11
MBI, 6-28
MDR, 6-40, 6-67, 6-68, 7-14, 7-15
customer ID context field, 6-41
customer ID field, 6-41
Message Billing Index. See MBI
Message Recording Detail. See MDR
Module, 6-2
Module 021, 6-61, 7-8
Module 022, 6-61, 7-9

Index-4

Billing and Traffic Collection Guide


Module 025, 6-65, 7-12
Module 027, 6-65, 7-12
Module 029, 6-66, 7-13
module 040, 7-13
Module 040, 6-66
Module 049, 6-66, 7-13
Module 101, 6-67, 7-14
Module 102, 6-67, 7-14
Module 103, 6-67, 7-14
Module 104, 5-17, 6-68, 7-15
Module 105, 6-68, 7-15
Module 164, 6-37, 6-68, 6-69, 7-15,
7-16, 7-18
Module 198, 6-68, 7-15
Module 264, 6-68, 7-15
Module 306, 6-68, 7-15
Module 40, 6-35, 6-55
Module 611, 6-68, 7-15
Module 612, 6-69, 7-16
Module 613, 6-69, 7-16
Module 616, 6-69, 7-16
Module 719, 6-69, 7-16
Module 720, 6-39, 6-69
Module 88, 6-67, 7-14
Module inclusion rules, 6-60, 7-8
Modules, 7-2

N
Naming convention, 2-7
NANP, 6-18
Network Terminal Number. See NTN
North American Numbering Plan. See
NANP
NPA, 6-17, 6-27
NPA-NXX, 6-38
NTN, 6-37, 7-18
Number
field, 6-37, 6-46, 6-47, 6-48, 6-49
identity, 6-36, 6-46, 6-47, 6-49
plan indicator, 6-37, 6-46, 6-47, 6-48,
6-49
Numbering Plan Area. See NPA
NXX, 6-17

Telica, Inc.

Section 150-900-900

O
Off Hook, 8-24
OfficeID, 2-7, 3-7
OLIP, 6-49, 6-68, 7-15
Operator action indicator, 6-16
Orig physical, 6-50
Originating
FAC type, 6-41
NPA, 6-16, 6-18
number, 6-16
number field, 6-18
Originating Line Information Parameter.
See OLIP
OrigNumberModuleGen, 5-16
OrigPktRsrcModuleCntxt, 5-19
OrigTDMRsrcModuleCntxt, 5-19
Outgoing
routing indicator, 6-36
TGMN, 6-36
TGN, 6-36
Outgoing CCS, 8-14, 8-18, 8-19
Outgoing Trunk Group Member
Number, 6-36
OutpulseDigitsModuleGen, 5-17
Output directory, 4-7, 5-28, 8-2
Overflow count, 8-13, 8-15, 8-17, 8-20
Overseas indicator, 6-18

P
Party identifier field, 6-38, 6-51
Passive, 5-25
Password, 5-25
PDN, 7-18
Peg count
directory number, 4-10, 5-30
Peg counts, 4-1, 4-2, 4-6, 4-13, 5-26,
5-32, 8-1, 8-2, 8-3, 8-5, 8-6, 8-10,
8-14, 8-27
granularity, 4-11, 5-31
incoming, 8-13, 8-14, 8-15, 8-16,
8-17, 8-18, 8-19, 8-20, 8-21, 8-22
outgoing, 8-13, 8-14, 8-15, 8-16, 8-17,
8-18, 8-19, 8-20, 8-21, 8-22
report, 4-8, 5-28

Index-5

Index
Physical Port, 8-26
PhysicalModuleCntxt, 5-20
PhysicalModuleGen, 5-20
PktRsrcModuleGen, 5-19
plexusDc.ini, 5-6
PlexView Pro Billing System, 1-2
PlexView Pro parameters, 5-23
PlexView ASCII Billing Server, 1-1
PlexView Pro Billing System, 1-1
Port 1983, 2-3, 3-4
Precut trunks, 8-13, 8-17
Prefix, 2-6, 3-7, 3-8, 4-6, 4-7, 5-12, 5-27
called number, 6-54
Prefix digits
called number, 6-54
prefix.log, 3-2, 3-9
prefix.log file, 2-2
prefix.old, 3-8
prefix_conn.info, 3-8
PrefixModuleGen, 5-20
Present date, 6-33
Present time, 6-33
Private Virtual Network. See
Pro Billing, 5-5
ProBillingEnabled, 5-22
Procedures, 1-2
PurgeNull, 5-23
PURGENULLDATA True field, 3-6, 523
PVN, 6-65, 6-66, 7-12

Q
QosModuleGen field, 5-18

R
RAO, 6-12, 6-28, 6-29
Receiver Entity, 5-13
RecOfficeID, 5-16
Record length, 6-2
Record sequence number, 6-54
Record transfer, 2-2
Record types, 8-4
Recording office, 6-12
identification, 6-12

Telica, Inc.

Issue 3, January 9, 2004


type, 6-12
Recording office type, 5-15
Redundancy, 2-7
REL, 6-20
Release, 8-24
cause, 8-24
date, 8-25
time, 8-25
Release Message. See REL
ReleaseCauseModuleGen, 5-18
Report
ASCII CDR, 8-22
traffic CCS, 8-11
trunk group hold time, 8-10
Report format
ASCII CDR, 4-10, 5-30
CAS Trunk group, 4-9, 5-29
detailed peg count, 4-10, 5-30
hold time, 4-9, 5-28
interface group CAS, 4-10, 5-30
interface group CCS, 4-9, 4-10, 5-29,
5-30
trunk group CCS, 4-9, 5-29
Resynchronization, 2-8
Revenue Accounting Office. See RAO
Routing indicator, 6-32

S
S99PLXStats, 4-3, 4-6, 5-3, 5-26
Saving ASCII files, 6-4
SCF, 6-43
SCF SCA, 6-44
SCP, 6-39
SCR, 6-43
Screening list size, 6-44
Sensor ID, 5-15
Sensor identification, 6-11
Sensor type, 5-15
SensorID, 2-7, 3-7
SeqNumModuleGen, 5-18
Sequence number, 1-3, 2-8, 6-2
Server port, 2-5, 3-5
Server requirements, 3-2
Service feature, 6-16
Service logic identification, 6-29
Index-6

Billing and Traffic Collection Guide


Service observed/traffic sampled
indicator, 6-15
Service provider identity, 6-39, 6-52
Significant digits, 6-35, 6-37, 6-38, 6-45,
6-46, 6-47, 6-48, 6-49, 6-50, 6-52,
6-53, 6-54, 6-55, 6-56, 6-57, 6-58
SIP, 8-3, 8-5, 8-23
SIP call ID, 6-53
SIP trunk group, 8-23
report, 4-10, 5-29
SipCallIdModuleGen, 5-17
SS7, 4-2, 8-3, 8-5, 8-23
SS7 trunk group, 8-23
Standby connection, 2-2
Station number, 6-18
Statistical data, 4-1, 8-1
Statistical information, 2-2
Statistics Entity, 5-25
Statistics retrieval process, 4-4
Storage duration, 4-12, 5-31, 5-32
Structure 0110, 6-40
Structure code, 6-2, 6-10, 6-11, 7-2
Structure Code 0220, 6-66, 7-13
Structure Code 0221, 6-66, 7-13
Study indicator, 6-14
Sun server, 2-1
Sun Solaris, 1-2
Supporting information field, 6-39, 6-52
SwitchName, 5-6

T
TCA, 4-2, 4-3, 4-14, 5-5, 8-29
edit configuration, 9-67
installation, 9-51
provisioning, 9-51
upgrade, 9-71
TCP/IP, 5-4
TDMRsrcModuleGen, 5-19
TdsPath, 5-26
Telica Statistical Analysis Application.
See TSAA. See TSAA
Telica Statistical Data Server. See TSDS.
See TSDS
TelicaStatsSrvr, 4-3, 4-4, 4-6
Term physical, 6-51
Telica, Inc.

Section 150-900-900
Terminating
company, 6-31
FAC type, 6-42
NPA, 6-18
number, 6-18
TermNumberModuleGen, 5-17
TermPktRsrcModuleCntxt, 5-19
TermTDMRsrcModuleCntxt, 5-19
TGN, 6-24, 6-32, 6-35
Time period, 2-1
Time zone, 2-6, 3-7
Timezone, 5-12
Timing indicator, 6-13
Total CCS, 8-14, 8-18, 8-19, 8-21
Total circuits, 8-18
Total peg count, 8-17, 8-19, 8-21
Traffic CCS, 8-3
Traffic CCS Report, 8-11
Traffic Collection, 5-2
Traffic Collection Application, 4-1, 8-1
Traffic statistics, 5-5
Treatment ModuleCntxt, 5-20
TreatmentModuleGen, 5-20
Trkgrp CCS report, 4-9, 5-29
Trunk group
CAS, 8-3, 8-5
SIP, 8-3, 8-5
SS7, 8-3, 8-5
Trunk group name, 8-17
Trunk Group Name, 8-25
Trunk group number, 6-24, 6-38, 8-14,
8-17, 8-19, 8-21
Trunk identification, 6-68
Trunk member number, 6-35, 6-38
TrunkIdModuleGen, 5-17
Trunks available, 8-17
Trunks configured, 8-17
TSAA, 4-1, 4-3, 4-6, 4-13, 5-26, 5-32,
8-1
tsaa.conf, 4-3, 4-7, 5-6
tsaa_<pid>.log, 4-13, 5-32
TSDS, 4-1, 4-4, 4-5, 4-6, 5-26, 8-1
tsds.conf, 4-5, 4-6
tsds.conn, 4-4
tsds.log, 4-4

Index-7

Index
TypeOf740If, 5-26

U
Usage count, 6-31
User, 5-25

W
WATS, 6-28
administration field, 6-28

Telica, Inc.

Issue 3, January 9, 2004


band, 6-28
indicator, 6-28
Wide Area Telecommunications Service.
See WATS

X
X.121, 6-37
X.121 Numbering Plan, 6-72, 7-18

Index-8

Вам также может понравиться