Cisco Unity Express 2.0 Command Reference
V

Table Of Contents

V

voice mailbox owner

voice mailbox unlock

voicemail capacity time

voicemail default

voicemail extension-length (network location id)

voicemail operator telephone

voicemail phone-prefix (network location id)

voicemail recording time

voicemail spoken-name (network location id)

voicemail vpim-encoding (network location id)


V


voice mailbox owner

voice mailbox unlock

voicemail capacity time

voicemail default

voicemail extension-length (network location id)

voicemail operator telephone

voicemail phone-prefix (network location id)

voicemail recording time

voicemail spoken-name (network location id)

voicemail vpim-encoding (network location id)

voice mailbox owner

To create a mailbox for a user or a group, use the voice mailbox owner command in Cisco Unity Express configuration mode. This command initiates the mailbox configuration mode for mailbox subcommands.

voice mailbox owner name [size seconds]

Mailbox configuration mode:
default
description
"text"
disable
expiration time
greeting [alternate | standard]
mailboxsize mailbox-size-seconds
messagesize message-size-seconds
no parameter
tutorial [disabled | enabled]

Syntax Description

name

Name of the mailbox owner.

size seconds

(Optional) Storage size of the mailbox, in seconds. This is the same value as mailboxsize.

default

Sets mailbox parameters to the system default values.

description "text"

Specifies a text description of the mailbox. The text must be enclosed in double quotes (" ").

disable

Deactivates the mailbox so that no members can access the voice messages.

expiration time

Specifies the length of time in days that messages can be stored in the mailbox.

greeting [alternate | standard]

Specifies which greeting a caller hears when reaching the mailbox.

mailboxsize mailbox-size-seconds

Specifies the storage size of the mailbox, in seconds. This is the same value as for the size keyword.

messagesize message-size-seconds

Specifies the maximum length in seconds of a message that can be stored in the mailbox.

no parameter

Deletes the configuration of a specific parameter value.

tutorial [disabled | enabled]

Specifies whether the tutorial should be played. The default is enabled.


Defaults

expiration: system-wide value
mailboxsize: system-wide value
messagesize: system-wide value
tutorial: enabled

Command Modes

Cisco Unity Express configuration

Command History

Cisco Unity Express Release
Modification

1.0

This command was introduced on the Cisco Unity Express network module and in Cisco CallManager Express 3.0.

1.1

This command was implemented on the advanced integration module (AIM) and in Cisco CallManager 3.3(3).

1.1.2

This command was implemented on the Cisco 2800 series and Cisco 3800 series routers.


Usage Guidelines

If the name value refers to a user, this command creates a personal mailbox. If the name value refers to a group, the command creates a general delivery mailbox that several users and other groups can access.

The users and groups must be configured before assigning them to a mailbox.

The mailbox owner records a standard greeting and an alternate, if needed, from the telephone user interface (TUI). If the mailbox owner has not recorded any greetings for the mailbox, Cisco Unity Express uses a default greeting.

The mailbox-size-seconds and message-size-seconds values depend on the number of mailboxes to be created and the storage capacity of the voice-mail system. Some mailboxes may need to be larger than others to accommodate more or longer messages. For example, a customer service department may need a larger mailbox to accommodate messages from customers. Consider the purpose of the mailbox when assigning its size and message length.

The sequence in which the parameters are configured is optional.

Examples

The following example shows a mailbox created for a user:

se-10-0-0-0# config t
se-10-0-0-0(config)# voice mailbox owner user7
se-10-0-0-0(config-mailbox)# description "User 7's mailbox"
se-10-0-0-0(config-mailbox)# greeting standard
se-10-0-0-0(config-mailbox)# mailboxsize 360
se-10-0-0-0(config-mailbox)# messagesize 150
se-10-0-0-0(config-mailbox)# expiration 21
se-10-0-0-0(config-mailbox)# tutorial disabled
se-10-0-0-0(config-mailbox)# exit
se-10-0-0-0(config)# 

