Table Of Contents

Reports

Overview: Reports

About Report Data

Generating Reports

Viewing and Printing Reports

Subscribers Report

Subscriber Message Activity Report

Distribution Lists Report

Failed Login Report

Storage Usage Report

Transfer Call Billing Report

Outcall Billing Report

Administrative Access Activity Report

Event Log Report

Port Usage Report

System Configuration Report

Unresolved References Report

Call Handler Traffic Report

AMIS Out Traffic Report

AMIS In Traffic Report

Reports

---

Overview: Reports

You can use Cisco Unity reports to gain information about subscribers and system activity. Some Cisco Unity reports provide information about subscribers and system activity over a period of time. Others offer a "snapshot" of a particular Cisco Unity entity as it stands at the time you run the report.

Refer to the following sections in this chapter to learn more about using Cisco Unity reports:

•About Report Data—This section provides information about how Cisco Unity gathers and stores report data, and which settings you can change to ensure that your reports contain the data you need.

•Generating Reports—This section details how to generate, view, and print Cisco Unity reports.

Refer to the following sections in this chapter for information on specific reports:

Subscriber reports:

•Subscribers Report—This report includes profile and account information about each subscriber.

•Subscriber Message Activity Report—This report shows when subscriber messages were left and when they were accessed.

•Distribution Lists Report—This report shows the owner, members, and creation date of public distribution lists.

•Failed Login Report—This report shows details of failed attempts to log on to subscriber accounts (by phone) and to the Cisco Unity Administrator.

•Storage Usage Report—This report shows the storage limits and disk space used for messages by a subscriber or by all subscribers.

•Transfer Call Billing Report—This report provides information about call transfers from call handlers and subscribers; this information can be used for billing purposes.

•Outcall Billing Report—This report provides information about outgoing calls made by Cisco Unity for message notifications; this information can be used for billing purposes.

System reports:

•Administrative Access Activity Report—This report shows details of all changes entered into the Cisco Unity Administrator; this information can be used as an audit trail of commands entered by system administrators.

•Event Log Report—This report provides information from the Windows application log.

•Port Usage Report—This report shows activity on each port; this information can be used to determine when to add new ports.

•System Configuration Report—This report provides information on system resource allocation.

•Unresolved References Report—This report shows any call handlers that were left in an invalid state when the Cisco Unity Administrator was not used to delete subscriber accounts.

•Call Handler Traffic Report—This report shows how many calls are routed through a particular call handler and how callers are choosing to exit that handler.

•AMIS Out Traffic Report—This report provides information about outbound AMIS calls.

•AMIS In Traffic Report—This report provides information about inbound AMIS calls.

About Report Data

Cisco Unity reports that provide information about subscribers and system activity over a period of time contain log-based data. For example, the Call Handler Traffic report shows how many calls are routed through a particular call handler and how callers are choosing to exit that handler during the time period that you specify. Other Cisco Unity reports offer a "snapshot" of subscriber or system data as it stands at the time you run the report, and therefore they reflect the current status of a particular Cisco Unity entity. For example, the Storage Usage report shows the current storage limits and disk space used for messages by a subscriber or by all subscribers.

Cisco Unity automatically gathers and stores data that is used in log-based reports every 30 minutes. You specify how long Cisco Unity stores the data in the Cleanup Interval for Logger Data Files in Days field on the System > Configuration > Settings page. For example, if you have set this field to three, a log-based report will reflect activity only for the last three days, even if you specified more than three days in the time range for the report.

You should regularly delete the report files that you generate, to avoid accumulating large amounts of data. By default, Cisco Unity deletes report files every seven days. To change how often reports are deleted, adjust the settings for the Cleanup Interval for Report Files in Days field on the System > Configuration > Settings Page.

Generating Reports

When you generate a report, you can specify some or all of the following:

•The subscribers, administrators, or distribution lists to include in the report

•The date and time range to include

•The sort order for the data in the report

You also choose to save the report either as a Web page or as a comma-delimited file:

