-
Cisco Unity Express Command Reference for 3.0 and Later Versions
-
Using Cisco Unity Express Software
-
Cisco Unity Express Commands: A
-
Cisco Unity Express Commands: B
-
Cisco Unity Express Commands: C
-
Cisco Unity Express Commands: D
-
Cisco Unity Express Commands: E
-
Cisco Unity Express Commands: F
-
Cisco Unity Express Commands: G
-
Cisco Unity Express Commands: H
-
Cisco Unity Express Commands: I
-
Cisco Unity Express Commands: K
-
Cisco Unity Express Commands: L
-
Cisco Unity Express Commands: M
-
Cisco Unity Express Commands: N
-
Cisco Unity Express Commands: O
-
Cisco Unity Express Commands: P
-
Cisco Unity Express Commands: R
-
Cisco Unity Express Commands: script (ccn application) to show ccn trigger sip
-
Cisco Unity Express Commands: show clock detail to show remote users
-
Cisco Unity Express Commands: show restore history to system shutdown (aaa accounting enable)
-
Cisco Unity Express Commands: T
-
Cisco Unity Express Commands: U
-
Cisco Unity Express Commands: V
-
Cisco Unity Express Commands: W
-
Cisco Unity Express Commands: X
-
Cisco Unity Express Commands: Z
-
Index
-
Feedback
Table Of Contents
license activate timecardview users
license activate voicemail mailboxes
license agent default authenticate
locale (ccn trigger http)-IVR Only
login-fail (aaa accounting event)
L
Last Updated: June 4, 2010
license activate timecardview users
license activate voicemail mailboxes
license agent default authenticate
locale (ccn trigger http)-IVR Only
login-fail (aaa accounting event)
license activate ivr sessions
To activate the license for IVR sessions, use the license activate ivr sessions command in Cisco Unity Express EXEC mode. Using the no form of this command sets the usage to zero and disables the feature.
license activate ivr sessions numeric string
no license activate ivr sessions numeric string
Syntax Description
Command Default
None.
Command Modes
Cisco Unity Express EXEC
Command History
Usage Guidelines
This command enables you to activate the license for IVR sessions.
Examples
The following example shows how to activate the license for IVR sessions:
se-10-0-0-0# license activate ivr sessions 4
Related Commands
license activate ports
To activate the license for ports, use the license activate ports command in Cisco Unity Express EXEC mode. Using the no form of this command sets the usage to zero and disables the feature.
license activate ports numeric string
no license activate ports numeric string
Syntax Description
numeric string
Specifies the number of ports to be activated.The value must be a value that is less than or equal to the number of ports supported by this platform, and it must be a multiple of two.
Command Default
None.
Command Modes
Cisco Unity Express EXEC
Command History
Usage Guidelines
This command enables you to activate the license for ports.
Examples
The following example shows how to activate the license for ports:
se-10-0-0-0# license activate ports 4Related Commands
license activate timecardview users
To activate the license for TimeCardView users, use the license activate timecardview command in Cisco Unity Express EXEC mode. Using the no form of this command sets the usage to zero and disables the feature.
license activate timecardview users numeric string
no license activate timecardview users numeric string
Syntax Description
numeric string
Specifies the number of TimeCardView users to be activated. The value must be a value that is less than or equal to the number of TimeCardView users supported by this platform.
Command Default
None.
Command Modes
Cisco Unity Express EXEC
Command History
Usage Guidelines
This command enables you to activate the license for TimeCardView users.
Examples
The following example shows how to activate the license for TimeCardView users:
se-10-0-0-0# license activate timecardview users 4
Related Commands
license activate voicemail mailboxes
To activate the license for voicemail mailboxes, use the license activate voicemail mailboxes command in Cisco Unity Express EXEC mode. Using the no form of this command sets the voicemail mailboxes value to zero and disables the voicemail mailboxes.
license activate voicemail mailboxes numeric string
no license activate voicemail mailboxes numeric string
Syntax Description
Command Default
None.
Command Modes
Cisco Unity Express EXEC
Command History
Usage Guidelines
This command enables you to activate the license for voicemail mailboxes.
Examples
The following example shows how to activate the license for voicemail mailboxes:
se-10-0-0-0# license activate voicemail mailboxes 275
Evaluation licenses are being activated in the device for the following feature(s):Feature Name: VMIVR-VM-MBXPLEASE READ THE FOLLOWING TERMS CAREFULLY. INSTALLING THE LICENSE ORLICENSE KEY PROVIDED FOR ANY CISCO PRODUCT FEATURE OR USING SUCHPRODUCT FEATURE CONSTITUTES YOUR FULL ACCEPTANCE OF THE FOLLOWINGTERMS. YOU MUST NOT PROCEED FURTHER IF YOU ARE NOT WILLING TO BE BOUNDBOUND BY ALL THE TERMS SET FORTH HEREIN.You hereby acknowledge and agree that the product feature licenseis terminable and that the product feature enabled by such licensemay be shut down or terminated by Cisco after expiration of theapplicable term of the license (e.g., 30-day trial period). Ciscoreserves the right to terminate or shut down any such product featureelectronically or by any other means available. While alerts or suchmessages may be provided, it is your sole responsibility to monitoryour terminable usage of any product feature enabled by the licenseand to ensure that your systems and networks are prepared for the shutdown of the product feature. You acknowledge and agree that Cisco willnot have any liability whatsoever for any damages, including, but notlimited to, direct, indirect, special, or consequential damages relatedto any product feature being shutdown or terminated. By clicking the"accept" button or typing "yes" you are indicating you have read andagree to be bound by all the terms provided herein.ACCEPT? [y/n]? yesLicense activation count saved for use at next reload
Related Commands
license agent default authenticate
To configure the default license agent, use the license agent default authenticate command in Cisco Unity Express configuration mode. Use the no form of this command to remove the configuration.
license agent default authenticate [none]
no license agent default authenticate [none]
Syntax Description
Command Default
None.
Command Modes
Cisco Unity Express Configuration
Command History
Usage Guidelines
This command starts the default license agent. The authenticate option specifies if the authentication is required. The default license agent starts automatically when the device boots up.
Examples
The following example shows how to configure the license agent:
se-10-0-0-0(config)# license agent default authenticate
Related Commands
Configures the license agent listener.
Limits the total number of license agent sessions.
Defines a transport notification.
license agent listener http
To configure the license agent in listener mode, use the license agent listener http command in Cisco Unity Express configuration mode. Use the no form of this command to remove the configuration.
Cisco Unity Express 8.0.1 and earlier:
license agent listener http [crypto | plaintext] url-path authenticate [none] [max-message size]
no license agent listener http [crypto | plaintext] url-path authenticate [none] [max-message size]
Cisco Unity Express 8.0.2 and later:
license agent listener http [encrypted | plaintext] url-path authenticate [none] [max-message size]
no license agent listener http [encrypted | plaintext] url-path authenticate [none] [max-message size]
Syntax Description
Command Default
None.
Command Modes
Cisco Unity Express Configuration
Command History
7.1
This command was introduced.
8.0.2
The crypto keyword was replaced by the keyword encrypted.
Usage Guidelines
This command starts the license agent in listener mode. The options specifies if you need to use the https or http service, listener's URL, and authentication.
Examples
The following example shows how to authenticate the license agent using the http crypto authentication mechanism:
se-10-0-0-0(config)# license agent listener http crypto path authenticate
Related Commands
Authenticates the license agent by using the default HTTP mechanism.
Limits the total number of license agent sessions.
Defines a transport notification.
license agent max-sessions
To configure the maximum number of HTTP sessions to license agent, use the license agent max-sessions command in Cisco Unity Express configuration mode. Use the no form of this command to remove the configuration.
license agent max-sessions number
no license agent max-sessions number
Syntax Description
Command Default
None.
Command Modes
Cisco Unity Express Configuration
Command History
Usage Guidelines
This commands enables you to configure the maximum number of HTTP sessions. The range is from 4 to 25.
Examples
The following example shows how to configure the maximum number of HTTP sessions:
se-10-0-0-0(config)# license agent max-sessions 5
Related Commands
Authenticates the license agent by using the default HTTP mechanism.
Limits the total number of license agent sessions.
Defines a transport notification.
license agent notify
To use a notification transport, use the license agent notify command in Cisco Unity Express configuration mode. Use the no form of this command to remove the configuration.
license agent notify URL
no license agent notify URL
Syntax Description
Command Default
None.
Command Modes
Cisco Unity Express Configuration
Command History
Usage Guidelines
This commands enables you to use a notification transport. When you access or modify a license, an event will be triggered. Information concerning this event is sent as a notification. Some examples of the notifications are:
•
License installed
•
•
•
•
•
•
•
•
Examples
The following example shows how to configure the notification transport:
se-10-0-0-0(config)# license agent notify http://10.86.26.95/abc ?
credentials Credentials String
username Login name
se-10-0-0-0(config)# license agent notify http://10.86.26.95/abc username anonymous password guest
se-10-0-0-0(config)# end
The following example shows the output show run | include license command
se-10-0-0-0# show run | include license
license agent max-sessions 9
license agent notify http://10.86.26.95/abc credentials hidden 6u/dKTN/hsHQZ6vnngB74bKLbOxLrFmfSd8ZZNgd+Y9J3xlk2B35j0nfGWTYHfmPSd8ZZNgd+Y9J3xlk2B35j0nfGW TYHfmPSd8ZZNgd+Y9J3xlk2B35j0nfGWTYHfmP
Authenticates the license agent by using the default HTTP mechanism.
Limits the total number of license agent sessions.
license clear
To remove one or more licenses information from your device, use the license clear feature command in Cisco Unity Express EXEC mode.
license clear feature name
Syntax Description
Command Default
None.
Command Modes
Cisco Unity Express EXEC
Command History
Usage Guidelines
This command enables you to remove the license entry from your device.
Examples
The following example shows how to clear the license for a feature:
se-10-0-0-0# license clear TCV-USER
Feature: TCV-USER
1 License Type: Evaluation
License State: Active, Not in Use, EULA accepted
Evaluation total period: 4 weeks 2 days
Evaluation period left: 4 weeks 2 days
License Addition: Additive
License Count: 2
Comment:
Store Index: 4
Store Name: Primary License Storage
Are you sure you want to clear? (yes/[no]): yes
Note
Related Commands
Adds or deletes a comment for a specific license.
Modifies the license priority information.
license comment
To add or delete a comment for a specific license, use the license comment command in Cisco Unity Express EXEC mode.
license comment {add | delete} feature name comment string
Syntax Description
add
Adds the comment to the feature.
delete
Deletes the comment from the feature.
feature name
Specifies the feature name.
comment string
Specifies a text description of the comment string.
Command Default
None.
Command Modes
Cisco Unity Express EXEC
Command History
Usage Guidelines
This command enables you to add or delete comments for a specific license line. This can be done only for the installed licenses.
Examples
The following example adds a comment to the license:
se-10-0-0-0# license comment add TCV-USER test
Feature: TCV-USER
1 License Type: Evaluation
License State: Active, Not in Use, EULA accept
Evaluation total period: 4 weeks 2 days
Evaluation period left: 4 weeks 2 days
License Addition: Additive
License Count: 2
Comment:
Store Index: 4
Store Name: Primary License Storage
% Success: Adding comment "test" succeeded
Related Commands
Clears the license information from your system.
Modifies the license priority information.
license install
To install the licenses, use the license install command in Cisco Unity Express EXEC mode.
license install URL
Syntax Description
Command Default
None.
Command Modes
Cisco Unity Express EXEC
Command History
Usage Guidelines
This commands enables you to install the license stored in a license file.
Examples
The following example shows how to install the license for a feature:
se-10-0-0-0# license install ftp://192.1.1.53/lic/nme-159/nme-159.lic
Installing...Feature:VMIVR-IVR-SESS...Successful:Supported
License Note:
Application will evaluate this change upon next reload
Installing...Feature:VMIVR-VM-MBX...Successful:Supported
License Note:
Application will evaluate this change upon next reload
Installing...Feature:TCV-USER...Successful:Supported
License Note:
Application will evaluate this change upon next reload
Installing...Feature:VMIVR-PORT...Successful:Supported
License Note:
Application will evaluate this change upon next reload
4/4 licenses were successfully installed
0/4 licenses were existing licenses
0/4 licenses were failed to install
The installation process does not install duplicate licenses. The following message is displayed when duplicate licenses are detected:
Installing...Feature:xxx-xxx-xxx...Skipped:Duplicate
Related Commands
license modify priority
To modify the license priority information, use the license modify priority command in Cisco Unity Express EXEC mode.
license modify priority feature name {high | low}
Syntax Description
Command Default
None.
Command Modes
Cisco Unity Express EXEC
Command History
Usage Guidelines
This commands enables you to modify the license priority level. This command lists all the expiring licenses that are available for the specified feature and you can change the priority level to be the highest for the selected license.
Examples
The following example shows how to change the license priority level:
se-10-0-0-0# license modify priority TCV-USER high
Feature: TCV-USER
Index: 1 License type : Evaluation
Lock type : Locked
License Count : 2
License Priority: Low
Are you sure you want to modify priority? (yes/[no]): yes
Note
Related Commands
Revokes the license.
Saves the license and device credential information.
Displays the summary of all of the licenses installed.
Displays the details of the installed license.
license revoke
To revoke the license, use the license revoke command in Cisco Unity Express EXEC mode.
license revoke URL URL
Syntax Description
URL
Specifies the URL path for the permission ticket file.
URL
Specifies the URL path for the destination to rehost ticket file
Command Default
None.
Command Modes
Cisco Unity Express EXEC
Command History
Usage Guidelines
This command enables you to revoke the license. Rehost operation has multiple steps, which helps in moving a license from Source device (X) to a Target device (Y).
To revoke the license, perform the following steps:
1.
2.
3.
4.
For example, permanent licenses of 225 count exist for MBX feature. Now permission ticket of 100 count is obtained from SWIFT to revoke 100 count out of 225 counts.
After installing the 225 count Grace (Extension) license, the remaining count of 125 count permanent license is installed as part of revoke operation.
Examples
The following example shows how to revoke the licenses:
se-10-0-0-0# show lic de VMIVR-VM-MBX
Feature: VMIVR-VM-MBX Period left: Life time
Index: 1 Feature: VMIVR-VM-MBX Version: 1.0
License Type: Permanent
License State: Active, In Use
License Count: 225 /100
License Priority: Medium
Store Index: 3
Store Name: Primary License Storage
Index: 2 Feature: VMIVR-VM-MBX Version: 1.0
License Type: Evaluation
License State: Inactive
Evaluation total period: 8 weeks 4 days
Evaluation period left: 8 weeks 4 days
License Count: 600 / 0
License Priority: None
Store Index: 0
Store Name: Evaluation License Storage
se-10-0-0-0# license revoke ?
URL URL of the permission ticket
se-10-0-0-0# license revoke ftp://10.xx.xx.195/LIC-FILES/VEGA/FHH12460003_100-MBX.lic-PT ?
URL URL destination for rehost ticket
se-10-0-0-0# license revoke ftp://10.xx.xx.195/LIC-FILES/VEGA/FHH12460003_100-MBX.lic-PT ftp://10.1.1.1/permissionticketfile-100MBX
Following Permanent license(s) will be installed on this device
Feature Name: VMIVR-VM-MBX :Count = 125
Following Extension license(s) will be installed on this device
Feature Name: VMIVR-VM-MBX :Count = 225
Following Permanent license(s) will be revoked from this device
Feature Name: VMIVR-VM-MBX :Count = 225
PLEASE READ THE FOLLOWING TERMS CAREFULLY. INSTALLING THE LICENSE OR
LICENSE KEY PROVIDED FOR ANY CISCO PRODUCT FEATURE OR USING SUCH
PRODUCT FEATURE CONSTITUTES YOUR FULL ACCEPTANCE OF THE FOLLOWING
TERMS. YOU MUST NOT PROCEED FURTHER IF YOU ARE NOT WILLING TO BE BOUND
BOUND BY ALL THE TERMS SET FORTH HEREIN.
You hereby acknowledge and agree that the product feature license
is terminable and that the product feature enabled by such license
may be shut down or terminated by Cisco after expiration of the
applicable term of the license (e.g., 30-day trial period). Cisco
reserves the right to terminate or shut down any such product feature
electronically or by any other means available. While alerts or such
messages may be provided, it is your sole responsibility to monitor
your terminable usage of any product feature enabled by the license
and to ensure that your systems and networks are prepared for the shut
down of the product feature. You acknowledge and agree that Cisco will
not have any liability whatsoever for any damages, including, but not
limited to, direct, indirect, special, or consequential damages related
to any product feature being shutdown or terminated. By clicking the
"accept" button or typing "yes" you are indicating you have read and
agree to be bound by all the terms provided herein.
ACCEPT? [yes/no]: yes
License Note:
Application will evaluate this change upon next reload
Application will evaluate this change upon next reload
Rehost ticket saved ..... to ftp://10.1.1.1/permissionticketfile-100MBX
se-10-0-0-0# reload
vega# show license detail VMIVR-VM-MBX
Feature: VMIVR-VM-MBX Period left: Life time
Index: 1 Feature: VMIVR-VM-MBX Version: 1.0
License Type: Permanent
License State: Active, In Use
License Count: 125 /125
License Priority: Medium
Store Index: 0
Store Name: Primary License Storage
Index: 2 Feature: VMIVR-VM-MBX Version: 1.0
License Type: Evaluation
License State: Inactive
Evaluation total period: 8 weeks 4 days
Evaluation period left: 8 weeks 4 days
License Count: 225 / 0
License Priority: Low
Store Index: 4
Store Name: Primary License Storage
Index: 3 Feature: VMIVR-VM-MBX Version: 1.0
License Type: Evaluation
License State: Inactive
Evaluation total period: 8 weeks 4 days
Evaluation period left: 8 weeks 4 days
License Count: 600 / 0
License Priority: Low
Store Index: 0
Store Name: Evaluation License Storage
Related Commands
license save
To save a copy of the all the licenses installed, use the license save command in Cisco Unity Express EXEC mode.
license save {credential | URL} URL
Syntax Description
credential
Saves the device credential information.
URL
Defines the URL destination path for the license file.
URL
Defines the URL destination path for saving the device credential information.
Command Default
None.
Command Modes
Cisco Unity Express EXEC
Command History
Usage Guidelines
The command enables you to saves a copy of the all the licenses installed in the license storage to a specified file. These licenses include all node locked licenses which are installed on a device and it does not include the evaluation licenses
Examples
The following example shows how to save the license installed on your device:
se-10-0-0-0# license save credential ftp://anonymous:guest@10.86.26.195/NME-CredentialDevice credential saved ..... to ftp://anonymous:guest@10.86.26.195/NME-Credentialse-10-0-0-0# license save ftp://anonymous:guest@10.86.26.195/License-Copylicense lines saved ..... to ftp://anonymous:guest@10.86.26.195/License-CopyRelated Commands
Revokes the license.
Clears the license information from your system.
Displays a summary of all of the licenses installed.
Displays the details of the installed license.
line console
To enter config-line submode and specify whether the console connection is subject to authentication, use the line console command in Cisco Unity Express configuration mode.
line console
Syntax Description
This command has no arguments or keywords.
Defaults
None.
Command Modes
Cisco Unity Express configuration (config)
Command History
Usage Guidelines
After you enter config-line submode, the only property that you can configure is whether the console connection is subject to authentication. To do this, enter the login command.
If authentication is not enabled for the console connection, any user logging into the system through the console is given the superuser privilege and is not required to provide a username or password.
Examples
The following example enables authentication for the console:
se-10-0-0-0# config tse-10-0-0-0(config)# line consolese-10-0-0-0(config-line)# loginRelated Commands
list name
To create a public distribution list, use the list name command in Cisco Unity Express configuration mode. This command does not have a no form.
list name list-name number list-number create
Syntax Description
Defaults
The system creates the everyone list with number 999 to contain everyone on the system.
Command Modes
Cisco Unity Express configuration
Command History
Usage Guidelines
Each list must have a unique name or number.
The system supports a maximum of 15 public lists.
A list number can match the subscriber's or general delivery mailbox (GDM) telephone number but must not match another local public list number.
The system automatically assigns 9999 to the default everyone public list. An administrator can change this number using the GUI menu option Voice Mail > Distribution Lists > Public Lists. The 9999 number cannot be changed using TUI options or CLI commands.
A local subscriber cannot modify a remote distribution list and cannot use a remote distribution list as the recipient of a voice message.
Note
Examples
The following example creates public distribution list number 12 for designers:
se-10-0-0-0# config tse-10-0-0-0(config)# list name designers number 12 createse-10-0-0-0(config)# exitRelated Commands
list number
To add a nonsubscriber as a member of a distribution list, use the list member command in Cisco Unity Express configuration mode. Use the no form of the command to remove the member.
list number list-number member member-number type non-subscriber
no list number list-number membermember-number type non-subscriber
Syntax Description
list-number
ID number of the distribution list.
member-number
ID number of the non-subscriber to associate the distribution list.
Defaults
None.
Command Modes
Cisco Unity Express configuration
Command History
Usage Guidelines
After this command is executed, the system verifies that the number satisfies the rules of the restriction table.If the restriction table does not match, it returns an error saying that "the number entered is restricted."
If this command is entered and the restriction table is later updated to not allow the new entry, the number added to the distribution list will not be removed. However, when a new message is addressed using the list with the now restricted non-subscriber number, the system will prevent the message from being sent to the restricted number in the distribution list. All other addresses contained in the distribution list that are not restricted will have the message delivered to them.
Examples
The following example adds a member with number 12 to distribution list number 7215551413:
se-10-0-0-0# config tse-10-0-0-0 (config)# list number 12 member 7215551413 type nonsubscribertype non-subscriberse-10-0-0-0 (config)# exitRelated Commands
list number delete
To delete a public distribution list from the local system, use the list number delete command in Cisco Unity Express configuration mode. This command does not have a no form.
list number list-number delete
Syntax Description
Defaults
No list number is deleted.
Command Modes
Cisco Unity Express configuration
Command History
Usage Guidelines
An error message appears if the list does not exist.
A local subscriber or administrator cannot delete a public distribution list at a remote site.
Note
Examples
The following example deletes list number 35:
se-10-0-0-0# config tse-10-0-0-0(config)# list number 35 deletese-10-0-0-0(config)# exitRelated Commands
list number description
To add a description to a public distribution list, use the list number description command in Cisco Unity Express configuration command. To delete the description, use the no form of this command.
list number list-number description description
no list number list-number description description
Syntax Description
Defaults
No description is defined.
Command Modes
Cisco Unity Express configuration
Command History
Usage Guidelines
An error message appears if the list does not exist.
Note
Examples
The following example assigns a description to list number 35:
se-10-0-0-0# config tse-10-0-0-0(config)# list number 35 description "SJC Engineers"se-10-0-0-0(config)# exitRelated Commands
list number member
To add members to a public distribution list, use the list number member command in Cisco Unity Express configuration mode. To delete the member from the list, use the no form of this command.
list number list-number member {member-name | extension}
type {group | user | gdm | list | remote | blind}no list number list-number member {member-name | extension}
type {group | user | gdm | list | remote | blind}Syntax Description
Defaults
No list members are configured.
Command Modes
Cisco Unity Express configuration
Command History
Usage Guidelines
An error message appears if the member name or extension does not exist. Additionally, the system verifies that the public list has members. If the list is empty, the system plays a prompt indicating that the list contains no members and does not allow the list to be used as a recipient of the message.
The maximum number of public list members is 1000 for the system. An error message appears if a new member would exceed the maximum.
A remote subscriber that is statically configured on the local system can be a member of a distribution list. However, that remote subscriber cannot own a distribution list on the local system.
A private list cannot be a member of a public list.
Recursive distribution lists are permitted; for example, list A can be a member of list B and list B can be a member of list A.
To use a blind address, specify the location ID and extension of the blind address. The system verifies the location ID and extension length.
Note
Examples
The following example assigns members to list number 35:
se-10-0-0-0# config tse-10-0-0-0(config)# list number 35 member user2 type userse-10-0-0-0(config)# list number 35 member user7 type userse-10-0-0-0(config)# list number 35 member supervisors type groupse-10-0-0-0(config)# list number 35 member sales type gdmse-10-0-0-0(config)# list number 35 member project3 type listse-10-0-0-0(config)# list number 35 member user4 type remotese-10-0-0-0(config)# list number 35 member nyc72222 type blindse-10-0-0-0(config)# exitThe following examples delete members from list number 35:
se-10-0-0-0# config tse-10-0-0-0(config)# no list number 35 member user2 type userse-10-0-0-0(config)# no list number 35 member sales type gdmse-10-0-0-0(config)# exitRelated Commands
list number owner
To assign an owner to a public distribution list, use the list number owner command in Cisco Unity Express configuration mode. To delete the list owner, use the no form of this command.
list number list-number owner owner-ID
no list number list-number owner owner-ID
Syntax Description
list-number
Number of the list. Valid public list numbers can have up to 15 digits.
owner-ID
Name of the list owner.
Defaults
No list number or list owner is configured.
Command Modes
Cisco Unity Express configuration
Command History
Usage Guidelines
The list owner can be a local subscriber or a local group. If the owner is a group, all the members of the group are owners of the list. The default list everyone cannot have an owner.
The list owner can edit and delete members of the list and can assign other owners to the list.
An error message appears if the list number or list owner does not exist.
The maximum number of owners on the system is 50. An error message appears if a new owner ID would exceed the maximum number of list owners.
Members of the Administrators group are implicit owners of all public distribution lists and can edit any public list at any time. If all the owners of a list are deleted, the Administrator group continues to have ownership of the list.
The owner of a public or private distribution list can record a spoken name for the list using the TUI. The default everyone public list has a spoken name by default. An administrator can change this name using the TUI.
Note
Examples
The following example assigns user2 as the owner of list number 35:
se-10-0-0-0# config tse-10-0-0-0(config)# list number 35 owner user2se-10-0-0-0(config)# exitThe following example deletes the owner of list 35:
se-10-0-0-0# config tse-10-0-0-0(config)# no list number 35 owner user2se-10-0-0-0(config)# exitRelated Commands
locale (ccn trigger http)-IVR Only
To specify the language to use for the prompts that the caller hears when a Cisco Unity Express IVR HTTP-based trigger is activated, use the locale command in Cisco Unity Express IVR HTTP trigger configuration mode. Use the no form of this command to set the language to the systemDefault.
locale xx_YY
no locale
Syntax Description
xx_YY
Specifies the language used for the prompts heard by the caller. Cisco Unity Express supports several languages but only one language can be used for all triggers on the system. See Release Notes for Cisco Unity Express for the current list of supported languages.
Command Default
The default locale is systemDefault.
Command Modes
Cisco Unity Express IVR HTTP trigger configuration
Command History
Examples
The following example sets the trigger language to US English:
se-10-0-0-0# config t
se-10-0-0-0(config)# ccn trigger http urlname myhttpapp
Adding new trigger
se-10-0-0-0(config-trigger)# locale en_USse-10-0-0-0(config-trigger)# end
se-10-0-0-0(config)# exitThe following example sets the trigger language to the default (systemDefault):
se-10-0-0-0# config t
se-10-0-0-0(config)# ccn trigger http urlname myhttpapp
Adding new trigger
se-10-0-0-0(config-trigger)# no localese-10-0-0-0(config-trigger)# end
se-10-0-0-0(config)# exitRelated Commands
Displays the trigger and application settings. Use the show ccn trigger http command option to display the Cisco Unity Express IVR HTTP-based trigger settings.
locale (ccn trigger jtapi)
To specify the language used for the prompts that are heard by the caller when a JTAPI trigger is activated, use the locale command in Cisco Unity Express CCN configuration trigger mode. To set the language to the system default, use the no form of this command.
locale xx_YY
no locale
Syntax Description
xx_YY
Specifies the language used for the prompts heard by the caller. Cisco Unity Express supports several languages but only one language can be used for all triggers on the system. See Release Notes for Cisco Unity Express for the current list of supported languages.
Defaults
U.S. English
Command Modes
CCN configuration trigger
Command History
Examples
The following example sets the trigger language to French.
se-10-0-0-0# config t
se-10-0-0-0(config)# ccn trigger jtapi phonenumber 1234
se-10-0-0-0(config-trigger)# locale fr_FRse-10-0-0-0(config-trigger)# end
se-10-0-0-0(config)# exitRelated Commands
locale (ccn trigger sip)
To specify the language used for the SIP system prompts that are heard by the caller when a SIP trigger is activated, use the locale command in Cisco Unity Express CCN configuration trigger mode. To set the language to the system defaults, use the no form of this command.
locale xx_YY
no locale
Syntax Description
xx_YY
Specifies the language used for the prompts heard by the caller. Cisco Unity Express supports several languages but only one language can be used for all triggers on the system. See Release Notes for Cisco Unity Express for the current list of supported languages.
Defaults
U.S. English
Command Modes
CCN configuration trigger
Command History
Examples
The following example sets the trigger language to French.
se-10-0-0-0# config t
se-10-0-0-0(config)# ccn trigger sip phonenumber 1234
se-10-0-0-0(config-trigger)# locale fr_FRse-10-0-0-0(config-trigger)# end
se-10-0-0-0(config)# exitRelated Commands
log console
To configure the types of messages to be displayed on the console, use the log console command in Cisco Unity Express configuration mode. To stop messages from displaying, use the no form of this command.
log console {errors | info | warning}
no log console {errors | info | warning}
Caution
Syntax Description
Defaults
Only fatal error messages are displayed.
Command Modes
Cisco Unity Express configuration
Command History
Usage Guidelines
The messages on the console display are also saved in the messages.log file. These messages can be used for debugging purposes.
Examples
The following example configures error messages to be displayed on the console:
se-10-0-0-0# config tse-10-0-0-0(config)# log console errorsse-10-0-0-0(config)# exitRelated Commands
log console monitor
To display system messages on the console, use the log console monitor command in Cisco Unity Express configuration mode. To stop messages from displaying, use the no form of this command.
log console monitor {module | entity | activity}
no log console monitor {module | entity | activity}
Caution
Syntax Description
module
Cisco Unity Express modules.
entity
Cisco Unity Express module entities.
activity
Cisco Unity Express entity actions.
Defaults
Only fatal error messages are displayed.
Command Modes
Cisco Unity Express EXEC
Command History
Usage Guidelines
The messages on the console monitor are also saved in the messages.log file. These messages can be used for debugging purposes.
Examples
The following example displays messages for results of the database entity in the networking module:
se-10-0-0-0# log console monitor networking database resultsRelated Commands
log server
To configure an external server for saving log messages, use the log server command in Cisco Unity Express configuration mode. To delete the log server, use the no form of this command.
log server address {ip-address | hostname}
no log server address {ip-address | hostname}
Syntax Description
address ip-address
IP address of the external log server.
address hostname
Hostname of the external log server.
Defaults
No external log server is configured. The local hard disk is used for saving log messages.
Command Modes
Cisco Unity Express configuration
Command History
Usage Guidelines
An external log server contains a copy of the messages.log file that is stored on the hard disk of the router that contains the Cisco Unity Express module. Copying the file to a server permits flexibility in viewing, printing, and troubleshooting system messages.
Examples
The following example assigns 10.1.61.16 as the external log server:
se-10-0-0-0# config tse-10-0-0-0(config)# log server address 10.1.61.16se-10-0-0-0(config)# exitRelated Commands
log trace boot
To save the trace configuration upon rebooting, use the log trace boot command in Cisco Unity Express EXEC mode.
log trace boot
Syntax Description
This command has no arguments or keywords.
Command Modes
Cisco Unity Express EXEC
Command History
Usage Guidelines
The current trace configuration is lost upon reboot because tracing is CPU intensive. To ensure that the current trace configuration is saved when the CUE module is rebooted, use the log trace boot command.
Examples
The following example illustrates the log trace boot command:
se-10-0-0-0# log trace bootRelated Commands
log trace buffer save
To save the current trace information, use the log trace buffer save command in Cisco Unity Express EXEC mode. To turnoff the log trace, use the no form of this command.
log trace buffer save
no log trace buffer
Syntax Description
This command has no arguments or keywords.
Command Modes
Cisco Unity Express EXEC
Command History
Usage Guidelines
Current trace information stored in the memory buffer can be saved to a file. The file created with the log trace buffer save command is atrace_save.log.
Examples
The following example illustrates the log trace buffer save command:
se-10-0-0-0# log trace buffer saveRelated Commands
Displays a list of the trace logs.
Displays the modules and entities being traced.
login (aaa accounting event)
To enable or disable the logging of login events, use the login command in Cisco Unity Express AAA accounting event configuration mode. Use the no form of this command to disable the logging of login events. Use the default form of this command to restore the default setting (the logging of login events is enabled).
login
no login
default login
Syntax Description
This command has no arguments or keywords.
Command Default
The logging of login events is enabled.
Command Modes
Cisco Unity Express AAA accounting event configuration (aaa-accounting-event)
Command History
Usage Guidelines
This command enables the logging of all forms of system access except IMAP, including access to the CLI, GUI, TUI, and VVE, when a login is required. This command does not enable the logging of failed login attempts.
Examples
The following example disables the logging of login events:
se-10-0-0-0# config t
se-10-0-0-0(config)# aaa accounting event
se-10-0-0-0(aaa-accounting-event)# no loginRelated Commands
login (config-line)
To specify whether the console connection is subject to authentication, use the login command in Cisco Unity Express line configuration mode. Use the no or default form of this command to disable console authentication.
login
no login
default login
Syntax Description
This command has no arguments or keywords.
Defaults
There is no console authentication
Command Modes
Cisco Unity Express line configuration (config-line)
Command History
Usage Guidelines
To configure whether the console connection is subject to authentication, you must first enter the line console command and then the login command.
If authentication is not enabled for console connection, any user logging into the system through the console is given the superuser privilege and is not required to provide a username or password.
Examples
The following example enables authentication for the console:
se-10-0-0-0# config tse-10-0-0-0(config)# line consolese-10-0-0-0(config-line)# loginRelated Commands
login-fail (aaa accounting event)
To enable or disable the logging of failed login attempts, use the login-fail command in Cisco Unity Express AAA accounting event configuration mode. Use the no form of this command to disable the logging of failed login attempts. Use the default form of this command to restore the default setting (the logging of failed login attempts is enabled).
login-fail
no login-fail
default login-fail
Syntax Description
This command has no arguments or keywords.
Command Default
The logging of failed login attempts is enabled.
Command Modes
Cisco Unity Express AAA accounting event configuration (aaa-accounting-event)
Command History
Usage Guidelines
This command enables the logging of failed login attempts for all forms of system access except IMAP, including access to the CLI, GUI, TUI, and VVE, when a login is required.
Examples
The following example disables the logging of failed login attempts:
se-10-0-0-0# config t
se-10-0-0-0(config)# aaa accounting event
se-10-0-0-0(aaa-accounting-event)# no login-failRelated Commands
login pinless
To configure pin login behavior for the mailbox, use the login pinless command in Cisco Unity Express config-mailbox mode. Use the no or default version to return to the default setting, requiring callers to enter a PIN to access their mailbox.
login pinless {subscriber-phones | any-phone}
no login pinless
Syntax Description
Defaults
Callers must enter a PIN to access their mailbox.
Command Modes
Cisco Unity Express config-mailbox
Command History
Usage Guidelines
By default, a PIN is required to access voice mailboxes. You must configure this command to allow PINless access.
When you allow a caller to PINless access the voice mailbox from any phone configured for the mailbox owner, this includes access from the subscriber's configured extension, E.164 number, or fax numbers. Any callers not originating from one of these sources ware required to enter a PIN to gain access to the voice mailbox with this configuration.
This command is valid only for personal mailboxes. You cannot use this command to configure a GDM to use PINless login.
The following example allows callers to access their voice mailbox from any phone configured for the mailbox owner without entering a PIN:
se-10-0-0-0# config tse-10-0-0-0(config)# voice mailbox owner user4se-10-0-0-0(config-mailbox)# login pinless subscriber-phonesse-10-0-0-0(config-mailbox)# exitRelated Commands
logout (aaa accounting event)
To enable or disable the logging of logout events, use the logout command in Cisco Unity Express AAA accounting event configuration mode. Use the no form of this command to disable the logging of logout events. Use the default form of this command to restore the default setting (the logging of logout events is enabled).
logout
no logout
default logout
Syntax Description
This command has no arguments or keywords.
Command Default
The logging of logout events is enabled.
Command Modes
Cisco Unity Express AAA accounting event configuration (aaa-accounting-event)
Command History
Usage Guidelines
This command enables the logging of all forms of system access except IMAP, including access to the CLI, GUI, TUI, and VVE, when a login is required before logout.
Examples
The following example disables the logging of logout events:
se-10-0-0-0# config t
se-10-0-0-0(config)# aaa accounting event
se-10-0-0-0(aaa-accounting-event)# no logoutRelated Commands