Related Commands

Command
Description

groupname

Configures a Cisco Unity Express group.

show voicemail

Displays the properties of a voice mailbox.

username

Configures a Cisco Unity Express user.

voicemail default

Configures system-wide default voice mailbox values.


voice mailbox unlock

To unlock a voice mailbox, use the voice mailbox unlock command in Cisco Unity Express EXEC mode.

voice mailbox unlock {owner name | telephonenumber tel-number}

Syntax Description

owner name

Name of the mailbox owner. For a general delivery mailbox, this must be the owner's name, not a group member's name.

telephonenumber tel-number

Telephone number assigned to the mailbox.


Command Modes

Cisco Unity Express EXEC

Command History

Cisco Unity Express Release
Modification

1.0

This command was introduced on the Cisco Unity Express network module and in Cisco CallManager Express 3.0.

1.1

This command was implemented on the advanced integration module (AIM) and in Cisco CallManager 3.3(3).

1.1.2

This command was implemented on the Cisco 2800 series and Cisco 3800 series routers.


Usage Guidelines

When a mailbox becomes locked, the owner hears a message stating that the mailbox is unavailable.

Examples

The following example unlocks an individual mailbox:

se-10-0-0-0> enable
se-10-0-0-0# voice mailbox unlock owner user3

The following example unlocks a general delivery mailbox:

se-10-0-0-0> enable
se-10-0-0-0# voice mailbox unlock owner sales

The following example unlocks a mailbox using an extension number:

se-10-0-0-0> enable
se-10-0-0-0# voice mailbox unlock telephonenumber 61122

Related Commands

Command
Description

show voicemail

Displays the properties of a configured mailbox.

voice mailbox owner

Configures a mailbox.


voicemail capacity time

To specify the maximum storage space, in minutes, for all recorded messages and greetings, use the voicemail capacity time command in Cisco Unity Express configuration mode.

voicemail capacity time minutes

Syntax Description

minutes

Total storage time, in minutes, for all recorded messages and greetings in the voice-mail system.


Defaults

The default storage time is determined by the license.

Command Modes

Cisco Unity Express configuration

Command History

Cisco Unity Express Release
Modification

1.0

This command was introduced on the Cisco Unity Express network module and in Cisco CallManager Express 3.0.

1.1

This command was implemented on the advanced integration module (AIM) and in Cisco CallManager 3.3(3).

1.1.2

This command was implemented on the Cisco 2800 series and Cisco 3800 series routers.


Usage Guidelines

This command sets the maximum storage time for all recorded voice-mail messages and greetings. The maximum value permitted is determined by the capacity of your Cisco Unity Express module.

Examples

The following example sets the total capacity for all recorded voice-mail messages and greetings to 100 hours (6000 minutes):

se-10-0-0-0# config t
se-10-0-0-0(config)# voicemail capacity time 6000

Related Commands

Command
Description

voicemail default

Configures voicemail parameters.

voicemail operator telephone

Creates an operator mailbox.

show voicemail

Displays the voicemail limits.


voicemail default

To assign default values for all new mailboxes, use the voicemail default command in Cisco Unity Express configuration mode.

voicemail default {expiration days | language xx_YY | mailboxsize mailbox-size-seconds |
messagesize message-size-seconds}

Syntax Description

expiration days

Sets the number of days a message can be stored in a mailbox before the voice-mail system deletes it.

language xx_YY

Specifies the language used for voice-mail prompts on the local Cisco Unity Express system. Release 2.0 supports one default language enabled on the system. Valid values are:

en_EN (U.S. English)

de_DE (German)

fr_FR (European French)

es_ES (European Spanish).

mailboxsize mailbox-size-seconds

Sets the maximum number of seconds for storing messages in a mailbox.

messagesize message-size-seconds

Sets the maximum number of seconds for a caller's message stored in a mailbox.


Defaults

language: installed language

Command Modes

Cisco Unity Express configuration

Command History

Cisco Unity Express Release
Modification

