Cisco Unity Express VoiceMail and Auto Attendant CLI Administrator Guide

Types of Remote Addressing

Cisco Unity Express supports the following types of remote addressing:

• Blind addressing
• Spoken name confirmation

Blind Addressing

A subscriber can send a message to another subscriber on a remote location, which must be configured on the local (sender’s) system. The sender addresses the message using the location ID of the remote system plus the recipient’s extension number at the remote location.

When the message is sent to the remote subscriber, the sender will not hear a confirmation of the recipient’s name or extension. This is blind addressing.

Spoken Name Confirmation for Remote Subscribers

Administrators can assign user IDs and extensions in the local Cisco Unity Express directory for subscribers at existing remote locations. Additionally, administrators or other privileged subscribers can record spoken names for these subscribers using the Administration via Telephone (AvT) feature.

If the local system has vCard information enabled, incoming vCard information updates the remote subscriber information on the local system. The vCard information may contain the remote subscriber’s first name, last name, and spoken name. This information is stored in the least recently used (LRU) cache.

A sender on the local system can address a message to a remote subscriber using dial-by-name or dial-by-extension. If a spoken name for the recipient is recorded, the sender hears the spoken name as confirmation. If the recipient does not exist in the local directory but is in the LRU cache, the sender hears the LRU cache information as confirmation. If the remote subscriber is not in the directory or the cache, the sender receives the recipient’s location ID and extension.

Delivery Notifications

Cisco Unity Express supports the following message delivery notification types:

• Non-delivery receipt (NDR)
• Delayed delivery record (DDR)

Non-Delivery Receipt (NDR)

If the system cannot deliver a message to a remote site after 6 hours, the local sender receives a non-delivery receipt (NDR) indicating the message was not sent or that the message was not delivered to the recipient’s mailbox.

This receipt indicates the reason for nondelivery. If nondelivery is due to the recipient’s mailbox being full, nonexistent, or disabled, the nondelivery message includes the sender’s original message. When the sender plays the NDR, the sender can readdress and resend the original message or delete the message.

Each NDR counts against the sender’s mailbox capacity.

Delayed Delivery Record (DDR)

Cisco Unity Express sends a delayed delivery record (DDR) to the local sender’s mailbox after 60 minutes of trying to deliver the original message. Unlike the NDR, the DDR does not contain the original message as an attachment and does not count against the sender’s mailbox capacity.

The DDR cannot be saved, only deleted.

The system stores only one copy of a DDR for a particular message in the sender’s mailbox. The sender must delete the existing DDR in order to receive an updated DDR for the same message.

Prerequisites

• Cisco Unity Express must be installed and configured at each remote location.
• Network connectivity between all Cisco Unity Express and Cisco call control system sites must be established.
• Ensure that VPIM networking is configured on Cisco Unity, including the primary location for Cisco Unity and the delivery locations for remote Cisco Unity Express locations.

Required Data for This Procedure

The following information is required to configure networking on Cisco Unity Express:

• Network location ID number—Unique ID number for each location used by the voice-mail sender to send a remote message. The maximum length of the number is 7 digits. Cisco Unity Express supports a maximum of 500 locations.

Note Avoid creating locations with conflicting IDs, such as 100, 1001, and so forth. This may lead to ambiguity while sending messages to these locations and may lead to messages being addressed incorrectly.

• E-mail domain name—E-mail domain name or IP address for the remote voice-mail system. The domain name is attached to the local voice-mail originator’s extension when sending a VPIM message. The local system’s e-mail domain name must be configured to receive remote voice-mail messages.
• (Optional) Location name—Descriptive name of the network location.
• (Optional) Abbreviated location name—Abbreviated name of the network location. Maximum length of the name is 5 characters.
• (Optional) Voice-mail system telephone number prefix—Phone number prefix that is added to a local voice-mail originator’s extension to create a VPIM address. A prefix is required only if an e-mail domain services multiple locations, and extensions between the locations are not unique. The maximum length of the prefix is 15 digits. The default prefix is empty.
• (Optional) Length of the local voice-mail system extensions. The default minimum is 2, the default maximum is 15.
• (Optional) VPIM encoding scheme—Encoding scheme options for translating voice-mail messages at the local Cisco Unity Express system are dynamic, G.711mu-law, or G.726. The default scheme is dynamic.
• (Optional) Voice-mail spoken name capability—Enabling this functionality permits receipt of a voice-mail originator’s spoken name, which is played at the beginning of the received voice-mail message.
• (Optional) Broadcast VPIM ID—Used for sending and receiving broadcast messages between network locations. See Configuring the Broadcast Message VPIM ID for a Network Location for more information.
• (Optional) Secure Messaging—Used for supporting secure messaging. Supported in Cisco Unity Express 8.6 and later versions. See the “Configuring Secure Messaging” section for more information.
• Location ID for the local system.

