Cisco Unity Express 2.3 Command Reference
D

Table Of Contents

D

default (ccn application)

default (ccn engine)

default (ccn trigger jtapi)

default (ccn trigger sip)

default ccm-manager (ccn subsystem jtapi)

default ctiport (ccn subsystem jtapi)

default gateway (ccn subsystem sip)

default security password length min

default security pin length min

description (ccn application)

dtmf-relay


D


Last Updated: May 1, 2006

default (ccn application)

default (ccn engine)

default (ccn trigger jtapi)

default (ccn trigger sip)

default ccm-manager (ccn subsystem jtapi)

default ctiport (ccn subsystem jtapi)

default gateway (ccn subsystem sip)

default security password length min

default security pin length min

description (ccn application)

dtmf-relay

default (ccn application)

To reset a CCN application parameter to its default value, use the default command in CCN application configuration mode.

default {description | enabled | maxsessions | parameter name}

Syntax Description

description

Sets the application description to the name of the application.

enabled

Enables the application.

maxsessions

Sets the maximum number of sessions to the port license number.

parameter name

Sets the parameter's value to the default set in the script.

Note Parameter names can be viewed using the show ccn application command.


Command Modes

CCN application configuration

Command History

Cisco Unity Express Release
Modification

1.0

This command was introduced on the Cisco Unity Express network module and in Cisco Unified Communications Manager Express 3.0.

1.1

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

1.1.2

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


Usage Guidelines

The default command sets a Cisco Unified Communication Network (CCN) application parameter to its default value.

Examples

The following example sets the maximum number of sessions to the port license number:

se-10-0-0-0# config t

se-10-0-0-0(config)# ccn application voicemail

se-10-0-0-0(config-application)# default maxsessions
se-10-0-0-0(config-application)# end
se-10-0-0-0(config)# exit

Related Commands

Command
Description

ccn application

Configures the CCN applications, such as voice mail and auto attendant.

ccn engine

Configures the parameters used by all CCN applications.

ccn trigger sip phonenumber

Configures CCN trigger values for the applications.

show ccn application

Displays all of the CCN application details.


default (ccn engine)

To set the upper limit on the number of steps executed in a CCN application to the default value, use the default command in CCN engine configuration mode.

default maxsteps

Syntax Description

maxsteps

Upper limit on the number of steps executed in a CCN application. The default is 1000.


Command Modes

CCN engine configuration mode

Command History

Cisco Unity Express Release
Modification

1.0

This command was introduced on the Cisco Unity Express network module and in Cisco Unified Communications Manager Express 3.0.

1.1

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

1.1.2

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


Examples

The following example resets the specified parameters to their factory values:

se-10-0-0-0# config t

se-10-0-0-0(config)# ccn engine

se-10-0-0-0(config-engine)# default maxsteps

se-10-0-0-0(config-engine)# end

se-10-0-0-0(config)# exit

Related Commands

Command
Description

ccn application

Configures the CCN applications, such as voice mail and auto attendant.

ccn engine

Configures the parameters used by all CCN applications.

ccn trigger sip phonenumber

Configures CCN trigger values for the applications.

show ccn engine

Displays the CCN engine information.


default (ccn trigger jtapi)

To reset a CCN JTAPI trigger parameter to its default value, use the default command in CCN trigger JTAPI configuration mode. To disable the trigger or to set the number of maxsessions to 0, use the no form of this command.

default {application | enabled | idletimeout | locale | maxsessions}

no default {enabled | maxsessions}

Syntax Description

application

Has no effect on the application.

enabled

Enables the trigger. Use the no form of this command to disable the trigger.

idletimeout

Sets the idle timeout to 10,000 seconds.

locale

Sets the locale to "systemDefault."

maxsessions

Sets the maximum number of sessions to the port license number. Use the no form of this command to set the number to 0.


Command Modes

CCN trigger JTAPI configuration

Command History

Cisco Unity Express Release
Modification

1.0

This command was introduced on the Cisco Unity Express network module and in Cisco Unified Communications Manager Express 3.0.

1.1

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

1.1.2

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


Examples

The following example sets the maximum number of sessions to the port license number:

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)# default maxsessions
se-10-0-0-0(config-trigger)# end
se-10-0-0-0(config)# exit