1.0

This command was introduced on the Cisco Unity Express network module and in Cisco CallManager Express 3.0.

1.1

This command was implemented on the advanced integration module (AIM) and in Cisco CallManager 3.3(3).

1.1.2

This command was implemented on the Cisco 2800 series and Cisco 3800 series routers.

2.0

The language option was expanded to include languages other than U.S. English.


Usage Guidelines

This command assigns default values for new individual and general delivery mailboxes. These values can be configured later to other values for specific users or mailboxes.

Examples

The following example sets the default values for new mailboxes:

se-10-0-0-0> enable
se-10-0-0-0# config t
se-10-0-0-0(config)# voicemail default expiration 30
se-10-0-0-0(config)# voicemail default mailboxsize 360
se-10-0-0-0(config)# voicemail default messagesize 90
se-10-0-0-0(config)# voicemail default language de_DE

Related Commands

Command
Description

voicemail capacity time

Configures the maximum storage capacity for the voice-mail system.

voicemail operator telephone

Creates an operator mailbox.


voicemail extension-length (network location id)

To configure the number of digits contained in extensions at a network location, use the voicemail extension-length command in Cisco Unity Express location configuration mode. To remove the configuration for the number of digits for extensions, use the no form of this command.

voicemail extension-length [number | max number | min number]

no voicemail extension-length

Syntax Description

number

(Optional) Configures the number of digits contained in extensions at the location.

max number

(Optional) Sets the maximum number of digits for extensions.

min number

(Optional) Sets the minimum number of digits for extensions.


Defaults

The default minimum number of digits for extensions is 2, and the default maximum number of digits for extensions is 15.

Command Modes

Cisco Unity Express location configuration

Command History

Release
Modification

2.0

This command was introduced.


Usage Guidelines

Use this command to configure the number of digits. To specify a set number of digits, use the voicemail extension-length number command. If you want to specify a maximum and minimum value for the digits, use the max and min keywords.

Examples

The following example configures the voice-mail extension length to be 6 digits:

se-10-0-0-0# config t
se-10-0-0-0(config)# network location id 9
se-10-0-0-0(config-location)# voicemail extension-length 6 

The following example configures the voice-mail extension maximum length to be 7 digits:

se-10-0-0-0# config t
se-10-0-0-0(config)# network location id 9
se-10-0-0-0(config-location)# voicemail extension-length max 7

Related Commands

Command
Description

show network detail location id

Displays the configuration of a specific location.


voicemail operator telephone

To assign an extension as the voice-mail operator, use the voicemail operator telephone command in Cisco Unity Express configuration mode.

voicemail operator telephone tel-number

Syntax Description

tel-number

Extension of the voice-mail operator.


Command Modes

Cisco Unity Express configuration

Command History

Cisco Unity Express Release
Modification

1.0

This command was introduced on the Cisco Unity Express network module and in Cisco CallManager Express 3.0.

1.1

This command was implemented on the advanced integration module (AIM) and in Cisco CallManager 3.3(3).

1.1.2

This command was implemented on the Cisco 2800 series and Cisco 3800 series routers.


Usage Guidelines

A mailbox owner dials this extension while in the voice-mail system to reach the voice-mail operator. Do not assign this extension to a group.

This operator extension need not be the same as the auto-attendant operator extension. If they are the same, the voice-mail user who dials the operator extension while in voice mail reaches the auto-attendant menu and then presses "0" to get the operator.

Examples

The following example assigns extension 9000 as the voice-mail operator:

se-10-0-0-0# config t
se-10-0-0-0(config)# voicemail operator telephone 9000

Related Commands

Command
Description

show voicemail

Displays details about the voicemail configuration.


voicemail phone-prefix (network location id)

To configure a voice-mail phone number prefix for a network location, use the voicemail phone-prefix command in Cisco Unity Express location configuration mode. To delete a prefix, use the no form of this command.

voicemail phone-prefix number

no voicemail phone-prefix number