Web page	An HTML file. You use a Web browser to view and to print the report. In some cases, a report may be too large to be viewed in a Web browser.
Comma-delimited file	A text file (also known as a comma separated or CSV file). Each row in the report appears on a separate line, and values are separated by commas. Select this format if you want to view the information in another application, for example, a spreadsheet program.

The best time to generate reports is when the system is not busy: after regular business hours when Cisco Unity is not processing many calls, or when there are no other processes running (for example, before or after a full backup). Note that for large systems, reports that offer a "snapshot" of subscriber or system data may take a significant amount of time to run.

In the current release of Cisco Unity, reports cannot be scheduled in advance, and if you turn off Cisco Unity while there are reports in the report queue, the reports will be deleted.

Viewing and Printing Reports

When a report is ready, Cisco Unity sends an e-mail to the person who generated the report. The e-mail contains a link to the report file. To access the report file, all Cisco Unity administrators must have full read/write access and all Domain Users must have read rights to the CommServer\Reports directory located on the Cisco Unity server (these access levels are set by default). To have read rights, an administrator or user must either be a member of the domain that Cisco Unity is in or be associated with a domain that is trusted by the domain that Cisco Unity is in.

All reports contain a report header followed by columns of data. If, for example, you generate a report for all subscribers, the subscriber name is included above the data associated with the subscriber.

To view a report

---

Step 1 Click the link in the e-mail message.

Step 2 If the report is in Web page format, the browser will start automatically and display the information. If the report is in comma-delimited format, you may be required to choose an application in which to display the information.

---

To print a report

---

Step 1 View the report, as described above.

Step 2 Click Print in the File menu.

---

To view the status of a report

The ability to view report status is controlled by class of service.

---

Step 1 Go to http://<server name>/status, or double-click the desktop shortcut to the Status Monitor.

Step 2 Click Reports.

---

Subscribers Report

Use the Subscribers report to get a listing of all the Cisco Unity subscribers. You can generate the report for an individual subscriber, for all members of a public distribution list, or for all Cisco Unity subscribers.

The Subscribers report includes the following information:

First Name, Last Name	The name of the subscriber or public distribution list for which the report was generated.
Exchange Alias	The subscriber alias in Exchange.
Location	The Cisco Unity location.
NT Domain	The Windows domain name assigned to a subscriber.
Billing ID	The billing ID of a subscriber.
Class of Service (COS)	The class of service assigned to a subscriber.
Extension	The primary phone extension assigned to a subscriber. If there are any alternate extensions assigned to a subscriber, they are listed below the primary.
Inbox Size	The total size, in kilobytes, of all e-mail, voice, and fax messages stored for the subscriber in Exchange.

Subscriber Message Activity Report

Use the Subscriber Message Activity report to diagnose voice message problems reported by a subscriber (for example, voice messages are not being sent or received, or the message waiting indicator is not being turned on or off properly). You generate this report for an individual subscriber only.

The Subscriber Message Activity report includes the following information:

Date and Time	The date and time that the subscriber took action on the message.
Source	Either the computer or the phone that generated the message activity.
Action Taken in Response to Message	The activity that took place in regards to voice messages (for example, New Message, Message Read, Save, Delete, Mark New, Login, and Logoff). The actions MWI On Requested and MWI On Completed indicate, respectively, that Cisco Unity sent a request to the phone system to turn on the MWI and received a request-completed confirmation. In cases where the phone system does not provide a confirmation, Cisco Unity assumes the request was successful.
Number of New Messages	The number of new voice messages in the Exchange mailbox for a subscriber.
Sender's Name and DTMF	The name and extension of the message sender, if known.
Date and Time Message Arrived	The date and time the message arrived in the Exchange mailbox.
Dial Out Number	The number to which a message notification was sent.
Dial Out Result	The result of the outgoing call for the message notification. Possible results include: •Busy—The dialed number was busy. •Connected—The called party answered the phone. •Failure—The call failed. •Port Disabled—All ports for outgoing calls were disabled. •Port Unavailable—No ports were available for the outgoing call. •RNA (Ring No Answer)—The dialed number did not answer. •Release—The result is unknown. This typically happens for notifications sent to pagers. •Unknown—The result is unknown.

