Queue Configuration

Create Queues

Creates a queue on a Universal Messaging server instance.

Syntax

sagcc create configuration data nodeAlias Universal-Messaging-instanceName
UM-QUEUES {--input|-i} file.xml

Arguments and Options

nodeAlias: Required. The alias name of the installation in which the Universal Messaging server instance is installed.
Universal-Messaging-instanceName: Required. The ID of the Universal Messaging server instance on which you want to create a queue.
UM-QUEUES: Required. The ID of the configuration type of which you want to create an instance.
--input|-i file.xml: Required. The absolute path to the XML file that contains the configuration properties of the queue.

Examples

To create a queue on the server instance with ID "Universal-Messaging-umserver" that is installed in the installation with alias name "sag01", using the "queue_create.xml" file:

sagcc create configuration data sag01 Universal-Messaging-umserver 
UM-QUEUES -i C:\Queues\queue_create.xml

The XML file contains the queue attributes and has the following format:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Queue>
    <name>queue1</name>
    <type>Persistent</type>
    <ttl>78</ttl>
    <capacity>99</capacity>
    <parent>umserver</parent>
  ......
</Queue>

Get Queue Data

Edit online

Retrieves configuration information about a specific queue on a Universal Messaging server instance.

Syntax

sagcc get configuration data nodeAlias Universal-Messaging-instanceName
UM-QUEUES-queueName

Arguments and Options

nodeAlias: Required. The alias name of the installation in which the Universal Messaging server instance is installed.
Universal-Messaging-instanceName: Required. The ID of the Universal Messaging server instance for which you want to retrieve queue information.
UM-QUEUES-queueName: Required. The ID of the queue for which you want to retrieve information.

Examples

To retrieve information about the queue with name "queue1" on the server instance with ID "Universal-Messaging-umserver" installed in the installation with alias name "sag01":

sagcc get configuration data sag01 Universal-Messaging-umserver UM-QUEUES-queue1

Update Queues

Edit online

Updates a queue on a Universal Messaging server instance.

Syntax

sagcc update configuration data nodeAlias Universal-Messaging-instanceName
UM-QUEUES-queueName {--input|-i} file.xml

Arguments and Options

nodeAlias: Required. The alias name of the installation in which the Universal Messaging server instance is installed.
Universal-Messaging-instanceName: Required. The ID of the Universal Messaging server instance on which you want to update a queue.
UM-QUEUES-queueName: Required. The ID of the queue you want to update.
--input|-i file.xml: Required. The absolute path to the XML file that contains the configuration properties of the queue.

Examples

To update the queue "queue1" on the server instance with ID "Universal-Messaging-umserver" that is installed in the installation with alias name "sag01", using the "queue_update.xml" file:

sagcc update configuration data sag01 Universal-Messaging-umserver 
UM-QUEUES-queue1 -i C:\Queues\queue_update.xml

The XML file contains the queue attributes and has the following format:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Queue>
    <name>queue1</name>
    <type>Persistent</type>
    <ttl>50000</ttl>
    <capacity>50000</capacity>
    <parent>umserver</parent>
    <deadEventStore/>
......
</Queue>