About Call Detail Recorder

Note: This option must be enabled/configured using the Text Console.

Call Detail Recorder (CDR) is an optional feature that implements a call accounting system that is referred to in the telecommunications industry as call detail recording. This section describes the features and capabilities of the Call Detail Recorder optional feature. It works with the NuPoint Voice application on the NuPoint UM server and must be enabled/configured using the Text console. You can generate reports about call detail information using either the Web console or the Text console.

CDR creates a record of each call transaction (such as a voice message) on the NuPoint Unified Messaging server. Records are stored in a single-line, fixed-length format. They are uniquely identified by consecutive Call Sequence Numbers, which range from 1 to 999999. After record 999999 is written, the next record is number 1. Records are not overwritten when the Sequence number goes back to 1. Overwriting only occurs when the defined maximum number of records have been stored.

The CDR application is designed to be run by one user at a time to avoid two people overwriting each other’s selections. If the CDR Main Menu is running on one terminal, and a second user tries to start the CDR Main Menu, it terminates after giving the second user an error message.

CDR runs continuously once you start it. Even if you shut down or reboot the server, CDR restarts when the NuPoint Voice application loads. Similarly, if you stop CDR, it remains off until you restart it from the CDR menu.

Most configuration options can be changed while CDR is running EXCEPT the following:

CDR Features

Call Detail Recorder is designed for easy data transport to another computer system. The remote site can then process the call information using any appropriate application. Call Detail Recorder provides the following features:

CDR Records

CDR creates a record of each call transaction on the NuPoint UM server (for example, a voice message). Records are stored in a single-line, fixed-length format. They are uniquely identified by consecutive Call Sequence Numbers, which range from 1 to 999999. After record 999999 is written, the next record is number 1. (Call Sequence Numbers "turn over," just like the odometer in a car.) Records are not overwritten when the Sequence number goes back to 1. Overwriting occurs when the defined maximum number of records have been stored.

Note: CDR records are sometimes referred to as "messages" in the menus or prompts.

CDR Fields

The CDR Record Fields table below lists the 26 fields that can appear in a CDR record. For information about field length and/or formatting, see CDR Reports.

CDR records contain certain fields that need further explanation. These fields contain two-digit numerical codes that identify certain details of every call monitored. The tables that follow this one describe the meanings of these fields:

Finally, you can see the interrelationship of the above fields by referring to Interpreting Your Results.

CDR Record Fields
Field Abbreviation Meaning
1 CSN Call sequence number
2 DATE Call start date
3 TIME Call start time
4 STIM Call stop time
5 PORT Port number (Module, Port, and Line)
6 SYID Server System ID (site code)
7 CDUR Call duration
8 FMBX From mailbox (when using tree or chain mailbox) or originating mailbox
9 TMBX To mailbox (destination mailbox or mailbox called; also mailbox logged into by user)
10 FNUM Originating telephone number or network node number
11 TNUM Destination telephone number or network node number, or mailbox transferred to from a tree or chain mailbox
12 MSG Server speech message number
13 CT Call type ( see CDR Ca ll Types table )
14 AT Access type (see CDR Access Types table)
15 TT Termination type (see CDR Termination Types table)
16 ME Invalid mailbox entries
17 PE Invalid Passcode entries
18 MS Number of messages sent
19 MP Number of messages played or received
20 MD Number of messages discarded
21 MK Number of messages kept
22 TA Number of failed transfer attempts
23 EC Error code (see CDR Error Codes Table)

Call Types (Field 13)

CDR allows you to determine different types of calls, which lets you bill them at different rates, for example, or ignore certain types you include in your basic service package. The table below shows the available call types you can track.

Call Type (CT) is the 13th field in each CDR record.

You should use Call Type 1 only when you need as much detail as possible, such as when troubleshooting. It lists every message sent to and from each mailbox. For example, if a user sends one message to a distribution list with four users, and you are logging Call Type 1 messages, CDR generates four records, one for each recipient. If you do not log Call Type 1, CDR still creates one record indicating that a user sent four messages (4 appears in the MS field).