Distribution Lists Report

Use the Distribution Lists report to get a listing of all public distribution lists and, optionally, the members in each list. You can generate the report for a selected public distribution list or for all public distribution lists.

If you want the report to include the names of distribution list members, check the List All Members For Each Distribution List check box.

The Distribution Lists report includes the following information:

Creation Date	The date that the public distribution list was created.
List Alias	The Exchange alias name of the public distribution list.
Count	The number of subscribers and other public distribution lists that are members of the public distribution list.
Distribution List Name	The name of the public distribution list.
Owner First and Last Name	The subscriber or public distribution list that owns the public distribution list.
Member List	The names of subscribers and other public distribution lists that are members of this public distribution list.

Failed Login Report

The Failed Login report includes information about failed phone user logons as well as failed Cisco Unity Administrator logons. Use the Failed Login report to identify patterns of invalid logons, which would indicate that an individual is trying to gain unauthorized access to Cisco Unity. The report also identifies accounts that have been locked because the maximum number of invalid logons has been exceeded.

You can generate the Failed Login report for an individual subscriber account, or for all subscriber accounts. Additionally, you can indicate whether to show all failed logon attempts (expand the report) or show only the last failure for each subscriber.

Note that including the Failed Login report for the Cisco Unity Administrator logons requires that auditing be enabled in system security policies. Cisco Unity setup enables auditing by default.

The Failed Login report includes the following information about failed phone user logons:

Subscriber/User Name	The display name of the subscriber whose account experienced the failed logon.
Alias	The Exchange alias of the subscriber whose account experienced the failed logon.
Caller ID (Phone Number Called From)	The calling number, if known, from which the logon was attempted.
Subscriber DTMF	The unique DTMF access code that callers dial to access this account.
Date and Time	The date and time of the failed logon.
Maximum Failures Exceeded	Whether the failed logon exceeded the maximum number allowed; if so, the account is locked.
Failure Number	A running total of failed logons by subscriber or by day, depending on how the report is sorted.
Source	Indicates either Standard when a subscriber uses normal Cisco Unity password security, or Enhanced when a subscriber uses enhanced phone security to log on.

The Failed Login report also includes the following information about failed Cisco Unity Administrator logons:

User Name	The logon name assigned to the subscriber.
Computer	The name of the workstation, if known, from which a subscriber attempted to log on.
User Domain	The Windows domain name assigned to a subscriber.
Event ID	The Windows event ID that was generated when the logon failed.
Date and Time	The date and time of the failed logon.
Failure Number	A running total of failed logons by subscriber or by day, depending on how the report is sorted.

Storage Usage Report

Use the Storage Usage report to obtain information about the amount of storage space available and the disk space used for storing messages by each subscriber. You can generate the Storage Usage report for a selected subscriber, for all subscribers, or for a public distribution list.

The Storage Usage report includes the following information:

Subscriber Name	The display name of the subscriber.
Storage Limit (KB)	The amount of disk space, in kilobytes, allocated for the subscriber message store.
Total Message Size (KB)	The amount of disk space, in kilobytes, in use for received and stored messages.
Disk Storage Available (KB)	The amount of disk space, in kilobytes, available for receiving and storing messages.

Transfer Call Billing Report

Use the Transfer Call Billing report to obtain information about calls that are transferred from a subscriber account or from a call handler. You can use this report for billing purposes or to keep track of transfers to long distance phone numbers. You can generate the report for all subscribers, billing IDs, or call handlers, or for a specific subscriber, public distribution list, billing ID, or call handler.

The Transfer Call Billing report includes the following information:

Name	The name of the Cisco Unity entity (such as subscriber, call handler, or interview handler) from which the call was transferred.
Extension	The extension of the Cisco Unity entity (such as subscriber, call handler, or interview handler) from which the call was transferred.
Billing ID	The billing ID of the Cisco Unity entity (such as subscriber, call handler, or interview handler) from which the call was transferred.
Date	The date that the transfer occurred.
Time	The time that the transfer occurred.
Dialed Number	The number that the call was transferred to.
Transfer Result	The result of the call. Possible results include: •Connected—The called party answered the phone. •Busy—The dialed number was busy. •RNA (Ring No Answer)—The dialed number did not answer. •Released—The result is unknown.

Outcall Billing Report

Use the Outcall Billing report to obtain information about outbound calls made by Cisco Unity for message notifications. This report also provides information about outbound calls made when subscribers use the Media Master control bar to create or play recordings over the phone. You can use this report for billing purposes, or to keep track of message notifications sent to long distance phone numbers.

You can generate the report for all Cisco Unity subscribers or billing IDs, or for a specific subscriber, billing ID, or public distribution list. You can select to generate a summary version of the report or a detailed version, which includes the times and lengths of each call.

The detailed version of the Outcall Billing report includes the following information:

Name	The name of the Cisco Unity entity (such as subscriber, call handler, or interview handler) which made the call.
Extension	The extension of the Cisco Unity entity (such as subscriber, call handler, or interview handler) which made the call.
Billing ID	The billing ID of the Cisco Unity entity (such as subscriber, call handler, or interview handler) which made the call.
Time	The time that Cisco Unity made the call.
Delivery Device	The notification device that the message was sent to, which can be a home phone, work phone, spare phone, or pager. For Media Master recording by phone, the word "TRAP" (Telephone Record And Playback) is listed as the delivery device.
Dialed Number	The phone number of the delivery device.
Result	The result of the call. Possible results include: •Busy—The dialed number was busy. •Connected—The called party answered the phone. •Failure—The call failed. •Port Disabled—All ports for outgoing calls have been disabled. •Port Unavailable—No ports were available for the outgoing call. •RNA (Ring No Answer)—The dialed number did not answer. •Release—The result is unknown. This typically happens for notifications sent to pagers. •Unknown—The result is unknown.
Call Time (Seconds)	The length of the call, in seconds.

Administrative Access Activity Report

Use the Administrative Access Activity report to track which system administrators changed values in Cisco Unity during a specified period and the changes they made. You can generate this report for a selected administrator or for all administrators.

The Administrative Access Activity report includes the following information:

Date and Time	The date and time that the administrator created, deleted, or updated data for a Cisco Unity entity (such as subscriber, call handler, or interview handler).
Admin	The administrator alias in Exchange.
Administrator's First and Last Name	The name of the administrator.
DTMF ID	The extension assigned to the administrator.
Administrative Action	Whether the administrator action created, updated, or deleted data for a Cisco Unity entity.
Object	The type of Cisco Unity entity (such as subscriber, call handler, or interview handler) that the administrator created, deleted, or updated.
Name	The name of the Cisco Unity entity (such as subscriber, call handler, or interview handler) that the administrator created, deleted, or updated.
Field (Property)	The name of the field from the page in the Cisco Unity Administrator that was changed in creating, updating, or deleting data for a Cisco Unity entity.
Value	The new value for the changed field.

Event Log Report

Use the Event Log report to list events from the Windows application log. You can generate the report for all application events on the Cisco Unity server, or for the events that apply only to Cisco Unity. Note that Cisco Unity writes events only to the Windows application log; it does not write events to the system or security logs. If you generate a report for all application events, you can identify the Cisco Unity events as those events that end in "_MC" (for example, "AvLogMgrSvr_MC").

You can also view application events by using the Windows Event Viewer (from the Start menu, click Programs > Administrative Tools > Event Viewer). For more information on Windows events, refer to the Windows Event Viewer online Help. If you want Cisco Unity to send e-mail, voice mail, or both to subscribers or public distribution lists in response to an application event on the Cisco Unity server, see the "Event Notification Utility" section on page 6-3 to set this up.

The Event Log report includes the following information:

Date and Time	The date and time that the event occurred.
Type	The Windows event type.
Source	The component that caused and logged the event.
Message (Msg) ID	The event ID.
Computer	The server on which the event occurred.
More Info	A message that contains additional information about the event.