SUMMARY STEPS

1. config t

2. network location id number

3. (Optional) name location-name

4. (Optional) abbreviation name

5. email domain domain-name

6. (Optional) voicemail phone-prefix digit string

7. (Optional) voicemail extension-length number [min number | max number]

8. (Optional) voicemail vpim-encoding {dynamic | G711ulaw | G726}

9. (Optional) voicemail spoken-name

10. (Optional) voicemail secure-messaging

11. end

12. Repeat Steps 2 through 11 for each remote location.

13. network local location id number

14. end

15. show network locations

16. show network detail location id number

17. show network detail local

18. show network queues

DETAILED STEPS

	Command or Action	Purpose
Step 1	config t   se-10-0-0-0# config t	Enters configuration mode.
Step 2	network location id number   se-10-0-0-0(config)# network location id 9	Enters location configuration mode to allow you to add or modify a location. number—A unique numeric ID assigned to the location. This number is used to identify the location and is entered when a subscriber performs addressing functions in the TUI. The maximum length of the number is 7 digits. Cisco Unity Express supports up to 500 locations on a single system. To delete a location, use the no form of this command.
Step 3	name location-name   se-10-0-0-0(config-location)# name “San Jose”	(Optional) Descriptive name used to identify the location. Enclose the name in double quotes if spaces are used. To delete a location name description, use the no form of this command.
Step 4	abbreviation name   se-10-0-0-0(config-location)# abbreviation sjcal	(Optional) Creates an alphanumeric abbreviation for the location that is spoken to a subscriber when the subscriber performs addressing functions in the TUI. You cannot enter more than 5 characters. To delete an abbreviation, use the no form of this command.
Step 5	email domain domain-name   se-10-0-0-0(config-location)# email domain mycompany.com	Configures the e-mail domain name or IP address for the location. The domain name is added when sending a VPIM message to the remote location (for example, “4843000@mycompany.com”). If you do not configure a domain name or IP address, the Cisco Unity Express system at this location cannot receive network messages. To remove the e-mail domain name or IP address and disable networking, use the no form of this command. Caution If you remove the e-mail domain for a network location, the system automatically disables networking from the Cisco Unity Express module to that location. If you remove the e-mail domain for the local location, then networking on that Cisco Unity Express module is disabled. To reenable a location, assign it a valid e-mail domain.
Step 6	voicemail phone-prefix digit-string   se-10-0-0-0(config-location)# voicemail phone-prefix 484	(Optional) Configures the phone number prefix that is added to an extension to create a VPIM address for a subscriber at the location. A prefix is required only if an e-mail domain services multiple locations and extensions between the locations are not unique. Valid values: 1 to 15 digits. Default value: empty. To delete a phone prefix, use the no form of this command.
Step 7	voicemail extension-length {number | min number max number}   se-10-0-0-0(config-location)# voicemail extension-length 8   se-10-0-0-0(config-location)# voicemail extension-length min 5 max 9	(Optional) Configures the voice mail extension length for the location. number—Configures the number of digits contained in extensions at the location. max number—Sets the minimum number of digits for extensions. Default value: 2. min number—Sets the maximum number of digits for extensions. Default value: 15. To remove the configuration for the number of digits for extensions, use the no form of this command.
Step 8	voicemail vpim-encoding {dynamic | G711ulaw | G726}   se-10-0-0-0(config-location)# voicemail vpim-encoding G711ulaw	(Optional) Configures the encoding method used to transfer voice-mail messages to this location. dynamic—Cisco Unity Express negotiates with the location to determine the encoding method G711ulaw—Cisco Unity Express always sends messages as G711 mu-law.wav files. Set this only if the receiving system supports G711 mu-law encoding (such as Cisco Unity). G726—Cisco Unity Express always sends messages as G726 (32K ADPCM). Use for low-bandwidth connections or when the system to which Cisco Unity Express is connecting does not support G711 u-law. Default value: dynamic. To return to the default value for encoding, use the no or default form of this command.
Step 9	voicemail spoken-name   se-10-0-0-0(config-location)# voicemail spoken-name	(Optional) Enables sending the spoken name of the voice-mail originator as part of the message. If the spoken name is sent, it is played as the first part of the received message. Default: enabled. To disable sending the spoken name, use the no form of this command.
Step 10	voicemail secure-messaging   se-10-0-0-0(config-location)# voicemail secure-messaging	(Optional) Enables secure messaging for all incoming messages to the network location.
Step 11	end   se-10-0-0-0(config-location)# end	Exits location configuration mode.
Step 12	network local location id number   se-10-0-0-0(config)# network local location id 1	Enables networking for the local Cisco Unity Express system identified by the location ID number. To delete the local location, use the no form of this command. Caution If you delete the local network location and then save your configuration, when you reload Cisco Unity Express, the local network location will remain disabled. After Cisco Unity Express restarts, reenter the network local location id command to reenable networking at this location.
Step 13	exit   se-10-0-0-0(config)# exit	Exits configuration mode.
Step 14	show network locations   se-10-0-0-0# show network locations	(Optional) Displays the location ID, name, abbreviation, and domain name for each configured Cisco Unity Express location.
Step 15	show network detail location id number   se-10-0-0-0# show network detail location id 9	(Optional) Displays network information for the specified location ID, including the number of messages sent and received.
Step 16	show network detail local   se-10-0-0-0# show network detail local	(Optional) Displays network information for the local Cisco Unity Express location, including the number of messages sent and received.
Step 17	show network queues   se-10-0-0-0# show network queues	(Optional) Displays information about messages in the outgoing queue that are to be sent from this Cisco Unity Express system. The queue information contains three displays: one for urgent job queue information, one for normal job queue information, and one for running job information.