Syntax Description

number

Phone number prefix that is added to an extension to create a VPIM address for a user at the network location. Valid values: 1 to 15 digits.


Defaults

The default value is an empty string.

Command Modes

Cisco Unity Express location configuration

Command History

Release
Modification

2.0

This command was introduced.


Usage Guidelines

A prefix is required only if an e-mail domain services multiple locations, and extensions between the locations are not unique.

Examples

The following example shows a voicemail phone prefix of 345 assigned to network location 484:

se-10-0-0-0(config)# network location id 484
se-10-0-0-0(config-location)# voicemail phone-prefix 345
se-10-0-0-0(config-location)# 

Related Commands

Command
Description

show network detail location id

Displays details about a specific network location.


voicemail recording time

To specify the maximum recording length for any message or greeting, use the voicemail recording time command in Cisco Unity Express configuration mode.

voicemail recording time minutes

Syntax Description

minutes

Maximum length in minutes, for any recorded message or greeting in the voice-mail system.


Command Modes

Cisco Unity Express configuration

Command History

Cisco Unity Express Release
Modification

1.0

This command was introduced on the Cisco Unity Express network module and in Cisco CallManager Express 3.0.

1.1

This command was implemented on the advanced integration module (AIM) and in Cisco CallManager 3.3(3).

1.1.2

This command was implemented on the Cisco 2800 series and Cisco 3800 series routers.


Usage Guidelines

This command sets the maximum length for any recorded voice-mail message and greeting. The maximum value permitted is determined by the capacity of your Cisco Unity Express module.

Examples

The following example sets the maximum recording time for any message or greeting to 15 minutes:

se-10-0-0-0# config t
se-10-0-0-0(config)# voicemail recording time 15

Related Commands

Command
Description

show voicemail

Displays system voicemail details.


voicemail spoken-name (network location id)

To enable sending the spoken name of the voice-mail originator as part of a voice-mail message, use the voicemail spoken-name command in location configuration mode. To disable sending the spoken name, use the no form of this command.

voicemail spoken-name

no voicemail spoken-name

Syntax Description

This command has no arguments or keywords.

Defaults

Enabled

Command Modes

Cisco Unity Express location configuration

Command History

Release
Modification

2.0

This command was introduced.


Usage Guidelines

If spoken name sending is enabled, the recorded name of the originating user is played as the first part of the received message.

Examples

The following example shows spoken name enabled for a location:

se-10-0-0-0# config t
se-10-0-0-0(config)# network location id 9
se-10-0-0-0(config-location)# voicemail spoken-name

Related Commands

Command
Description

show network detail location id

Displays configuration details for a network location.


voicemail vpim-encoding (network location id)

To configure the encoding method used to transfer voice-mail messages from the Cisco Unity Express location to other locations, use the voicemail vpim-encoding command in Cisco Unity Express location configuration mode. To return to the default method of encoding (dynamic), use the no form of this command.

voicemail vpim-encoding {dynamic | G711ulaw | G726}

no voicemail vpim-encoding

Syntax Description

dynamic

The Cisco Unity Express location negotiates with the remote location to determine the encoding method.

G711ulaw

Cisco Unity Express always sends messages as G711 u-law .wav files.

G726

Cisco Unity Express always sends messages as G726 (32K ADPCM).


Defaults

dynamic

Command Modes

Cisco Unity Express location configuration

Command History

Release
Modification

2.0

This command was introduced.


Usage Guidelines

Use G711 u-law only if the receiving system supports G711 u-law encoding (such as Cisco Unity). Use G726 for low-bandwidth connections or when the system to which Cisco Unity Express is connecting does not support G711 u-law.

Examples

The following example shows VPIM encoding set to G711 u-law for network location 9:

se-10-0-0-0# config t
se-10-0-0-0(config)# network location id 9
se-10-0-0-0(config-location)# voicemail vpim-encoding g711ulaw

Related Commands

Command
Description

show network detail location id

Displays configuration details for a network location.