CDR Call Types
Call Type Meaning Call Type Meaning
01 Local message delivery (to local mailboxes, by outside caller or user) Use only when maximum detail needed. 15 Incoming Busy-forwarded call
02 Outgoing NP WakeUp call 16 Incoming No-answer-forwarded call
03 Telephone call placement 17 Incoming Indirect
04 This call type no longer used 18 Outgoing NP Net call setup
05 Paging call or outside message delivery 19 Incoming NP Net call setup
06 This call type no longer used 20 This call type no longer used
07 Outgoing NP Net call 21 This call type no longer used
08 Cut-through paging call 22 Outgoing NP Net disconnect
09 This call type no longer used 23 Incoming NP Net disconnect
10 Incoming NP Net call 24 This call type no longer used
11 Mailbox Purge 25 This call type no longer used
12 Incoming direct call 26 This call type no longer used
13 Incoming direct call - No passcode 27 NuPoint Voice resource access
14 Incoming Call-forwarded call 28 NP View network access

Each of these Call Types and their related fields is described in the "Analyzing CDR Data" section.

Networking Application Call Types

NP Net has its own call types (see the table above) that display Call Setup information. These call types only log the time used by the handshaking process to connect a pair of NP Net servers. In addition to the Call Setup message types, NP Net has its own incoming and outgoing call types that log the time used in transmitting or receiving each individual message between two NP Net servers. Finally, there are two NP Net disconnect call types.

Access Types (Field 14)

Access Type (AT) is the 14th field in each CDR record and shows how the caller or user accessed the server. You can use Access Types for differential billing or to determine your clients’ usage of the server. The following table shows the possible access types.

CDR Access Types
Access Type Meaning Access Type Meaning
01 Outside caller 10 This access type no longer used
02 Mailbox user 11 NP Net receipt update
03 Mobile DID user 12 Name broadcast
04 Outside caller to template mailbox 13 Greeting broadcast
05 This access type no longer used 14 Passcode broadcast
06 NP View session over TCP/IP network 15 Message Delivery, billed (all-types)
07 Outside caller called into NP Receptionist 16-22 This access type no longer used
08 Message Delivery, non-billed (all types) 23-25 Reserved for future use
09 User accessed Administration-by-Phone functions 40 NP OnDemand feature

Termination Types (Field 15)

Termination Type (TT) is the 15th field of each CDR record. It indicates how the call was ended. Again, you can use this for differential billing or to determine your clients’ usage of the server. The following table lists the Termination Types available.

Termination Types 1 through 8 are generated at the completion of a call. Types 9 and 10 are for calls that continue after a record is logged. For example, if an outside caller leaves a message and stays on the line to hear the prompt, the caller can then leave a message for another user. CDR creates a second record for the next action the caller performs. This subsequent record indicates the mailbox being used in the From Mailbox field (FMBX, field number 8).

CDR Termination Types
Termination Type Meaning
00 Unknown
01 Call completed successfully
02 Caller/user hung up
03 Call failed
04 Caller/user disconnected by the server, or three invalid mailboxes entered sequentially, or invalid passcode entries, or no response from caller/user
05 Caller/user transferred to an extension
06 Caller/user transferred to attendant
07 Caller/user transferred to E-mail
08 Message delayed by recipient (used with Call Placement)
09 Caller/user transferred to mailbox (from tree or chain mailbox)
10 Caller/user recycled (completed call, performed another function)

Error Codes (Field 23)

The Error Code (EC) is the 23rd field in the CDR record. It indicates if there was any error or problem with the call. You can use error codes for differential billing (for example, only bill calls with certain codes) or to determine if there is a problem with the server when troubleshooting.

The following table lists the available Error Codes and their meanings.

CDR Error Codes
Error Code Meaning Error Code Meaning
00 Unknown error. Contact your support representative. 12 Message rejected by destination
01 Call successfully completed 13 Mailbox was in use when user called
02 Call terminated due to excess invalid mailbox number entry attempts 14 Could not transfer caller/user to an extension
03 Call terminated due to excess invalid passcode entry attempts 15 Could not transfer caller/user to an attendant
04 Timeout on waiting for input 16 Could not transfer caller/user to E-mail
05 Too many bad access code entries 17 Access to mailbox denied
06 Destination was busy 18 This error code no longer used
07 Destination did not answer 19 This error code no longer used
08 Network node does not exist 20 Time limit reached
09 Mailbox does not exist 21 Message is bad or does not exist
10 Invalid telephone number 22 Destination mailbox is full
11 Invalid extension number 23 This error code no longer used