Examples

The following examples illustrate the output from the show network commands on company Mycompany’s call control system in San Jose with remote voice-mail provided by six remote Cisco Unity Express sites.

The following example illustrates output from the show network queues command. The output includes the following fields:

• ID—Job ID.
• Retry—Number of times that Cisco Unity Express has tried to send this job to the remote location.
• Time—Time when the job will be resent.

SUMMARY STEPS

1. config t

2. network location id location-id

3. no enable

4. y

5. end

6. exit

DETAILED STEPS

Examples

The following example displays the details for network location 15 with networking disabled:

The following example re-establishes voice-mail transmission to and from network location 15.

Required Data for This Procedure

• Network location ID
• URL of the file with the recorded spoken name on the server
• Login and password to the server

Downloading the Location Spoken Name

To download the network location spoken name, use the following command in Cisco Unity Express EXEC mode:

network copy spokenname url url location id location-id loginname server-login password server-password

where the command arguments are defined as:

The following example uploads the spoken name file rename.wav for location 500:

Uploading the Location Spoken Name

To upload the network location spoken name, use the following command in Cisco Unity Express EXEC mode:

network copy spokenname location id location-id url url loginname server-login password server-password

where the command arguments are defined as:

The following example uploads the spoken name file rename.wav for location 500:

Configuring the Local Directory with Remote Subscribers

Configuring remote subscribers requires the following procedures:

• Configuring the local system for networking.

CLI commands exist to configure the local and remote sites in the system. GUI screens are available to configure the location parameters.

• Configuring vCard information on the local system.

See the chapter Configuring a Location with vCard Information for that procedure.

• Adding the remote subscriber information to the local directory.

This section describes this procedure.

• Adding a spoken name and location for the remote subscriber.

The administrator uses the TUI to record a spoken name for the remote subscriber and a spoken name for the remote location.

Configuring the remote subscriber can be done in the Cisco Unity Express configuration mode and the EXEC mode. Both modes permit adding the remote subscriber to the local directory but have different capabilities for other subscriber information. Use the remote username location command once, in either mode, to associate the remote subscriber with a network location.

Configuration Mode

Use this Cisco Unity Express configuration mode procedure to configure remote subscribers on the local system.

Required Data for This Procedure

The following information is required to configure remote subscribers on the local system:

• Remote username
• Remote subscriber’s extension number
• Remote location ID

SUMMARY STEPS

1. config t

2. remote username username location location-id create

3. remote username username phonenumber extension-number

4. exit

DETAILED STEPS

EXEC Mode

Use this Cisco Unity Express EXEC mode procedure to configure remote subscribers on the local system.

Required Data for This Procedure

The following information is required to configure remote subscribers on the local system:

• Remote username
• Remote location ID
• Remote subscriber’s first name, last name, and full name for display purposes

SUMMARY STEPS

1. remote username username location location-id create

2. remote username username fullname display display-name

