Universal Messaging 10.11 | Administration Guide | Command Line Administration Tools | Syntax reference for command line tools | Syntax: Data Group Tools
 
Syntax: Data Group Tools
Important:
The data group and data stream functionality is deprecated.
AddDataGroup

Tool name:
AddDataGroup

Description:
Adds a child data group to a parent data group.
Both of these data groups must exist.

Usage:
runUMTool AddDataGroup -rname=<rname> -datagroupname=<datagroupname>
-parentname=<parentname> [optional_args]

Examples:
AddDataGroup -rname=nsp://localhost:9000 -datagroupname=mydatagroup01
-parentname=mydatagroup02

Required arguments:

rname :
Connection URL to the realm where the data groups exist.

datagroupname :
Name of the child data group.

parentname :
Name of the parent data group.

Optional Parameters:

username :
Your Universal Messaging server username.

password :
Your Universal Messaging server password.
CreateDataGroup

Tool name:
CreateDataGroup

Description:
Creates a data group with the specified name on the specified server.
Additionally, conflation attributes and other options of the data group
can be set.

Usage:
runUMTool CreateDataGroup -rname=<rname> -datagroupname=<datagroupname>
[optional_args]

Examples:
CreateDataGroup -rname=nsp://localhost:9000 -datagroupname=mydatagroup01
-confinterval=2000 -enablemulticast=true

Required arguments:

rname :
Connection URL to the realm where the data group will be created.

datagroupname :
Name of the data group to be created.

Optional Parameters:

enablemulticast :
Whether multicast is supported on the new data group.

priority :
The default message priority for events on the new data group.

dropexpired :
Don't send events that are made obsolete by newer ones.

confinterval :
Interval at which all the events are sent.

confaction :
Action to take when multiple events arrive for this data group.
0 = drop old events
1 = merge events

username :
Your Universal Messaging server username.

password :
Your Universal Messaging server password.
DeleteDataGroup

Tool name:
DeleteDataGroup

Description:
Removes the data group with the specified name from the server.

Usage:
runUMTool DeleteDataGroup -rname=<rname> -datagroupname=<datagroupname>
[optional_args]

Examples:
DeleteDataGroup -rname=nsp://localhost:9000 -datagroupname=mydatagroup01

Required arguments:

rname :
Connection URL to the realm from which the data group will be deleted.

datagroupname :
Name of the data group to be deleted.

Optional Parameters:

username :
Your Universal Messaging server username.

password :
Your Universal Messaging server password.
ListenDataGroup

Tool name:
ListenDataGroup

Description:
Listens for data group events on a Universal Messaging realm.

Usage:
runUMTool ListenDataGroup -rname=<rname> [optional_args]

Examples:
ListenDataGroup -rname=nsp://localhost:9000

Required arguments:

rname :
Connection URL to the realm from which messages will be received.

Optional Parameters:

username :
Your Universal Messaging server username.

password :
Your Universal Messaging server password.
PublishDataGroup

Tool name:
PublishDataGroup

Description:
Publishes messages to a data group.

Usage:
runUMTool PublishDataGroup -rname=<rname> -datagroupname=<datagroupname>
[optional_args]

Examples:
PublishDataGroup -rname=nsp://localhost:9000 -datagroupname=mydatagroup01
-size=20

Required arguments:

rname :
Connection URL to the realm to which the messages will be published.

datagroupname :
Name of the data group to publish to.

Optional Parameters:

message :
Message to send. Put the message in quotes if it contains spaces.
You can't use -size along with -message.

size :
Size of the message to send. Message will be generated.
You can't use -message along with -size.

count :
How many times to send the event. Default 1.

username :
Your Universal Messaging server username.

password :
Your Universal Messaging server password.