Related Commands

Command
Description

ccn application

Configures the CCN applications, such as voice mail and auto attendant.

ccn engine

Configures the parameters used by all CCN applications.

show ccn trigger

Displays all of the CCN application details.


default (ccn trigger sip)

To reset a CCN SIP trigger parameter to its default value, use the default command in CCN trigger SIP configuration mode. To disable the trigger or to set the number of maxsessions to 0, use the no form of this command.

default {application | enabled | idletimeout | locale | maxsessions}

no default {enabled | maxsessions}

Syntax Description

application

Has no effect on the application.

enabled

Enables the trigger. Use the no form of this command to disable the trigger.

idletimeout

Sets the idle timeout to 10,000 seconds.

locale

Sets the locale to "systemDefault."

maxsessions

Sets the maximum number of sessions to the port license number. Use the no form of this command to set the number to 0.


Command Modes

CCN trigger SIP configuration

Command History

Cisco Unity Express Release
Modification

1.0

This command was introduced on the Cisco Unity Express network module and in Cisco Unified Communications Manager Express 3.0.

1.1

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

1.1.2

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


Examples

The following example sets the maximum number of sessions to the port license number:

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)# default maxsessions
se-10-0-0-0(config-trigger)# end
se-10-0-0-0(config)# exit

Related Commands

Command
Description

ccn application

Configures the CCN applications, such as voice mail and auto attendant.

ccn engine

Configures the parameters used by all CCN applications.

show ccn trigger

Displays all of the CCN application details.


default ccm-manager (ccn subsystem jtapi)

To reset a Cisco Unified Communications Manager JTAPI subsystem parameter used by Cisco Unity Express to its default value, use the default ccm-manager command in Cisco Unity Express CCN subsystem JTAPI configuration mode.

default ccm-manager {address | username | password}

Syntax Description

address

Sets the IP address of the Cisco Unified Communications Manager server to 0.0.0.0.

username

Sets the CCM JTAPI username to an empty string.

password

Sets the CCM JTAPI password to an empty string.


Command Modes

CCN subsystem JTAPI configuration

Command History

Cisco Unity Express Release
Modification

1.0

This command was introduced on the Cisco Unity Express network module and in Cisco Unified Communications Manager Express 3.0.

1.1

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

1.1.2

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


Examples

The following example sets the Cisco Unified Communications Manager server address to 0.0.0.0.

se-10-0-0-0# config t

se-10-0-0-0(config)# ccn subsystem jtapi

se-10-0-0-0(config-jtapi)# default ccm-manager address

se-10-0-0-0(config-jtapi)# end

se-10-0-0-0(config)# exit

Related Commands

Command
Description

ccn application

Configures the CCN applications, such as voice mail and auto attendant.

ccn engine

Configures the parameters used by all CCN applications.

ccn subsystem jtapi

Configures CCM JTAPI parameters.

ccn trigger sip phonenumber

Configures CCN trigger values for the applications.

show ccn subsystem jtapi

Displays the CCN subsystem JTAPI details.


default ctiport (ccn subsystem jtapi)

To reset the Cisco Unified Communications Manager CTI port address to its default value (an empty string), use the default ctiport command in Cisco Unity Express CCN subsystem JTAPI configuration mode.

default ctiport

Syntax Description

This command has no arguments or keywords.

Command Modes

CCN subsystem JTAPI configuration

Command History

Cisco Unity Express Release
Modification

1.0

This command was introduced on the Cisco Unity Express network module and in Cisco Unified Communications Manager Express 3.0.

1.1

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

1.1.2

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


Examples

The following example sets the Cisco Unified Communications Manager CTI port address to an empty string.

se-10-0-0-0# config t

se-10-0-0-0(config)# ccn subsystem jtapi

se-10-0-0-0(config-jtapi)# default ctiport

se-10-0-0-0(config-jtapi)# end

se-10-0-0-0(config)# exit

Related Commands

Command
Description

ccn application

Configures the CCN applications, such as voice mail and auto attendant.

ccn engine

Configures the parameters used by all CCN applications.

ccn subsystem jtapi

Configures the CCM JTAPI parameters.

ccn trigger sip phonenumber

Configures CCN trigger values for the applications.

show ccn subsystem jtapi

