The Tenor CMS generates a Call Detail Record (CDR) at the completion of each
call. The CDR data string contains call information such as call date and time, call
length, calling party, called party, etc. You can capture billing type data, which can
be used to create billing reports.
The last 9600 CDRs generated are stored by the Tenor CMS in a circular buffer.
This means that any number of CDRs over 9600 will overwrite the existing CDRs
– in other words; first in, first out. We advise that you set up a PC or Workstation to
act as a CDR Server responsible for receiving the CDRs as they are generated.
Up to four (4) servers can be set up to collect CDRs from each CMS. The server is
responsible for capturing CDRs by TCP/IP, processing/storing them in permanent
memory, and producing billing records. If the CMS is reset from the Command Line
Interface (CLI) in Monitor Mode, it will retain all CDR Records in the buffer. If the
Tenor is reset in any other manner (power cycle, etc.), any CDRs not collected from
the CMS will be lost when it is reset.
There is a configuration parameter command, CDRFormat, that is used to choose
which of the three (3) possible Call Data Record output formats (Standard,
Extended, or Extended-CMS – see details below) you want sent to your CDR Server
from the Tenor. You can also specify if you would like the CDR Server and the CMS
to go through a Session ID synchronization process upon connection. This is done
by using a unique Session ID number to confirm that neither unit has been reset or
“power cycled,” and that the CMS has delivered all call records to the CDR Server.
The CDR Server Software and Billing Software mentioned are third-party software,
and are not supported by Quintum.
Quintum Tenor CMS CDRPage 1
Establishing a Connection between Tenor CMS and the CDR Server
In order to capture CDRs, a connection between CMS and the CDR server must be
established. Based on configuration, the CMS can either establish a TCP/IP session
with one or both of these CDR servers, or the CDR server can establish a connection
with the CMS. If the latter is the case, where the CDR Server is initiating the
connection, then the CDRServerIPAddr in the CMS should be set to 0.0.0.0.
The following flow diagram illustrates the general transfer of information using
both connection types. More detail is provided in the sections that follow.
Figure 1 CDR Connection Flow
Configure CDR Format
Before attempting to collect CDRs, you should configure the following information.
Through CLI commands under the Prompt Level config-CDRServer-x# (“x” = 1, 2,
3 or 4), you can determine the appropriate output format, and assign CDR Server IP
Address(es), CDR Server Port Number(s), and CDR Server Password information.
Use the following CLI commands: CDRFormat, CDRServerIPAddr, CDRServerPort and CDRPassWord.
Quintum Tenor CMS CDRPage 2
Table 1: CDR CLI Commands
CommandDescription
CDRFormatThis configuration parameter command is used to choose which of the four (4)
possible Call Data Records output formats you would like sent to your CDR
Server, each with or witho ut Sessio n ID functionality (see below).
CDRServerIPAddrIP address of the CDR server (used to establish connection with CDR server).
CDRServerPortThe Application Port number(s) used by the CDR server(s). (Used when the
CMS establishes connection with CDR server.) (Valid values are 9002, 9003,
9004, and 9005)
CDRPassWordPassword to be used by the CDR server(s) to gain permission to access the
CMS.
Syntax for the CDRFormat command is as follows:
config-CDRServer-1# set cdrformat {x}
or
config-CDRServer-2# set cdrformat {x}
Table 2: CDRFormat Parameter Settings
SettingDescription
0Gives the Standard CDR output (See next page for output details)
1Gives the Extended CDR output. (See next page for output details)
3Gives Extended-CMS CDR output. (See next page for output details)
4Gives Extended-CMS+ CDR output. (See next page for output details)
100Same data stream as Selection 0, but adds the Session ID functionality.
101Same data stream as Selection 1, but adds the Session ID functionality.
103Same data stream as Selection 3, but adds the Session ID functionality.
104Same data stream as Selection 4, but adds the Session ID functionality
199Same data stream as Selection 104, but adds the trunk id parameters (if
configured) and the disconnect leg
Quintum Tenor CMS CDRPage 3
Configure CDR Server Connection Information on Tenor CMS
To capture CDR reports on a CDR server (i.e., a PC or workstation you designate to
capture CDR data), you must first configure the IP address and port number of the
CDR server in the Tenor CMS (see CLI commands in previous section). Once these
are configured, the Tenor will be able to establish a TCP/IP session with the server
on its own.
If no IP address is configured on the Tenor CMS through the CLI, the CDR server
can initiate the session. The Tenor CMS uses TCP port numbers 9002, 9003, 9004
and 9005 on its side for the CDR sessions. The CDRServerPort must still be
configured to either 9002, 9003, 9004 or 9005.
Establish Connection between CDR Server and Tenor CMS
Whether the CMS establishes the connection with the CDR server or the CDR
server attempts to establish the connection, there is a limit of 5 attempts to enter the
correct password before the TCP session is terminated. (To configure a password,
see the CLI command CDRPassWord in the previous section).
After the CDR server successfully logs into the CDR port of the CMS, the CDR
server is provided with the IP address and unit name of the CMS. The CDR server
then supplies the sequence number of the last CDR that it has received from the
CMS. If the last CDR number is unknown, the server sends 0 for the sequence
number. After this exchange, the CMS starts delivering new CDRs to the server.
Quintum Tenor CMS CDRPage 4
CDR Output Format
The following is an example of CDR output. Each field in a CDR string is separated
by a comma, and any blank fields are designated by a comma. See below for field
definitions. There are three possible CDR Output Formats, as defined by the
CDRFormat command. This command is also discussed in the CMS CLI Reference
Guide.
Sample CDR Record: Standard Format (CDRFormat set to “0”)
| | | | | | | | | | | | | | | | | | | |
A B C D E F G H I J K L M NOP QR ST
Sample CDR Record: Extended Format (CDRFormat set to “1” or “101”)
Standard Format plus:
14155551000, 1234, 9876543210, 123456789
| | | |
U V W X
Quintum Tenor CMS CDRPage 5
CDR Field Definitions: Standard Format Fields
Table 3: Standard Format Fields - Settings 0 & 100
IDSample SettingField NameDefinition
A1CDR Sequence
Number
B17325551212Called numberThe number called. This will be in international
C15Duration (seconds)This value is in seconds. The value will be 0 if
D20000207062812Call Initiated date/
time
Sequence number. This is a unique number
assigned to identify an individual call (i.e, 1, 2,
3,…). The sequence number starts from 1 and
wraps around at 4,294,967,295. When a Tenor
resets, the sequence number starts from 1 again.
If the system has a problem and loses
connectivity, the CDR server can send the Tenor
the last Call ID that it received. T enor will reply with
all records that contain a Call ID, which is greater
than the one last received.
format except for pass-through calls going from
Line-Side to the Trunk-Side or from Trunk-Side to
the Line-Side.
never connected.
The date and time the call initiated in the format of
yyyymmddhhmmss. The time will be the local time
configured on the Tenor. yyyy (4 digits for year),
mm (2 digits for month), dd (2 digits for day), hh (2
digits for hour), mm (2 digits for minutes), ss (2
digits for seconds).
E21060207062815Call Connected date/
time
F20000207062830Call Disconnected
date/time
G16Disconnect Cause
Code
The date and time the call was actually connected
in the format yyyymmddhhmmss. The time will be
the local time configured on the Tenor. yyyy (4
digits for year), mm (2 digits for month), dd (2
digits for day), hh (2 digits for hour), mm (2 digits
for minutes), ss (2 digits for seconds). This field
will be blank if the call never connected.
The date and time the call disconnected in the
format yyyymmddhhmmss. The time will be the
local time configured on the Tenor. yyyy (4 digits
for year), mm (2 digits for month), dd (2 digits for
day), hh (2 digits for hour), mm (2 digits for
minutes), ss (2 digits for seconds).
The Q.931 cause value assigned if the call is not
connected. Possible common entries are listed in
the Cause Code listbelow. This field will be blank
if the call was connected.
Quintum Tenor CMS CDRPage 6
Table 3: Standard Format Fields - Settings 0 & 100
IDSample SettingField NameDefinition
H208.226.140.57Local IP AddressThe IP address of the Local-side Tenor CMS. The
entry will be in the following format:
xxx.xxx.xxx.xxx.
I192.168.10.64Remote IP AddressThe IP address of the Remote-side Tenor (or other
Gateway). This will be generated only if the call is
VoIP; if the call is circuit based, this field will be
blank. The entry will be in the following format:
xxx.xxx.xxx.xxx.
J4Origination Trunk IdIdentifies the origination trunk ID of the line that
initiated the call. This field will be blank if no trunk
ID is configured. The trunk ID is often configured
with an account code.
K1Call TypeThe type of call. Valid entry: 1 = voice, 2 = fax,
3 = modem, 4 = data.
L1Call Number TypeThe called numbering plan used for the call per
Q.931. Possible common entries are as follows:
1 = Public/E.164, 9 = Private.
M1Incoming Digital
Interface
N1Incoming ChannelIf the call is incoming, this field identifies which
O1Outgoing Digital
Interface
P1Outgoing ChannelIf the call is outgoing, this field identifies which
QnullAuto Switch TimeThis is the date and time the AutoSwitch occurred
If the call is incoming, this field identifies which line
the call came in on. Valid entry: 1 to 8. This field
will be empty if the call is an incoming VoIP call.
channel the call came in on. V alid entry: 1-31. This
field is empty if the call is an incoming VoIP call.
If the call is outgoing, this field identifies which line
the call is going out on. Valid entry: 1 to 8. This
field will be empty if the call is an outgoing VoIP
call.
channel the call went out on. Valid entry: 1-31.
This field will be empty if the call is an outgoing
VoIP call.
(when the call is switched from VoIP to circuit).
The entry will be in the following format:
yyyymmddhhmmss where yyyy (4 digits for year),
mm (2 digits for month), dd (2 digits for day), hh (2
digits for hour), mm (2 digits for minutes), ss (2
digits for seconds). If an AutoSwitch did not occur,
this field will be blank.
Quintum Tenor CMS CDRPage 7
Table 3: Standard Format Fields - Settings 0 & 100
IDSample SettingField NameDefinition
RnullAuto Switch Duratio nThe number of seconds that the AutoSwitch call
was active. Valid entry: time in seconds.
S0Bad IP Quality EventsThe number of bad quality events that occur
during a VoIP call. This number determines the
overall quality of a call.
T0Auto Switch FlagThe terminating side of the AutoSwitch call initially
terminates to the internal Aut oSwitch agent before
the call is actually autoswitched. This termination
generates an extra CDR in addition to the original
call that is autoswitched. This field identifies a call
that is terminated to the AutoSwitch agent. 0 =
normal call, 1 = termination to the AutoSwitch
agent.
CDR Field Definitions: Extended Format Fields
Includes all Standard Format Fields plus the following.
Table 4: Extended Format - Settings 1 & 101
IDSample SettingField NameDefinition
U14155551000Calling Party NumberThe Number called from. The format will be
delivered in whatever format the PSTN (TrunkSide) or PBX (Line-Side) delivers to the Tenor. It
will not necessarily be in International format.
V12345678901234PIN CodePIN Code entered. 14 digits maximum. This field
will be blank if a PIN is not configured.
W0123456789Local Call ID #Unique identification number, generated by the
local-side Tenor, for call record matching
purposes. Generated for all calls. **
X9876543210Remote Call ID # Unique identification number, generated by the
remote-side Tenor, for call record matching
purposes. Only generated for IP calls. **
** For a given IP call, Local Call ID of one Tenor should match the Remote Call ID of the other.
The reason that the sequence number and the Local Call IDs are usually the same, but not always the same,
is that the sequence number is generated at the end of the call wh en the CDR is output, and the Call IDs are
generated at the start of the call.
Quintum Tenor CMS CDRPage 8
CDR Field Definitions: Extended-CMS Format Fields
Settings 3 & 103
Sample CDR Record (the actual field output would be separated by commas)
B17325551212Called numberThe number called. This will be in international
C15Duration (seconds)This value is in seconds. The value will be 0 if
Sequence number. This is a unique number
assigned to identify an individual call (e.g, 1, 2, 3,
…). The sequence number starts from 1 and
wraps around at 4,294,967,295. When a Tenor
resets, the sequence number starts from 1 again.
If the system has a problem and loses
connectivity, the CDR server can send the Tenor
the last Call ID that it received. T enor will reply with
all records that contain a Call ID, which is greater
than the one last received.
format except for a pass-through call going from
Line-Side to the Trunk- Side or from Trunk-Side to
the Line-Side.
never connected.
Quintum Tenor CMS CDRPage 9
Table 5: Extended-CMS Format - Settings 3 & 103
IDSample SettingField NameDefinition
D20020107062812Call Initiated date/
time
E20020107062815Call Connected date/
time
F20020107063819Call Disconnected
date/time
G16Disconnect Cause
Code
The date and time the call initiated in the format of
yyyymmddhhmmss. The time will be the local time
configured on the Tenor. yyyy (4 digits for year),
mm (2 digits for month), dd (2 digi ts for day), hh (2
digits for hour), mm (2 digits for minutes), ss (2
digits for seconds).
The date and time the call was actually connected
in the format yyyymmddhhmmss. The time will be
the local time configured on the Tenor. yyyy (4
digits for year), mm (2 digits for month), dd (2
digits for day), hh (2 digits for hour), mm (2 digits
for minutes), ss (2 digits for seconds). This field
will be blank if the call never connected.
The date and time the call disconnected in the
format yyyymmddhhmmss. The time will be the
local time configured on the Tenor. yyyy (4 digi ts
for year), mm (2 digits for month), dd (2 digits for
day), hh (2 digits for hour), mm (2 digits for
minutes), ss (2 digits for seconds).
The Q.931 cause value assigned if the call is not
connected. Possible common entries are listed in
the Cause Code listbelow. This field will be blank
if the call was connected.
H208.226.140.57Local IP AddressThe IP address of the Local-side Tenor CMS. The
entry will be in the following format:
xxx.xxx.xxx.xxx.
I192.168.10.64Remote IP AddressThe IP address of the Remote-side T enor (or other
Gateway). This will be generated only if the call is
VoIP; if the call is circuit based, this field will be
blank. The entry will be in the following format:
xxx.xxx.xxx.xxx.
J4Origination Trunk IdIdentifies the origination trunk ID of the line that
initiated the call. This field will be blank if no trunk
ID is configured. The trunk ID is often configured
with an account code.
K1Call TypeThe type of call. Valid entry: 1 = voice, 2 = fax,
3 = modem, 4 = data.
L1Call Number TypeThe called numbering plan used for the call per
Q.931. Possible common entries are as follows:
1 = Public/E.164, 9 = Private.
Quintum Tenor CMS CDRPage 10
Table 5: Extended-CMS Format - Settings 3 & 103
IDSample SettingField NameDefinition
M5Incoming SlotIf the call is incoming, this field identifies which
Slot the call came in on. Valid entry: 1 through 13.
This field will be empty if the call is an incoming
VoIP call.N
N1Incoming DeviceIf the call is incoming, this field identifies which
Device channel the call came in on. Valid entry: 1-
4. This field will be empty if the call is an incoming
VoIP call.
O1Incoming Digital
Interface
P1Incoming ChannelIf the call is incoming, this field identifies which
Q3Outgoing SlotIf the call is outgoing, this field identifies the Slot
R1Outgoing DeviceIf the call is outgoing, this field identifies the
S4Outgoing Digital
Interface
If the call is incoming, this field identifies which
Digital Interface the call came in on. Valid entry: 1
through 8. This field will be empty if the call is an
incoming VoIP call.
channel the call came in on. V alid entry: 1-31. This
field will be empty if the call is an incoming VoIP
call.
the call is going out on. Valid entry: 1 through 13.
This field will be empty if the call is an outgoing
VoIP call.
Device the call is going out on. Valid entry: 1
through 4. This field will be empty if the call is an
outgoing VoIP call.
If the call is outgoing, this field identifies which
Digital Interface the call is going out on. Valid
entry: 1 through 8. This field will be empty if the
call is an outgoing VoIP call.
T1Outgoing ChannelIf the call is outgoing, this field identifies which
channel the call went out on. Valid entry: 1-31.
This field will be empty if the call is an outgoing
VoIP call
UNull (blank)Auto Switch TimeThis is the date and time the AutoSwitch occurred
(when the call is switched from VoIP to circuit).
The entry will be in the following format:
yyyymmddhhmmss where yyyy (4 digits for year),
mm (2 digits for month), dd (2 digi ts for day), hh (2
digits for hour), mm (2 digits for minutes), ss (2
digits for seconds). If an AutoSwitch did not occur,
this field will be blank.
Quintum Tenor CMS CDRPage 11
Table 5: Extended-CMS Format - Settings 3 & 103
IDSample SettingField NameDefinition
VNull (blank)Auto Switch DurationThe number of seconds that the AutoSwitch call
was active. Valid entry: time in seconds.
W0Bad IP Quality EventsThe number of bad quality events that occur
during a VoIP call. This number determines the
overall quality of a call.
X0Auto Switch FlagThe terminating side of the AutoSwitch call initially
terminates to the internal AutoSwitch agent before
the call is actually autoswitched. This termination
generates an extra CDR in addition to the original
call that is autoswitched. This field identifies a call
that is terminated to the AutoSwitch agent. 0 =
normal call, 1 = termination to the AutoSwitch
agent.
Y14155551000Calling Party NumberThe Number called from. The format will be
delivered in whatever format the PSTN (TrunkSide) or PBX (Line-Side) delivers to the Tenor. It
will not necessarily be in International format.
Z12345678901234PIN CodePIN Code entered. 14 digits maximum. This field
will be blank if a PIN is not configured.
AA123456789Local Call ID # Unique identification number, generated by the
local-side Tenor, for call record matching
purposes. Generated for all calls. **
BB987654321Remote Call ID #Unique identification number, generated by the
remote-side Tenor, for call record matching
purposes. Only generated for IP calls.
**
Settings 4 & 104
Includes all “Extended-CMS” Fields plus:
Table 6: Extended-CMS Format - Settings 4 & 104
IDSample SettingField NameDefinition
AC12138765432Incoming/Outgoing IP DNIf this is an Incoming IP Call, the number
displayed will be the number as received from the
other endpoint. If this is an Outgoing IP Call, the
number displayed will be the DN as it was sent out
over IP. (Outgoing Number plus any prepended
digits)
Quintum Tenor CMS CDRPage 12
Disconnect Cause Code List (Field G)
Table 7: Disconnect Cause Codes
Cause
Code
16Normal Call Clearing. The cause indicates that the call is being cleared because one of the
users has requested that the call be cleared.
17User Busy. The called system acknowledges the connection request but is unable to accept
the call because all B channels are in use.
18No User Responding. The cause is used when a user does not respond to a call
establishment message with either an alerting or connect indication within the prescribed
period of time allocated (in Q.931 by the expiry of either timer T303 or T310).
28Invalid Number Format (Address Incomplete). The cause indicates that the called user
cannot be reached because the called party number is not a valid format or is not complete.
31Normal, Unspecified. This cause is used to report a normal event only when no other cause
in the normal class applies.
34No Circuit/Channel Available. The connection cannot be established because no
appropriate channel is available to take the call.
47Resource Unavailable, Unspecified. This cause is used to report a resource unavailable
event only when no other cause will apply.
Definition
Quintum Tenor CMS CDRPage 13
Loading...
+ hidden pages
You need points to download manuals.
1 point = 1 manual.
You can buy points or you can get point for every manual you upload.