3. remote username username fullname first first-name

4. remote username username fullname last last-name

DETAILED STEPS

Examples

The following example configures several remote subscribers.

Displaying Remote Subscribers

Several commands are available to display remote subscribers.

Displaying All Remote Subscribers

The following command displays all remote subscribers configured on the local system:

show remote users

The output for this command may appear similar to the following:

Displaying a Specific Remote Subscriber

The following command displays the details for a specific remote subscriber:

show remote user detail username username

where username is the specific remote subscriber.

The output for this command may appear similar to the following:

Deleting Remote Subscriber Information

Several commands are available to delete remote subscriber information from the local directory.

Deleting an Extension Number

The following configuration mode command deletes a remote subscriber’s extension number:

no remote username username phonenumber extension-number

where username is the name of the remote subscriber and extension-number is the remote subscriber’s extension.

The following example deletes extension 75555 from remote subscriber User 2:

Deleting a Remote Subscriber Entry in Local Directory

The following EXEC mode command deletes the remote subscriber from the local directory:

remote username username delete

where username is the name of the remote subscriber.

The following example deletes the remote subscriber User 2:

Deleting a Remote Username

The following EXEC mode commands delete the remote subscriber’s name:

no remote username username fullname display display-name

no remote username username fullname first first-name

no remote username username fullname last last-name

where username is the name of the remote subscriber, display-name is the remote subscriber’s display name, first-name is the remote subscriber’s first name, and last-name is the remote subscriber’s last name.

The following example deletes the display name from remote subscriber User 2:

The following example deletes the first name from remote subscriber User 2:

The following example deletes the last name from remote subscriber User 2:

Required Data for This Procedure

• Username
• URL of the file with the recorded spoken name on the server
• Login and password to the server

Downloading the Remote Subscriber Spoken Name

To download the remote subscriber spoken name, use the following command in Cisco Unity Express EXEC mode:

remote copy spokenname url url username username loginname server-login password server-password

where the command arguments are defined as:

The following example uploads the spoken name file user1.wav for remote subscriber user1:

Uploading the Remote Subscriber Spoken Name

To upload the network location spoken name, use the following command in Cisco Unity Express EXEC mode:

remote copy spokenname url url username username loginname server-login password server-password

where the command arguments are defined as:

The following example uploads the spoken name file user1.wav for remote subscriber user1:

Enabling and Disabling vCard Information

The remote location numeric ID is required to enable the location to receive vCard information.

The system default is to send the vCard information.

SUMMARY STEPS

1. config t

2. network location id location-id

3. voicemail vcard

4. end

5. exit

DETAILED STEPS

Examples

The following example enables receipt of vCard information to network locations 23 and nyc:

The following command disables receipt of vCard information to network location nyc:

Displaying vCard Status

Several commands are available to display vCard status.

Displaying vCard Status For a Specific Location

The following Cisco Unity Express EXEC mode command displays details about a specific remote location:

show network detail location id location-id

where location-id is the remote location number.

The following example displays details about network location 15, which has vCard enabled:

Displaying vCard Status For the Local System

The following EXEC mode command displays details for the local Cisco Unity Express system:

show network detail local

The following example displays details for the local system with vCard enabled:

Enabling and Disabling the LRU Cache

Use the following Cisco Unity Express configuration mode command to enable the LRU cache on the local system:

remote cache enable

The following example illustrates enabling the LRU cache on the local system:

Use the following Cisco Unity Express configuration mode command to disable the LRU cache on the local system. Disabling the cache clears all cache entries and prevents storage of new subscriber entries.

no remote cache enable

The following example illustrates disabling the LRU cache on the local system:

Displaying LRU Cache Data

Use the following Cisco Unity Express EXEC mode command to display the local system’s LRU cache data:

show remote cache

The system displays the location ID, location name, extension, and last accessed time for each cached user.

Required Data for This Procedure

• Network location ID
• Network location VPIM ID

SUMMARY STEPS

1. config t

2. network location id location-id

3. voicemail broadcast vpim-id vpim-id

4. end

5. exit

DETAILED STEPS

Examples

The following example sets the VPIM ID to ny-270 for network location 150:

SUMMARY STEPS

1. trace networking smtp [ all | receive | send | work ]

2. trace networking vpim [all | receive | send]

3. trace networking sysdb [all]

4. trace networking dns [all]

5. trace networking database [ all | connection | execute | garbage | largeobject | mgmt | query | results | transaction ]

6. trace networking jobqueue [all | job number]

DETAILED STEPS