Beruflich Dokumente
Kultur Dokumente
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.
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.
Trademarks
All trademarks and service marks specified herein are owned by their respective companies.
Ordering information
Support
Technical support
Please contact your Lucent Technologies Local Customer Support Team (LCS) for technical questions about the information in this document.
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.
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.
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) 150-500-100 Issue 2, May 13, 2003
Procedures Checklist 150-500-200 Issue 4, Jan. 9, 2004
Provisioning Task Index List 150-500-300 Issue 2, Jan. 9, 2004
Detailed Level Procedures 150-500-400
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
9. TOP Procedures...............................................................................9-1
9.1 Task Oriented Practices (TOPS) ..............................................................9-1
9.2 Procedures Checklist ................................................................................9-3
9.3 Provisioning Task Index List ...................................................................9-5
Telica, Inc ii
List of Figures
Figure 1-1. AMADNS Architecture................................................................................1-2
Figure 1-2. PlexView AMA Billing................................................................................1-3
Figure 2-1. PlexView ASCII Billing Conversion Details ...............................................2-3
Figure 3-1. PlexView AMA Billing Conversion Details ................................................3-3
Figure 4-1. PlexView TCA Statistics Retrieval Process .................................................4-4
Figure 5-1. The Plexus and the Billing and Traffic System............................................5-4
Figure 5-2. Traffic Collection Application .....................................................................5-5
Figure 6-1. Long Duration Call Sample........................................................................6-63
Figure 7-1. Long Duration Call Sample........................................................................7-10
Figure 9-1. 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
Telica, Inc iv
Billing and Traffic Collection Guide Section 150-100-000
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.
v 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.
Table A. Documentation
Part Manual Title Description
Number
79-6002 Plexus 9000 Installation and Contains Plexus 9000 installation and
Operations Manual provisioning procedures.
79-6003 Plexus 9000 TL1 Commands Provides a listing and description of all
Reference Guide the TL1 commands needed to provision
the Plexus 9000.
79-6004 Plexus 9000 Planning and Provides information regarding the items
Engineering Guide 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.
79-6005 Plexus 9000 Core Consists of the Installation and
Documentation Set Operations Manual (79-6002); the TL1
Commands Reference Guide (79-6003);
and the Planning and Engineering Guide
(79-6004).
79-6006 Plexus 9000 Install and TL1 Consists of the Installation and
Documentation Set Operations Manual (79-6002) and the
TL1 Commands Reference Guide
(79-6003).
79-6007 Plexus 9000 Customer Contains the manuals and release notes
Documentation CD-ROM of the core documentation set in Adobe
Acrobat PDF format.
Telica, Inc vi
Billing and Traffic Collection Guide Section 150-100-000
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.
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.
Convention Indicates
Courier new Command syntax
Italics Book titles, new terms, file names, emphasized
text
Angle brackets < > Parameter delimiters
Square brackes [ ] Optional parameters
ix Telica, Inc
Introduction Issue 2, May 13, 2003
NOTES:
Telica, Inc x
1. PlexView Pro Billing System
1.1 Scope ....................................................................................................................1-1
1.2 Overview ..............................................................................................................1-1
1.3 PlexView Pro Billing System Requirements .......................................................1-2
1.4 Automatic Message Accounting Data Networking System................................. 1-2
1.5 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
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
Sun
Work
Station
Active
Data Processing Billing
PlexView Billing and Management
Standby Module Application
System
Sun Server
Circular
Buffer
Memory Switch Data
Collection DDI_Client
Interface
ry
y
ar
ma
nd
Pri
co
Se
P345-AA
01-08-01 Formatter File
Interface Storage
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.
Signaling
Process
GDI (CDRs)
TCP/IP
Active
PlexView
Standby ASCII Billing
Call Module
Detail
Records
Sun Server
TM
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.
# 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
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.
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.
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 server’s 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.
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.
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.
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.2 Features
The AMA Lite application offers these features:
• 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.
Refer to Figure 3-1 for an illustrated example of the AMA Lite conversion
process.
Signaling
Process
GDI (CDRs)
TCP/IP
Active
PlexView
Standby AMA Lite
Call Application
Detail
Records
Sun Server
TM
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.
# 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.
#
# 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)
#
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.
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.
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.
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.
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 server’s 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.
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.
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.
NOTES:
4.1 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.
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.
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:
See Figure 4-1 for an illustrated example of the statistics retrieval process.
Signaling
Process
Active
PlexView Traffic
Standby Traffic Mgmt Data Collector Capacity
Module and Eng
Call
Records App
TM Sun Server
Circular
Buffer Track Daily
Busy Hour Files FTP
X# of Statistics
Records Memory
(Configurable)
Track
Switch Call
Interface Daily
Statistics Files
Virtual (Receives (Peg Count)
N groups of CDRs) P506-AA
X# of above Memory 12-10-01
records (Disk)
(Configurable)
Track
Traffic (CCS) Hourly
Statistics Files
Track Trunk
Group Hold- Daily
Time Output Files
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:
• 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.
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.
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.
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.
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.
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.
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.
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
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.
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.
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.
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 Features
The PlexView Billing and Traffic System offers these features.
• 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).
Refer to Figure 5-1 for an illustration of the Plexus and the Billing and
Traffic System.
ASCII ASCII
Billing Files
AMA AMA
Lite Lite
CDRs Files
TCP/IP
Data Traffic
Active Traffic
Collector/ Statistics Collection
GDI Receiver App
Standby
NetMinder NetMinder
NTM NTM
TM (Future) 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.
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.
Track Call
Statistics
Files
(Peg Counts)
Traffic
DATs
Statistics
Track
Busy Hour Daily
Statistics Files
TSAA
ASCII Files
Data/
Conf
PlexView
FTP
Track EMS
Traffic (CCS) Files
Statistics
Track
Raw
Avg Trunk Files
CDRs
Hold Time
P984-AA
05-01-03
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>.
##############################
#Data Collector MAIN Entity Configuration
##############################
[DataCollectorConfig]
# Prefix= <none> prefix for various output files (ascii, baf, stats)
# MaxLogQueue= 16384 max trace entries allow on queue before dropping
# MaxFileSize= 10485760 max size in bytes of any single trace file
# MaxFileCount= 6 max old trace log files retained
# LogPath= ./logs directory for trace log files
# LogFilename= dcLog base name of trace log files
# DebugPort= <none> telnet debug port into DataCollector
# DebugBindIp= 0.0.0.0 (INADDR_ANY) override BindIp for debug port only.
# BindIp= 0.0.0.0 (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.
# Timezone= <system> 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.
Prefix= SwitchName
##############################
#Receiver Entity Configuration
##############################
[ReceiverConfig]
GdiHost= 1 SPA_address
GdiHost= 2 SPB_address
#################################
# Billing entity configuration
#################################
[BillingConfig]
# 211CallType= 0 Call Types for N11 Calls - Valid values are from
# 311CallType= 0 zero to 999. The value zero disables AMA generation.
# 411CallType= 9
# 511CallType= 0
# 611CallType= 0
# 711CallType= 0
# 811CallType= 0
# 911CallType= 0
# Output Options
# --------------
# Time BAF and ASCII output files are open for writing (minutes)
FileInterval= 120
# 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]
#gdiPsRaoHost= localhost
#################################
# AsciiPush entity configuration
#################################
# Configure FTP push of ASCII billing files to remote server
[AsciiPush]
#################################
# BafPush entity configuration
#################################
# Configure FTP push of BAF (AMA Lite) billing files to remote server
[BafPush]
#################################
# Statistics entity configuration
#################################
[StatisticsConfig]
############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.
##############################
#Data Collector MAIN Entity Configuration
##############################
[DataCollectorConfig]
# Prefix= <none> prefix for various output files (ascii, baf, stats)
# MaxLogQueue= 16384 max trace entries allow on queue before dropping
# MaxFileSize= 10485760 max size in bytes of any single trace file
# MaxFileCount= 6 max old trace log files retained
# LogPath= ./logs directory for trace log files
# LogFilename= dcLog base name of trace log files
# DebugPort= <none> telnet debug port into DataCollector
# DebugBindIp= 0.0.0.0 (INADDR_ANY) override BindIp for debug port only.
# BindIp= 0.0.0.0 (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.
# Timezone= <system> 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.
Prefix= 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.
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.
##############################
#Receiver Entity Configuration
##############################
[ReceiverConfig]
GdiHost= 1 SPA_address
GdiHost= 2 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 switch’s
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.
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.
#################################
# Billing entity configuration
#################################
[BillingConfig]
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.
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.
# Output Options
# --------------
# Time BAF and ASCII output files are open for writing (minutes)
FileInterval= 120
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.
# 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]
#gdiPsRaoHost= localhost
#################################
# AsciiPush entity configuration
#################################
# Configure FTP push of ASCII billing files to remote server
[AsciiPush]
#################################
# BafPush entity configuration
#################################
# Configure FTP push of BAF (AMA Lite) billing files to remote server
[BafPush]
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.
#################################
# Statistics entity configuration
#################################
[StatisticsConfig]
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.
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.
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 5.4.4 for a description of Erlang B.
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.
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.
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
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.
5.4.4 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.
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.
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.
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.
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.
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.
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).
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 Telcordia’s 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 Telcordia’s 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.
Call Structure
Type Call Type Name Code Module
142 Local Exchange Carrier (LEC) Number 0364 022
Service
159 Message Detail Recording (MDR) Data 0001, 0079, 102, 103, 105
0500
264 Calling Identity Delivery Record 0110
330 CLASS Feature 110, 1030 49
710 Originating Toll AMA Recording (Vendor 0625 022, 104, 164
Specific)
720 Connecting Network Access Incoming 0625 022, 104, 164, 720
Record
721 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.
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.
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.
8. Timing Indicator
The Timing Indicator is a five-digit numeric field. Valid values are:
Chars Meaning
digit 1 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
9. Study Indicator
Study Indicator is a seven-character numeric field. This field is used in
conjunction with billing studies.
Chars Meaning
digit 1 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
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”.
The Originating Number field together with the Originating NPA field
may be populated with a billing number. Billing numbers are LEC-
assigned 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.
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.
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.
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
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.
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 INC’s code is recorded.
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.
Refer to section 6.5, Module Number 164 for a more detailed description
of this module.
Refer to section 6.5, Module Number 164, for a more detailed description
of this module.
Refer to section 6.5, Module Number 164 for a more detailed description
of this module.
Refer to section 6.5, Module Number 164 for a more detailed description
of this module.
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:
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.
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 NPA-
NXX
Characters 7-12 = 0
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
00 UNKNOWN
01 DS1 (89-0360)
02 DS3 (89-0365)
03
04 Octal DS3 (89-0382)
05 Octal DS3 (89-0398)
06 ATM DS3 (89-0409)
07 Octal DS3
08 ENA (89-0390)
09 Voice Server (VOP8) (89-0388)
10 Voice Server (VOP6) (89-0395)
11 OC12
12 VOIP
13 STS DS3
14 STS or DS3
15 PNA (89-0393)
16
17
18 Triple DS3 (410)
19 Octal DS3 (411)
Note that only TDM board types are supported. For non-TDM boards
only TTCCSS are populated. The remaining fields are zero.
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.”
The “C” indicates the Cause Category and the values can be:
0 = International Telecommunications Union (ITU) standard
2 = National
3 = Network specific
The second significant digit is indicated with “N” for the NLP (Non-
Linear 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.
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
12 = Clear Mode
99 = Unknown
Module Description
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)
G1 G2 G3 Gk
Cell
Connect Disconnect
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.
This module is not used with carrier access calls, nor should it be used
with Operator Services System (OSS) calls.
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.
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.
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.
CC= Country Code – Identifies the destination country and can vary
between 1 and 3 digits.
CDR
Orig A B C D E
Term B C D E F
Module 164 A A A A
Module 164 B C D
Module 164 B B
Module 164
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.
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:
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.
7.1 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.
The AMA Lite billing and BTS applications follow the AMA record
formatting rules as defined in Telcordia’s 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.
GR-1100
Field Description Table # # of Char.
carrierConnectDate 6 6
carrierConnectTime 18 8
carrierElapsedTime 19 10
icIncCallEventStatus 58 4
trunkGroupNumber 83 6
routingIndicator 59 2
dialingInd 85 2
aniInd 60 2
* * * *MODULE 104* * * *
moduleCode 4
trunkIdentNumber 10
* * * *MODULE 164* * * *
moduleCode 4
numberIdentity 2
countryCodeOrDNIC 6
sigDigitsInNext 4
digits 16
* * * *TERMINATOR MODULE CODE zero * * * *
The master record contains the fields listed in Table 7-E. 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.
GR-1100
Field Description Table # # of Char.
Destination Number [4] 17 8
Elapsed Time 19 10
IC/INC Prefix [3] 57 6
Carrier Connect Date [3] 6 6
Carrier Connect Time [4] 18 8
Carrier Elapsed Time 19 10
IC/INC Call Event Status 58 4
trunkGroupSigTypeInd
Trunk Group Number 83 6
Routing Indicator 59 2
Dialing And Presubscription Indicator 85 2
ANI/CPN Indicator 60 2
Revenue Accounting Office (RAO) Number 46 4
Local Access Transport Area (LATA) 197 4
WATS Indicator 28 2
Wats Band or Message billing Index 29 4
WATS Administration 30 6
Data Capabilities Indicator 41 4
Information Transfer Rate Indicator 42 4
Terminating Company 56 4
Completion Indicator 280 4
Service Logic Identification [5] 77 10
Numbering Plan Area (NPA) 13 4
Directory Number 14 8
Usage count 130 6
Date 6 6
Time 18 8
Class Feature Code 415 4
Call Count -Information delivered 803 6
Call Count -Information Anonymous/Unavailable 803 6
Activating NPA 13 4
Activating Number 14 8
Far-end Overseas indicator 15 2
Far-end NPA 16 6
Far-end Number 17 8
CLASS Functions 330 4
CLASS Feature status 331 4
Screening list size of selective call forwarding or
802 4
selective call acceptance
screening list size of selective call rejection 802 4
screening list size for distinctive ringing/call waiting 802 4
forward to overseas Indicator 15 2
forward to NPA 16 6
forward Number 17 8
activation date 18 8
activation time 18 8
deactivation date 6 6
deactivation time 18 8
Cell
Connect Disconnect
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.
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:
This module is not used with carrier access calls, nor should it be used
with Operator Services System (OSS) calls.
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.
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.
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:
− Module Code
− Number Identify
− Country Code or Data Network Identification Code
− Significant Digits in the Next Field(s)
− Number
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 Network Element (NE) generates Module 164 and appends it to the
BAF structure generated for a call when the following conditions exist:
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:
7-21
Call Types, Modules and Structure Code 0625 (5 pages)
Call Call Type Name Mod. Module Fields and Field Ref. # Structure Code Fields Calling Pattern
Type for Sect. 6 (Based on Call Type)
119 Terminating 021, 021 - Module Code ID, Eight common data fields, Terminating exchange
Access Record 104, IC/INC Prefix, Connect Date (g),
164, Carrier Access Date (tt), Timing Indicator (h),
720 Carrier Access Time (uu), Study Indicator (i),
Elapsed Time (vv), Called Party Off-hook Indicator (j),
IC/INC Call Event Status (ww), Service Observed/Traffic Sampled (k),
Trunk Group Number (xx), Operator Action (l),
Routing Indicator (yy), Service Feature (m),
Dialing and Presubscription Indicator (zz), Originating NPA (n),
ANI/CPN Indicator (aaa) Originating Number (o),
104 – Module Code ID, Overseas (International Call) Indicator (p),
Trunk ID Terminating NPA (q),
164 – Module Code, Terminating Number (r),
Number Identity (rrr), Connect Time (s),
Country Code or Data Network ID Code (ttt), Elapsed Time (t),
Significant Digits in Next Field(s) (uuu), IC/INC Prefix (u),
Number (vvv) Carrier Connect Date (v),
720 – Module Code ID, Carrier Connect Time (w),
Party ID (zzz), IC/INC Call Event Status (y),
Location Routing Number (LRN) (xxx), Trunk Group Number (z),
Service Provider Identity (bbbb), Routing Indicator (aa),
Location (cccc), Dialing and Presubscription Indicator (bb),
Supporting Information (dddd) ANI/CPN Indicator (cc)
7-22
Call Types, Modules and Structure Code 0625 (5 pages)
Call Call Type Name Mod. Module Fields and Field Ref. # Structure Code Fields Calling Pattern
Type for Sect. 6 (Based on Call Type)
710 Originating Toll Eight common data fields,
AMA Recording Connect Date (g),
(Vendor Specific) 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 Call Type Name Mod. Module Fields and Field Ref. # Structure Code Fields Calling Pattern
Type for Sect. 6 (Based on Call Type)
720 Connecting 021, 021 - Module Code ID, Eight common data fields,
Network Access 104, IC/INC Prefix, Connect Date (g),
Incoming Record 164, Carrier Access Date (tt), Timing Indicator (h),
720 Carrier Access Time (uu), Study Indicator (i),
Elapsed Time (vv), Called Party Off-hook Indicator (j),
IC/INC Call Event Status (ww), Service Observed/Traffic Sampled (k),
Trunk Group Number (xx), Operator Action (l),
Routing Indicator (yy), Service Feature (m),
Dialing and Presubscription Indicator (zz), Originating NPA (n),
ANI/CPN Indicator (aaa) Originating Number (o),
104 – Module Code ID, Overseas (International Call) Indicator (p),
Trunk ID Terminating NPA (q),
164 – Module Code, Terminating Number (r),
Number Identity (rrr), Connect Time (s),
Country Code or Data Network ID Code (ttt), Elapsed Time (t),
Significant Digits in Next Field(s) (uuu), IC/INC Prefix (u),
Number (vvv) Carrier Connect Date (v),
720 – Module Code ID, Carrier Connect Time (w),
Party ID (zzz), IC/INC Call Event Status (y),
Location Routing Number (LRN) (xxx), Trunk Group Number (z),
Service Provider Identity (bbbb), Routing Indicator (aa),
Location (cccc), Dialing and Presubscription Indicator (bb),
Supporting Information (dddd) ANI/CPN Indicator (cc)
7-24
Table 7-H. Plexus 9000 AMA Record Mapping to Telcordia GR-1100
# table Structure Code
Field Description
Char. # 0001 0020 0027 0028 0079 0220 0360 0364 0500 0625 0631 0645 0653 0656 0664 9003 0110 1030 0614 0096
Record Descriptor Word 000 X X X X X X X X X X X X X X X X X X X X
Hexadecimal Identifier 2 00 X X X X X X X X X X X X X X X X X X X X
Structure Code 6 0 X X X X X X X X X X X X X X X X X X X X
Call Type Code 4 1 X X X X X X X X X X X X X X X X X X X X
Sensor Type 4 2 X X X X X X X X X X X X X X X X X X X X
Sensor Previous Output Ind
Sensor Identification 8 3 X X X X X X X X X X X X X X X X X X X X
Recording Office Type 4 4 X X X X X X X X X X X X X X X X X X X X
Recording Office Previous
Output Ind
Recording Office Identification 8 5 X X X X X X X X X X X X X X X X X X X X
Connect Date [3] 6 6 X X X X X X X X X X X X X X X X X X X
Connect Time 8 18 X X X X X X X X X X X X X X X X X X X
Timing Indicator [3] 6 7 X X X X X X X X X X X X X X X X
Study Indicator[7] 8 8 X X X X X X X X X X X X X X X X
Called Party Off-Hook
2 9 X X X X X X X X X X X X X X
Indicator
Service Observed/Traffic
2 10 X X X X X X X X X X X X
Sampled
Operator Action 2 11 X X X X X X X X X X X X X
Service Feature 4 12 X X X X X X X X X X X X X X X X
Originating NPA [2] 4 13 X X X X X X X X X X X
Originating Number [4] 8 14 X X X X X X X X X X X
Dialed NPA [2] 4 13 X X
Dialed Number [4] 8 14 X X
Destination Overseas
2 15 X X X X X X X X X X X
(International Call) Indicator
Destination Number Plan
6 16 X X X X X X X X X X X X X
Area (NPA) [3]
Destination Number [4] 8 17 X X X X X X X X X X X X X
Elapsed Time 10 19 X X X X X X X X X X X X X X X X
IC/INC Prefix [3] 6 57 X X X X X X X
Carrier Connect Date [3] 6 6 X X X X X X
7-25
# table Structure Code
Field Description
Char. # 0001 0020 0027 0028 0079 0220 0360 0364 0500 0625 0631 0645 0653 0656 0664 9003 0110 1030 0614 0096
Carrier Connect Time [4] 8 18 X X X X X X
Carrier Elapsed Time 10 19 X X X X X X
IC/INC Call Event Status 4 58 X X X X X X
trunkGroupSigTypeInd
Trunk Group Number 6 83 X X X X X X X
Routing Indicator 2 59 X X X X X X X
Dialing And Presubscription
2 85 X X X X
Indicator
ANI/CPN Indicator 2 60 X X X X
Revenue Accounting Office
4 46 X X
(RAO) Number
Local Access Transport Area
4 197 X X
(LATA)
WATS Indicator 2 28 X X
Wats Band or Message billing
4 29 X X
Index
WATS Administration 6 30 X X
Data Capabilities Indicator 4 41 X
Information Transfer Rate
4 42 X
Indicator
Terminating Company 4 56 X
Completion Indicator 4 280 X
Service Logic Identification [5] 10 77 X
Numbering Plan Area (NPA) 4 13 X X
Directory Number 8 14 X X
Usage count 6 130 X
Date 6 6 X X
Time 8 18 X X
Class Feature Code 4 415 X X X
Call Count -Information
6 803 X
delivered
Call Count -Information
6 803 X
Anonymous/Unavailable
Activating NPA 4 13 X X X
Activating Number 8 14 X X X
Far-end Overseas indicator 2 15 X
7-27
7-28 Telica, Inc.
8. Traffic Statistics Reports
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.
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.
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:
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
value The record_type’s 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).
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.
The following information is calculated for every record when the non-
detailed output option is chosen:
Fields:
version Specifies the version of the application on the Plexus.
month, day, year, hour, min Describes the start date and time of the five-
minute 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 = SS7 trunk group
4 = CAS trunk group
5 = SIP trunk group
6 = CAS interface
7 = GR303 interface
8 = BICC trunk group
For a description and sample of Trunk Group Hold Time output, refer to
8.2.2.3.2.
A sample of what the output would actually look like is provided below.
Field descriptions follow.
Fields:
version Specifies the version of the application on the
Plexus.
month, day, year, hour, min Describes the date and time of the record.
value Trunkgroup ID.
hold_time The average hold time for the value (in seconds).
Note: All time period criteria used to generate Traffic CCS reports are based
on the Plexus 9000 clock, not the Sun server clock.
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.
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.
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
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
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
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
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
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 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 Release Date: Carrier Release date of the call if the call is
released. If the call is in progress, it’s 00-00-0000.
Carrier Release Time: Carrier Release time of the call if the call is
released. If the call is in progress, it’s 00:00:00.00.
Conversation Connect Date: Conversation Connection date of the call, if
the call is answered. If the call is not answered, it’s 00-00-
0000.
Conversation Connect Time: Conversation Connection time of the call,
if the call is answered. If the call is not answered it’s
00:00:00.00.
Conversation Duration: Total conversation duration of the call if it’s
answered and released, current conversation duration of the
call if it’s in progress (long duration CDRs) in tenths of a
second. If the call is not answered, it’s 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 it’s in progress, it’s 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 it’s in progress, it’s 00:00:00.00.
Incoming Trunk Group Name: “NONAME” if the interface doesn’t
have a name.
Outgoing Trunk Group Name: “NONAME” if the interface doesn’t
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
00 UNKNOWN
01 DS1 (89-0360)
02 DS3 (89-0365)
03
04 Octal DS3 (89-0382)
05 Octal DS3 (89-0398)
06 ATM DS3 (89-0409)
07 Octal DS3
08 ENA (89-0390)
09 Voice Server (VOP8) (89-0388)
10 Voice Server (VOP6) (89-0395)
11 OC12
12 VOIP
13 STS DS3
14 STS or DS3
15 PNA (89-0393)
16
17
18 Triple DS3 (410)
19 Octal DS3 (411)
<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.
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
8.3.2 Configuration
8.3.2.1 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.
8.3.2.2 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.
9. TOP Procedures
9.1 Task Oriented Practices (TOPS)
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.
ISSUE &
DLP TITLE NAME DATE
IXL-001 Provisioning Task Index List 2, 01/09/04
NOTES:
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
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.
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:
• 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 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↵
↵
cd /opt/PlexViewABS↵
Note: In the following steps, the correct version number should be substituted
for x-x-x-x.
↵
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↵
# 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
Step 11. Enter the IP addresses or names of the Client’s 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↵
cd ↵
/etc/rc3.d↵
↵
./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>↵
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.
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↵
↵
ls –l *.txt↵
↵
od –x abs.conn↵
↵
more abs.log↵
Step 29. Do you want to logout of the ABS server at this time?
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↵
# 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
↵
/etc/rc3.d/S99PLXAbs stop↵
Step 35. Start the ABS Server by typing the following:
↵
/etc/rc3.d/S99PLXAbs start↵
↵
ps –e –o pid –o args | grep TelicaAbsSrvr↵
↵
kill XXXX↵
↵
./TelicaAbsSrvr abs.conf↵
Step 39. Logout of the ABS server by typing:
↵
exit↵
NOTES:
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.
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↵
In the following steps, the correct version number should be substituted for x-
x-x-x.
↵
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↵
↵
/etc/rc3.d/S99PLXAbs stop↵
↵
mv Version.txt ..↵
↵
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↵
↵
/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↵
# 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
# 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
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.
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:
• 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 AMA Lite server, create the AMA Lite base directory in
opt/. Do this by typing:
↵
mkdir /opt/PlexViewAMA↵
↵
cd /opt/PlexViewAMA↵
Note: In the following steps, the correct version number should be substituted
for x-x-x-x.
↵
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
# 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.
#
# 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)
#
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 Client’s 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↵
↵
/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.
Step 23. Do you want to logout of the AMA Lite server at this time?
NOTES:
SUMMARY: This procedure provides the steps to edit the configuration files for
AMA Lite.
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↵
# 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)
↵
/etc/rc3.d/S99PLXsAma stop↵
Step 5. Start the AMA Lite Server by typing the following:
↵
/etc/rc3.d/S99PLXsAma start↵
↵
ps –ef | grep TelicaAmaSrvr↵
↵
exit↵
NOTES:
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.
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↵
↵.
cd /opt/PlexViewAMA/upgrade↵