Table Of Contents
username (gateway configuration)
username notification cascade-to after
username profile (phone devices)
U
Last Updated: June 21, 2007
username (gateway configuration)
username notification cascade-to after
username profile (phone devices)
username (configuration)
To configure a Cisco Unity Express subscriber, use the username command in either Cisco Unity Express EXEC mode or configuration mode.
EXEC Mode
username name [create | delete | faxnumber entension fullname [first "first" | last "last-name" | display "full-name"] | group group-name | language xx_YY | password "password" | pin number]
Configuration Mode
username name [password "password" | phonenumber phonenumber |
phonenumberE164 full-number | pin number]Syntax Description
name
Specifies the name or ID of the subscriber to be created. The username must be at least 3 and no more than 32 characters in length. Cisco Unity Express allows only letters, numbers, underscore (_), dot (.), and dash (-) in user IDs. User IDs must start with a letter. Do not use spaces in the username.
create
(Optional) Creates a subscriber with no other information.
delete
(Optional) Deletes the subscriber.
faxnumber extension
Assigns the specified fax number to the user. In case of a single DID, there is no need to configure this number.
fullname first "first"
(Optional) First name of the subscriber. The name must be entered in double quotes (" ").
fullname last "last-name"
(Optional) Last name of the subscriber. The name must be entered in double quotes (" ").
fullname display "full-name"
(Optional) Name as the subscriber wants it to appear on other telephone displays. The name must be entered in double quotes (" ").
group group-name
(Optional) Group with which this subscriber is associated. If the group-name value does not exist, this command creates it.
language xx_YY
(Optional) Language of the prompt. See Release Notes for Cisco Unity Express 2.3 for a list of supported languages.
password "password"
(Optional) Password for the subscriber. The password must be entered in double quotes (" "). Valid values contain at least 3 but not more than 32 characters in length. Spaces are not allowed. Acceptable password characters are lowercase letters a to z, uppercase letters A to Z, digits 0 to 9, and the following symbols: - , . + = _ ! @ # $ ^ * ( ) ? / ~ < > & %.
phonenumber phonenumber
(Optional) Extension or number for this subscriber.
phonenumberE164 full-number
(Optional) Full telephone number, including area code, for the subscriber.
pin number
(Optional) Personal identification number for the subscriber. Valid values are at least 3 but not more than 19 characters in length, consisting of letters and numbers. No other characters are permitted.
Command Default
language: U.S. English
Command Modes
Cisco Unity Express EXEC
Cisco Unity Express configurationCommand History
Usage Guidelines
The EXEC version of the command stores the permitted information in Cisco Unity Express flash memory. If a problem with the disk occurs, this information is available so that the subscriber may access the voice-mail system.
The configuration version of the command is stored in the Cisco Unity Express system configuration file. If a power outage or a system shutdown occurs, the subscriber information can be retrieved.
Examples
The following example creates a subscriber user1, assigns her as a member to the Sales group, and assigns the extension 0190, a password, and a PIN.
se-10-0-0-0# username user1 fullname display "User 1"se-10-0-0-0# username user1 faxnumber 0100se-10-0-0-0# username user1 group Salesse-10-0-0-0# username user1 password "sales123"se-10-0-0-0# username user1 pin 4122se-10-0-0-0# config tse-10-0-0-0(config)# username user1 phonenumber 50190se-10-0-0-0(config)# username user1 phonenumberE164 12225550190se-10-0-0-0(config)# endse-10-0-0-0# show user detail username user1Full Name: User 1First Name:Last Name: user1Nickname: user1Phone: 50190Phone(E.164): 12225550190Language: en_ENUse-10-0-0-0#Related Commands
Command DescriptionDisplays the configured groups.
Displays details for a specific subscriber.
Displays a list of all usernames.
username (gateway configuration)
To specify the username and password used when attempting to register with the messaging gateway, use the username command in Cisco Unity Express gateway configuration mode. Use the no form of the command to negate the username configured for the messaging gateway registration.
username text {password {text | encrytped} password} [retry-interval integer]
no username text
Syntax Description
Command Modes
Cisco Unity Express gateway configuration
Command History
Usage Guidelines
This command specifies the username used to register to either the primary or secondary messaging gateway. You can also optionally specify a retry interval. The default retry interval is five minutes.
Examples
The following example specifies the username for registration to the primary messaging gateway:
se-10-0-0-0# config tse-10-0-0-0(config)# messaging-gateway primary 59000 192.0.2.24se-10-0-0-0(config-gateway)# username cue31 password pass31 retry-interval 20Status : Registered (Tue Aug 21 17:09:08 PDT 2006)Reg-expiration : Wed Aug 22 17:09:08 PDT 2006Location-id : 1234Reg-id : 1234Reg-password : (Not displayed)Retry-interval : 10 minute(s)Related Commands
username generate
To generate a temporary password or PIN for a subscriber, use the username generate command in Cisco Unity Express EXEC mode.
username username generate {password | pin}
Syntax Description
Defaults
Password and PIN are blank.
Command Modes
Cisco Unity Express EXEC
Command History
Usage Guidelines
To display the generated password or PIN, use the show user auth username username command.
The subscriber must change this password or PIN after logging in to the GUI or TUI.
Examples
The following example generates a temporary password and PIN for user5:
se-10-0-0-0# username user5 generate passwordse-10-0-0-0# username user5 generate pinse-10-0-0-0# show user auth username user5Password: rfg889920Pin: 7850Related Commands
Command Descriptionshow user auth username
Displays the authentication information (password and PIN) for the subscriber.
username notification cascade-to after
To define a rule for cascading a notification, use the username notification cascade-to after command in Cisco Unity Express EXEC mode. Use the no form of this command to remove the rule and disable cascading to the specified user.
username user-id notification cascade-to uid after minutes
no username user-id notification cascade-to uid after minutes
Syntax Description
Command Default
There are no notification cascading rules defined for the subscriber.
Command Modes
Cisco Unity Express EXEC
Command History
Usage Guidelines
Use the username notification cascade-to after command in Cisco Unity Express configuration mode to define:
•The user for whom notification cascading is being configured.
•The user to whom cascaded notification is being sent.
•The amount of time after which the notification cascade occurs.
An error message appears when:
•The specified user or profile does not exist on the local system.
•The user exists but a rule is already defined to cascade to that user.
•The user does not have a mailbox.
•The user cannot define a rule to cascade notification to himself.
•The maximum number of users have already been configured for cascading.
•The time is outside the allowed range.
•The time is within the allowed range, but a rule is already defined to cascade notification at that time.
Examples
The following example define a rule to cascade notification from user22 to user 42 after 10 minutes:
se-10-0-0-0# username user22 notification cascade-to user42 after 10Related Commands
username profile (phone devices)
To configure a subscriber's cell phone for message notification, use the username profile (phone devices) command in Cisco Unity Express EXEC mode. To remove or deactivate a parameter from the cell phone, use the no or default form of this command.
username username profile vm-notif-profile {cell-phone | home-phone | work-phone}
{enable
extra-digits digits
phonenumber phonenumber
preference {all | urgent}
schedule day day-of-week active from hh:mm to hh:mm}no username username profile vm-notif-profile {cell-phone | home-phone | work-phone}
{enable
extra-digits digits
phonenumber phonenumber
preference {all | urgent}
schedule day day-of-week active from hh:mm to hh:mm}default username username profile vm-notif-profile {cell-phone | home-phone | work-phone} preference {all | urgent}
Syntax Description
Defaults
Cell phone notifications are disabled.
Default preference is urgent.Command Modes
Cisco Unity Express EXEC
Command History
Usage Guidelines
The system creates one default notification profile with the filename vm-notif-profile per subscriber. This filename cannot be changed.
Repeat the command with the schedule parameter to configure more than one time slot. This parameter changes only the specified time slots; the configuration for the other time slots is not changed.
An error message appears for the following conditions:
•The subscriber does not exist in the system.
•The subscriber does not have a mailbox.
•phonenumber is a restricted number.
•More than 64 digits are entered for digits.
•A valid phone number is not assigned to the device.
•The administrator has disabled message notification on a system-wide basis.
•The system-wide notification preference is set to urgent and an attempt is made to set this subscriber's preference to all.
•The schedule start time is later than the schedule end time.
Using the no or default form of this command results in the following conditions:
•no username username profile vm-notif-profile {cell-phone | home-phone | work-phone} enable disables the sending of notifications to the device.
•no username username profile vm-notif-profile {cell-phone | home-phone | work-phone} extra-digits removes the extra digits assigned to the device.
•no username username profile vm-notif-profile {cell-phone | home-phone | work-phone} phonenumber removes the phone number from the device and automatically disables the device.
•no (or default) username username profile vm-notif-profile {cell-phone | home-phone | work-phone} preference sets the notification preference to urgent.
•no username username profile vm-notif-profile {cell-phone | home-phone | work-phone} schedule day day-of-week active from hh:mm to hh:mm deactivates the sending of notifications for the specified time slot.
Examples
The following example configures the cell phone for subscriber user3:
se-10-0-0-0# username user3 profile vm-notif-profile cell-phone phonenumber 12225550150se-10-0-0-0# username user3 profile vm-notif-profile cell-phone enablese-10-0-0-0# username user3 profile vm-notif-profile cell-phone extra-digits 9se-10-0-0-0# username user3 profile vm-notif-profile cell-phone allse-10-0-0-0# username user3 profile vm-notif-profile cell-phone schedule day 2 active from 08:00 to 17:00se-10-0-0-0# username user3 profile vm-notif-profile cell-phone schedule day 3 active from 08:00 to 12:00se-10-0-0-0# username user3 profile vm-notif-profile cell-phone schedule day 4 active from 13:00 to 16:00se-10-0-0-0# username user3 profile vm-notif-profile cell-phone schedule day 5 active from 08:00 to 14:00se-10-0-0-0# username user3 profile vm-notif-profile cell-phone schedule day 6 active from 08:00 to 17:00Related Commands
username profile email
To configure a subscriber's e-mail for message notification, use the username profile email command in Cisco Unity Express EXEC mode. To remove or deactivate a parameter from the e-mail device, use the no or default form of this command.
username username profile vm-notif-profile email
{address email-address
attach
enable
preference {all | urgent}
schedule day day-of-week active from hh:mm to hh:mm
text email-text}no username username profile vm-notif-profile email
{address email-address
attach
enable
preference {all | urgent}
schedule day day-of-week active from hh:mm to hh:mm
text email-text}default username username profile vm-notif-profile email attach
default username username profile vm-notif-profile email preference {all | urgent}
Syntax Description
Defaults
E-mail notifications are disabled.
E-mail attachments are disabled.
Default preference is urgent.Command Modes
Cisco Unity Express EXEC
Command History
Usage Guidelines
The system creates one default notification profile with the filename vm-notif-profile per subscriber. This filename cannot be changed.
Repeat the command with the schedule parameter to configure more than one time slot. This parameter changes only the specified time slots; the configuration for the other time slots is not changed.
An error message appears for the following conditions:
•The subscriber does not exist in the system.
•The subscriber does not have a mailbox.
•The administrator has disabled message notification on a system-wide basis.
•The administrator has disabled e-mail attachments on a system-wide basis.
•E-mail is enabled before the e-mail address is defined.
•E-mail is enabled and an SMTP server is not configured.
•The system-wide notification preference is set to urgent and an attempt is made to set this subscriber's preference to all.
•The schedule start time is later than the schedule end time.
•E-mail text contains a question mark (?).
•E-mail text is longer than 128 characters.
Using the no or default form of this command results in the following conditions:
•no username username profile vm-notif-profile email enable disables the sending of notifications to the device.
•no username username profile vm-notif-profile email address email-address removes the email address assigned to the device and automatically disables the device.
•no (or default) username username profile vm-notif-profile email attach disables attaching voice messages to outgoing e-mail notifications for this device.
•no (or default) username username profile vm-notif-profile email preference sets the notification preference to urgent.
•no username username profile vm-notif-profile email schedule day day-of-week active from hh:mm to hh:mm deactivates the sending of notifications for the specified time slot.
•no username username profile vm-notif-profile email text removes the text associated with this device.
Examples
The following example configures the cell phone for subscriber user3:
se-10-0-0-0# username user3 profile vm-notif-profile email address user1@company.comse-10-0-0-0# username user3 profile vm-notif-profile email enablese-10-0-0-0# username user3 profile vm-notif-profile email attachse-10-0-0-0# username user3 profile vm-notif-profile email allse-10-0-0-0# username user3 profile vm-notif-profile email schedule day 3 active from 08:00 to 10:00se-10-0-0-0# username user3 profile vm-notif-profile email text "Sales meeting scheduled in main office conference room C 1:00-3:00 p.m. 4/19/06"Related Commands
username profile num-pager
To configure a subscriber's numeric pager for message notification, use the username profile num-pager command in Cisco Unity Express EXEC mode. To remove or deactivate a parameter from the home phone, use the no or default form of this command.
username username profile vm-notif-profile num-pager
{enable
extra-digits digits
phonenumber phonenumber
preference {all | urgent}
schedule day day-of-week active from hh:mm to hh:mm}no username username profile vm-notif-profile num-pager
{enable
extra-digits digits
phonenumber phonenumber
preference {all | urgent}
schedule day day-of-week active from hh:mm to hh:mm}default username username profile vm-notif-profile num-pager preference {all | urgent}
Syntax Description
Defaults
Numeric pager notifications are disabled.
Default preference is urgent.Command Modes
Cisco Unity Express EXEC
Command History
Usage Guidelines
The system creates one default notification profile with the filename vm-notif-profile per subscriber. This filename cannot be changed.
Repeat the command with the schedule parameter to configure more than one time slot. This parameter changes only the specified time slots; the configuration for the other time slots is not changed.
An error message appears for the following conditions:
•The subscriber does not exist in the system.
•The subscriber does not have a mailbox.
•phonenumber is a restricted number.
•More than 64 digits are entered for digits.
•A valid phone number is not assigned to the device.
•The administrator has disabled message notification on a system-wide basis.
•The system-wide notification preference is set to urgent and an attempt is made to set this subscriber's preference to all.
•The schedule start time is later than the schedule end time.
Using the no or default form of this command results in the following conditions:
•no username username profile vm-notif-profile num-pager enable disables the sending of notifications to the device.
•no username username profile vm-notif-profile num-pager extra-digits removes the extra digits assigned to the device.
•no username username profile vm-notif-profile num-pager phonenumber removes the phone number from the device and automatically disables the device.
•no (or default) username username profile vm-notif-profile num-pager preference sets the notification preference to urgent.
•no username username profile vm-notif-profile num-pager schedule day day-of-week active from hh:mm to hh:mm deactivates the sending of notifications for the specified time slot.
Examples
The following example configures the cell phone for subscriber user3:
se-10-0-0-0# username user3 profile vm-notif-profile num-pager phonenumber 12225550150se-10-0-0-0# username user3 profile vm-notif-profile num-pager enablese-10-0-0-0# username user3 profile vm-notif-profile num-pager extra-digits 9se-10-0-0-0# username user3 profile vm-notif-profile num-pager allse-10-0-0-0# username user3 profile vm-notif-profile num-pager schedule day 2 active from 08:00 to 17:00se-10-0-0-0# username user3 profile vm-notif-profile num-pager schedule day 3 active from 08:00 to 12:00se-10-0-0-0# username user3 profile vm-notif-profile num-pager schedule day 4 active from 13:00 to 16:00se-10-0-0-0# username user3 profile vm-notif-profile num-pager schedule day 5 active from 08:00 to 14:00se-10-0-0-0# username user3 profile vm-notif-profile num-pager schedule day 6 active from 08:00 to 17:00Related Commands
username profile text-pager
To configure a subscriber's text pager for message notification, use the username profile text-pager command in Cisco Unity Express EXEC mode. To remove or deactivate a parameter from the text pager device, use the no or default form of this command.
username username profile vm-notif-profile text-pager
{address email-address
enable
preference {all | urgent}
schedule day day-of-week active from hh:mm to hh:mm
text email-text}no username username profile vm-notif-profile text-pager
{address email-address
enable
preference {all | urgent}
schedule day day-of-week active from hh:mm to hh:mm
text message-text}default username username profile vm-notif-profile text-pager preference {all | urgent}
Syntax Description
Defaults
Text pager notifications are disabled.
Default preference is urgent.Command Modes
Cisco Unity Express EXEC
Command History
Usage Guidelines
The system creates one default notification profile with the filename vm-notif-profile per subscriber. This filename cannot be changed.
Repeat the command with the schedule parameter to configure more than one time slot. This parameter changes only the specified time slots; the configuration for the other time slots is not changed.
An error message appears for the following conditions:
•The subscriber does not exist in the system.
•The subscriber does not have a mailbox.
•The administrator has disabled message notification on a system-wide basis.
•Text paging is enabled before the e-mail address is defined.
•Text paging is enabled and an SMTP server is not configured.
•The system-wide notification preference is set to urgent and an attempt is made to set this subscriber's preference to all.
•The schedule start time is later than the schedule end time.
•Message text contains a question mark (?).
•Message text is longer than 128 characters.
Using the no or default form of this command results in the following conditions:
•no username username profile vm-notif-profile text-pager enable disables the sending of notifications to the device.
•no username username profile vm-notif-profile text-pager address email-address removes the e-mail address assigned to the device and automatically disables the device.
•no (or default) username username profile vm-notif-profile text-pager preference sets the notification preference to urgent.
•no username username profile vm-notif-profile text-pager schedule day day-of-week active from hh:mm to hh:mm deactivates the sending of notifications for the specified time slot.
•no username username profile vm-notif-profile text-pager text removes the text associated with this device.
Examples
The following example configures the cell phone for subscriber user3:
se-10-0-0-0# username user3 profile vm-notif-profile text-pager address user1@company.comse-10-0-0-0# username user3 profile vm-notif-profile text-pager enablese-10-0-0-0# username user3 profile vm-notif-profile text-pager allse-10-0-0-0# username user3 profile vm-notif-profile text-pager schedule day 3 active from 08:00 to 10:00se-10-0-0-0# username user3 profile vm-notif-profile text-pager text "Sales meeting scheduled in main office conference room C 1:00-3:00 p.m. 4/19/06"Related Commands