The Allworx server will listen on a TCP port on the LAN interface for connections. While a connection exists to the port, any new CDR records will be sent to the connecting client.

1. Streaming CDRs to ExternalDevices
The Allworx server will listen on a TCP port on the LAN interface for connections.
While a connection exists to the port, any new CDR records will be sent to the
connecting client.
CDR records are sent to listening clients each time a call-leg is connected (start) and
when it is terminated (end). Calls that are not answered have no CDR (e.g. ring with no
answer).
The CDR records are delimited by new-line characters (CRLF). Fields within the record
are delimited by commas (0x2C). Any comma that exists within the fields of the CDR
data is replaced by a space character (0x20). Blank fields (no value) are represented by
two consecutive commas.
The CDRs are transmitted in plain text. Any numeric field is represented by its ASCII
equivalent (as in the “%d” format for printf). The CDR records contain the following
ordered fields:
Name [Release] Description Value Range Examples
Call-ID [6.7] A unique designatorfor a call. Integer: 0 – 2 32 227390943
Call-Leg [6.7] A unique designatorfor a call-leg
within a call.
Integer: 0 – 2 32 1174075812
IsLive [6.7] Boolean for whether this CDR
represents the start of a call the end.
1 = live,
0 = terminated
0
Starttime Timestamp of the start of the call-leg in
UTC seconds since 1/1/1970
12:00:00am GMT
Integer: 0 – 2 32 1174075812
Duration Length of the call in seconds. Integer: 0 – 2 31 306
Source Device Unique identifier of the source of a call
such as MAC, Analog port or T1
channel (if known)
String Port:01
Mac:00:0A:DD:81:01:01
Chan:01
Source Description Description of calling device String Line 2-585.421.3850
Wilma’s Office Phone
Calling Party Name Caller-ID name received. String BARNEY RUBBLE
Calling Party Number Caller-ID number received (if any) String 3135551212

2. Name [Release] Description Value Range Examples
Destination Device Unique identifier of the destination of a
call such as MAC, Analog port or T1
channel (if known)
String Port:08
Mac:00:0A:DD:82:02:02
Chan:01
Destination Description Description of receiving device String Fred’s Office Phone
Called Party Name Description of party being called String Fred Flintstone
Called Party Number Number dialed/called String 109
PIN Number Authorization PIN number used to
place call
String 12345
DTMF Digits dialed during live call String 109
Terminator [6.7] 0 == unknown (for old calls)
1 == source party terminated call-leg.
2 == destination party ended call-leg
Integer: 0 – 2 2
Scope [6.8] 0 == unknown (for old calls)
1 == internal call
2 == external call
Integer: 0 – 2 2
DNIS Name [6.9.5] Mnemonic of dialed number String Allworx Toll Free
DNIS Number [6.9.5] Dialed number String 8662559679
An example CDR using the above format is:
43215442,6989,0,1209737765,47, Chan:05,Bedrock PRI - 05,RUBBLE
BARNEY,9998782233, MAC:00-0A-DD-81-01-26,Fred’s Office Phone,Fred
Flintstone,109,12345,,1,2,Allworx Toll Free,8662559679[CRLF]
Any fields beyond the last should be ignored as these are reserved for future use. String
format fields with no value are empty (appear as consecutive TAB characters). Integer
format fields with no value contain a zero.
The simplest client solution is a telnet session (e.g. via hyperterm) with data logging
directed at the CDR port. This log file can be imported into a spreadsheet for parsing.
There are also a myriad of CDR/SMDR software packages available for
purchase/download.