Port Usage Report

Use the Port Usage report to determine if the voice messaging system is running close to capacity. You can indicate the port or ports to include in the report. Enter port numbers or ranges of numbers separated by commas (for example, 1,2,4,8) in the Ports to Show field. To include all ports in the report, leave this field blank.

The Port Usage report includes the following information:

Port Number	The Cisco Unity port number.
Unit of Time	The unit of time by which data is broken down for the time period that you specified in the Date Range. Depending on the length of the time period, data is broken down into hours, days, and weeks.
Date Range	The range of dates for which data is included.
Time	The specific hour or date(s) by which data is broken down for the time period that you specified in the Date Range.
Ports	The ports included in the report.
Number of Calls	The number of calls processed by the port per hour, day, or week for the time period specified.
Length of Calls	The total length, in seconds, of all calls on the port per hour, day, or week for the time period specified.
Average Length of Calls	The average length, in seconds, of all calls on the port per hour, day, or week for the time period specified.
Percent Utilization	The percentage of available time that a port was in use per hour, day, or week. Note that it is recommended that the value of Percent Utilization not exceed 80 percent of the ports used for incoming calls during peak usage.
Average Calls Per Hour	The average number of calls per hour for each port.
Average Calls Per Day	The average number of calls per day for each port. This information is provided only on the row that contains the summary for the week.

System Configuration Report

Use the System Configuration report to get information about the Cisco Unity server and software.

You also can view this information in the Cisco Unity Administrator on the Configuration pages.

The System Configuration report includes the following information:

Serial Number	The serial number that appears on the system key.
OEM Code	Identifies the OEM version, if applicable.
Product	The name of the software product and version number.
Number of Voice Ports	The number of voice ports licensed for the Cisco Unity system.
Languages	The number of language licenses.
Available Licenses and Total Licenses	The available and total number of Cisco Unity licensed features, such as text-to-speech and Digital Networking.
Leading Silence for Recordings	The length of silence, in seconds, allowed at the beginning of a recording. When the leading silence is longer than specified, Cisco Unity stops recording and discards the recording.
Trailing Silence for Short and Long Recordings	The length of silence, in seconds, allowed at the end of recordings that are 30 seconds or less and of recordings that are more than 30 seconds. When the trailing-silence limit is reached, Cisco Unity assumes the recording is finished and stops recording.
Minimum Length for a Recording	The minimum length of a recording, in seconds. When a recording is shorter than the minimum length, it is discarded.
Computer and Domain Name	The Cisco Unity server name on the network and the Windows domain name.
Total Hard Drive Space, Total Used Hard Drive Space, and Total Free Space	The total size of all hard disks, the total amount of space in use, and the total free space on the Cisco Unity server.
Additional Settings	The report contains additional information about the Cisco Unity server and software, such as integration type, ActiveAssistant licensing, and the text-to-speech engine.

Unresolved References Report

Use the Unresolved References report to locate primary call handlers (those call handlers that are associated with a subscriber account), other call handlers, and interview handlers that are left unresolved because of the improper deletion of a subscriber account. The problem occurs when a subscriber is deleted by using Microsoft Exchange or Windows administrator applications without first deleting the subscriber by using the Cisco Unity Administrator.

The Unresolved References report examines the Cisco Unity information stored in the Exchange directory and reports any problems that it finds. The report identifies the unresolved handler, describes the problem, and suggests a solution.

If the report finds an unresolved primary call handler, you will need to use the Cisco Unity SysCheck utility to remove it. To access the SysCheck utility, go to the directory in which Cisco Unity is installed (the default is C:\CommServer). Then, browse to the SysCheck subdirectory, and run SysCheck.exe.

The Unresolved References report includes the following information:

Handler Name	The name of the unresolved handler.
Handler/Access ID	The extension (if any) associated with the handler.
Handler Type	The type of handler found to be in an unresolved state. The type can include call handlers, interview handlers, the directory handler, or primary call handlers.
Owner	The owner of the handler.
Message Recipient	The message recipient associated with the handler.