Displays the CCN subsystem JTAPI details.


default gateway (ccn subsystem sip)

To reset a SIP server parameter to its default value, use the default gateway command in Cisco Unity Express CCN subsystem SIP configuration mode.

default gateway {address | port}

Syntax Description

address

Sets the IP address of the SIP server to 0.0.0.0.

port

Sets the SIP port to 5060.


Command Modes

CCN subsystem SIP configuration

Command History

Cisco Unity Express Release
Modification

1.0

This command was introduced on the Cisco Unity Express network module and in Cisco Unified Communications Manager Express 3.0.

1.1

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

1.1.2

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


Examples

The following example sets the SIP server port to 5060.

se-10-0-0-0# config t

se-10-0-0-0(config)# ccn subsystem sip

se-10-0-0-0(config-sip)# default gateway port

se-10-0-0-0(config-sip)# end

se-10-0-0-0(config)# exit

Related Commands

Command
Description

ccn application

Configures the CCN applications, such as voice mail and auto attendant.

ccn engine

Configures the parameters used by all CCN applications.

ccn subsystem sip

Configures the CCM JTAPI parameters.

ccn trigger sip phonenumber

Configures CCN trigger values for the applications.

show ccn subsystem sip

Displays the CCN subsystem SIP details.


default security password length min

To set the length of the security password to the default minimum, use the default security password length min command in Cisco Unity Express configuration mode.

default security password length min

Syntax Description

This command has no arguments or keywords.

Defaults

The password length is 3.

Command Modes

Cisco Unity Express configuration

Command History

Cisco Unity Express Release
Modification

2.1

This command was introduced.


Examples

The following example resets the password length:

se-10-0-0-0# config t
se-10-0-0-0(config)# default security password length min
se-10-0-0-0(config)# end

Related Commands

Command
Description

security password

Configures the system-wide password length and expiry time.

show security detail

Displays the password and PIN settings.


default security pin length min

To set the length of the security PIN to the default minimum, use the default security pin length min command in Cisco Unity Express configuration mode.

default security pin length min

Syntax Description

This command has no arguments or keywords.

Defaults

The PIN length is 3.

Command Modes

Cisco Unity Express configuration

Command History

Cisco Unity Express Release
Modification

2.1

This command was introduced.


Examples

The following example resets the PIN length:

se-10-0-0-0# config t
se-10-0-0-0(config)# default security pin length min
se-10-0-0-0(config)# end

Related Commands

Command
Description

security pin

Configures the system-wide pin length and expiry time.

show security detail

Displays the password and PIN settings.


description (ccn application)

To specify an optional description for a CCN application, use the description command in Cisco Unity Express CCN application configuration mode. To remove the description, use the no form of this command.

description "text"

no description "text"

Syntax Description

text

Specifies a text description for the application. Use double quotes around the text.


Defaults

No string is defined.

Command Modes

CCN application configuration

Command History

Cisco Unity Express Release
Modification

1.0

This command was introduced on the Cisco Unity Express network module and in Cisco Unified Communications Manager Express 3.0.

1.1

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

1.1.2

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


Examples

The following example adds a description for the CCN autoattendant application:

se-10-0-0-0# config t

se-10-0-0-0(config)# ccn application autoattendant

se-10-0-0-0(config-application)# description "Release 1 AA"

se-10-0-0-0(config-application)# end

se-10-0-0-0(config)# exit

Related Commands

Command
Description

ccn application

Configures the CCN applications, such as voice mail and auto attendant.

show ccn application

Displays the CCN application details.


dtmf-relay

To set the SIP DTMF relay mechanism, use the dtmf-relay command in Cisco Unity Express SIP configuration mode. To use the default values, use the no or default form of this command.

dtmf-relay {rtp-nte | sub-notify | info | sip-notify}

no dtmf-relay

default dtmf-relay

Syntax Description

rtp-nte

Uses the media path to relay incoming and outgoing DTMF signals to Cisco Unity Express.

sub-notify

Uses Subscribe and Notify messages to relay for incoming DTMF signals to Cisco Unity Express. This option is not available for outgoing DTMF signals from Cisco Unity Express.

info

Uses the Info message to relay outgoing DTMF signals from Cisco Unity Express to the Cisco IOS SIP gateway.

sip-notify

