Cisco Unified Messaging Gateway Command Reference for 8.0 and Later Versions
L Commands (VPIM)

Table Of Contents

L

license activate vpim nodes

list-manager

list number

list publish


L


Last Updated: November 17, 2010

license activate vpim nodes

list-manager

list number

list publish

license activate vpim nodes

To activate the license for Cisco Unified VPIM nodes, use the license activate vpim nodes command in Cisco UMG EXEC mode. Using the no form of this command sets the usage to zero and disables the feature.

license activate vpim nodes number

no license activate vpim nodes

Syntax Description

number

The number of nodes to activate.


Command Modes

Cisco UMG EXEC

Command History

Cisco UMG Version
Modification

8.0

This command was introduced.


Usage Guidelines

The number argument can be between 0 and the maximum number of nodes supported by the device and must be a multiple of 25. This activation count is applied for all types of licenses, so it can be used to reduce the count below the module maximum count or below the count of any other installed license.

Examples

The following example illustrates the use of the license activate vpim nodes command when the license has not yet been activated:

se-192-1-1-149# license activate vpim nodes 50

Evaluation licenses are being activated in the device for the following feature(s): 

        Feature Name: CUMG-SRSV-NODE

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? [y/n]?y

License activation count saved for use at next reload

The following example illustrates the use of the license activate vpim nodes command when the license has already been activated:

se-192-1-1-149# license activate vpim nodes 50

Current license already active, count saved for use at next reload

The following example illustrates the use of the license activate vpim nodes command to disable the licenses:

se-192-1-1-149# no license activate vpim nodes

License will be disabled at next reload

Related Commands

Command
Description

show license status application vpim

Displays the VPIM license status.


list-manager

To enter list manager mode in order to create, edit, or publish a system distribution list (SDL), use the list manager command in Cisco UMG EXEC mode.

list-manager

Syntax Description

This command has no keywords or arguments.

Command Modes

Cisco UMG EXEC

Command History

Cisco UMG Version
Modification

1.0

This command was introduced.


Usage Guidelines

Entering list manager mode locks list management on all peer messaging gateways, thereby preventing system desynchronization.

If the system encounters an SDL lock on a peer messaging gateway, it fails to lock and automatically leaves list manager mode. In this situation, you can wait until the lock on the peer messaging gateway is released or exit by using the exit command.


Caution If the system tells you that the current configuring messaging gateway is out of sync when you attempt to enter list manager mode, use the show list command to find out peer messaging gateway has the latest SDL information by looking at the SDL version numbers. Publishing from that messaging gateway brings the other messaging gateways back into sync.

Examples

The following example illustrates the use of the list-manager command to enter list manager mode:

umg-1# list-manager
umg-1(listmgr)# list number 4085550101
umg-1(listmgr-edit)#end
umg-1# 

The following example shows the output when the system fails to lock the list management.
umg-1# list-manager
Locking system distribution lists...Lock manager reports failure [FAILED]

The following example shows the out-of-sync warning.
umg-1# list-manager
Locking system distribution lists...[OK] 
**WARNING** This UMG is out of sync and contains old information, user should probably 
publish to this UMG from a peer. 
SDL-Version Last-Updated List-Of-Remote-Gateways 
-------------------------- ------------------------ ------------------------ 
* 50000_20070807033625 Aug 7, 2007 3:36:25 AM 51000 
-------------------------- ------------------------ ------------------------list-manager

Related Commands

Command
Description

list number

Creates an SDL.

list publish

Publishes one or more SDLs to peer messaging gateways.

member

Assigns members to an SDL.

name

Assigns a name to an SDL.

privilege (list-manager edit)

Configures an authorized sender to an SDL.

show list

Displays a list of the SDLs that are configured and their details.

show list privilege

Displays the authorized sender to a specific SDL.

show list tracking version

Displays an SDL tracking version.


list number

To enter list manager edit mode in order to configure a system distribution list (SDL) in detail, use the list number command in Cisco Unified Messaging Gateway (Cisco UMG) list manager mode. To delete an SDL, use the no form of this command.

list number number

no list number number

Syntax Description

number

The number an authorized subscriber dials to address a message to this SDL. The range is from 1 to 16 digits.


Command Modes

Cisco UMG list manager (listmgr)

Command History

Cisco UMG Version
Modification

1.0

This command was introduced.


Usage Guidelines

The list number cannot be the same as any other SDL number or any subscriber's number.

When you have created an SDL, unless you configure both an authorized sender and members for it, no messages can be sent to it and nobody can receive them.

When you leave list manager edit mode, the system automatically publishes your changes to all peer messaging gateways.

Examples

The following example illustrates the use of the list number command, and also subsequent configuration and publication:

umg-1# list-manager
Locking system distribution lists...[OK] 
umg-1(listmgr)# list number 1111 
umg-1(listmgr-edit)# name FirstList
umg-1(listmgr-edit)# privilege 4085550100
This authorized sender [4085550100] will be added. However this authorized sender does not 
exist yet!
umg-1(listmgr-edit)# member 4085550101 type sub
WARNING! The subscriber has been added to the list, but it doesn't exist in the subscriber 
directory.
umg-1(listmgr-edit)#_member 2222 type list
umg-1(listmgr-edit)# end
umg-1(listmgr)# end
auto publishing to all ...
LocationID        Status          Description
-----------------------------------------------------------
57000             Published


# of network gateways published:        1
# of network gateways failed to publish:0

Unlocking system distribution lists...[OK]
umg-1# show list 1111
Extension:          1111
Name:               FirstList
Number of members:  2
Member(s):          4085550101 (subscriber) 
                    2222 (list)
                    # of members: 2
umg-1#

Related Commands

Command
Description

list-manager

Locks down all peer Cisco UMGs so that SDLs can be published to peer messaging gateways,

list publish

Publishes one or more SDLs to peer messaging gateways.

member

Assigns members to an SDL.

name

Assigns a name to an SDL.

privilege (list-manager edit)

Configures an authorized sender to an SDL.

show list

Displays a list of the SDLs that are configured and their details.

show list privilege

Displays the authorized sender to a specific SDL.

show list tracking version

Displays an SDL tracking version.


list publish

To publish one or more SDLs to one or more peer messaging gateways, use the list publish command in Cisco UMG list manager mode.

list publish [ location-id ]

Syntax Description

location-id

The location ID (the range is 1 to 10 digits) of the peer messaging gateway to which you are publishing.


Command Modes

Cisco UMG list manager (listmgr)

Command History

Cisco UMG Version
Modification

1.0

This command was introduced.


Usage Guidelines

Use this command to publish SDLs to peer messaging gateways.


Note Use this command when you create an SDL, and each time you update an SDL, for example, when you add a new member.


Examples

The following examples illustrate the use of the list publish command to publish to all messaging gateways. The system indicates that it could not publish to one messaging gateway because that one was locked.

umg-1(listmgr)# list publish
LocationID Status Description
-----------------------------------------------------------
51000 Published
59000 Locked(Renewed)
# of network gateways published: 1
# of network gateways failed to publish:1
umg-1(listmgr)# end
umg-1#

Related Commands

Command
Description

list-manager

Enters list manager mode and locks down list management on all peer messaging gateways.

list number

Creates an SDL.

member

Assigns members to an SDL.

name

Assigns a name to an SDL.

privilege (list-manager edit)

Configures an authorized sender to an SDL.

show list

Displays a list of the SDLs that are configured and their details.

show list privilege

Displays the authorized sender to a specific SDL.

show list tracking version

Displays an SDL tracking version.