Call Handler Traffic Report

Use the Call Handler Traffic report to track the number of calls routed by a particular call handler, and how callers chose to exit that handler.

There are four ways a caller can exit a call handler: by hanging up, by choosing a one-key dialing option, by dialing an extension that transfers the call to another call handler (or subscriber), or by being routed automatically by the after-greeting action specified in the call handler.

The Call Handler Traffic report includes the following information:

Start Time	The specific hour or date(s) by which data is broken down for the time period that you specified in the Date Range.
Total Calls	The total number of calls routed to the call handler.
Method Callers Use to Exit a Call Handler	The total number of times each exit method is used by callers. Callers can exit a call handler by hanging up, pressing a one-key dialing option, dialing an extension that transfers the call to another call handler (or subscriber), or by being routed to another call handler (such as the Good-Bye call handler) as specified by the after-greeting action.
Key	The number of calls in which the caller exited the call handler by pressing a one-key dialing option. The report includes a tally for each key.
DTMF ID	The number of calls in which the caller exited the call handler by dialing a valid extension to transfer to another call handler (or subscriber).
Invalid DTMF ID	The number of calls routed to the default Error call handler because the caller dialed an invalid extension.
After Greeting Action	The number of calls routed according to the after greeting action specified for the call handler.
Hang-Up	The number of calls in which the caller exited the call handler by hanging up.

AMIS Out Traffic Report

Use the AMIS Out Traffic report to track the progress of outbound AMIS messages. This report is available only if your organization purchased a license for AMIS.

The Outbound AMIS Traffic report includes the following information:

Submit Date and Time	The date and time that the AMIS message transmission was completed.
Importance (Urgency)	Indicates whether the subscriber marked the AMIS message "Urgent" before sending it to the destination node.
Sender's Primary Extension/Sender	The extension of the subscriber who sent the AMIS message to the destination node.
Target Device/Target Mailbox Delivery Number	The remote mailbox ID number of the AMIS message recipient.
Transmission Start Time	The date and time that Cisco Unity started the transmission of the AMIS message to the destination node.
Transmission Duration	The total number of seconds needed to transmit the AMIS message from one node to the other.
Delivery Status	"Sent OK" is specified for successful deliveries and "Failed" for failed deliveries; if available, a brief explanation is displayed.
Total Transmission Time	The total transmission time for all AMIS messages sent, specified in seconds.
Total Messages Delivered Successfully	The total number of AMIS messages that were delivered within their specified delivery schedules.
Total Failed Messages	The total number of AMIS messages that were not delivered to the destination node within their specified delivery schedules.

AMIS In Traffic Report

Use the AMIS In Traffic report to track the progress of inbound AMIS messages. This report is available only if your organization purchased a license for AMIS.

The AMIS In Traffic report includes the following information:

Start Reception/Transmission Receive Time	The date and time that Cisco Unity began receiving the transmission of the AMIS message.
Matching ID/Remote Sender ID	The remote mailbox ID number of the remote subscriber sending the AMIS message. If Cisco Unity cannot find a matching ID for the node that sent a message, this section in the report is left blank, and the delivery is reported as a failure in the Status column.
Target User's Primary Extension/Recipient Extension	The extension of the subscriber for whom the AMIS message is intended. If Cisco Unity cannot find the subscriber extension in the directory, this section in the report is left blank, and the delivery is reported as a failure in the Status column.
Transmission Duration	The total number of seconds needed to transmit the AMIS message from one node to another.
Delivery Status	"Received OK" is specified for successful deliveries and "Failed" is specified for failed deliveries; if available, a brief explanation is displayed.
Port Number	The number of the port that received the AMIS message.
Total Transmission Time	The total transmission time for all AMIS messages that were received, specified in seconds.
Total Messages Received Successfully	The total number of AMIS messages that were received within their specified delivery schedules.
Total Failed Messages	The total number of AMIS messages that were not received within their specified delivery schedules.