Cisco Unity Express 2.3 Command Reference
M

Table Of Contents

M

maxsessions (ccn application)

maxsessions (ccn trigger jtapi)

maxsessions (ccn trigger sip)

maxsessions (IMAP)

maxsteps (ccn engine)

mwi refresh

mwi sip


M


Last Updated: May 1, 2006

maxsessions (ccn application)

maxsessions (ccn trigger jtapi)

maxsessions (ccn trigger sip)

maxsessions (IMAP)

maxsteps (ccn engine)

mwi refresh

mwi sip

maxsessions (ccn application)

To specify the maximum number of subscribers who can access an application simultaneously, use the maxsessions command in Cisco Unity Express configuration application mode. To set the number to 0, use the no form of this command.

maxsessions number

no maxsessions

Syntax Description

number

Number of subscribers who can access this application simultaneously. The maximum value is determined by the number of ports purchased for the application. The default value is the number of ports granted by the license.


Command Modes

Configuration application

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 subscribers who can access the autoattendant application simultaneously to 12.

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

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

se-10-0-0-0(config-application)# maxsessions 12

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.


maxsessions (ccn trigger jtapi)

To specify the maximum number of subscribers who can access a JTAPI trigger simultaneously, use the maxsessions command in Cisco Unity Express configuration trigger mode. To set the number to 0, use the no form of this command.

maxsessions number

no maxsessions

Syntax Description

number

Number of subscribers who can access this trigger simultaneously. The maximum value is determined by the number of ports purchased for the application. The default value is the number of ports granted by the license.


Command Modes

Configuration trigger

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 subscribers who can access the JTAPI phonenumber trigger simultaneously to 12.

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)# maxsessions 12

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

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

Related Commands

Command
Description

ccn trigger jtapi phonenumber

Enters CCN configuration trigger mode.

show ccn trigger

Displays the CCN trigger details.


maxsessions (ccn trigger sip)

To specify the maximum number of subscribers who can access a SIP trigger simultaneously, use the maxsessions command in Cisco Unity Express configuration trigger mode. To set the number to 0, use the no form of this command.

maxsessions number

no maxsessions

Syntax Description

number

Number of subscribers who can access this trigger simultaneously. The maximum value is determined by the number of ports purchased for the application. The default value is the number of ports granted by the license.


Command Modes

Configuration trigger

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 subscribers who can access the SIP phonenumber trigger simultaneously to 12.

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)# maxsessions 12

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

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

Related Commands

Command
Description

ccn trigger sip phonenumber

Enters CCN configuration trigger mode.

show ccn trigger

Displays the CCN trigger details.


maxsessions (IMAP)

To specify the maximum number of simultaneous IMAP sessions, use the maxsessions command in IMAP configuration mode. To set the number to the default value 50, use the no or default form of this command.

maxsessions number

no maxsessions

default maxsessions

Syntax Description

number

Number of simultaneous IMAP sessions. Valid values are 1 to 50. The default value is 50.


Defaults

The default number of sessions is 50.

Command Modes

IMAP configuration

Command History

Cisco Unity Express Release
Modification

2.3

This command was introduced.


Usage Guidelines

This command is not available on the AIM.

An error message appears if a value for number is greater than 50.

If a subscriber attempts to use the IMAP feature and the IMAP server is at its maximum number of sessions, the subscriber will see an error message.


Note The IMAP server must be restarted for this value to become active.


Examples

The following example sets the maximum number of simultaneous IMAP sessions to 12.

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

se-10-0-0-0(config)# service imap

se-10-0-0-0(config-application)# maxsessions 12

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

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

Related Commands

Command
Description

enable (IMAP)

Enables the IMAP feature.

groupname

Configures voice-mail group parameters.

service imap

Enters IMAP configuration mode.

session idletimeout (IMAP)

Specifies the IMAP session idletimeout value.

session security

Sets the IMAP client connection type.

show imap configuration

Displays all IMAP configuration parameters.

show imap sessions

Displays all active IMAP sessions.


maxsteps (ccn engine)

To specify the maximum number of steps that can be executed in an application, use the maxsteps command in Cisco Unity Express configuration engine mode. This command does not have a no form.

maxsteps number

Syntax Description

number

Maximum number of steps that can be executed in an application. The default value is 1000. Maximum number of steps is 10,000.


Defaults

1000 steps

Command Modes

Configuration engine

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 steps in an application to 500.

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

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

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

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 features shared by all the Cisco Unity Express subsystems.

show ccn engine

Displays the CCN engine details.


mwi refresh

To refresh the message-waiting indicator (MWI) lights on one or more telephones, use the mwi refresh command in Cisco Unity Express EXEC mode.

mwi refresh {all | telephonenumber tel-number}

Syntax Description

all

Refreshes all telephones configured on the system.

telephonenumber tel-number

Refreshes the specified telephone number or extension.


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 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

Use this command to update the MWI lights when they are not in synchronization with the stored voice messages.