Uses Unsolicited-Notify messages to relay incoming and outgoing DTMF signals.


Defaults

sip-notify, sub-notify is the default combination.

Command Modes

Cisco Unity Express SIP configuration

Command History

Cisco Unity Express Release
Modification

2.3

This command was introduced.


Usage Guidelines

To use the rtp-nte option, verify that the Cisco IOS SIP gateway is configured to use Unsolicited NOTIFY for SIP calls, as shown in the following example:

dial-peer voice 1000 voip
   destination-pattern 6700
   session protocol sipv2
   session target ipv4:10.100.9.6
   dtmf-relay sip-notify rtp-nte
   codec g711ulaw
   no vad

To use the sip-notify option, verify that the Cisco IOS SIP gateway is configured to use Unsolicited NOTIFY for SIP calls, as shown in the following example:

dial-peer voice 1 voip
   destination-pattern 6700
   session protocol sipv2
   session target ipv4:10.100.9.6
   dtmf-relay sip-notify
   codec g711ulaw
   no vad

Configure more than one option for transferring DTMF signals. The order in which you configure the options determines their order of preference. To configure more than one signal option, specify them using a single dtmf-relay command.

Table 2 shows the various option combinations, the remote end capability, and the signaling option for incoming and outgoing DTMF signals.

Table 2 DTMF Relay Option Combinations

Cisco Unity Express Configuration
Option Supported at Remote End
Option Used for Incoming DTMF to Cisco Unity Express
Option Used for Outgoing DTMF from Cisco Unity Express

sub-notify

sub-notify

no DTMF

info

no DTMF

info

rtp-nte

rtp-nte

rtp-nte

rtp-nte

sip-notify

sip-notify

sip-notify

sip-notify

sip-notify, rtp-nte

rtp-nte, sip-notify

sip-notify1

sip-notify1

sip-notify, rtp-nte

rtp-nte

rtp-nte

rtp-nte

sip-notify, info

sip-notify

sip-notify

sip-notify

sip-notify, info

no support2

no DTMF

info

sip-notify, sub-notify

sip-notify

sip-notify

sip-notify

sip-notify, sub-notify

no support2

sub-notify

sub-notify

sip-notify, rtp-nte, info

rtp-nte

rtp-nte

rtp-nte

sip-notify, rtp-nte, info

sip-notify

sip-notify

sip-notify

sip-notify, rtp-nte, info

no support2

no DTMF

info

sip-notify, rtp-nte, sub-notify

rtp-nte

rtp-nte

rtp-nte

sip-notify, rtp-nte, sub-notify

sip-notify

sip-notify

sip-notify

sip-notify, rtp-nte, sub-notify

no support2

sub-notify

no DTMF

sub-notify, info

sub-notify

info

rtp-nte, sub-notify

rtp-nte

rtp-nte

rtp-nte

rtp-nte, sub-notify

no support2

sub-notify

no DTMF

rtp-nte, info

rtp-nte

rtp-nte

rtp-nte

rtp-nte, info

no support2

no DTMF

info

sip-notify, rtp-nte, sub-notify, info

sip-notify, rtp-nte

sip-notify

sip-notify

sip-notify, rtp-nte, sub-notify, info

rtp-nte

rtp-nte

rtp-nte

sip-notify, rtp-nte, sub-notify, info

no support2

sub-notify

info

1 For incoming call. For outgoing call, the remote end decides between rtp-nte and sip-notify.

2 No support for rtp-nte and sip-notify.


Examples

The following example configures the options sip-notify and rtp-nte for handling DTMF signals.

se-10-0-0-0# config t
se-10-0-0-0(config)# ccn subsystem sip
se-10-0-0-0(config-sip)# dtmf-relay sip-notify rtp-nte
se-10-0-0-0(config-sip)# end
se-10-0-0-0(config)# end
se-10-0-0-0# 

Related Commands

Command
Description

ccn subsystem sip

Enters SIP configuration mode.

mwi sip

Sets the MWI notification mechanism used by Cisco Unity Express.

show ccn sip subscription mwi

Displays the active MWI subscriptions.

show ccn subsystem sip

Displays the DTMF relay mechanism.

transfer-mode

Sets the transfer mode used by Cisco Unity Express for SIP calls.