Refreshing an extension that does not require it does not affect that extension.

Examples

The following example refreshes the MWIs for all telephones:
se-10-0-0-0> enable
se-10-0-0-0# mwi refresh all

The following example refreshes the MWI for extension 2015:

se-10-0-0-0> enable

se-10-0-0-0# mwi refresh telephonenumber 2015

Related Commands

Command
Description

show groups

Displays a list of all configured groups.

show users

Displays a list of all configured subscribers.

show voicemail

Displays the properties of the configured voice-mail system.


mwi sip

To set the message waiting indicator (MWI) notification mechanism, use the mwi sip command in Cisco Unity Express SIP configuration mode. To use the outcall mechanism, use the no or default form of this command.

mwi sip {outcall | sub-notify | unsolicited}

no mwi sip

default mwi sip

Syntax Description

outcall

Sends MWI notifications using the SIP outcall mechanism.

sub-notify

Sends MWI notifications using the Subscribe Notify mechanism.

unsolicited

Sends MWI notifications using the Unsolicited Notify mechanism.


Defaults

The default mechanism is outcall.

Command Modes

Cisco Unity Express SIP configuration

Command History

Cisco Unity Express Release
Modification

2.3

This command was introduced.


Usage Guidelines

Only Cisco Unified CME can use the SIP outcall mechanism for generating MWI notifications. Outcall will not work between Cisco Unity Express and a Cisco Unified Communications Manager system.


Note If the MWI notification option is outcall, configure the MWI on and off extensions. See "Configuring the MWI On and Off Extensions (Cisco Unified CME Only)" in the Cisco Unity Express 2.3 CLI Administrator Guide.


The outcall option is available for backward compatibility. It is recommended that you use either sub-notify or unsolicited for the MWi notification option.

To use the outcall option, Cisco Unified CME must configure each ephone-dn that is registered to receive MWI notifications as follows:

ephone-dn 30
  number 8000....
  mwi on
.
.
ephone-dn 31
  number 8001....
  mwi off

Both Cisco Unified CME and Cisco Unified Communications Manager in SRST mode can use the sub-notify and unsolicited mechanisms for generating MWI notifications. With these mechanisms, the MWI notifications will reflect the accurate status of messages in a subscriber's voice mailbox.

After an ephone-dn is configured with the sub-notify option, Cisco Unified CME sends a Subscribe message to Cisco Unity Express to register the phone for MWI notifications. When a new voice message arrives in the voice mailbox for the ephone-dn, Cisco Unity Express updates the MWI status. If Cisco Unity Express does not receive the Subscribe message for the ephone-dn, Cisco Unity Express will not update the MWI status when a new message arrives.

To use the sub-notify option, Cisco Unified CME must configure each ephone-dn that is registered to receive MWI notifications as follows:

For Cisco IOS Releases Prior to 12.3(11)T07

telephony-service
.
.
   mwi sip-server 10.100.9.6 transport udp port 5060 
   number 2010
.
ephone-dn 35
  mwi sip

For Cisco IOS Releases 12.3(11)T07 and Later

sip-ua
.
.
   mwi-server ipv4:10.100.9.6 transport udp port 5060 
   number 2010
.
ephone-dn 35
  mwi sip

For Cisco SRST Mode

sip-ua
.
.
   mwi-server ipv4:10.100.9.6 transport udp port 5060 
   number 2010
.
call-manager-fallback.
  mwi relay

The unsolicited option does not require Cisco Unified CME to send a subscription request for each ephone-dn to Cisco Unity Express for MWI notifications. Cisco Unity Express sends Notify messages to Cisco Unified CME whenever the voice mailbox for any ephone-dn receives a new message. In this way, the MWI status reflects the current voice mailbox message status.

To use the unsolicited option, Cisco Unified CME must configure each ephone-dn that is registered to receive MWI notifications as follows:

For Cisco IOS Releases Prior to 12.3(11)T07

telephony-service
.
.
   mwi sip-server 10.100.9.6 transport udp port 5060 unsolicited 
   number 2010
.
ephone-dn 35
  mwi sip

For Cisco IOS Release 12.3(11)T07 and Later

sip-ua
.
.
   mwi-server ipv4:10.100.9.6 transport udp port 5060 unsolicited
   number 2010
.
ephone-dn 35
  mwi sip

For Cisco SRST Mode
sip-ua
.
.
   mwi-server ipv4:10.100.9.6 transport udp port 5060 unsolicited
   number 2010
.
call-manager-fallback.
  mwi relay

The SIP server IP address used in these commands must be the IP address of Cisco Unity Express. In the examples shown above, this is 10.100.9.6.

Examples

The following example configures the MWI notification mechanism as SIP Notify:

se-10-0-0-0# config t
se-10-0-0-0(config)# ccn subsystem sip
se-10-0-0-0(config-sip)# mwi sip sub-notify
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.

dtmf-relay

Sets the SIP DTMF relay mechanism.

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.